@cudoment/cudoc 0.1.0 → 0.2.0

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

@@ -0,0 +1,51 @@
+/**
+ * Lays out a table's column as host components, optionally splitting one column
+ * across several cells.
+ *
+ * Which table this applies to is described declaratively — the heading above it
+ * and the header text of the column — because options have to survive JSON
+ * serialization on their way through a bundler config.
+ */
+import type { SectionSelector, TransformContext } from "../../core/index.js";
+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";
+export type TableColumnLayoutOptions = {
+    /** The heading that introduces the table this rule applies to. */
+    section: SectionSelector;
+    /** Header text of the column to lay out. Compared after collapsing spaces. */
+    columnHeaders: string[];
+    split?: SplitOptions;
+    components?: TableComponents;
+    /** Attribute used to widen a cell. Defaults to `colSpan`. */
+    spanAttribute?: string;
+    /**
+     * Delimiter pairs stripped from a header cell before comparison, so a column
+     * header carrying badge or id syntax still matches.
+     */
+    metadataDelimiters?: DelimiterPair[];
+    /** Element names ignored when reading header text, such as a badge. */
+    ignoreElements?: string[];
+};
+export type ResolvedTableColumnLayoutOptions = {
+    section: SectionSelector;
+    columnHeaders: string[];
+    split: ReturnType<typeof resolveSplitOptions>;
+    components: ResolvedTableComponents;
+    spanAttribute: string;
+    metadataDelimiters: DelimiterPair[];
+    ignoreElements: string[];
+};
+export declare const resolveTableColumnLayoutOptions: (options: TableColumnLayoutOptions, optionPath?: string) => ResolvedTableColumnLayoutOptions;
+/**
+ * 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
+ * the generated subtree has to run after this one.
+ */
+export declare const createTableColumnLayoutTransform: (options: ResolvedTableColumnLayoutOptions) => ({ ancestors, index, node, parent }: TransformContext) => void;
+export { createLayoutTable, resolveTableComponents } from "./create-table.js";
+export { resolveSplitOptions, splitCell } from "./split-cell.js";
+export type { TableComponents } from "./create-table.js";
+export type { SplitOptions } from "./split-cell.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;AA6DD;;;;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

@@ -0,0 +1,96 @@
+/**
+ * Lays out a table's column as host components, optionally splitting one column
+ * across several cells.
+ *
+ * Which table this applies to is described declaratively — the heading above it
+ * and the header text of the column — because options have to survive JSON
+ * serialization on their way through a bundler config.
+ */
+import { assertSectionSelector, findPreviousHeading, getInlineText, isMdxTextElementNamed, matchesSectionHeading, normalizeHeaderText, stripDelimited, DEFAULT_BADGE_DELIMITERS, DEFAULT_ID_DELIMITERS, } from "../../core/index.js";
+import { createLayoutTable, resolveTableComponents, } from "./create-table.js";
+import { resolveSplitOptions } from "./split-cell.js";
+export const DEFAULT_SPAN_ATTRIBUTE = "colSpan";
+export const resolveTableColumnLayoutOptions = (options, optionPath = "tableColumnLayout") => {
+    if (!options || typeof options !== "object") {
+        throw new TypeError(`${optionPath} must be an object`);
+    }
+    const { columnHeaders } = options;
+    if (!Array.isArray(columnHeaders) ||
+        columnHeaders.length === 0 ||
+        !columnHeaders.every((header) => typeof header === "string" && header.trim())) {
+        throw new TypeError(`${optionPath}.columnHeaders must be a non-empty string array`);
+    }
+    return {
+        section: assertSectionSelector(options.section, `${optionPath}.section`),
+        columnHeaders: [...columnHeaders],
+        split: resolveSplitOptions(options.split),
+        components: resolveTableComponents(options.components),
+        spanAttribute: options.spanAttribute ?? DEFAULT_SPAN_ATTRIBUTE,
+        metadataDelimiters: options.metadataDelimiters ?? [
+            DEFAULT_BADGE_DELIMITERS,
+            DEFAULT_ID_DELIMITERS,
+        ],
+        ignoreElements: options.ignoreElements ?? ["Badge"],
+    };
+};
+/**
+ * Reads a header cell's text, dropping generated elements and leftover metadata
+ * syntax so the comparison sees what the author wrote.
+ */
+const readHeaderText = (cell, options) => {
+    const fromNode = (node) => {
+        if (node.data?.cudoc?.kind ===
+            "badge")
+            return "";
+        if (options.ignoreElements.some((name) => isMdxTextElementNamed(node, name))) {
+            return "";
+        }
+        if (node.type === "text") {
+            return stripDelimited(node.value, options.metadataDelimiters);
+        }
+        if ("value" in node && typeof node.value === "string")
+            return node.value;
+        if ("children" in node && Array.isArray(node.children)) {
+            return node.children.map(fromNode).join("");
+        }
+        return "";
+    };
+    return normalizeHeaderText(cell.children.map(fromNode).join(""));
+};
+const findColumnIndex = (table, options) => {
+    const headerRow = table.children[0];
+    if (!headerRow)
+        return -1;
+    return headerRow.children.findIndex((cell) => options.columnHeaders.includes(readHeaderText(cell, options)));
+};
+const readHeadingText = (heading, options) => stripDelimited(getInlineText(heading.children.filter((node) => node.data?.cudoc
+    ?.kind !== "badge")), options.metadataDelimiters);
+/**
+ * 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
+ * the generated subtree has to run after this one.
+ */
+export const createTableColumnLayoutTransform = (options) => ({ ancestors, index, node, parent }) => {
+    if (node.type !== "table" || !parent || typeof index !== "number")
+        return;
+    const previousHeading = findPreviousHeading(parent, index, ancestors);
+    if (!previousHeading ||
+        !matchesSectionHeading(previousHeading, options.section, (heading) => readHeadingText(heading, options))) {
+        return;
+    }
+    const table = node;
+    const columnIndex = findColumnIndex(table, options);
+    if (columnIndex === -1)
+        return;
+    parent.children[index] = createLayoutTable({
+        columnIndex,
+        components: options.components,
+        split: options.split,
+        spanAttribute: options.spanAttribute,
+        table,
+    });
+    parent.children[index].position = table.position;
+};
+export { createLayoutTable, resolveTableComponents } from "./create-table.js";
+export { resolveSplitOptions, splitCell } from "./split-cell.js";
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { CudocTableCellContent } from "../../core/index.js";
+export declare const DEFAULT_SPLIT_MIN_ITEMS = 4;
+export declare const DEFAULT_SPLIT_COLUMNS = 2;
+export type SplitOptions = {
+    /** Split only once the cell holds at least this many items. */
+    minItems?: number;
+    /** How many columns the cell becomes when it is split. */
+    columns?: number;
+};
+export type ResolvedSplitOptions = {
+    minItems: number;
+    columns: number;
+};
+export declare const resolveSplitOptions: (options?: SplitOptions) => ResolvedSplitOptions;
+/**
+ * Splits a cell's items across columns, or returns it unchanged when there are
+ * too few to be worth splitting.
+ *
+ * Items are spread evenly and any remainder goes to the leading columns, so no
+ * column ends up empty. For two columns this is the same boundary as taking the
+ * ceiling of half the items.
+ */
+export declare const splitCell: (children: CudocTableCellContent[], options: ResolvedSplitOptions) => CudocTableCellContent[][];
+//# sourceMappingURL=split-cell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"split-cell.d.ts","sourceRoot":"","sources":["../../../../src/internal/transforms/table-column-layout/split-cell.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AA0ShE,eAAO,MAAM,uBAAuB,IAAI,CAAA;AACxC,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,UAAS,YAAiB,KACzB,oBAcF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,qBAAqB,EAAE,EACjC,SAAS,oBAAoB,KAC5B,qBAAqB,EAAE,EAgBzB,CAAA"}

package/dist/internal/transforms/table-column-layout/split-cell.js

@@ -0,0 +1,219 @@
+import { createMdxAttribute, isMdxTextElementNamed } from "../../core/index.js";
+import { createBreak, isBreak } from "../table-cell-list/elements.js";
+const hasVisibleCellContent = (children) => children.some((child) => {
+    if (child.type === "text")
+        return child.value.trim().length > 0;
+    return !isBreak(child);
+});
+const isMdxListElement = (node) => isMdxTextElementNamed(node, "ul") || isMdxTextElementNamed(node, "ol");
+const isMdxListItemElement = (node) => isMdxTextElementNamed(node, "li");
+const isSemanticList = (node) => node.type === "list";
+const isNamedMdxAttribute = (attribute, name) => attribute.type === "mdxJsxAttribute" && attribute.name === name;
+const hasNamedMdxAttribute = (node, name) => node.attributes.some((attribute) => isNamedMdxAttribute(attribute, name));
+const readOlStartValue = (list) => {
+    const startAttribute = list.attributes.find((attribute) => isNamedMdxAttribute(attribute, "start"));
+    if (!startAttribute)
+        return 1;
+    if (typeof startAttribute.value !== "string")
+        return null;
+    const normalizedStart = startAttribute.value.trim();
+    if (!/^[+-]?\d+$/.test(normalizedStart))
+        return null;
+    const startValue = Number(normalizedStart);
+    return Number.isSafeInteger(startValue) ? startValue : null;
+};
+const isUnsupportedListElement = (node) => node.name === "ol" &&
+    (hasNamedMdxAttribute(node, "reversed") || readOlStartValue(node) === null);
+const cloneListAttributes = (list, startOffset) => {
+    const attributes = list.attributes.map((attribute) => structuredClone(attribute));
+    if (list.name !== "ol" || startOffset === 0)
+        return attributes;
+    const authoredStart = readOlStartValue(list);
+    if (authoredStart === null)
+        return attributes;
+    const startValue = String(authoredStart + startOffset);
+    const startAttributeIndex = attributes.findIndex((attribute) => isNamedMdxAttribute(attribute, "start"));
+    if (startAttributeIndex === -1) {
+        return [...attributes, createMdxAttribute("start", startValue)];
+    }
+    attributes[startAttributeIndex] = createMdxAttribute("start", startValue);
+    return attributes;
+};
+const cloneListElement = (list, children, startOffset = 0) => {
+    return {
+        ...list,
+        attributes: cloneListAttributes(list, startOffset),
+        children: children.map((child) => structuredClone(child)),
+    };
+};
+const cloneSemanticList = (list, children, startOffset = 0) => {
+    const start = list.ordered
+        ? (typeof list.start === "number" ? list.start : 1) + startOffset
+        : null;
+    return {
+        ...list,
+        start,
+        children: children.map((child) => structuredClone(child)),
+    };
+};
+const collectCellItems = (children) => {
+    const items = [];
+    let line = [];
+    let pendingBreakCount = 0;
+    const flushLine = () => {
+        if (hasVisibleCellContent(line)) {
+            items.push({
+                preservedBreaksBefore: pendingBreakCount,
+                children: line,
+                type: "line",
+            });
+            pendingBreakCount = 0;
+        }
+        line = [];
+    };
+    for (const child of children) {
+        if (isBreak(child)) {
+            flushLine();
+            pendingBreakCount++;
+            continue;
+        }
+        if (isSemanticList(child)) {
+            flushLine();
+            if (child.children.length > 0) {
+                items.push(...child.children.map((item, itemIndex) => ({
+                    kind: "mdast",
+                    listItemIndex: itemIndex,
+                    preservedBreaksBefore: itemIndex === 0 ? pendingBreakCount : 0,
+                    item,
+                    list: child,
+                    type: "listItem",
+                })));
+                pendingBreakCount = 0;
+            }
+            else {
+                line.push(child);
+            }
+            continue;
+        }
+        if (isMdxListElement(child)) {
+            flushLine();
+            if (isUnsupportedListElement(child)) {
+                line.push(child);
+                continue;
+            }
+            const listItems = child.children.filter(isMdxListItemElement);
+            if (listItems.length > 0) {
+                items.push(...listItems.map((item, itemIndex) => ({
+                    kind: "mdx",
+                    listItemIndex: itemIndex,
+                    preservedBreaksBefore: itemIndex === 0 ? pendingBreakCount : 0,
+                    item,
+                    list: child,
+                    type: "listItem",
+                })));
+                pendingBreakCount = 0;
+            }
+            else {
+                line.push(child);
+            }
+            continue;
+        }
+        line.push(child);
+    }
+    flushLine();
+    return items;
+};
+const renderCellItems = (items) => {
+    const children = [];
+    let pendingList;
+    const appendBreaks = (count) => {
+        if (!hasVisibleCellContent(children))
+            return;
+        for (let i = 0; i < count; i++)
+            children.push(createBreak());
+    };
+    const flushList = () => {
+        if (!pendingList || pendingList.items.length === 0)
+            return;
+        children.push(pendingList.kind === "mdast"
+            ? cloneSemanticList(pendingList.list, pendingList.items, pendingList.startOffset)
+            : cloneListElement(pendingList.list, pendingList.items, pendingList.startOffset));
+        pendingList = undefined;
+    };
+    for (const item of items) {
+        if (item.type === "listItem") {
+            if (pendingList &&
+                (pendingList.kind !== item.kind ||
+                    pendingList.list !== item.list ||
+                    item.preservedBreaksBefore > 0)) {
+                flushList();
+            }
+            if (!pendingList) {
+                appendBreaks(item.preservedBreaksBefore);
+                pendingList =
+                    item.kind === "mdast"
+                        ? {
+                            kind: "mdast",
+                            list: item.list,
+                            items: [],
+                            startOffset: item.listItemIndex,
+                        }
+                        : {
+                            kind: "mdx",
+                            list: item.list,
+                            items: [],
+                            startOffset: item.listItemIndex,
+                        };
+            }
+            if (pendingList.kind === "mdast" && item.kind === "mdast") {
+                pendingList.items.push(item.item);
+            }
+            else if (pendingList.kind === "mdx" && item.kind === "mdx") {
+                pendingList.items.push(item.item);
+            }
+            continue;
+        }
+        flushList();
+        appendBreaks(item.preservedBreaksBefore);
+        children.push(...item.children.map((child) => structuredClone(child)));
+    }
+    flushList();
+    return children;
+};
+export const DEFAULT_SPLIT_MIN_ITEMS = 4;
+export const DEFAULT_SPLIT_COLUMNS = 2;
+export const resolveSplitOptions = (options = {}) => {
+    const columns = options.columns ?? DEFAULT_SPLIT_COLUMNS;
+    const minItems = options.minItems ?? DEFAULT_SPLIT_MIN_ITEMS;
+    if (!Number.isInteger(columns) || columns < 2) {
+        throw new TypeError("split.columns must be an integer of 2 or more");
+    }
+    if (!Number.isInteger(minItems) || minItems < columns) {
+        throw new TypeError(`split.minItems must be an integer of at least split.columns (${columns})`);
+    }
+    return { columns, minItems };
+};
+/**
+ * Splits a cell's items across columns, or returns it unchanged when there are
+ * too few to be worth splitting.
+ *
+ * Items are spread evenly and any remainder goes to the leading columns, so no
+ * column ends up empty. For two columns this is the same boundary as taking the
+ * ceiling of half the items.
+ */
+export const splitCell = (children, options) => {
+    const items = collectCellItems(children);
+    if (items.length < options.minItems)
+        return [children];
+    const perColumn = Math.floor(items.length / options.columns);
+    const remainder = items.length % options.columns;
+    const layout = [];
+    let offset = 0;
+    for (let column = 0; column < options.columns; column += 1) {
+        const size = perColumn + (column < remainder ? 1 : 0);
+        layout.push(renderCellItems(items.slice(offset, offset + size)));
+        offset += size;
+    }
+    return layout;
+};
+//# sourceMappingURL=split-cell.js.map

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

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

package/dist/markdown.d.ts

@@ -0,0 +1,10 @@
+import type { Root } from "mdast";
+import { normalizeDocument, type DocumentOptions } from "./document.js";
+export type CompiledDocument = {
+    tree: Root;
+    frontmatter: Record<string, unknown>;
+    diagnostics: ReturnType<typeof normalizeDocument>;
+};
+/** Standalone Markdown/MDX compiler. Host adapters supply their actual compiler instead. */
+export declare function compileDocument(source: string, options?: DocumentOptions): CompiledDocument;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +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"}

package/dist/markdown.js

@@ -0,0 +1,47 @@
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import remarkDirective from "remark-directive";
+import remarkFrontmatter from "remark-frontmatter";
+import { compileSync } from "@mdx-js/mdx";
+import { parse as parseYaml } from "yaml";
+import { normalizeDocument, } from "./document.js";
+/** Standalone Markdown/MDX compiler. Host adapters supply their actual compiler instead. */
+export function compileDocument(source, options = {}) {
+    let tree;
+    if (options.format === "mdx") {
+        let captured;
+        const capture = () => (value) => {
+            captured = structuredClone(value);
+        };
+        compileSync(source, {
+            remarkPlugins: [
+                remarkGfm,
+                remarkFrontmatter,
+                ...(options.host === "docusaurus" ? [remarkDirective] : []),
+                capture,
+            ],
+        });
+        tree = captured;
+    }
+    else {
+        const processor = unified()
+            .use(remarkParse)
+            .use(remarkGfm)
+            .use(remarkFrontmatter);
+        if (options.host === "docusaurus")
+            processor.use(remarkDirective);
+        tree = processor.runSync(processor.parse(source));
+    }
+    const frontmatterNode = tree.children.find((n) => n.type === "yaml");
+    const frontmatter = frontmatterNode
+        ? parseYaml(frontmatterNode.value, { maxAliasCount: 100 })
+        : {};
+    if (frontmatter !== null &&
+        (typeof frontmatter !== "object" || Array.isArray(frontmatter)))
+        throw new Error("cudoc: frontmatter must be a mapping");
+    tree.children = tree.children.filter((n) => !["yaml", "mdxjsEsm"].includes(n.type));
+    const diagnostics = normalizeDocument(tree, source, options);
+    return { tree, frontmatter: frontmatter ?? {}, diagnostics };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +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"}

package/dist/node/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/node/cli.ts"],"names":[],"mappings":""}

package/dist/node/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { buildDocuments, buildDocumentsAsync } from "./library.js";
+import { prepareEmbeds } from "./prepare-embeds.js";
+import { generateDataset } from "./dataset.js";
+try {
+    const [command, ...args] = process.argv.slice(2);
+    if (!["collect", "dataset"].includes(command) ||
+        args.length !== 2 ||
+        args[0] !== "--config")
+        throw new Error("Usage: cudoc <collect|dataset> --config config.mjs");
+    const config = args[1].endsWith(".json")
+        ? JSON.parse(fs.readFileSync(args[1], "utf8"))
+        : (await import(pathToFileURL(path.resolve(args[1])).href)).default;
+    if (command === "dataset")
+        console.log(JSON.stringify(generateDataset(config)));
+    else {
+        const library = config.compiler
+            ? await buildDocumentsAsync({
+                ...config,
+                compiler: async (...parameters) => config.compiler(...parameters),
+            })
+            : buildDocuments(config);
+        await prepareEmbeds(library, config.outDir);
+        console.log(JSON.stringify({
+            documentCount: library.documents.length,
+            outDir: config.outDir ?? ".cudoc/documents",
+        }));
+    }
+}
+catch (error) {
+    console.error(error);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/node/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/node/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,IAAI,CAAC;IACH,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAChD,IACE,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzC,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;QAEtB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;IACrE,IAAI,OAAO,KAAK,SAAS;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;SACjD,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ;YAC7B,CAAC,CAAC,MAAM,mBAAmB,CAAC;gBACxB,GAAG,MAAM;gBACT,QAAQ,EAAE,KAAK,EACb,GAAG,UAA2D,EAC9D,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;aACpC,CAAC;YACJ,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3C,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC;YACb,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YACvC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,kBAAkB;SAC5C,CAAC,CACH,CAAA;IACH,CAAC;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}

package/dist/node/dataset.d.ts

@@ -0,0 +1,19 @@
+import { type ProjectionOptions } from "../dataset.js";
+export type DatasetOptions = ProjectionOptions & {
+    inputDir: string;
+    outDir: string;
+    documents?: string[];
+    scopes?: string[];
+    projectionId?: string;
+    requireVersion?: boolean;
+};
+export declare function generateDataset({ inputDir, outDir, documents, scopes, projectionId, requireVersion, ...projection }: DatasetOptions): {
+    schemaVersion: string;
+    documentCount: number;
+    documents: {
+        id: string;
+        hash: string;
+        outputHash: string;
+    }[];
+};
+//# sourceMappingURL=dataset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataset.d.ts","sourceRoot":"","sources":["../../src/node/dataset.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAUlE,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AACD,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,MAAM,EACN,SAAS,EACT,MAAM,EACN,YAAuB,EACvB,cAAqB,EACrB,GAAG,UAAU,EACd,EAAE,cAAc;;;;YAiBK,MAAM;cAAQ,MAAM;oBAAc,MAAM;;EA+B7D"}

package/dist/node/dataset.js

@@ -0,0 +1,51 @@
+import fs from "node:fs";
+import path from "node:path";
+import { validateAstContract } from "../internal/core/ast/validate.js";
+import { projectAst } from "../dataset.js";
+import { hash, sourceFiles, publishDirectory, safePath, posix, writeJson, } from "./storage.js";
+export function generateDataset({ inputDir, outDir, documents, scopes, projectionId = "custom", requireVersion = true, ...projection }) {
+    const entries = sourceFiles(inputDir, [".json"])
+        .filter((file) => !["manifest.json", "meta.json"].includes(path.basename(file)))
+        .map((file) => ({
+        file,
+        id: posix(path.relative(inputDir, file)).replace(/\.json$/, ""),
+    }))
+        .filter((entry) => (!documents || documents.includes(entry.id)) &&
+        (!scopes || scopes.includes(entry.id.split("/")[0])));
+    for (const id of documents ?? [])
+        if (!entries.some((e) => e.id === id))
+            throw new Error(`cudoc: dataset document missing: ${id}`);
+    const inputs = [];
+    publishDirectory(inputDir, outDir, (staging) => {
+        for (const { file, id } of entries) {
+            try {
+                const source = fs.readFileSync(file, "utf8");
+                const input = JSON.parse(source);
+                validateAstContract(input, { requireVersion });
+                const tree = projectAst(input, projection);
+                const serialized = JSON.stringify(tree);
+                writeJson(safePath(staging, `documents/${id}.json`), tree);
+                inputs.push({ id, hash: hash(source), outputHash: hash(serialized) });
+            }
+            catch (cause) {
+                throw new Error(`cudoc: dataset projection failed for ${file}`, {
+                    cause,
+                });
+            }
+        }
+        writeJson(path.join(staging, "manifest.json"), {
+            schemaVersion: "1.0.0",
+            projectionId,
+            projection,
+            documentCount: inputs.length,
+            scopes: scopes ?? [...new Set(entries.map((e) => e.id.split("/")[0]))],
+            documents: inputs,
+        });
+    });
+    return {
+        schemaVersion: "1.0.0",
+        documentCount: inputs.length,
+        documents: inputs,
+    };
+}
+//# sourceMappingURL=dataset.js.map

package/dist/node/dataset.js.map

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