@reiwuzen/blocky 1.4.2 → 1.4.4

package/dist/index.cjs

@@ -37,7 +37,6 @@ __export(index_exports, {
   duplicateBlock: () => duplicateBlock,
   duplicateBlockAfter: () => duplicateBlockAfter,
   formatNodes: () => formatNodes,
-  formatParagraphBlock: () => stripPrefix,
   generateId: () => generateId,
   indentBlock: () => indentBlock,
   insertAt: () => insertAt,
@@ -547,12 +546,13 @@ function replaceRange(block, startNodeIndex, startOffset, endNodeIndex, endOffse
 // src/engine/transform.ts
 var import_result4 = require("@reiwuzen/result");
 var TRIGGERS = {
-  "-": "bullet",
-  "1.": "number",
-  "[]": "todo",
-  "#": "heading1",
-  "##": "heading2",
-  "###": "heading3"
+  "-": { type: "bullet", meta: { depth: 0 } },
+  "1.": { type: "number", meta: { depth: 0 } },
+  "[]": { type: "todo", meta: { depth: 0, checked: false } },
+  "[x]": { type: "todo", meta: { depth: 0, checked: true } },
+  "#": { type: "heading1" },
+  "##": { type: "heading2" },
+  "###": { type: "heading3" }
 };
 function getRawText(block) {
   const first = block.content[0];
@@ -567,19 +567,25 @@ function stripPrefix(block, prefix) {
   return [{ ...first, text: stripped }, ...block.content.slice(1)];
 }
 function applyMarkdownTransform(block, cursorOffset) {
-  if (block.type !== "paragraph") return import_result4.Result.Ok({ block, converted: false });
+  if (block.type !== "paragraph")
+    return import_result4.Result.Ok({ block, converted: false });
   const text = getRawText(block);
-  const match = Object.keys(TRIGGERS).sort((a, b) => b.length - a.length).find((trigger) => text === trigger || text.startsWith(trigger + " "));
-  if (!match) return import_result4.Result.Ok({ block, converted: false });
-  const triggerEnd = match.length + 1;
-  if (cursorOffset < triggerEnd) return import_result4.Result.Ok({ block, converted: false });
-  const targetType = TRIGGERS[match];
+  const match = Object.keys(TRIGGERS).sort((a, b) => b.length - a.length).find((trigger) => text === trigger);
+  if (!match)
+    return import_result4.Result.Ok({ block, converted: false });
+  if (cursorOffset < match.length)
+    return import_result4.Result.Ok({ block, converted: false });
+  const spec = TRIGGERS[match];
   const strippedContent = stripPrefix(block, match);
+  const baseMeta = buildMetaForTarget(spec.type);
   const converted = {
     id: block.id,
-    type: targetType,
+    type: spec.type,
     content: strippedContent,
-    meta: buildMetaForTarget(targetType)
+    meta: {
+      ...baseMeta,
+      ...spec.meta ?? {}
+    }
   };
   return import_result4.Result.Ok({ block: converted, converted: true });
 }
@@ -895,7 +901,6 @@ var currentBlocks = (history) => history.present.blocks;
   duplicateBlock,
   duplicateBlockAfter,
   formatNodes,
-  formatParagraphBlock,
   generateId,
   indentBlock,
   insertAt,

package/dist/index.d.cts

@@ -118,33 +118,43 @@ type TransformResult = {
     /** true if the block type was actually changed, false if no trigger matched */
     converted: boolean;
 };
-declare function stripPrefix(block: Block<"paragraph">, prefix: string): Block<"paragraph">["content"];
 /**
  * Attempt to convert a paragraph block into another type based on a
  * Markdown-style prefix typed by the user.
  *
- * Call this when a **space** is typed inside a paragraph block.
+ * This transform is intended to be called by the UI **when the user presses
+ * space** inside a paragraph block.
  *
- * Supported triggers (must appear at position 0, immediately before the space):
+ * The engine itself does NOT check for the space character — the caller is
+ * responsible for invoking this function at the correct time.
  *
- * | Typed    | Converts to |
- * |----------|-------------|
- * | `-`      | bullet      |
- * | `1.`     | number      |
- * | `[]`     | todo        |
- * | `#`      | heading1    |
- * | `##`     | heading2    |
- * | `###`    | heading3    |
+ * Supported triggers (must appear at position 0):
  *
- * Guards — returns `converted: false` without mutating if any fail:
- *   1. `block.type` must be `"paragraph"`
- *   2. The text must start with a known trigger prefix
- *   3. `cursorOffset` must be ≥ `trigger.length + 1` — ensures the space
- *      was typed right after the trigger (blocks mid-text triggers like
- *      `"hello - "` from accidentally converting)
+ * | Typed | Converts to | Meta |
+ * |------|---------------|------|
+ * | `-`   | bullet       | `{ depth: 0 }` |
+ * | `1.`  | number       | `{ depth: 0 }` |
+ * | `[]`  | todo         | `{ depth: 0, checked: false }` |
+ * | `[x]` | todo         | `{ depth: 0, checked: true }` |
+ * | `#`   | heading1     | default meta |
+ * | `##`  | heading2     | default meta |
+ * | `###` | heading3     | default meta |
  *
- * On success the returned block has the trigger prefix stripped from its
- * content and a freshly built `meta` for the target type.
+ * Guards — returns `{ converted: false }` without mutation if any fail:
+ *
+ * 1. `block.type` must be `"paragraph"`
+ * 2. The paragraph text must exactly match a trigger prefix
+ * 3. `cursorOffset` must be ≥ `trigger.length`
+ *
+ * On success:
+ *
+ * - The trigger prefix is stripped from the block content
+ * - A new block is returned with the target type
+ * - `meta` is constructed from:
+ *
+ *   `buildMetaForTarget(type)` + trigger-specific overrides
+ *
+ * The original block object is never mutated.
  */
 declare function applyMarkdownTransform(block: AnyBlock, cursorOffset: number): Result<TransformResult>;
 /**
@@ -323,4 +333,4 @@ declare function duplicateBlockAfter(blocks: AnyBlock[], id: string, newId?: str
  */
 declare function moveBlock(blocks: AnyBlock[], id: string, direction: "up" | "down"): Result<AnyBlock[], string>;
 
-export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, areBlocksSame, canRedo, canUndo, changeBlockType, createBlock, createBlockAfter, createHistory, currentBlocks, deleteBlock, deleteLastChar, deleteRange, deserialize, deserializeNodes, duplicateBlock, duplicateBlockAfter, formatNodes, stripPrefix as formatParagraphBlock, 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 };
+export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, areBlocksSame, 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

@@ -118,33 +118,43 @@ type TransformResult = {
     /** true if the block type was actually changed, false if no trigger matched */
     converted: boolean;
 };
-declare function stripPrefix(block: Block<"paragraph">, prefix: string): Block<"paragraph">["content"];
 /**
  * Attempt to convert a paragraph block into another type based on a
  * Markdown-style prefix typed by the user.
  *
- * Call this when a **space** is typed inside a paragraph block.
+ * This transform is intended to be called by the UI **when the user presses
+ * space** inside a paragraph block.
  *
- * Supported triggers (must appear at position 0, immediately before the space):
+ * The engine itself does NOT check for the space character — the caller is
+ * responsible for invoking this function at the correct time.
  *
- * | Typed    | Converts to |
- * |----------|-------------|
- * | `-`      | bullet      |
- * | `1.`     | number      |
- * | `[]`     | todo        |
- * | `#`      | heading1    |
- * | `##`     | heading2    |
- * | `###`    | heading3    |
+ * Supported triggers (must appear at position 0):
  *
- * Guards — returns `converted: false` without mutating if any fail:
- *   1. `block.type` must be `"paragraph"`
- *   2. The text must start with a known trigger prefix
- *   3. `cursorOffset` must be ≥ `trigger.length + 1` — ensures the space
- *      was typed right after the trigger (blocks mid-text triggers like
- *      `"hello - "` from accidentally converting)
+ * | Typed | Converts to | Meta |
+ * |------|---------------|------|
+ * | `-`   | bullet       | `{ depth: 0 }` |
+ * | `1.`  | number       | `{ depth: 0 }` |
+ * | `[]`  | todo         | `{ depth: 0, checked: false }` |
+ * | `[x]` | todo         | `{ depth: 0, checked: true }` |
+ * | `#`   | heading1     | default meta |
+ * | `##`  | heading2     | default meta |
+ * | `###` | heading3     | default meta |
  *
- * On success the returned block has the trigger prefix stripped from its
- * content and a freshly built `meta` for the target type.
+ * Guards — returns `{ converted: false }` without mutation if any fail:
+ *
+ * 1. `block.type` must be `"paragraph"`
+ * 2. The paragraph text must exactly match a trigger prefix
+ * 3. `cursorOffset` must be ≥ `trigger.length`
+ *
+ * On success:
+ *
+ * - The trigger prefix is stripped from the block content
+ * - A new block is returned with the target type
+ * - `meta` is constructed from:
+ *
+ *   `buildMetaForTarget(type)` + trigger-specific overrides
+ *
+ * The original block object is never mutated.
  */
 declare function applyMarkdownTransform(block: AnyBlock, cursorOffset: number): Result<TransformResult>;
 /**
@@ -323,4 +333,4 @@ declare function duplicateBlockAfter(blocks: AnyBlock[], id: string, newId?: str
  */
 declare function moveBlock(blocks: AnyBlock[], id: string, direction: "up" | "down"): Result<AnyBlock[], string>;
 
-export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, areBlocksSame, canRedo, canUndo, changeBlockType, createBlock, createBlockAfter, createHistory, currentBlocks, deleteBlock, deleteLastChar, deleteRange, deserialize, deserializeNodes, duplicateBlock, duplicateBlockAfter, formatNodes, stripPrefix as formatParagraphBlock, 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 };
+export { type AnyBlock, type Block, type BlockContent, type BlockMeta, type BlockType, type History, type HistoryEntry, type Node, type NodeSelection, applyMarkdownTransform, areBlocksSame, 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

@@ -478,12 +478,13 @@ function replaceRange(block, startNodeIndex, startOffset, endNodeIndex, endOffse
 // src/engine/transform.ts
 import { Result as Result4 } from "@reiwuzen/result";
 var TRIGGERS = {
-  "-": "bullet",
-  "1.": "number",
-  "[]": "todo",
-  "#": "heading1",
-  "##": "heading2",
-  "###": "heading3"
+  "-": { type: "bullet", meta: { depth: 0 } },
+  "1.": { type: "number", meta: { depth: 0 } },
+  "[]": { type: "todo", meta: { depth: 0, checked: false } },
+  "[x]": { type: "todo", meta: { depth: 0, checked: true } },
+  "#": { type: "heading1" },
+  "##": { type: "heading2" },
+  "###": { type: "heading3" }
 };
 function getRawText(block) {
   const first = block.content[0];
@@ -498,19 +499,25 @@ function stripPrefix(block, prefix) {
   return [{ ...first, text: stripped }, ...block.content.slice(1)];
 }
 function applyMarkdownTransform(block, cursorOffset) {
-  if (block.type !== "paragraph") return Result4.Ok({ block, converted: false });
+  if (block.type !== "paragraph")
+    return Result4.Ok({ block, converted: false });
   const text = getRawText(block);
-  const match = Object.keys(TRIGGERS).sort((a, b) => b.length - a.length).find((trigger) => text === trigger || text.startsWith(trigger + " "));
-  if (!match) return Result4.Ok({ block, converted: false });
-  const triggerEnd = match.length + 1;
-  if (cursorOffset < triggerEnd) return Result4.Ok({ block, converted: false });
-  const targetType = TRIGGERS[match];
+  const match = Object.keys(TRIGGERS).sort((a, b) => b.length - a.length).find((trigger) => text === trigger);
+  if (!match)
+    return Result4.Ok({ block, converted: false });
+  if (cursorOffset < match.length)
+    return Result4.Ok({ block, converted: false });
+  const spec = TRIGGERS[match];
   const strippedContent = stripPrefix(block, match);
+  const baseMeta = buildMetaForTarget(spec.type);
   const converted = {
     id: block.id,
-    type: targetType,
+    type: spec.type,
     content: strippedContent,
-    meta: buildMetaForTarget(targetType)
+    meta: {
+      ...baseMeta,
+      ...spec.meta ?? {}
+    }
   };
   return Result4.Ok({ block: converted, converted: true });
 }
@@ -825,7 +832,6 @@ export {
   duplicateBlock,
   duplicateBlockAfter,
   formatNodes,
-  stripPrefix as formatParagraphBlock,
   generateId,
   indentBlock,
   insertAt,

package/package.json

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