@sobree/core 0.1.31 → 0.1.32

package/dist/editor/internal/positionMap.d.ts

@@ -8,6 +8,17 @@ import { BlockRegistry } from './blockRegistry';
  * `offset = 0` — block-internal table addressing is a future extension.
  */
 export declare function positionFromDomPoint(hosts: readonly HTMLElement[], registry: BlockRegistry, node: Node, domOffset: number): InlinePosition | null;
+/**
+ * Registry-free `(node, offset)` → block descriptor (`blockId` + offset, plus a
+ * cell address inside a table). The id-based core of {@link positionFromDomPoint},
+ * also used to save/restore a selection across a DOM rebuild (repagination)
+ * where raw node references don't survive.
+ */
+interface BlockPoint {
+    blockId: string;
+    offset: number;
+    cell?: CellAddress;
+}
 /** Build an API `Range` from a live DOM `Range`. */
 export declare function rangeFromDomRange(hosts: readonly HTMLElement[], registry: BlockRegistry, range: Range): ApiRange | null;
 /** Read `window.getSelection()` as a model `Selection`. */
@@ -21,6 +32,15 @@ export declare function domPointFromPosition(hosts: readonly HTMLElement[], pos:
 } | null;
 /** Apply a model `Selection` to `window.getSelection()`. */
 export declare function applySelectionToDom(hosts: readonly HTMLElement[], selection: Selection): boolean;
+export interface SelectionDescriptor {
+    start: BlockPoint;
+    end: BlockPoint;
+    collapsed: boolean;
+}
+/** Capture the live selection as a {@link SelectionDescriptor}, or null. */
+export declare function captureSelectionDescriptor(hosts: readonly HTMLElement[]): SelectionDescriptor | null;
+/** Restore a {@link SelectionDescriptor} to the live DOM (after a rebuild). */
+export declare function applySelectionDescriptor(hosts: readonly HTMLElement[], desc: SelectionDescriptor | null): boolean;
 /** Total character-count length of a block, per the counting rules above. */
 export declare function blockLength(blockEl: Element): number;
 /** The DOM element for body block `index` via the positional `data-block-index`
@@ -31,3 +51,5 @@ export declare function blockElementAtIndex(hosts: readonly HTMLElement[], index
 /** Count distinct blocks in the rendered DOM. Dedups by id so a block split
  *  across a page boundary (two fragments, one id) counts once. */
 export declare function countBlocks(hosts: readonly HTMLElement[]): number;
+type CellAddress = NonNullable<InlinePosition["cell"]>;
+export {};