@cogitato/kit-cli 0.0.0-stage → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { DEFAULT_PORT, doctor, formatDoctor, machineChecks, prototypeChecks, isServerUp, type CheckStatus, type DoctorCheck, type DoctorOptions } from "./doctor.js";
+export { exportFlows, type ExportOptions } from "./export-flows.js";
+export { buildManifest, keptStatus, sameManifest, serializeManifest, type ExportResult } from "./flows.js";
+export { formatResult } from "./format.js";
+export { KIT_PATH, preview, type PreviewOptions, type PreviewResult } from "./preview.js";
+export { LAYOUT, PROTOTYPE_NAME, WORKSPACE_LAYOUT, findProject, findWorkspace, listPrototypes, projectAt, projectIn, readContract, resolvePrototype, sourceFiles, workspaceAt, type ContractView, type Project, type Workspace, } from "./project.js";
+export { createPrototype, validateKit, validateWorkspace, workspaceSuccess } from "./workspace.js";
+export { ID_PATTERNS, humanize, readFlows, readRegistry, readScreen, type Registry, type ScreenEntry } from "./registry.js";
+export { checkCssValue } from "./rules/css-values.js";
+export { validate, type ValidateOptions } from "./validate.js";
+export { KitError } from "./errors.js";
+export { addGap, type AddGapOptions, type AddGapResult } from "./gaps.js";
+export { MCP_TOOLS, checkedByHook, postEditHook, runHook, sessionStartHook, type HookEvent, type HookInput, type HookOutput } from "./hook.js";
+export { CANVAS_PATH, canvasLink, previewLink, stateLink } from "./links.js";
+export { SNAPSHOT_VIEWPORT, freePort, snapshotFile, snapshotManifest, takeSnapshots, type SnapshotOptions, type SnapshotResult } from "./snapshots.js";
+export { FRAME_STATUSES, setStatus, statusLabel, type FrameStatusValue } from "./status.js";
+export { describeChanges, saveVersion, type SaveOptions, type SaveResult } from "./save.js";
+export { addEdge, addState, createScreen, type AddEdgeOptions, type AddStateOptions, type CreateScreenOptions, type ScaffoldResult, } from "./scaffold.js";
+export { SHARED_INPUTS, affectedPrototypes, previewHost, slugPart } from "./hosting.js";

package/dist/index.js

@@ -0,0 +1,21 @@
+// Library entry. Hooks, skills and the kit MCP server call these; they don't reimplement them.
+export { DEFAULT_PORT, doctor, formatDoctor, machineChecks, prototypeChecks, isServerUp } from "./doctor.js";
+export { exportFlows } from "./export-flows.js";
+export { buildManifest, keptStatus, sameManifest, serializeManifest } from "./flows.js";
+export { formatResult } from "./format.js";
+export { KIT_PATH, preview } from "./preview.js";
+export { LAYOUT, PROTOTYPE_NAME, WORKSPACE_LAYOUT, findProject, findWorkspace, listPrototypes, projectAt, projectIn, readContract, resolvePrototype, sourceFiles, workspaceAt, } from "./project.js";
+export { createPrototype, validateKit, validateWorkspace, workspaceSuccess } from "./workspace.js";
+export { ID_PATTERNS, humanize, readFlows, readRegistry, readScreen } from "./registry.js";
+export { checkCssValue } from "./rules/css-values.js";
+export { validate } from "./validate.js";
+export { KitError } from "./errors.js";
+export { addGap } from "./gaps.js";
+export { MCP_TOOLS, checkedByHook, postEditHook, runHook, sessionStartHook } from "./hook.js";
+export { CANVAS_PATH, canvasLink, previewLink, stateLink } from "./links.js";
+export { SNAPSHOT_VIEWPORT, freePort, snapshotFile, snapshotManifest, takeSnapshots } from "./snapshots.js";
+export { FRAME_STATUSES, setStatus, statusLabel } from "./status.js";
+export { describeChanges, saveVersion } from "./save.js";
+export { addEdge, addState, createScreen, } from "./scaffold.js";
+export { SHARED_INPUTS, affectedPrototypes, previewHost, slugPart } from "./hosting.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAA0D,MAAM,aAAa,CAAC;AACrK,OAAO,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAA2C,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,cAAc,EACd,SAAS,EACT,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,GAIZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAmC,MAAM,eAAe,CAAC;AAC5H,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,EAAyC,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAmD,MAAM,WAAW,CAAC;AAC/I,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAA6C,MAAM,gBAAgB,CAAC;AACvJ,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,WAAW,EAAqC,MAAM,WAAW,CAAC;AAC5F,OAAO,EACL,OAAO,EACP,QAAQ,EACR,YAAY,GAKb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/issue.d.ts

@@ -0,0 +1,17 @@
+import type { Issue } from "@cogitato/contract";
+import ts from "typescript";
+export type { Issue };
+/** Issue at a position in a TypeScript source file. */
+export declare function issueAt(code: string, sf: ts.SourceFile, node: ts.Node, message: string, extra?: {
+    severity?: Issue["severity"];
+    suggestion?: string;
+}): Issue;
+export declare function parseSource(file: string, text: string): ts.SourceFile;
+/** Text of a string literal or a template without substitutions; undefined for anything computed. */
+export declare function literalText(node: ts.Node | undefined): string | undefined;
+/** Name of an object literal property when it's written as plain text. */
+export declare function propertyName(name: ts.PropertyName): string | undefined;
+/** The value expression of property `key` in an object literal, if it's a plain `key: value` assignment. */
+export declare function getProperty(obj: ts.ObjectLiteralExpression, key: string): ts.PropertyAssignment | undefined;
+/** Calls to `name(...)` (or `x.name(...)`) anywhere in the file. */
+export declare function findCalls(sf: ts.SourceFile, name: string): ts.CallExpression[];

package/dist/issue.js

@@ -0,0 +1,65 @@
+import ts from "typescript";
+/** Issue at a position in a TypeScript source file. */
+export function issueAt(code, sf, node, message, extra = {}) {
+    const { line, character } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+    return {
+        code,
+        severity: extra.severity ?? "error",
+        file: sf.fileName,
+        path: "",
+        line: line + 1,
+        column: character + 1,
+        message,
+        ...(extra.suggestion !== undefined ? { suggestion: extra.suggestion } : {}),
+    };
+}
+export function parseSource(file, text) {
+    const kind = file.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    return ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, kind);
+}
+/** Text of a string literal or a template without substitutions; undefined for anything computed. */
+export function literalText(node) {
+    if (!node)
+        return undefined;
+    if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))
+        return node.text;
+    if (ts.isParenthesizedExpression(node) || ts.isAsExpression(node) || ts.isSatisfiesExpression(node)) {
+        return literalText(node.expression);
+    }
+    return undefined;
+}
+/** Name of an object literal property when it's written as plain text. */
+export function propertyName(name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name) || ts.isNoSubstitutionTemplateLiteral(name)) {
+        return name.text;
+    }
+    return undefined;
+}
+/** The value expression of property `key` in an object literal, if it's a plain `key: value` assignment. */
+export function getProperty(obj, key) {
+    for (const p of obj.properties) {
+        if (ts.isPropertyAssignment(p) && propertyName(p.name) === key)
+            return p;
+    }
+    return undefined;
+}
+/** Calls to `name(...)` (or `x.name(...)`) anywhere in the file. */
+export function findCalls(sf, name) {
+    const out = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            const calleeName = ts.isIdentifier(callee)
+                ? callee.text
+                : ts.isPropertyAccessExpression(callee)
+                    ? callee.name.text
+                    : undefined;
+            if (calleeName === name)
+                out.push(node);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return out;
+}
+//# sourceMappingURL=issue.js.map

package/dist/issue.js.map

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

package/dist/links.d.ts

@@ -0,0 +1,15 @@
+import { type Project } from "./project.js";
+export declare const CANVAS_PATH = "/__canvas";
+/**
+ * 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 declare function stateLink(project: Project, node: string, port?: number): string;
+/** Local canvas, opened on one state's frame. */
+export declare function canvasLink(project: Project, node: string, port?: number): string;
+/**
+ * Hosted canvas for a branch, from the workspace's package.json:
+ * `"kit": { "previewUrl": "https://{host}.cogitato-preview.app", "org": "acme-shop-demo" }`.
+ * `{host}` is previewHost(branch, prototype, org). Undefined when hosting isn't set up.
+ */
+export declare function previewLink(project: Project, branch: string, node?: string): string | undefined;

package/dist/links.js

@@ -0,0 +1,60 @@
+import { existsSync, readFileSync } from "node:fs";
+import { DEFAULT_PORT } from "./doctor.js";
+import { KitError } from "./errors.js";
+import { previewHost, slugPart } from "./hosting.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}`)}`;
+}
+/**
+ * Hosted canvas for a branch, from the workspace's package.json:
+ * `"kit": { "previewUrl": "https://{host}.cogitato-preview.app", "org": "acme-shop-demo" }`.
+ * `{host}` is previewHost(branch, prototype, org). Undefined when hosting isn't set up.
+ */
+export function previewLink(project, branch, node) {
+    const pkgPath = project.workspace.abs("package.json");
+    if (!existsSync(pkgPath))
+        return undefined;
+    let kit;
+    try {
+        kit = JSON.parse(readFileSync(pkgPath, "utf8")).kit;
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof kit?.previewUrl !== "string" || !kit.previewUrl.includes("{host}") || typeof kit.org !== "string" || !slugPart(kit.org))
+        return undefined;
+    const host = previewHost({ branch, prototype: project.name, org: kit.org });
+    const base = kit.previewUrl.replace("{host}", host).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,55 @@
+import { type ComponentManifest, type ResolvedToken } from "@cogitato/contract";
+/** Workspace conventions: one design kit for every prototype (no config file). */
+export declare const WORKSPACE_LAYOUT: {
+    readonly contract: "design/contract";
+    readonly kit: "kit";
+    readonly prototypes: "prototypes";
+};
+/** Conventions inside one prototype, prototypes/<name>/. */
+export declare const LAYOUT: {
+    readonly design: "design";
+    readonly flowsJson: "design/flows.json";
+    readonly src: "src";
+    readonly screens: "src/screens";
+    readonly flowsTs: "src/flows.ts";
+    readonly screenFile: "screen.tsx";
+};
+/** A folder with paths relative to it. */
+export interface Workspace {
+    /** Absolute path of the folder. */
+    root: string;
+    /** Absolute path for a relative path. */
+    abs(rel: string): string;
+    /** Relative path with "/" separators. */
+    rel(abs: string): string;
+}
+/** One prototype. Its paths are relative to prototypes/<name>/. */
+export interface Project extends Workspace {
+    name: string;
+    workspace: Workspace;
+}
+export declare function workspaceAt(root: string): Workspace;
+/** Finds the workspace by walking up from `from` to the first folder containing design/contract. */
+export declare function findWorkspace(from?: string): Workspace | undefined;
+/** What a prototype's folder name may be: lowercase words with single dashes. */
+export declare const PROTOTYPE_NAME: RegExp;
+/** Names of the prototypes in a workspace: folders in prototypes/ with a valid name and a package.json. Sorted. */
+export declare function listPrototypes(ws: Workspace): string[];
+export declare function projectIn(ws: Workspace, name: string): Project;
+/** The prototype whose folder is `root` (prototypes/<name>). */
+export declare function projectAt(root: string): Project;
+/** The prototype `from` is inside, or the workspace's only prototype. Undefined if it's unclear. */
+export declare function findProject(from?: string): Project | undefined;
+/** The named prototype, else the one `from` is in, else the only one. Throws a designer-readable error otherwise. */
+export declare function resolvePrototype(ws: Workspace, name?: string, from?: 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;
+/** 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(from: Workspace | Project): ContractView;

package/dist/project.js

@@ -0,0 +1,145 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { resolveTokens, tokensToCss, } from "@cogitato/contract";
+import { KitError } from "./errors.js";
+/** Workspace conventions: one design kit for every prototype (no config file). */
+export const WORKSPACE_LAYOUT = {
+    contract: "design/contract",
+    kit: "kit",
+    prototypes: "prototypes",
+};
+/** Conventions inside one prototype, prototypes/<name>/. */
+export const LAYOUT = {
+    design: "design",
+    flowsJson: "design/flows.json",
+    src: "src",
+    screens: "src/screens",
+    flowsTs: "src/flows.ts",
+    screenFile: "screen.tsx",
+};
+export function workspaceAt(root) {
+    return {
+        root,
+        abs: (rel) => (isAbsolute(rel) ? rel : join(root, rel)),
+        rel: (abs) => relative(root, isAbsolute(abs) ? abs : join(root, abs)).split(sep).join("/"),
+    };
+}
+/** Finds the workspace by walking up from `from` to the first folder containing design/contract. */
+export function findWorkspace(from = process.cwd()) {
+    let dir = resolve(from);
+    for (;;) {
+        if (existsSync(join(dir, WORKSPACE_LAYOUT.contract)))
+            return workspaceAt(dir);
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/** What a prototype's folder name may be: lowercase words with single dashes. */
+export const PROTOTYPE_NAME = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/** Names of the prototypes in a workspace: folders in prototypes/ with a valid name and a package.json. Sorted. */
+export function listPrototypes(ws) {
+    const dir = ws.abs(WORKSPACE_LAYOUT.prototypes);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((name) => PROTOTYPE_NAME.test(name) && existsSync(join(dir, name, "package.json")))
+        .sort();
+}
+export function projectIn(ws, name) {
+    if (!listPrototypes(ws).includes(name)) {
+        const names = listPrototypes(ws);
+        throw new KitError(`There's no prototype called "${name}".${names.length ? ` The prototypes here are: ${names.join(", ")}.` : ""}`);
+    }
+    return { ...workspaceAt(ws.abs(`${WORKSPACE_LAYOUT.prototypes}/${name}`)), name, workspace: ws };
+}
+/** The prototype whose folder is `root` (prototypes/<name>). */
+export function projectAt(root) {
+    const ws = findWorkspace(root);
+    if (!ws)
+        throw new KitError(`${root} isn't inside a Cogitato workspace (there's no design/contract folder above it).`);
+    const name = basename(resolve(root));
+    if (resolve(root) !== resolve(ws.abs(`${WORKSPACE_LAYOUT.prototypes}/${name}`))) {
+        throw new KitError(`${root} isn't a prototype folder. Prototypes live in ${WORKSPACE_LAYOUT.prototypes}/<name> inside the workspace.`);
+    }
+    return projectIn(ws, name);
+}
+/** The prototype `from` is inside, or the workspace's only prototype. Undefined if it's unclear. */
+export function findProject(from = process.cwd()) {
+    const ws = findWorkspace(from);
+    if (!ws)
+        return undefined;
+    const name = new RegExp(`^${WORKSPACE_LAYOUT.prototypes}/([^/]+)`).exec(ws.rel(resolve(from)))?.[1];
+    const all = listPrototypes(ws);
+    if (name && all.includes(name))
+        return projectIn(ws, name);
+    return all.length === 1 ? projectIn(ws, all[0]) : undefined;
+}
+/** The named prototype, else the one `from` is in, else the only one. Throws a designer-readable error otherwise. */
+export function resolvePrototype(ws, name, from) {
+    if (name)
+        return projectIn(ws, name);
+    const found = findProject(from ?? ws.root);
+    if (found && found.workspace.root === ws.root)
+        return found;
+    const all = listPrototypes(ws);
+    if (!all.length)
+        throw new KitError("This workspace has no prototypes yet. Ask Claude to start one.");
+    throw new KitError(`This workspace has several prototypes (${all.join(", ")}). Say which one.`);
+}
+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}`);
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readContract(from) {
+    const ws = "workspace" in from ? from.workspace : from;
+    const tokensJson = readJson(ws.abs(`${WORKSPACE_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 = ws.abs(`${WORKSPACE_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 {};