@cudoment/cudoc 0.1.0

package/dist/internal/core/selectors.js

@@ -0,0 +1,87 @@
+/**
+ * Declarative selectors.
+ *
+ * A caller cannot pass a predicate function through a bundler config, so the
+ * conditions a transform needs are described as plain data and evaluated here.
+ */
+/** Concatenates the text of a phrasing subtree, ignoring node kinds. */
+export const getInlineText = (nodes) => nodes.map((node) => getInlineTextFromNode(node)).join("");
+const getInlineTextFromNode = (node) => {
+    if (node.type === "text")
+        return node.value;
+    if ("value" in node && typeof node.value === "string")
+        return node.value;
+    if ("children" in node && Array.isArray(node.children)) {
+        return getInlineText(node.children);
+    }
+    return "";
+};
+/** Collapses runs of whitespace and lowercases, for tolerant comparison. */
+export const normalizeTitle = (value) => value.replace(/\s+/g, " ").trim().toLowerCase();
+/** Drops every space, so a title written with or without one still matches. */
+export const compactTitle = (value) => normalizeTitle(value).replace(/\s/g, "");
+/** Collapses whitespace but keeps case, for exact header matching. */
+export const normalizeHeaderText = (value) => value.replace(/\s+/g, " ").trim();
+export const assertSectionSelector = (value, optionPath) => {
+    if (!value || typeof value !== "object") {
+        throw new TypeError(`${optionPath} must be an object`);
+    }
+    const { depth, titles } = value;
+    if (!Array.isArray(titles) ||
+        titles.length === 0 ||
+        !titles.every((title) => typeof title === "string" && title.trim())) {
+        throw new TypeError(`${optionPath}.titles must be a non-empty string array`);
+    }
+    if (depth !== undefined) {
+        const depths = Array.isArray(depth) ? depth : [depth];
+        if (!depths.every((one) => Number.isInteger(one) && one >= 1 && one <= 6)) {
+            throw new TypeError(`${optionPath}.depth must be 1-6, or an array of them`);
+        }
+    }
+    return value;
+};
+/**
+ * Tests a heading against a selector.
+ *
+ * Both a whitespace-normalized and a space-free comparison are accepted, so an
+ * author writing the title with or without an internal space still matches.
+ */
+export const matchesSectionHeading = (heading, selector, 
+/** Text extractor, so a caller can strip generated nodes first. */
+readText = (node) => getInlineText(node.children)) => {
+    if (selector.depth !== undefined) {
+        const depths = Array.isArray(selector.depth)
+            ? selector.depth
+            : [selector.depth];
+        if (!depths.includes(heading.depth))
+            return false;
+    }
+    const text = normalizeTitle(readText(heading));
+    const compact = compactTitle(text);
+    return selector.titles.some((title) => normalizeTitle(title) === text || compactTitle(title) === compact);
+};
+/**
+ * Finds the heading that introduces the node at `index`.
+ *
+ * The search continues through ancestors, because a table may sit inside a
+ * container whose own siblings hold the heading.
+ */
+export const findPreviousHeading = (parent, index, ancestors = []) => {
+    for (let i = index - 1; i >= 0; i -= 1) {
+        const candidate = parent.children[i];
+        if (candidate?.type === "heading")
+            return candidate;
+    }
+    for (let i = ancestors.length - 1; i >= 0; i -= 1) {
+        const ancestor = ancestors[i];
+        if (!ancestor)
+            continue;
+        for (let siblingIndex = ancestor.index - 1; siblingIndex >= 0; siblingIndex -= 1) {
+            const candidate = ancestor.parent.children[siblingIndex];
+            if (candidate?.type === "heading")
+                return candidate;
+        }
+    }
+    return undefined;
+};
+//# sourceMappingURL=selectors.js.map

package/dist/internal/core/selectors.js.map

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

package/dist/internal/core/syntax/delimiters.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Delimiter-based syntax patterns.
+ *
+ * Options that reach a plugin through a bundler config must survive JSON
+ * serialization, so callers describe inline syntax with a delimiter pair such
+ * as `["(#", ")"]` instead of passing a `RegExp`. Patterns are built here.
+ *
+ * Delimiters are matched after the document is parsed, so they must be inert to
+ * the parser itself. In MDX that rules out `{` and `}`, which start a
+ * JavaScript expression, and `<`, which starts an element.
+ */
+/** An opening and a closing marker, in that order. */
+export type DelimiterPair = readonly [open: string, close: string];
+export declare const assertDelimiterPair: (value: unknown, optionPath: string) => DelimiterPair;
+/**
+ * Builds the pattern that matches `open`, a lazily captured body, then `close`.
+ * The body is lazy so the first closing marker ends the match, which is how a
+ * negated character class behaves for a single-character closing delimiter.
+ */
+export declare const createDelimiterPattern: ([open, close]: DelimiterPair, flags?: string) => RegExp;
+export declare const createGlobalDelimiterPattern: (pair: DelimiterPair) => RegExp;
+export type DelimitedPart = {
+    type: "text";
+    value: string;
+} | {
+    type: "delimited";
+    value: string;
+};
+/**
+ * Splits `value` into plain text and delimited segments.
+ *
+ * A segment whose body is blank is left in place as text: an author writing
+ * `(@)` means the literal characters, not an empty badge.
+ */
+export declare const splitByDelimiters: (value: string, pair: DelimiterPair) => DelimitedPart[];
+/** Reads the first non-blank delimited body, or `undefined` when there is none. */
+export declare const extractDelimitedValue: (value: string, pair: DelimiterPair) => string | undefined;
+export declare const hasDelimitedValue: (value: string, pair: DelimiterPair) => boolean;
+/**
+ * Removes every non-blank delimited segment for each pair. Blank bodies are
+ * kept, matching {@link splitByDelimiters}.
+ */
+export declare const stripDelimited: (value: string, pairs: readonly DelimiterPair[]) => string;
+export declare const stripDelimitedAndTrimEnd: (value: string, pairs: readonly DelimiterPair[]) => string;
+//# sourceMappingURL=delimiters.d.ts.map

package/dist/internal/core/syntax/delimiters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimiters.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/syntax/delimiters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AAOlE,eAAO,MAAM,mBAAmB,GAC9B,OAAO,OAAO,EACd,YAAY,MAAM,KACjB,aAiBF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,eAAe,aAAa,EAC5B,cAAU,KACT,MAC2E,CAAA;AAE9E,eAAO,MAAM,4BAA4B,GAAI,MAAM,aAAa,KAAG,MAChC,CAAA;AAEnC,MAAM,MAAM,aAAa,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,EACb,MAAM,aAAa,KAClB,aAAa,EA6Bf,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,MAAM,aAAa,KAClB,MAAM,GAAG,SAIX,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,EACb,MAAM,aAAa,KAClB,OAAmD,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,OAAO,SAAS,aAAa,EAAE,KAC9B,MAQA,CAAA;AAEH,eAAO,MAAM,wBAAwB,GACnC,OAAO,MAAM,EACb,OAAO,SAAS,aAAa,EAAE,KAC9B,MAAgD,CAAA"}

package/dist/internal/core/syntax/delimiters.js

@@ -0,0 +1,81 @@
+/**
+ * Delimiter-based syntax patterns.
+ *
+ * Options that reach a plugin through a bundler config must survive JSON
+ * serialization, so callers describe inline syntax with a delimiter pair such
+ * as `["(#", ")"]` instead of passing a `RegExp`. Patterns are built here.
+ *
+ * Delimiters are matched after the document is parsed, so they must be inert to
+ * the parser itself. In MDX that rules out `{` and `}`, which start a
+ * JavaScript expression, and `<`, which starts an element.
+ */
+const REGEXP_SPECIAL_CHARACTERS = /[.*+?^${}()|[\]\\]/g;
+const escapeRegExp = (value) => value.replace(REGEXP_SPECIAL_CHARACTERS, "\\$&");
+export const assertDelimiterPair = (value, optionPath) => {
+    if (!Array.isArray(value) ||
+        value.length !== 2 ||
+        typeof value[0] !== "string" ||
+        typeof value[1] !== "string") {
+        throw new TypeError(`${optionPath} must be a pair of strings, for example ["(#", ")"]`);
+    }
+    if (!value[0] || !value[1]) {
+        throw new TypeError(`${optionPath} must not contain an empty delimiter`);
+    }
+    return [value[0], value[1]];
+};
+/**
+ * Builds the pattern that matches `open`, a lazily captured body, then `close`.
+ * The body is lazy so the first closing marker ends the match, which is how a
+ * negated character class behaves for a single-character closing delimiter.
+ */
+export const createDelimiterPattern = ([open, close], flags = "") => new RegExp(`${escapeRegExp(open)}([\\s\\S]*?)${escapeRegExp(close)}`, flags);
+export const createGlobalDelimiterPattern = (pair) => createDelimiterPattern(pair, "g");
+/**
+ * Splits `value` into plain text and delimited segments.
+ *
+ * A segment whose body is blank is left in place as text: an author writing
+ * `(@)` means the literal characters, not an empty badge.
+ */
+export const splitByDelimiters = (value, pair) => {
+    const matches = [...value.matchAll(createGlobalDelimiterPattern(pair))];
+    if (matches.length === 0)
+        return [{ type: "text", value }];
+    const parts = [];
+    let lastIndex = 0;
+    for (const match of matches) {
+        const matchIndex = match.index;
+        if (typeof matchIndex !== "number")
+            continue;
+        const fullMatch = match[0];
+        const body = (match[1] ?? "").trim();
+        if (!body)
+            continue;
+        if (matchIndex > lastIndex) {
+            const beforeText = value.substring(lastIndex, matchIndex);
+            if (beforeText)
+                parts.push({ type: "text", value: beforeText });
+        }
+        parts.push({ type: "delimited", value: body });
+        lastIndex = matchIndex + fullMatch.length;
+    }
+    if (lastIndex < value.length) {
+        const afterText = value.substring(lastIndex);
+        if (afterText)
+            parts.push({ type: "text", value: afterText });
+    }
+    return parts;
+};
+/** Reads the first non-blank delimited body, or `undefined` when there is none. */
+export const extractDelimitedValue = (value, pair) => {
+    const match = value.match(createDelimiterPattern(pair));
+    const body = match?.[1]?.trim();
+    return body || undefined;
+};
+export const hasDelimitedValue = (value, pair) => createDelimiterPattern(pair).test(value);
+/**
+ * Removes every non-blank delimited segment for each pair. Blank bodies are
+ * kept, matching {@link splitByDelimiters}.
+ */
+export const stripDelimited = (value, pairs) => pairs.reduce((current, pair) => current.replace(createGlobalDelimiterPattern(pair), (match, body) => (body.trim() ? "" : match)), value);
+export const stripDelimitedAndTrimEnd = (value, pairs) => stripDelimited(value, pairs).trimEnd();
+//# sourceMappingURL=delimiters.js.map

package/dist/internal/core/syntax/delimiters.js.map

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

package/dist/internal/core/syntax/heading-metadata.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Heading metadata syntax: an explicit anchor id and an optional badge written
+ * inline in the heading text.
+ *
+ * The same parsing runs during compilation and during reference checking, so a
+ * checker never disagrees with the rendered anchor.
+ */
+import type { Heading, PhrasingContent, Root } from "mdast";
+import type { MdxJsxTextElement } from "mdast-util-mdx-jsx";
+import { type DelimiterPair } from "./delimiters.js";
+export declare const DEFAULT_HEADING_DEPTHS: readonly [2, 3, 4, 5];
+export declare const DEFAULT_ID_DELIMITERS: DelimiterPair;
+export declare const DEFAULT_BADGE_DELIMITERS: DelimiterPair;
+export declare const DEFAULT_ANCHOR_NAME = "Anchor";
+export type AnchorOptions = {
+    /** Element name emitted for the anchor. */
+    name?: string;
+    /** Attribute carrying the id. */
+    idAttribute?: string;
+    /** Attribute carrying the heading level, or `false` to omit it. */
+    levelAttribute?: string | false;
+    /** Prefix placed before the depth, so depth 2 becomes `h2` by default. */
+    levelPrefix?: string;
+    /** Attribute carrying the badge text. */
+    badgeAttribute?: string;
+};
+export type HeadingMetadataOptions = {
+    /** Heading depths that may carry metadata. */
+    depths?: number[];
+    idDelimiters?: DelimiterPair;
+    badgeDelimiters?: DelimiterPair;
+    anchor?: AnchorOptions;
+};
+export type ResolvedHeadingMetadataOptions = {
+    depths: number[];
+    idDelimiters: DelimiterPair;
+    badgeDelimiters: DelimiterPair;
+    anchor: {
+        name: string;
+        idAttribute: string;
+        levelAttribute: string | false;
+        levelPrefix: string;
+        badgeAttribute: string;
+    };
+};
+export declare const resolveHeadingMetadataOptions: (options?: HeadingMetadataOptions) => ResolvedHeadingMetadataOptions;
+/**
+ * Moves the metadata written in a heading's text into an anchor element.
+ *
+ * When several text nodes carry metadata the last id and the last badge win,
+ * and only the text node that holds the final match has its trailing space
+ * trimmed, so the visible heading text keeps its internal spacing.
+ */
+export declare const transformHeadingAnchor: (node: Heading, options: ResolvedHeadingMetadataOptions) => void;
+/** Applies {@link transformHeadingAnchor} to every heading in a tree. */
+export declare const transformHeadingAnchors: (tree: Root, options: ResolvedHeadingMetadataOptions) => void;
+export declare const findAnchorNode: (nodes: PhrasingContent[], anchorName?: string) => MdxJsxTextElement | undefined;
+export declare const extractAnchorId: (anchor: MdxJsxTextElement | undefined, idAttribute?: string) => string | undefined;
+//# sourceMappingURL=heading-metadata.d.ts.map

package/dist/internal/core/syntax/heading-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-metadata.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/syntax/heading-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAQ,MAAM,OAAO,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAA;AAGxB,eAAO,MAAM,sBAAsB,uBAAwB,CAAA;AAC3D,eAAO,MAAM,qBAAqB,EAAE,aAA2B,CAAA;AAC/D,eAAO,MAAM,wBAAwB,EAAE,aAA2B,CAAA;AAClE,eAAO,MAAM,mBAAmB,WAAW,CAAA;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC/B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,CAAC,EAAE,aAAa,CAAA;IAC5B,eAAe,CAAC,EAAE,aAAa,CAAA;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,YAAY,EAAE,aAAa,CAAA;IAC3B,eAAe,EAAE,aAAa,CAAA;IAC9B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,cAAc,EAAE,MAAM,GAAG,KAAK,CAAA;QAC9B,WAAW,EAAE,MAAM,CAAA;QACnB,cAAc,EAAE,MAAM,CAAA;KACvB,CAAA;CACF,CAAA;AAaD,eAAO,MAAM,6BAA6B,GACxC,UAAS,sBAA2B,KACnC,8BAqCF,CAAA;AAgFD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,OAAO,EACb,SAAS,8BAA8B,KACtC,IA+DF,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,GAClC,MAAM,IAAI,EACV,SAAS,8BAA8B,KACtC,IAIF,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,OAAO,eAAe,EAAE,EACxB,aAAY,MAA4B,KACvC,iBAAiB,GAAG,SAOtB,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,QAAQ,iBAAiB,GAAG,SAAS,EACrC,oBAAkB,KACjB,MAAM,GAAG,SAAqD,CAAA"}

package/dist/internal/core/syntax/heading-metadata.js

@@ -0,0 +1,178 @@
+/**
+ * Heading metadata syntax: an explicit anchor id and an optional badge written
+ * inline in the heading text.
+ *
+ * The same parsing runs during compilation and during reference checking, so a
+ * checker never disagrees with the rendered anchor.
+ */
+import { visit } from "unist-util-visit";
+import { assertDelimiterPair, hasDelimitedValue, extractDelimitedValue, stripDelimited, stripDelimitedAndTrimEnd, } from "./delimiters.js";
+import { readStringAttribute, setStringAttribute } from "../mdx/jsx.js";
+export const DEFAULT_HEADING_DEPTHS = [2, 3, 4, 5];
+export const DEFAULT_ID_DELIMITERS = ["(#", ")"];
+export const DEFAULT_BADGE_DELIMITERS = ["(@", ")"];
+export const DEFAULT_ANCHOR_NAME = "Anchor";
+const assertDepths = (value, optionPath) => {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        !value.every((depth) => Number.isInteger(depth) && depth >= 1 && depth <= 6)) {
+        throw new TypeError(`${optionPath} must be a non-empty array of 1-6`);
+    }
+    return [...value];
+};
+export const resolveHeadingMetadataOptions = (options = {}) => {
+    const anchor = options.anchor ?? {};
+    const levelAttribute = anchor.levelAttribute === false
+        ? false
+        : (anchor.levelAttribute ?? "headerLevel");
+    if (levelAttribute !== false && typeof levelAttribute !== "string") {
+        throw new TypeError("headingMetadata.anchor.levelAttribute must be a string or false");
+    }
+    return {
+        depths: options.depths
+            ? assertDepths(options.depths, "headingMetadata.depths")
+            : [...DEFAULT_HEADING_DEPTHS],
+        idDelimiters: options.idDelimiters
+            ? assertDelimiterPair(options.idDelimiters, "headingMetadata.idDelimiters")
+            : DEFAULT_ID_DELIMITERS,
+        badgeDelimiters: options.badgeDelimiters
+            ? assertDelimiterPair(options.badgeDelimiters, "headingMetadata.badgeDelimiters")
+            : DEFAULT_BADGE_DELIMITERS,
+        anchor: {
+            name: anchor.name ?? DEFAULT_ANCHOR_NAME,
+            idAttribute: anchor.idAttribute ?? "id",
+            levelAttribute,
+            levelPrefix: anchor.levelPrefix ?? "h",
+            badgeAttribute: anchor.badgeAttribute ?? "badge",
+        },
+    };
+};
+const isMetadataContainer = (node) => ["strong", "emphasis", "delete"].includes(node.type) &&
+    "children" in node &&
+    Array.isArray(node.children);
+const collectMetadataTextNodes = (nodes) => {
+    const textNodes = [];
+    for (const node of nodes) {
+        if (node.type === "text") {
+            textNodes.push(node);
+        }
+        else if (isMetadataContainer(node)) {
+            textNodes.push(...collectMetadataTextNodes(node.children));
+        }
+    }
+    return textNodes;
+};
+const pruneEmptyMetadataNodes = (nodes) => {
+    const nextNodes = [];
+    for (const node of nodes) {
+        if (node.type === "text") {
+            if (node.value)
+                nextNodes.push(node);
+            continue;
+        }
+        if (!isMetadataContainer(node)) {
+            nextNodes.push(node);
+            continue;
+        }
+        node.children = pruneEmptyMetadataNodes(node.children);
+        if (node.children.length > 0)
+            nextNodes.push(node);
+    }
+    return nextNodes;
+};
+const createAnchorNode = ({ badge, depth, existingAnchor, id, options, }) => {
+    const { anchor } = options;
+    const attributes = existingAnchor
+        ? structuredClone(existingAnchor.attributes)
+        : [];
+    if (id) {
+        setStringAttribute(attributes, anchor.idAttribute, id);
+        if (anchor.levelAttribute !== false) {
+            setStringAttribute(attributes, anchor.levelAttribute, `${anchor.levelPrefix}${depth}`);
+        }
+    }
+    if (badge)
+        setStringAttribute(attributes, anchor.badgeAttribute, badge);
+    return {
+        ...(existingAnchor ? structuredClone(existingAnchor) : {}),
+        type: "mdxJsxTextElement",
+        name: anchor.name,
+        attributes,
+        children: existingAnchor ? structuredClone(existingAnchor.children) : [],
+    };
+};
+/**
+ * Moves the metadata written in a heading's text into an anchor element.
+ *
+ * When several text nodes carry metadata the last id and the last badge win,
+ * and only the text node that holds the final match has its trailing space
+ * trimmed, so the visible heading text keeps its internal spacing.
+ */
+export const transformHeadingAnchor = (node, options) => {
+    if (!options.depths.includes(node.depth))
+        return;
+    const pairs = [options.badgeDelimiters, options.idDelimiters];
+    const textNodes = collectMetadataTextNodes(node.children);
+    const candidates = textNodes.flatMap((textNode) => {
+        const badge = extractDelimitedValue(textNode.value, options.badgeDelimiters);
+        const id = extractDelimitedValue(textNode.value, options.idDelimiters);
+        return badge || id ? [{ textNode, badge, id }] : [];
+    });
+    const target = candidates[candidates.length - 1];
+    if (!target)
+        return;
+    const badge = [...candidates]
+        .reverse()
+        .find((candidate) => candidate.badge)?.badge;
+    const id = [...candidates].reverse().find((candidate) => candidate.id)?.id;
+    for (const textNode of textNodes) {
+        if (!hasDelimitedValue(textNode.value, options.badgeDelimiters) &&
+            !hasDelimitedValue(textNode.value, options.idDelimiters)) {
+            continue;
+        }
+        const nextText = textNode === target.textNode
+            ? stripDelimitedAndTrimEnd(textNode.value, pairs)
+            : stripDelimited(textNode.value, pairs);
+        textNode.value = nextText.trim() ? nextText : "";
+    }
+    node.children = pruneEmptyMetadataNodes(node.children);
+    const anchorIdx = node.children.findIndex((child) => child.type === "mdxJsxTextElement" &&
+        "name" in child &&
+        child.name === options.anchor.name);
+    const existingAnchor = anchorIdx === -1
+        ? undefined
+        : node.children[anchorIdx];
+    const anchorNode = createAnchorNode({
+        badge,
+        depth: node.depth,
+        existingAnchor,
+        id,
+        options,
+    });
+    const textIdx = node.children.indexOf(target.textNode);
+    if (anchorIdx !== -1) {
+        node.children[anchorIdx] = anchorNode;
+    }
+    else if (textIdx !== -1) {
+        node.children.splice(textIdx + 1, 0, anchorNode);
+    }
+    else {
+        node.children.push(anchorNode);
+    }
+};
+/** Applies {@link transformHeadingAnchor} to every heading in a tree. */
+export const transformHeadingAnchors = (tree, options) => {
+    visit(tree, "heading", (heading) => {
+        transformHeadingAnchor(heading, options);
+    });
+};
+export const findAnchorNode = (nodes, anchorName = DEFAULT_ANCHOR_NAME) => {
+    for (const node of nodes) {
+        if ("attributes" in node && node.name === anchorName) {
+            return node;
+        }
+    }
+    return undefined;
+};
+export const extractAnchorId = (anchor, idAttribute = "id") => readStringAttribute(anchor, idAttribute);
+//# sourceMappingURL=heading-metadata.js.map

package/dist/internal/core/syntax/heading-metadata.js.map

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

package/dist/internal/core/syntax/index.d.ts

@@ -0,0 +1,5 @@
+export { assertDelimiterPair, createDelimiterPattern, createGlobalDelimiterPattern, extractDelimitedValue, hasDelimitedValue, splitByDelimiters, stripDelimited, stripDelimitedAndTrimEnd, } from "./delimiters.js";
+export type { DelimitedPart, DelimiterPair } from "./delimiters.js";
+export { DEFAULT_ANCHOR_NAME, DEFAULT_BADGE_DELIMITERS, DEFAULT_HEADING_DEPTHS, DEFAULT_ID_DELIMITERS, extractAnchorId, findAnchorNode, resolveHeadingMetadataOptions, transformHeadingAnchor, transformHeadingAnchors, } from "./heading-metadata.js";
+export type { AnchorOptions, HeadingMetadataOptions, ResolvedHeadingMetadataOptions, } from "./heading-metadata.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/core/syntax/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/syntax/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,GACzB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAA"}

package/dist/internal/core/syntax/index.js

@@ -0,0 +1,3 @@
+export { assertDelimiterPair, createDelimiterPattern, createGlobalDelimiterPattern, extractDelimitedValue, hasDelimitedValue, splitByDelimiters, stripDelimited, stripDelimitedAndTrimEnd, } from "./delimiters.js";
+export { DEFAULT_ANCHOR_NAME, DEFAULT_BADGE_DELIMITERS, DEFAULT_HEADING_DEPTHS, DEFAULT_ID_DELIMITERS, extractAnchorId, findAnchorNode, resolveHeadingMetadataOptions, transformHeadingAnchor, transformHeadingAnchors, } from "./heading-metadata.js";
+//# sourceMappingURL=index.js.map

package/dist/internal/core/syntax/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/core/syntax/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,GACzB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA"}

package/dist/internal/core/walk.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Single-pass traversal shared by every cudoc transform.
+ *
+ * Transforms run in one walk rather than one walk each, because ordering
+ * between them is a contract: a transform that rewrites a whole table has to
+ * see cells that earlier transforms already normalized.
+ */
+import type { Node, Parent, Root } from "mdast";
+/** Where a node sits in its parent, recorded for each ancestor. */
+export type AncestorLocation = {
+    index: number;
+    parent: Parent;
+};
+/** State carried through one document. Extend it per plugin. */
+export type TransformState = {
+    /** Raw source text, when the host provided it. Needed to read table cells. */
+    source: string | null;
+};
+export type TransformContext<State extends TransformState = TransformState> = {
+    ancestors?: AncestorLocation[];
+    index?: number;
+    node: Node;
+    parent?: Parent;
+    state: State;
+};
+export type Transform<State extends TransformState = TransformState> = (context: TransformContext<State>) => void;
+/**
+ * Runs `preTransforms` on the way down and `postTransforms` on the way up.
+ *
+ * A pre transform may replace the node it was given; the walk re-reads the slot
+ * from the parent afterwards so the replacement, not the original, is what gets
+ * descended into and what the post transforms see.
+ */
+export declare const walk: <State extends TransformState>({ postTransforms, preTransforms, state, tree, }: {
+    postTransforms: Transform<State>[];
+    preTransforms: Transform<State>[];
+    state: State;
+    tree: Root;
+}) => void;
+//# sourceMappingURL=walk.d.ts.map

package/dist/internal/core/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../../src/internal/core/walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAE/C,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,IAAI;IAC5E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,IAAI,CACrE,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAC7B,IAAI,CAAA;AAKT;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,KAAK,SAAS,cAAc,EAAE,iDAKhD;IACD,cAAc,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAA;IAClC,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAA;IACjC,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;CACX,KAAG,IAqDH,CAAA"}

package/dist/internal/core/walk.js

@@ -0,0 +1,53 @@
+/**
+ * Single-pass traversal shared by every cudoc transform.
+ *
+ * Transforms run in one walk rather than one walk each, because ordering
+ * between them is a contract: a transform that rewrites a whole table has to
+ * see cells that earlier transforms already normalized.
+ */
+const hasChildren = (node) => "children" in node && Array.isArray(node.children);
+/**
+ * Runs `preTransforms` on the way down and `postTransforms` on the way up.
+ *
+ * A pre transform may replace the node it was given; the walk re-reads the slot
+ * from the parent afterwards so the replacement, not the original, is what gets
+ * descended into and what the post transforms see.
+ */
+export const walk = ({ postTransforms, preTransforms, state, tree, }) => {
+    const runTransforms = (transforms, context) => {
+        for (const transform of transforms)
+            transform(context);
+    };
+    const visitNode = (node, parent, index, ancestors = []) => {
+        runTransforms(preTransforms, {
+            ancestors,
+            index,
+            node,
+            parent,
+            state,
+        });
+        const currentNode = parent && typeof index === "number" ? parent.children[index] : node;
+        if (!currentNode)
+            return;
+        if (hasChildren(currentNode)) {
+            const childAncestors = parent && typeof index === "number"
+                ? [...ancestors, { index, parent }]
+                : ancestors;
+            for (let childIndex = 0; childIndex < currentNode.children.length; childIndex += 1) {
+                const child = currentNode.children[childIndex];
+                if (!child)
+                    continue;
+                visitNode(child, currentNode, childIndex, childAncestors);
+            }
+        }
+        runTransforms(postTransforms, {
+            ancestors,
+            index,
+            node: currentNode,
+            parent,
+            state,
+        });
+    };
+    visitNode(tree);
+};
+//# sourceMappingURL=walk.js.map

package/dist/internal/core/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../../src/internal/core/walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH,MAAM,WAAW,GAAG,CAAC,IAAU,EAAkB,EAAE,CACjD,UAAU,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAAe,CAAC,QAAQ,CAAC,CAAA;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAA+B,EACjD,cAAc,EACd,aAAa,EACb,KAAK,EACL,IAAI,GAML,EAAQ,EAAE;IACT,MAAM,aAAa,GAAG,CACpB,UAA8B,EAC9B,OAAgC,EAChC,EAAE;QACF,KAAK,MAAM,SAAS,IAAI,UAAU;YAAE,SAAS,CAAC,OAAO,CAAC,CAAA;IACxD,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,CAChB,IAAU,EACV,MAAe,EACf,KAAc,EACd,YAAgC,EAAE,EAClC,EAAE;QACF,aAAa,CAAC,aAAa,EAAE;YAC3B,SAAS;YACT,KAAK;YACL,IAAI;YACJ,MAAM;YACN,KAAK;SACN,CAAC,CAAA;QAEF,MAAM,WAAW,GACf,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QACrE,IAAI,CAAC,WAAW;YAAE,OAAM;QAExB,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,MAAM,cAAc,GAClB,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ;gBACjC,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC,CAAC,SAAS,CAAA;YAEf,KACE,IAAI,UAAU,GAAG,CAAC,EAClB,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,EACxC,UAAU,IAAI,CAAC,EACf,CAAC;gBACD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;gBAC9C,IAAI,CAAC,KAAK;oBAAE,SAAQ;gBACpB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,CAAC,CAAA;YAC3D,CAAC;QACH,CAAC;QAED,aAAa,CAAC,cAAc,EAAE;YAC5B,SAAS;YACT,KAAK;YACL,IAAI,EAAE,WAAW;YACjB,MAAM;YACN,KAAK;SACN,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,SAAS,CAAC,IAAI,CAAC,CAAA;AACjB,CAAC,CAAA"}

package/dist/mdx.d.ts

@@ -0,0 +1,2 @@
+export * from "./internal/core/mdx/index.js";
+//# sourceMappingURL=mdx.d.ts.map

package/dist/mdx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../src/mdx.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA"}

package/dist/mdx.js

@@ -0,0 +1,2 @@
+export * from "./internal/core/mdx/index.js";
+//# sourceMappingURL=mdx.js.map

package/dist/mdx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx.js","sourceRoot":"","sources":["../src/mdx.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA"}