@dogsbay/format-dogsbay-md 0.2.0-beta.140 → 0.2.0-beta.142

package/dist/browser.d.ts

@@ -15,6 +15,7 @@ export { dogsbayMdToTree, parseInline, containerOpenBefore, type ParseResult, ty
 export { KNOWN_INLINE_DIRECTIVES, type ParseDiagnostic } from "./diagnostics.js";
 export { KNOWN_BLOCK_DIRECTIVES, LEAF_ONLY_DIRECTIVES, BLOCK_LEAF_DIRECTIVES } from "./plugin-containers.js";
 export { treeToDogsbayMd, nodeToDogsbayMd } from "./serialize.js";
+export { DIRECTIVE_PROPS, PASSTHROUGH_PROP, unknownProps } from "./directive-props.js";
 export type { SerializeOptions } from "./types.js";
 export { inlineToDogsbayMd } from "./inline.js";
 export { transformCodeRegions, transformProseLines, transformProseSegments, fenceOpenBefore, createFenceTracker, } from "./code-regions.js";

package/dist/browser.js

@@ -16,6 +16,8 @@ export { KNOWN_INLINE_DIRECTIVES } from "./diagnostics.js";
 // The `:::name` blocks the parser knows (an editor completes names from it)
 export { KNOWN_BLOCK_DIRECTIVES, LEAF_ONLY_DIRECTIVES, BLOCK_LEAF_DIRECTIVES } from "./plugin-containers.js";
 export { treeToDogsbayMd, nodeToDogsbayMd } from "./serialize.js";
+// The props each known directive draws (an editor completes prop names from it)
+export { DIRECTIVE_PROPS, PASSTHROUGH_PROP, unknownProps } from "./directive-props.js";
 export { inlineToDogsbayMd } from "./inline.js";
 export { transformCodeRegions, transformProseLines, transformProseSegments, fenceOpenBefore, createFenceTracker, } from "./code-regions.js";
 export { maskMinjaInCode, unmaskMinjaInCode, maskAllMinjaOpeners, isMinjaProcessedFence, stripInlineMinjaMarkers, stripFenceMinjaMarkers } from "./minja-mask.js";

package/dist/diagnostics.d.ts

@@ -2,7 +2,7 @@ export interface ParseDiagnostic {
     /** 1-based line in the source (front matter counted). */
     line: number;
     /** Stable kind, for filtering. */
-    code: "unclosed-container" | "stray-closer" | "unknown-container" | "unknown-inline" | "block-directive-inline" | "bad-attributes" | "closer-mismatch" | "dropped-attributes" | "missing-label" | "leaf-as-block" | "nesting-unchecked" | "unknown-prop";
+    code: "unclosed-container" | "stray-closer" | "unknown-container" | "unknown-inline" | "block-directive-inline" | "bad-attributes" | "closer-mismatch" | "dropped-attributes" | "missing-label" | "leaf-as-block" | "nesting-unchecked" | "unknown-prop" | "props-yaml";
     message: string;
     /**
      * The directive's name, without colons, on `unknown-container` and `unknown-inline`: a host that

package/dist/parse.js

@@ -100,7 +100,18 @@ export function dogsbayMdToTree(source, options) {
     attachTableAttrsRow(tokens, content);
     // Before tokensToTree: it changes nothing these read, but read the parse as markdown-it left it
     // A lone-CR source never gets here with diagnostics (see the top), so `lineOf` is set
-    const diagnostics = options?.diagnostics ? collectDiagnostics(tokens, content.split(/\r\n|\n/), lineOf ?? (() => undefined)) : undefined;
+    let diagnostics = options?.diagnostics ? collectDiagnostics(tokens, content.split(/\r\n|\n/), lineOf ?? (() => undefined)) : undefined;
+    if (diagnostics && lineOf && yamlLifted.badProps.length) {
+        for (const bad of yamlLifted.badProps) {
+            // The line YAML stops at, mapped itself: protected directives can add or stash lines in
+            // the block, and an unlifted block's lines go to the output one for one
+            const line = lineOf(bad.line0 + bad.offset);
+            if (line === undefined)
+                continue;
+            diagnostics.push({ line, code: "props-yaml", message: `This reads like a props block, but its YAML does not load (line ${line}: ${bad.message}), so it is read as a rule and text` });
+        }
+        diagnostics = diagnostics.sort((a, b) => a.line - b.line);
+    }
     let tree = foldRelated(tokensToTree(tokens, options?.sourceLines ? lineOf : undefined));
     if (directiveTable) {
         // `preserve` restores every construct as a first-class node. `resolve-first`
@@ -243,6 +254,7 @@ function preprocessYamlBodies(source) {
     const lines = source.split("\n");
     const out = [];
     const lineMap = [];
+    const badProps = [];
     // Which lines are fenced code: a `:::card` shown inside a ```markdown example is text, and the
     // lift must not read its `---` block (it rewrote a docs page's example, 2026-10-27).
     const fence = createFenceTracker();
@@ -284,12 +296,39 @@ function preprocessYamlBodies(source) {
                 i = j + 1; // skip past the closing `---`
                 continue;
             }
+            // Not lifted, but written as props whose YAML does not load: it stays a rule and text, and
+            // a diagnostic says why (the playground's editor highlights it as props)
+            const bad = j < lines.length && !fenced ? propsYamlError(lines, i + 2, j) : undefined;
+            if (bad)
+                badProps.push({ line0: out.length, offset: 2 + bad.line, message: bad.message });
         }
         out.push(line);
         lineMap.push(i);
         i++;
     }
-    return { source: out.join("\n"), lineMap };
+    return { source: out.join("\n"), lineMap, badProps };
+}
+/**
+ * Why the text between a directive's `---` lines is meant as props but does not load: it opens
+ * with a prop-shaped, lower-case `key:` and holds no container line, and js-yaml refuses it. Anything else
+ * (a rule, then prose, then a rule) is not props and gets nothing.
+ */
+function propsYamlError(lines, from, to) {
+    // Lower-case first, as props are: `Note: see [x` after a rule is prose
+    if (from >= to || !/^(?:[a-z_][\w.-]*|"[^"]*"|'[^']*'):(?:[ \t]|\r?$)/.test(lines[from]))
+        return undefined;
+    for (let k = from; k < to; k++)
+        if (CONTAINER_LINE.test(lines[k]))
+            return undefined;
+    try {
+        yaml.load(lines.slice(from, to).join("\n"));
+        return undefined;
+    }
+    catch (err) {
+        const e = err;
+        const line = Math.min(Math.max(e.mark?.line ?? 0, 0), to - from - 1);
+        return { line, message: e.reason ?? "it is not YAML" };
+    }
 }
 /**
  * Parse a single inline string to InlineNode[] (useful for testing).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/format-dogsbay-md",
-  "version": "0.2.0-beta.140",
+  "version": "0.2.0-beta.142",
   "description": "Dogsbay Markdown dialect — canonical format for TreeNode[] with directives, YAML bodies, and intelligent fallbacks",
   "type": "module",
   "main": "dist/index.js",
@@ -40,10 +40,10 @@
     "markdown-it-footnote": "^4.0.0",
     "markdown-it-front-matter": "^0.2.4",
     "pele": "1.6.0",
-    "@dogsbay/corpus": "0.2.0-beta.140",
-    "@dogsbay/minja": "0.2.0-beta.140",
-    "@dogsbay/types": "0.2.0-beta.140",
-    "@dogsbay/serialize-core": "0.2.0-beta.140"
+    "@dogsbay/corpus": "0.2.0-beta.142",
+    "@dogsbay/minja": "0.2.0-beta.142",
+    "@dogsbay/types": "0.2.0-beta.142",
+    "@dogsbay/serialize-core": "0.2.0-beta.142"
   },
   "license": "MIT",
   "repository": {