@reiwuzen/blocky 1.0.1 → 1.1.0

package/README.md

@@ -202,6 +202,45 @@ undo(h).match(
 );
 ```
 
+### Cursor — `engine/cursor`
+
+Bridges the browser's flat cursor offset to the engine's `nodeIndex + offset` model.
+The browser gives a single number from `window.getSelection()` — these functions convert it.
+
+```ts
+// Convert a flat UI cursor offset → { nodeIndex, offset }
+flatToPosition(block, flatOffset): Result<CursorPosition>
+
+// Convert a flat UI selection → NodeSelection (ready for format/delete functions)
+flatToSelection(block, start, end): Result<NodeSelection>
+
+// Inverse — convert { nodeIndex, offset } back to flat offset (restore cursor in DOM)
+positionToFlat(block, nodeIndex, offset): Result<number>
+```
+
+```ts
+// Typical usage on every keypress / selection
+const sel = window.getSelection();
+flatToSelection(block, sel.anchorOffset, sel.focusOffset)
+  .andThen((nodeSel) => toggleBold(block.content, nodeSel))
+  .match(
+    (content) => updateBlock({ ...block, content }),
+    (err)     => console.error(err)
+  );
+```
+
+### Block Ops — `engine/block-ops`
+
+Wrappers around content functions that return `Result<AnyBlock>` instead of `Result<BlockContent>` —
+useful when you want the full updated block back directly.
+
+```ts
+blockInsertAt(block, nodeIndex, offset, incoming): Result<AnyBlock>
+blockDeleteLastChar(block): Result<AnyBlock>
+blockDeleteRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset): Result<AnyBlock>
+blockReplaceRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset, incoming): Result<AnyBlock>
+```
+
 ### Utils — `utils/block`
 
 ```ts
@@ -224,6 +263,8 @@ src/
 │   └── block.ts
 └── engine/
     ├── content.ts      ← insertAt, deleteLastChar, deleteRange, replaceRange, splitBlock, mergeBlocks
+    ├── block-ops.ts    ← blockInsertAt, blockDeleteLastChar, blockDeleteRange, blockReplaceRange
+    ├── cursor.ts       ← flatToPosition, flatToSelection, positionToFlat
     ├── format.ts       ← toggleBold, toggleItalic, toggleColor, setLink, ...
     ├── transform.ts    ← applyMarkdownTransform, changeBlockType, toggleTodo, indent/outdent
     ├── serializer.ts   ← serialize, deserialize, toMarkdown, toPlainText, ...

package/dist/engine/block.d.ts

@@ -0,0 +1,13 @@
+import type { AnyBlock, Node } from "../types/block";
+import { Result } from "@reiwuzen/result";
+import { splitBlock, mergeBlocks } from "./content";
+/**─── Wrappers ──────────────────────────────────────────────────────────────────
+* Each function runs the content engine operation and returns Result<AnyBlock>
+instead of Result<BlockContent<T>> — caller gets the full updated block back.
+*/
+export declare function blockInsertAt(block: AnyBlock, nodeIndex: number, offset: number, incoming: Node): Result<AnyBlock>;
+export declare function blockDeleteLastChar(block: AnyBlock): Result<AnyBlock>;
+export declare function blockDeleteRange(block: AnyBlock, startNodeIndex: number, startOffset: number, endNodeIndex: number, endOffset: number): Result<AnyBlock>;
+export declare function blockReplaceRange(block: AnyBlock, startNodeIndex: number, startOffset: number, endNodeIndex: number, endOffset: number, incoming: Node): Result<AnyBlock>;
+export { splitBlock, mergeBlocks };
+//# sourceMappingURL=block.d.ts.map

package/dist/engine/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/engine/block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAKL,UAAU,EACV,WAAW,EACZ,MAAM,WAAW,CAAC;AAEnB;;;EAGE;AAEF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,IAAI,GACb,MAAM,CAAC,QAAQ,CAAC,CAQlB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAQrE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,QAAQ,CAAC,CAQlB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,GACb,MAAM,CAAC,QAAQ,CAAC,CASlB;AAGD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/dist/engine/block.js

@@ -0,0 +1,26 @@
+import { insertAt, deleteLastChar, deleteRange, replaceRange, splitBlock, mergeBlocks, } from "./content";
+/**─── Wrappers ──────────────────────────────────────────────────────────────────
+* Each function runs the content engine operation and returns Result<AnyBlock>
+instead of Result<BlockContent<T>> — caller gets the full updated block back.
+*/
+export function blockInsertAt(block, nodeIndex, offset, incoming) {
+    return insertAt(block, nodeIndex, offset, incoming).map((content) => ({
+        ...block,
+        content,
+    }));
+}
+export function blockDeleteLastChar(block) {
+    return deleteLastChar(block).map((content) => ({
+        ...block,
+        content,
+    }));
+}
+export function blockDeleteRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset) {
+    return deleteRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset).map((content) => ({ ...block, content }));
+}
+export function blockReplaceRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset, incoming) {
+    return replaceRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset, incoming).map((content) => ({ ...block, content }));
+}
+// splitBlock already returns Result<[AnyBlock, AnyBlock]> — re-exported as-is
+export { splitBlock, mergeBlocks };
+//# sourceMappingURL=block.js.map

package/dist/engine/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../src/engine/block.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB;;;EAGE;AAEF,MAAM,UAAU,aAAa,CAC3B,KAAe,EACf,SAAiB,EACjB,MAAc,EACd,QAAc;IAEd,OAAO,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG,CACrD,CAAC,OAAO,EAAE,EAAE,CACV,CAAC;QACC,GAAG,KAAK;QACR,OAAO;KACR,CAAa,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAe;IACjD,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,CAC9B,CAAC,OAAO,EAAE,EAAE,CACV,CAAC;QACC,GAAG,KAAK;QACR,OAAO;KACR,CAAa,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAe,EACf,cAAsB,EACtB,WAAmB,EACnB,YAAoB,EACpB,SAAiB;IAEjB,OAAO,WAAW,CAChB,KAAK,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,CACV,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAa,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAe,EACf,cAAsB,EACtB,WAAmB,EACnB,YAAoB,EACpB,SAAiB,EACjB,QAAc;IAEd,OAAO,YAAY,CACjB,KAAK,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,QAAQ,CACT,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAa,CAAC,CAAC;AAC1D,CAAC;AAED,8EAA8E;AAC9E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/dist/engine/cursor.d.ts

@@ -0,0 +1,38 @@
+import type { AnyBlock } from '../types/block';
+import type { NodeSelection } from './format';
+import { Result } from '@reiwuzen/result';
+export type CursorPosition = {
+    nodeIndex: number;
+    offset: number;
+};
+/**
+ * Convert a flat UI cursor offset to { nodeIndex, offset }.
+ *
+ * The browser gives a single number representing position in the
+ * concatenated text of the block. This function walks the node array
+ * and finds which node that position falls in and where within it.
+ *
+ * e.g. nodes = ["Hello"(5), " World"(6)]
+ *   flatOffset=0  → { nodeIndex: 0, offset: 0 }
+ *   flatOffset=5  → { nodeIndex: 0, offset: 5 }  (end of first node)
+ *   flatOffset=6  → { nodeIndex: 1, offset: 1 }
+ *   flatOffset=11 → { nodeIndex: 1, offset: 6 }  (end of last node)
+ */
+export declare function flatToPosition(block: AnyBlock, flatOffset: number): Result<CursorPosition, string>;
+/**
+ * Convert a flat UI selection { start, end } to NodeSelection.
+ *
+ * The browser gives two flat offsets from window.getSelection().
+ * This calls flatToPosition twice and returns a NodeSelection
+ * ready to pass to toggleBold, formatNodes, deleteRange, etc.
+ *
+ * e.g. nodes = ["Hello"(bold), " World"]
+ *   { start: 3, end: 8 } → { startIndex:0, startOffset:3, endIndex:1, endOffset:3 }
+ */
+export declare function flatToSelection(block: AnyBlock, start: number, end: number): Result<NodeSelection, string>;
+/**
+ * Inverse — convert { nodeIndex, offset } back to a flat offset.
+ * Useful after engine operations to restore cursor position in the DOM.
+ */
+export declare function positionToFlat(block: AnyBlock, nodeIndex: number, offset: number): Result<number, string>;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/engine/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/engine/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAYF;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAqChC;AAID;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAY/B;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB"}

package/dist/engine/cursor.js

@@ -0,0 +1,90 @@
+import { Result } from '@reiwuzen/result';
+// ─── Helpers ───────────────────────────────────────────────────────────────────
+function getTextLength(node) {
+    if (node.type === "text" || node.type === "code")
+        return node.text.length;
+    if (node.type === "equation")
+        return node.latex.length;
+    return 0;
+}
+// ─── flatToPosition ────────────────────────────────────────────────────────────
+/**
+ * Convert a flat UI cursor offset to { nodeIndex, offset }.
+ *
+ * The browser gives a single number representing position in the
+ * concatenated text of the block. This function walks the node array
+ * and finds which node that position falls in and where within it.
+ *
+ * e.g. nodes = ["Hello"(5), " World"(6)]
+ *   flatOffset=0  → { nodeIndex: 0, offset: 0 }
+ *   flatOffset=5  → { nodeIndex: 0, offset: 5 }  (end of first node)
+ *   flatOffset=6  → { nodeIndex: 1, offset: 1 }
+ *   flatOffset=11 → { nodeIndex: 1, offset: 6 }  (end of last node)
+ */
+export function flatToPosition(block, flatOffset) {
+    // code/equation blocks are always a single node — offset maps directly
+    if (block.type === "code" || block.type === "equation") {
+        const node = block.content[0];
+        const len = getTextLength(node);
+        if (flatOffset < 0 || flatOffset > len)
+            return Result.Err(`flatOffset (${flatOffset}) out of bounds (length=${len})`);
+        return Result.Ok({ nodeIndex: 0, offset: flatOffset });
+    }
+    const nodes = block.content;
+    if (flatOffset < 0)
+        return Result.Err(`flatOffset (${flatOffset}) cannot be negative`);
+    let accumulated = 0;
+    for (let i = 0; i < nodes.length; i++) {
+        const len = getTextLength(nodes[i]);
+        // offset lands within this node OR at its end (but not the last node)
+        if (flatOffset <= accumulated + len) {
+            return Result.Ok({ nodeIndex: i, offset: flatOffset - accumulated });
+        }
+        accumulated += len;
+    }
+    // flatOffset is exactly at the end of the last node
+    if (flatOffset === accumulated) {
+        const last = nodes.length - 1;
+        return Result.Ok({ nodeIndex: Math.max(0, last), offset: getTextLength(nodes[last]) });
+    }
+    return Result.Err(`flatOffset (${flatOffset}) out of bounds (total length=${accumulated})`);
+}
+// ─── flatToSelection ───────────────────────────────────────────────────────────
+/**
+ * Convert a flat UI selection { start, end } to NodeSelection.
+ *
+ * The browser gives two flat offsets from window.getSelection().
+ * This calls flatToPosition twice and returns a NodeSelection
+ * ready to pass to toggleBold, formatNodes, deleteRange, etc.
+ *
+ * e.g. nodes = ["Hello"(bold), " World"]
+ *   { start: 3, end: 8 } → { startIndex:0, startOffset:3, endIndex:1, endOffset:3 }
+ */
+export function flatToSelection(block, start, end) {
+    if (start > end)
+        return Result.Err(`start (${start}) cannot be greater than end (${end})`);
+    return flatToPosition(block, start).andThen((startPos) => flatToPosition(block, end).map((endPos) => ({
+        startIndex: startPos.nodeIndex,
+        startOffset: startPos.offset,
+        endIndex: endPos.nodeIndex,
+        endOffset: endPos.offset,
+    })));
+}
+// ─── positionToFlat ────────────────────────────────────────────────────────────
+/**
+ * Inverse — convert { nodeIndex, offset } back to a flat offset.
+ * Useful after engine operations to restore cursor position in the DOM.
+ */
+export function positionToFlat(block, nodeIndex, offset) {
+    if (block.type === "code" || block.type === "equation")
+        return Result.Ok(offset);
+    const nodes = block.content;
+    if (nodeIndex < 0 || nodeIndex >= nodes.length)
+        return Result.Err(`nodeIndex (${nodeIndex}) out of bounds`);
+    let flat = 0;
+    for (let i = 0; i < nodeIndex; i++) {
+        flat += getTextLength(nodes[i]);
+    }
+    return Result.Ok(flat + offset);
+}
+//# sourceMappingURL=cursor.js.map

package/dist/engine/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/engine/cursor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { insertAt, deleteLastChar, deleteRange, replaceRange, splitBlock, mergeB
 export { formatNodes, toggleBold, toggleItalic, toggleUnderline, toggleStrikethrough, toggleHighlight, toggleColor, setLink, removeLink, mergeAdjacentNodes } from "./engine/format";
 export { applyMarkdownTransform, changeBlockType, toggleTodo, indentBlock, outdentBlock } from "./engine/transform";
 export { serialize, deserialize, serializeNodes, deserializeNodes, toPlainText, toMarkdown } from "./engine/serializer";
+export { flatToPosition, flatToSelection, positionToFlat, } from './engine/cursor';
 export { createHistory, push, undo, redo, canUndo, canRedo, currentBlocks } from "./engine/history";
 export type { History, HistoryEntry } from "./engine/history";
 export { generateId, createBlock, insertBlockAfter, deleteBlock, duplicateBlock, moveBlock } from "./utils/block";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGhH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrL,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGpH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGxH,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpG,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGlH,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGhH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrL,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGpH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGxH,OAAO,EAAC,cAAc,EAAC,eAAe,EAAC,cAAc,GAAE,MAAM,iBAAiB,CAAA;AAG9E,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpG,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGlH,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -6,6 +6,8 @@ export { formatNodes, toggleBold, toggleItalic, toggleUnderline, toggleStrikethr
 export { applyMarkdownTransform, changeBlockType, toggleTodo, indentBlock, outdentBlock } from "./engine/transform";
 // ─── Serializer ────────────────────────────────────────────────────────────────
 export { serialize, deserialize, serializeNodes, deserializeNodes, toPlainText, toMarkdown } from "./engine/serializer";
+// ─── Cursor ───────────────────────────────────────────────────────────────────
+export { flatToPosition, flatToSelection, positionToFlat, } from './engine/cursor';
 // ─── History ───────────────────────────────────────────────────────────────────
 export { createHistory, push, undo, redo, canUndo, canRedo, currentBlocks } from "./engine/history";
 // ─── Utils ─────────────────────────────────────────────────────────────────────

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEhH,kFAAkF;AAClF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErL,kFAAkF;AAClF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpH,kFAAkF;AAClF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExH,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGpG,kFAAkF;AAClF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEhH,kFAAkF;AAClF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErL,kFAAkF;AAClF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpH,kFAAkF;AAClF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExH,iFAAiF;AACjF,OAAO,EAAC,cAAc,EAAC,eAAe,EAAC,cAAc,GAAE,MAAM,iBAAiB,CAAA;AAE9E,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGpG,kFAAkF;AAClF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reiwuzen/blocky",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Pure TypeScript block editor engine. Headless, framework-agnostic — content mutation, formatting, transforms, serialization, and history.",
   "type": "module",
   "main": "dist/index.js",