contentbase 0.4.0 → 0.4.1

package/dist/document.js

@@ -0,0 +1,418 @@
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import remarkRehype from "remark-rehype";
+import rehypeStringify from "rehype-stringify";
+import yaml from "js-yaml";
+import { toString } from "mdast-util-to-string";
+import { kebabCase } from "./utils/inflect";
+import { AstQuery } from "./ast-query";
+import { NodeShortcuts } from "./node-shortcuts";
+import { stringifyAst } from "./utils/stringify-ast";
+import { normalizeHeadings } from "./utils/normalize-headings";
+import { parseTable } from "./utils/parse-table";
+import { stripMarkdown } from "./utils/strip-markdown";
+export class Document {
+    id;
+    collection;
+    #content;
+    #meta;
+    #ast;
+    constructor(options) {
+        this.id = options.id;
+        this.collection = options.collection;
+        this.#content = options.content;
+        this.#meta = options.meta ?? {};
+        this.#ast = options.ast ?? null;
+    }
+    // ─── Core getters ───
+    get meta() {
+        return this.#meta;
+    }
+    get content() {
+        return this.#content;
+    }
+    get ast() {
+        if (!this.#ast) {
+            this.#ast = this.processor.parse(this.#content);
+        }
+        return this.#ast;
+    }
+    get title() {
+        if (this.#meta.title)
+            return String(this.#meta.title);
+        const heading = this.astQuery.select("heading");
+        return heading ? toString(heading) : this.id;
+    }
+    get slug() {
+        return kebabCase(this.title.toLowerCase());
+    }
+    get createdAt() {
+        return this.collection.items.get(this.id)?.createdAt;
+    }
+    get updatedAt() {
+        return this.collection.items.get(this.id)?.updatedAt;
+    }
+    get size() {
+        return this.collection.items.get(this.id)?.size;
+    }
+    get rawContent() {
+        if (Object.keys(this.#meta).length === 0) {
+            return this.content;
+        }
+        const frontmatter = yaml.dump(this.#meta).trim();
+        return `---\n${frontmatter}\n---\n\n${this.content}`;
+    }
+    get path() {
+        return this.collection.resolve(this.id) + ".md";
+    }
+    // ─── Processor ───
+    /**
+     * Returns a unified processor configured for parsing markdown with GFM.
+     * This is intentionally NOT the MDX processor -- MDX compilation is a
+     * separate concern handled by plugins.
+     */
+    get processor() {
+        return unified().use(remarkParse).use(remarkGfm);
+    }
+    // ─── AST access ───
+    get astQuery() {
+        return new AstQuery(this.ast);
+    }
+    get nodes() {
+        return new NodeShortcuts(this.astQuery);
+    }
+    query(ast = this.ast) {
+        return new AstQuery(ast);
+    }
+    // ─── Section operations ───
+    /**
+     * Extract a section of the document, starting with a heading.
+     * Returns all nodes underneath the heading until another heading
+     * of the same depth is encountered, or the end of the document.
+     */
+    extractSection(startHeading) {
+        let heading;
+        if (typeof startHeading === "string") {
+            heading = this.astQuery.findHeadingByText(startHeading);
+            // If not found, try alternatives from the model definition's sections
+            if (!heading) {
+                heading = this.#resolveAlternativeHeading(startHeading);
+            }
+        }
+        else {
+            heading = startHeading;
+        }
+        if (!heading) {
+            throw new Error(`Heading not found: ${typeof startHeading === "string" ? startHeading : toString(startHeading)}`);
+        }
+        const endHeading = this.astQuery.findNextSiblingHeadingTo(heading);
+        const sectionNodes = endHeading
+            ? this.astQuery.findBetween(heading, endHeading)
+            : this.astQuery.findAllAfter(heading);
+        return [heading, ...sectionNodes];
+    }
+    /**
+     * Look up section alternatives from the model definition.
+     * If the requested heading matches a section's heading or is one of its alternatives,
+     * try all variants (primary + alternatives) until one is found in the AST.
+     */
+    #resolveAlternativeHeading(requestedHeading) {
+        const def = this.collection?.findModelDefinition?.(this.id);
+        if (!def?.sections)
+            return undefined;
+        for (const sectionDef of Object.values(def.sections)) {
+            const allNames = [sectionDef.heading, ...(sectionDef.alternatives ?? [])];
+            if (!allNames.some((n) => n === requestedHeading))
+                continue;
+            for (const name of allNames) {
+                const found = this.astQuery.findHeadingByText(name);
+                if (found)
+                    return found;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Returns an AstQuery scoped to the nodes underneath a particular heading,
+     * excluding the heading itself.
+     */
+    querySection(startHeading) {
+        let children = [];
+        try {
+            children = this.extractSection(startHeading).slice(1);
+        }
+        catch {
+            // Section not found: return empty query
+        }
+        return new AstQuery({
+            type: "root",
+            children: children,
+        });
+    }
+    // ─── Section mutations ───
+    /**
+     * Removes the nodes under the given heading from the AST.
+     * Returns a new Document by default. Pass { mutate: true } to modify in place.
+     */
+    removeSection(heading, opts = {}) {
+        const headingNode = typeof heading === "string"
+            ? this.astQuery.findHeadingByText(heading)
+            : heading;
+        if (!headingNode)
+            throw new Error(`Heading not found: ${heading}`);
+        const sectionNodes = this.extractSection(headingNode);
+        const newChildren = this.ast.children.filter((n) => !sectionNodes.includes(n));
+        if (opts.mutate) {
+            this.ast.children = newChildren;
+            this.#content = stringifyAst(this.ast);
+            return this;
+        }
+        const newAst = { type: "root", children: [...newChildren] };
+        return new Document({
+            id: this.id,
+            content: stringifyAst(newAst),
+            meta: { ...this.#meta },
+            collection: this.collection,
+            ast: newAst,
+        });
+    }
+    /**
+     * Replaces the content underneath a heading with new content.
+     */
+    replaceSectionContent(heading, nodesOrMarkdown, opts = {}) {
+        const headingNode = typeof heading === "string"
+            ? this.astQuery.findHeadingByText(heading)
+            : heading;
+        if (!headingNode)
+            throw new Error(`Heading not found: ${heading}`);
+        let newNodes;
+        if (typeof nodesOrMarkdown === "string") {
+            newNodes = this.processor.parse(nodesOrMarkdown)
+                .children;
+        }
+        else {
+            newNodes = nodesOrMarkdown;
+        }
+        const sectionNodes = this.extractSection(headingNode).slice(1);
+        const headingIndex = this.ast.children.indexOf(headingNode);
+        if (opts.mutate) {
+            this.ast.children.splice(headingIndex + 1, sectionNodes.length, ...newNodes);
+            this.#content = stringifyAst(this.ast);
+            return this;
+        }
+        const children = [...this.ast.children];
+        children.splice(headingIndex + 1, sectionNodes.length, ...newNodes);
+        const newAst = { type: "root", children };
+        return new Document({
+            id: this.id,
+            content: stringifyAst(newAst),
+            meta: { ...this.#meta },
+            collection: this.collection,
+            ast: newAst,
+        });
+    }
+    /** Insert new content before a given node. */
+    insertBefore(node, nodesOrMarkdown, opts = {}) {
+        let newNodes;
+        if (typeof nodesOrMarkdown === "string") {
+            newNodes = this.processor.parse(nodesOrMarkdown)
+                .children;
+        }
+        else {
+            newNodes = nodesOrMarkdown;
+        }
+        const index = this.ast.children.indexOf(node);
+        if (opts.mutate) {
+            this.ast.children.splice(index, 0, ...newNodes);
+            this.#content = stringifyAst(this.ast);
+            return this;
+        }
+        const children = [...this.ast.children];
+        children.splice(index, 0, ...newNodes);
+        const newAst = { type: "root", children };
+        return new Document({
+            id: this.id,
+            content: stringifyAst(newAst),
+            meta: { ...this.#meta },
+            collection: this.collection,
+            ast: newAst,
+        });
+    }
+    /** Insert new content after a given node. */
+    insertAfter(node, nodesOrMarkdown, opts = {}) {
+        let newNodes;
+        if (typeof nodesOrMarkdown === "string") {
+            newNodes = this.processor.parse(nodesOrMarkdown)
+                .children;
+        }
+        else {
+            newNodes = nodesOrMarkdown;
+        }
+        const index = this.ast.children.indexOf(node);
+        if (opts.mutate) {
+            this.ast.children.splice(index + 1, 0, ...newNodes);
+            this.#content = stringifyAst(this.ast);
+            return this;
+        }
+        const children = [...this.ast.children];
+        children.splice(index + 1, 0, ...newNodes);
+        const newAst = { type: "root", children };
+        return new Document({
+            id: this.id,
+            content: stringifyAst(newAst),
+            meta: { ...this.#meta },
+            collection: this.collection,
+            ast: newAst,
+        });
+    }
+    /** Append new content at the end of a section. */
+    appendToSection(heading, nodesOrMarkdown, opts = {}) {
+        const headingNode = typeof heading === "string"
+            ? this.astQuery.findHeadingByText(heading)
+            : heading;
+        if (!headingNode)
+            throw new Error(`Heading not found: ${heading}`);
+        let newNodes;
+        if (typeof nodesOrMarkdown === "string") {
+            newNodes = this.processor.parse(nodesOrMarkdown)
+                .children;
+        }
+        else {
+            newNodes = nodesOrMarkdown;
+        }
+        const sectionNodes = this.extractSection(headingNode);
+        const lastNode = sectionNodes[sectionNodes.length - 1];
+        const lastIndex = this.ast.children.indexOf(lastNode);
+        if (opts.mutate) {
+            this.ast.children.splice(lastIndex + 1, 0, ...newNodes);
+            this.#content = stringifyAst(this.ast);
+            return this;
+        }
+        const children = [...this.ast.children];
+        children.splice(lastIndex + 1, 0, ...newNodes);
+        const newAst = { type: "root", children };
+        return new Document({
+            id: this.id,
+            content: stringifyAst(newAst),
+            meta: { ...this.#meta },
+            collection: this.collection,
+            ast: newAst,
+        });
+    }
+    // ─── Content manipulation ───
+    replaceContent(content) {
+        return new Document({
+            id: this.id,
+            content,
+            meta: { ...this.#meta },
+            collection: this.collection,
+        });
+    }
+    appendContent(content) {
+        return new Document({
+            id: this.id,
+            content: this.#content + content,
+            meta: { ...this.#meta },
+            collection: this.collection,
+        });
+    }
+    /** Re-parse the AST from the current content. Mutable. */
+    rerenderAST(newContent = this.content) {
+        this.#content = newContent;
+        this.#ast = this.processor.parse(newContent);
+        return this;
+    }
+    /** Update content from the current AST state. Mutable. */
+    reloadFromAST(newAst = this.ast) {
+        this.#ast = newAst;
+        this.#content = stringifyAst(newAst);
+        return this;
+    }
+    stringify(ast = this.ast) {
+        return stringifyAst(ast);
+    }
+    normalizeHeadings() {
+        normalizeHeadings(this.ast);
+        this.#content = stringifyAst(this.ast);
+        return this;
+    }
+    // ─── Serialization ───
+    toJSON() {
+        return {
+            id: this.id,
+            meta: this.meta,
+            content: this.content,
+            ast: this.ast,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+            size: this.size,
+        };
+    }
+    stripMarkdown(options) {
+        return stripMarkdown(this.ast, options);
+    }
+    toText(filterFn = () => true) {
+        return this.ast.children
+            .filter(filterFn)
+            .map((n) => toString(n))
+            .join("\n");
+    }
+    /**
+     * Returns an indented text outline of the document's headings.
+     * Each heading is indented based on its depth relative to the
+     * minimum heading depth found in the document.
+     */
+    async toHtml() {
+        const result = await unified()
+            .use(remarkParse)
+            .use(remarkGfm)
+            .use(remarkRehype)
+            .use(rehypeStringify)
+            .process(this.content);
+        return String(result);
+    }
+    toOutline() {
+        const headings = this.ast.children.filter((n) => n.type === "heading");
+        if (headings.length === 0)
+            return "";
+        const minDepth = Math.min(...headings.map((h) => h.depth));
+        return headings
+            .map((h) => {
+            const indent = "  ".repeat(h.depth - minDepth);
+            return `${indent}- ${toString(h)}`;
+        })
+            .join("\n");
+    }
+    // ─── Utility access ───
+    get utils() {
+        return {
+            kebabCase,
+            toString,
+            stringifyAst,
+            parseTable,
+            normalizeHeadings,
+            extractSection: (heading) => this.extractSection(heading),
+            createNewAst: (children = []) => ({ type: "root", children }),
+        };
+    }
+    // ─── Persistence ───
+    async save(options = {}) {
+        if (options.normalize !== false) {
+            this.normalizeHeadings();
+        }
+        await this.collection.saveItem(this.id, {
+            content: this.rawContent,
+            extension: options.extension,
+        });
+        return this;
+    }
+    async reload() {
+        const item = await this.collection.readItem(this.id);
+        this.#content = item.content;
+        this.#meta = item.meta;
+        this.#ast = null; // Will be lazily re-parsed
+        return this;
+    }
+}
+//# sourceMappingURL=document.js.map

package/dist/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,eAAe,MAAM,kBAAkB,CAAC;AAC/C,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAavD,MAAM,OAAO,QAAQ;IACV,EAAE,CAAS;IACX,UAAU,CAAa;IAEhC,QAAQ,CAAS;IACjB,KAAK,CAA0B;IAC/B,IAAI,CAAc;IAElB,YAAY,OAAwB;QAClC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;IAClC,CAAC;IAED,uBAAuB;IAEvB,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI,GAAG;QACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,IAAI;QACN,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACvD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACvD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;IAClD,CAAC;IAED,IAAI,UAAU;QACZ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,QAAQ,WAAW,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IAClD,CAAC;IAED,oBAAoB;IAEpB;;;;OAIG;IACH,IAAI,SAAS;QACX,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,qBAAqB;IAErB,IAAI,QAAQ;QACV,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAY,IAAI,CAAC,GAAG;QACxB,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,6BAA6B;IAE7B;;;;OAIG;IACH,cAAc,CAAC,YAA8B;QAC3C,IAAI,OAA4B,CAAC;QACjC,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,YAAY,CAEzC,CAAC;YAEd,sEAAsE;YACtE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,YAAY,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,sBAAsB,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CACjG,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,OAAc,CAAC,CAAC;QAC1E,MAAM,YAAY,GAAG,UAAU;YAC7B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC;YAChD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,0BAA0B,CAAC,gBAAwB;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,mBAAmB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,EAAE,QAAQ;YAAE,OAAO,SAAS,CAAC;QAErC,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAU,EAAE,CAAC;YAC9D,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,gBAAgB,CAAC;gBAAE,SAAS;YAEpE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAwB,CAAC;gBAC3E,IAAI,KAAK;oBAAE,OAAO,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,YAA8B;QACzC,IAAI,QAAQ,GAAc,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC;YAClB,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,QAAyB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,4BAA4B;IAE5B;;;OAGG;IACH,aAAa,CACX,OAAyB,EACzB,OAA6B,EAAE;QAE/B,MAAM,WAAW,GACf,OAAO,OAAO,KAAK,QAAQ;YACzB,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAyB;YACnE,CAAC,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAEnE,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAY,CAAC,CAC5C,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,CAAC,GAAW,CAAC,QAAQ,GAAG,WAAW,CAAC;YACzC,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,qBAAqB,CACnB,OAAyB,EACzB,eAAmC,EACnC,OAA6B,EAAE;QAE/B,MAAM,WAAW,GACf,OAAO,OAAO,KAAK,QAAQ;YACzB,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAyB;YACnE,CAAC,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAEnE,IAAI,QAAuB,CAAC;QAC5B,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC;iBAC7C,QAAyB,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,eAAgC,CAAC;QAC9C,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,WAA0B,CAAC,CAAC;QAE3E,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CACtB,YAAY,GAAG,CAAC,EAChB,YAAY,CAAC,MAAM,EACnB,GAAG,QAAQ,CACZ,CAAC;YACF,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC;QACpE,MAAM,MAAM,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;IACL,CAAC;IAED,8CAA8C;IAC9C,YAAY,CACV,IAAa,EACb,eAAmC,EACnC,OAA6B,EAAE;QAE/B,IAAI,QAAuB,CAAC;QAC5B,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC;iBAC7C,QAAyB,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,eAAgC,CAAC;QAC9C,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAmB,CAAC,CAAC;QAE7D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;QACvC,MAAM,MAAM,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,WAAW,CACT,IAAa,EACb,eAAmC,EACnC,OAA6B,EAAE;QAE/B,IAAI,QAAuB,CAAC;QAC5B,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC;iBAC7C,QAAyB,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,eAAgC,CAAC;QAC9C,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAmB,CAAC,CAAC;QAE7D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;IACL,CAAC;IAED,kDAAkD;IAClD,eAAe,CACb,OAAyB,EACzB,eAAmC,EACnC,OAA6B,EAAE;QAE/B,MAAM,WAAW,GACf,OAAO,OAAO,KAAK,QAAQ;YACzB,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAyB;YACnE,CAAC,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAEnE,IAAI,QAAuB,CAAC;QAC5B,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC;iBAC7C,QAAyB,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,eAAgC,CAAC;QAC9C,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAuB,CAAC,CAAC;QAErE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;YACxD,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B;IAE/B,cAAc,CAAC,OAAe;QAC5B,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO;YACP,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,OAAe;QAC3B,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO;YAChC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,0DAA0D;IAC1D,WAAW,CAAC,aAAqB,IAAI,CAAC,OAAO;QAC3C,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,aAAa,CAAC,SAAe,IAAI,CAAC,GAAG;QACnC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,MAAY,IAAI,CAAC,GAAG;QAC5B,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,iBAAiB;QACf,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IAExB,MAAM;QASJ,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,OAA8B;QAC1C,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CACJ,WAAuC,GAAG,EAAE,CAAC,IAAI;QAEjD,OAAQ,IAAI,CAAC,GAAG,CAAC,QAAsB;aACpC,MAAM,CAAC,QAAQ,CAAC;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;aACvB,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE;aAC3B,GAAG,CAAC,WAAW,CAAC;aAChB,GAAG,CAAC,SAAS,CAAC;aACd,GAAG,CAAC,YAAY,CAAC;aACjB,GAAG,CAAC,eAAe,CAAC;aACpB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,SAAS;QACP,MAAM,QAAQ,GAAI,IAAI,CAAC,GAAG,CAAC,QAAsB,CAAC,MAAM,CACtD,CAAC,CAAC,EAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAC1C,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAE3D,OAAO,QAAQ;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC;YAC/C,OAAO,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,yBAAyB;IAEzB,IAAI,KAAK;QACP,OAAO;YACL,SAAS;YACT,QAAQ;YACR,YAAY;YACZ,UAAU;YACV,iBAAiB;YACjB,cAAc,EAAE,CAAC,OAAyB,EAAE,EAAE,CAC5C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YAC9B,YAAY,EAAE,CAAC,WAA0B,EAAE,EAAE,EAAE,CAC7C,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,CAAS;SAChD,CAAC;IACJ,CAAC;IAED,sBAAsB;IAEtB,KAAK,CAAC,IAAI,CACR,UAAuD,EAAE;QAEzD,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE;YACtC,OAAO,EAAE,IAAI,CAAC,UAAU;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,2BAA2B;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/extract-sections.d.ts

@@ -0,0 +1,46 @@
+import type { Content } from "mdast";
+import type { ParsedDocument } from "./parse";
+/** Any object that exposes a title and section extraction — satisfied by both Document and ParsedDocument. */
+export type SectionSource = {
+    title: string;
+    extractSection(heading: string | Content): Content[];
+};
+export interface ExtractionEntry {
+    /** The source document or parsed document */
+    source: SectionSource;
+    /** Section heading name(s) to extract. A string extracts one section; an array extracts multiple. */
+    sections: string | string[];
+}
+export interface ExtractSectionsOptions {
+    /** Optional title for the combined document (becomes an h1). */
+    title?: string;
+    /**
+     * How to organize extracted sections.
+     * - `"grouped"` (default): Each source document gets a heading (its title),
+     *   with extracted sections nested underneath.
+     * - `"flat"`: All extracted sections are placed sequentially with no source grouping.
+     */
+    mode?: "grouped" | "flat";
+    /**
+     * What to do when a requested section is not found in a source document.
+     * - `"skip"` (default): silently omit the missing section
+     * - `"throw"`: throw an error
+     */
+    onMissing?: "skip" | "throw";
+}
+/**
+ * Extract named sections from multiple documents into a single combined document.
+ *
+ * @example
+ * ```ts
+ * const combined = extractSections([
+ *   { source: doc1, sections: "Acceptance Criteria" },
+ *   { source: doc2, sections: ["Acceptance Criteria", "Mockups"] },
+ * ], {
+ *   title: "All Acceptance Criteria",
+ *   mode: "grouped",
+ * });
+ * ```
+ */
+export declare function extractSections(entries: ExtractionEntry[], options?: ExtractSectionsOptions): ParsedDocument;
+//# sourceMappingURL=extract-sections.d.ts.map

package/dist/extract-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-sections.d.ts","sourceRoot":"","sources":["../src/extract-sections.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAQ,OAAO,EAAwB,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,8GAA8G;AAC9G,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;CACtD,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,MAAM,EAAE,aAAa,CAAC;IACtB,qGAAqG;IACrG,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AA8HD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,GAAE,sBAA2B,GACnC,cAAc,CA2ChB"}

package/dist/extract-sections.js

@@ -0,0 +1,153 @@
+import { toString } from "mdast-util-to-string";
+import { AstQuery } from "./ast-query";
+import { NodeShortcuts } from "./node-shortcuts";
+import { stringifyAst } from "./utils/stringify-ast";
+import { stripMarkdown } from "./utils/strip-markdown";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function createHeadingNode(text, depth) {
+    return {
+        type: "heading",
+        depth,
+        children: [{ type: "text", value: text }],
+    };
+}
+function clampDepth(d) {
+    return Math.max(1, Math.min(6, d));
+}
+/** Deep-clone section nodes and shift all heading depths to the target depth. */
+function cloneAndShiftHeadings(nodes, targetDepth) {
+    if (nodes.length === 0)
+        return [];
+    const firstNode = nodes[0];
+    const originalDepth = firstNode.type === "heading" ? firstNode.depth : 1;
+    const depthShift = targetDepth - originalDepth;
+    const cloned = structuredClone(nodes);
+    if (depthShift !== 0) {
+        for (const node of cloned) {
+            if (node.type === "heading") {
+                node.depth = clampDepth(node.depth + depthShift);
+            }
+        }
+    }
+    return cloned;
+}
+function tryExtractSection(source, sectionName, onMissing) {
+    try {
+        return source.extractSection(sectionName);
+    }
+    catch (err) {
+        if (onMissing === "throw")
+            throw err;
+        return null;
+    }
+}
+function normalizeSections(sections) {
+    return Array.isArray(sections) ? sections : [sections];
+}
+/** Build a fully queryable ParsedDocument from an AST root (mirrors parse.ts). */
+function buildParsedDocument(ast) {
+    const astQuery = new AstQuery(ast);
+    const nodes = new NodeShortcuts(astQuery);
+    const firstHeading = astQuery.select("heading");
+    const title = firstHeading ? toString(firstHeading) : "";
+    const content = stringifyAst(ast);
+    function extractSection(startHeading) {
+        let heading;
+        if (typeof startHeading === "string") {
+            heading = astQuery.findHeadingByText(startHeading);
+        }
+        else {
+            heading = startHeading;
+        }
+        if (!heading) {
+            throw new Error(`Heading not found: ${typeof startHeading === "string" ? startHeading : toString(startHeading)}`);
+        }
+        const endHeading = astQuery.findNextSiblingHeadingTo(heading);
+        const sectionNodes = endHeading
+            ? astQuery.findBetween(heading, endHeading)
+            : astQuery.findAllAfter(heading);
+        return [heading, ...sectionNodes];
+    }
+    function querySection(startHeading) {
+        let children = [];
+        try {
+            children = extractSection(startHeading).slice(1);
+        }
+        catch {
+            // Section not found: return empty query
+        }
+        return new AstQuery({
+            type: "root",
+            children: children,
+        });
+    }
+    return {
+        meta: {},
+        content,
+        ast,
+        astQuery,
+        nodes,
+        title,
+        stringify: (tree = ast) => stringifyAst(tree),
+        stripMarkdown: (options) => stripMarkdown(ast, options),
+        extractSection,
+        querySection,
+    };
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+/**
+ * Extract named sections from multiple documents into a single combined document.
+ *
+ * @example
+ * ```ts
+ * const combined = extractSections([
+ *   { source: doc1, sections: "Acceptance Criteria" },
+ *   { source: doc2, sections: ["Acceptance Criteria", "Mockups"] },
+ * ], {
+ *   title: "All Acceptance Criteria",
+ *   mode: "grouped",
+ * });
+ * ```
+ */
+export function extractSections(entries, options = {}) {
+    const { title, mode = "grouped", onMissing = "skip" } = options;
+    const combinedChildren = [];
+    let baseDepth = 1;
+    if (title) {
+        combinedChildren.push(createHeadingNode(title, 1));
+        baseDepth = 2;
+    }
+    for (const entry of entries) {
+        const { source } = entry;
+        const sectionNames = normalizeSections(entry.sections);
+        if (mode === "grouped") {
+            const sourceTitle = source.title || "(Untitled)";
+            combinedChildren.push(createHeadingNode(sourceTitle, clampDepth(baseDepth)));
+            const sectionTargetDepth = baseDepth + 1;
+            for (const sectionName of sectionNames) {
+                const sectionNodes = tryExtractSection(source, sectionName, onMissing);
+                if (!sectionNodes)
+                    continue;
+                const shifted = cloneAndShiftHeadings(sectionNodes, sectionTargetDepth);
+                combinedChildren.push(...shifted);
+            }
+        }
+        else {
+            // flat mode
+            for (const sectionName of sectionNames) {
+                const sectionNodes = tryExtractSection(source, sectionName, onMissing);
+                if (!sectionNodes)
+                    continue;
+                const shifted = cloneAndShiftHeadings(sectionNodes, baseDepth);
+                combinedChildren.push(...shifted);
+            }
+        }
+    }
+    const ast = { type: "root", children: combinedChildren };
+    return buildParsedDocument(ast);
+}
+//# sourceMappingURL=extract-sections.js.map

package/dist/extract-sections.js.map

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