@blankdotpage/cake 0.1.10 → 0.1.12

package/README.md

@@ -49,6 +49,73 @@ npm run demo
 
 ## Library usage
 
+### With React
+
 ```tsx
-import { CakeEditor, defaultEditorSettings } from "@blankdotpage/cake";
+import { CakeEditor } from "@blankdotpage/cake/react";
+import { boldExtension } from "@blankdotpage/cake/extensions/bold";
+import { italicExtension } from "@blankdotpage/cake/extensions/italic";
+import { linkExtension } from "@blankdotpage/cake/extensions/link";
+import { headingExtension } from "@blankdotpage/cake/extensions/heading";
+import { plainTextListExtension } from "@blankdotpage/cake/extensions/list";
+
+const extensions = [
+  headingExtension,
+  plainTextListExtension,
+  boldExtension,
+  italicExtension,
+  linkExtension,
+];
+
+function MyEditor() {
+  const [value, setValue] = useState("");
+
+  return (
+    <CakeEditor
+      value={value}
+      onChange={setValue}
+      extensions={extensions}
+      placeholder="Start typing..."
+    />
+  );
+}
+```
+
+### Without React
+
+```ts
+import { CakeEditor } from "@blankdotpage/cake";
+import { boldExtension } from "@blankdotpage/cake/extensions/bold";
+import { italicExtension } from "@blankdotpage/cake/extensions/italic";
+import { linkExtension } from "@blankdotpage/cake/extensions/link";
+
+const container = document.getElementById("editor");
+
+const engine = new CakeEditor({
+  container,
+  value: "Hello **world**",
+  extensions: [boldExtension, italicExtension, linkExtension],
+  onChange: (value, selection) => {
+    console.log("Content changed:", value);
+  },
+  onSelectionChange: (selection) => {
+    console.log("Selection:", selection);
+  },
+});
+
+// Later: clean up
+engine.destroy();
 ```
+
+### Available extensions
+
+- `blockquoteExtension` - Block quotes (`>`)
+- `boldExtension` - Bold text (`**text**`)
+- `combinedEmphasisExtension` - Combined bold/italic (`***text***`)
+- `headingExtension` - Headings (`#`, `##`, etc.)
+- `imageExtension` - Images (`![alt](url)`)
+- `italicExtension` - Italic text (`*text*`)
+- `linkExtension` - Links (`[text](url)`)
+- `plainTextListExtension` - Ordered and unordered lists
+- `scrollbarExtension` - Custom scrollbar styling
+- `strikethroughExtension` - Strikethrough (`~~text~~`)

package/dist/cake/editor/cake-editor.d.ts

@@ -0,0 +1,230 @@
+import type { Selection } from "../core/types";
+import { type CakeExtension, type EditCommand } from "../core/runtime";
+import type { SelectionRect } from "./selection/selection-geometry";
+type EngineOptions = {
+    container: HTMLElement;
+    contentRoot?: HTMLElement;
+    value: string;
+    selection?: Selection;
+    extensions?: CakeExtension[];
+    onChange?: (value: string, selection: Selection) => void;
+    onSelectionChange?: (selection: Selection) => void;
+    readOnly?: boolean;
+    spellCheckEnabled?: boolean;
+};
+export type RenderPerf = {
+    totalMs: number;
+    renderAndMapMs: number;
+    applySelectionMs: number;
+    didUpdateDom: boolean;
+    blockCount: number;
+    runCount: number;
+};
+export declare class CakeEditor {
+    private container;
+    private runtime;
+    private extensions;
+    private _state;
+    private get state();
+    private set state(value);
+    private contentRoot;
+    private domMap;
+    private isApplyingSelection;
+    private isComposing;
+    private beforeInputHandled;
+    private beforeInputResetId;
+    private keydownHandledBeforeInput;
+    private suppressSelectionChange;
+    private suppressSelectionChangeResetId;
+    private ignoreTouchNativeSelectionUntil;
+    private blockTrustedTextDrag;
+    private selectedAtomicLineIndex;
+    private lastAppliedSelection;
+    private compositionCommit;
+    private compositionCommitTimeoutId;
+    private overlayRoot;
+    private caretElement;
+    private caretBlinkTimeoutId;
+    private overlayUpdateId;
+    private scrollCaretIntoViewId;
+    private selectionRectElements;
+    private lastSelectionRects;
+    private onChange?;
+    private onSelectionChange?;
+    private readOnly;
+    private spellCheckEnabled;
+    private extensionsRoot;
+    private placeholderRoot;
+    private resizeObserver;
+    private lastFocusRect;
+    private verticalNavGoalX;
+    private lastRenderPerf;
+    private history;
+    private pendingClickHit;
+    getLastRenderPerf(): RenderPerf | null;
+    private isEventTargetInContentRoot;
+    private handleBeforeInputBound;
+    private handleInputBound;
+    private handleCompositionStartBound;
+    private handleCompositionEndBound;
+    private handleSelectionChangeBound;
+    private handleFocusInBound;
+    private handleFocusOutBound;
+    private handleScrollBound;
+    private handleResizeBound;
+    private handleClickBound;
+    private handleKeyDownBound;
+    private handlePasteBound;
+    private handleCopyBound;
+    private handleCutBound;
+    private handlePointerDownBound;
+    private handlePointerMoveBound;
+    private handlePointerUpBound;
+    private handleDragStartBound;
+    private handleDragOverBound;
+    private handleDropBound;
+    private handleDragEndBound;
+    private dragState;
+    private dropIndicator;
+    private textDragState;
+    private selectionDragState;
+    private pointerDownPosition;
+    private hasMovedSincePointerDown;
+    private lastTouchTime;
+    private isTouchDevice;
+    constructor(options: EngineOptions);
+    destroy(): void;
+    setReadOnly(readOnly: boolean): void;
+    setSpellCheckEnabled(enabled: boolean): void;
+    getValue(): string;
+    getSelection(): Selection;
+    getCursorLength(): number;
+    getFocusRect(): SelectionRect | null;
+    getContainer(): HTMLElement;
+    getContentRoot(): HTMLElement | null;
+    getLines(): import("./selection/selection-layout").LineInfo[];
+    getOverlayRoot(): HTMLDivElement;
+    syncPlaceholder(): void;
+    insertText(text: string): void;
+    replaceText(oldText: string, newText: string): void;
+    setSelection(selection: Selection): void;
+    setValue({ value, selection }: {
+        value: string;
+        selection?: Selection;
+    }): void;
+    focus(selection?: Selection): void;
+    blur(): void;
+    hasFocus(): boolean;
+    selectAll(): void;
+    undo(): void;
+    redo(): void;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    executeCommand(command: EditCommand, options?: {
+        restoreFocus?: boolean;
+    }): boolean;
+    private attachListeners;
+    private attachDragListeners;
+    private detachDragListeners;
+    private detachListeners;
+    private handleFocusIn;
+    private handleFocusOut;
+    private render;
+    private isEmptyParagraphDoc;
+    private updatePlaceholder;
+    private syncPlaceholderPosition;
+    private updateContentRootAttributes;
+    private applySelection;
+    private handleSelectionChange;
+    private syncSelectionFromDom;
+    private adjustSelectionForAtomicBlocks;
+    private getAtomicBlockSelectionFromClick;
+    private handleClick;
+    private handleKeyDown;
+    private resolveExtensionKeybinding;
+    private handleCopy;
+    private handleCut;
+    private handlePaste;
+    private handleBeforeInput;
+    private applyInputIntent;
+    private handleInput;
+    private handleCompositionStart;
+    private handleCompositionEnd;
+    private resolveBeforeInputIntent;
+    private selectionFromTargetRangesWithStatus;
+    private cursorFromDom;
+    private applyEdit;
+    private handleDeleteAtomicBlockSelection;
+    private handleBackspaceAfterAtomicBlock;
+    private recordHistory;
+    private applySelectionUpdate;
+    private getLayoutForNavigation;
+    private moveSelectionByChar;
+    private moveOffsetByChar;
+    private moveSelectionVertically;
+    private moveSelectionToVisualRowStart;
+    private moveSelectionToVisualRowEnd;
+    private extendSelectionToVisualRowStart;
+    private extendSelectionToVisualRowEnd;
+    private extendSelectionToDocumentStart;
+    private extendSelectionToDocumentEnd;
+    private extendFullLineSelectionByLine;
+    private moveSelectionByWord;
+    private extendSelectionByWord;
+    private moveOffsetByWord;
+    private deleteToVisualRowStart;
+    private handleIndent;
+    private handleOutdent;
+    private readDomText;
+    /**
+     * Reconcile DOM text changes with the model while preserving formatting markers.
+     * Used when external agents (IME, Grammarly) modify the DOM directly.
+     *
+     * Strategy:
+     * 1. Get visible text from DOM (what was modified)
+     * 2. Get visible text from model (what we had)
+     * 3. Find the minimal diff (common prefix/suffix)
+     * 4. Map the changed region from cursor space to source space
+     * 5. Replace the corresponding source region, preserving markers
+     */
+    private reconcileDomChanges;
+    private resolveCollapsedReconcileAffinity;
+    private markBeforeInputHandled;
+    private suppressSelectionChangeForTick;
+    private markCompositionCommit;
+    private clearCompositionCommit;
+    private handleScroll;
+    private handleResize;
+    private openLinkPopoverForSelection;
+    private scheduleOverlayUpdate;
+    private flushOverlayUpdate;
+    private ensureOverlayRoot;
+    private selectionRectsEqual;
+    private ensureExtensionsRoot;
+    private updateExtensionsOverlayPosition;
+    private updateSelectionOverlay;
+    private syncSelectionRects;
+    private updateCaret;
+    private markCaretActive;
+    private stopCaretBlink;
+    private clearCaretBlinkTimer;
+    private scheduleScrollCaretIntoView;
+    private scrollCaretIntoView;
+    private hitTestFromClientPoint;
+    private handlePointerDown;
+    private handlePointerMove;
+    private handlePointerUp;
+    private showDropIndicator;
+    private hideDropIndicator;
+    private findClosestLineByY;
+    private calculateDropLineIndex;
+    private detectFullLineSelection;
+    private moveLines;
+    private handleDragStart;
+    private handleDragOver;
+    private handleDrop;
+    private handleDragEnd;
+    private dataTransferHasImageFile;
+}
+export {};
+//# sourceMappingURL=cake-editor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cake-editor.d.ts","sourceRoot":"","sources":["../../../src/cake/editor/cake-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,WAAW,EAGjB,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAcpE,KAAK,aAAa,GAAG;IACnB,SAAS,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACzD,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AA6BF,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAE9B,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,KAAK,QAEhB;IACD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,yBAAyB,CAAS;IAC1C,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,8BAA8B,CAAuB;IAC7D,OAAO,CAAC,+BAA+B,CAAuB;IAC9D,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,oBAAoB,CAA0B;IACtD,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,0BAA0B,CAAuB;IACzD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,CAA4B;IAC7C,OAAO,CAAC,iBAAiB,CAAC,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,OAAO,CAKb;IAIF,OAAO,CAAC,eAAe,CAGP;IAEhB,iBAAiB,IAAI,UAAU,GAAG,IAAI;IAItC,OAAO,CAAC,0BAA0B;IAiBlC,OAAO,CAAC,sBAAsB,CAAqC;IACnE,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,2BAA2B,CAA0C;IAC7E,OAAO,CAAC,yBAAyB,CAAwC;IACzE,OAAO,CAAC,0BAA0B,CAAyC;IAC3E,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,sBAAsB,CAAqC;IACnE,OAAO,CAAC,sBAAsB,CAAqC;IACnE,OAAO,CAAC,oBAAoB,CAAmC;IAC/D,OAAO,CAAC,oBAAoB,CAAmC;IAC/D,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,kBAAkB,CAAiC;IAG3D,OAAO,CAAC,SAAS,CAMD;IAChB,OAAO,CAAC,aAAa,CAA+B;IAGpD,OAAO,CAAC,aAAa,CAIL;IAEhB,OAAO,CAAC,kBAAkB,CAGV;IAMhB,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,wBAAwB,CAAS;IAIzC,OAAO,CAAC,aAAa,CAAK;IAI1B,OAAO,CAAC,aAAa;gBAOT,OAAO,EAAE,aAAa;IAkBlC,OAAO;IAaP,WAAW,CAAC,QAAQ,EAAE,OAAO;IAK7B,oBAAoB,CAAC,OAAO,EAAE,OAAO;IAKrC,QAAQ;IAIR,YAAY;IAIZ,eAAe;IAIf,YAAY;IAIZ,YAAY;IAIZ,cAAc;IAId,QAAQ;IAIR,cAAc;IAOd,eAAe;IAIf,UAAU,CAAC,IAAI,EAAE,MAAM;IAUvB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAyB5C,YAAY,CAAC,SAAS,EAAE,SAAS;IAUjC,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE;IAiBvE,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS;IAU3B,IAAI;IAIJ,QAAQ;IAWR,SAAS;IAKT,IAAI;IAgBJ,IAAI;IAeJ,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,OAAO;IAIlB,cAAc,CACZ,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO;IAgCV,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,MAAM;IA2Gd,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,2BAA2B;IAQnC,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,qBAAqB;IAwF7B,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,8BAA8B;IA4CtC,OAAO,CAAC,gCAAgC;IA8CxC,OAAO,CAAC,WAAW;IA4KnB,OAAO,CAAC,aAAa;IAyQrB,OAAO,CAAC,0BAA0B;IAsClC,OAAO,CAAC,UAAU;IA8BlB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,WAAW;IA6CnB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,gBAAgB;IAsCxB,OAAO,CAAC,WAAW;IA0CnB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,wBAAwB;IAuGhC,OAAO,CAAC,mCAAmC;IA0C3C,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,gCAAgC;IAoDxC,OAAO,CAAC,+BAA+B;IAqEvC,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,mBAAmB;IA6E3B,OAAO,CAAC,gBAAgB;IAsCxB,OAAO,CAAC,uBAAuB;IAgG/B,OAAO,CAAC,6BAA6B;IA+BrC,OAAO,CAAC,2BAA2B;IA+BnC,OAAO,CAAC,+BAA+B;IA4BvC,OAAO,CAAC,6BAA6B;IAgCrC,OAAO,CAAC,8BAA8B;IAKtC,OAAO,CAAC,4BAA4B;IAKpC,OAAO,CAAC,6BAA6B;IAkDrC,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,sBAAsB;IAyD9B,OAAO,CAAC,YAAY;IAiGpB,OAAO,CAAC,aAAa;IA+FrB,OAAO,CAAC,WAAW;IAcnB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,mBAAmB;IAsG3B,OAAO,CAAC,iCAAiC;IA6BzC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,8BAA8B;IAWtC,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,2BAA2B;IA2BnC,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,+BAA+B;IAcvC,OAAO,CAAC,sBAAsB;IA8C9B,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,2BAA2B;IAanC,OAAO,CAAC,mBAAmB;IA4C3B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,iBAAiB;IAkQzB,OAAO,CAAC,iBAAiB;IAiDzB,OAAO,CAAC,eAAe;IAqFvB,OAAO,CAAC,iBAAiB;IAiDzB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,sBAAsB;IA8B9B,OAAO,CAAC,uBAAuB;IAkD/B,OAAO,CAAC,SAAS;IA0EjB,OAAO,CAAC,eAAe;IAqDvB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,UAAU;IAgKlB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,wBAAwB;CAsBjC"}