@sobree/core 0.1.30 → 0.1.31

package/dist/doc/api.d.ts

@@ -50,6 +50,20 @@ export type BlockExpectations = Record<string, number>;
 export interface InlinePosition {
     block: BlockRef;
     offset: number;
+    /**
+     * Set when the position is inside a table cell: the rendered cell address
+     * the `offset` is measured within — `row` (the cell's `<tr>` index in the
+     * table), `col` (its cell index in that row), `blockIndex` (which content
+     * block inside the cell). Absent for ordinary block positions, where
+     * `offset` is the character offset into `block` itself. Lets caret capture
+     * / restore (e.g. undo) land back in the same cell instead of collapsing to
+     * the table boundary.
+     */
+    cell?: {
+        row: number;
+        col: number;
+        blockIndex: number;
+    };
 }
 /**
  * Inclusive range from `from` to `to` — both inline positions. Single-

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

@@ -12,24 +12,22 @@ export declare function positionFromDomPoint(hosts: readonly HTMLElement[], regi
 export declare function rangeFromDomRange(hosts: readonly HTMLElement[], registry: BlockRegistry, range: Range): ApiRange | null;
 /** Read `window.getSelection()` as a model `Selection`. */
 export declare function selectionFromDom(hosts: readonly HTMLElement[], registry: BlockRegistry): Selection;
-/** Resolve an `InlinePosition` to a DOM `{ node, offset }` point. */
-export declare function domPointFromPosition(hosts: readonly HTMLElement[], registry: BlockRegistry, pos: InlinePosition): {
+/** Resolve an `InlinePosition` to a DOM `{ node, offset }` point. Locates the
+ *  block by its stable `data-block-id` — robust to paper / column / list
+ *  nesting, where the block is never a direct host child. */
+export declare function domPointFromPosition(hosts: readonly HTMLElement[], pos: InlinePosition): {
     node: Node;
     offset: number;
 } | null;
 /** Apply a model `Selection` to `window.getSelection()`. */
-export declare function applySelectionToDom(hosts: readonly HTMLElement[], registry: BlockRegistry, selection: Selection): boolean;
+export declare function applySelectionToDom(hosts: readonly HTMLElement[], selection: Selection): boolean;
 /** Total character-count length of a block, per the counting rules above. */
 export declare function blockLength(blockEl: Element): number;
-/**
- * Enumerate blocks across all content hosts in document order,
- * expanding `<ul>`/`<ol>` children as one block each. Returns the
- * total block count.
- */
-export declare function countBlocks(hosts: readonly HTMLElement[]): number;
-/**
- * Return the DOM element that hosts a given block index. For list-item
- * blocks this is the `<li>`; for everything else it's the direct host
- * child.
- */
+/** The DOM element for body block `index` via the positional `data-block-index`
+ *  stamp. Requires `data-block-id` too, so table cell paragraphs (which carry a
+ *  cell-internal `data-block-index` but no id) can't shadow a body block. Valid
+ *  against a freshly-rendered DOM (index === body position). */
 export declare function blockElementAtIndex(hosts: readonly HTMLElement[], index: number): HTMLElement | null;
+/** 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;