@reiwuzen/blocky 1.4.3 → 1.4.4

package/dist/index.cjs

@@ -546,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];
@@ -574,13 +575,17 @@ function applyMarkdownTransform(block, cursorOffset) {
     return import_result4.Result.Ok({ block, converted: false });
   if (cursorOffset < match.length)
     return import_result4.Result.Ok({ block, converted: false });
-  const targetType = TRIGGERS[match];
+  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 });
 }

package/dist/index.d.cts

@@ -122,28 +122,39 @@ type TransformResult = {
  * 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>;
 /**

package/dist/index.d.ts

@@ -122,28 +122,39 @@ type TransformResult = {
  * 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>;
 /**

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];
@@ -506,13 +507,17 @@ function applyMarkdownTransform(block, cursorOffset) {
     return Result4.Ok({ block, converted: false });
   if (cursorOffset < match.length)
     return Result4.Ok({ block, converted: false });
-  const targetType = TRIGGERS[match];
+  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 });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reiwuzen/blocky",
-  "version": "1.4.3",
+  "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",