@dogsbay/format-dogsbay-md 0.2.0-beta.121 → 0.2.0-beta.123

package/dist/attributes.d.ts

@@ -45,4 +45,3 @@ export declare function escapeAttrValue(value: string): string;
  * This is the common glue between TreeNode.props and attribute output.
  */
 export declare function splitProps(props: Record<string, unknown> | undefined, excludeKeys?: string[]): RenderedAttrs;
-//# sourceMappingURL=attributes.d.ts.map

package/dist/attributes.js

@@ -92,4 +92,3 @@ export function splitProps(props, excludeKeys = []) {
     }
     return result;
 }
-//# sourceMappingURL=attributes.js.map

package/dist/browser.d.ts

@@ -20,4 +20,3 @@ export { maskMinjaInCode, unmaskMinjaInCode, maskAllMinjaOpeners, isMinjaProcess
 export { extractHeadings, slugifyHeadingText, type HeadingInfo } from "./headings.js";
 export { splitFrontmatter, type Frontmatter } from "./frontmatter.js";
 export { TemplatePages, TemplatePageError, declaresParams, ATTRIBUTE_BLOCK_OPEN, type TemplatePagesOptions } from "./template-pages.js";
-//# sourceMappingURL=browser.d.ts.map

package/dist/browser.js

@@ -19,4 +19,3 @@ export { maskMinjaInCode, unmaskMinjaInCode, maskAllMinjaOpeners, isMinjaProcess
 export { extractHeadings, slugifyHeadingText } from "./headings.js";
 export { splitFrontmatter } from "./frontmatter.js";
 export { TemplatePages, TemplatePageError, declaresParams, ATTRIBUTE_BLOCK_OPEN } from "./template-pages.js";
-//# sourceMappingURL=browser.js.map

package/dist/capabilities.d.ts

@@ -0,0 +1,25 @@
+/**
+ * What the Dogsbay MD exporter can and cannot represent — a CONTRACT (the
+ * format-docusaurus pattern): one cell per `MATRIX_ROWS` type of the
+ * component × format matrix, checked by `validateCapabilities` and by
+ * tests/capabilities.test.ts.
+ *
+ * Dogsbay MD is the CANONICAL source format, so the bar for `full` is a
+ * round trip: `treeToDogsbayMd` → `dogsbayMdToTree` gives back the same tree
+ * (modulo canonical spelling — `:::tab[One]` comes back as the deflist tab
+ * form, a trailing newline on raw HTML). Each `full` below was measured that
+ * way, not assumed.
+ *
+ * Support levels: full — round-trips · partial — survives with reduced
+ * fidelity (the note says how) · none — dropped or flattened (the note says
+ * what is lost).
+ *
+ * Types with no `case` in `renderNode` fall to `renderUnknown`: with the
+ * default `unknownNodes: "html"` it writes `node.html` if present, else the
+ * children (the wrapper and its props are lost), else
+ * `<!-- unsupported: <type> -->`. Nothing is recorded — there is no export
+ * ledger in this package yet — so every partial/none here is a loss the
+ * exporter does not report.
+ */
+import type { CapabilityDeclaration } from "@dogsbay/serialize-core";
+export declare const DOGSBAY_MD_CAPABILITIES: CapabilityDeclaration[];

package/dist/capabilities.js

@@ -0,0 +1,91 @@
+export const DOGSBAY_MD_CAPABILITIES = [
+    // ── Blocks ───────────────────────────────────────────────
+    { feature: "heading", support: "full", rendersAs: "`#`–`######` with `{#id .class}` attrs" },
+    { feature: "paragraph", support: "full" },
+    { feature: "blockquote", support: "full", rendersAs: "`> …`" },
+    { feature: "unordered-list", support: "full", rendersAs: "`- item`" },
+    { feature: "ordered-list", support: "full", rendersAs: "`1. item`" },
+    { feature: "hr", support: "full", rendersAs: "`---`" },
+    {
+        feature: "table",
+        support: "partial",
+        rendersAs: "GFM pipe table + `{caption=\"…\"}`; an HTML `<table>` when a cell holds blocks, a row has `th` cells, or the table is headerless",
+        note: "A simple table round-trips. The HTML fallback re-parses as a raw `html` node, not a `table`; inside it blocks other than paragraph/list/code/callout/table collapse to their content and kbd/icon/math/footnote-ref degrade to text.",
+    },
+    { feature: "code", support: "full", rendersAs: "fenced block with language, `title=\"…\"` and line-highlight meta" },
+    { feature: "math-block", support: "full", rendersAs: "`$$ … $$`" },
+    { feature: "deflist", support: "full", rendersAs: "`Term` / `: definition`" },
+    { feature: "figure", support: "full", rendersAs: "`:::figure{caption=\"…\"}`; a captionless figure is written as its content" },
+    { feature: "footnote-list", support: "full", rendersAs: "`[^label]: …` definitions" },
+    { feature: "html", support: "full", rendersAs: "the raw HTML, verbatim" },
+    {
+        feature: "html-container",
+        support: "partial",
+        rendersAs: "`node.html` verbatim, or the container's children as blocks",
+        note: "Content is kept; a children-only container (the shape the mkdocs md_in_html, asciidoc and mdx importers produce) loses its wrapper tag and attributes.",
+    },
+    {
+        feature: "diagram",
+        support: "partial",
+        rendersAs: "a ```mermaid fence with the diagram source",
+        note: "The source round-trips (it re-parses as a code fence, which the build turns back into a diagram); a pre-rendered SVG is not kept.",
+    },
+    { feature: "youtube", support: "full", rendersAs: "`:::youtube{#id title=\"…\"}`" },
+    // ── Components ───────────────────────────────────────────
+    { feature: "callout", support: "full", rendersAs: "GitHub alert `> [!NOTE]`; `:::type[Title]{…}` for a custom title or a non-GitHub type" },
+    { feature: "details", support: "full", rendersAs: "`:::details{title=\"…\"}`" },
+    { feature: "details-sheet", support: "full", rendersAs: "`:::details{title=\"…\" sheet}`" },
+    { feature: "theme", support: "full", rendersAs: "`:::theme{name=\"dark\"}` around the content" },
+    { feature: "tabs-variant", support: "full", rendersAs: "`:::tabs{variant=\"pills\"}`" },
+    { feature: "tone", support: "full", rendersAs: "`tone=\"…\"` on `:::cards` or `:::card`" },
+    { feature: "tabs", support: "full", rendersAs: "`:::tabs` with the deflist tab form (`Label` / `:   body`)" },
+    { feature: "steps", support: "full", rendersAs: "`:::steps` around an ordered list" },
+    { feature: "accordion", support: "full", rendersAs: "`:::accordion` with deflist items" },
+    { feature: "cards", support: "full", rendersAs: "`:::cards` — compact YAML list when every card body is paragraphs, `:::card` directives otherwise" },
+    { feature: "card", support: "full", rendersAs: "`:::card{title href …}`" },
+    { feature: "link-card", support: "full", rendersAs: "`:::link-card{title href}` with the description as body" },
+    { feature: "files", support: "full", rendersAs: "`:::files` around the nested list" },
+    { feature: "grid", support: "full", rendersAs: "`::::grid` / `:::grid-item`" },
+    { feature: "link-button", support: "full", rendersAs: "`:::button{href}`" },
+    { feature: "related", support: "full", rendersAs: "bold caption + `{._additional-resources}` + the link list (the shape the parser folds back)" },
+    {
+        feature: "example",
+        support: "partial",
+        rendersAs: "its children, unwrapped",
+        note: "No case: `renderUnknown` writes the children only. The `:::example` wrapper (live preview + shown source) is lost and the content re-parses as ordinary blocks; unrecorded.",
+    },
+    {
+        feature: "container",
+        support: "partial",
+        rendersAs: "`:::name` for this format's own generic containers; the children otherwise",
+        note: "A container parsed from Dogsbay MD (`meta.container` + `meta.name`) round-trips. A `container` from another importer has no name to write: its wrapper and props (class, id) are dropped and only the children survive; unrecorded.",
+    },
+    {
+        feature: "annotation-list",
+        support: "partial",
+        rendersAs: "each item's content as a separate paragraph",
+        note: "No case: `renderUnknown` writes the children, and the list items render without list markers — numbering and the link to the code block's `(n)` markers are lost; unrecorded.",
+    },
+    // ── API reference ────────────────────────────────────────
+    {
+        feature: "endpoint",
+        support: "partial",
+        rendersAs: "`## METHOD /path` + summary/description + Parameters table + request-body/response lists + code-sample fences",
+        note: "Readable Markdown, but not a structure: it re-parses as headings/tables/lists, never an `endpoint`. Schemas beyond name/type/required/description, and spec raw HTML (escaped as `&lt;`), are not carried.",
+    },
+    { feature: "api-doc", support: "full", rendersAs: "`:::api-doc{…}`" },
+    { feature: "api-class", support: "full", rendersAs: "`:::api-class{…}`" },
+    { feature: "api-member", support: "full", rendersAs: "`:::api-member{…}`" },
+    { feature: "api-params", support: "full", rendersAs: "`:::api-params` with a YAML `params:` body" },
+    { feature: "api-source", support: "full", rendersAs: "`:::api-source{…}`" },
+    // ── Inline ───────────────────────────────────────────────
+    { feature: "link", support: "full", rendersAs: "`[text](href \"title\")`" },
+    { feature: "image", support: "full", rendersAs: "`![alt](src \"title\"){attrs}`" },
+    { feature: "kbd", support: "full", rendersAs: "`:kbd[Ctrl+S]`" },
+    { feature: "math", support: "full", rendersAs: "`$…$`" },
+    { feature: "highlight", support: "full", rendersAs: "`==…==`" },
+    { feature: "badge", support: "full", rendersAs: "`:badge[Text]{variant=…}`" },
+    { feature: "icon", support: "full", rendersAs: "`:icon[name]`" },
+    { feature: "footnote-ref", support: "full", rendersAs: "`[^label]`" },
+    { feature: "html-inline", support: "full", rendersAs: "the raw HTML, verbatim" },
+];

package/dist/cli.d.ts

@@ -18,4 +18,3 @@ import type { FormatPlugin } from "@dogsbay/types";
  */
 export declare function carriedFrontmatter(fm: Record<string, unknown> | undefined): Record<string, unknown>;
 export declare const plugin: FormatPlugin;
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -12,6 +12,7 @@ import { dogsbayMdToTree } from "./parse.js";
 import { treeToDogsbayMd } from "./serialize.js";
 import { buildNavFromDirectory } from "./nav.js";
 import { renderDiagrams } from "./renderers/diagrams.js";
+import { DOGSBAY_MD_CAPABILITIES } from "./capabilities.js";
 /**
  * Detect whether a directory contains a Dogsbay MD source tree.
  *
@@ -350,6 +351,7 @@ export const plugin = {
     name: "dogsbay-md",
     canImport: true,
     canExport: true,
+    capabilities: DOGSBAY_MD_CAPABILITIES,
     detectSource: detectDogsbayMdSource,
     importOptions: [
         {
@@ -364,4 +366,3 @@ export const plugin = {
         return exportDogsbayMd(pages, nav, output, opts);
     },
 };
-//# sourceMappingURL=cli.js.map

package/dist/code-regions.d.ts

@@ -86,4 +86,3 @@ export declare function transformProseSegments(source: string, transform: (prose
  */
 export declare function fenceOpenBefore(source: string): boolean[];
 export {};
-//# sourceMappingURL=code-regions.d.ts.map

package/dist/code-regions.js

@@ -212,4 +212,3 @@ export function fenceOpenBefore(source) {
     states.push(state.open);
     return states;
 }
-//# sourceMappingURL=code-regions.js.map

package/dist/directive-guard.d.ts

@@ -8,4 +8,3 @@
  * validation, which is the first line.
  */
 export declare function assertDirectiveField(what: string, value: string): string;
-//# sourceMappingURL=directive-guard.d.ts.map

package/dist/directive-guard.js

@@ -13,4 +13,3 @@ export function assertDirectiveField(what, value) {
         throw new Error(`cannot serialize ${what} containing "${marker}": ${JSON.stringify(value)}`);
     return value;
 }
-//# sourceMappingURL=directive-guard.js.map

package/dist/directive-preserve.d.ts

@@ -63,4 +63,3 @@ export interface RestoreOptions {
     nodesFor?: "all" | "include";
 }
 export declare function restoreDirectives(tree: TreeNode[], table: DirectiveSpan[], options?: RestoreOptions): TreeNode[];
-//# sourceMappingURL=directive-preserve.d.ts.map

package/dist/directive-preserve.js

@@ -407,4 +407,3 @@ export function restoreDirectives(tree, table, options = {}) {
         sweep(node, table);
     return folded;
 }
-//# sourceMappingURL=directive-preserve.js.map

package/dist/directives.d.ts

@@ -16,4 +16,3 @@ export interface DirectiveRenderInput {
  * the component, option threshold, and prop complexity.
  */
 export declare function renderBlockDirective(input: DirectiveRenderInput, ctx: ResolvedOptions): string;
-//# sourceMappingURL=directives.d.ts.map

package/dist/directives.js

@@ -95,4 +95,3 @@ function attrsToYaml(attrs) {
     }
     return result;
 }
-//# sourceMappingURL=directives.js.map

package/dist/escape.d.ts

@@ -58,4 +58,3 @@ export declare const indent: typeof coreIndent;
  * the last byte of every emitted file.
  */
 export declare function normalizeTrailingWhitespace(content: string): string;
-//# sourceMappingURL=escape.d.ts.map

package/dist/escape.js

@@ -147,4 +147,3 @@ export function normalizeTrailingWhitespace(content) {
     }
     return out.join("\n").replace(/\s*$/, "\n");
 }
-//# sourceMappingURL=escape.js.map

package/dist/frontmatter.d.ts

@@ -9,4 +9,3 @@ export interface Frontmatter {
  * body is malformed — callers that want a fallback should catch.
  */
 export declare function splitFrontmatter(source: string): Frontmatter;
-//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.js

@@ -64,4 +64,3 @@ export function splitFrontmatter(source) {
         content,
     };
 }
-//# sourceMappingURL=frontmatter.js.map

package/dist/headings.d.ts

@@ -40,11 +40,4 @@ export interface HeadingInfo {
 }
 import { slugifyHeadingText } from "@dogsbay/serialize-core";
 export { slugifyHeadingText };
-/**
- * Extract top-level heading metadata AND backfill `props.slug` on
- * headings that lack an explicit one — exactly the site build's
- * anchor-id assignment. Mutates the tree (by design: serialization and
- * rendering read the backfilled slug).
- */
 export declare function extractHeadings(tree: TreeNode[]): HeadingInfo[];
-//# sourceMappingURL=headings.d.ts.map

package/dist/headings.js

@@ -19,7 +19,7 @@ function collectInlineText(nodes) {
 }
 // ONE slug rule for the platform: the site build, the TOC and every
 // exporter's heading links read the same function (serialize-core).
-import { slugifyHeadingText } from "@dogsbay/serialize-core";
+import { isDetailsSheet, slugifyHeadingText } from "@dogsbay/serialize-core";
 export { slugifyHeadingText };
 /**
  * Extract top-level heading metadata AND backfill `props.slug` on
@@ -27,9 +27,19 @@ export { slugifyHeadingText };
  * anchor-id assignment. Mutates the tree (by design: serialization and
  * rendering read the backfilled slug).
  */
+/**
+ * The page's own level: top-level nodes, and the content of transparent
+ * wrappers. A `:::theme` band only changes colours, so a heading inside it is
+ * still a page heading (DITA `<section outputclass="db-theme-dark">` wraps
+ * its section title); walking only the top level left it with no id and no
+ * table-of-contents entry.
+ */
+function pageLevel(tree) {
+    return tree.flatMap((n) => (n.type === "theme" ? pageLevel(n.children ?? []) : [n]));
+}
 export function extractHeadings(tree) {
     const slots = [];
-    for (const node of tree) {
+    for (const node of pageLevel(tree)) {
         if (node.type !== "heading" || !node.inline)
             continue;
         const text = node.inline
@@ -97,6 +107,37 @@ export function extractHeadings(tree) {
         slot.slug = slug;
         taken.add(slug);
     }
+    // PASS 3 — a side sheet with no id gets one from its title, so a link
+    // written as for a heading (`[options](#advanced-options)`) opens it (#101).
+    // Sheets come last and yield: they cannot move a heading's anchor.
+    const ids = new Set();
+    const walk = (nodes) => {
+        for (const n of nodes ?? []) {
+            const id = n.props?.id;
+            if (typeof id === "string" && id)
+                ids.add(id);
+            walk(n.children);
+        }
+    };
+    walk(tree);
+    const sheets = (nodes) => {
+        for (const n of nodes ?? []) {
+            if (n.type === "details" && isDetailsSheet(n.props) && !n.props?.id) {
+                const title = String(n.props?.title ?? n.props?.summary ?? "");
+                const base = slugifyHeadingText(title);
+                if (base) {
+                    let slug = base;
+                    for (let k = 1; taken.has(slug) || ids.has(slug); k++)
+                        slug = `${base}-${k}`;
+                    taken.add(slug);
+                    ids.add(slug);
+                    n.props = { ...n.props, id: slug };
+                }
+            }
+            sheets(n.children);
+        }
+    };
+    sheets(tree);
     const headings = [];
     for (const slot of slots) {
         const slug = slot.slug ?? "";
@@ -113,4 +154,3 @@ export function extractHeadings(tree) {
     }
     return headings;
 }
-//# sourceMappingURL=headings.js.map

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { treeToDogsbayMd, nodeToDogsbayMd } from "./serialize.js";
 export type { SerializeOptions } from "./types.js";
+export { DOGSBAY_MD_CAPABILITIES } from "./capabilities.js";
 export { inlineToDogsbayMd } from "./inline.js";
 export { dogsbayMdToTree, parseInline } from "./parse.js";
 export { extractHeadings, slugifyHeadingText, type HeadingInfo } from "./headings.js";
@@ -14,4 +15,3 @@ export { renderDiagrams } from "./renderers/diagrams.js";
 export type { RenderDiagramsOptions } from "./renderers/diagrams.js";
 export { renderMermaidSvg, setMmdcOverride, findMmdc } from "./renderers/mermaid.js";
 export { TemplatePages, TemplatePageError, declaresParams, ATTRIBUTE_BLOCK_OPEN, type TemplatePagesOptions } from "./template-pages.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,6 +3,7 @@
 // Spec: dogsbay-research/content/formats/dogsbay-markdown-spec.md
 // Plan: plans/format-dogsbay-md.md
 export { treeToDogsbayMd, nodeToDogsbayMd } from "./serialize.js";
+export { DOGSBAY_MD_CAPABILITIES } from "./capabilities.js";
 export { inlineToDogsbayMd } from "./inline.js";
 export { dogsbayMdToTree, parseInline } from "./parse.js";
 export { extractHeadings, slugifyHeadingText } from "./headings.js";
@@ -13,4 +14,3 @@ export { loadNavFile } from "./nav-file.js";
 export { renderDiagrams } from "./renderers/diagrams.js";
 export { renderMermaidSvg, setMmdcOverride, findMmdc } from "./renderers/mermaid.js";
 export { TemplatePages, TemplatePageError, declaresParams, ATTRIBUTE_BLOCK_OPEN } from "./template-pages.js";
-//# sourceMappingURL=index.js.map

package/dist/inline.d.ts

@@ -3,4 +3,3 @@
  */
 import type { InlineNode } from "@dogsbay/types";
 export declare function inlineToDogsbayMd(nodes: InlineNode[] | undefined): string;
-//# sourceMappingURL=inline.d.ts.map

package/dist/inline.js

@@ -352,4 +352,3 @@ function escapeLinkDest(dest) {
     }
     return dest;
 }
-//# sourceMappingURL=inline.js.map

package/dist/minja-mask.d.ts

@@ -61,4 +61,3 @@ export declare function stripInlineMinjaMarkers(text: string): string;
  * touched (shared grammar).
  */
 export declare function stripFenceMinjaMarkers(text: string): string;
-//# sourceMappingURL=minja-mask.d.ts.map

package/dist/minja-mask.js

@@ -125,4 +125,3 @@ export function stripFenceMinjaMarkers(text) {
         return removed ? out.replace(/\s+$/, "") : info;
     });
 }
-//# sourceMappingURL=minja-mask.js.map

package/dist/nav-file.d.ts

@@ -58,4 +58,3 @@ export interface LoadNavFileOptions {
  * to compute slugs.
  */
 export declare function loadNavFile(path: string, contentDir: string, options?: LoadNavFileOptions): NavItem[];
-//# sourceMappingURL=nav-file.d.ts.map

package/dist/nav-file.js

@@ -331,4 +331,3 @@ function fileToHref(file, hrefPrefix) {
     const prefix = hrefPrefix.endsWith("/") ? hrefPrefix.slice(0, -1) : hrefPrefix;
     return slug ? `${prefix}/${slug}` : prefix;
 }
-//# sourceMappingURL=nav-file.js.map

package/dist/nav.d.ts

@@ -38,4 +38,3 @@ export interface BuildNavOptions {
  * Sorting falls back to filename alphabetical when order is not set.
  */
 export declare function buildNavFromDirectory(contentDir: string, options?: BuildNavOptions): NavItem[];
-//# sourceMappingURL=nav.d.ts.map

package/dist/nav.js

@@ -185,4 +185,3 @@ function prettifyName(slug) {
         .join(" ");
 }
 void statSync; // reserved for future use (e.g. mtime-based caching)
-//# sourceMappingURL=nav.js.map

package/dist/parse-attrs.d.ts

@@ -21,4 +21,3 @@ export declare function parseAttrs(inner: string): ParsedAttrs;
  * `id` and `classes` become `id` and `class`; other props flow through.
  */
 export declare function attrsToProps(attrs: ParsedAttrs): Record<string, unknown>;
-//# sourceMappingURL=parse-attrs.d.ts.map

package/dist/parse-attrs.js

@@ -114,4 +114,3 @@ export function attrsToProps(attrs) {
     }
     return props;
 }
-//# sourceMappingURL=parse-attrs.js.map

package/dist/parse.d.ts

@@ -26,4 +26,3 @@ export declare function dogsbayMdToTree(source: string, options?: ParseOptions):
  * Parse a single inline string to InlineNode[] (useful for testing).
  */
 export declare function parseInline(source: string): InlineNode[];
-//# sourceMappingURL=parse.d.ts.map

package/dist/parse.js

@@ -1130,11 +1130,9 @@ function accordionFromChildren(props, children) {
         }
         return { type: "accordion", props, children: items };
     }
-    // Directive form: explicit `:::accordion-item` children
-    const itemKids = children.filter((c) => c.type === "accordion-item");
-    if (itemKids.length > 0) {
-        return { type: "accordion", props, children: itemKids };
-    }
+    // Directive form: explicit `:::accordion-item` children. Other blocks (an
+    // intro paragraph) stay too: every renderer places them around the group
+    // (serialize-core `renderAroundGroup`); filtering them here deleted them.
     return { type: "accordion", props, children };
 }
 /**
@@ -1180,9 +1178,14 @@ function linkCardFromChildren(props, children) {
     return { type: "link-card", props, children };
 }
 function tabsFromChildren(props, children) {
-    // Preferred: children is a single deflist
-    if (children.length === 1 && children[0].type === "deflist") {
-        const dl = children[0];
+    // Preferred: the definition-list form. An intro or outro paragraph around
+    // the ONE deflist stays where it is (renderAroundGroup places it), as in the
+    // directive form; requiring the deflist to be the only child turned the
+    // whole group into a plain list with no warning (#102). Two deflists and no
+    // :::tab: which one is the tabs is a guess, so neither is converted.
+    const deflists = children.filter((c) => c.type === "deflist");
+    if (deflists.length === 1 && !children.some((c) => c.type === "tab")) {
+        const dl = deflists[0];
         const tabs = [];
         const list = dl.children ?? [];
         for (let i = 0; i < list.length; i++) {
@@ -1200,14 +1203,11 @@ function tabsFromChildren(props, children) {
                 }
             }
         }
-        return { type: "tabs", props, children: tabs };
-    }
-    // Directive form: children are explicit :::tab containers
-    const tabs = children.filter((c) => c.type === "tab");
-    if (tabs.length > 0) {
-        return { type: "tabs", props, children: tabs };
+        return { type: "tabs", props, children: children.flatMap((c) => (c === dl ? tabs : [c])) };
     }
-    // Fallback — unknown shape
+    // Directive form: explicit :::tab containers. Other blocks (an intro, text
+    // between tabs) stay: every renderer places them around the group
+    // (serialize-core `renderAroundGroup`); filtering them here deleted them.
     return { type: "tabs", props, children };
 }
 function stepsFromChildren(props, children) {
@@ -1726,4 +1726,3 @@ function inlineDirectiveToNode(name, labelText, labelInline, attrs) {
         }
     }
 }
-//# sourceMappingURL=parse.js.map

package/dist/plugin-block-leaf.d.ts

@@ -16,4 +16,3 @@
  */
 import type MarkdownIt from "markdown-it";
 export declare function blockLeafDirectivePlugin(md: MarkdownIt): void;
-//# sourceMappingURL=plugin-block-leaf.d.ts.map

package/dist/plugin-block-leaf.js

@@ -78,4 +78,3 @@ function blockLeafRule(state, startLine, endLine, silent) {
     state.line = startLine + 1;
     return true;
 }
-//# sourceMappingURL=plugin-block-leaf.js.map

package/dist/plugin-containers.d.ts

@@ -6,11 +6,10 @@
  * nest. Same-name nesting requires more colons (::::).
  */
 import type MarkdownIt from "markdown-it";
-export declare const KNOWN_BLOCK_DIRECTIVES: readonly ["tabs", "tab", "steps", "step", "cards", "card", "grid", "grid-item", "details", "callout", "note", "tip", "info", "important", "warning", "caution", "danger", "success", "hint", "attention", "error", "failure", "bug", "question", "abstract", "quote", "button", "figure", "math", "api-endpoint", "api-params", "api-response", "config", "files", "example", "accordion", "accordion-item", "link-card", "autodoc", "api-class", "api-member", "api-doc", "api-source", "youtube", "openapi"];
+export declare const KNOWN_BLOCK_DIRECTIVES: readonly ["tabs", "tab", "steps", "step", "cards", "card", "grid", "grid-item", "details", "callout", "note", "tip", "info", "important", "warning", "caution", "danger", "success", "hint", "attention", "error", "failure", "bug", "question", "abstract", "quote", "button", "figure", "math", "api-endpoint", "api-params", "api-response", "config", "files", "example", "accordion", "accordion-item", "link-card", "autodoc", "api-class", "api-member", "api-doc", "api-source", "youtube", "openapi", "theme"];
 /**
  * The token name for a `:::name` block with a name no renderer knows. It becomes a node of that
  * type (parse.ts), which renderers show as a plain container and report, rather than literal text.
  */
 export declare const GENERIC_CONTAINER = "dogsbay_generic";
 export declare function containersPlugin(md: MarkdownIt): void;
-//# sourceMappingURL=plugin-containers.d.ts.map

package/dist/plugin-containers.js

@@ -61,6 +61,9 @@ export const KNOWN_BLOCK_DIRECTIVES = [
     // expanded into endpoint cards from the spec at build time (the
     // Swagger UI / Redoc embed). See packages/cli/src/resolve-openapi.ts.
     "openapi",
+    // A scoped theme, `:::theme{name="dark"}`: its content in another token
+    // set (plans/dita-variants-themes.md). A wrapper, so it takes blocks.
+    "theme",
 ];
 /**
  * The token name for a `:::name` block with a name no renderer knows. It becomes a node of that
@@ -108,4 +111,3 @@ export function containersPlugin(md) {
         render: () => "",
     });
 }
-//# sourceMappingURL=plugin-containers.js.map

package/dist/plugin-inline-directives.d.ts

@@ -15,4 +15,3 @@
  */
 import type MarkdownIt from "markdown-it";
 export declare function inlineDirectivesPlugin(md: MarkdownIt): void;
-//# sourceMappingURL=plugin-inline-directives.d.ts.map

package/dist/plugin-inline-directives.js

@@ -118,4 +118,3 @@ function inlineDirectiveRule(state, silent) {
     state.pos = pos;
     return true;
 }
-//# sourceMappingURL=plugin-inline-directives.js.map

package/dist/plugin-mark.d.ts

@@ -10,4 +10,3 @@
  */
 import type MarkdownIt from "markdown-it";
 export declare function markPlugin(md: MarkdownIt): void;
-//# sourceMappingURL=plugin-mark.d.ts.map

package/dist/plugin-mark.js

@@ -72,4 +72,3 @@ export function markPlugin(md) {
         return false;
     });
 }
-//# sourceMappingURL=plugin-mark.js.map

package/dist/plugin-math.d.ts

@@ -20,4 +20,3 @@
  */
 import type MarkdownIt from "markdown-it";
 export declare function mathPlugin(md: MarkdownIt): void;
-//# sourceMappingURL=plugin-math.d.ts.map

package/dist/plugin-math.js

@@ -88,4 +88,3 @@ export function mathPlugin(md) {
     });
     md.inline.ruler.before("escape", "math_inline", mathInline);
 }
-//# sourceMappingURL=plugin-math.js.map

package/dist/renderers/diagrams.d.ts

@@ -22,4 +22,3 @@ export interface RenderDiagramsOptions {
  * the build log when many fences are present.
  */
 export declare function renderDiagrams(tree: TreeNode[], options?: RenderDiagramsOptions): Promise<void>;
-//# sourceMappingURL=diagrams.d.ts.map

package/dist/renderers/diagrams.js

@@ -68,4 +68,3 @@ export async function renderDiagrams(tree, options) {
     }
     await walk(tree);
 }
-//# sourceMappingURL=diagrams.js.map

package/dist/renderers/mermaid.d.ts

@@ -21,4 +21,3 @@ export declare function findMmdc(): string | null;
  * identical diagrams across pages or rebuilds.
  */
 export declare function renderMermaidSvg(code: string): Promise<string | null>;
-//# sourceMappingURL=mermaid.d.ts.map

package/dist/renderers/mermaid.js

@@ -149,4 +149,3 @@ export async function renderMermaidSvg(code) {
         catch { /* ignore */ }
     }
 }
-//# sourceMappingURL=mermaid.js.map

package/dist/serialize.d.ts

@@ -22,4 +22,3 @@ export declare function treeToDogsbayMd(nodes: TreeNode[], options?: SerializeOp
  * Exposed for chunker to emit one node per file.
  */
 export declare function nodeToDogsbayMd(node: TreeNode, options?: SerializeOptions): string;
-//# sourceMappingURL=serialize.d.ts.map