WIP: Start adding new anchorPoint API on edit session

These will replace anchors, but they won't be stored on the Buffer
at all. The API user will access them by a returned scalar id rather
than calling methods on the returned anchor object directly.

src/app/anchor-point.coffee

@@ -0,0 +1,79 @@
+_ = require 'underscore'
+Point = require 'point'
+
+module.exports =
+class AnchorPoint
+  bufferPosition: null
+  screenPosition: null
+  ignoreSameLocationInserts: false
+  surviveSurroundingChanges: false
+
+  constructor: ({@id, @editSession, bufferPosition, @ignoreSameLocationInserts, @surviveSurroundingChanges}) ->
+    @setBufferPosition(bufferPosition)
+
+  handleBufferChange: (e) ->
+    { oldRange, newRange } = e
+    position = @getBufferPosition()
+
+    if oldRange.containsPoint(position, exclusive: true)
+      if @surviveSurroundingChanges
+        @setBufferPosition(oldRange.start)
+      else
+        @invalidate()
+      return
+    return if @ignoreSameLocationInserts and position.isEqual(oldRange.start)
+    return if position.isLessThan(oldRange.end)
+
+    newRow = newRange.end.row
+    newColumn = newRange.end.column
+    if position.row == oldRange.end.row
+      newColumn += position.column - oldRange.end.column
+    else
+      newColumn = position.column
+      newRow += position.row - oldRange.end.row
+
+    @setBufferPosition([newRow, newColumn])
+
+  setBufferPosition: (position, options={}) ->
+    @bufferPosition = Point.fromObject(position)
+    clip = options.clip ? true
+    @bufferPosition = @editSession.clipBufferPosition(@bufferPosition) if clip
+    @refreshScreenPosition(options)
+
+  getBufferPosition: ->
+    @bufferPosition
+
+  setScreenPosition: (position, options={}) ->
+    oldScreenPosition = @screenPosition
+    oldBufferPosition = @bufferPosition
+    @screenPosition = Point.fromObject(position)
+    clip = options.clip ? true
+    assignBufferPosition = options.assignBufferPosition ? true
+
+    @screenPosition = @editSession.clipScreenPosition(@screenPosition, options) if clip
+    @bufferPosition = @editSession.bufferPositionForScreenPosition(@screenPosition, options) if assignBufferPosition
+
+    Object.freeze @screenPosition
+    Object.freeze @bufferPosition
+
+#     unless @screenPosition.isEqual(oldScreenPosition)
+#       @trigger 'moved',
+#         oldScreenPosition: oldScreenPosition
+#         newScreenPosition: @screenPosition
+#         oldBufferPosition: oldBufferPosition
+#         newBufferPosition: @bufferPosition
+#         bufferChange: options.bufferChange
+
+  getScreenPosition: ->
+    @screenPosition
+
+  getScreenRow: ->
+    @screenPosition.row
+
+  refreshScreenPosition: (options={}) ->
+    return unless @editSession
+    screenPosition = @editSession.screenPositionForBufferPosition(@bufferPosition, options)
+    @setScreenPosition(screenPosition, bufferChange: options.bufferChange, clip: false, assignBufferPosition: false)
+
+  invalidate: ->
+    @editSession.removeAnchorPoint(@id)

src/app/display-buffer.coffee

@@ -225,7 +225,7 @@ class DisplayBuffer
     @lineMap.replaceScreenRows(start, end, newScreenLines)
     screenDelta = @lastScreenRowForBufferRow(tokenizedBufferEnd + tokenizedBufferDelta) - end
 
-    @trigger 'changed', { start, end, screenDelta, bufferDelta }
+    @trigger 'changed', { start, end, screenDelta, bufferDelta, bufferChange }
 
   buildLineForBufferRow: (bufferRow) ->
     @buildLinesForBufferRows(bufferRow, bufferRow)

src/app/edit-session.coffee

@@ -9,6 +9,7 @@ EventEmitter = require 'event-emitter'
 Subscriber = require 'subscriber'
 Range = require 'range'
 AnchorRange = require 'anchor-range'
+AnchorPoint = require 'anchor-point'
 _ = require 'underscore'
 fs = require 'fs'
 
@@ -40,6 +41,8 @@ class EditSession
     @softTabs = @buffer.usesSoftTabs() ? softTabs ? true
     @languageMode = new LanguageMode(this, @buffer.getExtension())
     @displayBuffer = new DisplayBuffer(@buffer, { @languageMode, tabLength })
+    @nextAnchorPointId = 1
+    @anchorPointsById = {}
     @anchors = []
     @anchorRanges = []
     @cursors = []
@@ -54,6 +57,7 @@ class EditSession
     @preserveCursorPositionOnBufferReload()
 
     @subscribe @displayBuffer, "changed", (e) =>
+      @updateAnchorPoints(e.bufferChange)
       @refreshAnchorScreenPositions() unless e.bufferDelta
       @trigger 'screen-lines-changed', e
 
@@ -351,6 +355,25 @@ class EditSession
   pushOperation: (operation) ->
     @buffer.pushOperation(operation, this)
 
+  updateAnchorPoints: (bufferChange) ->
+    return unless bufferChange
+    anchorPoint.handleBufferChange(bufferChange) for anchorPoint in @getAnchorPoints()
+
+  getAnchorPoints: ->
+    _.values(@anchorPointsById)
+
+  addAnchorPointAtBufferPosition: (bufferPosition, options) ->
+    id = @nextAnchorPointId++
+    params = _.extend({editSession: this, id, bufferPosition}, options)
+    @anchorPointsById[id] = new AnchorPoint(params)
+    id
+
+  getAnchorPointBufferPosition: (id) ->
+    @anchorPointsById[id]?.getBufferPosition()
+
+  removeAnchorPoint: (id) ->
+    delete @anchorPointsById[id]
+
   getAnchors: ->
     new Array(@anchors...)