@pierre/diffs 1.3.0-beta.9 → 1.3.0-rc.2

package/dist/editor/editStack.js.map

@@ -1 +1 @@
-{"version":3,"file":"editStack.js","names":["#maxEntries","#undoStack","#redoStack"],"sources":["../../src/editor/editStack.ts"],"sourcesContent":["import type { DiffLineAnnotation } from '../types';\nimport type { EditorSelection } from './selection';\nimport type { ResolvedTextEdit, TextDocument } from './textDocument';\n\n/** Largest number of undo or redo entries kept; oldest entries drop first once exceeded. */\nconst DEFAULT_EDIT_STACK_MAX_ENTRIES = 100;\n\n/** An entry in the edit stack. */\nexport interface EditStackEntry<LAnnotation> {\n  /** Forward offset edits from the entry's base text to its final text. */\n  forwardEdits: ResolvedTextEdit[];\n  /** Inverse offset edits from the entry's final text back to its base text. */\n  inverseEdits: ResolvedTextEdit[];\n  /** Document version before the entry is applied. */\n  versionBefore: number;\n  /** Document version after the entry is applied. */\n  versionAfter: number;\n  /** Selection before the transaction. */\n  selectionsBefore?: EditorSelection[];\n  /** Selection after the transaction. */\n  selectionsAfter?: EditorSelection[];\n  /** Line annotations before the transaction. */\n  lineAnnotationsBefore?: DiffLineAnnotation<LAnnotation>[];\n  /** Line annotations after the transaction. */\n  lineAnnotationsAfter?: DiffLineAnnotation<LAnnotation>[];\n  /**\n   * When `true`, this entry is its own undo step and never merges with the\n   * entry before or after it. Set for paste and cut, which otherwise look like\n   * typing and would merge into the previous keystroke.\n   */\n  undoBoundary?: boolean;\n}\n\n/** Options for the edit stack. */\nexport interface EditStackOptions {\n  /** The maximum number of entries to keep in the undo stack. */\n  maxEntries?: number;\n}\n\n/** A stack of edit entries. */\nexport class EditStack<LAnnotation> {\n  #undoStack: EditStackEntry<LAnnotation>[] = [];\n  #redoStack: EditStackEntry<LAnnotation>[] = [];\n  #maxEntries: number;\n\n  constructor(options?: EditStackOptions) {\n    this.#maxEntries = Math.max(\n      1,\n      options?.maxEntries ?? DEFAULT_EDIT_STACK_MAX_ENTRIES\n    );\n  }\n\n  get canUndo(): boolean {\n    return this.#undoStack.length > 0;\n  }\n\n  get canRedo(): boolean {\n    return this.#redoStack.length > 0;\n  }\n\n  /** Clears both the undo and redo stacks. */\n  clear(): void {\n    this.#undoStack.length = 0;\n    this.#redoStack.length = 0;\n  }\n\n  /** Clears the redo stack. */\n  clearRedo(): void {\n    this.#redoStack.length = 0;\n  }\n\n  /** Pushes a new entry onto the undo stack. */\n  push(entry: EditStackEntry<LAnnotation>): void {\n    this.#undoStack.push(entry);\n    this.clearRedo();\n    if (this.#undoStack.length > this.#maxEntries) {\n      this.#undoStack.shift();\n    }\n  }\n\n  /** Sets the selections after the last undo entry. */\n  setLastUndoSelectionsAfter(selections: EditorSelection[]): void {\n    const lastEntry = this.#undoStack[this.#undoStack.length - 1];\n    if (lastEntry !== undefined) {\n      lastEntry.selectionsAfter = selections.map((selection) => ({\n        ...selection,\n      }));\n    }\n  }\n\n  /** Sets the line annotations after the last undo entry. */\n  setLastUndoLineAnnotations(\n    lineAnnotationsBefore: DiffLineAnnotation<LAnnotation>[],\n    lineAnnotationsAfter: DiffLineAnnotation<LAnnotation>[]\n  ): void {\n    const lastEntry = this.#undoStack[this.#undoStack.length - 1];\n    if (lastEntry !== undefined) {\n      lastEntry.lineAnnotationsBefore = lineAnnotationsBefore.slice();\n      lastEntry.lineAnnotationsAfter = lineAnnotationsAfter.slice();\n    }\n  }\n\n  /** Returns the last undo entry, or `undefined` if empty. */\n  peekUndo(): EditStackEntry<LAnnotation> | undefined {\n    return this.#undoStack[this.#undoStack.length - 1];\n  }\n\n  /** Replaces the last undo entry with the given entry. */\n  replaceLastUndo(entry: EditStackEntry<LAnnotation>): void {\n    if (this.#undoStack.length === 0) {\n      this.push(entry);\n      return;\n    }\n    this.#undoStack[this.#undoStack.length - 1] = entry;\n    this.clearRedo();\n  }\n\n  /** Moves the latest undo entry to the redo stack and returns it, or `undefined` if empty. */\n  popUndoToRedo(): EditStackEntry<LAnnotation> | void {\n    const entry = this.#undoStack.pop();\n    if (entry !== undefined) {\n      this.#redoStack.push(entry);\n      return entry;\n    }\n  }\n\n  /** Moves the latest redo entry back to the undo stack and returns it, or `undefined` if empty. */\n  popRedoToUndo(): EditStackEntry<LAnnotation> | void {\n    const entry = this.#redoStack.pop();\n    if (entry !== undefined) {\n      this.#undoStack.push(entry);\n      return entry;\n    }\n  }\n}\n\nexport function createEditStackEntry<LAnnotation>(\n  textDocument: TextDocument<LAnnotation>,\n  resolvedEdits: ResolvedTextEdit[],\n  versionBefore: number,\n  versionAfter: number,\n  selectionsBefore?: EditorSelection[],\n  selectionsAfter?: EditorSelection[],\n  lineAnnotationsBefore?: DiffLineAnnotation<LAnnotation>[],\n  lineAnnotationsAfter?: DiffLineAnnotation<LAnnotation>[]\n): EditStackEntry<LAnnotation> {\n  const forwardEdits = [...resolvedEdits].sort((a, b) => a.start - b.start);\n  const inverseEdits: ResolvedTextEdit[] = [];\n  for (let i = 0, offsetDelta = 0; i < forwardEdits.length; i++) {\n    const edit = forwardEdits[i];\n    const replacedText = textDocument.getTextSlice(edit.start, edit.end);\n    const startAfterEdit = edit.start + offsetDelta;\n    inverseEdits.push({\n      start: startAfterEdit,\n      end: startAfterEdit + edit.text.length,\n      text: replacedText,\n    });\n    offsetDelta += edit.text.length - (edit.end - edit.start);\n  }\n  return {\n    forwardEdits: forwardEdits.map((edit) => ({ ...edit })),\n    inverseEdits: inverseEdits,\n    versionBefore,\n    versionAfter,\n    selectionsBefore: selectionsBefore?.map((selection) => ({\n      ...selection,\n    })),\n    selectionsAfter: selectionsAfter?.map((selection) => ({ ...selection })),\n    lineAnnotationsBefore: lineAnnotationsBefore?.slice(),\n    lineAnnotationsAfter: lineAnnotationsAfter?.slice(),\n  };\n}\n\n/** Determines if the change matches following modes:\n * - 'insert': simple typing\n * - 'backspace': backward delete\n * - 'delete': forward delete\n */\nexport function shouldCoalesceEditStackEntry<LAnnotation>(\n  previousEntry: EditStackEntry<LAnnotation> | undefined,\n  nextEntry: EditStackEntry<LAnnotation>\n): boolean {\n  if (\n    previousEntry === undefined ||\n    previousEntry.undoBoundary === true ||\n    nextEntry.undoBoundary === true ||\n    previousEntry.forwardEdits.length === 0 ||\n    previousEntry.forwardEdits.length !== previousEntry.inverseEdits.length ||\n    previousEntry.forwardEdits.length !== nextEntry.forwardEdits.length ||\n    nextEntry.forwardEdits.length !== nextEntry.inverseEdits.length\n  ) {\n    return false;\n  }\n  let mode: 'insert' | 'backspace' | 'delete' | undefined;\n  for (let i = 0; i < previousEntry.forwardEdits.length; i++) {\n    const previousForward = previousEntry.forwardEdits[i];\n    const previousInverse = previousEntry.inverseEdits[i];\n    const nextForward = nextEntry.forwardEdits[i];\n    const nextInverse = nextEntry.inverseEdits[i];\n    const mappedNextStart = mapOffsetAfterForwardBatchToBefore(\n      nextForward.start,\n      previousEntry.forwardEdits\n    );\n    const previousWasInsert =\n      previousForward.start <= previousForward.end &&\n      previousForward.text.length > 0 &&\n      !previousForward.text.includes('\\n') &&\n      !previousInverse.text.includes('\\n');\n    const nextIsInsert =\n      nextForward.start === nextForward.end &&\n      nextForward.text.length > 0 &&\n      !nextForward.text.includes('\\n') &&\n      nextInverse.text.length === 0;\n    if (previousWasInsert && nextIsInsert) {\n      // Merge only when the next insert starts exactly where the previous\n      // inserted text ends, in after-edit offsets. `previousInverse.end` marks\n      // that point, since undo replaces exactly the inserted range. A\n      // base-offset check can't tell this apart from a caret that jumped to the\n      // left edge: both edges of a pure insert map back to the same base offset,\n      // so typing \"a\" then \"b\" at the left edge would merge as \"ab\" while the\n      // buffer holds \"ba\", corrupting redo.\n      if (nextForward.start !== previousInverse.end) {\n        return false;\n      }\n      mode ??= 'insert';\n      if (mode !== 'insert') {\n        return false;\n      }\n      continue;\n    }\n    const previousWasDelete =\n      previousForward.text.length === 0 &&\n      previousForward.end > previousForward.start &&\n      previousInverse.text.length > 0;\n    const nextIsDelete =\n      nextForward.text.length === 0 &&\n      nextForward.end > nextForward.start &&\n      nextInverse.text.length > 0;\n    if (previousWasDelete && nextIsDelete) {\n      if (mappedNextStart === previousForward.end) {\n        mode ??= 'delete';\n        if (mode !== 'delete') {\n          return false;\n        }\n        continue;\n      }\n      if (\n        mappedNextStart + (nextForward.end - nextForward.start) !==\n        previousForward.start\n      ) {\n        return false;\n      }\n      mode ??= 'backspace';\n      if (mode !== 'backspace') {\n        return false;\n      }\n      continue;\n    }\n    return false;\n  }\n  return mode !== undefined;\n}\n\n/** Coalesce edit stack entries for simple typing and single-character deletes. */\nexport function coalesceEditStackEntries<LAnnotation>(\n  previousEntry: EditStackEntry<LAnnotation>,\n  nextEntry: EditStackEntry<LAnnotation>\n): EditStackEntry<LAnnotation> {\n  const forwardEdits: ResolvedTextEdit[] = [];\n  const replacedTexts: string[] = [];\n  for (let i = 0; i < previousEntry.forwardEdits.length; i++) {\n    const previousForward = previousEntry.forwardEdits[i];\n    const previousInverse = previousEntry.inverseEdits[i];\n    const nextForward = nextEntry.forwardEdits[i];\n    const nextInverse = nextEntry.inverseEdits[i];\n    const mappedNextStart = mapOffsetAfterForwardBatchToBefore(\n      nextForward.start,\n      previousEntry.forwardEdits\n    );\n\n    if (previousForward.text.length > 0) {\n      forwardEdits.push({\n        start: previousForward.start,\n        end: previousForward.end,\n        text: previousForward.text + nextForward.text,\n      });\n      replacedTexts.push(previousInverse.text);\n      continue;\n    }\n\n    if (mappedNextStart === previousForward.end) {\n      forwardEdits.push({\n        start: previousForward.start,\n        end: mappedNextStart + (nextForward.end - nextForward.start),\n        text: '',\n      });\n      replacedTexts.push(previousInverse.text + nextInverse.text);\n      continue;\n    }\n\n    forwardEdits.push({\n      start: Math.min(previousForward.start, mappedNextStart),\n      end: previousForward.end,\n      text: '',\n    });\n    replacedTexts.push(nextInverse.text + previousInverse.text);\n  }\n\n  return {\n    forwardEdits,\n    inverseEdits: buildInverseEditsFromReplacedTexts(\n      forwardEdits,\n      replacedTexts\n    ),\n    versionBefore: previousEntry.versionBefore,\n    versionAfter: nextEntry.versionAfter,\n    selectionsBefore: previousEntry.selectionsBefore?.slice(),\n    selectionsAfter: nextEntry.selectionsAfter?.slice(),\n    lineAnnotationsBefore: previousEntry.lineAnnotationsBefore?.slice(),\n    lineAnnotationsAfter: nextEntry.lineAnnotationsAfter?.slice(),\n  };\n}\n\nfunction buildInverseEditsFromReplacedTexts(\n  forwardEdits: readonly ResolvedTextEdit[],\n  replacedTexts: readonly string[]\n): ResolvedTextEdit[] {\n  const inverseEdits: ResolvedTextEdit[] = [];\n  for (let i = 0, offsetDelta = 0; i < forwardEdits.length; i++) {\n    const edit = forwardEdits[i];\n    const startAfterEdit = edit.start + offsetDelta;\n    inverseEdits.push({\n      start: startAfterEdit,\n      end: startAfterEdit + edit.text.length,\n      text: replacedTexts[i],\n    });\n    offsetDelta += edit.text.length - (edit.end - edit.start);\n  }\n  return inverseEdits;\n}\n\nfunction mapOffsetAfterForwardBatchToBefore(\n  offsetAfter: number,\n  forwardEdits: readonly ResolvedTextEdit[]\n): number {\n  let offset = offsetAfter;\n  for (const edit of forwardEdits) {\n    const oldLength = edit.end - edit.start;\n    const newLength = edit.text.length;\n    const delta = newLength - oldLength;\n    if (offset < edit.start) {\n      continue;\n    }\n    if (offset >= edit.start + newLength) {\n      offset -= delta;\n      continue;\n    }\n    offset = edit.start + Math.min(offset - edit.start, oldLength);\n  }\n  return offset;\n}\n"],"mappings":"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"}
+{"version":3,"file":"editStack.js","names":["#maxEntries","#undoStack","#redoStack","#canCoalesce"],"sources":["../../src/editor/editStack.ts"],"sourcesContent":["import type { DiffLineAnnotation, EditorSelection } from '../types';\nimport type { ResolvedTextEdit, TextDocument } from './textDocument';\n\n/** Largest number of undo or redo entries kept; oldest entries drop first once exceeded. */\nconst DEFAULT_EDIT_STACK_MAX_ENTRIES = 100;\n\nconst COALESCING_MODE_INSERT = 1;\nconst COALESCING_MODE_BACKSPACE = 2;\nconst COALESCING_MODE_DELETE = 3;\ntype EditStackCoalescingMode = 1 | 2 | 3;\n\n/** An entry in the edit stack. */\nexport interface EditStackEntry<LAnnotation> {\n  /** Forward offset edits from the entry's base text to its final text. */\n  forwardEdits: ResolvedTextEdit[];\n  /** Inverse offset edits from the entry's final text back to its base text. */\n  inverseEdits: ResolvedTextEdit[];\n  /** Document version before the entry is applied. */\n  versionBefore: number;\n  /** Document version after the entry is applied. */\n  versionAfter: number;\n  /** Selection before the transaction. */\n  selectionsBefore?: EditorSelection[];\n  /** Selection after the transaction. */\n  selectionsAfter?: EditorSelection[];\n  /** Line annotations before the transaction. */\n  lineAnnotationsBefore?: DiffLineAnnotation<LAnnotation>[];\n  /** Line annotations after the transaction. */\n  lineAnnotationsAfter?: DiffLineAnnotation<LAnnotation>[];\n  /** Input mode inferred from the edit or retained by a coalesced run. */\n  coalescingMode?: EditStackCoalescingMode;\n  /**\n   * When `true`, this entry is its own undo step and never merges with the\n   * entry before or after it. Set for paste and cut, which otherwise look like\n   * typing and would merge into the previous keystroke.\n   */\n  undoBoundary?: boolean;\n}\n\n/** Options for the edit stack. */\nexport interface EditStackOptions {\n  /** The maximum number of entries to keep in the undo stack. */\n  maxEntries?: number;\n}\n\n/** A stack of edit entries. */\nexport class EditStack<LAnnotation> {\n  #undoStack: EditStackEntry<LAnnotation>[] = [];\n  #redoStack: EditStackEntry<LAnnotation>[] = [];\n  #maxEntries: number;\n  #canCoalesce = false;\n\n  constructor(options?: EditStackOptions) {\n    this.#maxEntries = Math.max(\n      1,\n      options?.maxEntries ?? DEFAULT_EDIT_STACK_MAX_ENTRIES\n    );\n  }\n\n  get canUndo(): boolean {\n    return this.#undoStack.length > 0;\n  }\n\n  get canRedo(): boolean {\n    return this.#redoStack.length > 0;\n  }\n\n  /** Clears both the undo and redo stacks. */\n  clear(): void {\n    this.#undoStack.length = 0;\n    this.#redoStack.length = 0;\n    this.#canCoalesce = false;\n  }\n\n  /** Clears the redo stack. */\n  clearRedo(): void {\n    this.#redoStack.length = 0;\n  }\n\n  /** Pushes a new entry onto the undo stack. */\n  push(entry: EditStackEntry<LAnnotation>): void {\n    this.#undoStack.push(entry);\n    this.clearRedo();\n    this.#canCoalesce = true;\n    if (this.#undoStack.length > this.#maxEntries) {\n      this.#undoStack.shift();\n    }\n  }\n\n  /** Sets the selections after the last undo entry. */\n  setLastUndoSelectionsAfter(selections: EditorSelection[]): void {\n    const lastEntry = this.#undoStack[this.#undoStack.length - 1];\n    if (lastEntry !== undefined) {\n      lastEntry.selectionsAfter = selections.map((selection) => ({\n        ...selection,\n      }));\n    }\n  }\n\n  /** Sets the line annotations after the last undo entry. */\n  setLastUndoLineAnnotations(\n    lineAnnotationsBefore: DiffLineAnnotation<LAnnotation>[],\n    lineAnnotationsAfter: DiffLineAnnotation<LAnnotation>[]\n  ): void {\n    const lastEntry = this.#undoStack[this.#undoStack.length - 1];\n    if (lastEntry !== undefined) {\n      lastEntry.lineAnnotationsBefore = lineAnnotationsBefore.slice();\n      lastEntry.lineAnnotationsAfter = lineAnnotationsAfter.slice();\n    }\n  }\n\n  /** Returns the last undo entry, or `undefined` if empty. */\n  peekUndo(): EditStackEntry<LAnnotation> | undefined {\n    return this.#undoStack[this.#undoStack.length - 1];\n  }\n\n  /** Returns the last undo entry only while its coalescing group is open. */\n  peekUndoForCoalescing(): EditStackEntry<LAnnotation> | undefined {\n    return this.#canCoalesce ? this.peekUndo() : undefined;\n  }\n\n  /** Replaces the last undo entry with the given entry. */\n  replaceLastUndo(entry: EditStackEntry<LAnnotation>): void {\n    if (this.#undoStack.length === 0) {\n      this.push(entry);\n      return;\n    }\n    this.#undoStack[this.#undoStack.length - 1] = entry;\n    this.clearRedo();\n    this.#canCoalesce = true;\n  }\n\n  /** Moves the latest undo entry to the redo stack and returns it, or `undefined` if empty. */\n  popUndoToRedo(): EditStackEntry<LAnnotation> | void {\n    const entry = this.#undoStack.pop();\n    if (entry !== undefined) {\n      this.#redoStack.push(entry);\n      this.#canCoalesce = false;\n      return entry;\n    }\n  }\n\n  /** Moves the latest redo entry back to the undo stack and returns it, or `undefined` if empty. */\n  popRedoToUndo(): EditStackEntry<LAnnotation> | void {\n    const entry = this.#redoStack.pop();\n    if (entry !== undefined) {\n      this.#undoStack.push(entry);\n      this.#canCoalesce = false;\n      return entry;\n    }\n  }\n}\n\nexport function createEditStackEntry<LAnnotation>(\n  textDocument: TextDocument<LAnnotation>,\n  resolvedEdits: ResolvedTextEdit[],\n  versionBefore: number,\n  versionAfter: number,\n  selectionsBefore?: EditorSelection[],\n  selectionsAfter?: EditorSelection[],\n  lineAnnotationsBefore?: DiffLineAnnotation<LAnnotation>[],\n  lineAnnotationsAfter?: DiffLineAnnotation<LAnnotation>[]\n): EditStackEntry<LAnnotation> {\n  const forwardEdits = [...resolvedEdits].sort((a, b) => a.start - b.start);\n  const inverseEdits: ResolvedTextEdit[] = [];\n  let coalescingMode: EditStackCoalescingMode | undefined;\n  if (selectionsBefore?.length === forwardEdits.length) {\n    const caretOffsets: number[] = [];\n    for (const selection of selectionsBefore) {\n      if (\n        selection.start.line !== selection.end.line ||\n        selection.start.character !== selection.end.character\n      ) {\n        break;\n      }\n      caretOffsets.push(textDocument.offsetAt(selection.start));\n    }\n    if (caretOffsets.length === forwardEdits.length) {\n      caretOffsets.sort((a, b) => a - b);\n      let isBackspace = true;\n      let isDelete = true;\n      for (let i = 0; i < forwardEdits.length; i++) {\n        const edit = forwardEdits[i];\n        if (edit.text.length > 0 || edit.start === edit.end) {\n          isBackspace = false;\n          isDelete = false;\n          break;\n        }\n        isBackspace &&= caretOffsets[i] === edit.end;\n        isDelete &&= caretOffsets[i] === edit.start;\n      }\n      coalescingMode = isBackspace\n        ? COALESCING_MODE_BACKSPACE\n        : isDelete\n          ? COALESCING_MODE_DELETE\n          : undefined;\n    }\n  }\n  for (let i = 0, offsetDelta = 0; i < forwardEdits.length; i++) {\n    const edit = forwardEdits[i];\n    const replacedText = textDocument.getTextSlice(edit.start, edit.end);\n    const startAfterEdit = edit.start + offsetDelta;\n    inverseEdits.push({\n      start: startAfterEdit,\n      end: startAfterEdit + edit.text.length,\n      text: replacedText,\n    });\n    offsetDelta += edit.text.length - (edit.end - edit.start);\n  }\n  return {\n    forwardEdits: forwardEdits.map((edit) => ({ ...edit })),\n    inverseEdits: inverseEdits,\n    versionBefore,\n    versionAfter,\n    selectionsBefore: selectionsBefore?.map((selection) => ({\n      ...selection,\n    })),\n    selectionsAfter: selectionsAfter?.map((selection) => ({ ...selection })),\n    lineAnnotationsBefore: lineAnnotationsBefore?.slice(),\n    lineAnnotationsAfter: lineAnnotationsAfter?.slice(),\n    coalescingMode,\n  };\n}\n\n/** Determines if the change matches following modes:\n * - 'insert': simple typing\n * - 'backspace': backward delete\n * - 'delete': forward delete\n */\nexport function shouldCoalesceEditStackEntry<LAnnotation>(\n  previousEntry: EditStackEntry<LAnnotation> | undefined,\n  nextEntry: EditStackEntry<LAnnotation>\n): boolean {\n  if (\n    previousEntry === undefined ||\n    previousEntry.undoBoundary === true ||\n    nextEntry.undoBoundary === true ||\n    previousEntry.forwardEdits.length === 0 ||\n    previousEntry.forwardEdits.length !== previousEntry.inverseEdits.length ||\n    previousEntry.forwardEdits.length !== nextEntry.forwardEdits.length ||\n    nextEntry.forwardEdits.length !== nextEntry.inverseEdits.length\n  ) {\n    return false;\n  }\n  let mode: EditStackCoalescingMode | undefined;\n  for (let i = 0; i < previousEntry.forwardEdits.length; i++) {\n    const previousForward = previousEntry.forwardEdits[i];\n    const previousInverse = previousEntry.inverseEdits[i];\n    const nextForward = nextEntry.forwardEdits[i];\n    const nextInverse = nextEntry.inverseEdits[i];\n    const mappedNextStart = mapOffsetAfterForwardBatchToBefore(\n      nextForward.start,\n      previousEntry.forwardEdits\n    );\n    const previousWasInsert =\n      previousForward.start <= previousForward.end &&\n      previousForward.text.length > 0 &&\n      !previousForward.text.includes('\\n') &&\n      !previousInverse.text.includes('\\n');\n    const nextIsInsert =\n      nextForward.start === nextForward.end &&\n      nextForward.text.length > 0 &&\n      !nextForward.text.includes('\\n') &&\n      nextInverse.text.length === 0;\n    if (previousWasInsert && nextIsInsert) {\n      // Merge only when the next insert starts exactly where the previous\n      // inserted text ends, in after-edit offsets. `previousInverse.end` marks\n      // that point, since undo replaces exactly the inserted range. A\n      // base-offset check can't tell this apart from a caret that jumped to the\n      // left edge: both edges of a pure insert map back to the same base offset,\n      // so typing \"a\" then \"b\" at the left edge would merge as \"ab\" while the\n      // buffer holds \"ba\", corrupting redo.\n      if (nextForward.start !== previousInverse.end) {\n        return false;\n      }\n      mode ??= COALESCING_MODE_INSERT;\n      if (\n        mode !== COALESCING_MODE_INSERT ||\n        (previousEntry.coalescingMode !== undefined &&\n          previousEntry.coalescingMode !== COALESCING_MODE_INSERT) ||\n        (nextEntry.coalescingMode !== undefined &&\n          nextEntry.coalescingMode !== COALESCING_MODE_INSERT)\n      ) {\n        return false;\n      }\n      continue;\n    }\n    const previousWasDelete =\n      previousForward.text.length === 0 &&\n      previousForward.end > previousForward.start &&\n      previousInverse.text.length > 0;\n    const nextIsDelete =\n      nextForward.text.length === 0 &&\n      nextForward.end > nextForward.start &&\n      nextInverse.text.length > 0;\n    if (previousWasDelete && nextIsDelete) {\n      let nextMode: EditStackCoalescingMode;\n      if (mappedNextStart === previousForward.end) {\n        nextMode = COALESCING_MODE_DELETE;\n      } else if (\n        mappedNextStart + (nextForward.end - nextForward.start) !==\n        previousForward.start\n      ) {\n        return false;\n      } else {\n        nextMode = COALESCING_MODE_BACKSPACE;\n      }\n      mode ??= nextMode;\n      if (\n        mode !== nextMode ||\n        (previousEntry.coalescingMode !== undefined &&\n          previousEntry.coalescingMode !== nextMode) ||\n        (nextEntry.coalescingMode !== undefined &&\n          nextEntry.coalescingMode !== nextMode)\n      ) {\n        return false;\n      }\n      continue;\n    }\n    return false;\n  }\n  return mode !== undefined;\n}\n\n/** Coalesce edit stack entries for simple typing and single-character deletes. */\nexport function coalesceEditStackEntries<LAnnotation>(\n  previousEntry: EditStackEntry<LAnnotation>,\n  nextEntry: EditStackEntry<LAnnotation>\n): EditStackEntry<LAnnotation> {\n  const forwardEdits: ResolvedTextEdit[] = [];\n  const replacedTexts: string[] = [];\n  let coalescingMode: EditStackCoalescingMode | undefined;\n  for (let i = 0; i < previousEntry.forwardEdits.length; i++) {\n    const previousForward = previousEntry.forwardEdits[i];\n    const previousInverse = previousEntry.inverseEdits[i];\n    const nextForward = nextEntry.forwardEdits[i];\n    const nextInverse = nextEntry.inverseEdits[i];\n    const mappedNextStart = mapOffsetAfterForwardBatchToBefore(\n      nextForward.start,\n      previousEntry.forwardEdits\n    );\n\n    if (previousForward.text.length > 0) {\n      coalescingMode ??= COALESCING_MODE_INSERT;\n      forwardEdits.push({\n        start: previousForward.start,\n        end: previousForward.end,\n        text: previousForward.text + nextForward.text,\n      });\n      replacedTexts.push(previousInverse.text);\n      continue;\n    }\n\n    if (mappedNextStart === previousForward.end) {\n      coalescingMode ??= COALESCING_MODE_DELETE;\n      forwardEdits.push({\n        start: previousForward.start,\n        end: mappedNextStart + (nextForward.end - nextForward.start),\n        text: '',\n      });\n      replacedTexts.push(previousInverse.text + nextInverse.text);\n      continue;\n    }\n\n    coalescingMode ??= COALESCING_MODE_BACKSPACE;\n    forwardEdits.push({\n      start: Math.min(previousForward.start, mappedNextStart),\n      end: previousForward.end,\n      text: '',\n    });\n    replacedTexts.push(nextInverse.text + previousInverse.text);\n  }\n\n  return {\n    forwardEdits,\n    inverseEdits: buildInverseEditsFromReplacedTexts(\n      forwardEdits,\n      replacedTexts\n    ),\n    versionBefore: previousEntry.versionBefore,\n    versionAfter: nextEntry.versionAfter,\n    selectionsBefore: previousEntry.selectionsBefore?.slice(),\n    selectionsAfter: nextEntry.selectionsAfter?.slice(),\n    lineAnnotationsBefore: previousEntry.lineAnnotationsBefore?.slice(),\n    lineAnnotationsAfter: nextEntry.lineAnnotationsAfter?.slice(),\n    coalescingMode,\n  };\n}\n\nfunction buildInverseEditsFromReplacedTexts(\n  forwardEdits: readonly ResolvedTextEdit[],\n  replacedTexts: readonly string[]\n): ResolvedTextEdit[] {\n  const inverseEdits: ResolvedTextEdit[] = [];\n  for (let i = 0, offsetDelta = 0; i < forwardEdits.length; i++) {\n    const edit = forwardEdits[i];\n    const startAfterEdit = edit.start + offsetDelta;\n    inverseEdits.push({\n      start: startAfterEdit,\n      end: startAfterEdit + edit.text.length,\n      text: replacedTexts[i],\n    });\n    offsetDelta += edit.text.length - (edit.end - edit.start);\n  }\n  return inverseEdits;\n}\n\nfunction mapOffsetAfterForwardBatchToBefore(\n  offsetAfter: number,\n  forwardEdits: readonly ResolvedTextEdit[]\n): number {\n  let offset = offsetAfter;\n  for (const edit of forwardEdits) {\n    const oldLength = edit.end - edit.start;\n    const newLength = edit.text.length;\n    const delta = newLength - oldLength;\n    if (offset < edit.start) {\n      continue;\n    }\n    if (offset >= edit.start + newLength) {\n      offset -= delta;\n      continue;\n    }\n    offset = edit.start + Math.min(offset - edit.start, oldLength);\n  }\n  return offset;\n}\n"],"mappings":"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"}

package/dist/editor/editor.d.ts

@@ -1,13 +1,24 @@
-import { DiffLineAnnotation, DiffsEditableComponent, DiffsEditor, DiffsEditorSelection, FileContents, RenderRange } from "../types.js";
-import { TextEdit } from "./textDocument.js";
-import { AutoSurround, EditorSelection } from "./selection.js";
+import { DiffLineAnnotation, DiffsEditableComponent, DiffsEditor, EditableInstance, EditorState, FileContents, LineAnnotation, Range, TextEdit } from "../types.js";
+import { LanguageConfigMap } from "./languages.js";
 import { Marker } from "./marker.js";
+import { AutoSurround } from "./selection.js";
 import { SelectionActionContext } from "./selectionAction.js";
+import { PersistStateStorage } from "./stateStorage.js";
 
 //#region src/editor/editor.d.ts
 interface EditorOptions<LAnnotation> {
   /** The maximum number of entries to keep in the undo stack. */
   historyMaxEntries?: number;
+  /**
+   * Preserve each file's document and item-local editor state when switching files.
+   * Every editable file must provide a unique, stable `cacheKey`.
+   */
+  persistState?: boolean;
+  /**
+   * Storage for serializable editor state. Text documents stay in this Editor's
+   * in-memory cache. Defaults to `"inMemory"`.
+   */
+  persistStateStorage?: PersistStateStorage;
   /** Render rounded corners for selection ranges, default is true. */
   roundedSelection?: boolean;
   /** Highlight matching brackets near the caret, default is true. */
@@ -17,9 +28,11 @@ interface EditorOptions<LAnnotation> {
    * Default is `"default"` (both quotes and brackets).
    */
   autoSurround?: AutoSurround;
+  /** Per-language comment tokens used by the comment commands. */
+  languageCommentConfig?: LanguageConfigMap;
   /**
-   * Show a floating selection action popover anchored to the active selection,
-   * default is disabled.
+   * Show a floating selection action popover after a user-created selection,
+   * default is disabled. Programmatic selection updates do not open it.
    */
   enabledSelectionAction?: boolean;
   /**
@@ -28,33 +41,42 @@ interface EditorOptions<LAnnotation> {
    * see https://www.electronjs.org/docs/latest/api/clipboard
    */
   clipboard?: {
-    readText: () => Promise<string> | string;
+    readText: (type?: string) => Promise<string> | string;
   };
   /** Render the selection action widget element. */
   renderSelectionAction?: (context: SelectionActionContext<LAnnotation>) => HTMLElement;
   /** Callback when the editor is attached to a file. */
   onAttach?: (editor: Editor<LAnnotation>, fileInstance: DiffsEditableComponent<LAnnotation>) => void;
   /** Callback when the editor document changes. */
-  onChange?: (file: FileContents, lineAnnotations?: DiffLineAnnotation<LAnnotation>[]) => void;
+  onChange?: (file: FileContents, lineAnnotations?: LineAnnotation<LAnnotation>[] | DiffLineAnnotation<LAnnotation>[]) => void;
   /** Callback when the editor gains focus. */
   onFocus?: () => void;
   /** Callback when the editor loses focus. */
   onBlur?: () => void;
   __debug?: boolean;
 }
-interface EditorState<LAnnotation> {
-  file: FileContents;
-  lineAnnotations?: DiffLineAnnotation<LAnnotation>[];
-  selections?: EditorSelection[];
-  renderRange?: RenderRange;
+interface EditorFocusOptions extends FocusOptions {
+  /** One-based document line number or first editable line with a visible top. */
+  lineNumber?: number | 'first-visible';
+  /** Zero-based character offset for a numeric line. Defaults to 0. */
+  character?: number;
+  /** Non-negative CSS pixels below the viewport or sticky header. */
+  offset?: number;
 }
 declare class Editor<LAnnotation> implements DiffsEditor<LAnnotation> {
   #private;
   constructor(options?: EditorOptions<LAnnotation>);
   setOptions(options: EditorOptions<LAnnotation>): void;
-  edit(fileInstance: DiffsEditableComponent<LAnnotation>): () => void;
+  edit<T extends DiffsEditableComponent<LAnnotation>>(fileInstance: EditableInstance<T>): () => void;
   /**
-   * Apply edits to current attached file.
+   * Apply edits to current attached file. Every edit joins the undo timeline:
+   * a programmatic edit must leave the document and its history exactly as
+   * the same edit typed by the user would (history equivalence — see
+   * TextDocument.applyResolvedEdits), so it is undoable like any other edit.
+   *
+   * @param updateHistory Whether to record caller selection snapshots for
+   * exact undo/redo restoration. Defaults to true. When false, live selections
+   * are remapped during replay and the text edit still joins the undo timeline.
    */
   applyEdits(edits: TextEdit[], updateHistory?: boolean): void;
   /** Whether there is an edit to undo. */
@@ -65,23 +87,29 @@ declare class Editor<LAnnotation> implements DiffsEditor<LAnnotation> {
   undo(): void;
   /** Redo the last undone edit. Does nothing when there is nothing to redo. */
   redo(): void;
-  getState(): EditorState<LAnnotation>;
+  getFile(): FileContents | undefined;
+  getText(): string;
+  getState(): EditorState;
   setState({
-    file,
-    lineAnnotations,
-    renderRange,
-    selections
-  }: EditorState<LAnnotation>): void;
-  setSelections(selections: DiffsEditorSelection[]): void;
+    selections,
+    view
+  }: EditorState): void;
+  setSelections(selections: (Range & {
+    direction: 'none' | 'backward' | 'forward';
+  })[]): void;
   setMarkers(markers: Marker[]): void;
-  focus(options?: FocusOptions): void;
+  focus(options?: EditorFocusOptions): void;
   blur(): void;
   cleanUp(recycle?: boolean): void;
+  /** @internal Capture outgoing state and substitute cached text before render. */
+  __prepareFile(file: FileContents): FileContents;
   /** @internal */
   __postponeBgTokenizeToNextFrame(): void;
   /** @internal */
+  __captureFocusForDOMReplacement(): void;
+  /** @internal */
   __syncRenderView: DiffsEditor<LAnnotation>['__syncRenderView'];
 }
 //#endregion
-export { Editor, EditorOptions, EditorState };
+export { Editor, EditorFocusOptions, EditorOptions };
 //# sourceMappingURL=editor.d.ts.map

package/dist/editor/editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor.d.ts","names":[],"sources":["../../src/editor/editor.ts"],"mappings":";;;;;;;UAyIiB,aAAA;;EAEf,iBAAA;EAF4B;EAI5B,gBAAA;EAOe;EALf,aAAA;EAqBkC;;;;EAhBlC,YAAA,GAAe,YAAA;EAqBwB;;;;EAhBvC,sBAAA;EAqBsC;;;;;EAftC,SAAA;IACE,QAAA,QAAgB,OAAA;EAAA;EAPlB;EAUA,qBAAA,IACE,OAAA,EAAS,sBAAA,CAAuB,WAAA,MAC7B,WAAA;EALH;EAOF,QAAA,IACE,MAAA,EAAQ,MAAA,CAAO,WAAA,GACf,YAAA,EAAc,sBAAA,CAAuB,WAAA;EANvC;EASA,QAAA,IACE,IAAA,EAAM,YAAA,EACN,eAAA,GAAkB,kBAAA,CAAmB,WAAA;EAVL;EAalC,OAAA;EAZK;EAcL,MAAA;EAEA,OAAA;AAAA;AAAA,UAGe,WAAA;EACf,IAAA,EAAM,YAAA;EACN,eAAA,GAAkB,kBAAA,CAAmB,WAAA;EACrC,UAAA,GAAa,eAAA;EACb,WAAA,GAAc,WAAA;AAAA;AAAA,cAUH,MAAA,yBAA+B,WAAA,CAAY,WAAA;EAAA;EAsHtD,WAAA,CAAY,OAAA,GAAS,aAAA,CAAc,WAAA;EAInC,UAAA,CAAW,OAAA,EAAS,aAAA,CAAc,WAAA;EAOlC,IAAA,CAAK,YAAA,EAAc,sBAAA,CAAuB,WAAA;EApJ1C;;;EAuLA,UAAA,CAAW,KAAA,EAAO,QAAA,IAAY,aAAA;EAlLf;EAAA,IA+PX,OAAA;EA/PsB;EAAA,IAoQtB,OAAA;EAlQiC;EAuQrC,IAAA;EAtQa;EA2Qb,IAAA;EAIA,QAAA,IAAY,WAAA,CAAY,WAAA;EAaxB,QAAA;IACE,IAAA;IACA,eAAA;IACA,WAAA;IACA;EAAA,GACC,WAAA,CAAY,WAAA;EAWf,aAAA,CAAc,UAAA,EAAY,oBAAA;EAoB1B,UAAA,CAAW,OAAA,EAAS,MAAA;EA6BpB,KAAA,CAAM,OAAA,GAAU,YAAA;EAchB,IAAA;EAIA,OAAA,CAAQ,OAAA;EAhX6B;EAsbrC,+BAAA;EArba;EAgcb,gBAAA,EAAkB,WAAA,CAAY,WAAA;AAAA"}
+{"version":3,"file":"editor.d.ts","names":[],"sources":["../../src/editor/editor.ts"],"mappings":";;;;;;;;UAyLiB,aAAA;;EAEf,iBAAA;EAF4B;;;;EAO5B,YAAA;EA4B+B;;;;EAvB/B,mBAAA,GAAsB,mBAAA;EA+BZ;EA7BV,gBAAA;EA8BgB;EA5BhB,aAAA;EAkCqB;;;;EA7BrB,YAAA,GAAe,YAAA;EA8BS;EA5BxB,qBAAA,GAAwB,iBAAA;EArBxB;;;;EA0BA,sBAAA;EAZA;;;;;EAkBA,SAAA;IACE,QAAA,GAAW,IAAA,cAAkB,OAAA;EAAA;EAAlB;EAGb,qBAAA,IACE,OAAA,EAAS,sBAAA,CAAuB,WAAA,MAC7B,WAAA;EAFL;EAIA,QAAA,IACE,MAAA,EAAQ,MAAA,CAAO,WAAA,GACf,YAAA,EAAc,sBAAA,CAAuB,WAAA;EALL;EAQlC,QAAA,IACE,IAAA,EAAM,YAAA,EACN,eAAA,GACI,cAAA,CAAe,WAAA,MACf,kBAAA,CAAmB,WAAA;EAXpB;EAcL,OAAA;EAXU;EAaV,MAAA;EAEA,OAAA;AAAA;AAAA,UAGe,kBAAA,SAA2B,YAAY;EAjBpD;EAmBF,UAAA;EAfQ;EAiBR,SAAA;EAfM;EAiBN,MAAA;AAAA;AAAA,cAmBW,MAAA,yBAA+B,WAAA,CAAY,WAAA;EAAA;EAkJtD,WAAA,CAAY,OAAA,GAAS,aAAA,CAAc,WAAA;EAInC,UAAA,CAAW,OAAA,EAAS,aAAA,CAAc,WAAA;EAkClC,IAAA,WAAe,sBAAA,CAAuB,WAAA,GACpC,YAAA,EAAc,gBAAA,CAAiB,CAAA;EArN1B;AAAA;AAGT;;;;;;;;EA4OE,UAAA,CAAW,KAAA,EAAO,QAAA,IAAY,aAAA;EAtOxB;EAAA,IAySF,OAAA;EAtRa;EAAA,IA2Rb,OAAA;EA3RkD;EAgStD,IAAA;EA9IqB;EAmJrB,IAAA;EAIA,OAAA,IAAW,YAAA;EAcX,OAAA;EAIA,QAAA,IAAY,WAAA;EAaZ,QAAA;IAAW,UAAA;IAAY;EAAA,GAAQ,WAAA;EAgB/B,aAAA,CACE,UAAA,GAAa,KAAA;IAAU,SAAA;EAAA;EAoCzB,UAAA,CAAW,OAAA,EAAS,MAAA;EA6BpB,KAAA,CAAM,OAAA,GAAU,kBAAA;EAmChB,IAAA;EAOA,OAAA,CAAQ,OAAA;EA3GO;EA8Lf,aAAA,CAAc,IAAA,EAAM,YAAA,GAAe,YAAA;EA7HnB;EAyJhB,+BAAA;EA5BmC;EAuCnC,+BAAA;EAekB;EAAlB,gBAAA,EAAkB,WAAA,CAAY,WAAA;AAAA"}