@vectojs/markdown 0.25.0 → 0.25.1

package/README.md

@@ -112,7 +112,17 @@ context-menu, so `role` is only needed when even a `url` must not appear in the
 a11y tree. See the [Image reference](https://vectojs.org/reference/ui-image/)
 for the full Visual Flattening trust table and `DecodedImage` lifecycle.
 
-> Documents @vectojs/markdown@0.23.0.
+## Projection policy — `classifyProjectionBlocks` & `applyProjectionMode`
+
+`Markdown` documents negotiate visual projection per block:
+`classifyProjectionBlocks(content)` tags top-level blocks (`prose` for
+headings/paragraphs, `code` for fences, `container` for quotes/lists whose
+nested prose is tagged recursively, canvas for tables/chrome), and
+`applyProjectionMode(root, mode)` switches the subtree — `'canvas'` forces
+canvas pixels, `'dom'` materializes prose/code, `'hybrid'` sets `'auto'`
+everywhere so the engine negotiates per block.
+
+> Documents @vectojs/markdown@0.25.0.
 
 ## Documentation
 

package/dist/index.js

@@ -6773,10 +6773,23 @@ function classifyProjectionBlock(node, index) {
   }
   return { node, label: `${index}: ${node.constructor.name} (canvas leaf)`, domKind: "" };
 }
+function classifyNestedChildren(node) {
+  for (const child of node.children) {
+    if (child instanceof import_ui5.Text || child instanceof import_ui5.RichText) {
+      child.domKind = "prose";
+    } else if (child instanceof CodeBlock) {
+      child.domKind = "code";
+    } else if (child instanceof import_ui5.Table) {
+    } else if (child.children.length > 0) {
+      classifyNestedChildren(child);
+    }
+  }
+}
 function classifyProjectionBlocks(content) {
   const blocks = content.children.map((child, i) => classifyProjectionBlock(child, i));
   for (const { node, domKind } of blocks) {
     if (domKind) node.domKind = domKind;
+    if (domKind === "container") classifyNestedChildren(node);
   }
   return blocks;
 }

package/dist/index.mjs

@@ -6723,10 +6723,23 @@ function classifyProjectionBlock(node, index) {
   }
   return { node, label: `${index}: ${node.constructor.name} (canvas leaf)`, domKind: "" };
 }
+function classifyNestedChildren(node) {
+  for (const child of node.children) {
+    if (child instanceof Text2 || child instanceof RichText3) {
+      child.domKind = "prose";
+    } else if (child instanceof CodeBlock) {
+      child.domKind = "code";
+    } else if (child instanceof Table2) {
+    } else if (child.children.length > 0) {
+      classifyNestedChildren(child);
+    }
+  }
+}
 function classifyProjectionBlocks(content) {
   const blocks = content.children.map((child, i) => classifyProjectionBlock(child, i));
   for (const { node, domKind } of blocks) {
     if (domKind) node.domKind = domKind;
+    if (domKind === "container") classifyNestedChildren(node);
   }
   return blocks;
 }

package/dist/projection-policy.d.ts

@@ -19,11 +19,13 @@ import { Stack } from '@vectojs/ui';
  * - `Table` → `''` (unsupported-kind): composite interactive widget, stays
  *   canvas with a reported reason.
  * - Grouping wrappers (children present, no specific class) → `'container'`:
- *   never materialized itself; children negotiate individually.
+ *   never materialized itself; the pass recurses into its children so nested
+ *   prose/code negotiates individually (r8, CTX-0608).
  * - Anything else (rules, borders, backgrounds) → `''`: canvas leaves.
  *
- * Kinds are assigned to top-level blocks only; nested content keeps its own
- * `domKind` (default `''` → canvas, reported) until a finer pass tags it.
+ * Tables stay canvas even when nested inside a container (composite widget,
+ * cell text included). Grouping wrappers below the top level keep `domKind`
+ * `''` (reported fallback) — only nested prose/code leaves are tagged.
  */
 /** Dogfood switcher mode (RFC4 §6): forced canvas, forced dom, or negotiated. */
 export type MarkdownProjectionMode = 'canvas' | 'dom' | 'hybrid';
@@ -40,6 +42,8 @@ export declare function classifyProjectionBlock(node: Entity, index: number): Cl
 /**
  * Top-level blocks of a document's content stack, in order, with kinds
  * assigned onto the blocks (idempotent — re-running keeps prior kinds).
+ * Container blocks additionally have their nested prose/code tagged via
+ * {@link classifyNestedChildren} (idempotent for the same reason).
  */
 export declare function classifyProjectionBlocks(content: Stack): ClassifiedProjectionBlock[];
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/markdown",
-  "version": "0.25.0",
+  "version": "0.25.1",
   "publishConfig": {
     "access": "public"
   },