@cudoment/cudoc 0.1.0

package/dist/node/export-ast.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Writes the compiled AST of each document to JSON.
+ *
+ * The tree comes from the host's real compilation rather than a second parse.
+ * Re-parsing MDX to reproduce it would drift, because the MDX compiler applies
+ * its own transforms before user plugins ever run.
+ */
+import type { Transformer } from "unified";
+import type { Root } from "mdast";
+import { resolveAstVersion } from "../internal/core/index.js";
+import type { AstVersionOptions, ValidateAstOptions } from "../internal/core/index.js";
+import { type PathOptions, type ResolvedPathOptions } from "./paths.js";
+type AstNode = Record<string, unknown>;
+/** Properties dropped from stored JSON: neither survives a round trip usefully. */
+export declare const DEFAULT_STRIPPED_PROPERTIES: string[];
+/** Node types dropped entirely. ESM export nodes carry no document content. */
+export declare const DEFAULT_DROPPED_NODE_TYPES: string[];
+export type ExportAstOptions = PathOptions & {
+    /** Properties removed from every node. */
+    strip?: string[];
+    /** Node types removed together with their subtree. */
+    dropNodeTypes?: string[];
+    /** Where the schema version is written, and what it is. */
+    version?: AstVersionOptions;
+    /** Validate the contract before writing. On by default. */
+    validate?: boolean;
+    /** Cell element names to validate when layout rules use custom components. */
+    tableCellElement?: ValidateAstOptions["tableCellElement"];
+    /**
+     * Sink for the serialized document. Defaults to an atomic file write.
+     * Intended for programmatic use; a config passed through a bundler cannot
+     * carry a function.
+     */
+    write?: (filePath: string, contents: string) => void;
+};
+export type ExportAstContext = {
+    pathOptions: ResolvedPathOptions;
+    strip: Set<string>;
+    dropNodeTypes: Set<string>;
+    version: ReturnType<typeof resolveAstVersion>;
+    validate: boolean;
+    tableCellElement: ValidateAstOptions["tableCellElement"];
+    write: (filePath: string, contents: string) => void;
+};
+export declare const resolveExportAstOptions: (options?: ExportAstOptions) => ExportAstContext;
+/** Strips properties and drops node types in a single pass. */
+export declare const projectTree: (node: unknown, context: ExportAstContext) => unknown;
+/** Builds the object written for one document, without touching the disk. */
+export declare const buildExportedAst: (tree: unknown, context: ExportAstContext) => AstNode;
+declare const exportAst: (options?: ExportAstOptions) => Transformer<Root, Root>;
+export default exportAst;
+//# sourceMappingURL=export-ast.d.ts.map

package/dist/node/export-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-ast.d.ts","sourceRoot":"","sources":["../../src/node/export-ast.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,EACL,iBAAiB,EAElB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAA;AAEnB,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtC,mFAAmF;AACnF,eAAO,MAAM,2BAA2B,UAAyB,CAAA;AAEjE,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,UAAe,CAAA;AAEtD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAA;IACzD;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CACrD,CAAA;AAgCD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,mBAAmB,CAAA;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;IAC7C,QAAQ,EAAE,OAAO,CAAA;IACjB,gBAAgB,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAA;IACxD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD,CAAA;AAED,eAAO,MAAM,uBAAuB,GAClC,UAAS,gBAAqB,KAC7B,gBAQD,CAAA;AAEF,+DAA+D;AAC/D,eAAO,MAAM,WAAW,GACtB,MAAM,OAAO,EACb,SAAS,gBAAgB,KACxB,OAsBF,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,GAC3B,MAAM,OAAO,EACb,SAAS,gBAAgB,KACxB,OAyBF,CAAA;AAED,QAAA,MAAM,SAAS,GACZ,UAAS,gBAAqB,KAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAoBvD,CAAA;AAEH,eAAe,SAAS,CAAA"}

package/dist/node/export-ast.js

@@ -0,0 +1,117 @@
+/**
+ * Writes the compiled AST of each document to JSON.
+ *
+ * The tree comes from the host's real compilation rather than a second parse.
+ * Re-parsing MDX to reproduce it would drift, because the MDX compiler applies
+ * its own transforms before user plugins ever run.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { resolveAstVersion, validateAstContract, } from "../internal/core/index.js";
+import { getOutputPath, resolvePathOptions, } from "./paths.js";
+/** Properties dropped from stored JSON: neither survives a round trip usefully. */
+export const DEFAULT_STRIPPED_PROPERTIES = ["position", "estree"];
+/** Node types dropped entirely. ESM export nodes carry no document content. */
+export const DEFAULT_DROPPED_NODE_TYPES = ["mdxjsEsm"];
+const writeJsonAtomically = (outputFile, contents) => {
+    const temporaryFile = path.join(path.dirname(outputFile), `.${path.basename(outputFile)}.${process.pid}.${crypto.randomUUID()}.tmp`);
+    let operationFailed = false;
+    try {
+        fs.mkdirSync(path.dirname(outputFile), { recursive: true });
+        fs.writeFileSync(temporaryFile, contents, "utf-8");
+        fs.renameSync(temporaryFile, outputFile);
+    }
+    catch (error) {
+        operationFailed = true;
+        throw error;
+    }
+    finally {
+        if (fs.existsSync(temporaryFile)) {
+            try {
+                fs.unlinkSync(temporaryFile);
+            }
+            catch (cleanupError) {
+                // A cleanup failure must not mask the original error.
+                if (!operationFailed)
+                    throw cleanupError;
+                console.error(`cudoc: failed to remove temporary file ${temporaryFile}`, cleanupError);
+            }
+        }
+    }
+};
+export const resolveExportAstOptions = (options = {}) => ({
+    pathOptions: resolvePathOptions(options),
+    strip: new Set(options.strip ?? DEFAULT_STRIPPED_PROPERTIES),
+    dropNodeTypes: new Set(options.dropNodeTypes ?? DEFAULT_DROPPED_NODE_TYPES),
+    version: resolveAstVersion(options.version),
+    validate: options.validate !== false,
+    tableCellElement: options.tableCellElement,
+    write: options.write ?? writeJsonAtomically,
+});
+/** Strips properties and drops node types in a single pass. */
+export const projectTree = (node, context) => {
+    if (!node || typeof node !== "object")
+        return node;
+    if (Array.isArray(node)) {
+        return node.flatMap((child) => {
+            const projected = projectTree(child, context);
+            return projected === undefined ? [] : [projected];
+        });
+    }
+    const type = node.type;
+    if (typeof type === "string" && context.dropNodeTypes.has(type)) {
+        return undefined;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(node)) {
+        if (context.strip.has(key))
+            continue;
+        const projected = projectTree(value, context);
+        if (projected !== undefined)
+            result[key] = projected;
+    }
+    return result;
+};
+/** Builds the object written for one document, without touching the disk. */
+export const buildExportedAst = (tree, context) => {
+    const projected = projectTree(tree, context);
+    if (!projected || typeof projected !== "object") {
+        throw new Error("cudoc: the AST root did not survive projection");
+    }
+    const exportTree = projected;
+    const currentData = exportTree.data && typeof exportTree.data === "object"
+        ? exportTree.data
+        : {};
+    exportTree.data = {
+        ...currentData,
+        [context.version.field]: context.version.value,
+    };
+    if (context.validate) {
+        validateAstContract(exportTree, {
+            requireVersion: true,
+            version: context.version,
+            tableCellElement: context.tableCellElement,
+        });
+    }
+    return exportTree;
+};
+const exportAst = (options = {}) => (tree, file) => {
+    const context = resolveExportAstOptions(options);
+    const outputFile = file.path
+        ? getOutputPath(file.path, context.pathOptions)
+        : null;
+    if (!outputFile)
+        return tree;
+    try {
+        const exportTree = buildExportedAst(tree, context);
+        context.write(outputFile, JSON.stringify(exportTree));
+    }
+    catch (error) {
+        console.error(`cudoc: failed to export ${file.path}:`, error instanceof Error ? error.message : String(error));
+        throw error;
+    }
+    return tree;
+};
+export default exportAst;
+//# sourceMappingURL=export-ast.js.map

package/dist/node/export-ast.js.map

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

package/dist/node/index.d.ts

@@ -0,0 +1,7 @@
+export { default, default as exportAst, buildExportedAst, projectTree, resolveExportAstOptions, DEFAULT_DROPPED_NODE_TYPES, DEFAULT_STRIPPED_PROPERTIES, } from "./export-ast.js";
+export type { ExportAstContext, ExportAstOptions } from "./export-ast.js";
+export { loadAst, loadAstFile } from "./load-ast.js";
+export type { LoadAstOptions } from "./load-ast.js";
+export { getOutputPath, getRelativeOutputPath, resolvePathOptions, DEFAULT_EXTENSIONS, DEFAULT_OUTPUT_ROOT, DEFAULT_SOURCE_ROOT, } from "./paths.js";
+export type { PathOptions, ResolvedPathOptions } from "./paths.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,SAAS,EACpB,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA"}

package/dist/node/index.js

@@ -0,0 +1,4 @@
+export { default, default as exportAst, buildExportedAst, projectTree, resolveExportAstOptions, DEFAULT_DROPPED_NODE_TYPES, DEFAULT_STRIPPED_PROPERTIES, } from "./export-ast.js";
+export { loadAst, loadAstFile } from "./load-ast.js";
+export { getOutputPath, getRelativeOutputPath, resolvePathOptions, DEFAULT_EXTENSIONS, DEFAULT_OUTPUT_ROOT, DEFAULT_SOURCE_ROOT, } from "./paths.js";
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,SAAS,EACpB,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}

package/dist/node/load-ast-file.d.ts

@@ -0,0 +1,9 @@
+import type { AstVersionOptions, ExportedCudocAstRoot, ValidateAstOptions } from "../internal/core/index.js";
+export type LoadAstOptions = {
+    version?: AstVersionOptions;
+    validate?: boolean;
+    tableCellElement?: ValidateAstOptions["tableCellElement"];
+};
+/** Loads and validates one stored document. */
+export declare const loadAstFile: (filePath: string, { version, validate, tableCellElement }?: LoadAstOptions) => ExportedCudocAstRoot;
+//# sourceMappingURL=load-ast-file.d.ts.map

package/dist/node/load-ast-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-ast-file.d.ts","sourceRoot":"","sources":["../../src/node/load-ast-file.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,2BAA2B,CAAA;AAElC,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAA;CAC1D,CAAA;AAED,+CAA+C;AAC/C,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,EAChB,0CAAgD,cAAmB,KAClE,oBA+BF,CAAA"}

package/dist/node/load-ast-file.js

@@ -0,0 +1,32 @@
+/** File loading without the build-time output path helpers. */
+import fs from "node:fs";
+import { resolveAstVersion, validateAstContract, } from "../internal/core/index.js";
+/** Loads and validates one stored document. */
+export const loadAstFile = (filePath, { version, validate = true, tableCellElement } = {}) => {
+    let fileContent;
+    try {
+        fileContent = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (error) {
+        if (error?.code === "ENOENT") {
+            throw new Error(`cudoc: stored AST not found: ${filePath}`);
+        }
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fileContent);
+    }
+    catch (error) {
+        throw new Error(`cudoc: stored AST is not valid JSON (${error instanceof Error ? error.message : String(error)}): ${filePath}`);
+    }
+    if (validate) {
+        validateAstContract(parsed, {
+            requireVersion: true,
+            version: resolveAstVersion(version),
+            tableCellElement,
+        });
+    }
+    return parsed;
+};
+//# sourceMappingURL=load-ast-file.js.map

package/dist/node/load-ast-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-ast-file.js","sourceRoot":"","sources":["../../src/node/load-ast-file.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAalC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAAgB,EAChB,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,EAAE,gBAAgB,KAAqB,EAAE,EAC7C,EAAE;IACxB,IAAI,WAAmB,CAAA;IACvB,IAAI,CAAC;QACH,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA2C,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAA;QAC7D,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,wCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,MAAM,QAAQ,EAAE,CACjB,CAAA;IACH,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,mBAAmB,CAAC,MAAM,EAAE;YAC1B,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC;YACnC,gBAAgB;SACjB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAA8B,CAAA;AACvC,CAAC,CAAA"}

package/dist/node/load-ast.d.ts

@@ -0,0 +1,11 @@
+import type { ExportedCudocAstRoot } from "../internal/core/index.js";
+import { type PathOptions } from "./paths.js";
+import { type LoadAstOptions } from "./load-ast-file.js";
+export { loadAstFile } from "./load-ast-file.js";
+export type { LoadAstOptions } from "./load-ast-file.js";
+/**
+ * Loads the document stored for a source-relative document path, such as
+ * `en/app-setting/app`.
+ */
+export declare const loadAst: (documentPath: string, options?: LoadAstOptions & PathOptions) => ExportedCudocAstRoot;
+//# sourceMappingURL=load-ast.d.ts.map

package/dist/node/load-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-ast.d.ts","sourceRoot":"","sources":["../../src/node/load-ast.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD;;;GAGG;AACH,eAAO,MAAM,OAAO,GAClB,cAAc,MAAM,EACpB,UAAS,cAAc,GAAG,WAAgB,KACzC,oBAWF,CAAA"}

package/dist/node/load-ast.js

@@ -0,0 +1,17 @@
+/** Source-relative document lookup, built on the file loader. */
+import path from "node:path";
+import { resolvePathOptions, } from "./paths.js";
+import { loadAstFile } from "./load-ast-file.js";
+export { loadAstFile } from "./load-ast-file.js";
+/**
+ * Loads the document stored for a source-relative document path, such as
+ * `en/app-setting/app`.
+ */
+export const loadAst = (documentPath, options = {}) => {
+    const pathOptions = resolvePathOptions(options);
+    const projectRoot = pathOptions.cwd ?? process.cwd();
+    const normalized = documentPath.replace(/^[/\\]+/, "").replace(/\.json$/i, "");
+    const filePath = path.join(projectRoot, pathOptions.outDir, `${normalized}.json`);
+    return loadAstFile(filePath, options);
+};
+//# sourceMappingURL=load-ast.js.map

package/dist/node/load-ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-ast.js","sourceRoot":"","sources":["../../src/node/load-ast.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EACL,kBAAkB,GAGnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAuB,MAAM,oBAAoB,CAAA;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,YAAoB,EACpB,UAAwC,EAAE,EACpB,EAAE;IACxB,MAAM,WAAW,GAAwB,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACpE,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,WAAW,EACX,WAAW,CAAC,MAAM,EAClB,GAAG,UAAU,OAAO,CACrB,CAAA;IAED,OAAO,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AACvC,CAAC,CAAA"}

package/dist/node/paths.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Maps a source document path onto its output path.
+ *
+ * The mapping is described with a source root and an output root rather than a
+ * glob, so it stays serializable and needs no matcher dependency.
+ */
+export declare const DEFAULT_SOURCE_ROOT = "docs";
+export declare const DEFAULT_OUTPUT_ROOT = ".cudoc/ast";
+export declare const DEFAULT_EXTENSIONS: string[];
+export type PathOptions = {
+    /** Directory holding the documents, relative to `cwd`. */
+    sourceRoot?: string;
+    /** Directory the JSON is written to, relative to `cwd`. */
+    outDir?: string;
+    /** Source extensions that are exported. Compared case-insensitively. */
+    extensions?: string[];
+    /** Project root. Defaults to `process.cwd()` at call time. */
+    cwd?: string;
+};
+export type ResolvedPathOptions = Required<Omit<PathOptions, "cwd">> & {
+    cwd: string | undefined;
+};
+export declare const resolvePathOptions: (options?: PathOptions) => ResolvedPathOptions;
+/**
+ * The path of the output file relative to `outDir`, or `null` when the source
+ * is outside the source root or is not an exported extension.
+ */
+export declare const getRelativeOutputPath: (sourceFilePath: string, options: ResolvedPathOptions) => string | null;
+/** The absolute output path, or `null` when the source is not exported. */
+export declare const getOutputPath: (sourceFilePath: string, options: ResolvedPathOptions) => string | null;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,mBAAmB,SAAS,CAAA;AACzC,eAAO,MAAM,mBAAmB,eAAe,CAAA;AAC/C,eAAO,MAAM,kBAAkB,UAAW,CAAA;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,GAAG;IACrE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,UAAS,WAAgB,KACxB,mBAoBF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,MAAM,EACtB,SAAS,mBAAmB,KAC3B,MAAM,GAAG,IAoBX,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,aAAa,GACxB,gBAAgB,MAAM,EACtB,SAAS,mBAAmB,KAC3B,MAAM,GAAG,IAMX,CAAA"}

package/dist/node/paths.js

@@ -0,0 +1,54 @@
+/**
+ * Maps a source document path onto its output path.
+ *
+ * The mapping is described with a source root and an output root rather than a
+ * glob, so it stays serializable and needs no matcher dependency.
+ */
+import path from "node:path";
+export const DEFAULT_SOURCE_ROOT = "docs";
+export const DEFAULT_OUTPUT_ROOT = ".cudoc/ast";
+export const DEFAULT_EXTENSIONS = [".mdx"];
+export const resolvePathOptions = (options = {}) => {
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    if (!Array.isArray(extensions) ||
+        extensions.length === 0 ||
+        !extensions.every((value) => typeof value === "string" && value.startsWith("."))) {
+        throw new TypeError('extensions must be a non-empty array of strings starting with "."');
+    }
+    return {
+        sourceRoot: options.sourceRoot ?? DEFAULT_SOURCE_ROOT,
+        outDir: options.outDir ?? DEFAULT_OUTPUT_ROOT,
+        extensions: extensions.map((value) => value.toLowerCase()),
+        cwd: options.cwd,
+    };
+};
+/**
+ * The path of the output file relative to `outDir`, or `null` when the source
+ * is outside the source root or is not an exported extension.
+ */
+export const getRelativeOutputPath = (sourceFilePath, options) => {
+    const projectRoot = options.cwd ?? process.cwd();
+    const sourceRoot = path.resolve(projectRoot, options.sourceRoot);
+    const resolvedSource = path.resolve(projectRoot, sourceFilePath);
+    const relativeSource = path.relative(sourceRoot, resolvedSource);
+    const outsideSourceRoot = relativeSource === "" ||
+        relativeSource === ".." ||
+        relativeSource.startsWith(`..${path.sep}`) ||
+        path.isAbsolute(relativeSource);
+    if (outsideSourceRoot)
+        return null;
+    if (!options.extensions.includes(path.extname(relativeSource).toLowerCase())) {
+        return null;
+    }
+    const parsed = path.parse(relativeSource);
+    return path.join(parsed.dir, `${parsed.name}.json`);
+};
+/** The absolute output path, or `null` when the source is not exported. */
+export const getOutputPath = (sourceFilePath, options) => {
+    const relativeOutputPath = getRelativeOutputPath(sourceFilePath, options);
+    if (!relativeOutputPath)
+        return null;
+    const projectRoot = options.cwd ?? process.cwd();
+    return path.join(projectRoot, options.outDir, relativeOutputPath);
+};
+//# sourceMappingURL=paths.js.map

package/dist/node/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,CAAC,CAAA;AAiB1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,UAAuB,EAAE,EACJ,EAAE;IACvB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAA;IAC3D,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAC1B,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,UAAU,CAAC,KAAK,CACf,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAC9D,EACD,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,mEAAmE,CACpE,CAAA;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;QACrD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,mBAAmB;QAC7C,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1D,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,cAAsB,EACtB,OAA4B,EACb,EAAE;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAChE,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAChE,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAChE,MAAM,iBAAiB,GACrB,cAAc,KAAK,EAAE;QACrB,cAAc,KAAK,IAAI;QACvB,cAAc,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;IAEjC,IAAI,iBAAiB;QAAE,OAAO,IAAI,CAAA;IAClC,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC,EACxE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,OAAO,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,cAAsB,EACtB,OAA4B,EACb,EAAE;IACjB,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IACzE,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAA;IAEpC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;AACnE,CAAC,CAAA"}

package/dist/query.d.ts

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

package/dist/query.d.ts.map

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

package/dist/query.js

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

package/dist/query.js.map

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

package/dist/syntax.d.ts

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

package/dist/syntax.d.ts.map

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

package/dist/syntax.js

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

package/dist/syntax.js.map

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

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@cudoment/cudoc",
+  "version": "0.1.0",
+  "description": "Reusable document ASTs: validation, queries, export and loading for cross-document embedding.",
+  "keywords": [
+    "cudoc",
+    "mdast",
+    "mdx",
+    "markdown",
+    "ast",
+    "documentation"
+  ],
+  "homepage": "https://github.com/cudoment/cudoc/tree/main/packages/cudoc#readme",
+  "bugs": {
+    "url": "https://github.com/cudoment/cudoc/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cudoment/cudoc.git",
+    "directory": "packages/cudoc"
+  },
+  "license": "MIT",
+  "author": "cudoment",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./ast": {
+      "types": "./dist/ast.d.ts",
+      "default": "./dist/ast.js"
+    },
+    "./syntax": {
+      "types": "./dist/syntax.d.ts",
+      "default": "./dist/syntax.js"
+    },
+    "./mdx": {
+      "types": "./dist/mdx.d.ts",
+      "default": "./dist/mdx.js"
+    },
+    "./query": {
+      "types": "./dist/query.d.ts",
+      "default": "./dist/query.js"
+    },
+    "./embed": {
+      "types": "./dist/embed.d.ts",
+      "default": "./dist/embed.js"
+    },
+    "./node/export-ast": {
+      "types": "./dist/node/export-ast.d.ts",
+      "default": "./dist/node/export-ast.js"
+    },
+    "./node/load-ast-file": {
+      "types": "./dist/node/load-ast-file.d.ts",
+      "default": "./dist/node/load-ast-file.js"
+    },
+    "./node/paths": {
+      "types": "./dist/node/paths.d.ts",
+      "default": "./dist/node/paths.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "mdast-util-mdx-jsx": "^3.2.0",
+    "unist-util-visit": "^5.0.0",
+    "unified": "^11.0.5",
+    "vfile": "^6.0.3"
+  },
+  "peerDependencies": {
+    "@types/mdast": "^4.0.4"
+  },
+  "peerDependenciesMeta": {
+    "@types/mdast": {
+      "optional": true
+    }
+  }
+}