@pierre/diffs 1.3.0-beta.4 → 1.3.0-beta.6

package/dist/editor/editor.d.ts

@@ -1,30 +1,80 @@
-import { DiffLineAnnotation, DiffsEditableComponent, DiffsEditor, DiffsEditorSelection, DiffsHighlighter, FileContents, LineAnnotation, RenderRange } from "../types.js";
+import { DiffLineAnnotation, DiffsEditableComponent, DiffsEditor, DiffsEditorSelection, FileContents, RenderRange } from "../types.js";
+import { TextEdit } from "./textDocument.js";
+import { AutoSurround, EditorSelection } from "./selection.js";
 import { Marker } from "./marker.js";
 import { SelectionActionContext } from "./selectionAction.js";
 
 //#region src/editor/editor.d.ts
 interface EditorOptions<LAnnotation> {
+  /** The maximum number of entries to keep in the undo stack. */
+  historyMaxEntries?: number;
   /** Render rounded corners for selection ranges, default is true. */
   roundedSelection?: boolean;
-  /** Show the clickable selection action icon, default is disabled. */
+  /**
+   * Controls auto-surround when typing quotes or brackets over a selection.
+   * Default is `"default"` (both quotes and brackets).
+   */
+  autoSurround?: AutoSurround;
+  /**
+   * 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: () => 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>[] | LineAnnotation<any>[]) => void;
+  onChange?: (file: FileContents, lineAnnotations?: DiffLineAnnotation<LAnnotation>[]) => void;
   __debug?: boolean;
 }
+interface EditorState<LAnnotation> {
+  file: FileContents;
+  lineAnnotations?: DiffLineAnnotation<LAnnotation>[];
+  selections?: EditorSelection[];
+  renderRange?: RenderRange;
+}
 declare class Editor<LAnnotation> implements DiffsEditor<LAnnotation> {
   #private;
   constructor(options?: EditorOptions<LAnnotation>);
   edit(component: DiffsEditableComponent<LAnnotation>): () => void;
-  syncToRenderedView(highlighter: DiffsHighlighter, fileContainer: HTMLElement, fileContents: FileContents, didFileChange: boolean, lineAnnotations: DiffLineAnnotation<LAnnotation>[] | undefined, renderRange: RenderRange | undefined): void;
-  postponeBackgroundTokenizeToNextFrame(): void;
+  /**
+   * Apply edits to current attached file.
+   */
+  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;
+  getState(): EditorState<LAnnotation>;
+  setState({
+    file,
+    lineAnnotations,
+    renderRange,
+    selections
+  }: EditorState<LAnnotation>): void;
   setSelections(selections: DiffsEditorSelection[]): void;
   setMarkers(markers: Marker[]): void;
   focus(options?: FocusOptions): void;
+  blur(): void;
   cleanUp(): void;
+  /** @internal */
+  __postponeBackgroundTokenizeToNextFrame(): void;
+  /** @internal */
+  __syncRenderView: DiffsEditor<LAnnotation>['__syncRenderView'];
 }
 //#endregion
-export { Editor, EditorOptions };
+export { Editor, EditorOptions, EditorState };
 //# sourceMappingURL=editor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"editor.d.ts","names":["DiffLineAnnotation","DiffsEditableComponent","DiffsEditor","DiffsEditorSelection","DiffsHighlighter","FileContents","LineAnnotation","RenderRange","Marker","SelectionActionContext","EditorOptions","LAnnotation","HTMLElement","Editor","FocusOptions"],"sources":["../../src/editor/editor.d.ts"],"sourcesContent":["import type { DiffLineAnnotation, DiffsEditableComponent, DiffsEditor, DiffsEditorSelection, DiffsHighlighter, FileContents, LineAnnotation, RenderRange } from '../types';\nimport { type Marker } from './marker';\nimport { type SelectionActionContext } from './selectionAction';\nexport interface EditorOptions<LAnnotation> {\n    /** Render rounded corners for selection ranges, default is true. */\n    roundedSelection?: boolean;\n    /** Show the clickable selection action icon, default is disabled. */\n    enabledSelectionAction?: boolean;\n    /** Render the selection action widget element. */\n    renderSelectionAction?: (context: SelectionActionContext<LAnnotation>) => HTMLElement;\n    /** Callback when the editor document changes. */\n    onChange?: (file: FileContents, lineAnnotations?: DiffLineAnnotation<LAnnotation>[] | LineAnnotation<any>[]) => void;\n    __debug?: boolean;\n}\nexport declare class Editor<LAnnotation> implements DiffsEditor<LAnnotation> {\n    #private;\n    constructor(options?: EditorOptions<LAnnotation>);\n    edit(component: DiffsEditableComponent<LAnnotation>): () => void;\n    syncToRenderedView(highlighter: DiffsHighlighter, fileContainer: HTMLElement, fileContents: FileContents, didFileChange: boolean, lineAnnotations: DiffLineAnnotation<LAnnotation>[] | undefined, renderRange: RenderRange | undefined): void;\n    postponeBackgroundTokenizeToNextFrame(): void;\n    setSelections(selections: DiffsEditorSelection[]): void;\n    setMarkers(markers: Marker[]): void;\n    focus(options?: FocusOptions): void;\n    cleanUp(): void;\n}\n//# sourceMappingURL=editor.d.ts.map"],"mappings":";;;;;UAGiBU;;EAAAA,gBAAa,CAAA,EAAA,OAAAC;EAM+BA;EAAvBF,sBAAAA,CAAAA,EAAAA,OAAAA;EAAwCG;EAExDP,qBAAAA,CAAAA,EAAAA,CAAAA,OAAAA,EAFgBI,sBAEhBJ,CAFuCM,WAEvCN,CAAAA,EAAAA,GAFwDO,WAExDP;EAAmDM;EAAnBX,QAAAA,CAAAA,EAAAA,CAAAA,IAAAA,EAAhCK,YAAgCL,EAAAA,eAAAA,CAAAA,EAAAA,kBAAAA,CAAmBW,WAAnBX,CAAAA,EAAAA,GAAoCM,cAApCN,CAAAA,GAAAA,CAAAA,EAAAA,EAAAA,GAAAA,IAAAA;EAAoCM,OAAAA,CAAAA,EAAAA,OAAAA;;AAGrEO,cAAAA,MAAMF,CAAAA,WAAA,CAAA,YAAyBT,WAAzB,CAAqCS,WAArC,CAAA,CAAA;EAAqCA,CAAAA,OAAAA;EAExBA,WAAAA,CAAAA,OAAAA,CAAAA,EAAdD,aAAcC,CAAAA,WAAAA,CAAAA;EAAdD,IAAAA,CAAAA,SAAAA,EACNT,sBADMS,CACiBC,WADjBD,CAAAA,CAAAA,EAAAA,GAAAA,GAAAA,IAAAA;EACiBC,kBAAAA,CAAAA,WAAAA,EACPP,gBADOO,EAAAA,aAAAA,EAC0BC,WAD1BD,EAAAA,YAAAA,EACqDN,YADrDM,EAAAA,aAAAA,EAAAA,OAAAA,EAAAA,eAAAA,EAC4GX,kBAD5GW,CAC+HA,WAD/HA,CAAAA,EAAAA,GAAAA,SAAAA,EAAAA,WAAAA,EACwKJ,WADxKI,GAAAA,SAAAA,CAAAA,EAAAA,IAAAA;EAAvBV,qCAAAA,CAAAA,CAAAA,EAAAA,IAAAA;EACgBG,aAAAA,CAAAA,UAAAA,EAEND,oBAFMC,EAAAA,CAAAA,EAAAA,IAAAA;EAAiCQ,UAAAA,CAAAA,OAAAA,EAG7CJ,MAH6CI,EAAAA,CAAAA,EAAAA,IAAAA;EAA2BP,KAAAA,CAAAA,OAAAA,CAAAA,EAI5ES,YAJ4ET,CAAAA,EAAAA,IAAAA;EAA0EM,OAAAA,CAAAA,CAAAA,EAAAA,IAAAA"}
+{"version":3,"file":"editor.d.ts","names":[],"sources":["../../src/editor/editor.ts"],"mappings":";;;;;;;UAoGiB,aAAA;;EAEf,iBAAA;EAF4B;EAI5B,gBAAA;EAKe;;;;EAAf,YAAA,GAAe,YAAA;EAoBE;;;;EAfjB,sBAAA;EAqBuC;;;;;EAfvC,SAAA;IACE,QAAA,QAAgB,OAAA;EAAA;EAZH;EAef,qBAAA,IACE,OAAA,EAAS,sBAAA,CAAuB,WAAA,MAC7B,WAAA;EANL;EAQA,QAAA,IACE,MAAA,EAAQ,MAAA,CAAO,WAAA,GACf,YAAA,EAAc,sBAAA,CAAuB,WAAA;EATrB;EAYlB,QAAA,IACE,IAAA,EAAM,YAAA,EACN,eAAA,GAAkB,kBAAA,CAAmB,WAAA;EAEvC,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;EA2GtD,WAAA,CAAY,OAAA,GAAS,aAAA,CAAc,WAAA;EAInC,IAAA,CAAK,SAAA,EAAW,sBAAA,CAAuB,WAAA;EAnI/B;;;EAuKR,UAAA,CAAW,KAAA,EAAO,QAAA,IAAY,aAAA;EAtK5B;EAAA,IAmPE,OAAA;EAjPG;EAAA,IAsPH,OAAA;EAnPW;EAwPf,IAAA;EAxP0B;EA6P1B,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;EA4BpB,KAAA,CAAM,OAAA,GAAU,YAAA;EAchB,IAAA;EAIA,OAAA;EA/VA;EA+YA,uCAAA;EA9YA;EAyZA,gBAAA,EAAkB,WAAA,CAAY,WAAA;AAAA"}