@pierre/diffs 1.2.12 → 1.3.0-beta.10

package/dist/editor/editStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editStack.js","names":["#maxEntries","#undoStack","#redoStack"],"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\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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"}

package/dist/editor/editor.d.ts

@@ -0,0 +1,105 @@
+import { DiffLineAnnotation, DiffsEditableComponent, DiffsEditor, EditorState, FileContents, 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 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. */
+  matchBrackets?: boolean;
+  /**
+   * Controls auto-surround when typing quotes or brackets over a selection.
+   * 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.
+   */
+  enabledSelectionAction?: boolean;
+  /**
+   * Custom clipboard provider.
+   * Highly recommended to use native clipboard API if you are building an electron app.
+   * see https://www.electronjs.org/docs/latest/api/clipboard
+   */
+  clipboard?: {
+    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;
+  /** Callback when the editor gains focus. */
+  onFocus?: () => void;
+  /** Callback when the editor loses focus. */
+  onBlur?: () => void;
+  __debug?: boolean;
+}
+declare class Editor<LAnnotation> implements DiffsEditor<LAnnotation> {
+  #private;
+  constructor(options?: EditorOptions<LAnnotation>);
+  setOptions(options: EditorOptions<LAnnotation>): void;
+  edit(fileInstance: DiffsEditableComponent<LAnnotation>): () => void;
+  /**
+   * 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. */
+  get canUndo(): boolean;
+  /** Whether there is an undone edit to redo. */
+  get canRedo(): boolean;
+  /** Undo the last edit. Does nothing when there is nothing to undo. */
+  undo(): void;
+  /** Redo the last undone edit. Does nothing when there is nothing to redo. */
+  redo(): void;
+  getFile(): FileContents | undefined;
+  getText(): string;
+  getState(): EditorState;
+  setState({
+    selections,
+    view
+  }: EditorState): void;
+  setSelections(selections: (Range & {
+    direction: 'none' | 'backward' | 'forward';
+  })[]): void;
+  setMarkers(markers: Marker[]): void;
+  focus(options?: FocusOptions): 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 */
+  __syncRenderView: DiffsEditor<LAnnotation>['__syncRenderView'];
+}
+//#endregion
+export { Editor, EditorOptions };
+//# sourceMappingURL=editor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","names":[],"sources":["../../src/editor/editor.ts"],"mappings":";;;;;;;;UA+KiB,aAAA;;EAEf,iBAAA;EAF4B;;;;EAO5B,YAAA;EA4B+B;;;;EAvB/B,mBAAA,GAAsB,mBAAA;EA+BZ;EA7BV,gBAAA;EA8BgB;EA5BhB,aAAA;EAiCuC;;;;EA5BvC,YAAA,GAAe,YAAA;EAnBf;EAqBA,qBAAA,GAAwB,iBAAA;EAXxB;;;;EAgBA,sBAAA;EAPe;;;;;EAaf,SAAA;IACE,QAAA,GAAW,IAAA,cAAkB,OAAA;EAAA;EAG/B;EAAA,qBAAA,IACE,OAAA,EAAS,sBAAA,CAAuB,WAAA,MAC7B,WAAA;EAD6B;EAGlC,QAAA,IACE,MAAA,EAAQ,MAAA,CAAO,WAAA,GACf,YAAA,EAAc,sBAAA,CAAuB,WAAA;EAJlC;EAOL,QAAA,IACE,IAAA,EAAM,YAAA,EACN,eAAA,GAAkB,kBAAA,CAAmB,WAAA;EAN7B;EASV,OAAA;EATE;EAWF,MAAA;EAEA,OAAA;AAAA;AAAA,cAaW,MAAA,yBAA+B,WAAA,CAAY,WAAA;EAAA;EAoItD,WAAA,CAAY,OAAA,GAAS,aAAA,CAAc,WAAA;EAInC,UAAA,CAAW,OAAA,EAAS,aAAA,CAAc,WAAA;EAiClC,IAAA,CAAK,YAAA,EAAc,sBAAA,CAAuB,WAAA;EA7LxC;;;;;AAOK;AAaT;;;;EAsNE,UAAA,CAAW,KAAA,EAAO,QAAA,IAAY,aAAA;EAlFT;EAAA,IAqJjB,OAAA;EAjJgB;EAAA,IAsJhB,OAAA;EArHe;EA0HnB,IAAA;EASW;EAJX,IAAA;EAIA,OAAA,IAAW,YAAA;EAcX,OAAA;EAIA,QAAA,IAAY,WAAA;EAcZ,QAAA;IAAW,UAAA;IAAY;EAAA,GAAQ,WAAA;EAsB/B,aAAA,CACE,UAAA,GAAa,KAAA;IAAU,SAAA;EAAA;EAmCzB,UAAA,CAAW,OAAA,EAAS,MAAA;EA6BpB,KAAA,CAAM,OAAA,GAAU,YAAA;EAchB,IAAA;EAIA,OAAA,CAAQ,OAAA;EArb6C;EA+frD,aAAA,CAAc,IAAA,EAAM,YAAA,GAAe,YAAA;EA/fjB;EA2hBlB,+BAAA;EA3hBsD;EAsiBtD,gBAAA,EAAkB,WAAA,CAAY,WAAA;AAAA"}