cudoc-remark 0.4.0 → 0.6.0

package/README.md

@@ -1,8 +1,10 @@
 # cudoc-remark
 
+> **Most sites do not set this package up themselves.** On Docusaurus and Nextra it sits under the adapter: install it beside `cudoc-docusaurus` or `cudoc-nextra` and take only its embed plugin, library loader and compiler capture from it, as the [Docusaurus](https://github.com/cudoment/cudoc/tree/main/docs/docusaurus.md) and [Nextra](https://github.com/cudoment/cudoc/tree/main/docs/nextra.md) guides show. Configure it directly in two cases only: a Next.js site on `@next/mdx`, which has no adapter ([Next.js guide](https://github.com/cudoment/cudoc/tree/main/docs/next.md)), and a remark or MDX pipeline you assemble yourself. Otherwise start from [your site generator](https://github.com/cudoment/cudoc#pick-your-site-generator).
+
 Connect cudoc Markdown syntax and prepared document embeds to a remark/MDX pipeline.
 
-This separate package is a pipeline adapter, not a second implementation of cudoc's rules. Shared document semantics live in `@cudoment/cudoc`. Use it directly with Next.js/remark; Docusaurus and Nextra adapters already depend on it. VitePress and Eleventy share `cudoc-markdown-it`, and HTML uses its own adapter; none of them need this plugin.
+This separate package is a pipeline adapter, not a second implementation of cudoc's rules. Shared document semantics live in `@cudoment/cudoc`. VitePress and Eleventy share `cudoc-markdown-it`, and HTML uses its own adapter; none of them need this plugin.
 
 ESM · Node.js 20+
 
@@ -17,13 +19,13 @@ import cudoc from "cudoc-remark"
 const remarkPlugins = [remarkGfm, [cudoc, { host: "next", syntax: {} }]]
 ```
 
-Default settings produce component-free output in both `.md` and `.mdx`; `syntax: {}` makes the defaults explicit. Let the host detect the document format. For Next.js Turbopack, use package-name plugin strings and JSON options as shown in the guide. `cudoc-remark/embed` inserts its runtime automatically after collection and preparation.
+Default settings produce component-free output in both `.md` and `.mdx`; `syntax: {}` makes the defaults explicit. Let the host detect the document format. For Next.js Turbopack, use package-name plugin strings and JSON options as shown in the guide. After collection and preparation, `cudoc-remark/embed` splices each prepared embed into the page as it compiles, so embedded components render through the host's own component mapping; `cudoc-remark/loader` keeps a recollection visible to the dev server and the build cache.
 
 Choose `host`, `cudoc` or `both` independently for `headingAnchor`, `badge`, `tableCellList`, `callout` and `link`. The representative callout is `> [!NOTE] Title`. Authors do not register cudoc React components in the recommended setup. Syntax-only rendering needs no stored JSON; cross-document embedding requires document collection.
 
 - [Usage guide](https://github.com/cudoment/cudoc/tree/main/docs/next.md) · [한국어 가이드](https://github.com/cudoment/cudoc/tree/main/docs/next.ko.md)
 - [Markdown syntax](https://github.com/cudoment/cudoc/tree/main/docs/syntax.md)
 - [Embedding](https://github.com/cudoment/cudoc/tree/main/docs/embedding.md)
-- [Standalone HTML alongside a host](https://github.com/cudoment/cudoc/tree/main/docs/html.md#export-alongside-an-existing-site)
+- [Standalone HTML alongside a host](https://github.com/cudoment/cudoc/tree/main/docs/export.md#export-alongside-an-existing-site)
 - [API reference](https://github.com/cudoment/cudoc/tree/main/docs/api-reference/README.md)
 - [Runnable examples](https://github.com/cudoment/cudoc/tree/main/examples/README.md)

package/dist/capture.d.ts

@@ -1,8 +1,29 @@
 import type { Root } from "mdast";
 import type { Plugin } from "unified";
 import type { CompiledDocument } from "@cudoment/cudoc/markdown";
-/** Capture remark's final tree at the start of rehype, after native host plugins. */
-export declare function createCompilerCapture(): {
+export type CompilerCaptureOptions = {
+    /**
+     * Path prefixes the host resolves by itself, each with the prefix an image
+     * is recorded under instead. Docusaurus reads `@site/static/img/logo.png`
+     * from the site directory and serves it at `/img/logo.png`, an address the
+     * check and the export resolve through their asset directories, so a
+     * Docusaurus collector passes `{ "@site/static/": "/" }`. The longest
+     * matching prefix wins; the host's own page is not changed. Only images
+     * are recorded this way: a link keeps the path it was written with.
+     */
+    aliases?: Record<string, string>;
+};
+/**
+ * Capture remark's final tree at the start of rehype, after native host plugins.
+ *
+ * `capture.remark` also notes every Markdown image as it stands then. A host
+ * plugin that runs later may turn one into a component of its own, as
+ * Docusaurus turns each into an `<img>` requiring the file; it rewrites the
+ * node in place, so the note still finds it, and the captured component keeps
+ * the image as `data.cudocImage` for everything that renders the stored tree
+ * without the host.
+ */
+export declare function createCompilerCapture(options?: CompilerCaptureOptions): {
     remark: Plugin<[], Root>;
     rehype: Plugin;
     read(): CompiledDocument;

package/dist/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,qFAAqF;AACrF,wBAAgB,qBAAqB;;;YAyBzB,gBAAgB;EAQ3B"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,IAAI,EAAE,MAAM,OAAO,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAMrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAGhE,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B;;;YAwE9D,gBAAgB;EAQ3B"}

package/dist/capture.js

@@ -1,16 +1,67 @@
-import { lowerNativeElements } from "@cudoment/cudoc/document";
-/** Capture remark's final tree at the start of rehype, after native host plugins. */
-export function createCompilerCapture() {
+import { visit } from "unist-util-visit";
+import { lowerNativeElements, } from "@cudoment/cudoc/document";
+import { importedNames, importedNamesFromSource } from "@cudoment/cudoc/mdx";
+/**
+ * Capture remark's final tree at the start of rehype, after native host plugins.
+ *
+ * `capture.remark` also notes every Markdown image as it stands then. A host
+ * plugin that runs later may turn one into a component of its own, as
+ * Docusaurus turns each into an `<img>` requiring the file; it rewrites the
+ * node in place, so the note still finds it, and the captured component keeps
+ * the image as `data.cudocImage` for everything that renders the stored tree
+ * without the host.
+ */
+export function createCompilerCapture(options = {}) {
+    const given = options.aliases === undefined ? {} : options.aliases;
+    if (typeof given !== "object" ||
+        given === null ||
+        Array.isArray(given) ||
+        Object.entries(given).some(([prefix, value]) => !prefix || typeof value !== "string"))
+        throw new TypeError("cudoc: capture aliases must map path prefixes to strings");
+    const aliases = Object.entries(given).sort(([a], [b]) => b.length - a.length);
+    const portable = (url) => {
+        const alias = aliases.find(([prefix]) => url.startsWith(prefix));
+        return alias ? `${alias[1]}${url.slice(alias[0].length)}` : url;
+    };
     let current;
     let result;
+    const images = new Map();
     const remark = () => (tree) => {
         current = tree;
+        images.clear();
+        visit(tree, "image", (node) => {
+            images.set(node, {
+                url: portable(node.url),
+                alt: node.alt ?? null,
+                title: node.title ?? null,
+            });
+        });
     };
     const rehype = () => (_tree, file) => {
         if (!current)
             throw new Error("cudoc: install capture.remark before capture.rehype");
+        for (const [node, image] of images) {
+            const replaced = node;
+            if (replaced.type !== "image")
+                replaced.data = { ...replaced.data, cudocImage: image };
+        }
         const tree = structuredClone(current);
+        // An image the host kept is recorded under the same address.
+        if (aliases.length)
+            visit(tree, "image", (node) => {
+                node.url = portable(node.url);
+            });
         lowerNativeElements(tree);
+        // A host may have hoisted the ESM out of the tree already, so the source
+        // is read as well; the two agree when both are present.
+        const imports = [
+            ...new Set([
+                ...importedNames(tree),
+                ...(file.extname === ".mdx"
+                    ? importedNamesFromSource(String(file.value))
+                    : []),
+            ]),
+        ];
         tree.children = tree.children.filter((n) => !["yaml", "mdxjsEsm"].includes(n.type));
         result = {
             tree,
@@ -18,6 +69,7 @@ export function createCompilerCapture() {
                 file.data.frontmatter ??
                 {}),
             diagnostics: [],
+            ...(imports.length ? { imports } : {}),
         };
     };
     return {

package/dist/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAG9D,qFAAqF;AACrF,MAAM,UAAU,qBAAqB;IACnC,IAAI,OAAyB,CAAA;IAC7B,IAAI,MAAoC,CAAA;IACxC,MAAM,MAAM,GAAqB,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9C,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC,CAAA;IACD,MAAM,MAAM,GAAW,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,IAAI,CAAC,OAAO;YACV,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;QACxE,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QACrC,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9C,CAAA;QACD,MAAM,GAAG;YACP,IAAI;YACJ,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;gBACjC,IAAI,CAAC,IAAI,CAAC,WAAW;gBACrB,EAAE,CAA4B;YAChC,WAAW,EAAE,EAAE;SAChB,CAAA;IACH,CAAC,CAAA;IACD,OAAO;QACL,MAAM;QACN,MAAM;QACN,IAAI;YACF,IAAI,CAAC,MAAM;gBACT,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAA;YACH,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"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"}

package/dist/embed.d.ts

@@ -1,9 +1,43 @@
+/**
+ * Prepared embeds, spliced into the document as it compiles.
+ *
+ * `prepareEmbeds` has already resolved every fence into an mdast block: the
+ * selected sections, replacements applied, ids and links rebased, nested
+ * embeds expanded, all produced by the host's own compiler. This plugin puts
+ * those nodes where the fence was, so the rest of the host's pipeline — its
+ * remaining remark plugins, remark-rehype, the component mapping — treats
+ * them exactly like the document's own content. A component in an embedded
+ * section renders through the host's components; a code block reaches the
+ * host's highlighter; nothing is turned into an HTML string first.
+ *
+ * The stored blocks carry no `estree`: the AST export strips it, because it
+ * is compiler state rather than content. The expression text is kept, so the
+ * estree is parsed again here for every expression node the block contains.
+ */
 import type { Root } from "mdast";
 import type { Plugin } from "unified";
-/** Render persisted embeds inside the current host compilation. */
-declare const embed: Plugin<[{
+import type { DocumentNode } from "@cudoment/cudoc/document";
+import { type SourceRoot } from "@cudoment/cudoc/node/roots";
+export type EmbedPluginOptions = {
+    /** The prepared library. Defaults to `.cudoc/documents`. */
     outDir?: string;
+    /** One root at the top of the library. Defaults to `docs` when `roots` is absent. */
     sourceRoot?: string;
-}?], Root>;
+    /** The roots collection used, so a file maps to the same id here. */
+    roots?: SourceRoot[];
+};
+/**
+ * Gives every expression node in a stored block the estree the MDX compiler
+ * needs, from the expression text the export preserved.
+ *
+ * A JSX attribute value expression is parsed as an expression; a spread
+ * attribute as the object `{...value}` the MDX parser itself builds; a flow or
+ * text expression as an expression, or as an empty program when it holds only
+ * a comment. Anything that does not parse names the document and the text, so
+ * a block that compiled at collection but not here is not a silent failure.
+ */
+export declare function restoreExpressions(node: DocumentNode, documentId: string): void;
+/** Splice prepared embeds into the current host compilation. */
+declare const embed: Plugin<[EmbedPluginOptions?], Root>;
 export default embed;
 //# sourceMappingURL=embed.d.ts.map

package/dist/embed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AASrC,mEAAmE;AACnE,QAAA,MAAM,KAAK,EAAE,MAAM,CAAC,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EAAE,IAAI,CA6ElE,CAAA;AACH,eAAe,KAAK,CAAA"}
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAGrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAI5D,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,4BAA4B,CAAA;AAInC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qEAAqE;IACrE,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;CACrB,CAAA;AAcD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CA8CN;AAED,gEAAgE;AAChE,QAAA,MAAM,KAAK,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CA6B5C,CAAA;AACH,eAAe,KAAK,CAAA"}

package/dist/embed.js

@@ -1,74 +1,106 @@
-import path from "node:path";
-import { parse } from "acorn";
-import { readPreparedEmbeds, embedKey, } from "@cudoment/cudoc/node/prepare-embeds";
-/** Render persisted embeds inside the current host compilation. */
-const embed = (options = {}) => (tree, file) => {
-    let prepared;
-    let index = 0;
-    let usesEmbeds = false;
-    // One import per document makes the generated data a real bundler dependency.
-    // Rebuilding sources updates embeds.json even when the Markdown page is cached.
-    let relativeData = path
-        .relative(path.dirname(file.path), path.resolve(options.outDir ?? ".cudoc/documents", "embeds.json"))
-        .split(path.sep)
-        .join("/");
-    if (!relativeData.startsWith("."))
-        relativeData = `./${relativeData}`;
-    const documentId = path
-        .relative(path.resolve(options.sourceRoot ?? "docs"), file.path)
-        .split(path.sep)
-        .join("/")
-        .replace(/\.mdx?$/i, "");
-    const expand = (node) => {
-        if (!node.children)
-            return;
-        node.children = node.children.flatMap((child) => {
-            if (child.type === "code" && child.lang === "cudoc-embed") {
-                prepared ??= readPreparedEmbeds(options.outDir ?? ".cudoc/documents", documentId, String(file.value));
-                const result = prepared.blocks[embedKey(documentId, child.value, ++index)];
-                if (!result)
-                    throw new Error(`cudoc: prepared embed missing in ${documentId}; recollect documents`);
-                usesEmbeds = true;
-                const expression = `_cudocData.blocks[${JSON.stringify(embedKey(documentId, child.value, index))}]`;
-                return [
-                    {
-                        type: "mdxJsxFlowElement",
-                        name: "_CudocEmbed",
-                        attributes: [
-                            {
-                                type: "mdxJsxAttribute",
-                                name: "tree",
-                                value: {
-                                    type: "mdxJsxAttributeValueExpression",
-                                    value: expression,
-                                    data: {
-                                        estree: parse(expression, {
-                                            ecmaVersion: "latest",
-                                            sourceType: "module",
-                                        }),
-                                    },
-                                },
-                            },
-                        ],
-                        children: [],
-                    },
-                ];
+/**
+ * Prepared embeds, spliced into the document as it compiles.
+ *
+ * `prepareEmbeds` has already resolved every fence into an mdast block: the
+ * selected sections, replacements applied, ids and links rebased, nested
+ * embeds expanded, all produced by the host's own compiler. This plugin puts
+ * those nodes where the fence was, so the rest of the host's pipeline — its
+ * remaining remark plugins, remark-rehype, the component mapping — treats
+ * them exactly like the document's own content. A component in an embedded
+ * section renders through the host's components; a code block reaches the
+ * host's highlighter; nothing is turned into an HTML string first.
+ *
+ * The stored blocks carry no `estree`: the AST export strips it, because it
+ * is compiler state rather than content. The expression text is kept, so the
+ * estree is parsed again here for every expression node the block contains.
+ */
+import { Parser } from "acorn";
+import jsx from "acorn-jsx";
+// The roots module alone: a host loads its configuration, and this plugin
+// with it, in a runtime that cannot import the compiler stack behind
+// `node/library`.
+import { documentIdOf, resolveRoots, } from "@cudoment/cudoc/node/roots";
+import { expandPreparedEmbeds } from "@cudoment/cudoc/node/prepare-embeds";
+import { stripLibraryMarker } from "./loader.js";
+const parser = Parser.extend(jsx());
+const parse = (source) => parser.parse(source, {
+    ecmaVersion: "latest",
+    sourceType: "module",
+    locations: false,
+});
+/** A program holding only comments, which is what a commented-out expression compiles to. */
+const commentOnly = (value) => value.replace(/\/\*[\s\S]*?\*\/|\/\/[^\n]*/g, "").trim() === "";
+/**
+ * Gives every expression node in a stored block the estree the MDX compiler
+ * needs, from the expression text the export preserved.
+ *
+ * A JSX attribute value expression is parsed as an expression; a spread
+ * attribute as the object `{...value}` the MDX parser itself builds; a flow or
+ * text expression as an expression, or as an empty program when it holds only
+ * a comment. Anything that does not parse names the document and the text, so
+ * a block that compiled at collection but not here is not a silent failure.
+ */
+export function restoreExpressions(node, documentId) {
+    const estreeFor = (value, wrap) => {
+        try {
+            return parse(wrap(value));
+        }
+        catch (cause) {
+            if (commentOnly(value))
+                return { type: "Program", body: [], sourceType: "module", comments: [] };
+            throw new Error(`cudoc: embedded expression in ${documentId} does not parse: {${value}}`, { cause });
+        }
+    };
+    const visit = (current) => {
+        if ((current.type === "mdxFlowExpression" ||
+            current.type === "mdxTextExpression") &&
+            typeof current.value === "string")
+            current.data = {
+                ...current.data,
+                estree: estreeFor(current.value, (v) => `(${v})`),
+            };
+        if (Array.isArray(current.attributes))
+            for (const attribute of current.attributes) {
+                if (attribute.type === "mdxJsxExpressionAttribute") {
+                    attribute.data = {
+                        ...attribute.data,
+                        estree: estreeFor(String(attribute.value), (v) => `({${v}})`),
+                    };
+                    continue;
+                }
+                const value = attribute.value;
+                if (value &&
+                    typeof value === "object" &&
+                    value.type === "mdxJsxAttributeValueExpression")
+                    value.data = {
+                        ...value.data,
+                        estree: estreeFor(String(value.value), (v) => `(${v})`),
+                    };
             }
-            expand(child);
-            return [child];
-        });
+        current.children?.forEach(visit);
     };
-    expand(tree);
-    if (usesEmbeds) {
-        const value = `import { EmbeddedDocument as _CudocEmbed } from "cudoc-remark/runtime";\nimport _cudocData from ${JSON.stringify(relativeData)};`;
-        tree.children.unshift({
-            type: "mdxjsEsm",
-            value,
-            data: {
-                estree: parse(value, { ecmaVersion: "latest", sourceType: "module" }),
-            },
-        });
-    }
+    visit(node);
+}
+/** Splice prepared embeds into the current host compilation. */
+const embed = (options = {}) => (tree, file) => {
+    expandPreparedEmbeds(tree, 
+    // Resolved only when a fence is met: a file outside every root is fine
+    // as long as it embeds nothing.
+    () => {
+        const roots = resolveRoots(options.roots === undefined && options.sourceRoot === undefined
+            ? { sourceRoot: "docs" }
+            : options);
+        const documentId = documentIdOf(roots, file.path);
+        if (documentId === undefined)
+            throw new Error(`cudoc: ${file.path} is outside every collection root, so its embeds have no prepared data`);
+        return {
+            outDir: options.outDir ?? ".cudoc/documents",
+            documentId,
+            // The loader may have appended its marker line; the snapshot was
+            // taken from the file itself.
+            source: stripLibraryMarker(String(file.value)),
+        };
+    }, (block, documentId) => restoreExpressions(block, documentId));
 };
 export default embed;
 //# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -1 +1 @@
-{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAC9B,OAAO,GAAG,MAAM,WAAW,CAAA;AAE3B,0EAA0E;AAC1E,qEAAqE;AACrE,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,YAAY,GAEb,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAWhD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;AACnC,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,EAAE,CAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,KAAK;CACjB,CAAC,CAAA;AAEJ,6FAA6F;AAC7F,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE,CACpC,KAAK,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AAEjE;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,UAAkB;IAElB,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,IAA2B,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,WAAW,CAAC,KAAK,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;YAC1E,MAAM,IAAI,KAAK,CACb,iCAAiC,UAAU,qBAAqB,KAAK,GAAG,EACxE,EAAE,KAAK,EAAE,CACV,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,CAAC,OAAqB,EAAE,EAAE;QACtC,IACE,CAAC,OAAO,CAAC,IAAI,KAAK,mBAAmB;YACnC,OAAO,CAAC,IAAI,KAAK,mBAAmB,CAAC;YACvC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAEjC,OAAO,CAAC,IAAI,GAAG;gBACb,GAAG,OAAO,CAAC,IAAI;gBACf,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;aAC1B,CAAA;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;YACnC,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAuC,EAAE,CAAC;gBACxE,IAAI,SAAS,CAAC,IAAI,KAAK,2BAA2B,EAAE,CAAC;oBACnD,SAAS,CAAC,IAAI,GAAG;wBACf,GAAI,SAAS,CAAC,IAA2B;wBACzC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;qBAC9D,CAAA;oBACD,SAAQ;gBACV,CAAC;gBACD,MAAM,KAAK,GAAG,SAAS,CAAC,KAA4C,CAAA;gBACpE,IACE,KAAK;oBACL,OAAO,KAAK,KAAK,QAAQ;oBACzB,KAAK,CAAC,IAAI,KAAK,gCAAgC;oBAE/C,KAAK,CAAC,IAAI,GAAG;wBACX,GAAI,KAAK,CAAC,IAA2B;wBACrC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;qBACxD,CAAA;YACL,CAAC;QACH,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC,CAAA;IACD,KAAK,CAAC,IAAI,CAAC,CAAA;AACb,CAAC;AAED,gEAAgE;AAChE,MAAM,KAAK,GACT,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE,CACjB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IACb,oBAAoB,CAClB,IAAI;IACJ,uEAAuE;IACvE,gCAAgC;IAChC,GAAG,EAAE;QACH,MAAM,KAAK,GAAG,YAAY,CACxB,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAC7D,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE;YACxB,CAAC,CAAC,OAAO,CACZ,CAAA;QACD,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,IAAI,UAAU,KAAK,SAAS;YAC1B,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,CAAC,IAAI,wEAAwE,CAC5F,CAAA;QACH,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,kBAAkB;YAC5C,UAAU;YACV,iEAAiE;YACjE,8BAA8B;YAC9B,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAC/C,CAAA;IACH,CAAC,EACD,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CACpB,kBAAkB,CAAC,KAAgC,EAAE,UAAU,CAAC,CACnE,CAAA;AACH,CAAC,CAAA;AACH,eAAe,KAAK,CAAA"}

package/dist/host-plugins.d.ts

@@ -6,7 +6,7 @@
  */
 import type { PluggableList } from "unified";
 import { type CudocRemarkOptions } from "./options.js";
-export type HostPluginOptions = Omit<CudocRemarkOptions, "toc"> & {
+export type HostPluginOptions = Omit<CudocRemarkOptions, "toc" | "host" | "headingIds"> & {
     /**
      * Copy each anchor id onto its heading so the host uses it instead of
      * slugifying the heading text. On by default; turning it off leaves the
@@ -14,5 +14,10 @@ export type HostPluginOptions = Omit<CudocRemarkOptions, "toc"> & {
      */
     promoteHeadingIds?: boolean;
 };
-export declare const createHostPlugins: (options: HostPluginOptions | undefined, adapter: string) => PluggableList;
+/**
+ * The remark plugins a Docusaurus or Nextra adapter hands its host, in order.
+ * `host` is the adapter's own, and decides what the host is given: Docusaurus
+ * receives a settled id its slugger would change as `{#id}` text.
+ */
+export declare const createHostPlugins: (options: HostPluginOptions | undefined, adapter: string, host: "docusaurus" | "nextra") => PluggableList;
 //# sourceMappingURL=host-plugins.d.ts.map

package/dist/host-plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-plugins.d.ts","sourceRoot":"","sources":["../src/host-plugins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAItE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,GAAG;IAChE;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AA6BD,eAAO,MAAM,iBAAiB,GAC5B,SAAS,iBAAiB,YAAK,EAC/B,SAAS,MAAM,KACd,aAkCF,CAAA"}
+{"version":3,"file":"host-plugins.d.ts","sourceRoot":"","sources":["../src/host-plugins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAU,aAAa,EAAE,MAAM,SAAS,CAAA;AAGpD,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAItE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,kBAAkB,EAClB,KAAK,GAAG,MAAM,GAAG,YAAY,CAC9B,GAAG;IACF;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAgED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,iBAAiB,YAAK,EAC/B,SAAS,MAAM,EACf,MAAM,YAAY,GAAG,QAAQ,KAC5B,aAsCF,CAAA"}

package/dist/host-plugins.js

@@ -4,20 +4,22 @@
  * Docusaurus and Nextra share the transforms and heading id promotion.
  * Default output uses native elements without a cudoc component provider.
  */
+import { visit } from "unist-util-visit";
 import cudocPrepare from "./prepare.js";
 import { resolveOptions } from "./options.js";
 import { promoteAnchorIds } from "./heading-ids.js";
+// `host` and `headingIds` are the adapter's to set, so neither is accepted.
 const KNOWN_KEYS = new Set([
     "syntax",
-    "host",
     "format",
     "calloutTypes",
     "components",
-    "headingIds",
     "tableCellList",
     "headingMetadata",
     "badge",
     "tableColumnLayout",
+    "tableColumnWidths",
+    "ignoreDiagnostics",
     "transforms",
     "promoteHeadingIds",
 ]);
@@ -31,7 +33,44 @@ const readAnchorNaming = (options) => {
         idAttribute: headingMetadata.anchor?.idAttribute,
     };
 };
-export const createHostPlugins = (options = {}, adapter) => {
+/**
+ * Whether Docusaurus's slugger leaves an id as it is: letters, digits,
+ * hyphens and underscores only. The slugger runs with the case kept for an id
+ * already on a heading, and removes or replaces everything else.
+ */
+const slugStable = (id) => /^[\p{L}\p{M}\p{N}_-]+$/u.test(id);
+/**
+ * Hands Docusaurus the heading ids cudoc settled that its slugger would change.
+ *
+ * Docusaurus runs an id already on a heading through its slugger again, which
+ * turns `v1.2` into `v12`, but takes a `{#id}` at the end of the heading text
+ * as written. Its table of contents reads the same id, so the heading, its
+ * anchor and the entry stay one value.
+ *
+ * Every other id stays on the heading for the slugger, which returns it
+ * unchanged and records it, so a later heading whose text slugs to the same
+ * value is numbered past it instead of taking it. The page's `#` heading keeps
+ * its id there too: Docusaurus reads the page title from that heading's text
+ * before it takes a `{#id}` out.
+ */
+const docusaurusHeadingIds = () => (tree) => {
+    visit(tree, "heading", (heading) => {
+        const properties = heading.data?.hProperties;
+        const id = properties?.id;
+        if (typeof id !== "string" || !id)
+            return;
+        if (heading.depth === 1 || slugStable(id))
+            return;
+        delete properties.id;
+        heading.children.push({ type: "text", value: ` {#${id}}` });
+    });
+};
+/**
+ * The remark plugins a Docusaurus or Nextra adapter hands its host, in order.
+ * `host` is the adapter's own, and decides what the host is given: Docusaurus
+ * receives a settled id its slugger would change as `{#id}` text.
+ */
+export const createHostPlugins = (options = {}, adapter, host) => {
     if (typeof options !== "object" || options === null) {
         throw new TypeError(`${adapter}: options must be an object`);
     }
@@ -40,10 +79,9 @@ export const createHostPlugins = (options = {}, adapter) => {
             throw new TypeError(`${adapter}: unknown option "${key}"`);
         }
     }
+    if (host !== "docusaurus" && host !== "nextra")
+        throw new TypeError(`${adapter}: host must be "docusaurus" or "nextra"`);
     const { promoteHeadingIds = true, ...remarkOptions } = options;
-    const host = adapter.includes("docusaurus")
-        ? "docusaurus"
-        : "nextra";
     const resolvedOptions = {
         ...remarkOptions,
         host,
@@ -59,6 +97,11 @@ export const createHostPlugins = (options = {}, adapter) => {
     if (promoteHeadingIds) {
         plugins.push([promoteAnchorIds, readAnchorNaming(remarkOptions)]);
     }
+    // Last, once every id cudoc assigns is on its heading. Bare rather than
+    // `[plugin]`: Docusaurus accepts a plugin or a `[plugin, options]` pair and
+    // refuses a one-element array when it validates its config.
+    if (host === "docusaurus")
+        plugins.push(docusaurusHeadingIds);
     return plugins;
 };
 //# sourceMappingURL=host-plugins.js.map

package/dist/host-plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"host-plugins.js","sourceRoot":"","sources":["../src/host-plugins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,YAAY,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,cAAc,EAA2B,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAYnD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS;IACjC,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,OAAO;IACP,mBAAmB;IACnB,YAAY;IACZ,mBAAmB;CACkB,CAAC,CAAA;AAExC,iFAAiF;AACjF,MAAM,gBAAgB,GAAG,CACvB,OAA2B,EACF,EAAE;IAC3B,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAA;IAC/C,IAAI,CAAC,eAAe,IAAI,eAAe,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAC3D,OAAO;QACL,UAAU,EAAE,eAAe,CAAC,MAAM,EAAE,IAAI;QACxC,WAAW,EAAE,eAAe,CAAC,MAAM,EAAE,WAAW;KACjD,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,UAA6B,EAAE,EAC/B,OAAe,EACA,EAAE;IACjB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CAAC,GAAG,OAAO,6BAA6B,CAAC,CAAA;IAC9D,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,GAAG,OAAO,qBAAqB,GAAG,GAAG,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAA;IAC9D,MAAM,IAAI,GAA4B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QAClE,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,QAAQ,CAAA;IACZ,MAAM,eAAe,GAAG;QACtB,GAAG,aAAa;QAChB,IAAI;QACJ,UAAU,EAAE,MAAe;QAC3B,GAAG,EAAE,KAAK;KACF,CAAA;IAEV,uEAAuE;IACvE,2EAA2E;IAC3E,mEAAmE;IACnE,cAAc,CAAC,eAAe,CAAC,CAAA;IAE/B,MAAM,OAAO,GAAkB,CAAC,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAA;IAEhE,oEAAoE;IACpE,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IACnE,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"host-plugins.js","sourceRoot":"","sources":["../src/host-plugins.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -12,5 +12,5 @@ export { promoteAnchorIds } from "./heading-ids.js";
 export type { PromoteAnchorIdsOptions } from "./heading-ids.js";
 export { createHostPlugins } from "./host-plugins.js";
 export type { HostPluginOptions } from "./host-plugins.js";
-export { createCompilerCapture } from "./capture.js";
+export { createCompilerCapture, type CompilerCaptureOptions, } from "./capture.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,YAAY,EACvB,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,2CAA2C,CAAA;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAA;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,YAAY,EACvB,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,2CAA2C,CAAA;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAA;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -6,5 +6,5 @@ export { transformTableCellList } from "./transforms/table-cell-list/index.js";
 export { createTableColumnLayoutTransform, resolveTableColumnLayoutOptions, } from "./transforms/table-column-layout/index.js";
 export { promoteAnchorIds } from "./heading-ids.js";
 export { createHostPlugins } from "./host-plugins.js";
-export { createCompilerCapture } from "./capture.js";
+export { createCompilerCapture, } from "./capture.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,YAAY,EACvB,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAO7C,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,2CAA2C,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,YAAY,EACvB,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAO7C,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,2CAA2C,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EACL,qBAAqB,GAEtB,MAAM,cAAc,CAAA"}