@xtyle/core 0.5.0

package/dist/emit/monaco.js

@@ -0,0 +1,80 @@
+import { formatCss, schemeOf, toOklchColor } from "../color.js";
+// Each code scope maps to the Monaco/TextMate token names it should colour. Monaco
+// matches rules by token-name prefix, so listing the common scopes folds the long
+// tail onto the canonical family the same way the Prism emitter does.
+const SCOPE_RULES = {
+    comment: ["comment"],
+    keyword: ["keyword", "storage", "keyword.control"],
+    string: ["string", "string.value"],
+    number: ["number", "constant.numeric"],
+    function: ["function", "entity.name.function", "support.function"],
+    type: [
+        "type",
+        "type.identifier",
+        "class",
+        "struct",
+        "interface",
+        "enum",
+        "support.type",
+        "support.class",
+        "entity.name.type",
+        "entity.name.class",
+    ],
+    variable: ["variable", "identifier", "parameter", "property", "member"],
+    operator: ["operator"],
+    punctuation: ["delimiter", "delimiter.bracket", "delimiter.parenthesis", "delimiter.square"],
+    tag: ["tag", "entity.name.tag", "metatag"],
+    attr: ["attribute.name", "entity.other.attribute-name"],
+    regexp: ["regexp", "string.regexp"],
+};
+/**
+ * Emit a Monaco `IStandaloneThemeData` object that colours the editor from the
+ * derived `--code-*` family. Monaco wants opaque rule foregrounds as bare 6-digit
+ * hex and workbench `colors` as `#rrggbb[aa]`, so the engine's CSS values (which can
+ * be `rgba(...)`) are normalised through the same OKLCH round-trip the core uses.
+ */
+export function emitMonaco(register) {
+    // `formatCss` renders alpha colours as `rgba(...)`; Monaco only speaks hex, so
+    // fold both of its output shapes into `#rrggbb` / `#rrggbbaa`.
+    const hex = (token) => {
+        const value = register[token];
+        if (!value)
+            return undefined;
+        const css = formatCss(toOklchColor(value));
+        if (css.startsWith("#"))
+            return css;
+        const parts = css
+            .match(/rgba?\(([^)]+)\)/)?.[1]
+            ?.split(",")
+            .map((s) => s.trim());
+        if (!parts)
+            return css;
+        const byte = (n) => Math.round(n).toString(16).padStart(2, "0");
+        const [r, g, b] = parts.slice(0, 3).map((n) => byte(Number.parseFloat(n)));
+        const a = parts[3] === undefined ? "" : byte(Number.parseFloat(parts[3]) * 255);
+        return `#${r}${g}${b}${a}`;
+    };
+    const rules = [];
+    for (const [role, tokens] of Object.entries(SCOPE_RULES)) {
+        const fg = hex(`--code-${role}`);
+        if (!fg)
+            continue;
+        const foreground = fg.slice(1, 7);
+        for (const token of tokens)
+            rules.push({ token, foreground });
+    }
+    const bg = register["--code-bg"];
+    const base = bg && schemeOf(bg) === "light" ? "vs" : "vs-dark";
+    const colors = {};
+    const color = (key, token) => {
+        const v = hex(token);
+        if (v)
+            colors[key] = v;
+    };
+    color("editor.background", "--code-bg");
+    color("editor.foreground", "--code-fg");
+    color("editor.lineHighlightBackground", "--code-line-highlight");
+    color("editor.selectionBackground", "--code-selection");
+    return `${JSON.stringify({ base, inherit: true, rules, colors }, null, 2)}\n`;
+}
+//# sourceMappingURL=monaco.js.map

package/dist/emit/monaco.js.map

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

package/dist/emit/prism.d.ts

@@ -0,0 +1,9 @@
+import type { TokenRegister } from "../types.js";
+/**
+ * Emit a Prism-compatible stylesheet that maps Prism's token classes onto the
+ * derived `--code-*` family. Rules reference the custom properties (with the
+ * resolved value as a static fallback), so a themed page re-colours live as the
+ * theme switches, and a copied-out sheet still works standalone.
+ */
+export declare function emitPrism(register: TokenRegister): string;
+//# sourceMappingURL=prism.d.ts.map

package/dist/emit/prism.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prism.d.ts","sourceRoot":"","sources":["../../src/emit/prism.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmBjD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAiBzD"}

package/dist/emit/prism.js

@@ -0,0 +1,37 @@
+const SCOPE_SELECTORS = {
+    comment: [".token.comment", ".token.prolog", ".token.doctype", ".token.cdata"],
+    punctuation: [".token.punctuation"],
+    tag: [".token.tag", ".token.property", ".token.symbol", ".token.deleted"],
+    number: [".token.number", ".token.boolean", ".token.constant"],
+    string: [".token.string", ".token.char", ".token.selector", ".token.inserted"],
+    attr: [".token.attr-name"],
+    operator: [".token.operator", ".token.entity", ".token.url"],
+    keyword: [".token.keyword", ".token.atrule", ".token.attr-value"],
+    function: [".token.function"],
+    type: [".token.class-name", ".token.builtin"],
+    regexp: [".token.regex", ".token.important"],
+    variable: [".token.variable"],
+};
+const CONTAINER = 'code[class*="language-"], pre[class*="language-"]';
+/**
+ * Emit a Prism-compatible stylesheet that maps Prism's token classes onto the
+ * derived `--code-*` family. Rules reference the custom properties (with the
+ * resolved value as a static fallback), so a themed page re-colours live as the
+ * theme switches, and a copied-out sheet still works standalone.
+ */
+export function emitPrism(register) {
+    const ref = (token) => {
+        const value = register[token];
+        return value ? `var(${token}, ${value})` : `var(${token})`;
+    };
+    const rules = [
+        `${CONTAINER} {\n\tcolor: ${ref("--code-fg")};\n\tbackground: ${ref("--code-bg")};\n}`,
+        `${CONTAINER} ::selection,\n${CONTAINER}::selection {\n\tbackground: ${ref("--code-selection")};\n}`,
+        `.line-highlight {\n\tbackground: ${ref("--code-line-highlight")};\n}`,
+    ];
+    for (const [scope, selectors] of Object.entries(SCOPE_SELECTORS)) {
+        rules.push(`${selectors.join(",\n")} {\n\tcolor: ${ref(`--code-${scope}`)};\n}`);
+    }
+    return `${rules.join("\n\n")}\n`;
+}
+//# sourceMappingURL=prism.js.map

package/dist/emit/prism.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prism.js","sourceRoot":"","sources":["../../src/emit/prism.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAA6B;IACjD,OAAO,EAAE,CAAC,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAC9E,WAAW,EAAE,CAAC,oBAAoB,CAAC;IACnC,GAAG,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,CAAC;IACzE,MAAM,EAAE,CAAC,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,CAAC;IAC9D,MAAM,EAAE,CAAC,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,CAAC;IAC9E,IAAI,EAAE,CAAC,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,YAAY,CAAC;IAC5D,OAAO,EAAE,CAAC,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,CAAC;IACjE,QAAQ,EAAE,CAAC,iBAAiB,CAAC;IAC7B,IAAI,EAAE,CAAC,mBAAmB,EAAE,gBAAgB,CAAC;IAC7C,MAAM,EAAE,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAC5C,QAAQ,EAAE,CAAC,iBAAiB,CAAC;CAC7B,CAAC;AAEF,MAAM,SAAS,GAAG,mDAAmD,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,QAAuB;IAChD,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,KAAK,GAAa;QACvB,GAAG,SAAS,gBAAgB,GAAG,CAAC,WAAW,CAAC,oBAAoB,GAAG,CAAC,WAAW,CAAC,MAAM;QACtF,GAAG,SAAS,kBAAkB,SAAS,gCAAgC,GAAG,CAAC,kBAAkB,CAAC,MAAM;QACpG,oCAAoC,GAAG,CAAC,uBAAuB,CAAC,MAAM;KACtE,CAAC;IAEF,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,UAAU,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AAClC,CAAC"}

package/dist/gauntlet.d.ts

@@ -0,0 +1,27 @@
+import type { Algorithm, Knobs, Seeds } from "./types.js";
+export interface GauntletOptions {
+    runs?: number;
+    seed?: number;
+    knobs?: Knobs;
+}
+export interface GauntletFailure {
+    run: number;
+    seeds: Seeds;
+    knobs: Knobs;
+    invariant: string;
+    detail?: string;
+}
+export interface GauntletReport {
+    algorithm: string;
+    runs: number;
+    passed: number;
+    failures: GauntletFailure[];
+    ok: boolean;
+}
+export type GauntletDepth = "quick" | "standard" | "full";
+/** Run counts per depth tier: `quick` for a spot-check during iteration, `full` for the
+ * production battery. The CLI takes `--depth`; the test suite reads `XTYLE_GAUNTLET_DEPTH`. */
+export declare const GAUNTLET_DEPTH_RUNS: Record<GauntletDepth, number>;
+export declare function resolveDepth(value: string | undefined): GauntletDepth;
+export declare function gauntlet(algorithm: Algorithm, opts?: GauntletOptions): GauntletReport;
+//# sourceMappingURL=gauntlet.d.ts.map

package/dist/gauntlet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gauntlet.d.ts","sourceRoot":"","sources":["../src/gauntlet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,SAAS,EAGT,KAAK,EAEL,KAAK,EAEL,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,EAAE,EAAE,OAAO,CAAC;CACZ;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D;+FAC+F;AAC/F,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI7D,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAErE;AAgHD,wBAAgB,QAAQ,CACvB,SAAS,EAAE,SAAS,EACpB,IAAI,GAAE,eAAoB,GACxB,cAAc,CAuEhB"}

package/dist/gauntlet.js

@@ -0,0 +1,199 @@
+import { contrast, formatCss, oklch } from "./color.js";
+/** The three common seed colors expressed as the token constraints they actually are. */
+function seedsToConstraints(seeds) {
+    const out = {};
+    if (seeds.bg !== undefined)
+        out["--bg-0"] = seeds.bg;
+    if (seeds.fg !== undefined)
+        out["--fg-0"] = seeds.fg;
+    if (seeds.accent !== undefined)
+        out["--accent"] = seeds.accent;
+    return out;
+}
+/** Run counts per depth tier: `quick` for a spot-check during iteration, `full` for the
+ * production battery. The CLI takes `--depth`; the test suite reads `XTYLE_GAUNTLET_DEPTH`. */
+export const GAUNTLET_DEPTH_RUNS = {
+    quick: 40,
+    standard: 150,
+    full: 250,
+};
+export function resolveDepth(value) {
+    return value === "quick" || value === "full" ? value : "standard";
+}
+function mulberry32(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+const EXTREMES = [
+    { bg: "#000000", fg: "#ffffff", accent: "#ff0000" },
+    { bg: "#ffffff", fg: "#000000", accent: "#0000ff" },
+    { bg: "#000000", fg: "#000000", accent: "#00ff00" },
+    { bg: "#ffffff", fg: "#ffffff", accent: "#ffff00" },
+    { bg: "#808080", fg: "#808080", accent: "#808080" },
+    { bg: "#010101", fg: "#020202", accent: "#ff00ff" },
+    { bg: "#fefefe", fg: "#fdfdfd", accent: "#00ffff" },
+    { bg: "#123456", fg: "#abcdef", accent: "#fedcba" },
+];
+function randomSeeds(rand) {
+    const color = () => formatCss(oklch(rand(), rand() * 0.4, rand() * 360));
+    return { bg: color(), fg: color(), accent: color() };
+}
+const SCHEME_DRAWS = [undefined, "dark", "light"];
+const SHIFT_STEP_DRAWS = [30, 45, 90, 120];
+const ACCENT_SPLIT_DRAWS = [20, 30, 45, 60];
+const CONSTRAINT_TARGETS = ["--accent", "--bg-0"];
+const CONTRAST_DRAWS = [undefined, "aa", "aaa", 5];
+const VIBRANCY_DRAWS = [undefined, 0, 0.5, 1];
+const TYPE_SCALE_DRAWS = [undefined, 1.125, 1.25, 1.414];
+const RADIUS_SCALE_DRAWS = [undefined, 0, 1, 2];
+const DENSITY_DRAWS = [
+    undefined,
+    "compact",
+    "normal",
+    "comfortable",
+];
+// Hour-of-day coverage for the nxi-nite day/night algorithm. Neutral on the others (a
+// no-op knob a settle-only pipeline ignores) — a coverage range, not an opinion. Without
+// it the gauntlet never varies hour and "AA at every hour" goes untested.
+const HOUR_DRAWS = [undefined, 0, 6, 12, 18, 23, 24];
+const POLE_WHITE = oklch(0.98, 0, 0);
+const POLE_BLACK = oklch(0.15, 0, 0);
+function headroomColor(rand) {
+    for (let i = 0; i < 24; i++) {
+        const c = oklch(rand(), rand() * 0.4, rand() * 360);
+        if (Math.max(contrast(c, POLE_WHITE), contrast(c, POLE_BLACK)) >= 4.75) {
+            return formatCss(c);
+        }
+    }
+    return formatCss(oklch(rand() < 0.5 ? 0.12 : 0.96, rand() * 0.12, rand() * 360));
+}
+function midLightnessColor(rand) {
+    const l = 0.4 + rand() * 0.35;
+    const c = rand() < 0.5 ? 0 : rand() * 0.12;
+    return formatCss(oklch(l, c, rand() * 360));
+}
+function pick(rand, items) {
+    return items[Math.floor(rand() * items.length) % items.length];
+}
+function randomKnobs(rand, base, run) {
+    const knobs = { ...base };
+    if (base.scheme === undefined) {
+        const scheme = pick(rand, SCHEME_DRAWS);
+        if (scheme)
+            knobs.scheme = scheme;
+    }
+    if (base.accentShiftStep === undefined) {
+        knobs.accentShiftStep = pick(rand, SHIFT_STEP_DRAWS);
+    }
+    // Walked deterministically by run index — fuzzing the split this way covers its values without
+    // consuming the shared RNG, so adding it leaves every other draw's sequence byte-identical.
+    if (base.accentSplit === undefined) {
+        knobs.accentSplit = ACCENT_SPLIT_DRAWS[run % ACCENT_SPLIT_DRAWS.length];
+    }
+    if (base.contrastBand === undefined) {
+        const band = pick(rand, CONTRAST_DRAWS);
+        if (band !== undefined)
+            knobs.contrastBand = band;
+    }
+    if (base.vibrancy === undefined) {
+        const v = pick(rand, VIBRANCY_DRAWS);
+        if (v !== undefined)
+            knobs.vibrancy = v;
+    }
+    if (base.typeScale === undefined) {
+        const v = pick(rand, TYPE_SCALE_DRAWS);
+        if (v !== undefined)
+            knobs.typeScale = v;
+    }
+    if (base.radiusScale === undefined) {
+        const v = pick(rand, RADIUS_SCALE_DRAWS);
+        if (v !== undefined)
+            knobs.radiusScale = v;
+    }
+    if (base.density === undefined) {
+        const v = pick(rand, DENSITY_DRAWS);
+        if (v !== undefined)
+            knobs.density = v;
+    }
+    if (base.hour === undefined) {
+        const v = pick(rand, HOUR_DRAWS);
+        if (v !== undefined)
+            knobs.hour = v;
+    }
+    return knobs;
+}
+export function gauntlet(algorithm, opts = {}) {
+    const runs = opts.runs ?? 100;
+    const rand = mulberry32(opts.seed ?? 0x9e3779b9);
+    const failures = [];
+    let passed = 0;
+    const baseKnobs = { ...opts.knobs };
+    for (let run = 0; run < runs; run++) {
+        const seeds = run < EXTREMES.length
+            ? EXTREMES[run]
+            : randomSeeds(rand);
+        const knobs = randomKnobs(rand, baseKnobs, run);
+        // The seeds and any extra pins all enter through the one token channel; an extra draw can
+        // override a seed (e.g. re-pinning `--bg-0`), which is exactly the layering the engine allows.
+        const constraints = seedsToConstraints(seeds);
+        if (run % 5 === 0) {
+            constraints[pick(rand, CONSTRAINT_TARGETS)] = headroomColor(rand);
+        }
+        else if (run % 5 === 2) {
+            constraints["--bg-0"] = midLightnessColor(rand);
+        }
+        const register = algorithm.derive({ knobs, constraints });
+        const scheme = (knobs.scheme ?? register["--scheme"]) ?? "dark";
+        const ctx = {
+            register,
+            knobs,
+            scheme,
+            categories: algorithm.categories,
+            constraints,
+        };
+        let runOk = true;
+        if (constraints) {
+            for (const [name, value] of Object.entries(constraints)) {
+                if (register[name] !== value) {
+                    runOk = false;
+                    failures.push({
+                        run,
+                        seeds,
+                        knobs,
+                        invariant: "pinned token honored verbatim",
+                        detail: `${name}=${register[name]} expected ${value}`,
+                    });
+                }
+            }
+        }
+        for (const invariant of algorithm.invariants) {
+            const result = invariant(ctx);
+            if (!result.ok) {
+                runOk = false;
+                failures.push({
+                    run,
+                    seeds,
+                    knobs,
+                    invariant: result.name,
+                    detail: result.detail,
+                });
+            }
+        }
+        if (runOk)
+            passed++;
+    }
+    return {
+        algorithm: algorithm.id,
+        runs,
+        passed,
+        failures,
+        ok: failures.length === 0,
+    };
+}
+//# sourceMappingURL=gauntlet.js.map

package/dist/gauntlet.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,21 @@
+import type { TokenName, TokenRegister } from "./types.js";
+export interface TokenNode {
+    name: TokenName;
+    value?: string;
+    refs?: TokenName[];
+    resolve?: (inputs: TokenRegister) => string;
+}
+export declare class CycleError extends Error {
+    readonly cycle: TokenName[];
+    constructor(cycle: TokenName[]);
+}
+/**
+ * Resolves a token graph to a register. Values are computed in topological order
+ * — a node's `refs` are resolved before its own `resolve` runs, so every closure
+ * sees its inputs already materialized — while the returned register preserves the
+ * node declaration order, so output key order is stable and independent of the
+ * dependency edges. Throws {@link CycleError} on a cyclic `refs` chain.
+ */
+export declare function resolveGraph(nodes: TokenNode[]): TokenRegister;
+export declare function applyConstraints(register: TokenRegister, constraints: TokenRegister | undefined): TokenRegister;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,CAAC;CAC5C;AAED,qBAAa,UAAW,SAAQ,KAAK;aACR,KAAK,EAAE,SAAS,EAAE;gBAAlB,KAAK,EAAE,SAAS,EAAE;CAI9C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,aAAa,CAwC9D;AAED,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,aAAa,GAAG,SAAS,GACpC,aAAa,CAGf"}

package/dist/graph.js

@@ -0,0 +1,66 @@
+export class CycleError extends Error {
+    cycle;
+    constructor(cycle) {
+        super(`xtyle: cycle detected in token graph: ${cycle.join(" -> ")}`);
+        this.cycle = cycle;
+        this.name = "CycleError";
+    }
+}
+/**
+ * Resolves a token graph to a register. Values are computed in topological order
+ * — a node's `refs` are resolved before its own `resolve` runs, so every closure
+ * sees its inputs already materialized — while the returned register preserves the
+ * node declaration order, so output key order is stable and independent of the
+ * dependency edges. Throws {@link CycleError} on a cyclic `refs` chain.
+ */
+export function resolveGraph(nodes) {
+    const byName = new Map();
+    for (const node of nodes)
+        byName.set(node.name, node);
+    const computed = new Map();
+    const visiting = new Set();
+    const done = new Set();
+    const stack = [];
+    const visit = (name) => {
+        if (done.has(name))
+            return;
+        const node = byName.get(name);
+        if (!node)
+            return;
+        if (visiting.has(name)) {
+            const start = stack.indexOf(name);
+            throw new CycleError([...stack.slice(start), name]);
+        }
+        visiting.add(name);
+        stack.push(name);
+        for (const ref of node.refs ?? [])
+            visit(ref);
+        if (node.resolve) {
+            const inputs = {};
+            for (const [key, value] of computed)
+                inputs[key] = value;
+            computed.set(name, node.resolve(inputs));
+        }
+        else if (node.value !== undefined) {
+            computed.set(name, node.value);
+        }
+        stack.pop();
+        visiting.delete(name);
+        done.add(name);
+    };
+    for (const node of nodes)
+        visit(node.name);
+    const resolved = {};
+    for (const node of nodes) {
+        const value = computed.get(node.name);
+        if (value !== undefined)
+            resolved[node.name] = value;
+    }
+    return resolved;
+}
+export function applyConstraints(register, constraints) {
+    if (!constraints)
+        return { ...register };
+    return { ...register, ...constraints };
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/host/algorithms-bundle.generated.d.ts

@@ -0,0 +1,5 @@
+export declare const ALGORITHM_BUNDLES: Record<string, {
+    manifest: unknown;
+    source: string;
+}>;
+//# sourceMappingURL=algorithms-bundle.generated.d.ts.map

package/dist/host/algorithms-bundle.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithms-bundle.generated.d.ts","sourceRoot":"","sources":["../../src/host/algorithms-bundle.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAA4+w9B,CAAC"}