@cogitato/kit-cli 0.0.0-stage → 0.1.0

package/dist/links.js

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync } from "node:fs";
+import { DEFAULT_PORT } from "./doctor.js";
+import { KitError } from "./errors.js";
+import { sourceFiles } from "./project.js";
+import { readRegistry } from "./registry.js";
+export const CANVAS_PATH = "/__canvas";
+/** Finds the screen and state for "{screen id}.{state}" or a bare screen id (its default state). */
+function resolveNode(project, node) {
+    const { screens } = readRegistry(project, sourceFiles(project));
+    let screen = screens.find((s) => s.id === node);
+    let state = "default";
+    if (!screen) {
+        const dot = node.lastIndexOf(".");
+        screen = screens.find((s) => s.id === node.slice(0, dot));
+        state = node.slice(dot + 1);
+    }
+    if (!screen)
+        throw new KitError(`There's no screen or state called "${node}".`);
+    if (!screen.fixtures.some((f) => f.key === state)) {
+        throw new KitError(`The ${screen.title} screen has no state called "${state}".`);
+    }
+    return { screen, state };
+}
+/**
+ * Local address of a screen state, like http://localhost:5173/checkout/payment?fixture=card-declined.
+ * `node` is "{screen id}.{state}" or just a screen id (its default state).
+ */
+export function stateLink(project, node, port = DEFAULT_PORT) {
+    const { screen, state } = resolveNode(project, node);
+    return `http://localhost:${port}${screen.route}?fixture=${encodeURIComponent(state)}`;
+}
+/** Local canvas, opened on one state's frame. */
+export function canvasLink(project, node, port = DEFAULT_PORT) {
+    const { screen, state } = resolveNode(project, node);
+    return `http://localhost:${port}${CANVAS_PATH}?focus=${encodeURIComponent(`${screen.id}.${state}`)}`;
+}
+/** Netlify's form of a branch name in branch-deploy addresses: "design/sam-0102" -> "design-sam-0102". */
+export function branchSlug(branch) {
+    return branch.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+/**
+ * Hosted canvas for a branch, from `"kit": { "previewUrl": "https://{branch}--site.netlify.app" }`
+ * in the prototype's package.json. Undefined when the prototype has no hosting set up.
+ */
+export function previewLink(project, branch, node) {
+    const pkgPath = project.abs("package.json");
+    if (!existsSync(pkgPath))
+        return undefined;
+    let template;
+    try {
+        template = JSON.parse(readFileSync(pkgPath, "utf8")).kit?.previewUrl;
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof template !== "string" || !template.includes("{branch}"))
+        return undefined;
+    const base = template.replace("{branch}", branchSlug(branch)).replace(/\/+$/, "");
+    return `${base}${CANVAS_PATH}${node ? `?focus=${encodeURIComponent(node)}` : ""}`;
+}
+//# sourceMappingURL=links.js.map

package/dist/links.js.map

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

package/dist/preview.d.ts

@@ -0,0 +1,16 @@
+import { type ChildProcess } from "node:child_process";
+import type { Project } from "./project.js";
+export declare const KIT_PATH = "/__kit";
+export interface PreviewOptions {
+    port?: number;
+    open?: boolean;
+    /** Called with progress messages for the person running the command. */
+    log?: (message: string) => void;
+}
+export interface PreviewResult {
+    url: string;
+    /** The dev server Cogitato started, if it wasn't already running. Resolves when it exits. */
+    server?: ChildProcess;
+}
+/** Makes sure the prototype is running, then opens its /__kit page with every token and component. */
+export declare function preview(project: Project, opts?: PreviewOptions): Promise<PreviewResult>;

package/dist/preview.js

@@ -0,0 +1,38 @@
+import { spawn } from "node:child_process";
+import { DEFAULT_PORT, isServerUp } from "./doctor.js";
+export const KIT_PATH = "/__kit";
+function openInBrowser(url) {
+    const [cmd, args] = process.platform === "win32"
+        ? ["cmd", ["/c", "start", "", url]]
+        : process.platform === "darwin"
+            ? ["open", [url]]
+            : ["xdg-open", [url]];
+    spawn(cmd, args, { stdio: "ignore", detached: true }).unref();
+}
+/** Makes sure the prototype is running, then opens its /__kit page with every token and component. */
+export async function preview(project, opts = {}) {
+    const port = opts.port ?? DEFAULT_PORT;
+    const url = `http://localhost:${port}${KIT_PATH}`;
+    const log = opts.log ?? (() => { });
+    let server;
+    if (!(await isServerUp(port))) {
+        log("Starting the prototype...");
+        server = spawn("pnpm", ["exec", "vite", "--port", String(port), "--strictPort"], {
+            cwd: project.root,
+            stdio: "inherit",
+            shell: true,
+        });
+        const deadline = Date.now() + 30_000;
+        while (!(await isServerUp(port))) {
+            if (server.exitCode !== null || Date.now() > deadline) {
+                throw new Error("The prototype didn't start. Run kit doctor to see what's missing.");
+            }
+            await new Promise((r) => setTimeout(r, 300));
+        }
+    }
+    log(`The design kit is at ${url}`);
+    if (opts.open !== false)
+        openInBrowser(url);
+    return { url, ...(server ? { server } : {}) };
+}
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAejC,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GACf,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC7B,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAgB,EAAE,OAAuB,EAAE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;IACvC,MAAM,GAAG,GAAG,oBAAoB,IAAI,GAAG,QAAQ,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEnC,IAAI,MAAgC,CAAC;IACrC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACjC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,EAAE;YAC/E,GAAG,EAAE,OAAO,CAAC,IAAI;YACjB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACvF,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,GAAG,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,35 @@
+import { type ComponentManifest, type ResolvedToken } from "@cogitato/contract";
+/** Folder and file conventions every Cogitato prototype follows (no config file in v1). */
+export declare const LAYOUT: {
+    readonly design: "design";
+    readonly contract: "design/contract";
+    readonly flowsJson: "design/flows.json";
+    readonly src: "src";
+    readonly screens: "src/screens";
+    readonly kit: "src/kit";
+    readonly flowsTs: "src/flows.ts";
+    readonly screenFile: "screen.tsx";
+};
+export interface Project {
+    /** Absolute path of the prototype root (the folder holding design/ and src/). */
+    root: string;
+    /** Absolute path for a project-relative path. */
+    abs(rel: string): string;
+    /** Project-relative path with "/" separators. */
+    rel(abs: string): string;
+}
+/** Finds the prototype root by walking up from `from` to the first folder containing design/contract. */
+export declare function findProject(from?: string): Project | undefined;
+export declare function projectAt(root: string): Project;
+/** Every .ts, .tsx and .css file under src/, project-relative, sorted. */
+export declare function sourceFiles(project: Project): string[];
+export declare const isScreenFile: (rel: string) => boolean;
+export declare const isKitFile: (rel: string) => boolean;
+/** What the code rules need from the contract. Read leniently: contract problems are reported by contract validation. */
+export interface ContractView {
+    tokens: ResolvedToken[];
+    /** Every CSS custom property the runtime defines, taken from the generated token CSS itself. */
+    cssVars: Set<string>;
+    manifests: Map<string, ComponentManifest>;
+}
+export declare function readContract(project: Project): ContractView;

package/dist/project.js

@@ -0,0 +1,88 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { resolveTokens, tokensToCss, } from "@cogitato/contract";
+/** Folder and file conventions every Cogitato prototype follows (no config file in v1). */
+export const LAYOUT = {
+    design: "design",
+    contract: "design/contract",
+    flowsJson: "design/flows.json",
+    src: "src",
+    screens: "src/screens",
+    kit: "src/kit",
+    flowsTs: "src/flows.ts",
+    screenFile: "screen.tsx",
+};
+/** Finds the prototype root by walking up from `from` to the first folder containing design/contract. */
+export function findProject(from = process.cwd()) {
+    let dir = resolve(from);
+    for (;;) {
+        if (existsSync(join(dir, LAYOUT.contract)))
+            return projectAt(dir);
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+export function projectAt(root) {
+    return {
+        root,
+        abs: (rel) => (isAbsolute(rel) ? rel : join(root, rel)),
+        rel: (abs) => relative(root, isAbsolute(abs) ? abs : join(root, abs)).split(sep).join("/"),
+    };
+}
+const SOURCE = /\.(tsx?|css)$/;
+/** Every .ts, .tsx and .css file under src/, project-relative, sorted. */
+export function sourceFiles(project) {
+    const out = [];
+    const walk = (dir) => {
+        if (!existsSync(dir))
+            return;
+        for (const name of readdirSync(dir)) {
+            if (name === "node_modules" || name.startsWith("."))
+                continue;
+            const path = join(dir, name);
+            if (statSync(path).isDirectory())
+                walk(path);
+            else if (SOURCE.test(name) && !name.endsWith(".d.ts"))
+                out.push(project.rel(path));
+        }
+    };
+    walk(project.abs(LAYOUT.src));
+    return out.sort();
+}
+export const isScreenFile = (rel) => rel.startsWith(`${LAYOUT.screens}/`) && rel.endsWith(`/${LAYOUT.screenFile}`);
+export const isKitFile = (rel) => rel.startsWith(`${LAYOUT.kit}/`);
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readContract(project) {
+    const tokensJson = readJson(project.abs(`${LAYOUT.contract}/tokens.json`));
+    let tokens = [];
+    let cssVars = new Set();
+    try {
+        if (tokensJson) {
+            tokens = resolveTokens(tokensJson);
+            cssVars = new Set(tokensToCss(tokensJson).match(/--kit-[A-Za-z0-9_-]+(?=:)/g) ?? []);
+        }
+    }
+    catch {
+        tokens = [];
+    }
+    const manifests = new Map();
+    const dir = project.abs(`${LAYOUT.contract}/components`);
+    if (existsSync(dir)) {
+        for (const f of readdirSync(dir).filter((f) => f.endsWith(".json"))) {
+            const m = readJson(join(dir, f));
+            if (m && typeof m.name === "string")
+                manifests.set(m.name, m);
+        }
+    }
+    return { tokens, cssVars, manifests };
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,67 @@
+import ts from "typescript";
+import { type Issue } from "./issue.js";
+import { type Project } from "./project.js";
+export declare const ID_PATTERNS: {
+    screenId: RegExp;
+    slug: RegExp;
+    kitId: RegExp;
+    nodeRef: RegExp;
+};
+interface Located {
+    file: string;
+    line: number;
+    column: number;
+}
+export interface FixtureEntry extends Located {
+    key: string;
+    title: string;
+}
+export interface ScreenEntry extends Located {
+    id: string;
+    route: string;
+    title: string;
+    fixtures: FixtureEntry[];
+    /** Folder of the screen (project-relative). Files inside it belong to this screen. */
+    dir: string;
+}
+export interface EdgeEntry extends Located {
+    from: string;
+    to: string;
+    label?: string;
+}
+export interface FlowEntry extends Located {
+    id: string;
+    title: string;
+    nodes?: {
+        ref: string;
+        at: Located;
+    }[];
+    edges: EdgeEntry[];
+}
+export interface Registry {
+    screens: ScreenEntry[];
+    flows: FlowEntry[];
+    issues: Issue[];
+    /**
+     * False when a screen file couldn't be read as a screen. Flow checks are skipped then:
+     * they'd report that screen's states as missing, which only repeats the real problem.
+     */
+    complete: boolean;
+}
+/** "card-declined" -> "Card declined". Same rule as the runtime's fixture titles. */
+export declare function humanize(key: string): string;
+/** Reads the defineScreen({...}) registration in one screen.tsx. */
+export declare function readScreen(sf: ts.SourceFile): {
+    screen?: ScreenEntry;
+    issues: Issue[];
+};
+/** Reads defineFlows([...]) from src/flows.ts. */
+export declare function readFlows(sf: ts.SourceFile): {
+    flows: FlowEntry[];
+    issues: Issue[];
+};
+/** Parses a project file, reusing the parse while its text is unchanged (keeps repeat runs fast). */
+export declare function parseProjectFile(project: Project, rel: string): ts.SourceFile;
+/** Reads every screen registration and src/flows.ts. Never runs prototype code. */
+export declare function readRegistry(project: Project, files: string[]): Registry;
+export {};

package/dist/registry.js

@@ -0,0 +1,224 @@
+import { existsSync, readFileSync } from "node:fs";
+import { readSchema } from "@cogitato/contract";
+import ts from "typescript";
+import { findCalls, getProperty, issueAt, literalText, parseSource, propertyName } from "./issue.js";
+import { LAYOUT, isScreenFile } from "./project.js";
+// Id formats come from the shared schema so the reader and the validators can't disagree.
+const common = readSchema("common.schema.json");
+const pattern = (name) => new RegExp(common.$defs[name].pattern);
+export const ID_PATTERNS = {
+    screenId: pattern("screenId"),
+    slug: pattern("slug"),
+    kitId: pattern("kitId"),
+    nodeRef: pattern("nodeRef"),
+};
+/** "card-declined" -> "Card declined". Same rule as the runtime's fixture titles. */
+export function humanize(key) {
+    const words = key.replace(/[-_.]+/g, " ").trim();
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function locate(sf, node) {
+    const { line, character } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+    return { file: sf.fileName, line: line + 1, column: character + 1 };
+}
+const notStatic = (sf, node, what, example) => issueAt("code-screen-not-static", sf, node, `Write ${what} as plain text, like ${example}, so Cogitato can find it without running the code.`);
+/** Reads the defineScreen({...}) registration in one screen.tsx. */
+export function readScreen(sf) {
+    const issues = [];
+    const calls = findCalls(sf, "defineScreen");
+    if (calls.length === 0) {
+        const first = sf.statements[0] ?? sf;
+        issues.push(issueAt("code-screen-missing", sf, first, `${sf.fileName} doesn't register a screen. Export one with \`export default defineScreen({ ... })\`.`));
+        return { issues };
+    }
+    const call = calls[0];
+    const arg = call.arguments[0];
+    if (!arg || !ts.isObjectLiteralExpression(arg)) {
+        issues.push(notStatic(sf, arg ?? call, "the screen's settings", "`defineScreen({ id: \"cart\", ... })`"));
+        return { issues };
+    }
+    const text = (key, example) => {
+        const prop = getProperty(arg, key);
+        const shorthand = arg.properties.find((p) => ts.isShorthandPropertyAssignment(p) && p.name.text === key);
+        if (!prop && shorthand) {
+            issues.push(notStatic(sf, shorthand, `the screen's ${key}`, `\`${key}: ${example}\``));
+            return undefined;
+        }
+        if (!prop) {
+            issues.push(issueAt("code-screen-incomplete", sf, arg, `This screen is missing its \`${key}\`. Add it, like \`${key}: ${example}\`.`));
+            return undefined;
+        }
+        const value = literalText(prop.initializer);
+        if (value === undefined)
+            issues.push(notStatic(sf, prop.initializer, `the screen's ${key}`, `\`${example}\``));
+        return value;
+    };
+    const id = text("id", '"checkout.payment"');
+    const route = text("route", '"/checkout/payment"');
+    const title = text("title", '"Payment"');
+    if (id !== undefined && !ID_PATTERNS.screenId.test(id)) {
+        issues.push(issueAt("code-invalid-screen-id", sf, getProperty(arg, "id").initializer, `"${id}" isn't a valid screen id. Screen ids are lowercase words separated by dots, like "checkout.payment".`));
+    }
+    if (route !== undefined && !route.startsWith("/")) {
+        issues.push(issueAt("code-invalid-route", sf, getProperty(arg, "route").initializer, `The address "${route}" needs to start with "/", like "/checkout/payment".`));
+    }
+    const fixtures = [];
+    const fixturesProp = getProperty(arg, "fixtures");
+    if (!fixturesProp) {
+        issues.push(issueAt("code-missing-default-fixture", sf, arg, `This screen has no states. Add \`fixtures: { default: { data: {} } }\`; every screen needs a "default" state.`));
+    }
+    else if (!ts.isObjectLiteralExpression(fixturesProp.initializer)) {
+        issues.push(notStatic(sf, fixturesProp.initializer, "the screen's states (fixtures)", "`fixtures: { default: { data: {...} } }`"));
+    }
+    else {
+        for (const p of fixturesProp.initializer.properties) {
+            const key = ts.isPropertyAssignment(p) ? propertyName(p.name) : undefined;
+            if (!ts.isPropertyAssignment(p) || key === undefined) {
+                issues.push(notStatic(sf, p, "each state's name", '`"card-declined": { data: {...} }`'));
+                continue;
+            }
+            if (!ID_PATTERNS.slug.test(key)) {
+                issues.push(issueAt("code-invalid-fixture-name", sf, p.name, `The state name "${key}" isn't valid. Use lowercase words joined by dashes, like "card-declined".`));
+            }
+            let fixtureTitle = humanize(key);
+            if (ts.isObjectLiteralExpression(p.initializer)) {
+                const titleProp = getProperty(p.initializer, "title");
+                if (titleProp) {
+                    const t = literalText(titleProp.initializer);
+                    if (t === undefined)
+                        issues.push(notStatic(sf, titleProp.initializer, "the state's title", '`title: "Card declined"`'));
+                    else
+                        fixtureTitle = t;
+                }
+            }
+            else {
+                issues.push(notStatic(sf, p.initializer, `the "${key}" state`, '`{ title: "Card declined", data: {...} }`'));
+            }
+            fixtures.push({ key, title: fixtureTitle, ...locate(sf, p.name) });
+        }
+        if (!fixtures.some((f) => f.key === "default")) {
+            issues.push(issueAt("code-missing-default-fixture", sf, fixturesProp.name, `${title ?? "This screen"} has no "default" state. Every screen needs one; it's what the screen shows when it first opens.`));
+        }
+    }
+    if (id === undefined || route === undefined || title === undefined)
+        return { issues };
+    const dir = sf.fileName.slice(0, sf.fileName.lastIndexOf("/"));
+    return { screen: { id, route, title, fixtures, dir, ...locate(sf, call) }, issues };
+}
+/** Reads defineFlows([...]) from src/flows.ts. */
+export function readFlows(sf) {
+    const issues = [];
+    const flows = [];
+    const flowsNotStatic = (node, what, example) => issueAt("code-flows-not-static", sf, node, `Write ${what} as plain text, like ${example}, so Cogitato can read it without running the code.`);
+    const call = findCalls(sf, "defineFlows")[0];
+    if (!call)
+        return { flows, issues };
+    const list = call.arguments[0];
+    if (!list || !ts.isArrayLiteralExpression(list)) {
+        issues.push(flowsNotStatic(list ?? call, "the list of flows", "`defineFlows([{ id: \"checkout\", ... }])`"));
+        return { flows, issues };
+    }
+    for (const el of list.elements) {
+        if (!ts.isObjectLiteralExpression(el)) {
+            issues.push(flowsNotStatic(el, "each flow", '`{ id: "checkout", title: "Checkout", edges: [...] }`'));
+            continue;
+        }
+        const idProp = getProperty(el, "id");
+        const titleProp = getProperty(el, "title");
+        const id = literalText(idProp?.initializer);
+        const title = literalText(titleProp?.initializer);
+        if (id === undefined)
+            issues.push(flowsNotStatic(idProp?.initializer ?? el, "the flow's id", '`id: "checkout"`'));
+        if (title === undefined)
+            issues.push(flowsNotStatic(titleProp?.initializer ?? el, "the flow's title", '`title: "Checkout"`'));
+        const edges = [];
+        const edgesProp = getProperty(el, "edges");
+        if (!edgesProp || !ts.isArrayLiteralExpression(edgesProp.initializer)) {
+            issues.push(flowsNotStatic(edgesProp?.initializer ?? el, "the flow's arrows (edges)", '`edges: [{ from: "cart.default", to: "checkout.shipping.default" }]`'));
+        }
+        else {
+            for (const e of edgesProp.initializer.elements) {
+                const from = ts.isObjectLiteralExpression(e) ? literalText(getProperty(e, "from")?.initializer) : undefined;
+                const to = ts.isObjectLiteralExpression(e) ? literalText(getProperty(e, "to")?.initializer) : undefined;
+                if (!ts.isObjectLiteralExpression(e) || from === undefined || to === undefined) {
+                    issues.push(flowsNotStatic(e, "each arrow", '`{ from: "cart.default", to: "checkout.shipping.default" }`'));
+                    continue;
+                }
+                const labelProp = getProperty(e, "label");
+                const label = literalText(labelProp?.initializer);
+                if (labelProp && label === undefined)
+                    issues.push(flowsNotStatic(labelProp.initializer, "the arrow's label", '`label: "Pay now"`'));
+                edges.push({ from, to, ...(label !== undefined ? { label } : {}), ...locate(sf, e) });
+            }
+        }
+        let nodes;
+        const nodesProp = getProperty(el, "nodes");
+        if (nodesProp) {
+            if (!ts.isArrayLiteralExpression(nodesProp.initializer)) {
+                issues.push(flowsNotStatic(nodesProp.initializer, "the flow's steps (nodes)", '`nodes: ["cart.default"]`'));
+            }
+            else {
+                nodes = [];
+                for (const n of nodesProp.initializer.elements) {
+                    const ref = literalText(n);
+                    if (ref === undefined)
+                        issues.push(flowsNotStatic(n, "each step", '`"cart.default"`'));
+                    else
+                        nodes.push({ ref, at: locate(sf, n) });
+                }
+            }
+        }
+        if (id !== undefined && title !== undefined)
+            flows.push({ id, title, edges, nodes, ...locate(sf, el) });
+    }
+    return { flows, issues };
+}
+const cache = new Map();
+/** Parses a project file, reusing the parse while its text is unchanged (keeps repeat runs fast). */
+export function parseProjectFile(project, rel) {
+    const text = readFileSync(project.abs(rel), "utf8");
+    const hit = cache.get(project.abs(rel));
+    if (hit && hit.text === text)
+        return hit.sf;
+    const sf = parseSource(rel, text);
+    cache.set(project.abs(rel), { text, sf });
+    return sf;
+}
+/** Reads every screen registration and src/flows.ts. Never runs prototype code. */
+export function readRegistry(project, files) {
+    const issues = [];
+    const screens = [];
+    const seen = new Map();
+    let complete = true;
+    for (const rel of files.filter(isScreenFile)) {
+        const r = readScreen(parseProjectFile(project, rel));
+        issues.push(...r.issues);
+        if (!r.screen) {
+            complete = false;
+            continue;
+        }
+        const other = seen.get(r.screen.id);
+        if (other) {
+            issues.push({
+                code: "code-duplicate-screen",
+                severity: "error",
+                file: r.screen.file,
+                path: "",
+                line: r.screen.line,
+                column: r.screen.column,
+                message: `The screen id "${r.screen.id}" is already used by ${other.file}. Each screen needs its own id.`,
+            });
+            continue;
+        }
+        seen.set(r.screen.id, r.screen);
+        screens.push(r.screen);
+    }
+    let flows = [];
+    if (existsSync(project.abs(LAYOUT.flowsTs))) {
+        const r = readFlows(parseProjectFile(project, LAYOUT.flowsTs));
+        issues.push(...r.issues);
+        flows = r.flows;
+    }
+    return { screens, flows, issues, complete };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/rules/css-values.d.ts

@@ -0,0 +1,31 @@
+import type { ContractView } from "../project.js";
+/** Stands in for a `${...}` substitution when a template literal's text is checked. */
+export declare const SUBSTITUTION = "\u0001";
+export type Finding = {
+    kind: "color";
+    literal: string;
+    message: string;
+    suggestion?: string;
+} | {
+    kind: "size";
+    literal: string;
+    message: string;
+    suggestion?: string;
+} | {
+    kind: "unknown-token";
+    literal: string;
+    message: string;
+    suggestion?: string;
+};
+/**
+ * Checks one CSS declaration (or inline style property). `prop` may be camelCase.
+ * Token variables, 0, auto, inherit, transparent, currentColor and percentages are fine.
+ */
+export declare function checkCssValue(contract: ContractView, rawProp: string, value: string): Finding[];
+/** A bare number in a React inline style means pixels. */
+export declare function checkCssNumber(contract: ContractView, rawProp: string, n: number): Finding[];
+export declare const FINDING_CODES: {
+    readonly color: "code-hardcoded-color";
+    readonly size: "code-hardcoded-size";
+    readonly "unknown-token": "code-unknown-token";
+};