@lepid-labs/weft-core 0.1.0

package/dist/git.d.ts

@@ -0,0 +1,55 @@
+/** What a single history walk yields. Empty throughout when git cannot answer. */
+export interface FileHistory {
+    /** When each path last changed, as an ISO 8601 timestamp with offset. */
+    dates: Map<string, string>;
+    /**
+     * Every blob a path has ever held, under the name it goes by now.
+     *
+     * Two paths whose sets intersect held identical content at some point, which
+     * is what makes divergence detectable after the copies stop matching — the
+     * moment a plain hash comparison goes quiet.
+     */
+    blobs: Map<string, Set<string>>;
+    /**
+     * Where a path moved to, resolved through the whole chain: a file renamed
+     * twice maps straight to its current name rather than to the intermediate.
+     */
+    renames: Map<string, string>;
+}
+/**
+ * Read `git log --raw` output into a file history.
+ *
+ * Split from the subprocess so the parse is testable without a repository.
+ * Paths arrive relative to the directory the log was run in, with forward
+ * slashes on every platform.
+ *
+ * The walk is newest-first, which is what makes the rename handling work: by
+ * the time an older commit mentions a path under its former name, the rename
+ * that renamed it has already been seen, so its blobs can be filed under the
+ * name the path goes by today.
+ */
+export declare function parseGitLog(output: string): FileHistory;
+/**
+ * How much of a walk to pay for.
+ *
+ * Rename detection compares file content across every commit, and dates do not
+ * need it: a rename names its destination path whether or not git pairs it with
+ * the source, so the newest commit touching a path is the same commit either
+ * way. `"dates"` skips `-M` and leaves {@link FileHistory.renames} empty;
+ * `"full"` pays it for the renames and cross-rename blob attribution that
+ * validation wants.
+ */
+export type HistoryDepth = "dates" | "full";
+/**
+ * What git knows about the files under `dir`, keyed by path relative to it.
+ *
+ * One history walk rather than a command per file or per question: the indexer
+ * wants a date for every document, and validation wants blobs and renames for
+ * all of them at once. Anything that stops git answering — no repository, no git
+ * on PATH, a directory outside the work tree — yields an empty history rather
+ * than an error, since none of this is worth failing an index over.
+ */
+export declare function fileHistory(dir: string, depth?: HistoryDepth): Promise<FileHistory>;
+/** When each file under `dir` was last committed. A view of {@link fileHistory}. */
+export declare function lastCommitDates(dir: string): Promise<Map<string, string>>;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAmBA,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC3B,yEAAyE;IACzE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B;;;;;;OAMG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC;;;OAGG;IACH,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA4DvD;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,YAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiCjG;AAED,oFAAoF;AACpF,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE/E"}

package/dist/git.js

@@ -0,0 +1,127 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const run = promisify(execFile);
+/**
+ * Marks a commit line in the log output.
+ *
+ * A NUL, because it is the one byte a path cannot contain: with a printable
+ * prefix, a document called `commit notes.md` would be read as a date.
+ */
+const DATE_MARK = String.fromCharCode(0);
+/** History can be long, and a truncated log would silently lose dates. */
+const MAX_OUTPUT_BYTES = 64 * 1024 * 1024;
+/** An all-zero object id, which `--raw` writes for the missing side of an add or a delete. */
+const ABSENT_BLOB = /^0+$/;
+/**
+ * Read `git log --raw` output into a file history.
+ *
+ * Split from the subprocess so the parse is testable without a repository.
+ * Paths arrive relative to the directory the log was run in, with forward
+ * slashes on every platform.
+ *
+ * The walk is newest-first, which is what makes the rename handling work: by
+ * the time an older commit mentions a path under its former name, the rename
+ * that renamed it has already been seen, so its blobs can be filed under the
+ * name the path goes by today.
+ */
+export function parseGitLog(output) {
+    const dates = new Map();
+    const blobs = new Map();
+    const renames = new Map();
+    let date;
+    /** The name a path goes by now, following any renames already seen. */
+    const currentName = (path) => renames.get(path) ?? path;
+    const record = (path, ...candidates) => {
+        if (!date)
+            return;
+        const name = currentName(path);
+        // git walks newest first, so the first commit naming a path is the one
+        // that last touched it.
+        if (!dates.has(name))
+            dates.set(name, date);
+        let held = blobs.get(name);
+        if (!held) {
+            held = new Set();
+            blobs.set(name, held);
+        }
+        for (const blob of candidates) {
+            if (blob && !ABSENT_BLOB.test(blob))
+                held.add(blob);
+        }
+    };
+    for (const line of output.split("\n")) {
+        const text = line.replace(/\r$/, "");
+        if (!text)
+            continue;
+        if (text.startsWith(DATE_MARK)) {
+            date = text.slice(DATE_MARK.length);
+            continue;
+        }
+        // Anything else is a --raw entry:
+        //   :<mode> <mode> <old blob> <new blob> <status>\t<path>
+        // with a second path appended for a rename.
+        if (!text.startsWith(":"))
+            continue;
+        const fields = text.split("\t");
+        const [, , oldBlob, newBlob] = fields[0].split(" ");
+        const from = fields[1];
+        const to = fields[2];
+        if (!from)
+            continue;
+        if (to) {
+            // Note the rename before recording anything, so every older commit
+            // still to come under the source name files its blobs against the
+            // destination. That is what carries a document's history across a
+            // rename instead of stranding it under a path nothing points at.
+            // Resolving the destination first collapses a chain of renames.
+            renames.set(from, currentName(to));
+        }
+        record(to ?? from, oldBlob, newBlob);
+    }
+    return { dates, blobs, renames };
+}
+/**
+ * What git knows about the files under `dir`, keyed by path relative to it.
+ *
+ * One history walk rather than a command per file or per question: the indexer
+ * wants a date for every document, and validation wants blobs and renames for
+ * all of them at once. Anything that stops git answering — no repository, no git
+ * on PATH, a directory outside the work tree — yields an empty history rather
+ * than an error, since none of this is worth failing an index over.
+ */
+export async function fileHistory(dir, depth = "full") {
+    try {
+        const { stdout } = await run("git", [
+            // Without this, a path with a non-ASCII character comes back quoted
+            // and escaped, and would never match the file it names.
+            "-c",
+            "core.quotepath=false",
+            "log",
+            // Author date rather than committer date: a rebase or a cherry-pick
+            // rewrites the latter to the moment it ran, which would report every
+            // document on the branch as having changed today.
+            "--format=%x00%aI",
+            // Blob ids in full rather than abbreviated so two paths that held
+            // one blob compare equal.
+            "--raw",
+            "--no-abbrev",
+            // `--no-renames` rather than merely omitting `-M`: `diff.renames`
+            // defaults on, so a dates walk has to opt out explicitly to skip
+            // the content comparison it is trying not to pay for.
+            ...(depth === "full" ? ["-M"] : ["--no-renames"]),
+            // Paths relative to this directory, and only the ones under it.
+            "--relative",
+            "--",
+            ".",
+        ], { cwd: dir, maxBuffer: MAX_OUTPUT_BYTES, windowsHide: true });
+        return parseGitLog(stdout);
+    }
+    catch {
+        return { dates: new Map(), blobs: new Map(), renames: new Map() };
+    }
+}
+/** When each file under `dir` was last committed. A view of {@link fileHistory}. */
+export async function lastCommitDates(dir) {
+    return (await fileHistory(dir, "dates")).dates;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/git.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git.test.d.ts.map

package/dist/git.test.d.ts.map

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

package/dist/git.test.js

@@ -0,0 +1,198 @@
+import { execFileSync } from "node:child_process";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { fileHistory, lastCommitDates, parseGitLog } from "./git.js";
+/** The NUL the log format writes before each commit's date. */
+const MARK = String.fromCharCode(0);
+/** A readable stand-in for an object id. */
+const sha = (char) => char.repeat(40);
+const ZERO = sha("0");
+/** One `--raw` entry. A rename passes both paths. */
+function change(status, oldBlob, newBlob, ...paths) {
+    return `:100644 100644 ${oldBlob} ${newBlob} ${status}\t${paths.join("\t")}`;
+}
+function commit(date, ...entries) {
+    return [`${MARK}${date}`, "", ...entries].join("\n");
+}
+/** Commits are written newest-first, as git emits them. */
+function log(...commits) {
+    return `${commits.join("\n")}\n`;
+}
+const DAY = "2026-07-30T00:00:00Z";
+const EARLIER = "2026-01-02T00:00:00Z";
+describe("parseGitLog (dates)", () => {
+    it("maps each path to the commit that touched it", () => {
+        const { dates } = parseGitLog(log(commit(DAY, change("M", sha("a"), sha("b"), "README.md"), change("M", sha("c"), sha("d"), "guide.md"))));
+        expect(dates.get("README.md")).toBe(DAY);
+        expect(dates.get("guide.md")).toBe(DAY);
+    });
+    it("keeps the most recent commit for a path changed more than once", () => {
+        // git walks newest first, so the first commit naming a path wins.
+        const { dates } = parseGitLog(log(commit(DAY, change("M", sha("b"), sha("c"), "guide.md")), commit(EARLIER, change("M", sha("a"), sha("b"), "guide.md"), change("A", ZERO, sha("e"), "old.md"))));
+        expect(dates.get("guide.md")).toBe(DAY);
+        expect(dates.get("old.md")).toBe(EARLIER);
+    });
+    it("returns nothing for an empty log", () => {
+        expect(parseGitLog("").dates.size).toBe(0);
+    });
+    it("ignores entries listed before any commit", () => {
+        expect(parseGitLog(`${change("M", sha("a"), sha("b"), "stray.md")}\n`).dates.size).toBe(0);
+    });
+    it("reads a path that would look like a commit line under a printable marker", () => {
+        // The marker is a NUL precisely so a document called "commit notes.md"
+        // cannot be mistaken for one.
+        const { dates } = parseGitLog(log(commit(DAY, change("M", sha("a"), sha("b"), "commit notes.md"))));
+        expect(dates.get("commit notes.md")).toBe(DAY);
+    });
+    it("tolerates CRLF line endings", () => {
+        const crlf = log(commit(DAY, change("M", sha("a"), sha("b"), "guide.md"))).replace(/\n/g, "\r\n");
+        expect(parseGitLog(crlf).dates.get("guide.md")).toBe(DAY);
+    });
+    it("keeps a path with a space in it whole", () => {
+        const { dates } = parseGitLog(log(commit(DAY, change("M", sha("a"), sha("b"), "release notes/v2 draft.md"))));
+        expect(dates.has("release notes/v2 draft.md")).toBe(true);
+    });
+});
+describe("parseGitLog (blobs)", () => {
+    it("records both sides of a change, so a path's whole history is present", () => {
+        const { blobs } = parseGitLog(log(commit(DAY, change("M", sha("a"), sha("b"), "guide.md"))));
+        expect([...(blobs.get("guide.md") ?? [])].sort()).toEqual([sha("a"), sha("b")]);
+    });
+    it("accumulates across commits", () => {
+        const { blobs } = parseGitLog(log(commit(DAY, change("M", sha("b"), sha("c"), "guide.md")), commit(EARLIER, change("A", ZERO, sha("b"), "guide.md"))));
+        expect([...(blobs.get("guide.md") ?? [])].sort()).toEqual([sha("b"), sha("c")]);
+    });
+    it("ignores the all-zero id an add or a delete writes", () => {
+        const { blobs } = parseGitLog(log(commit(DAY, change("A", ZERO, sha("a"), "guide.md"))));
+        expect([...(blobs.get("guide.md") ?? [])]).toEqual([sha("a")]);
+    });
+    it("lets two paths that held one blob be told apart from two that never did", () => {
+        const { blobs } = parseGitLog(log(commit(DAY, change("M", sha("a"), sha("b"), "copy.md"), change("M", sha("a"), sha("c"), "original.md")), commit(EARLIER, change("M", sha("z"), sha("y"), "unrelated.md"))));
+        const copy = blobs.get("copy.md") ?? new Set();
+        const original = blobs.get("original.md") ?? new Set();
+        const unrelated = blobs.get("unrelated.md") ?? new Set();
+        expect([...copy].filter((b) => original.has(b))).toEqual([sha("a")]);
+        expect([...copy].filter((b) => unrelated.has(b))).toEqual([]);
+    });
+});
+describe("parseGitLog (renames)", () => {
+    it("records where a path moved to", () => {
+        const { renames } = parseGitLog(log(commit(DAY, change("R100", sha("a"), sha("a"), "old.md", "new.md"))));
+        expect(renames.get("old.md")).toBe("new.md");
+    });
+    it("collapses a chain of renames to the current name", () => {
+        // Newest first: b -> c is seen before a -> b, so a resolves straight to c.
+        const { renames } = parseGitLog(log(commit(DAY, change("R100", sha("b"), sha("b"), "b.md", "c.md")), commit(EARLIER, change("R100", sha("a"), sha("a"), "a.md", "b.md"))));
+        expect(renames.get("a.md")).toBe("c.md");
+        expect(renames.get("b.md")).toBe("c.md");
+    });
+    it("files a renamed path's earlier blobs under the name it goes by now", () => {
+        // Without this a moved document loses everything it was before the move,
+        // which is exactly the history divergence detection needs.
+        const { blobs } = parseGitLog(log(commit(DAY, change("R100", sha("b"), sha("b"), "old.md", "new.md")), commit(EARLIER, change("A", ZERO, sha("b"), "old.md"))));
+        expect(blobs.get("new.md")?.has(sha("b"))).toBe(true);
+        expect(blobs.has("old.md")).toBe(false);
+    });
+    it("dates a renamed path under its current name", () => {
+        const { dates } = parseGitLog(log(commit(DAY, change("R100", sha("b"), sha("b"), "old.md", "new.md")), commit(EARLIER, change("A", ZERO, sha("b"), "old.md"))));
+        expect(dates.get("new.md")).toBe(DAY);
+        expect(dates.has("old.md")).toBe(false);
+    });
+});
+describe("fileHistory", () => {
+    let repo;
+    beforeAll(() => {
+        repo = mkdtempSync(join(tmpdir(), "weft-git-"));
+        const git = (...args) => execFileSync("git", args, { cwd: repo, stdio: "ignore" });
+        git("init", "-q");
+        git("config", "user.email", "test@example.com");
+        git("config", "user.name", "Test");
+        git("config", "commit.gpgsign", "false");
+        // Dates are set explicitly: two commits made a moment apart would
+        // otherwise share a timestamp and prove nothing about which is newer.
+        writeFileSync(join(repo, "guide.md"), "# Guide\n");
+        git("add", "guide.md");
+        git("commit", "-q", "-m", "add guide", "--date", "2026-01-02T00:00:00+00:00");
+        writeFileSync(join(repo, "spec.md"), "# Spec\n");
+        git("add", "spec.md");
+        git("commit", "-q", "-m", "add spec", "--date", "2026-07-30T00:00:00+00:00");
+        // A real rename, so rename detection is exercised rather than simulated.
+        git("mv", "guide.md", "handbook.md");
+        git("commit", "-q", "-m", "rename guide", "--date", "2026-07-31T00:00:00+00:00");
+    });
+    afterAll(() => rmSync(repo, { recursive: true, force: true }));
+    it("dates every committed file", async () => {
+        const { dates } = await fileHistory(repo);
+        expect(dates.has("handbook.md")).toBe(true);
+        expect(dates.has("spec.md")).toBe(true);
+    });
+    it("gives a date that parses as a real instant", async () => {
+        const { dates } = await fileHistory(repo);
+        expect(Number.isNaN(Date.parse(dates.get("spec.md")))).toBe(false);
+    });
+    it("has no date for an uncommitted file", async () => {
+        writeFileSync(join(repo, "draft.md"), "# Draft\n");
+        expect((await fileHistory(repo)).dates.has("draft.md")).toBe(false);
+    });
+    it("records a real blob for every tracked file", async () => {
+        const { blobs } = await fileHistory(repo);
+        expect(blobs.get("spec.md")?.size).toBeGreaterThan(0);
+        for (const blob of blobs.get("spec.md") ?? [])
+            expect(blob).toMatch(/^[0-9a-f]{40}$/);
+    });
+    it("detects a rename git performed", async () => {
+        const { renames } = await fileHistory(repo);
+        expect(renames.get("guide.md")).toBe("handbook.md");
+    });
+    it("carries a renamed file's earlier history onto its new name", async () => {
+        const { blobs, dates } = await fileHistory(repo);
+        // The file existed as guide.md before the move; that history belongs to
+        // handbook.md now, and nothing should still be filed under the old name.
+        expect(blobs.has("guide.md")).toBe(false);
+        expect(dates.has("guide.md")).toBe(false);
+        expect(blobs.get("handbook.md")?.size).toBeGreaterThan(0);
+    });
+    it("dates a renamed file identically at either depth", async () => {
+        // A rename commit names its destination path whether or not git pairs it
+        // with the source, so skipping rename detection must not change a date.
+        const shallow = await fileHistory(repo, "dates");
+        const full = await fileHistory(repo, "full");
+        expect(shallow.dates.get("handbook.md")).toBe(full.dates.get("handbook.md"));
+        expect(shallow.dates.get("spec.md")).toBe(full.dates.get("spec.md"));
+    });
+    it("reports no renames at dates depth", async () => {
+        const { renames } = await fileHistory(repo, "dates");
+        expect(renames.size).toBe(0);
+    });
+    it("returns an empty history outside a repository rather than failing", async () => {
+        // A modification date is metadata worth having, never a reason to fail an
+        // index — a docs set unpacked from a tarball still has to build.
+        const loose = mkdtempSync(join(tmpdir(), "weft-nogit-"));
+        try {
+            const history = await fileHistory(loose);
+            expect(history.dates.size).toBe(0);
+            expect(history.blobs.size).toBe(0);
+            expect(history.renames.size).toBe(0);
+        }
+        finally {
+            rmSync(loose, { recursive: true, force: true });
+        }
+    });
+    it("returns an empty history for a directory that does not exist", async () => {
+        expect((await fileHistory(join(repo, "nope"))).dates.size).toBe(0);
+    });
+});
+describe("lastCommitDates", () => {
+    it("is the dates half of a file history", async () => {
+        const loose = mkdtempSync(join(tmpdir(), "weft-nogit-"));
+        try {
+            expect(await lastCommitDates(loose)).toEqual(new Map());
+        }
+        finally {
+            rmSync(loose, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=git.test.js.map

package/dist/git.test.js.map

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

package/dist/includes.d.ts

@@ -0,0 +1,53 @@
+import type { IncludeContributes, IncludeDefaults, IncludeHeadingShift, WeftEdge } from "./types.js";
+/**
+ * The edge type that means "this document renders that one inline".
+ *
+ * A convention rather than a new mechanism, like `DERIVES_FROM` — any string has
+ * always been a valid edge type. What it gains here is defined semantics: the
+ * renderer expands an edge of this type at render time, and `include-cycle`
+ * checks the graph they form stays acyclic.
+ */
+export declare const INCLUDES = "includes";
+export declare const HEADING_SHIFTS: readonly IncludeHeadingShift[];
+export declare const CONTRIBUTES_MODES: readonly IncludeContributes[];
+/**
+ * What an include edge means when it says nothing: headings fold into the
+ * including document's outline, and content is searchable only at its source.
+ */
+export declare const INCLUDE_DEFAULTS: Required<IncludeDefaults>;
+/**
+ * Stamp resolved include semantics onto every `includes` edge.
+ *
+ * Run at manifest build time so the defaults are resolved exactly once. A
+ * consumer of the manifest — the UI most of all, which has no config access —
+ * reads the edge and never has to know what the project's defaults were.
+ */
+export declare function applyIncludeDefaults(edges: WeftEdge[], defaults?: IncludeDefaults): WeftEdge[];
+/** An anchor-bounded slice of a Markdown document. */
+export interface SectionRange {
+    /** The sliced source text, ready to render. */
+    text: string;
+    /**
+     * Heading level the range starts at: the selected heading's level, or the
+     * shallowest heading in the document for a whole-document range. Absent when
+     * the document has no headings — there is nothing for `headingShift` to move.
+     */
+    baseLevel?: number;
+}
+/**
+ * Extract the section of a Markdown document an anchor selects.
+ *
+ * The range runs from the anchored heading to the next heading of the same or
+ * shallower level, exclusive — the section as a reader understands it. No
+ * anchor selects the whole document, the degenerate case of the same idea.
+ *
+ * Lives in core rather than the UI because a static `weft build` will need the
+ * identical slice server-side; the extraction has one home so the two renderers
+ * cannot disagree about where a section ends.
+ *
+ * Returns undefined when the anchor names no heading in the document. That the
+ * anchor is broken is `edge-anchor-missing`'s finding — the caller only needs
+ * to know there is nothing to expand.
+ */
+export declare function extractSection(content: string, anchor?: string): SectionRange | undefined;
+//# sourceMappingURL=includes.d.ts.map

package/dist/includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"includes.d.ts","sourceRoot":"","sources":["../src/includes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC,eAAO,MAAM,cAAc,EAAE,SAAS,mBAAmB,EAAqB,CAAC;AAC/E,eAAO,MAAM,iBAAiB,EAAE,SAAS,kBAAkB,EAAyB,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,eAAe,CAGtD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,QAAQ,EAAE,CAS9F;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAuBzF"}

package/dist/includes.js

@@ -0,0 +1,73 @@
+import { extractMarkdownAnchors } from "./anchors/markdown.js";
+/**
+ * The edge type that means "this document renders that one inline".
+ *
+ * A convention rather than a new mechanism, like `DERIVES_FROM` — any string has
+ * always been a valid edge type. What it gains here is defined semantics: the
+ * renderer expands an edge of this type at render time, and `include-cycle`
+ * checks the graph they form stays acyclic.
+ */
+export const INCLUDES = "includes";
+export const HEADING_SHIFTS = ["auto", "none"];
+export const CONTRIBUTES_MODES = ["source", "inline"];
+/**
+ * What an include edge means when it says nothing: headings fold into the
+ * including document's outline, and content is searchable only at its source.
+ */
+export const INCLUDE_DEFAULTS = {
+    headingShift: "auto",
+    contributes: "source",
+};
+/**
+ * Stamp resolved include semantics onto every `includes` edge.
+ *
+ * Run at manifest build time so the defaults are resolved exactly once. A
+ * consumer of the manifest — the UI most of all, which has no config access —
+ * reads the edge and never has to know what the project's defaults were.
+ */
+export function applyIncludeDefaults(edges, defaults) {
+    return edges.map((edge) => {
+        if (edge.type !== INCLUDES)
+            return edge;
+        return {
+            ...edge,
+            headingShift: edge.headingShift ?? defaults?.headingShift ?? INCLUDE_DEFAULTS.headingShift,
+            contributes: edge.contributes ?? defaults?.contributes ?? INCLUDE_DEFAULTS.contributes,
+        };
+    });
+}
+/**
+ * Extract the section of a Markdown document an anchor selects.
+ *
+ * The range runs from the anchored heading to the next heading of the same or
+ * shallower level, exclusive — the section as a reader understands it. No
+ * anchor selects the whole document, the degenerate case of the same idea.
+ *
+ * Lives in core rather than the UI because a static `weft build` will need the
+ * identical slice server-side; the extraction has one home so the two renderers
+ * cannot disagree about where a section ends.
+ *
+ * Returns undefined when the anchor names no heading in the document. That the
+ * anchor is broken is `edge-anchor-missing`'s finding — the caller only needs
+ * to know there is nothing to expand.
+ */
+export function extractSection(content, anchor) {
+    const headings = extractMarkdownAnchors(content).filter((a) => a.level !== undefined);
+    if (anchor === undefined || anchor === "" || anchor === "#") {
+        const levels = headings.map((h) => h.level);
+        return {
+            text: content,
+            ...(levels.length ? { baseLevel: Math.min(...levels) } : {}),
+        };
+    }
+    const slug = anchor.startsWith("#") ? anchor : `#${anchor}`;
+    const start = headings.find((h) => h.slug === slug);
+    if (!start || !start.line)
+        return undefined;
+    const level = start.level;
+    const next = headings.find((h) => h.line > start.line && h.level <= level);
+    const lines = content.split(/\r?\n/);
+    const text = lines.slice(start.line - 1, next?.line ? next.line - 1 : undefined).join("\n");
+    return { text, baseLevel: level };
+}
+//# sourceMappingURL=includes.js.map

package/dist/includes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"includes.js","sourceRoot":"","sources":["../src/includes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AAEnC,MAAM,CAAC,MAAM,cAAc,GAAmC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAkC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IAC1D,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,QAAQ;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAiB,EAAE,QAA0B;IACjF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO;YACN,GAAG,IAAI;YACP,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,QAAQ,EAAE,YAAY,IAAI,gBAAgB,CAAC,YAAY;YAC1F,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,EAAE,WAAW,IAAI,gBAAgB,CAAC,WAAW;SACtF,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAe;IAC9D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAEtF,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAe,CAAC,CAAC;QACtD,OAAO;YACN,IAAI,EAAE,OAAO;YACb,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAe,CAAC;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,IAAe,GAAI,KAAK,CAAC,IAAe,IAAK,CAAC,CAAC,KAAgB,IAAI,KAAK,CAClF,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}

package/dist/includes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=includes.test.d.ts.map

package/dist/includes.test.d.ts.map

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