@cogitato/kit-cli 0.0.0-stage → 0.2.0

package/dist/scaffold.js

@@ -0,0 +1,232 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import ts from "typescript";
+import { KitError } from "./errors.js";
+import { exportFlows } from "./export-flows.js";
+import { findCalls, getProperty, literalText, parseSource } from "./issue.js";
+import { canvasLink, stateLink } from "./links.js";
+import { LAYOUT, sourceFiles } from "./project.js";
+import { ID_PATTERNS, humanize, readRegistry } from "./registry.js";
+import { validate } from "./validate.js";
+const q = (s) => JSON.stringify(s);
+/** Indentation of the line that `pos` is on. */
+function indentAt(text, pos) {
+    const start = text.lastIndexOf("\n", pos - 1) + 1;
+    return /^[ \t]*/.exec(text.slice(start))[0];
+}
+/**
+ * Adds `item` as the last element of an array or object literal, matching how the existing
+ * elements are laid out (one per line, or all on one line).
+ */
+function appendToLiteral(sf, text, node, item) {
+    const elements = ts.isArrayLiteralExpression(node) ? node.elements : node.properties;
+    const start = node.getStart(sf);
+    const close = node.getEnd() - 1;
+    const last = elements[elements.length - 1];
+    if (!last) {
+        const indent = indentAt(text, start);
+        const open = text[start];
+        return `${text.slice(0, start)}${open}\n${indent}  ${item(`${indent}  `)},\n${indent}${text[close]}${text.slice(node.getEnd())}`;
+    }
+    const lastEnd = last.getEnd();
+    if (!text.slice(start, last.getStart(sf)).includes("\n")) {
+        return `${text.slice(0, lastEnd)}, ${item(indentAt(text, start))}${text.slice(lastEnd)}`;
+    }
+    const indent = indentAt(text, last.getStart(sf));
+    const comma = text.indexOf(",", lastEnd);
+    const at = elements.hasTrailingComma && comma >= 0 && comma < close ? comma + 1 : lastEnd;
+    return `${text.slice(0, at)}${elements.hasTrailingComma ? "" : ","}\n${indent}${item(indent)},${text.slice(at)}`;
+}
+const registryOf = (project) => readRegistry(project, sourceFiles(project));
+function splitNode(node) {
+    const dot = node.lastIndexOf(".");
+    if (dot < 0)
+        throw new KitError(`"${node}" isn't a step. Steps are written as "{screen id}.{state}", like "checkout.payment.default".`);
+    return { screen: node.slice(0, dot), state: node.slice(dot + 1) };
+}
+function requireStep(reg, node) {
+    const { screen, state } = splitNode(node);
+    const s = reg.screens.find((x) => x.id === screen);
+    if (!s)
+        throw new KitError(`There's no screen with the id "${screen}".`);
+    if (!s.fixtures.some((f) => f.key === state)) {
+        throw new KitError(`The ${s.title} screen has no state called "${state}" (it has: ${s.fixtures.map((f) => `"${f.key}"`).join(", ")}).`);
+    }
+}
+function finish(project, files, node) {
+    exportFlows(project);
+    const r = validate(project, { files });
+    return { ...r, files, node, link: stateLink(project, node), canvas: canvasLink(project, node) };
+}
+function componentName(id) {
+    const last = id.slice(id.lastIndexOf(".") + 1);
+    return last.replace(/(^|[-_])([a-z0-9])/g, (_m, _s, c) => c.toUpperCase()) + "Screen";
+}
+function screenSource(id, route, title) {
+    const name = componentName(id);
+    return `import { defineScreen } from "@cogitato/runtime";
+
+// Build this screen with components from the design kit (@/kit/...) and token variables only.
+function ${name}() {
+  return (
+    <main>
+      <h1>${title.replace(/[{}<>]/g, "")}</h1>
+    </main>
+  );
+}
+
+export default defineScreen({
+  id: ${q(id)},
+  route: ${q(route)},
+  title: ${q(title)},
+  fixtures: {
+    default: { title: "Default", data: {} },
+  },
+  component: ${name},
+});
+`;
+}
+/** Creates src/screens/<id as folders>/screen.tsx with a default state, and optionally an arrow to it. */
+export function createScreen(project, opts) {
+    const { id } = opts;
+    if (!ID_PATTERNS.screenId.test(id)) {
+        throw new KitError(`"${id}" isn't a valid screen id. Use lowercase words separated by dots, like "checkout.review".`);
+    }
+    const reg = registryOf(project);
+    if (reg.screens.some((s) => s.id === id))
+        throw new KitError(`There's already a screen called "${id}".`);
+    const route = opts.route ?? `/${id.split(".").join("/")}`;
+    if (route === "/")
+        throw new KitError(`The address "/" is the prototype's list of screens, so a screen can't use it. Pick another one, like "/home".`);
+    if (!route.startsWith("/"))
+        throw new KitError(`The address "${route}" needs to start with "/", like "/checkout/review".`);
+    const clash = reg.screens.find((s) => s.route === route);
+    if (clash)
+        throw new KitError(`The address "${route}" is already used by the ${clash.title} screen. Pick another one.`);
+    if (opts.from)
+        requireStep(reg, opts.from);
+    const file = `${LAYOUT.screens}/${id.split(".").join("/")}/${LAYOUT.screenFile}`;
+    if (existsSync(project.abs(file)))
+        throw new KitError(`${file} already exists. Pick another screen id.`);
+    const title = opts.title?.trim() || humanize(id.slice(id.lastIndexOf(".") + 1));
+    mkdirSync(dirname(project.abs(file)), { recursive: true });
+    writeFileSync(project.abs(file), screenSource(id, route, title));
+    const node = `${id}.default`;
+    const files = [file];
+    if (opts.from)
+        files.push(insertEdge(project, { from: opts.from, to: node, label: opts.label, flow: opts.flow }));
+    return finish(project, files, node);
+}
+function fixturesLiteral(sf) {
+    const arg = findCalls(sf, "defineScreen")[0]?.arguments[0];
+    if (!arg || !ts.isObjectLiteralExpression(arg))
+        return undefined;
+    const init = getProperty(arg, "fixtures")?.initializer;
+    return init && ts.isObjectLiteralExpression(init) ? init : undefined;
+}
+/** Adds a state (fixture) to an existing screen, and optionally an arrow to it. */
+export function addState(project, opts) {
+    const { state } = opts;
+    if (!ID_PATTERNS.slug.test(state)) {
+        throw new KitError(`"${state}" isn't a valid state name. Use lowercase words joined by dashes, like "card-expired".`);
+    }
+    const reg = registryOf(project);
+    const screen = reg.screens.find((s) => s.id === opts.screen);
+    if (!screen)
+        throw new KitError(`There's no screen with the id "${opts.screen}".`);
+    if (screen.fixtures.some((f) => f.key === state))
+        throw new KitError(`The ${screen.title} screen already has a "${state}" state.`);
+    if (opts.from)
+        requireStep(reg, opts.from);
+    const text = readFileSync(project.abs(screen.file), "utf8");
+    const sf = parseSource(screen.file, text);
+    const fixtures = fixturesLiteral(sf);
+    if (!fixtures)
+        throw new KitError(`Couldn't find the list of states in ${screen.file}.`);
+    const title = opts.title?.trim() || humanize(state);
+    const key = /^[a-z_$][a-z0-9_$]*$/i.test(state) ? state : q(state);
+    writeFileSync(project.abs(screen.file), appendToLiteral(sf, text, fixtures, () => `${key}: { title: ${q(title)}, data: {} }`));
+    const node = `${screen.id}.${state}`;
+    const files = [screen.file];
+    if (opts.from)
+        files.push(insertEdge(project, { from: opts.from, to: node, label: opts.label, flow: opts.flow }));
+    return finish(project, files, node);
+}
+/** Adds an arrow between two existing states in src/flows.ts. */
+export function addEdge(project, opts) {
+    const reg = registryOf(project);
+    requireStep(reg, opts.from);
+    requireStep(reg, opts.to);
+    return finish(project, [insertEdge(project, opts)], opts.to);
+}
+function edgeText(e) {
+    return `{ from: ${q(e.from)}, to: ${q(e.to)}${e.label ? `, label: ${q(e.label)}` : ""} }`;
+}
+/** Writes the arrow into src/flows.ts (creating the file or the flow if needed). Returns the file. */
+function insertEdge(project, e) {
+    const file = LAYOUT.flowsTs;
+    const path = project.abs(file);
+    const flowId = (flows) => e.flow ??
+        flows.find((f) => f.edges.some((x) => x.from === e.from || x.to === e.from))?.id ??
+        flows[0]?.id ??
+        splitNode(e.from).screen.split(".")[0];
+    if (!existsSync(path)) {
+        const id = e.flow ?? splitNode(e.from).screen.split(".")[0];
+        writeFileSync(path, `import { defineFlows } from "@cogitato/runtime";
+
+// How screens connect. Each step is "{screen id}.{state}".
+export default defineFlows([
+  {
+    id: ${q(id)},
+    title: ${q(humanize(id))},
+    edges: [
+      ${edgeText(e)},
+    ],
+  },
+]);
+`);
+        return file;
+    }
+    const text = readFileSync(path, "utf8");
+    const sf = parseSource(file, text);
+    const list = findCalls(sf, "defineFlows")[0]?.arguments[0];
+    if (!list || !ts.isArrayLiteralExpression(list))
+        throw new KitError(`Couldn't find the list of flows in ${file}.`);
+    const flows = list.elements.filter(ts.isObjectLiteralExpression).map((el) => {
+        const edges = getProperty(el, "edges")?.initializer;
+        const edgeList = edges && ts.isArrayLiteralExpression(edges) ? edges : undefined;
+        return {
+            el,
+            id: literalText(getProperty(el, "id")?.initializer) ?? "",
+            edgeList,
+            edges: [...(edgeList?.elements ?? [])].filter(ts.isObjectLiteralExpression).map((x) => ({
+                from: literalText(getProperty(x, "from")?.initializer) ?? "",
+                to: literalText(getProperty(x, "to")?.initializer) ?? "",
+            })),
+        };
+    });
+    const target = flowId(flows);
+    const flow = flows.find((f) => f.id === target);
+    if (flow?.edges.some((x) => x.from === e.from && x.to === e.to))
+        return file;
+    let next;
+    if (flow) {
+        if (!flow.edgeList)
+            throw new KitError(`Couldn't find the arrows (edges) of the "${target}" flow in ${file}.`);
+        next = appendToLiteral(sf, text, flow.edgeList, () => edgeText(e));
+    }
+    else {
+        next = appendToLiteral(sf, text, list, (indent) => [
+            "{",
+            `${indent}  id: ${q(target)},`,
+            `${indent}  title: ${q(humanize(target))},`,
+            `${indent}  edges: [`,
+            `${indent}    ${edgeText(e)},`,
+            `${indent}  ],`,
+            `${indent}}`,
+        ].join("\n"));
+    }
+    writeFileSync(path, next);
+    return file;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAmC,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA2CzC,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE3C,gDAAgD;AAChD,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CACtB,EAAiB,EACjB,IAAY,EACZ,IAA4D,EAC5D,IAAgC;IAEhC,MAAM,QAAQ,GAAG,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IACrF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IACnI,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3F,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,gBAAgB,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1F,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AAErF,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,IAAI,8FAA8F,CAAC,CAAC;IACxI,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,WAAW,CAAC,GAAa,EAAE,IAAY;IAC9C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,kCAAkC,MAAM,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,gCAAgC,KAAK,cAAc,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1I,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,OAAgB,EAAE,KAAe,EAAE,IAAY;IAC7D,WAAW,CAAC,OAAO,CAAC,CAAC;IACrB,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,OAAO,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,aAAa,CAAC,EAAU;IAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC;AAChG,CAAC;AAED,SAAS,YAAY,CAAC,EAAU,EAAE,KAAa,EAAE,KAAa;IAC5D,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO;;;WAGE,IAAI;;;YAGH,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;;;;;;QAMhC,CAAC,CAAC,EAAE,CAAC;WACF,CAAC,CAAC,KAAK,CAAC;WACR,CAAC,CAAC,KAAK,CAAC;;;;eAIJ,IAAI;;CAElB,CAAC;AACF,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,IAAyB;IACtE,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,2FAA2F,CAAC,CAAC;IACxH,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,oCAAoC,EAAE,IAAI,CAAC,CAAC;IACzG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1D,IAAI,KAAK,KAAK,GAAG;QAAE,MAAM,IAAI,QAAQ,CAAC,+GAA+G,CAAC,CAAC;IACvJ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,KAAK,qDAAqD,CAAC,CAAC;IAC3H,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACzD,IAAI,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,KAAK,4BAA4B,KAAK,CAAC,KAAK,4BAA4B,CAAC,CAAC;IACxH,IAAI,IAAI,CAAC,IAAI;QAAE,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3C,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;IACjF,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,0CAA0C,CAAC,CAAC;IACzG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChF,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEjE,MAAM,IAAI,GAAG,GAAG,EAAE,UAAU,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClH,OAAO,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,EAAiB;IACxC,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACjE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC;IACvD,OAAO,IAAI,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,OAAgB,EAAE,IAAqB;IAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,wFAAwF,CAAC,CAAC;IACxH,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAA4B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IACtF,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,kCAAkC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACnF,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,OAAO,MAAM,CAAC,KAAK,0BAA0B,KAAK,UAAU,CAAC,CAAC;IACnI,IAAI,IAAI,CAAC,IAAI;QAAE,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3C,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,uCAAuC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnE,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,cAAc,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;IAE/H,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClH,OAAO,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,OAAO,CAAC,OAAgB,EAAE,IAAoB;IAC5D,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,QAAQ,CAAC,CAAiB;IACjC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;AAC5F,CAAC;AAED,sGAAsG;AACtG,SAAS,UAAU,CAAC,OAAgB,EAAE,CAAiB;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,CAAC,KAA8D,EAAE,EAAE,CAChF,CAAC,CAAC,IAAI;QACN,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE;QAChF,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IAE1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAC7D,aAAa,CACX,IAAI,EACJ;;;;;UAKI,CAAC,CAAC,EAAE,CAAC;aACF,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;;QAEpB,QAAQ,CAAC,CAAC,CAAC;;;;CAIlB,CACI,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,sCAAsC,IAAI,GAAG,CAAC,CAAC;IACnH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC1E,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC;QACpD,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACjF,OAAO;YACL,EAAE;YACF,EAAE,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,IAAI,EAAE;YACzD,QAAQ;YACR,KAAK,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtF,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,IAAI,EAAE;gBAC5D,EAAE,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,IAAI,EAAE;aACzD,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAChD,IAAI,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7E,IAAI,IAAY,CAAC;IACjB,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,QAAQ,CAAC,4CAA4C,MAAM,aAAa,IAAI,GAAG,CAAC,CAAC;QAC/G,IAAI,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAChD;YACE,GAAG;YACH,GAAG,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG;YAC9B,GAAG,MAAM,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG;YAC3C,GAAG,MAAM,YAAY;YACrB,GAAG,MAAM,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG;YAC9B,GAAG,MAAM,MAAM;YACf,GAAG,MAAM,GAAG;SACb,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IACD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/snapshots.d.ts

@@ -0,0 +1,43 @@
+import { type ChildProcess } from "node:child_process";
+import { type SnapshotManifest } from "@cogitato/contract";
+import type { Project } from "./project.js";
+export declare const SNAPSHOT_VIEWPORT: {
+    readonly width: 1280;
+    readonly height: 800;
+};
+/** A port the operating system says is free right now, so parallel builds and dev servers never collide. */
+export declare function freePort(): Promise<number>;
+export interface SnapshotOptions {
+    /** Built prototype folder, project-relative. */
+    dist?: string;
+    /** Serve the build on this port. By default a free one is picked, so parallel builds don't collide. */
+    port?: number;
+    /** For tests: replace the browser and the preview server. */
+    deps?: {
+        launchBrowser?: (project: Project) => Promise<Browser | string>;
+        startPreview?: (project: Project, vite: string, dist: string, port: number) => Promise<ChildProcess>;
+    };
+    log?: (message: string) => void;
+}
+export interface SnapshotResult {
+    written: number;
+    /** Why no snapshots were taken, in plain words. */
+    skipped?: string;
+    manifest?: SnapshotManifest;
+}
+/** Image file for a state, relative to __kit-data/. */
+export declare const snapshotFile: (node: string) => string;
+export declare function snapshotManifest(nodes: string[], commit?: string): SnapshotManifest;
+export interface Page {
+    goto(url: string, opts?: object): Promise<unknown>;
+    waitForSelector(selector: string, opts?: object): Promise<unknown>;
+    waitForLoadState(state: string, opts?: object): Promise<unknown>;
+    waitForTimeout(ms: number): Promise<void>;
+    screenshot(opts: object): Promise<unknown>;
+}
+export interface Browser {
+    newPage(opts: object): Promise<Page>;
+    close(): Promise<void>;
+}
+/** Takes a screenshot of every state in the built prototype and writes __kit-data/snapshots.json. */
+export declare function takeSnapshots(project: Project, opts?: SnapshotOptions): Promise<SnapshotResult>;

package/dist/snapshots.js

@@ -0,0 +1,140 @@
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { createServer } from "node:net";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { SCHEMA_VERSIONS, validateFormat } from "@cogitato/contract";
+import { isServerUp } from "./doctor.js";
+import { readFlowsJson } from "./flows.js";
+// Screenshots of every state in a built prototype, so the canvas can show zoomed-out frames
+// instantly (07-canvas). Best effort: without Playwright or a browser it explains and skips, and
+// the canvas shows placeholders instead. A deploy never fails because of snapshots (ADR 013).
+export const SNAPSHOT_VIEWPORT = { width: 1280, height: 800 };
+/** A port the operating system says is free right now, so parallel builds and dev servers never collide. */
+export function freePort() {
+    return new Promise((resolve, reject) => {
+        const probe = createServer();
+        probe.once("error", reject);
+        probe.listen(0, () => {
+            const address = probe.address();
+            const port = typeof address === "object" && address ? address.port : 0;
+            probe.close(() => (port ? resolve(port) : reject(new Error("No free port could be found."))));
+        });
+    });
+}
+/** Image file for a state, relative to __kit-data/. */
+export const snapshotFile = (node) => `snapshots/${node}.jpg`;
+export function snapshotManifest(nodes, commit) {
+    return {
+        schemaVersion: SCHEMA_VERSIONS.snapshots,
+        ...(commit ? { commit } : {}),
+        viewport: { ...SNAPSHOT_VIEWPORT },
+        frames: Object.fromEntries(nodes.map((n) => [n, snapshotFile(n)])),
+    };
+}
+const states = (m) => m.screens.flatMap((s) => s.states.map((st) => ({ node: `${s.id}.${st.id}`, url: `${s.route}?fixture=${encodeURIComponent(st.fixture)}&kit-frame=1` })));
+/**
+ * A package the prototype itself has installed. Only its own node_modules counts, not whatever
+ * Node could find elsewhere (NODE_PATH, parent folders), so snapshots use the prototype's versions.
+ */
+function ownPackage(project, name) {
+    const pkg = project.abs(join("node_modules", name, "package.json"));
+    return existsSync(pkg) ? pkg : undefined;
+}
+async function launchBrowser(project) {
+    let playwright;
+    try {
+        const pkg = ownPackage(project, "playwright");
+        if (!pkg)
+            throw new Error("not installed");
+        const entry = createRequire(pkg).resolve("playwright");
+        const mod = (await import(pathToFileURL(entry).href));
+        // Playwright is CommonJS: depending on how Node reads it, its API is on the module or on `default`.
+        playwright = mod.chromium ? mod : mod.default;
+    }
+    catch {
+        return "Playwright isn't installed in this prototype, so no snapshots were taken. The canvas will show placeholders instead.";
+    }
+    try {
+        return await playwright.chromium.launch();
+    }
+    catch {
+        return "The snapshot browser couldn't start, so no snapshots were taken (run `npx playwright install chromium` to fix it). The canvas will show placeholders instead.";
+    }
+}
+/** The prototype's own Vite, which serves the build. Undefined when it isn't installed. */
+function viteBin(project) {
+    const pkg = ownPackage(project, "vite");
+    return pkg ? join(pkg, "..", "bin", "vite.js") : undefined;
+}
+async function startPreview(project, vite, dist, port) {
+    const server = spawn(process.execPath, [vite, "preview", "--outDir", dist, "--port", String(port), "--strictPort"], {
+        cwd: project.root,
+        stdio: "ignore",
+    });
+    const deadline = Date.now() + 20_000;
+    while (!(await isServerUp(port))) {
+        if (server.exitCode !== null || Date.now() > deadline) {
+            server.kill();
+            throw new Error("The built prototype couldn't be served for snapshots.");
+        }
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    return server;
+}
+/** Takes a screenshot of every state in the built prototype and writes __kit-data/snapshots.json. */
+export async function takeSnapshots(project, opts = {}) {
+    const log = opts.log ?? (() => { });
+    const dist = opts.dist ?? "dist";
+    const out = project.abs(join(dist, "__kit-data"));
+    const flows = readFlowsJson(project);
+    if (!existsSync(project.abs(dist)))
+        return { written: 0, skipped: "There's no built prototype to take snapshots of yet. Build it first." };
+    if (!flows)
+        return { written: 0, skipped: "There's no flow map (design/flows.json) yet, so there's nothing to take snapshots of." };
+    const vite = opts.deps?.startPreview ? "" : viteBin(project);
+    if (vite === undefined)
+        return { written: 0, skipped: "The prototype's parts aren't installed, so no snapshots were taken. The canvas will show placeholders instead." };
+    const browser = await (opts.deps?.launchBrowser ?? launchBrowser)(project);
+    if (typeof browser === "string")
+        return { written: 0, skipped: browser };
+    let server;
+    const done = [];
+    let port = opts.port ?? 0;
+    try {
+        if (!opts.port)
+            port = await freePort();
+        server = await (opts.deps?.startPreview ?? startPreview)(project, vite, dist, port);
+        const page = await browser.newPage({ viewport: { ...SNAPSHOT_VIEWPORT } });
+        mkdirSync(join(out, "snapshots"), { recursive: true });
+        for (const { node, url } of states(flows)) {
+            try {
+                await page.goto(`http://localhost:${port}${url}`, { waitUntil: "load" });
+                await page.waitForSelector("html[data-kit-ready]", { timeout: 10_000 });
+                await page.waitForLoadState("networkidle", { timeout: 5_000 }).catch(() => { });
+                await page.waitForTimeout(150);
+                await page.screenshot({ path: join(out, snapshotFile(node)), type: "jpeg", quality: 70 });
+                done.push(node);
+            }
+            catch {
+                log(`Couldn't take a snapshot of ${node}; the canvas will show a placeholder for it.`);
+            }
+        }
+    }
+    catch (e) {
+        return { written: 0, skipped: `No snapshots were taken: ${e instanceof Error ? e.message : String(e)}` };
+    }
+    finally {
+        await browser.close().catch(() => { });
+        server?.kill();
+    }
+    const manifest = snapshotManifest(done, flows.commit);
+    const check = validateFormat("snapshots", manifest, "__kit-data/snapshots.json");
+    if (!check.ok)
+        return { written: 0, skipped: `The snapshot list came out wrong: ${check.issues[0].message}` };
+    writeFileSync(join(out, "snapshots.json"), JSON.stringify(manifest, null, 2) + "\n");
+    log(`Took ${done.length} snapshot${done.length === 1 ? "" : "s"} for the canvas.`);
+    return { written: done.length, manifest };
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/snapshots.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,14 @@
+import type { Project } from "./project.js";
+/** exploring, in-review, approved, handed-off: from the shared schema. */
+export type FrameStatusValue = "exploring" | "in-review" | "approved" | "handed-off";
+export declare const FRAME_STATUSES: FrameStatusValue[];
+/**
+ * Sets a state's review status. "exploring" is the default, so it removes the entry.
+ * Returns the state's previous status.
+ */
+export declare function setStatus(project: Project, node: string, status: string): {
+    node: string;
+    status: FrameStatusValue;
+    previous: FrameStatusValue;
+};
+export declare const statusLabel: (status: string) => string;

package/dist/status.js

@@ -0,0 +1,38 @@
+import { readSchema } from "@cogitato/contract";
+import { KitError } from "./errors.js";
+import { exportFlows } from "./export-flows.js";
+import { readFlowsJson, writeManifest } from "./flows.js";
+// Review status of each frame on the canvas, kept in flows.json's `status` (ADR 014).
+const common = readSchema("common.schema.json");
+export const FRAME_STATUSES = common.$defs.frameStatus.enum;
+const LABELS = { exploring: "Exploring", "in-review": "In review", approved: "Approved", "handed-off": "Handed off" };
+/**
+ * Sets a state's review status. "exploring" is the default, so it removes the entry.
+ * Returns the state's previous status.
+ */
+export function setStatus(project, node, status) {
+    if (!FRAME_STATUSES.includes(status)) {
+        throw new KitError(`"${status}" isn't a review status. Use one of: ${FRAME_STATUSES.map((s) => `${s} (${LABELS[s] ?? s})`).join(", ")}.`);
+    }
+    // Start from a fresh export so the status lands on what the code has right now.
+    const exported = exportFlows(project);
+    if (exported.issues.some((i) => i.severity === "error")) {
+        throw new KitError("The flow map can't be updated until the prototype's problems are fixed. Check the prototype first.");
+    }
+    const manifest = readFlowsJson(project) ?? exported.manifest;
+    const known = manifest.screens.flatMap((s) => s.states.map((st) => `${s.id}.${st.id}`));
+    if (!known.includes(node))
+        throw new KitError(`There's no screen state called "${node}". States look like "checkout.payment.card-declined".`);
+    const current = (manifest.status ?? {});
+    const previous = current[node] ?? "exploring";
+    const { [node]: _old, ...others } = current;
+    const statuses = status === "exploring" ? others : { ...others, [node]: status };
+    const { status: _s, ...rest } = manifest;
+    const next = (Object.keys(statuses).length ? { ...rest, status: statuses } : rest);
+    const r = writeManifest(project, { manifest: next, issues: [] }, false);
+    if (r.issues.some((i) => i.severity === "error"))
+        throw new KitError(`The status couldn't be saved: ${r.issues[0].message}`);
+    return { node, status: status, previous };
+}
+export const statusLabel = (status) => LABELS[status] ?? status;
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,18 @@
+import { type ValidationResult } from "@cogitato/contract";
+import type { Issue } from "./issue.js";
+import { type Project } from "./project.js";
+export interface ValidateOptions {
+    /** Only check the design contract (the workspace's design/contract and this prototype's design/ files). */
+    contractOnly?: boolean;
+    /** Don't check the shared contract (validateWorkspace checks it once). */
+    skipContract?: boolean;
+    /**
+     * Only check these files (project-relative or absolute). The fast path for edit hooks.
+     * Screen registrations and flows are still read from the whole project, since ids and flow
+     * steps depend on every screen.
+     */
+    files?: string[];
+}
+export declare function sortIssues(issues: Issue[]): Issue[];
+/** Validates a prototype: its design contract, its code against the contract, and its flows. */
+export declare function validate(project: Project, opts?: ValidateOptions): ValidationResult;

package/dist/validate.js

@@ -0,0 +1,72 @@
+import { readFileSync } from "node:fs";
+import { validateProject } from "@cogitato/contract";
+import { buildManifest, staleIssue } from "./flows.js";
+import { LAYOUT, WORKSPACE_LAYOUT, isScreenFile, readContract, sourceFiles } from "./project.js";
+import { parseProjectFile, readRegistry } from "./registry.js";
+import { checkCssFile } from "./rules/css.js";
+import { checkTsxFile, duplicateKitIds } from "./rules/tsx.js";
+const ownerOf = (screens, file) => screens
+    .filter((s) => file.startsWith(`${s.dir}/`))
+    .sort((a, b) => b.dir.length - a.dir.length)[0];
+export function sortIssues(issues) {
+    return [...issues].sort((a, b) => a.file.localeCompare(b.file) || (a.line ?? 0) - (b.line ?? 0) || (a.column ?? 0) - (b.column ?? 0));
+}
+const finish = (issues) => ({
+    ok: !issues.some((i) => i.severity === "error"),
+    issues: sortIssues(issues),
+});
+/** Validates a prototype: its design contract, its code against the contract, and its flows. */
+export function validate(project, opts = {}) {
+    const issues = [];
+    const targets = opts.files?.map((f) => project.rel(f));
+    const touches = (pred) => !targets || targets.some(pred);
+    const sharedPrefix = `../../${WORKSPACE_LAYOUT.contract}/`;
+    if (touches((f) => f.startsWith(`${LAYOUT.design}/`) || f.startsWith(sharedPrefix))) {
+        const contractDir = project.workspace.abs(WORKSPACE_LAYOUT.contract);
+        const r = validateProject(project.abs(LAYOUT.design), contractDir);
+        for (const i of r.issues) {
+            const shared = i.file.startsWith("contract/");
+            if (shared && opts.skipContract)
+                continue;
+            // Contract issues are named from the workspace root, prototype issues from the prototype.
+            issues.push({ ...i, file: shared ? `${WORKSPACE_LAYOUT.contract}/${i.file.slice("contract/".length)}` : `${LAYOUT.design}/${i.file}` });
+        }
+    }
+    if (opts.contractOnly)
+        return finish(issues);
+    const contract = readContract(project);
+    const all = sourceFiles(project);
+    const registry = readRegistry(project, all);
+    const inScope = (file) => !targets || targets.includes(file);
+    issues.push(...registry.issues.filter((i) => inScope(i.file)));
+    const kitIds = [];
+    for (const file of all) {
+        if (file.endsWith(".css")) {
+            if (inScope(file))
+                issues.push(...checkCssFile(file, readFileSync(project.abs(file), "utf8"), contract));
+            continue;
+        }
+        // Every tsx file is read for its ids so duplicates across a screen's files are caught,
+        // but only files in scope report their own problems.
+        const isTsx = file.endsWith(".tsx");
+        if (!inScope(file) && !isTsx)
+            continue;
+        const r = checkTsxFile(parseProjectFile(project, file), { contract, owner: ownerOf(registry.screens, file) });
+        kitIds.push(...r.kitIds);
+        if (inScope(file))
+            issues.push(...r.issues);
+    }
+    issues.push(...duplicateKitIds(kitIds).filter((i) => inScope(i.file)));
+    // Flow steps depend on every screen, so check them whenever a screen or flows.ts is in scope.
+    if (registry.complete && touches((f) => f === LAYOUT.flowsTs || isScreenFile(f))) {
+        const built = buildManifest(registry);
+        issues.push(...built.issues);
+        if (!registry.issues.some((i) => i.severity === "error") && !built.issues.length) {
+            const stale = staleIssue(project, built.manifest);
+            if (stale)
+                issues.push(stale);
+        }
+    }
+    return finish(issues);
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,18 @@
+import { type ValidationResult } from "@cogitato/contract";
+import { type Issue } from "./issue.js";
+import { type Workspace } from "./project.js";
+/** Checks the shared kit's CSS and TSX against the contract. Issue files are workspace-relative. */
+export declare function validateKit(ws: Workspace): Issue[];
+/** Checks the shared contract and kit once, then every prototype. Issue files are workspace-relative. */
+export declare function validateWorkspace(ws: Workspace, opts?: {
+    contractOnly?: boolean;
+}): ValidationResult;
+/** What to tell a designer when validateWorkspace found nothing, so an empty workspace doesn't read as checked prototypes. */
+export declare function workspaceSuccess(ws: Workspace, opts?: {
+    contractOnly?: boolean;
+}): string;
+/** Starts prototypes/<name>/ from an existing prototype's setup, with one empty Home screen. */
+export declare function createPrototype(ws: Workspace, name: string): {
+    name: string;
+    files: string[];
+};