@dogsbay/serialize-core 0.2.0-beta.98

package/dist/capability.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Export capability declaration + loss ledger.
+ *
+ * Every target format can represent only part of the TreeNode vocabulary.
+ * Obsidian has no per-element `class`; Docusaurus has no `<Steps>`; plain
+ * markdown has no tabs at all. Today that knowledge is scattered — five
+ * near-identical ledger shapes exist across packages
+ * (`MdxLedgerEntry`, `DitaConversionNote`, `FidelityIssue`,
+ * `TranslateLedgerEntry` ×2) with nothing shared, and the one export-side
+ * fallback that exists (`format-dogsbay-md`'s `renderUnknown`) records
+ * *nothing* — its `skip` mode is silent loss. `format-obsidian`'s attribute
+ * dropping is documented in a CLAUDE.md and recorded nowhere.
+ *
+ * This module gives exporters two complementary, required surfaces:
+ *
+ * 1. **Static declaration** ({@link CapabilityDeclaration}) — what the format
+ *    structurally cannot represent, known before any content is seen. It is
+ *    documentation: publishable, diffable, and answerable up front ("what do
+ *    I lose migrating to Docusaurus?").
+ * 2. **Observed ledger** ({@link ExportLedger}) — what *this* conversion
+ *    actually dropped or degraded, per page. Answers "what did I lose in MY
+ *    content?", which is usually a much shorter list than the static one.
+ *
+ * The discipline, inherited from format-dita: **known loss, never silent
+ * loss.**
+ */
+/** How completely a target format supports a feature. */
+export type SupportLevel = 
+/** Round-trips faithfully. */
+"full"
+/** Representable, but something is lost (styling, semantics, nesting). */
+ | "partial"
+/** Cannot be represented at all; content is dropped or flattened. */
+ | "none";
+/** A static statement about one feature in one target format. */
+export interface CapabilityDeclaration {
+    /**
+     * TreeNode type (`"tabs"`, `"callout"`) or a named cross-cutting concern
+     * (`"per-element class"`, `"nested tabs"`).
+     */
+    feature: string;
+    support: SupportLevel;
+    /**
+     * How it degrades and what the reader should expect. REQUIRED whenever
+     * support is not "full" — a bare "partial" with no explanation is exactly
+     * the silent-loss problem this module exists to prevent.
+     */
+    note?: string;
+    /** What the feature becomes in the output, when it survives in some form. */
+    rendersAs?: string;
+}
+/** What happened to a specific piece of content during one export. */
+export type LossAction = 
+/** Content was removed entirely. */
+"dropped"
+/** Content survived, but with reduced fidelity (e.g. styling stripped). */
+ | "degraded"
+/** Content was mapped onto a near-equivalent construct. */
+ | "approximated";
+/** One observed loss event. */
+export interface ExportLedgerEntry {
+    /** TreeNode type or named concern — matches a {@link CapabilityDeclaration}. */
+    feature: string;
+    action: LossAction;
+    /** Human-readable specifics for this occurrence. */
+    detail?: string;
+    /** Page slug where it happened, when known. */
+    page?: string;
+}
+/** Aggregated view of a ledger, grouped by feature+action. */
+export interface LedgerSummaryRow {
+    feature: string;
+    action: LossAction;
+    count: number;
+    pages: string[];
+    /** First detail seen for this group — representative, not exhaustive. */
+    detail?: string;
+}
+/**
+ * Collects loss events during an export.
+ *
+ * Exporters create one per run, pass it down, and call {@link record} at every
+ * point they drop or degrade something. Cheap by design: recording is a push,
+ * and a clean export costs one empty array.
+ */
+export declare class ExportLedger {
+    private readonly items;
+    /** Page slug stamped onto entries recorded without an explicit one. */
+    private currentPage?;
+    /** Scope subsequent {@link record} calls to a page. */
+    setPage(page: string | undefined): void;
+    /** Record one loss event. */
+    record(entry: ExportLedgerEntry): void;
+    /** Convenience: record a dropped feature. */
+    drop(feature: string, detail?: string): void;
+    /** Convenience: record a degraded feature. */
+    degrade(feature: string, detail?: string): void;
+    /** Convenience: record an approximated feature. */
+    approximate(feature: string, detail?: string): void;
+    /** All recorded entries, in order. */
+    get entries(): readonly ExportLedgerEntry[];
+    get isEmpty(): boolean;
+    get size(): number;
+    /**
+     * Aggregate by feature+action, most frequent first — the shape a report
+     * prints. Mirrors `format-mdx`'s `printLedgerReport` grouping.
+     */
+    summary(): LedgerSummaryRow[];
+}
+/**
+ * Render the observed ledger as plain text for the CLI.
+ *
+ * Empty state is explicit and positive ("nothing was dropped") — the
+ * import-dita precedent — so a clean run is visibly clean rather than silent.
+ */
+export declare function formatLedgerReport(ledger: ExportLedger, formatName: string): string;
+/**
+ * Render a format's static capability declaration as a markdown table, for
+ * publishing in the package's docs ("what this exporter cannot support").
+ *
+ * Sorted worst-first (none → partial → full) so the limitations lead.
+ */
+export declare function formatCapabilityTable(capabilities: readonly CapabilityDeclaration[]): string;
+/**
+ * Cross-check an OBSERVED ledger against the STATIC declaration.
+ *
+ * `validateCapabilities` only checks the declaration's internal consistency; it
+ * cannot catch a degradation that was never declared. This closes that gap: a
+ * feature recorded as lost must be declared, and must not be declared `full`.
+ * Exporters assert it in tests so undocumented loss cannot ship.
+ */
+export declare function validateLedgerAgainstCapabilities(ledger: ExportLedger, capabilities: readonly CapabilityDeclaration[]): string[];
+/** The features a format cannot represent at all — the headline limitations. */
+export declare function unsupportedFeatures(capabilities: readonly CapabilityDeclaration[]): CapabilityDeclaration[];
+/**
+ * Validate a declaration set: every non-full entry must explain itself, and
+ * features must not be declared twice. Returns problem strings (empty = valid).
+ * Exporters assert this in their tests so an undocumented degradation cannot
+ * ship.
+ */
+export declare function validateCapabilities(capabilities: readonly CapabilityDeclaration[]): string[];
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,yDAAyD;AACzD,MAAM,MAAM,YAAY;AACtB,8BAA8B;AAC5B,MAAM;AACR,0EAA0E;GACxE,SAAS;AACX,qEAAqE;GACnE,MAAM,CAAC;AAEX,iEAAiE;AACjE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,MAAM,MAAM,UAAU;AACpB,oCAAoC;AAClC,SAAS;AACX,2EAA2E;GACzE,UAAU;AACZ,2DAA2D;GACzD,cAAc,CAAC;AAEnB,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,uEAAuE;IACvE,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B,uDAAuD;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvC,6BAA6B;IAC7B,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAOtC,6CAA6C;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5C,8CAA8C;IAC9C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/C,mDAAmD;IACnD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAInD,sCAAsC;IACtC,IAAI,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAE1C;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,OAAO,IAAI,gBAAgB,EAAE;CAoB9B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,qBAAqB,EAAE,GAC7C,MAAM,CAmBR;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,SAAS,qBAAqB,EAAE,GAC7C,MAAM,EAAE,CAmBV;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,qBAAqB,EAAE,GAC7C,qBAAqB,EAAE,CAEzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,SAAS,qBAAqB,EAAE,GAC7C,MAAM,EAAE,CAaV"}

package/dist/capability.js

@@ -0,0 +1,189 @@
+/**
+ * Export capability declaration + loss ledger.
+ *
+ * Every target format can represent only part of the TreeNode vocabulary.
+ * Obsidian has no per-element `class`; Docusaurus has no `<Steps>`; plain
+ * markdown has no tabs at all. Today that knowledge is scattered — five
+ * near-identical ledger shapes exist across packages
+ * (`MdxLedgerEntry`, `DitaConversionNote`, `FidelityIssue`,
+ * `TranslateLedgerEntry` ×2) with nothing shared, and the one export-side
+ * fallback that exists (`format-dogsbay-md`'s `renderUnknown`) records
+ * *nothing* — its `skip` mode is silent loss. `format-obsidian`'s attribute
+ * dropping is documented in a CLAUDE.md and recorded nowhere.
+ *
+ * This module gives exporters two complementary, required surfaces:
+ *
+ * 1. **Static declaration** ({@link CapabilityDeclaration}) — what the format
+ *    structurally cannot represent, known before any content is seen. It is
+ *    documentation: publishable, diffable, and answerable up front ("what do
+ *    I lose migrating to Docusaurus?").
+ * 2. **Observed ledger** ({@link ExportLedger}) — what *this* conversion
+ *    actually dropped or degraded, per page. Answers "what did I lose in MY
+ *    content?", which is usually a much shorter list than the static one.
+ *
+ * The discipline, inherited from format-dita: **known loss, never silent
+ * loss.**
+ */
+/**
+ * Collects loss events during an export.
+ *
+ * Exporters create one per run, pass it down, and call {@link record} at every
+ * point they drop or degrade something. Cheap by design: recording is a push,
+ * and a clean export costs one empty array.
+ */
+export class ExportLedger {
+    items = [];
+    /** Page slug stamped onto entries recorded without an explicit one. */
+    currentPage;
+    /** Scope subsequent {@link record} calls to a page. */
+    setPage(page) {
+        this.currentPage = page;
+    }
+    /** Record one loss event. */
+    record(entry) {
+        this.items.push({
+            ...entry,
+            page: entry.page ?? this.currentPage,
+        });
+    }
+    /** Convenience: record a dropped feature. */
+    drop(feature, detail) {
+        this.record({ feature, action: "dropped", detail });
+    }
+    /** Convenience: record a degraded feature. */
+    degrade(feature, detail) {
+        this.record({ feature, action: "degraded", detail });
+    }
+    /** Convenience: record an approximated feature. */
+    approximate(feature, detail) {
+        this.record({ feature, action: "approximated", detail });
+    }
+    /** All recorded entries, in order. */
+    get entries() {
+        return this.items;
+    }
+    get isEmpty() {
+        return this.items.length === 0;
+    }
+    get size() {
+        return this.items.length;
+    }
+    /**
+     * Aggregate by feature+action, most frequent first — the shape a report
+     * prints. Mirrors `format-mdx`'s `printLedgerReport` grouping.
+     */
+    summary() {
+        const groups = new Map();
+        for (const entry of this.items) {
+            const key = `${entry.feature}\t${entry.action}`;
+            let row = groups.get(key);
+            if (!row) {
+                row = {
+                    feature: entry.feature,
+                    action: entry.action,
+                    count: 0,
+                    pages: [],
+                    detail: entry.detail,
+                };
+                groups.set(key, row);
+            }
+            row.count++;
+            if (entry.page && !row.pages.includes(entry.page))
+                row.pages.push(entry.page);
+        }
+        return [...groups.values()].sort((a, b) => b.count - a.count);
+    }
+}
+/**
+ * Render the observed ledger as plain text for the CLI.
+ *
+ * Empty state is explicit and positive ("nothing was dropped") — the
+ * import-dita precedent — so a clean run is visibly clean rather than silent.
+ */
+export function formatLedgerReport(ledger, formatName) {
+    if (ledger.isEmpty) {
+        return `${formatName} export: nothing was dropped or degraded.`;
+    }
+    const lines = [
+        `${formatName} export — ${ledger.size} fidelity note(s):`,
+    ];
+    for (const row of ledger.summary()) {
+        const where = row.pages.length > 0
+            ? ` (${row.pages.length} page${row.pages.length === 1 ? "" : "s"})`
+            : "";
+        const detail = row.detail ? ` — ${row.detail}` : "";
+        lines.push(`  ${row.feature} ${row.action} ×${row.count}${where}${detail}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Render a format's static capability declaration as a markdown table, for
+ * publishing in the package's docs ("what this exporter cannot support").
+ *
+ * Sorted worst-first (none → partial → full) so the limitations lead.
+ */
+export function formatCapabilityTable(capabilities) {
+    const rank = { none: 0, partial: 1, full: 2 };
+    const sorted = [...capabilities].sort((a, b) => rank[a.support] - rank[b.support] || a.feature.localeCompare(b.feature));
+    const icon = {
+        full: "✅ full",
+        partial: "⚠️ partial",
+        none: "❌ none",
+    };
+    const rows = sorted.map((c) => `| ${c.feature} | ${icon[c.support]} | ${c.rendersAs ?? "—"} | ${c.note ?? ""} |`);
+    return [
+        "| Feature | Support | Renders as | Notes |",
+        "|---|---|---|---|",
+        ...rows,
+    ].join("\n");
+}
+/**
+ * Cross-check an OBSERVED ledger against the STATIC declaration.
+ *
+ * `validateCapabilities` only checks the declaration's internal consistency; it
+ * cannot catch a degradation that was never declared. This closes that gap: a
+ * feature recorded as lost must be declared, and must not be declared `full`.
+ * Exporters assert it in tests so undocumented loss cannot ship.
+ */
+export function validateLedgerAgainstCapabilities(ledger, capabilities) {
+    const byFeature = new Map(capabilities.map((c) => [c.feature, c]));
+    const problems = [];
+    const seen = new Set();
+    for (const row of ledger.summary()) {
+        if (seen.has(row.feature))
+            continue;
+        seen.add(row.feature);
+        const declared = byFeature.get(row.feature);
+        if (!declared) {
+            problems.push(`"${row.feature}" was ${row.action} at runtime but is not declared in the capability table`);
+        }
+        else if (declared.support === "full") {
+            problems.push(`"${row.feature}" is declared full but was ${row.action} at runtime`);
+        }
+    }
+    return problems;
+}
+/** The features a format cannot represent at all — the headline limitations. */
+export function unsupportedFeatures(capabilities) {
+    return capabilities.filter((c) => c.support === "none");
+}
+/**
+ * Validate a declaration set: every non-full entry must explain itself, and
+ * features must not be declared twice. Returns problem strings (empty = valid).
+ * Exporters assert this in their tests so an undocumented degradation cannot
+ * ship.
+ */
+export function validateCapabilities(capabilities) {
+    const problems = [];
+    const seen = new Set();
+    for (const cap of capabilities) {
+        if (seen.has(cap.feature))
+            problems.push(`duplicate declaration: ${cap.feature}`);
+        seen.add(cap.feature);
+        if (cap.support !== "full" && !cap.note) {
+            problems.push(`"${cap.feature}" is declared ${cap.support} but has no note explaining the loss`);
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=capability.js.map

package/dist/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"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"}

package/dist/includes.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Include realization — splice transcluded fragments into the tree.
+ *
+ * An `include` node (`{% include "path" %}`, AsciiDoc `include::`, a DITA
+ * conref, an MDX snippet import) is a TRANSCLUSION: the content lives in
+ * another file and belongs at that point in this page. Exactly one exporter —
+ * `format-dogsbay-md` — has syntax to carry the reference itself. Every other
+ * target must put the content IN, or the page ships with a hole in it.
+ *
+ * Before this existed, they put nothing in:
+ *
+ *   dogsbay-md   {% include "_snippets/warn.md" %}   ← preserved
+ *   docusaurus   <!-- unsupported: include -->        ← recorded, no content
+ *   astro        (nothing)                            ← silent
+ *   obsidian     (nothing)                            ← silent
+ *
+ * That mattered beyond the edge case: `dogsbay site build` resolves includes in
+ * a Minja preprocessing pass BEFORE parsing, so the supported publish path was
+ * fine — but `dogsbay convert --to astro` on the same corpus emitted `<p></p>`
+ * where every include had been. A corpus migrated from AsciiDoc (OpenShift:
+ * every `include::` becomes `{% include %}`) lost all of them on any second
+ * conversion, with no warning.
+ *
+ * This module is deliberately I/O-FREE: the caller supplies `resolve`, which
+ * maps an include's `src` to the fragment's nodes (reading and parsing however
+ * that format does it). Keeps the core pure and testable, and lets the same
+ * pass serve a filesystem importer, an in-memory editor, or a hosted runner.
+ */
+import type { TreeNode } from "@dogsbay/types";
+export interface RealizeResult {
+    tree: TreeNode[];
+    /** Include sources successfully spliced, in encounter order. */
+    realized: string[];
+    /** Include sources the resolver could not supply — reported, never silent. */
+    missing: string[];
+    /** Sources dropped because including them would recurse forever. */
+    cyclic: string[];
+    /**
+     * Sources dropped for exceeding `maxDepth` — legitimately nested too deep,
+     * NOT self-referential. Reporting these as cyclic told operators their
+     * content referred to itself when it merely nested.
+     */
+    tooDeep: string[];
+}
+export interface RealizeOptions {
+    /**
+     * Fragment lookup. Return the fragment's nodes, or null when it cannot be
+     * resolved (missing file, unreadable, outside the corpus).
+     */
+    resolve: (src: string, node: TreeNode) => TreeNode[] | null;
+    /**
+     * Depth limit for includes that themselves include. Default 10 — deep enough
+     * for real doc sets (OpenShift nests two or three), shallow enough that a
+     * pathological chain terminates.
+     */
+    maxDepth?: number;
+}
+/**
+ * Replace every `include` node with the nodes of its fragment.
+ *
+ * Cycles are detected by the ACTIVE path, not a global seen-set: a fragment
+ * legitimately included by twenty pages must resolve twenty times, while
+ * `a → b → a` must not recurse. The offending node is dropped and recorded.
+ */
+export declare function realizeIncludes(nodes: TreeNode[], options: RealizeOptions): RealizeResult;
+/** True when the tree contains an include anywhere. Cheap pre-check. */
+export declare function hasIncludes(nodes: TreeNode[]): boolean;
+//# sourceMappingURL=includes.d.ts.map

package/dist/includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"includes.d.ts","sourceRoot":"","sources":["../src/includes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,cAAc,GACtB,aAAa,CAsDf;AAwBD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAMtD"}

package/dist/includes.js

@@ -0,0 +1,94 @@
+/**
+ * Replace every `include` node with the nodes of its fragment.
+ *
+ * Cycles are detected by the ACTIVE path, not a global seen-set: a fragment
+ * legitimately included by twenty pages must resolve twenty times, while
+ * `a → b → a` must not recurse. The offending node is dropped and recorded.
+ */
+export function realizeIncludes(nodes, options) {
+    const maxDepth = options.maxDepth ?? 10;
+    const realized = [];
+    const missing = [];
+    const cyclic = [];
+    const tooDeep = [];
+    const walk = (list, active) => {
+        const out = [];
+        for (const node of list) {
+            if (node.type === "include") {
+                const src = String(node.props?.src ?? "");
+                if (!src) {
+                    missing.push("(include with no src)");
+                    continue;
+                }
+                if (active.includes(src)) {
+                    cyclic.push(src);
+                    continue;
+                }
+                if (active.length >= maxDepth) {
+                    tooDeep.push(src);
+                    continue;
+                }
+                const fragment = options.resolve(src, node);
+                if (!fragment) {
+                    missing.push(src);
+                    continue;
+                }
+                realized.push(src);
+                // Recurse: a fragment may include further fragments.
+                //
+                // `cloneTree` is load-bearing. One fragment is spliced into many pages
+                // and the resolver may hand back the SAME node objects each time (a
+                // cache, or the page set). Rebuilding only the spine left `inline`
+                // arrays and `props` objects ALIASED, so any later per-page pass — an
+                // href rewrite, a heading-level offset — mutated every other consumer
+                // and the cached fragment itself.
+                out.push(...walk(cloneTree(fragment), [...active, src]));
+                continue;
+            }
+            if (node.children) {
+                // Rebuild the node rather than mutating the caller's tree — the same
+                // fragment nodes can be spliced into several pages, and mutating them
+                // in place would corrupt every other use.
+                out.push({ ...node, children: walk(node.children, active) });
+                continue;
+            }
+            out.push(node);
+        }
+        return out;
+    };
+    return { tree: walk(nodes, []), realized, missing, cyclic, tooDeep };
+}
+/** Structural deep copy, so a spliced fragment is never aliased across pages. */
+function cloneTree(nodes) {
+    return nodes.map((node) => {
+        const copy = { ...node };
+        if (node.props)
+            copy.props = { ...node.props };
+        if (node.inline)
+            copy.inline = node.inline.map((i) => cloneInline(i));
+        if (node.children)
+            copy.children = cloneTree(node.children);
+        return copy;
+    });
+}
+function cloneInline(node) {
+    const copy = { ...node };
+    if (Array.isArray(copy.children)) {
+        copy.children = copy.children.map((c) => cloneInline(c));
+    }
+    if (copy.attrs && typeof copy.attrs === "object") {
+        copy.attrs = { ...copy.attrs };
+    }
+    return copy;
+}
+/** True when the tree contains an include anywhere. Cheap pre-check. */
+export function hasIncludes(nodes) {
+    for (const node of nodes) {
+        if (node.type === "include")
+            return true;
+        if (node.children && hasIncludes(node.children))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=includes.js.map

package/dist/includes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"includes.js","sourceRoot":"","sources":["../src/includes.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @dogsbay/serialize-core — the shared machinery every format exporter builds on.
+ *
+ * Three layers, in value order:
+ *
+ * 1. **Shape-tolerant reads** (`reads.ts`) — one place that knows WHERE a value
+ *    lives on a TreeNode. Eliminates the field-drift bug class where a
+ *    serializer reads a field the parser doesn't emit and silently emits
+ *    nothing.
+ * 2. **Generic inline walker** (`inline.ts`) — the 11-variant InlineNode switch,
+ *    written once, with markdown and HTML emitter presets.
+ * 3. **Capability + ledger** (`capability.ts`) — every exporter declares what it
+ *    cannot represent (static) and records what it actually lost (observed).
+ *    Known loss, never silent loss.
+ *
+ * Plus format-agnostic text helpers (`text.ts`) and an unknown-node fallback
+ * that reports instead of silently dropping (`unknown.ts`).
+ */
+export { leafInline, leafHtml, hasInline, hasContent, codeText, codeLang, tabTitle, tabValue, cardFields, cardBodySources, headingLevel, headingText, headingFragment, slugifyHeadingText, calloutVariant, calloutTitle, listStart, mediaSrc, renderLeaf, type CardFields, } from "./reads.js";
+export { walkInline, applyTextFlags, inlinePlainText, markdownInlineEmitters, htmlInlineEmitters, escapeHtml, escapeAttr, codeSpan, type InlineContext, type InlineEmitters, type InlineWalkOptions, } from "./inline.js";
+export { ExportLedger, formatLedgerReport, formatCapabilityTable, unsupportedFeatures, validateCapabilities, validateLedgerAgainstCapabilities, type SupportLevel, type CapabilityDeclaration, type LossAction, type ExportLedgerEntry, type LedgerSummaryRow, } from "./capability.js";
+export { pickCodeFence, pickDirectiveFence, indent, prefixLines, normalizeTrailingWhitespace, stripHtml, inlineHtmlToMarkdown, yamlScalar, frontmatterBlock, } from "./text.js";
+export { resolvePlugins, composeCapabilities, formatPluginConflicts, type ExportPluginMeta, type ResolvedPlugins, type ProviderConflict, type InvalidOverride, type ResolveOptions, } from "./plugins.js";
+export { realizeIncludes, hasIncludes, type RealizeResult, type RealizeOptions, } from "./includes.js";
+export { renderUnknownNode, type UnknownNodePolicy, type UnknownNodeOptions, } from "./unknown.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,2BAA2B,EAC3B,SAAS,EACT,oBAAoB,EACpB,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @dogsbay/serialize-core — the shared machinery every format exporter builds on.
+ *
+ * Three layers, in value order:
+ *
+ * 1. **Shape-tolerant reads** (`reads.ts`) — one place that knows WHERE a value
+ *    lives on a TreeNode. Eliminates the field-drift bug class where a
+ *    serializer reads a field the parser doesn't emit and silently emits
+ *    nothing.
+ * 2. **Generic inline walker** (`inline.ts`) — the 11-variant InlineNode switch,
+ *    written once, with markdown and HTML emitter presets.
+ * 3. **Capability + ledger** (`capability.ts`) — every exporter declares what it
+ *    cannot represent (static) and records what it actually lost (observed).
+ *    Known loss, never silent loss.
+ *
+ * Plus format-agnostic text helpers (`text.ts`) and an unknown-node fallback
+ * that reports instead of silently dropping (`unknown.ts`).
+ */
+export { leafInline, leafHtml, hasInline, hasContent, codeText, codeLang, tabTitle, tabValue, cardFields, cardBodySources, headingLevel, headingText, headingFragment, slugifyHeadingText, calloutVariant, calloutTitle, listStart, mediaSrc, renderLeaf, } from "./reads.js";
+export { walkInline, applyTextFlags, inlinePlainText, markdownInlineEmitters, htmlInlineEmitters, escapeHtml, escapeAttr, codeSpan, } from "./inline.js";
+export { ExportLedger, formatLedgerReport, formatCapabilityTable, unsupportedFeatures, validateCapabilities, validateLedgerAgainstCapabilities, } from "./capability.js";
+export { pickCodeFence, pickDirectiveFence, indent, prefixLines, normalizeTrailingWhitespace, stripHtml, inlineHtmlToMarkdown, yamlScalar, frontmatterBlock, } from "./text.js";
+export { resolvePlugins, composeCapabilities, formatPluginConflicts, } from "./plugins.js";
+export { realizeIncludes, hasIncludes, } from "./includes.js";
+export { renderUnknownNode, } from "./unknown.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,UAAU,GAEX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,QAAQ,GAIT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,GAMlC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,2BAA2B,EAC3B,SAAS,EACT,oBAAoB,EACpB,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GAMtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,WAAW,GAGZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,GAGlB,MAAM,cAAc,CAAC"}