@intentius/chant 0.124.26 → 0.124.28

package/dist/change-set-graph.js

@@ -0,0 +1,128 @@
+/**
+ * Place a change set's entries on the graph (#4022).
+ *
+ * A reader such as behold draws the graph `chant graph --format ir` and
+ * `chant workspace graph` print, and wants each change of a change set on the
+ * node it changes. The planner's address is not that node's id: a terraform
+ * plan names an instance, `module.app.terraform_data.instance[0]`, where the
+ * graph has one node per block, `<root>/module.app/terraform_data.instance`
+ * (the terraform lexicon's entity key, `hcl/parse.ts`). So chant maps the
+ * address itself, against the node ids of the graph it read, and a reader
+ * never derives an id.
+ *
+ * {@link changeSetNodeCandidates} lists the ids an entry's address can have,
+ * by planner. {@link mapChangeSetToGraph} keeps the first that the graph
+ * holds and puts the member's name in front, as `chant workspace graph`
+ * does. An entry whose address the graph does not hold gets `node: null`:
+ * a delete of a block the source no longer declares, or a warden or sql
+ * change outside the graph.
+ *
+ * Like `./change-set.ts`, this imports nothing at run time, so it bundles
+ * into one file with the change-set code.
+ */
+/**
+ * Split a terraform address into its dot-separated parts, dropping every
+ * `[...]` index. A quoted key may hold `.` or `]`, so quotes are honoured.
+ */
+function terraformParts(address) {
+    const parts = [];
+    let current = "";
+    let depth = 0;
+    let quoted = false;
+    for (let i = 0; i < address.length; i++) {
+        const c = address[i];
+        if (depth > 0) {
+            if (quoted) {
+                if (c === "\\")
+                    i++;
+                else if (c === '"')
+                    quoted = false;
+            }
+            else if (c === '"')
+                quoted = true;
+            else if (c === "]")
+                depth--;
+            continue;
+        }
+        if (c === "[")
+            depth++;
+        else if (c === ".") {
+            parts.push(current);
+            current = "";
+        }
+        else
+            current += c;
+    }
+    parts.push(current);
+    return parts.filter((p) => p.length > 0);
+}
+/**
+ * The block key the terraform lexicon gives an address in its root:
+ * `module.<call>/` for each module call, then the block's own address with
+ * no index. `module.app.terraform_data.instance[0]` is
+ * `module.app/terraform_data.instance`.
+ */
+export function terraformBlockKey(address) {
+    const parts = terraformParts(address);
+    const scope = [];
+    let i = 0;
+    while (parts[i] === "module" && i + 1 < parts.length) {
+        scope.push(`module.${parts[i + 1]}`);
+        i += 2;
+    }
+    const rest = parts.slice(i);
+    let block;
+    if (rest[0] === "data" && rest.length >= 3)
+        block = `data.${rest[1]}.${rest[2]}`;
+    else if (rest.length >= 2)
+        block = `${rest[0]}.${rest[1]}`;
+    else if (rest.length === 0 && scope.length > 0) {
+        // The module call itself is a block of its caller.
+        const call = scope.pop();
+        block = call;
+    }
+    if (block === undefined)
+        return undefined;
+    return [...scope, block].join("/");
+}
+/**
+ * The ids, in the order tried, that an entry's address can have in its
+ * member's graph IR:
+ *
+ * - `chant`: the address, which is the entity name the IR uses as its id.
+ * - `terraform`, `tofu`, `choudoufu`: `<root>/<block key>`, the root being
+ *   the change-set member (`terraformBlockKey`), then the address.
+ * - `warden`, `sql`: the address.
+ */
+export function changeSetNodeCandidates(entry) {
+    switch (entry.planner) {
+        case "terraform":
+        case "tofu":
+        case "choudoufu": {
+            const key = terraformBlockKey(entry.address);
+            return key === undefined ? [entry.address] : [`${entry.member}/${key}`, entry.address];
+        }
+        default:
+            return [entry.address];
+    }
+}
+/**
+ * The document with each entry's `node` set from `graph`, and `graph`
+ * recording which graph it was. A null `graph` (none could be read) gives
+ * every entry `node: null`. The digest is unchanged: `node` is not hashed.
+ */
+export function mapChangeSetToGraph(doc, graph) {
+    if (graph === null) {
+        return { ...doc, entries: doc.entries.map((e) => ({ ...e, node: null })), graph: null };
+    }
+    const ids = new Set(graph.ids);
+    const prefix = graph.member ? `${graph.member}/` : "";
+    return {
+        ...doc,
+        entries: doc.entries.map((e) => {
+            const id = changeSetNodeCandidates(e).find((c) => ids.has(c));
+            return { ...e, node: id === undefined ? null : `${prefix}${id}` };
+        }),
+        graph: { member: graph.member, at: graph.at },
+    };
+}

package/dist/change-set.d.ts

@@ -102,6 +102,15 @@ export interface ChangeSetEntry {
     /** The estate, environment or org the change lands in. */
     scope?: string;
     attributes: ChangeSetAttribute[];
+    /**
+     * The graph node the entry changes, as `chant graph --format ir` and
+     * `chant workspace graph` name it (#4022): `<member>/<id>` inside a
+     * workspace. Null when the graph holds no node for the address, such as
+     * a delete of a block the source no longer declares. Absent until the
+     * document is mapped onto a graph (`./change-set-graph.ts`), and never
+     * part of the digest.
+     */
+    node?: string | null;
 }
 /** Something a planner could not read, so the plan says nothing about it. */
 export interface ChangeSetHole {
@@ -182,6 +191,29 @@ export interface ChangeSetDocument {
     /** Triggered actions, sorted by member and address. Absent when no member runs one. */
     sideEffects?: ChangeSetSideEffect[];
     summary: ChangeSetSummary;
+    /**
+     * The graph the entries' `node` ids come from (#4022): the workspace member
+     * whose graph it is, or null outside a workspace, and the commit it was
+     * read at, or null when that is unknown. Null when no graph could be read,
+     * so every `node` is null. Absent on a document never mapped. Not hashed.
+     */
+    graph?: ChangeSetGraph | null;
+    /**
+     * The release this change set was planned for (#4045): the `releaseDigest`
+     * of the release a `components promote --release` deploys. Set with
+     * `environment` on a release gate's document, absent on every other. Part
+     * of the digest when present, so a stored document names the one release
+     * and environment its gate bound, and two releases whose plans read the
+     * same never share a document or an approval.
+     */
+    releaseDigest?: string;
+    /** The environment this change set was planned for (#4045), set with `releaseDigest`. Part of the digest when present. */
+    environment?: string;
+}
+/** Where a document's node ids come from. */
+export interface ChangeSetGraph {
+    member: string | null;
+    at: string | null;
 }
 /**
  * The set digest over members' plan digests: `computePlanDigest("change-set",
@@ -196,19 +228,29 @@ export declare function changeSetDigest(members: ReadonlyArray<Pick<ChangeSetMem
 /**
  * The document's digest: `computePlanDigest("change-set-document", …)` over
  * the set digest ({@link changeSetDigest}), each member's name, status and
- * holes, the entries and the side effects. Members are sorted by name and
+ * holes, the entries (without their graph `node`) and the side effects.
+ * Members are sorted by name and
  * entries and side effects by the keys {@link composeChangeSet} sorts them by,
  * so order makes no difference.
  *
  * A provisional member is left out, with its entries and side effects, as
  * the set digest leaves it out: no approval of the document covers it.
+ *
+ * A release gate's document (#4045) also hashes the `releaseDigest` and
+ * `environment` it was planned for. A document without them hashes as it
+ * always has, so no earlier digest moves.
  */
-export declare function changeSetDocumentDigest(doc: Pick<ChangeSetDocument, "members" | "entries" | "sideEffects">): string;
+export declare function changeSetDocumentDigest(doc: Pick<ChangeSetDocument, "members" | "entries" | "sideEffects" | "releaseDigest" | "environment">): string;
 /** The summary of a set of members and entries. */
 export declare function summarizeChangeSet(members: ChangeSetMember[], entries: ChangeSetEntry[]): ChangeSetSummary;
 export interface ComposeChangeSetOptions {
     /** The chant version to record in `chant`. */
     chant?: string;
+    /** The release and environment a release gate's change set was planned for (#4045), recorded and hashed. */
+    planned?: {
+        releaseDigest: string;
+        environment: string;
+    };
 }
 /**
  * Join adapters' parts into one document: members sorted by name, entries
@@ -222,7 +264,14 @@ export declare function composeChangeSet(parts: ReadonlyArray<ChangeSetPart>, op
  * effects give ({@link changeSetDocumentDigest}). A document that names a
  * member twice has no digest and is not verified.
  */
-export declare function verifyChangeSetDigest(doc: Pick<ChangeSetDocument, "digest" | "members" | "entries" | "sideEffects">): boolean;
+export declare function verifyChangeSetDigest(doc: Pick<ChangeSetDocument, "digest" | "members" | "entries" | "sideEffects" | "releaseDigest" | "environment">): boolean;
+/**
+ * Whether a change set changes nothing (ws-104 question 6, #4045): it has at
+ * least one member, every member planned, none failed or provisional, no
+ * member has a hole, and every entry is a `no-op` or a `read`. A release
+ * gate over such a document passes without an approval.
+ */
+export declare function isEmptyChangeSet(doc: Pick<ChangeSetDocument, "members" | "entries">): boolean;
 export interface LifecyclePlanPartInput {
     member: string;
     /** `chant lifecycle plan <env> --json`, parsed. */

package/dist/change-set.d.ts.map

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

package/dist/change-set.js

@@ -78,12 +78,17 @@ export function changeSetDigest(members) {
 /**
  * The document's digest: `computePlanDigest("change-set-document", …)` over
  * the set digest ({@link changeSetDigest}), each member's name, status and
- * holes, the entries and the side effects. Members are sorted by name and
+ * holes, the entries (without their graph `node`) and the side effects.
+ * Members are sorted by name and
  * entries and side effects by the keys {@link composeChangeSet} sorts them by,
  * so order makes no difference.
  *
  * A provisional member is left out, with its entries and side effects, as
  * the set digest leaves it out: no approval of the document covers it.
+ *
+ * A release gate's document (#4045) also hashes the `releaseDigest` and
+ * `environment` it was planned for. A document without them hashes as it
+ * always has, so no earlier digest moves.
  */
 export function changeSetDocumentDigest(doc) {
     const provisional = new Set(doc.members.filter((m) => m.provisional === true).map((m) => m.member));
@@ -91,9 +96,18 @@ export function changeSetDocumentDigest(doc) {
         .filter((m) => !provisional.has(m.member))
         .map((m) => ({ member: m.member, status: m.status, holes: m.holes }))
         .sort((a, b) => byString(a.member, b.member));
-    const entries = doc.entries.filter((e) => !provisional.has(e.member)).sort((a, b) => byString(entryKey(a), entryKey(b)));
+    // An entry's graph node (#4022) says where on the graph the change is,
+    // not what the plan does, so it stays outside the digest: mapping a stored
+    // document onto a graph never moves the value its gate bound.
+    const entries = doc.entries
+        .filter((e) => !provisional.has(e.member))
+        .map(({ node: _node, ...e }) => e)
+        .sort((a, b) => byString(entryKey(a), entryKey(b)));
     const sideEffects = (doc.sideEffects ?? []).filter((s) => !provisional.has(s.member)).sort(bySideEffect);
-    return computePlanDigest("change-set-document", { set: changeSetDigest(doc.members), members, entries, sideEffects });
+    const planned = doc.releaseDigest !== undefined || doc.environment !== undefined
+        ? { planned: { releaseDigest: doc.releaseDigest ?? null, environment: doc.environment ?? null } }
+        : {};
+    return computePlanDigest("change-set-document", { set: changeSetDigest(doc.members), members, entries, sideEffects, ...planned });
 }
 /** The summary of a set of members and entries. */
 export function summarizeChangeSet(members, entries) {
@@ -155,12 +169,14 @@ export function composeChangeSet(parts, options = {}) {
     const sideEffects = parts
         .flatMap((p) => (p.sideEffects ?? []).map((s) => ({ member: p.member.member, ...s })))
         .sort(bySideEffect);
-    const digest = changeSetDocumentDigest({ members, entries, sideEffects });
+    const planned = options.planned ? { releaseDigest: options.planned.releaseDigest, environment: options.planned.environment } : {};
+    const digest = changeSetDocumentDigest({ members, entries, sideEffects, ...planned });
     return {
         $schema: CHANGE_SET_SCHEMA_ID,
         contract: CHANGE_SET_CONTRACT,
         ...(options.chant !== undefined ? { chant: options.chant } : {}),
         digest,
+        ...planned,
         members,
         entries,
         ...(sideEffects.length > 0 ? { sideEffects } : {}),
@@ -180,6 +196,21 @@ export function verifyChangeSetDigest(doc) {
         return false;
     }
 }
+/**
+ * Whether a change set changes nothing (ws-104 question 6, #4045): it has at
+ * least one member, every member planned, none failed or provisional, no
+ * member has a hole, and every entry is a `no-op` or a `read`. A release
+ * gate over such a document passes without an approval.
+ */
+export function isEmptyChangeSet(doc) {
+    if (doc.members.length === 0)
+        return false;
+    for (const m of doc.members) {
+        if (m.status !== "planned" || m.provisional === true || m.holes.length > 0)
+            return false;
+    }
+    return doc.entries.every((e) => e.action === "no-op" || e.action === "read");
+}
 function lifecycleAttributes(entry) {
     const because = new Set(entry.disruptionBecause ?? []);
     return (entry.deltas ?? []).map((d) => ({

package/dist/chant-version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The installed chant's version, read from `@intentius/chant`'s own
+ * package.json, or "0.0.0" when it can't be read. The path is the same from
+ * `src/` and `dist/`, so it holds whether chant runs from source or from its
+ * build. Kept outside `cli/` so that a module the Op entry loads, such as the
+ * run-event writer (#4041), can name the version without loading the CLI.
+ */
+export declare const CHANT_VERSION: string;
+//# sourceMappingURL=chant-version.d.ts.map

package/dist/chant-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chant-version.d.ts","sourceRoot":"","sources":["../src/chant-version.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,MAMxB,CAAC"}

package/dist/chant-version.js

@@ -0,0 +1,16 @@
+import { createRequire } from "node:module";
+/**
+ * The installed chant's version, read from `@intentius/chant`'s own
+ * package.json, or "0.0.0" when it can't be read. The path is the same from
+ * `src/` and `dist/`, so it holds whether chant runs from source or from its
+ * build. Kept outside `cli/` so that a module the Op entry loads, such as the
+ * run-event writer (#4041), can name the version without loading the CLI.
+ */
+export const CHANT_VERSION = (() => {
+    try {
+        return createRequire(import.meta.url)("../package.json").version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+})();

package/dist/cli/commands/build.d.ts

@@ -80,6 +80,14 @@ export interface BuildOptions {
         serializers: Serializer[];
         result?: ReturnType<typeof build>;
     };
+    /**
+     * Where each output file goes: called with its absolute path and its
+     * content in place of creating the directory and writing the file. A
+     * release cut (#4046) passes one that keeps the files in memory, so it
+     * records exactly what this build writes and nothing left on disk by an
+     * earlier one.
+     */
+    writeFile?: (path: string, content: string) => void;
 }
 /**
  * Resolve the output format for `chant build`.

package/dist/cli/commands/build.d.ts.map

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

package/dist/cli/commands/build.js

@@ -25,6 +25,10 @@ import { formatError, formatWarning, formatSuccess, formatBold, formatInfo } fro
 import { writeFileSync, mkdirSync } from "fs";
 import { resolve, dirname, join, relative } from "path";
 import { watchDirectory, formatTimestamp, formatChangedFiles } from "../watch.js";
+function writeFileCreatingDir(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content);
+}
 /**
  * Resolve the output format for `chant build`.
  *
@@ -552,6 +556,7 @@ export async function buildCommand(options) {
         }));
     }
     // Handle output
+    const writeOutput = options.writeFile ?? writeFileCreatingDir;
     if (result.errors.length === 0 && errors.length === 0) {
         // Extract primary content and collect additional files from SerializerResult.
         // Each entry remembers which lexicon produced it, so a same-basename
@@ -680,8 +685,7 @@ export async function buildCommand(options) {
             additionalFiles.delete(filename);
             try {
                 const targetPath = join(projectDist, filename);
-                mkdirSync(dirname(targetPath), { recursive: true });
-                writeFileSync(targetPath, entry.content);
+                writeOutput(targetPath, entry.content);
                 opsWritten += 1;
             }
             catch (err) {
@@ -706,8 +710,7 @@ export async function buildCommand(options) {
                 continue;
             try {
                 const targetPath = join(projectDist, "ops", config.name, "op.json");
-                mkdirSync(dirname(targetPath), { recursive: true });
-                writeFileSync(targetPath, serializeOpIR(config));
+                writeOutput(targetPath, serializeOpIR(config));
                 irWritten += 1;
             }
             catch (err) {
@@ -724,8 +727,7 @@ export async function buildCommand(options) {
             // output path and any nested additional-file paths (e.g. ops/<name>/...).
             try {
                 const outputPath = resolve(options.output);
-                mkdirSync(dirname(outputPath), { recursive: true });
-                writeFileSync(outputPath, output);
+                writeOutput(outputPath, output);
                 // Write additional files (e.g. nested stack templates) alongside the primary output
                 if (additionalFiles.size > 0) {
                     const outputDir = dirname(outputPath);
@@ -746,8 +748,7 @@ export async function buildCommand(options) {
                             }
                         }
                         const targetPath = join(outputDir, filename);
-                        mkdirSync(dirname(targetPath), { recursive: true });
-                        writeFileSync(targetPath, fileContent);
+                        writeOutput(targetPath, fileContent);
                     }
                 }
             }

package/dist/cli/commands/check-lexicon-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-lexicon-docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check-lexicon-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAM9D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAkB1E;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAa9E"}
+{"version":3,"file":"check-lexicon-docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check-lexicon-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAM9D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAkB1E;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAa9E"}

package/dist/cli/commands/check-lexicon-docs.js

@@ -14,7 +14,9 @@
  * membership is the whole of reachability for a lexicon site.
  */
 import { existsSync, readdirSync, readFileSync } from "fs";
-import { join } from "path";
+import { basename, join, resolve } from "path";
+import { collectSidebarSlugs } from "../../codegen/docs.js";
+import { findChantDocsSite, sectionContentDir } from "../../codegen/docs-in-site.js";
 /**
  * Slugs the sidebar reaches, including nested group `items`.
  *
@@ -42,7 +44,7 @@ export function auditDocsReachability(lexiconDir) {
     const contentDir = join(lexiconDir, "docs", "src", "content", "docs");
     const configPath = join(lexiconDir, "docs", "astro.config.mjs");
     if (!existsSync(contentDir) || !existsSync(configPath)) {
-        return { hasSite: false, pages: [], unreachable: [] };
+        return auditSectionReachability(lexiconDir);
     }
     const slugs = sidebarSlugs(readFileSync(configPath, "utf-8"));
     const pages = readdirSync(contentDir)
@@ -77,3 +79,29 @@ export function auditDocsClassification(lexiconDir) {
     }
     return { hasPages: true, unclassified };
 }
+/**
+ * Reachability for a lexicon whose docs are a section of the chant main site
+ * (chant #3993): its generated pages under
+ * `docs/src/content/docs/lexicons/<name>/` against the `_sidebar.json` the
+ * pipeline wrote beside them. A page the fragment lists as hidden is
+ * deliberately URL-only and does not count. Before the section has been
+ * generated there is nothing to audit, which reads as no site, like a
+ * lexicon with no docs.
+ */
+function auditSectionReachability(lexiconDir) {
+    const site = findChantDocsSite(lexiconDir);
+    const name = basename(resolve(lexiconDir));
+    const dir = site ? sectionContentDir(site, name) : undefined;
+    const fragmentPath = dir ? join(dir, "_sidebar.json") : undefined;
+    if (!dir || !fragmentPath || !existsSync(fragmentPath))
+        return { hasSite: false, pages: [], unreachable: [] };
+    const fragment = JSON.parse(readFileSync(fragmentPath, "utf-8"));
+    const prefix = `lexicons/${name}/`;
+    const reached = new Set([...collectSidebarSlugs([fragment.group]), ...(fragment.hidden ?? [])].map((slug) => slug.startsWith(prefix) ? slug.slice(prefix.length) : slug));
+    const pages = readdirSync(dir)
+        .filter((f) => f.endsWith(".mdx") || f.endsWith(".md"))
+        .map((f) => f.replace(/\.mdx?$/, ""))
+        .sort();
+    const unreachable = pages.filter((slug) => slug !== "index" && !reached.has(slug));
+    return { hasSite: true, pages, unreachable };
+}

package/dist/cli/commands/check-lexicon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-lexicon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check-lexicon.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAyBD,gEAAgE;AAChE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAIlE;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAyB/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAanC;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAazE;AAID;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgmBpE;AAqBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAmDzE"}
+{"version":3,"file":"check-lexicon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check-lexicon.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAyBD,gEAAgE;AAChE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAIlE;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAyB/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAanC;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAazE;AAID;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4mBpE;AAqBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAmDzE"}

package/dist/cli/commands/check-lexicon.js

@@ -406,12 +406,23 @@ export async function checkLexicon(dir) {
         tier: 1,
         pass: hasSerializerTest,
     });
+    // A lexicon whose src/codegen/docs.ts runs docsPipeline always has a page:
+    // the pipeline writes the overview (index.mdx) from the manifest. Inside the
+    // chant repository that page is generated into the main docs site rather
+    // than committed under docs/ (chant #3993), so k3d, whose docs are all
+    // generated, has no .mdx of its own to count.
     const mdxFiles = findFiles(join(dir, "docs"), (n) => n.endsWith(".mdx"));
+    const docsTs = join(dir, "src", "codegen", "docs.ts");
+    const pipelineOverview = existsSync(docsTs) && readFileSync(docsTs, "utf-8").includes("docsPipeline(");
     items.push({
         name: "At least 1 .mdx doc page",
         tier: 1,
-        pass: mdxFiles.length > 0,
-        detail: mdxFiles.length > 0 ? `${mdxFiles.length} page(s)` : undefined,
+        pass: mdxFiles.length > 0 || pipelineOverview,
+        detail: mdxFiles.length > 0
+            ? `${mdxFiles.length} page(s)`
+            : pipelineOverview
+                ? "the docs pipeline's generated overview"
+                : undefined,
     });
     // Counting pages says nothing about whether a reader can find them.
     // Starlight has no auto-discovery, so a page missing from the sidebar is

package/dist/cli/commands/init-lexicon/templates/docs.d.ts

@@ -1,5 +1,8 @@
 /**
- * Docs site template generators for init-lexicon scaffold.
+ * Docs site template generators for init-lexicon scaffold. The app files
+ * (package.json, tsconfig, Astro config, content config) are written only for a
+ * lexicon outside the chant repository; inside it, the lexicon's docs are a
+ * section of the main site (chant #3993).
  */
 export declare function generateDocsPackageJson(name: string): string;
 export declare function generateDocsTsConfig(): string;

package/dist/cli/commands/init-lexicon/templates/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB5D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAiBlD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBlE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWzD"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAiBlD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBlE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWzD"}

package/dist/cli/commands/init-lexicon/templates/docs.js

@@ -1,6 +1,10 @@
 /**
- * Docs site template generators for init-lexicon scaffold.
+ * Docs site template generators for init-lexicon scaffold. The app files
+ * (package.json, tsconfig, Astro config, content config) are written only for a
+ * lexicon outside the chant repository; inside it, the lexicon's docs are a
+ * section of the main site (chant #3993).
  */
+import { DOCS_SITE_DEPENDENCIES } from "../../../../codegen/docs-in-site.js";
 export function generateDocsPackageJson(name) {
     return JSON.stringify({
         name: `@intentius/chant-lexicon-${name}-docs`,
@@ -12,11 +16,7 @@ export function generateDocsPackageJson(name) {
             build: "astro build",
             preview: "astro preview",
         },
-        dependencies: {
-            "@astrojs/starlight": "^0.37.6",
-            astro: "^5.6.1",
-            sharp: "^0.34.2",
-        },
+        dependencies: { ...DOCS_SITE_DEPENDENCIES },
     }, null, 2) + "\n";
 }
 export function generateDocsTsConfig() {

package/dist/cli/commands/init-lexicon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-lexicon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init-lexicon.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;IAGpC,aAAa;IACb,iBAAiB;IACjB,UAAU;IACV,WAAW;EAEd;AAqBD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyHhG;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrF"}
+{"version":3,"file":"init-lexicon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init-lexicon.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;IAGpC,aAAa;IACb,iBAAiB;IACjB,UAAU;IACV,WAAW;EAEd;AAqBD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkIhG;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrF"}

package/dist/cli/commands/init-lexicon.js

@@ -11,6 +11,7 @@ import { generatePackageJson, generateTsConfig, generateTsConfigBuild, generateJ
 import { generatePluginTestTs, generateSerializerTestTs, generateCompletionsTestTs, generateHoverTestTs } from "./init-lexicon/templates/tests.js";
 import { generateDocsPackageJson, generateDocsTsConfig, generateDocsAstroConfig, generateDocsContentConfig, generateDocsIndexMdx, generateDocsGettingStartedMdx } from "./init-lexicon/templates/docs.js";
 import { generateExamplePackageJson, generateExampleInfraTs } from "./init-lexicon/templates/examples.js";
+import { findChantDocsSite } from "../../codegen/docs-in-site.js";
 // ── Name derivation helpers ──────────────────────────────────────────
 function toCamelCase(name) {
     return name.replace(/[-_]+(.)/g, (_, c) => c.toUpperCase());
@@ -60,6 +61,12 @@ export async function initLexiconCommand(options) {
             warnings.push("Initializing in non-empty directory");
         }
     }
+    // Inside the chant repository a lexicon's docs are a section of the main
+    // site (chant #3993): the pipeline writes its pages into docs/, so the
+    // lexicon gets only docs/pages/. Anywhere else it gets a standalone
+    // Starlight app of its own, as before.
+    const standaloneDocs = findChantDocsSite(targetDir) === undefined;
+    const standaloneDocsDirs = ["docs/src", "docs/src/content", "docs/src/content/docs"];
     // Create directory structure
     const dirs = [
         "",
@@ -71,9 +78,7 @@ export async function initLexiconCommand(options) {
         "src/lsp",
         "src/generated",
         "docs",
-        "docs/src",
-        "docs/src/content",
-        "docs/src/content/docs",
+        ...(standaloneDocs ? standaloneDocsDirs : []),
         "docs/pages",
         "examples/getting-started",
         "examples/getting-started/src",
@@ -114,11 +119,15 @@ export async function initLexiconCommand(options) {
         "justfile": generateJustfile(name),
         ".gitignore": generateGitignore(),
         "README.md": generateReadme(name, names),
-        "docs/package.json": generateDocsPackageJson(name),
-        "docs/tsconfig.json": generateDocsTsConfig(),
-        "docs/astro.config.mjs": generateDocsAstroConfig(name),
-        "docs/src/content.config.ts": generateDocsContentConfig(),
-        "docs/src/content/docs/index.mdx": generateDocsIndexMdx(name),
+        ...(standaloneDocs
+            ? {
+                "docs/package.json": generateDocsPackageJson(name),
+                "docs/tsconfig.json": generateDocsTsConfig(),
+                "docs/astro.config.mjs": generateDocsAstroConfig(name),
+                "docs/src/content.config.ts": generateDocsContentConfig(),
+                "docs/src/content/docs/index.mdx": generateDocsIndexMdx(name),
+            }
+            : {}),
         "docs/pages/getting-started.mdx": generateDocsGettingStartedMdx(name),
         "examples/getting-started/package.json": generateExamplePackageJson(name),
         "examples/getting-started/src/infra.ts": generateExampleInfraTs(name, names),