@cudoment/cudoc 0.4.0 → 0.6.0

package/dist/internal/transforms/table-column-layout/create-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-table.js","sourceRoot":"","sources":["../../../../src/internal/transforms/table-column-layout/create-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAO3D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,SAAS,EAA6B,MAAM,iBAAiB,CAAA;AAEtE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,IAAI;IACT,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;CACF,CAAA;AAaV,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,aAA8B,EAAE,EACP,EAAE;IAC3B,MAAM,QAAQ,GAAG,EAAE,GAAG,wBAAwB,EAAE,GAAG,UAAU,EAAE,CAAA;IAC/D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,MAAM,IAAI,SAAS,CAAC,cAAc,GAAG,6BAA6B,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,CACxB,IAAe,EACf,IAAY,EACZ,aAAgC,EAAE,EACf,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AAE7E,MAAM,iBAAiB,GAAG,CACxB,QAAiC,EACjC,IAAY,EACZ,aAAgC,EAAE,EACf,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,mBAAmB;IACzB,IAAI;IACJ,UAAU;IACV,QAAQ,EAAE,QAAyC;CACpD,CAAC,CAAA;AAEF,4EAA4E;AAC5E,+EAA+E;AAC/E,MAAM,mBAAmB,GAAG,CAC1B,KAAY,EACZ,KAAa,EACb,IAAY,EACO,EAAE;IACrB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;IACtC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IAC7D,OAAO;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,gCAAgC;gBACtC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;gBACpC,IAAI,EAAE;oBACJ,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS;wBACf,UAAU,EAAE,QAAQ;wBACpB,IAAI,EAAE;4BACJ;gCACE,IAAI,EAAE,qBAAqB;gCAC3B,UAAU,EAAE,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;6BACzC;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAChC,WAAW,EACX,UAAU,EACV,KAAK,EACL,aAAa,EACb,KAAK,GAON,EAAqB,EAAE;IACtB,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IACnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,KAA8B,CAAA;IACjD,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;QACtC,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;IACF,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAEvC,MAAM,cAAc,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC5D,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE;QACvC,GAAG,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;QACrD,GAAG,CAAC,KAAK,KAAK,WAAW,IAAI,YAAY;YACvC,CAAC,CAAC,CAAC,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAChD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CACH,CAAA;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;QAClE,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACxD,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAA;YACrE,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;gBAC1B,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAA;YACxE,CAAC;YAED,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO;oBACL,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE;wBAClD,GAAG,UAAU;wBACb,GAAG,CAAC,YAAY;4BACd,CAAC,CAAC,CAAC,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;4BAChD,CAAC,CAAC,EAAE,CAAC;qBACR,CAAC;iBACH,CAAA;YACH,CAAC;YAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC7B,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CACzD,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,oBAAoB,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1C,GAAG,cAAc,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,OAAO,oBAAoB,CAAC,UAAU,CAAC,KAAK,EAAE;QAC5C,oBAAoB,CAAC,UAAU,CAAC,MAAM,EAAE;YACtC,oBAAoB,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;SAC1E,CAAC;QACF,oBAAoB,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;KAChD,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"create-table.js","sourceRoot":"","sources":["../../../../src/internal/transforms/table-column-layout/create-table.ts"],"names":[],"mappings":"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"}

package/dist/internal/transforms/table-column-layout/index.d.ts

@@ -11,6 +11,32 @@ import { type DelimiterPair } from "../../core/index.js";
 import { type ResolvedTableComponents, type TableComponents } from "./create-table.js";
 import { resolveSplitOptions, type SplitOptions } from "./split-cell.js";
 export declare const DEFAULT_SPAN_ATTRIBUTE = "colSpan";
+/** A CSS length a header cell can carry: a number and a unit, nothing else. */
+export declare const CSS_LENGTH: RegExp;
+/**
+ * Minimum widths for columns, by header text.
+ *
+ * A header cell whose text is a key gets `min-width` in its `style`, which
+ * every renderer reads: the HTML output as a style attribute, a layout table
+ * as its head element's `style` prop, and the Word export as the column's
+ * floor. This replaces a `<div style={{ minWidth }}>` written into a header
+ * cell by hand.
+ */
+export type TableColumnWidthOptions = {
+    /** Limit the rule to tables under this heading. Every table when absent. */
+    section?: SectionSelector;
+    /** Header text, compared after collapsing spaces, to a CSS length. */
+    widths: Record<string, string>;
+    metadataDelimiters?: DelimiterPair[];
+    ignoreElements?: string[];
+};
+export type ResolvedTableColumnWidthOptions = {
+    section?: SectionSelector;
+    widths: Record<string, string>;
+    metadataDelimiters: DelimiterPair[];
+    ignoreElements: string[];
+};
+export declare const resolveTableColumnWidthOptions: (options: TableColumnWidthOptions, optionPath?: string) => ResolvedTableColumnWidthOptions;
 export type TableColumnLayoutOptions = {
     /** The heading that introduces the table this rule applies to. */
     section: SectionSelector;
@@ -38,6 +64,12 @@ export type ResolvedTableColumnLayoutOptions = {
     ignoreElements: string[];
 };
 export declare const resolveTableColumnLayoutOptions: (options: TableColumnLayoutOptions, optionPath?: string) => ResolvedTableColumnLayoutOptions;
+/**
+ * Writes `min-width` onto matching header cells of a Markdown table. It runs
+ * before any layout rule, which carries the style into the head element it
+ * builds, so the width survives whichever shape the table ends up in.
+ */
+export declare const createTableColumnWidthTransform: (options: ResolvedTableColumnWidthOptions) => ({ ancestors, index, node, parent }: TransformContext) => void;
 /**
  * Runs as a post transform: the cells it reads must already be normalized by
  * the transforms that run on the way down, and any transform that needs to see

package/dist/internal/transforms/table-column-layout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/transforms/table-column-layout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC5E,OAAO,EAUL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAExE,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAE/C,MAAM,MAAM,wBAAwB,GAAG;IACrC,kEAAkE;IAClE,OAAO,EAAE,eAAe,CAAA;IACxB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAA;IACpC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,OAAO,EAAE,eAAe,CAAA;IACxB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;IAC7C,UAAU,EAAE,uBAAuB,CAAA;IACnC,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,aAAa,EAAE,CAAA;IACnC,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,eAAO,MAAM,+BAA+B,GAC1C,SAAS,wBAAwB,EACjC,mBAAgC,KAC/B,gCA8BF,CAAA;AAkED;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAC1C,SAAS,gCAAgC,MACzC,oCAAoC,gBAAgB,KAAG,IAyBvD,CAAA;AAEH,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/transforms/table-column-layout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC5E,OAAO,EAUL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAExE,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAE/C,+EAA+E;AAC/E,eAAO,MAAM,UAAU,QAAsC,CAAA;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAA;IACpC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,kBAAkB,EAAE,aAAa,EAAE,CAAA;IACnC,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,eAAO,MAAM,8BAA8B,GACzC,SAAS,uBAAuB,EAChC,mBAAgC,KAC/B,+BAuCF,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,kEAAkE;IAClE,OAAO,EAAE,eAAe,CAAA;IACxB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAA;IACpC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,OAAO,EAAE,eAAe,CAAA;IACxB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;IAC7C,UAAU,EAAE,uBAAuB,CAAA;IACnC,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,aAAa,EAAE,CAAA;IACnC,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,eAAO,MAAM,+BAA+B,GAC1C,SAAS,wBAAwB,EACjC,mBAAgC,KAC/B,gCA8BF,CAAA;AAiFD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GACzC,SAAS,+BAA+B,MACxC,oCAAoC,gBAAgB,KAAG,IA0BvD,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAC1C,SAAS,gCAAgC,MACzC,oCAAoC,gBAAgB,KAAG,IAyBvD,CAAA;AAEH,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/internal/transforms/table-column-layout/index.js

@@ -10,6 +10,37 @@ import { assertSectionSelector, findPreviousHeading, getInlineText, isMdxTextEle
 import { createLayoutTable, resolveTableComponents, } from "./create-table.js";
 import { resolveSplitOptions } from "./split-cell.js";
 export const DEFAULT_SPAN_ATTRIBUTE = "colSpan";
+/** A CSS length a header cell can carry: a number and a unit, nothing else. */
+export const CSS_LENGTH = /^\d+(?:\.\d+)?(?:px|rem|em|ch|%)$/;
+export const resolveTableColumnWidthOptions = (options, optionPath = "tableColumnWidths") => {
+    if (!options || typeof options !== "object")
+        throw new TypeError(`${optionPath} must be an object`);
+    const { widths } = options;
+    if (!widths ||
+        typeof widths !== "object" ||
+        Array.isArray(widths) ||
+        !Object.keys(widths).length)
+        throw new TypeError(`${optionPath}.widths must map header text to CSS lengths`);
+    for (const [header, width] of Object.entries(widths))
+        if (!header.trim() || typeof width !== "string" || !CSS_LENGTH.test(width))
+            throw new TypeError(`${optionPath}.widths[${JSON.stringify(header)}] must be a CSS length such as 120px or 8rem`);
+    return {
+        ...(options.section
+            ? {
+                section: assertSectionSelector(options.section, `${optionPath}.section`),
+            }
+            : {}),
+        widths: Object.fromEntries(Object.entries(widths).map(([header, width]) => [
+            normalizeHeaderText(header),
+            width,
+        ])),
+        metadataDelimiters: options.metadataDelimiters ?? [
+            DEFAULT_BADGE_DELIMITERS,
+            DEFAULT_ID_DELIMITERS,
+        ],
+        ignoreElements: options.ignoreElements ?? ["Badge"],
+    };
+};
 export const resolveTableColumnLayoutOptions = (options, optionPath = "tableColumnLayout") => {
     if (!options || typeof options !== "object") {
         throw new TypeError(`${optionPath} must be an object`);
@@ -69,6 +100,41 @@ const readHeadingText = (heading, options) => stripDelimited(getInlineText(
 // way `visibleHeadingText` drops them.
 heading.children.filter((node) => !["badge", "permalink"].includes(node.data?.cudoc
     ?.kind ?? ""))), options.metadataDelimiters);
+/** One declaration merged into a cell's existing `style` string. */
+const withDeclaration = (style, declaration) => [
+    ...(typeof style === "string" && style.trim()
+        ? style
+            .split(";")
+            .map((rule) => rule.trim())
+            .filter(Boolean)
+        : []),
+    declaration,
+].join("; ");
+/**
+ * Writes `min-width` onto matching header cells of a Markdown table. It runs
+ * before any layout rule, which carries the style into the head element it
+ * builds, so the width survives whichever shape the table ends up in.
+ */
+export const createTableColumnWidthTransform = (options) => ({ ancestors, index, node, parent }) => {
+    if (node.type !== "table" || !parent || typeof index !== "number")
+        return;
+    if (options.section) {
+        const previousHeading = findPreviousHeading(parent, index, ancestors);
+        if (!previousHeading ||
+            !matchesSectionHeading(previousHeading, options.section, (heading) => readHeadingText(heading, options)))
+            return;
+    }
+    const table = node;
+    for (const cell of table.children[0]?.children ?? []) {
+        const width = options.widths[readHeaderText(cell, options)];
+        if (!width)
+            continue;
+        const data = (cell.data ?? {});
+        const properties = { ...(data.hProperties ?? {}) };
+        properties.style = withDeclaration(properties.style, `min-width: ${width}`);
+        cell.data = { ...data, hProperties: properties };
+    }
+};
 /**
  * Runs as a post transform: the cells it reads must already be normalized by
  * the transforms that run on the way down, and any transform that needs to see

package/dist/internal/transforms/table-column-layout/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/transforms/table-column-layout/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/transforms/table-column-layout/index.ts"],"names":[],"mappings":"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"}

package/dist/markdown.d.ts

@@ -1,9 +1,17 @@
 import type { Root } from "mdast";
 import { normalizeDocument, type DocumentOptions } from "./document.js";
+import { importedNames, importedNamesFromSource } from "./internal/core/mdx/imports.js";
+export { importedNames, importedNamesFromSource };
 export type CompiledDocument = {
     tree: Root;
     frontmatter: Record<string, unknown>;
     diagnostics: ReturnType<typeof normalizeDocument>;
+    /**
+     * Local names the document's own `import` statements bind. The export drops
+     * the statements, and the checker needs to know which components an
+     * embedded copy of a section would leave behind.
+     */
+    imports?: string[];
 };
 /** Standalone Markdown/MDX compiler. Host adapters supply their actual compiler instead. */
 export declare function compileDocument(source: string, options?: DocumentOptions): CompiledDocument;

package/dist/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAQjC,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EAErB,MAAM,eAAe,CAAA;AAEtB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,WAAW,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;CAClD,CAAA;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,gBAAgB,CAwClB"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAQjC,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EAErB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,aAAa,EACb,uBAAuB,EACxB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAA;AAEjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,WAAW,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;IACjD;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,gBAAgB,CA8ClB"}

package/dist/markdown.js

@@ -6,6 +6,8 @@ import remarkFrontmatter from "remark-frontmatter";
 import { compileSync } from "@mdx-js/mdx";
 import { parse as parseYaml } from "yaml";
 import { normalizeDocument, } from "./document.js";
+import { importedNames, importedNamesFromSource, } from "./internal/core/mdx/imports.js";
+export { importedNames, importedNamesFromSource };
 /** Standalone Markdown/MDX compiler. Host adapters supply their actual compiler instead. */
 export function compileDocument(source, options = {}) {
     let tree;
@@ -40,8 +42,14 @@ export function compileDocument(source, options = {}) {
     if (frontmatter !== null &&
         (typeof frontmatter !== "object" || Array.isArray(frontmatter)))
         throw new Error("cudoc: frontmatter must be a mapping");
+    const imports = importedNames(tree);
     tree.children = tree.children.filter((n) => !["yaml", "mdxjsEsm"].includes(n.type));
     const diagnostics = normalizeDocument(tree, source, options);
-    return { tree, frontmatter: frontmatter ?? {}, diagnostics };
+    return {
+        tree,
+        frontmatter: frontmatter ?? {},
+        diagnostics,
+        ...(imports.length ? { imports } : {}),
+    };
 }
 //# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,WAAW,MAAM,cAAc,CAAA;AACtC,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,eAAe,MAAM,kBAAkB,CAAA;AAC9C,OAAO,iBAAiB,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AACzC,OAAO,EACL,iBAAiB,GAGlB,MAAM,eAAe,CAAA;AAQtB,4FAA4F;AAC5F,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,UAA2B,EAAE;IAE7B,IAAI,IAAU,CAAA;IACd,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,IAAI,QAA0B,CAAA;QAC9B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,KAAW,EAAE,EAAE;YACpC,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;QACnC,CAAC,CAAA;QACD,WAAW,CAAC,MAAM,EAAE;YAClB,aAAa,EAAE;gBACb,SAAS;gBACT,iBAAiB;gBACjB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO;aACR;SACF,CAAC,CAAA;QACF,IAAI,GAAG,QAAS,CAAA;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,OAAO,EAAE;aACxB,GAAG,CAAC,WAAW,CAAC;aAChB,GAAG,CAAC,SAAS,CAAC;aACd,GAAG,CAAC,iBAAiB,CAAC,CAAA;QACzB,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY;YAAE,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QACjE,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAS,CAAA;IAC3D,CAAC;IACD,MAAM,eAAe,GAAI,IAAI,CAAC,QAAsC,CAAC,IAAI,CACvE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CACzB,CAAA;IACD,MAAM,WAAW,GAAG,eAAe;QACjC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,KAAM,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;QAC3D,CAAC,CAAC,EAAE,CAAA;IACN,IACE,WAAW,KAAK,IAAI;QACpB,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE/D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,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;IACD,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,IAAI,EAAE,EAAE,WAAW,EAAE,CAAA;AAC9D,CAAC"}
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"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"}

package/dist/node/check.d.ts

@@ -13,7 +13,8 @@ import type { Root } from "mdast";
 import type { Position } from "unist";
 import type { Library } from "./library.js";
 import { type LocalTargetRoots } from "./local-target.js";
-export type ReferenceIssueCode = "missing-document" | "missing-anchor" | "missing-asset" | "duplicate-anchor" | "empty-anchor" | "unstable-anchor-link" | "missing-embed-source" | "missing-embed-anchor" | "invalid-embed-spec" | "unmatched-embed-replacement" | "unportable-embed-component";
+import { type SourceRoot } from "./roots.js";
+export type ReferenceIssueCode = "missing-document" | "missing-anchor" | "missing-asset" | "duplicate-anchor" | "empty-anchor" | "unstable-anchor-link" | "missing-embed-source" | "missing-embed-anchor" | "invalid-embed-spec" | "unmatched-embed-replacement" | "unreplaceable-embed-section" | "empty-embed-cell" | "unportable-embed-component" | "imported-embed-component" | "cyclic-embed";
 export type ReferenceIssue = {
     code: ReferenceIssueCode;
     severity: "error" | "warning";
@@ -25,8 +26,10 @@ export type ReferenceIssue = {
     reference: string;
     position?: Position;
     /**
-     * The anchors the target document actually has. Filled in for
-     * `missing-anchor` so the author can see the real names instead of a guess.
+     * The anchors the target document actually has, or for
+     * `missing-embed-anchor` its headings' ids, which are what a section can be
+     * embedded from. Filled in so the author can see the real names instead of
+     * a guess.
      */
     available?: string[];
 };
@@ -35,9 +38,11 @@ export type CheckResult = {
     documentCount: number;
     checkedReferences: number;
 };
-export type CheckOptions = Omit<LocalTargetRoots, "sourceRoot"> & {
-    /** Defaults to the library's own `sourceRoot`. */
+export type CheckOptions = Omit<LocalTargetRoots, "roots"> & {
+    /** One root at the top of the library; the shorthand for `roots: [{ dir }]`. */
     sourceRoot?: string;
+    /** Where the documents live on disk. Defaults to the library's own roots. */
+    roots?: SourceRoot[];
     /** Codes to leave out of the result entirely. */
     ignore?: ReferenceIssueCode[];
 };
@@ -50,7 +55,8 @@ type Anchor = {
  *
  * Both halves matter. The ids answer whether a link resolves; the origin
  * answers whether it will keep resolving, because a generated id depends on how
- * many same-named headings precede it.
+ * many same-named headings precede it. Besides headings, an id an element in
+ * raw HTML declares is an anchor too, and one the author wrote.
  */
 export declare function collectAnchors(tree: Root): Anchor[];
 export declare function checkReferences(library: Library, options?: CheckOptions): CheckResult;

package/dist/node/check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/node/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErC,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,cAAc,CAAA;AAI3D,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAE7E,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,oBAAoB,GACpB,6BAA6B,GAC7B,4BAA4B,CAAA;AAEhC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,kBAAkB,CAAA;IACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG;IAChE,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAC9B,CAAA;AAKD,KAAK,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAA;AAO/C;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CASnD;AAmJD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAiB,GACzB,WAAW,CAgSb"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/node/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAQ,IAAI,EAAE,MAAM,OAAO,CAAA;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAQrC,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,cAAc,CAAA;AAgB3D,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAG1D,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,oBAAoB,GACpB,6BAA6B,GAC7B,6BAA6B,GAC7B,kBAAkB,GAClB,4BAA4B,GAC5B,0BAA0B,GAC1B,cAAc,CAAA;AAElB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,kBAAkB,CAAA;IACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG;IAC3D,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,iDAAiD;IACjD,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAC9B,CAAA;AAKD,KAAK,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAA;AAO/C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAanD;AA0SD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAiB,GACzB,WAAW,CAsiBb"}