craftar 0.5.0 → 0.6.1

package/dist/core/template-import.js

@@ -0,0 +1,188 @@
+import path from "node:path";
+import { IngredientSchema } from "../schema/index.js";
+import { placeholders, substitutedFile } from "./extract.js";
+import { fingerprintOf } from "./fingerprint.js";
+import { parseYaml } from "./forge.js";
+import { substitute } from "./resolve.js";
+import { stripBom, toLf } from "./text.js";
+/**
+ * Template-aware import (spec 10): compare a workspace source with the Forge base as sync would
+ * render it for the importing profile, and — failing that — infer the values of the base's
+ * declared keys from the source. Pure but for the `DirReader` the importer hands in.
+ */
+const PLACEHOLDER = /\{\{\s*([A-Za-z0-9_.]+)\s*\}\}/g;
+const norm = (s) => toLf(stripBom(s));
+/** The values sync substitutes into `meta`'s files for the importing workspace: declared defaults, then P, then W (spec 10 §6.1). */
+export function renderMap(meta, profileParams, workspaceParams) {
+    const out = Object.create(null);
+    for (const [k, v] of Object.entries(meta.params ?? {}))
+        if (v.default !== undefined)
+            out[k] = v.default;
+    for (const [k, v] of Object.entries(profileParams))
+        out[k] = v;
+    for (const [k, v] of Object.entries(workspaceParams))
+        out[k] = v;
+    return out;
+}
+/** An ingredient directory as the comparison sees it: its validated metadata and its files, admitted ones as normalized text. */
+export async function readBase(dir, io) {
+    const metaFile = path.join(dir, "ingredient.yaml");
+    const meta = parseYaml(metaFile, await io.readText(metaFile), IngredientSchema);
+    const texts = new Map();
+    const bytes = new Map();
+    for (const rel of await io.list(dir)) {
+        if (rel === "ingredient.yaml")
+            continue;
+        if (substitutedFile(meta, rel))
+            texts.set(rel, norm(await io.readText(path.join(dir, rel))));
+        else
+            bytes.set(rel, await io.readBytes(path.join(dir, rel)));
+    }
+    return { meta, texts, bytes, metaFile };
+}
+/** The keys every admitted file of a base cites (`C(X)`). */
+export function citedKeys(texts) {
+    const out = new Set();
+    for (const t of texts.values())
+        for (const k of placeholders(t))
+            out.add(k);
+    return out;
+}
+/**
+ * The fingerprint of a base rendered through `map` (spec 10 §6.2): its metadata without `params`
+ * (a workspace cannot express a declaration), admitted files substituted exactly as `ctx.text`
+ * does, every other file as bytes. With no declaration and nothing set, this is `fingerprintDir`.
+ */
+export function renderedFingerprint(base, map) {
+    const meta = { ...base.meta };
+    delete meta.params;
+    const files = {};
+    for (const [rel, text] of base.texts)
+        files[rel] = substitute(text, map);
+    for (const [rel, b] of base.bytes)
+        files[rel] = b;
+    try {
+        return fingerprintOf(meta, files);
+    }
+    catch (e) {
+        // Named the way fingerprintDir names it: a cyclic alias is a fact about this file.
+        throw new Error(`invalid ${path.relative(process.cwd(), base.metaFile)}: ${e.message}`);
+    }
+}
+/** A template line split into literal text and holes; placeholders that are not holes are fixed first (§6.3 step 1). */
+function segments(line, holes, map) {
+    const out = [];
+    let last = 0;
+    let lit = "";
+    for (const m of line.matchAll(PLACEHOLDER)) {
+        lit += line.slice(last, m.index);
+        last = m.index + m[0].length;
+        const key = m[1];
+        if (holes.has(key)) {
+            out.push({ lit }, { hole: key });
+            lit = "";
+        }
+        else {
+            lit += Object.hasOwn(map, key) ? String(map[key]) : m[0];
+        }
+    }
+    out.push({ lit: lit + line.slice(last) });
+    return out.filter((s, i) => !("lit" in s) || s.lit !== "" || i === 0 || i === out.length - 1);
+}
+const validValue = (v) => v !== "" && !/[\n{}]/.test(v) && v === v.trim();
+/** Every assignment of the holes that makes `segs` spell `line`, up to `limit`; `strict` applies the value rules. */
+function solve(segs, line, strict, limit) {
+    const found = [];
+    const walk = (i, pos, assigned) => {
+        if (found.length >= limit)
+            return;
+        if (i === segs.length) {
+            if (pos === line.length)
+                found.push({ ...assigned });
+            return;
+        }
+        const s = segs[i];
+        if ("lit" in s) {
+            if (line.startsWith(s.lit, pos))
+                walk(i + 1, pos + s.lit.length, assigned);
+            return;
+        }
+        const next = segs[i + 1];
+        const nextLit = next && "lit" in next ? next.lit : "";
+        const lastHole = i + 1 >= segs.length || (i + 2 === segs.length && nextLit === "");
+        for (let end = pos; end <= line.length; end++) {
+            if (lastHole && end !== line.length - nextLit.length)
+                continue;
+            if (nextLit && !line.startsWith(nextLit, end))
+                continue;
+            const v = line.slice(pos, end);
+            if (strict && !validValue(v))
+                continue;
+            if (assigned[s.hole] !== undefined && assigned[s.hole] !== v)
+                continue;
+            const had = assigned[s.hole];
+            assigned[s.hole] = v;
+            walk(i + 1, end, assigned);
+            if (had === undefined)
+                delete assigned[s.hole];
+            if (found.length >= limit)
+                return;
+        }
+    };
+    walk(0, 0, {});
+    return found;
+}
+/**
+ * Infer the holes' values from the source files (spec 10 §6.3): line by line, every line with a
+ * hole must have exactly one solution, and every occurrence of a key must agree across lines and
+ * files. Not proved here — the caller renders with the result and compares fingerprints (§6.4).
+ */
+export function infer(templates, sources, holes, map) {
+    const values = {};
+    const where = {};
+    for (const [file, template] of templates) {
+        const source = sources.get(file);
+        if (source === undefined)
+            return { fallback: "F5", reason: `${file} differs` };
+        const tLines = template.split("\n");
+        const sLines = norm(source).split("\n");
+        if (tLines.length !== sLines.length)
+            return { fallback: "F5", reason: `the template does not match ${file} (line counts differ)` };
+        for (let n = 0; n < tLines.length; n++) {
+            const segs = segments(tLines[n], holes, map);
+            const hasHole = segs.some((s) => "hole" in s);
+            if (!hasHole) {
+                const lit = segs.map((s) => ("lit" in s ? s.lit : "")).join("");
+                if (lit !== sLines[n])
+                    return { fallback: "F5", reason: `the template does not match line ${n + 1} of ${file}` };
+                continue;
+            }
+            for (let i = 1; i < segs.length; i++) {
+                if ("hole" in segs[i] && "hole" in segs[i - 1]) {
+                    const a = segs[i - 1].hole;
+                    const b = segs[i].hole;
+                    return { fallback: "F4", reason: `inference ambiguous: {{${a}}}{{${b}}} are adjacent on line ${n + 1} of ${file}` };
+                }
+            }
+            const sols = solve(segs, sLines[n], true, 2);
+            if (sols.length > 1)
+                return { fallback: "F6", reason: `inference ambiguous on line ${n + 1} of ${file}` };
+            if (sols.length === 0) {
+                const [loose] = solve(segs, sLines[n], false, 1);
+                const bad = loose && Object.entries(loose).find(([, v]) => !validValue(v));
+                if (bad)
+                    return { fallback: "F7", reason: `${bad[0]} would be ${JSON.stringify(bad[1])}, which a parameter cannot carry` };
+                return { fallback: "F5", reason: `the template does not match line ${n + 1} of ${file}` };
+            }
+            for (const [k, v] of Object.entries(sols[0])) {
+                if (values[k] !== undefined && values[k] !== v) {
+                    return { fallback: "F5", reason: `${k} is ${JSON.stringify(values[k])} in ${where[k]} but ${JSON.stringify(v)} on line ${n + 1} of ${file}` };
+                }
+                values[k] = v;
+                where[k] ??= `line ${n + 1} of ${file}`;
+            }
+        }
+    }
+    return { values };
+}
+//# sourceMappingURL=template-import.js.map

package/dist/core/template-import.js.map

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

package/dist/core/yaml-edit.js

@@ -0,0 +1,36 @@
+import YAML from "yaml";
+import { detectEol, stripBom, toLf, withEol } from "./text.js";
+/**
+ * Edit a YAML document in place (spec 09 §6.4, generalized by spec 10 §6.6): refuse one that
+ * does not round-trip byte for byte — an edit never reformats a line it did not decide — apply
+ * `edit`, and restore the EOL and BOM. The width the file was written with decides the width of
+ * the edit: `unify` writes with no folding, `import` with yaml's default 80 columns, so both are
+ * tried, and the first that reproduces the text is the one the edit is serialized with. Both set
+ * `flowCollectionPadding: false`, so a file that spells a flow collection `[a, b]`, the common
+ * hand-written form, still round-trips; yaml's default would write it back as `[ a, b ]`.
+ */
+const BOM = String.fromCharCode(0xfeff);
+const WIDTHS = [
+    { flowCollectionPadding: false, lineWidth: 0 },
+    { flowCollectionPadding: false },
+];
+export function editYamlText(raw, o, edit) {
+    const refuse = (why, fix = "reformat it by hand, commit, and re-run") => new Error(`${o.command}: cannot edit ${o.label} in place (${why}) — ${fix}`);
+    const eol = detectEol(raw);
+    const bom = raw.charCodeAt(0) === BOM.charCodeAt(0);
+    const doc = YAML.parseDocument(raw);
+    const text = toLf(stripBom(raw));
+    const width = doc.errors.length ? undefined : WIDTHS.find((w) => doc.toString(w) === text);
+    if (!width)
+        throw refuse("it does not round-trip unchanged through the YAML writer");
+    for (const key of o.keys) {
+        const node = doc.get(key, true);
+        if (YAML.isAlias(node))
+            throw refuse(`${key} is an alias`, "expand it by hand, commit, and re-run");
+        if ((YAML.isMap(node) || YAML.isSeq(node)) && node.flow && node.items.length === 0)
+            node.flow = false;
+    }
+    edit(doc);
+    return (bom ? BOM : "") + withEol(doc.toString(width), eol);
+}
+//# sourceMappingURL=yaml-edit.js.map

package/dist/core/yaml-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-edit.js","sourceRoot":"","sources":["../../src/core/yaml-edit.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE/D;;;;;;;;GAQG;AAEH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AACxC,MAAM,MAAM,GAAG;IACb,EAAE,qBAAqB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE;IAC9C,EAAE,qBAAqB,EAAE,KAAK,EAAE;CACxB,CAAC;AAWX,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,CAAkB,EAAE,IAAkC;IAC9F,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,GAAG,GAAG,yCAAyC,EAAE,EAAE,CAC9E,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,iBAAiB,CAAC,CAAC,KAAK,cAAc,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC3F,IAAI,CAAC,KAAK;QAAE,MAAM,MAAM,CAAC,0DAA0D,CAAC,CAAC;IACrF,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,MAAM,MAAM,CAAC,GAAG,GAAG,cAAc,EAAE,uCAAuC,CAAC,CAAC;QACpG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACxG,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC"}