@dogsbay/serialize-core 0.2.0-beta.98

package/dist/inline.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Generic inline walker.
+ *
+ * The 11-variant `InlineNode` switch used to be written FOUR times
+ * (`format-astro` twice — template and html modes — plus `format-obsidian` and
+ * `format-dogsbay-md`'s HTML-table fallback). All four were the same
+ * `nodes.map(...).join("")` walk differing only in what each leaf emits, and
+ * the duplication is why `format-astro` silently DROPPED `highlight`: adding an
+ * arm meant remembering four places, so `:highlight[…]` rendered as nothing in
+ * both of its renderers. All four now go through this walk (retrofit
+ * 2026-08-04), so a variant is handled once per format instead of once per
+ * copy — and an omission degrades to plain text via `onUnsupported` rather
+ * than vanishing.
+ *
+ * This module provides the walk once. A format supplies an {@link InlineEmitters}
+ * map; anything it omits falls back to a safe default, and — critically —
+ * omissions can be *recorded* rather than silently dropped, via `onUnsupported`.
+ *
+ * Not unified here: `format-dogsbay-md`'s inline renderer is a format-stack
+ * machine (it emits delta open/close marks across consecutive text nodes so
+ * `*a\nb*` round-trips as one emphasis run). That is a genuinely different
+ * traversal and is deliberately left alone.
+ */
+import type { InlineNode } from "@dogsbay/types";
+/** Callbacks available to every emitter. */
+export interface InlineContext {
+    /** Render nested inline children (link text, highlight content). */
+    recurse: (nodes: InlineNode[]) => string;
+    /** Escape literal text for the target format. */
+    escape: (text: string) => string;
+    /** Record that a construct could not be represented faithfully. */
+    report: (feature: string, detail?: string) => void;
+}
+/**
+ * Per-variant emitters. Every key is optional; a missing key means "this
+ * format cannot represent this inline type", which routes through
+ * {@link InlineWalkOptions.onUnsupported} instead of vanishing.
+ */
+export interface InlineEmitters {
+    text?: (node: Extract<InlineNode, {
+        type: "text";
+    }>, ctx: InlineContext) => string;
+    link?: (node: Extract<InlineNode, {
+        type: "link";
+    }>, ctx: InlineContext) => string;
+    image?: (node: Extract<InlineNode, {
+        type: "image";
+    }>, ctx: InlineContext) => string;
+    code?: (node: Extract<InlineNode, {
+        type: "code";
+    }>, ctx: InlineContext) => string;
+    highlight?: (node: Extract<InlineNode, {
+        type: "highlight";
+    }>, ctx: InlineContext) => string;
+    "footnote-ref"?: (node: Extract<InlineNode, {
+        type: "footnote-ref";
+    }>, ctx: InlineContext) => string;
+    kbd?: (node: Extract<InlineNode, {
+        type: "kbd";
+    }>, ctx: InlineContext) => string;
+    icon?: (node: Extract<InlineNode, {
+        type: "icon";
+    }>, ctx: InlineContext) => string;
+    math?: (node: Extract<InlineNode, {
+        type: "math";
+    }>, ctx: InlineContext) => string;
+    "html-inline"?: (node: Extract<InlineNode, {
+        type: "html-inline";
+    }>, ctx: InlineContext) => string;
+    break?: (node: Extract<InlineNode, {
+        type: "break";
+    }>, ctx: InlineContext) => string;
+}
+export interface InlineWalkOptions {
+    emitters: InlineEmitters;
+    /** Text escaping for the target format. Defaults to identity. */
+    escape?: (text: string) => string;
+    /**
+     * Called when no emitter exists for a variant. Return the fallback string
+     * (often a plain-text degradation). Default: best-effort plain text.
+     */
+    onUnsupported?: (node: InlineNode, ctx: InlineContext) => string;
+    /** Loss recorder — wire this to an `ExportLedger`. */
+    report?: (feature: string, detail?: string) => void;
+}
+/**
+ * Best-effort plain-text degradation for a variant a format cannot express.
+ * Always prefer losing formatting over losing CONTENT.
+ */
+export declare function inlinePlainText(node: InlineNode, escape: (s: string) => string): string;
+/** Render a list of inline nodes with the supplied emitters. */
+export declare function walkInline(nodes: InlineNode[], options: InlineWalkOptions): string;
+/**
+ * Apply bold/italic/strikethrough in the canonical order.
+ *
+ * Order matters and is shared by every existing renderer: bold innermost,
+ * then italic, then strikethrough outermost.
+ */
+export declare function applyTextFlags(text: string, node: Extract<InlineNode, {
+    type: "text";
+}>, wrap: {
+    bold: (s: string) => string;
+    italic: (s: string) => string;
+    strike: (s: string) => string;
+}): string;
+/**
+ * Markdown inline emitters — the common baseline for any markdown-family
+ * target (Docusaurus, GitBook, MyST, plain CommonMark).
+ *
+ * Formats override individual arms for their own syntax (e.g. Obsidian's
+ * `==highlight==` is already the markdown default; Docusaurus needs `<kbd>`).
+ * Code spans widen their backtick run so content containing backticks survives
+ * — the bug `format-obsidian`'s naive `` `${text}` `` still has.
+ */
+export declare function markdownInlineEmitters(): InlineEmitters;
+/**
+ * A CommonMark code span that survives a round trip.
+ *
+ * Widens the backtick fence past any run inside the content, and pads when the
+ * content begins/ends with a backtick OR A SPACE — CommonMark strips one space
+ * from each side of a padded span, so ` x ` would come back as `x`. Empty
+ * content needs the pad too, or `` renders as two literal backticks.
+ */
+export declare function codeSpan(text: string): string;
+/** Escape HTML special characters in TEXT content. */
+export declare function escapeHtml(s: string): string;
+/**
+ * Escape a value destined for a double-quoted HTML ATTRIBUTE.
+ *
+ * Distinct from {@link escapeHtml} because it must also escape `"` — without
+ * it an href like `/a" onmouseover="x` breaks out of the attribute. format-astro
+ * keeps these separate for the same reason.
+ */
+export declare function escapeAttr(s: string): string;
+/**
+ * HTML inline emitters — the baseline for HTML-ish targets.
+ * Includes the `highlight` arm (`<mark>`) whose absence from format-astro's
+ * two hand-written switches is what motivated this preset.
+ */
+export declare function htmlInlineEmitters(): InlineEmitters;
+//# sourceMappingURL=inline.d.ts.map

package/dist/inline.d.ts.map

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

package/dist/inline.js

@@ -0,0 +1,183 @@
+/**
+ * Best-effort plain-text degradation for a variant a format cannot express.
+ * Always prefer losing formatting over losing CONTENT.
+ */
+export function inlinePlainText(node, escape) {
+    switch (node.type) {
+        case "text":
+            return escape(node.text);
+        case "code":
+            return escape(node.text);
+        case "math":
+            return escape(node.latex);
+        case "kbd":
+            return escape(node.keys.join("+"));
+        case "icon":
+            return escape(node.library ? `${node.library}:${node.name}` : node.name);
+        case "break":
+            return "\n";
+        case "html-inline":
+            // Keep the markup rather than nothing — losing formatting beats losing content.
+            return node.html;
+        case "footnote-ref":
+            return escape(`[^${node.label}]`);
+        case "image":
+            return escape(node.alt ?? "");
+        case "link":
+        case "highlight":
+            return node.children.map((c) => inlinePlainText(c, escape)).join("");
+        default:
+            return "";
+    }
+}
+/** Render a list of inline nodes with the supplied emitters. */
+export function walkInline(nodes, options) {
+    const escape = options.escape ?? ((s) => s);
+    const report = options.report ?? (() => { });
+    const ctx = {
+        recurse: (children) => walkInline(children, options),
+        escape,
+        report,
+    };
+    const onUnsupported = options.onUnsupported ??
+        ((node, c) => {
+            c.report(`inline:${node.type}`, "no emitter for this inline type");
+            return inlinePlainText(node, c.escape);
+        });
+    return nodes
+        .map((node) => {
+        const emitter = options.emitters[node.type];
+        if (!emitter)
+            return onUnsupported(node, ctx);
+        return emitter(node, ctx);
+    })
+        .join("");
+}
+/**
+ * Apply bold/italic/strikethrough in the canonical order.
+ *
+ * Order matters and is shared by every existing renderer: bold innermost,
+ * then italic, then strikethrough outermost.
+ */
+export function applyTextFlags(text, node, wrap) {
+    let out = text;
+    if (node.bold)
+        out = wrap.bold(out);
+    if (node.italic)
+        out = wrap.italic(out);
+    if (node.strikethrough)
+        out = wrap.strike(out);
+    return out;
+}
+/**
+ * Markdown inline emitters — the common baseline for any markdown-family
+ * target (Docusaurus, GitBook, MyST, plain CommonMark).
+ *
+ * Formats override individual arms for their own syntax (e.g. Obsidian's
+ * `==highlight==` is already the markdown default; Docusaurus needs `<kbd>`).
+ * Code spans widen their backtick run so content containing backticks survives
+ * — the bug `format-obsidian`'s naive `` `${text}` `` still has.
+ */
+export function markdownInlineEmitters() {
+    return {
+        text: (node, ctx) => applyTextFlags(ctx.escape(node.text), node, {
+            bold: (s) => `**${s}**`,
+            italic: (s) => `*${s}*`,
+            strike: (s) => `~~${s}~~`,
+        }),
+        link: (node, ctx) => {
+            const title = node.title ? ` "${node.title}"` : "";
+            return `[${ctx.recurse(node.children)}](${node.href}${title})`;
+        },
+        image: (node) => {
+            const title = node.title ? ` "${node.title}"` : "";
+            return `![${node.alt ?? ""}](${node.src}${title})`;
+        },
+        code: (node) => codeSpan(node.text),
+        highlight: (node, ctx) => `==${ctx.recurse(node.children)}==`,
+        "footnote-ref": (node) => `[^${node.label}]`,
+        kbd: (node) => node.keys.map((k) => `<kbd>${k}</kbd>`).join("+"),
+        math: (node) => `$${node.latex}$`,
+        // The presets MUST cover all 11 variants — omitting one is the bug this
+        // module was written to stop (format-astro silently dropped `highlight`
+        // for exactly this reason, until the retrofit put it on this walk).
+        // `:icon[…]` is DOGSBAY-MD-ONLY syntax. Emitting it from the shared
+        // markdown preset put a literal `:icon[lucide:check]` on the page of every
+        // other markdown target — and, because an emitter now existed, silenced
+        // the `onUnsupported` ledger entry that used to record the drop. A visible
+        // artefact that nothing reports is strictly worse than a recorded drop, so
+        // the baseline emits the readable name and REPORTS. Formats with real icon
+        // syntax (dogsbay-md) override this key.
+        icon: (node, ctx) => {
+            const full = node.library ? `${node.library}:${node.name}` : node.name;
+            ctx.report("icon", `no icon syntax in this format — emitted as the name "${full}"`);
+            return node.name;
+        },
+        "html-inline": (node) => node.html,
+        break: () => "  \n",
+    };
+}
+/**
+ * A CommonMark code span that survives a round trip.
+ *
+ * Widens the backtick fence past any run inside the content, and pads when the
+ * content begins/ends with a backtick OR A SPACE — CommonMark strips one space
+ * from each side of a padded span, so ` x ` would come back as `x`. Empty
+ * content needs the pad too, or `` renders as two literal backticks.
+ */
+export function codeSpan(text) {
+    const longest = (text.match(/`+/g) ?? []).reduce((max, run) => Math.max(max, run.length), 0);
+    const fence = "`".repeat(longest + 1);
+    const needsPad = text.length === 0 ||
+        text.startsWith("`") ||
+        text.endsWith("`") ||
+        text.startsWith(" ") ||
+        text.endsWith(" ");
+    const pad = needsPad ? " " : "";
+    return `${fence}${pad}${text}${pad}${fence}`;
+}
+/** Escape HTML special characters in TEXT content. */
+export function escapeHtml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/**
+ * Escape a value destined for a double-quoted HTML ATTRIBUTE.
+ *
+ * Distinct from {@link escapeHtml} because it must also escape `"` — without
+ * it an href like `/a" onmouseover="x` breaks out of the attribute. format-astro
+ * keeps these separate for the same reason.
+ */
+export function escapeAttr(s) {
+    return escapeHtml(s).replace(/"/g, "&quot;");
+}
+/**
+ * HTML inline emitters — the baseline for HTML-ish targets.
+ * Includes the `highlight` arm (`<mark>`) whose absence from format-astro's
+ * two hand-written switches is what motivated this preset.
+ */
+export function htmlInlineEmitters() {
+    return {
+        text: (node, ctx) => applyTextFlags(ctx.escape(node.text), node, {
+            bold: (s) => `<strong>${s}</strong>`,
+            italic: (s) => `<em>${s}</em>`,
+            strike: (s) => `<s>${s}</s>`,
+        }),
+        link: (node, ctx) => {
+            const title = node.title ? ` title="${escapeAttr(node.title)}"` : "";
+            return `<a href="${escapeAttr(node.href)}"${title}>${ctx.recurse(node.children)}</a>`;
+        },
+        image: (node) => `<img src="${escapeAttr(node.src)}" alt="${escapeAttr(node.alt ?? "")}" />`,
+        code: (node, ctx) => `<code>${ctx.escape(node.text)}</code>`,
+        highlight: (node, ctx) => `<mark>${ctx.recurse(node.children)}</mark>`,
+        "footnote-ref": (node) => `<sup><a href="#fn-${node.label}" id="fnref-${node.label}">[${node.label}]</a></sup>`,
+        kbd: (node) => node.keys.map((k) => `<kbd>${escapeHtml(k)}</kbd>`).join("+"),
+        math: (node, ctx) => `<code class="math-inline">${ctx.escape(node.latex)}</code>`,
+        icon: (node) => {
+            const full = node.library ? `${node.library}:${node.name}` : node.name;
+            return `<span class="dogsbay-icon" data-icon="${escapeAttr(full)}"></span>`;
+        },
+        "html-inline": (node) => node.html,
+        break: () => "<br />",
+    };
+}
+//# sourceMappingURL=inline.js.map

package/dist/inline.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Export plugin composition.
+ *
+ * A target format's capability is NOT a fixed property of the format — it is a
+ * property of the format **plus the plugins the emitted project will use**.
+ * Vanilla Docusaurus cannot represent an API endpoint; Docusaurus *with*
+ * `docusaurus-plugin-openapi-docs` can. So the capability declaration must be
+ * composed, not constant.
+ *
+ * This module holds the format-agnostic half: plugin metadata, per-feature
+ * provider resolution, and capability composition. The emission hooks
+ * themselves are format-specific (a Docusaurus plugin mutates
+ * `docusaurus.config.js`; an MkDocs one mutates `mkdocs.yml`), so each format
+ * extends {@link ExportPluginMeta} with its own hook signatures.
+ *
+ * Two rules, both inherited from the no-silent-loss doctrine:
+ *
+ * - A plugin that claims a feature must say at what level, and (via
+ *   {@link CapabilityDeclaration}) what is still lost.
+ * - When two plugins claim the same feature it is an ERROR, not a silent
+ *   pick. Resolution order is explicit override → declaration order, and an
+ *   unresolved clash is surfaced to the user.
+ */
+import type { CapabilityDeclaration, SupportLevel } from "./capability.js";
+/** Format-agnostic plugin metadata. Formats extend this with emission hooks. */
+export interface ExportPluginMeta {
+    /** Stable id used for `--plugins` selection and conflict messages. */
+    id: string;
+    /** One-line description shown when listing available plugins. */
+    description?: string;
+    /**
+     * Features this plugin takes ownership of, and the support level it raises
+     * them to. Keys match `CapabilityDeclaration.feature` / TreeNode types.
+     */
+    provides: Record<string, SupportLevel>;
+    /**
+     * Capability declarations that REPLACE the base format's entry for the
+     * features above — including what is still lost at the higher level.
+     */
+    capabilities?: CapabilityDeclaration[];
+    /** Plugin ids that cannot be used alongside this one. */
+    conflictsWith?: string[];
+    /** Extra steps the user must run after export (e.g. a codegen command). */
+    postExportSteps?: string[];
+}
+export interface ProviderConflict {
+    feature: string;
+    /** Plugin ids competing for the feature. */
+    candidates: string[];
+}
+/** An explicit `--provider feature=plugin` that cannot be honoured. */
+export interface InvalidOverride {
+    feature: string;
+    plugin: string;
+    reason: string;
+    /** Plugins that DO provide the feature — the usable choices. */
+    candidates: string[];
+}
+export interface ResolvedPlugins<P extends ExportPluginMeta> {
+    /** Selected plugins, in declaration order. */
+    plugins: P[];
+    /** feature → the plugin that owns emitting it. */
+    byFeature: Map<string, P>;
+    /** Unresolved clashes — the caller must surface these, never ignore them. */
+    conflicts: ProviderConflict[];
+    /** Overrides that name a plugin which cannot provide the feature. */
+    invalidOverrides: InvalidOverride[];
+    /** Mutual-exclusion violations (`conflictsWith`). */
+    incompatible: Array<{
+        plugin: string;
+        conflictsWith: string;
+    }>;
+}
+export interface ResolveOptions {
+    /**
+     * Explicit per-feature winner: `{ endpoint: "openapi-docs" }`. Beats
+     * declaration order and silences the conflict for that feature.
+     */
+    overrides?: Record<string, string>;
+}
+/**
+ * Resolve which plugin owns each feature.
+ *
+ * Precedence: explicit override → declaration order (earlier wins).
+ * A later plugin claiming an already-owned feature produces a conflict rather
+ * than quietly losing or quietly winning.
+ */
+export declare function resolvePlugins<P extends ExportPluginMeta>(plugins: P[], options?: ResolveOptions): ResolvedPlugins<P>;
+/**
+ * Compose the effective capability declaration: the base format's, with each
+ * resolved plugin's entries replacing the features it owns.
+ *
+ * The result is what the user should be shown — "with THIS profile, here is
+ * what you lose" — rather than the format's worst case.
+ */
+export declare function composeCapabilities<P extends ExportPluginMeta>(base: readonly CapabilityDeclaration[], resolved: ResolvedPlugins<P>): CapabilityDeclaration[];
+/** Human-readable explanation of any unresolved clash. */
+export declare function formatPluginConflicts<P extends ExportPluginMeta>(resolved: ResolvedPlugins<P>): string[];
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE3E,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC;;;OAGG;IACH,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,gBAAgB;IACzD,8CAA8C;IAC9C,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,kDAAkD;IAClD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1B,6EAA6E;IAC7E,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,qEAAqE;IACrE,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,qDAAqD;IACrD,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EACvD,OAAO,EAAE,CAAC,EAAE,EACZ,OAAO,GAAE,cAAmB,GAC3B,eAAe,CAAC,CAAC,CAAC,CA0DpB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,EAC5D,IAAI,EAAE,SAAS,qBAAqB,EAAE,EACtC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,qBAAqB,EAAE,CA+BzB;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,gBAAgB,EAC9D,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,MAAM,EAAE,CAqBV"}

package/dist/plugins.js

@@ -0,0 +1,119 @@
+/**
+ * Resolve which plugin owns each feature.
+ *
+ * Precedence: explicit override → declaration order (earlier wins).
+ * A later plugin claiming an already-owned feature produces a conflict rather
+ * than quietly losing or quietly winning.
+ */
+export function resolvePlugins(plugins, options = {}) {
+    const byFeature = new Map();
+    const claims = new Map();
+    const conflicts = [];
+    const invalidOverrides = [];
+    const incompatible = [];
+    const overrides = options.overrides ?? {};
+    const selected = new Set(plugins.map((p) => p.id));
+    for (const plugin of plugins) {
+        for (const other of plugin.conflictsWith ?? []) {
+            if (selected.has(other)) {
+                incompatible.push({ plugin: plugin.id, conflictsWith: other });
+            }
+        }
+    }
+    for (const plugin of plugins) {
+        for (const feature of Object.keys(plugin.provides)) {
+            const seen = claims.get(feature) ?? [];
+            seen.push(plugin.id);
+            claims.set(feature, seen);
+            const override = overrides[feature];
+            if (override) {
+                if (plugin.id === override)
+                    byFeature.set(feature, plugin);
+                continue;
+            }
+            if (!byFeature.has(feature))
+                byFeature.set(feature, plugin);
+        }
+    }
+    for (const [feature, candidates] of claims) {
+        if (candidates.length > 1 && !overrides[feature]) {
+            conflicts.push({ feature, candidates });
+        }
+    }
+    // An override must actually resolve the feature. Without this check a typo
+    // (`--provider endpoint=mermaid`) silently SWALLOWED a real a/b conflict and
+    // left the feature with no owner — the exporter then emitted a project whose
+    // content and capability report disagreed, with no error.
+    for (const [feature, id] of Object.entries(overrides)) {
+        if (byFeature.has(feature))
+            continue;
+        const candidates = claims.get(feature) ?? [];
+        invalidOverrides.push({
+            feature,
+            plugin: id,
+            reason: !selected.has(id)
+                ? "not selected"
+                : candidates.length === 0
+                    ? "no plugin provides this feature"
+                    : `does not provide it (providers: ${candidates.join(", ")})`,
+            candidates,
+        });
+    }
+    return { plugins, byFeature, conflicts, invalidOverrides, incompatible };
+}
+/**
+ * Compose the effective capability declaration: the base format's, with each
+ * resolved plugin's entries replacing the features it owns.
+ *
+ * The result is what the user should be shown — "with THIS profile, here is
+ * what you lose" — rather than the format's worst case.
+ */
+export function composeCapabilities(base, resolved) {
+    const out = new Map();
+    for (const cap of base)
+        out.set(cap.feature, cap);
+    for (const [feature, plugin] of resolved.byFeature) {
+        const declared = plugin.capabilities?.find((c) => c.feature === feature);
+        if (declared && declared.support !== "full" && !declared.note) {
+            throw new Error(`Plugin "${plugin.id}" declares "${feature}" as ${declared.support} ` +
+                `with no note explaining the loss.`);
+        }
+        if (declared) {
+            out.set(feature, declared);
+            continue;
+        }
+        // No explicit declaration — raise the support level and name the provider.
+        const level = plugin.provides[feature];
+        const existing = out.get(feature);
+        // Do NOT reuse the base note OR rendersAs: both describe the un-plugged
+        // level. Keeping `rendersAs` published rows like
+        // `| endpoint | partial | omitted entirely | provided by openapi-docs |`
+        // — the same self-contradiction the note rule above exists to prevent.
+        void existing;
+        out.set(feature, {
+            feature,
+            support: level,
+            note: level === "full" ? undefined : `provided by ${plugin.id}`,
+        });
+    }
+    return [...out.values()];
+}
+/** Human-readable explanation of any unresolved clash. */
+export function formatPluginConflicts(resolved) {
+    const lines = [];
+    for (const c of resolved.incompatible) {
+        lines.push(`plugins "${c.plugin}" and "${c.conflictsWith}" cannot be used together`);
+    }
+    for (const c of resolved.conflicts) {
+        lines.push(`feature "${c.feature}" is claimed by ${c.candidates.length} plugins ` +
+            `(${c.candidates.join(", ")}) — choose one, e.g. --provider ${c.feature}=${c.candidates[0]}`);
+    }
+    for (const o of resolved.invalidOverrides) {
+        const fix = o.candidates.length > 0
+            ? ` — use one of: ${o.candidates.join(", ")}`
+            : "";
+        lines.push(`--provider ${o.feature}=${o.plugin} cannot be honoured: ${o.reason}${fix}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

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