@cruba/crubal 0.0.0-stage → 0.2.0

package/dist/src/packages.js

@@ -0,0 +1,232 @@
+// packages.ts: package files (spec chapter 11). A file may hold several packages, each starting at a
+// `package:` line. The checks here are 11.1's prefixes, 11.3's trust entries and 11.4's rule that an
+// extending package may add to what it extends but never change it.
+import { emptyDictionary, readDefinitions, unquote } from "./defs.js";
+import { LANGUAGE } from "./read-text.js";
+import { readContracts } from "./store.js";
+import { readAccess } from "./access.js";
+import { CrubalError, readTree } from "./tree.js";
+const ORIGINS = new Set(["observed", "declared", "derived", "reported"]);
+const AUDIENCES = new Set(["public", "member", "staff", "owner"]);
+const splitList = (v) => v.split(",").map((s) => s.trim()).filter(Boolean);
+/** Split at commas outside parentheses: `controller, curator(ship, returns)` → two pieces. */
+function splitServes(value) {
+    const parts = [];
+    let depth = 0;
+    let cur = "";
+    for (const ch of value) {
+        if (ch === "(")
+            depth++;
+        if (ch === ")")
+            depth--;
+        if (ch === "," && depth === 0) {
+            parts.push(cur);
+            cur = "";
+        }
+        else
+            cur += ch;
+    }
+    parts.push(cur);
+    return parts.map((s) => s.trim()).filter(Boolean);
+}
+/** Read one `utility:` block. */
+function readUtility(node) {
+    const [name = "", version = ""] = node.value.split(/\s+\//).map((s) => s.trim());
+    if (!/^[a-z][\w-]*$/.test(name))
+        throw new CrubalError(`a utility is "utility: <name> /<version>", the name a lower-case word: ${node.value}`, node.line);
+    const u = { name, version, serves: [], needs: [], setup: [], line: node.line };
+    for (const c of node.children) {
+        if (!c.key)
+            continue;
+        if (c.key === "label")
+            u.label = unquote(c.value.trim());
+        else if (c.key === "describe")
+            u.describe = unquote(c.value.trim());
+        else if (c.key === "serves") {
+            for (const p of splitServes(c.value)) {
+                const m = p.match(/^([A-Za-z][\w-]*)(?:\((.*)\))?$/);
+                if (!m)
+                    throw new CrubalError(`serves: ${p} is not a name, or a name with items in parentheses`, c.line);
+                u.serves.push({ as: m[1], ...(m[2] !== undefined ? { items: splitList(m[2]) } : {}), line: c.line });
+            }
+        }
+        else if (c.key === "needs") {
+            for (const n of splitList(c.value)) {
+                const [nm = "", ver] = n.split(/\s+\//).map((s) => s.trim());
+                if (!/^([a-z0-9.-]+\/[a-z][\w-]*|[a-z][\w-]*)$/.test(nm))
+                    throw new CrubalError(`needs: ${nm} is not a package identity (domain/name) or a utility name`, c.line);
+                u.needs.push({ name: nm, ...(ver ? { version: ver } : {}), line: c.line });
+            }
+        }
+        else if (c.key === "setup") {
+            for (const s of splitList(c.value)) {
+                const m = s.match(/^(connection|setting)\s+(\S+)$/);
+                if (!m)
+                    throw new CrubalError(`setup: ${s} is not "connection <name>" or "setting <facet>"`, c.line);
+                u.setup.push(m[1] === "connection" ? { connection: m[2], line: c.line } : { setting: m[2], line: c.line });
+            }
+        }
+        else
+            throw new CrubalError(`a utility has label, describe, serves, needs and setup, not ${c.key}`, c.line);
+    }
+    return u;
+}
+/** Split a file into its packages, keeping line numbers true. */
+export function readPackages(source) {
+    const lines = source.split(/\r?\n/);
+    const starts = lines.flatMap((l, i) => (/^package: /.test(l) ? [i] : []));
+    return starts.map((start, n) => {
+        const end = starts[n + 1] ?? lines.length;
+        const text = lines.map((l, i) => (i >= start && i < end ? l : "")).join("\n");
+        const [head, ...rest] = readTree(text);
+        if (!head)
+            throw new CrubalError("an empty package", start + 1);
+        const [name = "", version = ""] = head.value.split(/\s+\//).map((s) => s.trim());
+        const info = { name, version, owner: "", line: head.line, crubal: LANGUAGE, crubalLine: head.line, extends: [], prefixes: new Map(), trust: [], dict: emptyDictionary(), contracts: [], header: {}, terms: {}, utilities: [] };
+        for (const c of head.children) {
+            if (c.key === "owner")
+                info.owner = c.value;
+            if (c.key === "crubal") {
+                info.crubal = Number(c.value);
+                info.crubalLine = c.line;
+            }
+            if (c.key === "extends") {
+                for (const e of c.value.split(",")) {
+                    const [en = "", ev = ""] = e.trim().split(/\s+\//);
+                    info.extends.push({ name: en.trim(), version: ev.trim(), line: c.line });
+                }
+            }
+            if (c.key === "prefixes")
+                for (const p of c.children)
+                    if (p.key)
+                        info.prefixes.set(p.key, { target: p.value, line: p.line });
+            if (c.key === "terms")
+                for (const t of c.children)
+                    if (t.key)
+                        info.terms[t.key] = t.value.trim();
+            if (c.key && !["owner", "crubal", "extends", "prefixes", "terms"].includes(c.key))
+                info.header[c.key] = c.value.trim();
+        }
+        for (const node of rest) {
+            if (node.key === "trust")
+                for (const t of node.children)
+                    info.trust.push({ entry: t.text.trim(), line: t.line });
+            if (node.key === "utility") {
+                const u = readUtility(node);
+                if (info.utilities.some((x) => x.name === u.name))
+                    throw new CrubalError(`the utility ${u.name} twice in one package`, node.line);
+                info.utilities.push(u);
+            }
+        }
+        // Definitions are everything after the header block.
+        const headerEnd = Math.max(start, ...head.children.flatMap(function deep(c) { return [c.line - 1, ...c.children.flatMap(deep)]; }));
+        const defs = text.split("\n").map((l, i) => (i > headerEnd ? l : "")).join("\n");
+        readDefinitions(defs, info.dict);
+        info.contracts = readContracts(defs).map((c) => c.name);
+        return info;
+    });
+}
+function sameDefinition(base, mine) {
+    if (base.type !== mine.type)
+        return "type";
+    if (base.pick !== mine.pick)
+        return "pick";
+    if ((base.unit ?? "") !== (mine.unit ?? ""))
+        return "unit";
+    const baseValues = (base.values ?? []).map((v) => v.value);
+    const mineValues = (mine.values ?? []).map((v) => v.value);
+    if (mine.values && baseValues.some((v) => !mineValues.includes(v)))
+        return "values";
+    return null;
+}
+/** Check every package in a file (11.1, 11.3, 11.4). Throws the first problem. */
+export function checkPackages(source) {
+    // 11.2: a kind's vary step names a level of its kind and facets of this package (a key of another package
+    // carries its prefix and is checked where that package is resolved).
+    {
+        const d = readDefinitions(source);
+        for (const [level, keys] of d.vary) {
+            if (!d.levels.has(level))
+                throw new CrubalError(`vary names ${level}, which isn't a level`, d.varyLines.get(level));
+            for (const k of keys)
+                if (!k.includes(":") && !d.facets.has(k))
+                    throw new CrubalError(`vary at ${level} names ${k}, which isn't a facet`, d.varyLines.get(level));
+        }
+    }
+    const pkgs = readPackages(source);
+    const byName = new Map(pkgs.map((p) => [p.name, p]));
+    for (const p of pkgs) {
+        // Language versions (11.8): never above this reader's, and never extending a package above one's own.
+        if (!Number.isInteger(p.crubal) || p.crubal < 1)
+            throw new CrubalError(`${p.name}: the language version is a whole number`, p.crubalLine);
+        if (p.crubal > LANGUAGE)
+            throw new CrubalError(`${p.name} is written in CRUBAL ${p.crubal}; this reader knows ${LANGUAGE}`, p.crubalLine);
+        for (const e of p.extends) {
+            const base = byName.get(e.name);
+            if (base && base.crubal > p.crubal)
+                throw new CrubalError(`${p.name} (CRUBAL ${p.crubal}) extends ${e.name}, written in CRUBAL ${base.crubal}, which it couldn't read`, e.line);
+        }
+        for (const [prefix, { target, line }] of p.prefixes) {
+            if (prefix === "crubal")
+                throw new CrubalError("the prefix crubal is reserved for the core", line);
+            if (prefix === p.name && target !== `${p.owner}/${p.name}`)
+                throw new CrubalError(`${p.name} can't map its own name to something else`, line);
+        }
+        for (const { entry, line } of p.trust) {
+            if (entry === "person" || ORIGINS.has(entry))
+                continue;
+            const bare = entry.startsWith(`${p.name}:`) ? entry.slice(p.name.length + 1) : entry;
+            if (p.contracts.includes(bare))
+                continue;
+            if (!entry.includes(":") && entry.includes("."))
+                continue; // a party's domain
+            throw new CrubalError(`${entry} is not a contract of this package`, line);
+        }
+        for (const f of p.dict.facets.values()) {
+            const m = f.key.match(/^([a-z][a-z0-9-]*):(.+)$/);
+            if (!m || m[1] === "crubal")
+                continue;
+            const base = byName.get(m[1]);
+            if (!base || !p.extends.some((e) => e.name === base.name))
+                continue;
+            const original = base.dict.facets.get(m[2]);
+            if (!original)
+                continue;
+            const changed = sameDefinition(original, f);
+            if (changed)
+                throw new CrubalError(`${p.name} changes ${f.key}'s ${changed}; an extending package may only add to it`, f.line);
+        }
+    }
+    checkUtilities(source, pkgs);
+    return pkgs;
+}
+/**
+ * Utility blocks (11.1): what a utility `serves` is a preset, a relation or an audience the file declares,
+ * and the items in parentheses are presets, menu items or relations; a `setting` in `setup` is a facet the
+ * file defines. Packages the file doesn't hold are named by prefix and checked where they are resolved.
+ */
+function checkUtilities(source, pkgs) {
+    if (!pkgs.some((p) => p.utilities.length))
+        return;
+    const { perms } = readAccess(source);
+    const dict = readDefinitions(source);
+    const known = (n) => perms.presets.has(n) || perms.relations.has(n) || AUDIENCES.has(n);
+    const item = (n) => perms.presets.has(n) || perms.menu.has(n) || perms.relations.has(n);
+    for (const p of pkgs) {
+        for (const u of p.utilities) {
+            for (const s of u.serves) {
+                if (!known(s.as))
+                    throw new CrubalError(`${u.name} serves ${s.as}, which isn't a preset, relation or audience here`, s.line);
+                for (const i of s.items ?? [])
+                    if (!item(i))
+                        throw new CrubalError(`${u.name} serves ${s.as}(${i}): ${i} isn't a preset, menu item or relation here`, s.line);
+            }
+            for (const s of u.setup)
+                if ("setting" in s && !s.setting.includes(":") && !dict.facets.has(s.setting))
+                    throw new CrubalError(`${u.name} needs the setting ${s.setting}, which isn't a facet here`, s.line);
+            if (u.needs.some((n) => n.name === u.name))
+                throw new CrubalError(`${u.name} needs itself`, u.line);
+        }
+    }
+}
+//# sourceMappingURL=packages.js.map

package/dist/src/packages.js.map

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

package/dist/src/print-text.d.ts

@@ -0,0 +1,7 @@
+import { type Dictionary, type Facet } from "./defs.ts";
+import type { Json, Wrapper } from "./model.ts";
+export type PrintMode = "full" | "plain";
+/** A list item's text form with its qualifiers and without its sources: the selector in an address. */
+export declare function itemText(f: Facet, v: Json): string;
+/** Print a wrapper as text. */
+export declare function printText(w: Wrapper, dict: Dictionary, mode?: PrintMode): string;

package/dist/src/print-text.js

@@ -0,0 +1,216 @@
+// print-text.ts: the JSON form (spec chapter 3) back to canonical text (chapter 2.9). Full mode writes the
+// envelope lines and sources, so reading the print gives the same pairs back.
+import { blank } from "./defs.js";
+import { writeText } from "./lex.js";
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** Detail pairs whose values are already spelled for the text form. */
+function detailText(pairs) {
+    if (!pairs.length)
+        return "";
+    return ` [${pairs.map(([k, v]) => `${k}: ${v}`).join(", ")}]`;
+}
+function sourcePairs(s) {
+    if (!s)
+        return [];
+    const out = [["origin", writeText(s.origin, true)], ["via", writeText(s.via, true)]];
+    if (s.owner)
+        out.push(["owner", writeText(s.owner, true)]);
+    return out;
+}
+const TEXT = blank("", "text");
+/** Spellings that would read as another shape under this facet, so text holding them must be quoted. */
+function otherShapes(f) {
+    const out = ["_", "-", "n/a", "N/A"];
+    if (f.type === "yes-no")
+        out.push("yes", "no", ...(f.words ?? []));
+    return out;
+}
+/** One scalar, as the text form spells it, without detail. */
+function scalarText(f, v) {
+    if (typeof v === "boolean") {
+        const [yes, no] = f.words ?? ["yes", "no"];
+        return v ? yes : no;
+    }
+    if (typeof v === "string")
+        return writeText(v, false, otherShapes(f));
+    if (typeof v === "number")
+        return String(v);
+    if (isObj(v)) {
+        if ("$empty" in v)
+            return v.$empty === "unknown" ? "_" : "-";
+        if ("$link" in v)
+            return `&${v.$link}`;
+        if ("$qty" in v)
+            return `${v.$qty}${v.unit}`;
+        if ("$money" in v)
+            return `${v.$money}${v.currency}`;
+        if ("$image" in v)
+            return writeText(String(v.$image));
+    }
+    return JSON.stringify(v);
+}
+/** The detail pairs a value carries in itself: qualifiers and image fields. */
+function ownDetail(v) {
+    if (!isObj(v))
+        return [];
+    if ("$value" in v) {
+        return Object.entries(v)
+            .filter(([k]) => k !== "$value")
+            .map(([k, q]) => [k, typeof q === "string" ? writeText(q, true) : scalarText(TEXT, q)]);
+    }
+    if ("$image" in v) {
+        return Object.entries(v)
+            .filter(([k]) => k !== "$image")
+            .map(([k, x]) => [k, typeof x === "string" ? writeText(x, true) : String(x)]);
+    }
+    return [];
+}
+function core(v) {
+    return isObj(v) && "$value" in v ? v.$value : v;
+}
+/** A list item's text form with its qualifiers and without its sources: the selector in an address. */
+export function itemText(f, v) {
+    return scalarText(f, core(v)) + detailText(ownDetail(v));
+}
+function valueLine(f, v, address, out) {
+    const src = out.mode === "full" ? out.sources[address] : undefined;
+    return scalarText(f, core(v)) + detailText([...ownDetail(v), ...sourcePairs(src)]);
+}
+function printFields(obj, within, prefix, depth, out) {
+    const pad = "  ".repeat(depth);
+    for (const [key, v] of Object.entries(obj)) {
+        const f = within ? within.get(key) : out.dict.facets.get(key);
+        const address = prefix ? `${prefix}.${key}` : key;
+        if (!f) {
+            const [first = "", ...more] = (typeof v === "string" ? v : JSON.stringify(v)).split("\n");
+            out.lines.push(first ? `${pad}${key}: ${first}` : `${pad}${key}:`);
+            for (const m of more)
+                out.lines.push(`${pad}  ${m}`);
+            continue;
+        }
+        printValue(f, key, v, address, depth, out);
+    }
+}
+function printValue(f, key, v, address, depth, out) {
+    const pad = "  ".repeat(depth);
+    if (isObj(v) && "$empty" in v) {
+        out.lines.push(`${pad}${key}: ${valueLine(f, v, address, out)}`);
+        return;
+    }
+    // Text holding a line break takes the block form (2.4.1): `key: |`, its detail on that line, the lines
+    // below, an empty line written as `|`.
+    if (f.type === "text" && !f.many && typeof v === "string" && v.includes("\n")) {
+        const src = out.mode === "full" ? out.sources[address] : undefined;
+        out.lines.push(`${pad}${key}: |${detailText(sourcePairs(src))}`);
+        for (const l of v.split("\n"))
+            out.lines.push(l === "" ? `${pad}  |` : `${pad}  ${l}`);
+        return;
+    }
+    if (f.type === "compound") {
+        const children = f.children ?? new Map();
+        out.lines.push(`${pad}${key}:`);
+        if (!f.many || !Array.isArray(v)) {
+            if (isObj(v))
+                printFields(v, children, address, depth + 1, out);
+            return;
+        }
+        for (const row of v) {
+            if (!isObj(row))
+                continue;
+            const rowKey = f.identity ? linkTarget(row[f.identity]) : String(row.$row ?? "");
+            const fields = {};
+            if (f.identity && row[f.identity] !== undefined)
+                fields[f.identity] = row[f.identity];
+            for (const [k, x] of Object.entries(row))
+                if (k !== "$row" && !(k in fields))
+                    fields[k] = x;
+            const start = out.lines.length;
+            if (!f.identity)
+                out.lines.push(`${pad}  - [row: ${rowKey}]`);
+            printFields(fields, children, `${address}[${rowKey}]`, depth + 2, out);
+            if (f.identity) {
+                const first = out.lines[start];
+                if (first !== undefined)
+                    out.lines[start] = `${pad}  - ${first.trimStart()}`;
+            }
+        }
+        return;
+    }
+    if (!f.many || !Array.isArray(v)) {
+        out.lines.push(`${pad}${key}: ${valueLine(f, v, address, out)}`);
+        return;
+    }
+    const items = v.map((item) => {
+        const src = out.mode === "full" ? out.sources[`${key}[${JSON.stringify(itemText(f, item))}]`] : undefined;
+        return scalarText(f, core(item)) + detailText([...ownDetail(item), ...sourcePairs(src)]);
+    });
+    const short = `${pad}${key}: ${items.join(", ")}`;
+    if (short.length <= 100 && items.every((i) => !i.includes("\n"))) {
+        out.lines.push(short);
+        return;
+    }
+    out.lines.push(`${pad}${key}:`);
+    for (const item of items)
+        out.lines.push(`${pad}  - ${item}`);
+}
+function linkTarget(v) {
+    return isObj(v) && "$link" in v ? String(v.$link) : String(v ?? "");
+}
+function printRecord(r, fileOwner, out) {
+    const sources = r.sources ?? {};
+    out.sources = sources;
+    const star = out.mode === "full" ? detailText(sourcePairs(sources["*"])) : "";
+    out.lines.push(`${r.level}: ${r.id}${r.of ? ` of ${r.of}` : ""}${star}`);
+    if (r.owner !== fileOwner)
+        out.lines.push(`  crubal:owner: ${r.owner}`);
+    if (r.within)
+        out.lines.push(`  crubal:within: ${r.within}`);
+    if (r.status?.state === "archived") {
+        const pairs = [];
+        if (r.status.reason)
+            pairs.push(["reason", writeText(r.status.reason, true)]);
+        if (r.status.into)
+            pairs.push(["into", r.status.into]);
+        out.lines.push(`  crubal:status: archived${detailText(pairs)}`);
+    }
+    if (r.applied && Object.keys(r.applied).length) {
+        out.lines.push(`  crubal:applied:${detailText(Object.entries(r.applied).map(([k, n]) => [k, String(n)]))}`);
+    }
+    if (r.wears?.length)
+        out.lines.push(`  crubal:wears: ${r.wears.join(", ")}`);
+    if (out.mode === "full" && r.created)
+        out.lines.push(`  crubal:created: ${r.created}`);
+    if (out.mode === "full" && r.updated)
+        out.lines.push(`  crubal:updated: ${r.updated}`);
+    printFields(r.values, null, "", 1, out);
+    if (r.parts?.length) {
+        out.lines.push("  crubal:parts:");
+        for (const part of r.parts) {
+            if (!isObj(part))
+                continue;
+            out.lines.push(`    - [row: ${part.$row}]`);
+            const wears = part.wears;
+            if (Array.isArray(wears) && wears.length)
+                out.lines.push(`      crubal:wears: ${wears.join(", ")}`);
+            if (isObj(part.values))
+                printFields(part.values, null, `parts[${part.$row}]`, 3, out);
+        }
+    }
+}
+/** Print a wrapper as text. */
+export function printText(w, dict, mode = "full") {
+    const out = { lines: [], sources: {}, mode, dict };
+    const owners = w.records.map((r) => r.owner);
+    const fileOwner = owners[0];
+    out.lines.push(`crubal: ${w.crubal}`);
+    if (w.package)
+        out.lines.push(`package: ${w.package}`);
+    if (fileOwner)
+        out.lines.push(`owner: ${fileOwner}`);
+    for (const r of w.records) {
+        out.lines.push("");
+        printRecord(r, fileOwner, out);
+    }
+    return `${out.lines.join("\n")}\n`;
+}
+//# sourceMappingURL=print-text.js.map

package/dist/src/print-text.js.map

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

package/dist/src/publish.d.ts

@@ -0,0 +1,27 @@
+import { type Parsed } from "./bundle.ts";
+import type { Json, JsonObject } from "./model.ts";
+export type Change = {
+    member: string;
+    kind: "unchanged" | "safe" | "minor" | "breaking" | "new" | "retired";
+    why: string[];
+    recipe?: string[];
+};
+/** Classify every member against the previous bundle. */
+export declare function classify(previous: JsonObject | undefined, next: JsonObject): Change[];
+export type PublishOptions = {
+    previous?: JsonObject;
+    date: string;
+    key?: {
+        d: string;
+        x: string;
+    };
+    records?: Json[];
+};
+/**
+ * Cut a version: versions by diff, the recipe check, `previous`, hash and signature. Throws a CrubalError
+ * naming what is missing. Returns the bundle and the classification.
+ */
+export declare function publish(source: string | Parsed, o: PublishOptions): {
+    bundle: JsonObject;
+    changes: Change[];
+};