@reiwuzen/blocky 1.2.0 → 1.3.1

package/dist/index.cjs

@@ -21,14 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   applyMarkdownTransform: () => applyMarkdownTransform,
-  blockDeleteLastChar: () => blockDeleteLastChar,
-  blockDeleteRange: () => blockDeleteRange,
-  blockInsertAt: () => blockInsertAt,
-  blockReplaceRange: () => blockReplaceRange,
   canRedo: () => canRedo,
   canUndo: () => canUndo,
   changeBlockType: () => changeBlockType,
   createBlock: () => createBlock,
+  createBlockAfter: () => createBlockAfter,
   createHistory: () => createHistory,
   currentBlocks: () => currentBlocks,
   deleteBlock: () => deleteBlock,
@@ -37,8 +34,7 @@ __export(index_exports, {
   deserialize: () => deserialize,
   deserializeNodes: () => deserializeNodes,
   duplicateBlock: () => duplicateBlock,
-  flatToPosition: () => flatToPosition,
-  flatToSelection: () => flatToSelection,
+  duplicateBlockAfter: () => duplicateBlockAfter,
   formatNodes: () => formatNodes,
   generateId: () => generateId,
   indentBlock: () => indentBlock,
@@ -48,7 +44,6 @@ __export(index_exports, {
   mergeBlocks: () => mergeBlocks,
   moveBlock: () => moveBlock,
   outdentBlock: () => outdentBlock,
-  positionToFlat: () => positionToFlat,
   push: () => push,
   redo: () => redo,
   removeLink: () => removeLink,
@@ -70,7 +65,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/utils/block.ts
+// src/engine/block.ts
 var import_result = require("@reiwuzen/result");
 var import_uuid = require("uuid");
 function generateId(fn) {
@@ -109,12 +104,28 @@ function createBlock(type, idFn) {
     return block;
   });
 }
-function insertBlockAfter(blocks, afterId, type, idFn) {
-  return createBlock(type, idFn).map((newBlock) => {
+function createBlockAfter(blocks, afterId, type, idFn) {
+  return createBlock(type, idFn).andThen((newBlock) => {
     const index = blocks.findIndex((b) => b.id === afterId);
+    if (index === -1) return import_result.Result.Err(`[BlockNotFound]: ${afterId}`);
     const next = [...blocks];
     next.splice(index + 1, 0, newBlock);
-    return { blocks: next, newId: newBlock.id };
+    return import_result.Result.Ok({ blocks: next, newId: newBlock.id });
+  });
+}
+function insertBlockAfter(blocks, afterId, insertBlock) {
+  const targetBlockIndex = blocks.findIndex((b) => b.id === afterId);
+  if (targetBlockIndex === -1) {
+    return import_result.Result.Err(`No block found with id: ${afterId}`);
+  }
+  const newBlocks = [
+    ...blocks.slice(0, targetBlockIndex + 1),
+    insertBlock,
+    ...blocks.slice(targetBlockIndex + 1)
+  ];
+  return import_result.Result.Ok({
+    blocks: newBlocks,
+    newFocusId: insertBlock.id
   });
 }
 function deleteBlock(blocks, id) {
@@ -122,8 +133,19 @@ function deleteBlock(blocks, id) {
   const prevId = blocks[index - 1]?.id ?? blocks[index + 1]?.id ?? "";
   return { blocks: blocks.filter((b) => b.id !== id), prevId };
 }
-function duplicateBlock(incoming, newId) {
-  return { ...incoming, id: newId };
+function duplicateBlock(incoming, newId = crypto.randomUUID()) {
+  return {
+    ...incoming,
+    id: newId,
+    meta: { ...incoming.meta },
+    content: incoming.content.map((node) => ({ ...node }))
+  };
+}
+function duplicateBlockAfter(blocks, id, newId) {
+  const targetBlock = blocks.find((b) => b.id === id);
+  if (targetBlock == null) return import_result.Result.Err(`[BlockNotFound]: ${id}`);
+  const dup = duplicateBlock(targetBlock, newId);
+  return insertBlockAfter(blocks, id, dup);
 }
 function moveBlock(blocks, id, direction) {
   const index = blocks.findIndex((b) => b.id === id);
@@ -439,25 +461,56 @@ function splitBlock(block, nodeIndex, offset) {
   const targetLen = target ? getTextLength(target) : 0;
   if (offset < 0 || offset > targetLen)
     return import_result3.Result.Err(`offset (${offset}) out of bounds`);
+  const atStart = nodeIndex === 0 && offset === 0;
+  const atEnd = nodeIndex === nodes.length - 1 && offset === targetLen;
   const beforeNodes = [
     ...nodes.slice(0, nodeIndex),
-    ...target && offset > 0 ? [sliceNode(target, 0, offset)].filter(Boolean) : []
+    ...target && offset > 0 ? [sliceNode(target, 0, offset)].filter(isNode) : []
   ];
   const afterNodes = [
-    ...target && offset < targetLen ? [sliceNode(target, offset, targetLen)].filter(Boolean) : [],
+    ...target && offset < targetLen ? [sliceNode(target, offset, targetLen)].filter(isNode) : [],
     ...nodes.slice(nodeIndex + 1)
   ];
-  const original = {
+  if (atStart) {
+    const left2 = {
+      ...block,
+      content: []
+    };
+    const right2 = {
+      id: generateId(),
+      type: block.type,
+      content: nodes,
+      meta: {}
+    };
+    return import_result3.Result.Ok([left2, right2]);
+  }
+  if (atEnd) {
+    const left2 = {
+      ...block,
+      content: nodes
+    };
+    const right2 = {
+      id: generateId(),
+      type: "paragraph",
+      content: [],
+      meta: {}
+    };
+    return import_result3.Result.Ok([left2, right2]);
+  }
+  const left = {
     ...block,
     content: beforeNodes
   };
-  const newBlock = {
+  const right = {
     id: generateId(),
     type: "paragraph",
     content: afterNodes,
     meta: {}
   };
-  return import_result3.Result.Ok([original, newBlock]);
+  return import_result3.Result.Ok([left, right]);
+}
+function isNode(node) {
+  return node !== null;
 }
 function mergeBlocks(blockA, blockB) {
   if (blockA.type === "code" || blockA.type === "equation")
@@ -511,18 +564,6 @@ function stripPrefix(block, prefix) {
   if (stripped.length === 0) return [];
   return [{ ...first, text: stripped }, ...block.content.slice(1)];
 }
-function buildMeta(type) {
-  switch (type) {
-    case "bullet":
-    case "number":
-    case "todo":
-      return { depth: 0 };
-    case "heading1":
-    case "heading2":
-    case "heading3":
-      return {};
-  }
-}
 function applyMarkdownTransform(block, cursorOffset) {
   if (block.type !== "paragraph")
     return import_result4.Result.Ok({ block, converted: false });
@@ -539,7 +580,7 @@ function applyMarkdownTransform(block, cursorOffset) {
     id: block.id,
     type: targetType,
     content: strippedContent,
-    meta: buildMeta(targetType)
+    meta: buildMetaForTarget(targetType)
   };
   return import_result4.Result.Ok({ block: converted, converted: true });
 }
@@ -766,67 +807,8 @@ ${block.content[0].text}
   }).join("\n\n");
 }
 
-// src/engine/cursor.ts
-var import_result6 = require("@reiwuzen/result");
-function getTextLength2(node) {
-  if (node.type === "text" || node.type === "code") return node.text.length;
-  if (node.type === "equation") return node.latex.length;
-  return 0;
-}
-function flatToPosition(block, flatOffset) {
-  if (block.type === "code" || block.type === "equation") {
-    const node = block.content[0];
-    const len = getTextLength2(node);
-    if (flatOffset < 0 || flatOffset > len)
-      return import_result6.Result.Err(`flatOffset (${flatOffset}) out of bounds (length=${len})`);
-    return import_result6.Result.Ok({ nodeIndex: 0, offset: flatOffset });
-  }
-  const nodes = block.content;
-  if (flatOffset < 0)
-    return import_result6.Result.Err(`flatOffset (${flatOffset}) cannot be negative`);
-  let accumulated = 0;
-  for (let i = 0; i < nodes.length; i++) {
-    const len = getTextLength2(nodes[i]);
-    if (flatOffset <= accumulated + len) {
-      return import_result6.Result.Ok({ nodeIndex: i, offset: flatOffset - accumulated });
-    }
-    accumulated += len;
-  }
-  if (flatOffset === accumulated) {
-    const last = nodes.length - 1;
-    return import_result6.Result.Ok({ nodeIndex: Math.max(0, last), offset: getTextLength2(nodes[last]) });
-  }
-  return import_result6.Result.Err(
-    `flatOffset (${flatOffset}) out of bounds (total length=${accumulated})`
-  );
-}
-function flatToSelection(block, start, end) {
-  if (start > end)
-    return import_result6.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
-    }))
-  );
-}
-function positionToFlat(block, nodeIndex, offset) {
-  if (block.type === "code" || block.type === "equation")
-    return import_result6.Result.Ok(offset);
-  const nodes = block.content;
-  if (nodeIndex < 0 || nodeIndex >= nodes.length)
-    return import_result6.Result.Err(`nodeIndex (${nodeIndex}) out of bounds`);
-  let flat = 0;
-  for (let i = 0; i < nodeIndex; i++) {
-    flat += getTextLength2(nodes[i]);
-  }
-  return import_result6.Result.Ok(flat + offset);
-}
-
 // src/engine/history.ts
-var import_result7 = require("@reiwuzen/result");
+var import_result6 = require("@reiwuzen/result");
 function createHistory(initialBlocks) {
   return {
     past: [],
@@ -844,9 +826,9 @@ function push(history, blocks, maxSize = 100) {
 }
 function undo(history) {
   if (history.past.length === 0)
-    return import_result7.Result.Err("Nothing to undo");
+    return import_result6.Result.Err("Nothing to undo");
   const previous = history.past[history.past.length - 1];
-  return import_result7.Result.Ok({
+  return import_result6.Result.Ok({
     past: history.past.slice(0, -1),
     present: previous,
     future: [history.present, ...history.future]
@@ -854,9 +836,9 @@ function undo(history) {
 }
 function redo(history) {
   if (history.future.length === 0)
-    return import_result7.Result.Err("Nothing to redo");
+    return import_result6.Result.Err("Nothing to redo");
   const next = history.future[0];
-  return import_result7.Result.Ok({
+  return import_result6.Result.Ok({
     past: [...history.past, history.present],
     present: next,
     future: history.future.slice(1)
@@ -865,54 +847,14 @@ function redo(history) {
 var canUndo = (history) => history.past.length > 0;
 var canRedo = (history) => history.future.length > 0;
 var currentBlocks = (history) => history.present.blocks;
-
-// src/engine/block.ts
-function blockInsertAt(block, nodeIndex, offset, incoming) {
-  return insertAt(block, nodeIndex, offset, incoming).map(
-    (content) => ({
-      ...block,
-      content
-    })
-  );
-}
-function blockDeleteLastChar(block) {
-  return deleteLastChar(block).map(
-    (content) => ({
-      ...block,
-      content
-    })
-  );
-}
-function blockDeleteRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset) {
-  return deleteRange(
-    block,
-    startNodeIndex,
-    startOffset,
-    endNodeIndex,
-    endOffset
-  ).map((content) => ({ ...block, content }));
-}
-function blockReplaceRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset, incoming) {
-  return replaceRange(
-    block,
-    startNodeIndex,
-    startOffset,
-    endNodeIndex,
-    endOffset,
-    incoming
-  ).map((content) => ({ ...block, content }));
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   applyMarkdownTransform,
-  blockDeleteLastChar,
-  blockDeleteRange,
-  blockInsertAt,
-  blockReplaceRange,
   canRedo,
   canUndo,
   changeBlockType,
   createBlock,
+  createBlockAfter,
   createHistory,
   currentBlocks,
   deleteBlock,
@@ -921,8 +863,7 @@ function blockReplaceRange(block, startNodeIndex, startOffset, endNodeIndex, end
   deserialize,
   deserializeNodes,
   duplicateBlock,
-  flatToPosition,
-  flatToSelection,
+  duplicateBlockAfter,
   formatNodes,
   generateId,
   indentBlock,
@@ -932,7 +873,6 @@ function blockReplaceRange(block, startNodeIndex, startOffset, endNodeIndex, end
   mergeBlocks,
   moveBlock,
   outdentBlock,
-  positionToFlat,
   push,
   redo,
   removeLink,

package/dist/index.d.cts

@@ -197,41 +197,6 @@ declare function toPlainText(nodes: Node[]): string;
  */
 declare function toMarkdown(blocks: AnyBlock[]): string;
 
-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)
- */
-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 }
- */
-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.
- */
-declare function positionToFlat(block: AnyBlock, nodeIndex: number, offset: number): Result<number, string>;
-
 type HistoryEntry = {
     blocks: AnyBlock[];
     timestamp: number;
@@ -278,15 +243,23 @@ declare function generateId(fn?: () => string): string;
  * @param idFn       - optional custom id generator (defaults to uuid v7)
  */
 declare function createBlock<T extends BlockType>(type: T, idFn?: () => string): Result<Block<T>, unknown>;
-declare function insertBlockAfter<T extends BlockType>(blocks: AnyBlock[], afterId: string, type: T, idFn?: () => string): Result<{
+declare function createBlockAfter<T extends BlockType>(blocks: AnyBlock[], afterId: string, type: T, idFn?: () => string): Result<{
     blocks: AnyBlock[];
     newId: string;
 }, unknown>;
+declare function insertBlockAfter(blocks: AnyBlock[], afterId: string, insertBlock: AnyBlock): Result<{
+    blocks: AnyBlock[];
+    newFocusId: string;
+}, unknown>;
 declare function deleteBlock(blocks: AnyBlock[], id: string): {
     blocks: AnyBlock[];
     prevId: string;
 };
-declare function duplicateBlock(incoming: AnyBlock, newId: string): AnyBlock;
+declare function duplicateBlock(incoming: AnyBlock, newId?: string): AnyBlock;
+declare function duplicateBlockAfter(blocks: AnyBlock[], id: string, newId?: string): Result<{
+    blocks: AnyBlock[];
+    newFocusId: string;
+}, unknown>;
 /**
  * Move a block up or down by one position in the array.
  * Returns the same array unchanged if block is already at the boundary.
@@ -294,13 +267,4 @@ declare function duplicateBlock(incoming: AnyBlock, newId: string): AnyBlock;
  */
 declare function moveBlock(blocks: AnyBlock[], id: string, direction: "up" | "down"): Result<AnyBlock[], string>;
 
-/**─── Wrappers ──────────────────────────────────────────────────────────────────
-* Each function runs the content engine operation and returns Result<AnyBlock>
-instead of Result<BlockContent<T>> — caller gets the full updated block back.
-*/
-declare function blockInsertAt(block: AnyBlock, nodeIndex: number, offset: number, incoming: Node): Result<AnyBlock>;
-declare function blockDeleteLastChar(block: AnyBlock): Result<AnyBlock>;
-declare function blockDeleteRange(block: AnyBlock, startNodeIndex: number, startOffset: number, endNodeIndex: number, endOffset: number): Result<AnyBlock>;
-declare function blockReplaceRange(block: AnyBlock, startNodeIndex: number, startOffset: number, endNodeIndex: number, endOffset: number, incoming: Node): Result<AnyBlock>;
-
-export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, blockDeleteLastChar, blockDeleteRange, blockInsertAt, blockReplaceRange, canRedo, canUndo, changeBlockType, createBlock, createHistory, currentBlocks, deleteBlock, deleteLastChar, deleteRange, deserialize, deserializeNodes, duplicateBlock, flatToPosition, flatToSelection, formatNodes, generateId, indentBlock, insertAt, insertBlockAfter, mergeAdjacentNodes, mergeBlocks, moveBlock, outdentBlock, positionToFlat, push, redo, removeLink, replaceRange, serialize, serializeNodes, setLink, splitBlock, toMarkdown, toPlainText, toggleBold, toggleColor, toggleHighlight, toggleItalic, toggleStrikethrough, toggleTodo, toggleUnderline, undo };
+export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, canRedo, canUndo, changeBlockType, createBlock, createBlockAfter, createHistory, currentBlocks, deleteBlock, deleteLastChar, deleteRange, deserialize, deserializeNodes, duplicateBlock, duplicateBlockAfter, formatNodes, generateId, indentBlock, insertAt, insertBlockAfter, mergeAdjacentNodes, mergeBlocks, moveBlock, outdentBlock, push, redo, removeLink, replaceRange, serialize, serializeNodes, setLink, splitBlock, toMarkdown, toPlainText, toggleBold, toggleColor, toggleHighlight, toggleItalic, toggleStrikethrough, toggleTodo, toggleUnderline, undo };

package/dist/index.d.ts

@@ -197,41 +197,6 @@ declare function toPlainText(nodes: Node[]): string;
  */
 declare function toMarkdown(blocks: AnyBlock[]): string;
 
-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)
- */
-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 }
- */
-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.
- */
-declare function positionToFlat(block: AnyBlock, nodeIndex: number, offset: number): Result<number, string>;
-
 type HistoryEntry = {
     blocks: AnyBlock[];
     timestamp: number;
@@ -278,15 +243,23 @@ declare function generateId(fn?: () => string): string;
  * @param idFn       - optional custom id generator (defaults to uuid v7)
  */
 declare function createBlock<T extends BlockType>(type: T, idFn?: () => string): Result<Block<T>, unknown>;
-declare function insertBlockAfter<T extends BlockType>(blocks: AnyBlock[], afterId: string, type: T, idFn?: () => string): Result<{
+declare function createBlockAfter<T extends BlockType>(blocks: AnyBlock[], afterId: string, type: T, idFn?: () => string): Result<{
     blocks: AnyBlock[];
     newId: string;
 }, unknown>;
+declare function insertBlockAfter(blocks: AnyBlock[], afterId: string, insertBlock: AnyBlock): Result<{
+    blocks: AnyBlock[];
+    newFocusId: string;
+}, unknown>;
 declare function deleteBlock(blocks: AnyBlock[], id: string): {
     blocks: AnyBlock[];
     prevId: string;
 };
-declare function duplicateBlock(incoming: AnyBlock, newId: string): AnyBlock;
+declare function duplicateBlock(incoming: AnyBlock, newId?: string): AnyBlock;
+declare function duplicateBlockAfter(blocks: AnyBlock[], id: string, newId?: string): Result<{
+    blocks: AnyBlock[];
+    newFocusId: string;
+}, unknown>;
 /**
  * Move a block up or down by one position in the array.
  * Returns the same array unchanged if block is already at the boundary.
@@ -294,13 +267,4 @@ declare function duplicateBlock(incoming: AnyBlock, newId: string): AnyBlock;
  */
 declare function moveBlock(blocks: AnyBlock[], id: string, direction: "up" | "down"): Result<AnyBlock[], string>;
 
-/**─── Wrappers ──────────────────────────────────────────────────────────────────
-* Each function runs the content engine operation and returns Result<AnyBlock>
-instead of Result<BlockContent<T>> — caller gets the full updated block back.
-*/
-declare function blockInsertAt(block: AnyBlock, nodeIndex: number, offset: number, incoming: Node): Result<AnyBlock>;
-declare function blockDeleteLastChar(block: AnyBlock): Result<AnyBlock>;
-declare function blockDeleteRange(block: AnyBlock, startNodeIndex: number, startOffset: number, endNodeIndex: number, endOffset: number): Result<AnyBlock>;
-declare function blockReplaceRange(block: AnyBlock, startNodeIndex: number, startOffset: number, endNodeIndex: number, endOffset: number, incoming: Node): Result<AnyBlock>;
-
-export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, blockDeleteLastChar, blockDeleteRange, blockInsertAt, blockReplaceRange, canRedo, canUndo, changeBlockType, createBlock, createHistory, currentBlocks, deleteBlock, deleteLastChar, deleteRange, deserialize, deserializeNodes, duplicateBlock, flatToPosition, flatToSelection, formatNodes, generateId, indentBlock, insertAt, insertBlockAfter, mergeAdjacentNodes, mergeBlocks, moveBlock, outdentBlock, positionToFlat, push, redo, removeLink, replaceRange, serialize, serializeNodes, setLink, splitBlock, toMarkdown, toPlainText, toggleBold, toggleColor, toggleHighlight, toggleItalic, toggleStrikethrough, toggleTodo, toggleUnderline, undo };
+export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, canRedo, canUndo, changeBlockType, createBlock, createBlockAfter, createHistory, currentBlocks, deleteBlock, deleteLastChar, deleteRange, deserialize, deserializeNodes, duplicateBlock, duplicateBlockAfter, formatNodes, generateId, indentBlock, insertAt, insertBlockAfter, mergeAdjacentNodes, mergeBlocks, moveBlock, outdentBlock, push, redo, removeLink, replaceRange, serialize, serializeNodes, setLink, splitBlock, toMarkdown, toPlainText, toggleBold, toggleColor, toggleHighlight, toggleItalic, toggleStrikethrough, toggleTodo, toggleUnderline, undo };

package/dist/index.js

@@ -1,4 +1,4 @@
-// src/utils/block.ts
+// src/engine/block.ts
 import { Result } from "@reiwuzen/result";
 import { v7 } from "uuid";
 function generateId(fn) {
@@ -37,12 +37,28 @@ function createBlock(type, idFn) {
     return block;
   });
 }
-function insertBlockAfter(blocks, afterId, type, idFn) {
-  return createBlock(type, idFn).map((newBlock) => {
+function createBlockAfter(blocks, afterId, type, idFn) {
+  return createBlock(type, idFn).andThen((newBlock) => {
     const index = blocks.findIndex((b) => b.id === afterId);
+    if (index === -1) return Result.Err(`[BlockNotFound]: ${afterId}`);
     const next = [...blocks];
     next.splice(index + 1, 0, newBlock);
-    return { blocks: next, newId: newBlock.id };
+    return Result.Ok({ blocks: next, newId: newBlock.id });
+  });
+}
+function insertBlockAfter(blocks, afterId, insertBlock) {
+  const targetBlockIndex = blocks.findIndex((b) => b.id === afterId);
+  if (targetBlockIndex === -1) {
+    return Result.Err(`No block found with id: ${afterId}`);
+  }
+  const newBlocks = [
+    ...blocks.slice(0, targetBlockIndex + 1),
+    insertBlock,
+    ...blocks.slice(targetBlockIndex + 1)
+  ];
+  return Result.Ok({
+    blocks: newBlocks,
+    newFocusId: insertBlock.id
   });
 }
 function deleteBlock(blocks, id) {
@@ -50,8 +66,19 @@ function deleteBlock(blocks, id) {
   const prevId = blocks[index - 1]?.id ?? blocks[index + 1]?.id ?? "";
   return { blocks: blocks.filter((b) => b.id !== id), prevId };
 }
-function duplicateBlock(incoming, newId) {
-  return { ...incoming, id: newId };
+function duplicateBlock(incoming, newId = crypto.randomUUID()) {
+  return {
+    ...incoming,
+    id: newId,
+    meta: { ...incoming.meta },
+    content: incoming.content.map((node) => ({ ...node }))
+  };
+}
+function duplicateBlockAfter(blocks, id, newId) {
+  const targetBlock = blocks.find((b) => b.id === id);
+  if (targetBlock == null) return Result.Err(`[BlockNotFound]: ${id}`);
+  const dup = duplicateBlock(targetBlock, newId);
+  return insertBlockAfter(blocks, id, dup);
 }
 function moveBlock(blocks, id, direction) {
   const index = blocks.findIndex((b) => b.id === id);
@@ -367,25 +394,56 @@ function splitBlock(block, nodeIndex, offset) {
   const targetLen = target ? getTextLength(target) : 0;
   if (offset < 0 || offset > targetLen)
     return Result3.Err(`offset (${offset}) out of bounds`);
+  const atStart = nodeIndex === 0 && offset === 0;
+  const atEnd = nodeIndex === nodes.length - 1 && offset === targetLen;
   const beforeNodes = [
     ...nodes.slice(0, nodeIndex),
-    ...target && offset > 0 ? [sliceNode(target, 0, offset)].filter(Boolean) : []
+    ...target && offset > 0 ? [sliceNode(target, 0, offset)].filter(isNode) : []
   ];
   const afterNodes = [
-    ...target && offset < targetLen ? [sliceNode(target, offset, targetLen)].filter(Boolean) : [],
+    ...target && offset < targetLen ? [sliceNode(target, offset, targetLen)].filter(isNode) : [],
     ...nodes.slice(nodeIndex + 1)
   ];
-  const original = {
+  if (atStart) {
+    const left2 = {
+      ...block,
+      content: []
+    };
+    const right2 = {
+      id: generateId(),
+      type: block.type,
+      content: nodes,
+      meta: {}
+    };
+    return Result3.Ok([left2, right2]);
+  }
+  if (atEnd) {
+    const left2 = {
+      ...block,
+      content: nodes
+    };
+    const right2 = {
+      id: generateId(),
+      type: "paragraph",
+      content: [],
+      meta: {}
+    };
+    return Result3.Ok([left2, right2]);
+  }
+  const left = {
     ...block,
     content: beforeNodes
   };
-  const newBlock = {
+  const right = {
     id: generateId(),
     type: "paragraph",
     content: afterNodes,
     meta: {}
   };
-  return Result3.Ok([original, newBlock]);
+  return Result3.Ok([left, right]);
+}
+function isNode(node) {
+  return node !== null;
 }
 function mergeBlocks(blockA, blockB) {
   if (blockA.type === "code" || blockA.type === "equation")
@@ -439,18 +497,6 @@ function stripPrefix(block, prefix) {
   if (stripped.length === 0) return [];
   return [{ ...first, text: stripped }, ...block.content.slice(1)];
 }
-function buildMeta(type) {
-  switch (type) {
-    case "bullet":
-    case "number":
-    case "todo":
-      return { depth: 0 };
-    case "heading1":
-    case "heading2":
-    case "heading3":
-      return {};
-  }
-}
 function applyMarkdownTransform(block, cursorOffset) {
   if (block.type !== "paragraph")
     return Result4.Ok({ block, converted: false });
@@ -467,7 +513,7 @@ function applyMarkdownTransform(block, cursorOffset) {
     id: block.id,
     type: targetType,
     content: strippedContent,
-    meta: buildMeta(targetType)
+    meta: buildMetaForTarget(targetType)
   };
   return Result4.Ok({ block: converted, converted: true });
 }
@@ -694,67 +740,8 @@ ${block.content[0].text}
   }).join("\n\n");
 }
 
-// src/engine/cursor.ts
-import { Result as Result6 } from "@reiwuzen/result";
-function getTextLength2(node) {
-  if (node.type === "text" || node.type === "code") return node.text.length;
-  if (node.type === "equation") return node.latex.length;
-  return 0;
-}
-function flatToPosition(block, flatOffset) {
-  if (block.type === "code" || block.type === "equation") {
-    const node = block.content[0];
-    const len = getTextLength2(node);
-    if (flatOffset < 0 || flatOffset > len)
-      return Result6.Err(`flatOffset (${flatOffset}) out of bounds (length=${len})`);
-    return Result6.Ok({ nodeIndex: 0, offset: flatOffset });
-  }
-  const nodes = block.content;
-  if (flatOffset < 0)
-    return Result6.Err(`flatOffset (${flatOffset}) cannot be negative`);
-  let accumulated = 0;
-  for (let i = 0; i < nodes.length; i++) {
-    const len = getTextLength2(nodes[i]);
-    if (flatOffset <= accumulated + len) {
-      return Result6.Ok({ nodeIndex: i, offset: flatOffset - accumulated });
-    }
-    accumulated += len;
-  }
-  if (flatOffset === accumulated) {
-    const last = nodes.length - 1;
-    return Result6.Ok({ nodeIndex: Math.max(0, last), offset: getTextLength2(nodes[last]) });
-  }
-  return Result6.Err(
-    `flatOffset (${flatOffset}) out of bounds (total length=${accumulated})`
-  );
-}
-function flatToSelection(block, start, end) {
-  if (start > end)
-    return Result6.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
-    }))
-  );
-}
-function positionToFlat(block, nodeIndex, offset) {
-  if (block.type === "code" || block.type === "equation")
-    return Result6.Ok(offset);
-  const nodes = block.content;
-  if (nodeIndex < 0 || nodeIndex >= nodes.length)
-    return Result6.Err(`nodeIndex (${nodeIndex}) out of bounds`);
-  let flat = 0;
-  for (let i = 0; i < nodeIndex; i++) {
-    flat += getTextLength2(nodes[i]);
-  }
-  return Result6.Ok(flat + offset);
-}
-
 // src/engine/history.ts
-import { Result as Result7 } from "@reiwuzen/result";
+import { Result as Result6 } from "@reiwuzen/result";
 function createHistory(initialBlocks) {
   return {
     past: [],
@@ -772,9 +759,9 @@ function push(history, blocks, maxSize = 100) {
 }
 function undo(history) {
   if (history.past.length === 0)
-    return Result7.Err("Nothing to undo");
+    return Result6.Err("Nothing to undo");
   const previous = history.past[history.past.length - 1];
-  return Result7.Ok({
+  return Result6.Ok({
     past: history.past.slice(0, -1),
     present: previous,
     future: [history.present, ...history.future]
@@ -782,9 +769,9 @@ function undo(history) {
 }
 function redo(history) {
   if (history.future.length === 0)
-    return Result7.Err("Nothing to redo");
+    return Result6.Err("Nothing to redo");
   const next = history.future[0];
-  return Result7.Ok({
+  return Result6.Ok({
     past: [...history.past, history.present],
     present: next,
     future: history.future.slice(1)
@@ -793,53 +780,13 @@ function redo(history) {
 var canUndo = (history) => history.past.length > 0;
 var canRedo = (history) => history.future.length > 0;
 var currentBlocks = (history) => history.present.blocks;
-
-// src/engine/block.ts
-function blockInsertAt(block, nodeIndex, offset, incoming) {
-  return insertAt(block, nodeIndex, offset, incoming).map(
-    (content) => ({
-      ...block,
-      content
-    })
-  );
-}
-function blockDeleteLastChar(block) {
-  return deleteLastChar(block).map(
-    (content) => ({
-      ...block,
-      content
-    })
-  );
-}
-function blockDeleteRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset) {
-  return deleteRange(
-    block,
-    startNodeIndex,
-    startOffset,
-    endNodeIndex,
-    endOffset
-  ).map((content) => ({ ...block, content }));
-}
-function blockReplaceRange(block, startNodeIndex, startOffset, endNodeIndex, endOffset, incoming) {
-  return replaceRange(
-    block,
-    startNodeIndex,
-    startOffset,
-    endNodeIndex,
-    endOffset,
-    incoming
-  ).map((content) => ({ ...block, content }));
-}
 export {
   applyMarkdownTransform,
-  blockDeleteLastChar,
-  blockDeleteRange,
-  blockInsertAt,
-  blockReplaceRange,
   canRedo,
   canUndo,
   changeBlockType,
   createBlock,
+  createBlockAfter,
   createHistory,
   currentBlocks,
   deleteBlock,
@@ -848,8 +795,7 @@ export {
   deserialize,
   deserializeNodes,
   duplicateBlock,
-  flatToPosition,
-  flatToSelection,
+  duplicateBlockAfter,
   formatNodes,
   generateId,
   indentBlock,
@@ -859,7 +805,6 @@ export {
   mergeBlocks,
   moveBlock,
   outdentBlock,
-  positionToFlat,
   push,
   redo,
   removeLink,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reiwuzen/blocky",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Pure TypeScript block editor engine. Headless, framework-agnostic — content mutation, formatting, transforms, serialization, and history.",
   "author": "Rei WuZen",
   "license": "ISC",