@cogitato/kit-cli 0.0.0-stage → 0.1.0

package/dist/rules/css-values.js

@@ -0,0 +1,185 @@
+import { tokenCssVar } from "@cogitato/contract";
+// Which CSS properties must use tokens, and which token group sizes come from.
+const COLOR_PROP = /^(color|background(-color|-image)?|border(-(top|right|bottom|left|block|inline)(-(start|end))?)?(-color)?|outline(-color)?|fill|stroke|box-shadow|text-shadow|text-decoration(-color)?|caret-color|accent-color|column-rule(-color)?)$/;
+const SIZE_GROUPS = [
+    { prop: /^(padding|margin)(-(top|right|bottom|left|block|inline)(-(start|end))?)?$|^(row-|column-)?gap$/, group: "space", scale: "spacing scale" },
+    { prop: /^border(-(top|bottom)-(left|right)|-(start|end)-(start|end))?-radius$/, group: "radius", scale: "corner radius scale" },
+    { prop: /^font-size$/, group: "font.size", scale: "font size scale" },
+];
+// Named colors designers are likely to type, with values so the nearest token can be suggested.
+const NAMED_COLORS = {
+    black: "#000000", white: "#ffffff", red: "#ff0000", green: "#008000", blue: "#0000ff",
+    yellow: "#ffff00", orange: "#ffa500", purple: "#800080", pink: "#ffc0cb", gray: "#808080",
+    grey: "#808080", silver: "#c0c0c0", navy: "#000080", teal: "#008080", maroon: "#800000",
+    olive: "#808000", lime: "#00ff00", aqua: "#00ffff", cyan: "#00ffff", magenta: "#ff00ff",
+    fuchsia: "#ff00ff", brown: "#a52a2a", gold: "#ffd700", indigo: "#4b0082", violet: "#ee82ee",
+    coral: "#ff7f50", salmon: "#fa8072", tomato: "#ff6347", crimson: "#dc143c", beige: "#f5f5dc",
+    ivory: "#fffff0", khaki: "#f0e68c", lavender: "#e6e6fa", tan: "#d2b48c", turquoise: "#40e0d0",
+    darkgray: "#a9a9a9", darkgrey: "#a9a9a9", lightgray: "#d3d3d3", lightgrey: "#d3d3d3",
+    whitesmoke: "#f5f5f5", gainsboro: "#dcdcdc", slategray: "#708090", dimgray: "#696969",
+};
+const HEX = /#([0-9a-fA-F]{8}|[0-9a-fA-F]{6}|[0-9a-fA-F]{3,4})\b/g;
+const COLOR_FN = /\b(rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\([^()]*\)/gi;
+const NAMED = new RegExp(`(?<![\\w-])(${Object.keys(NAMED_COLORS).join("|")})(?![\\w-])`, "gi");
+const LENGTH = /(?<![\w.-])(-?\d*\.?\d+)(px|rem|em)\b/g;
+const VAR = /var\(\s*(--[A-Za-z0-9_-]+)/g;
+/** Stands in for a `${...}` substitution when a template literal's text is checked. */
+export const SUBSTITUTION = "\u0001";
+const toKebab = (prop) => prop.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+function parseColor(literal) {
+    const named = NAMED_COLORS[literal.toLowerCase()];
+    const value = named ?? literal;
+    const hex = /^#([0-9a-f]{3,8})$/i.exec(value)?.[1];
+    if (hex) {
+        const full = hex.length <= 4 ? [...hex.slice(0, 3)].map((c) => c + c).join("") : hex.slice(0, 6);
+        return [0, 2, 4].map((i) => parseInt(full.slice(i, i + 2), 16));
+    }
+    const rgb = /^rgba?\(\s*(\d+)[\s,]+(\d+)[\s,]+(\d+)/i.exec(value);
+    if (rgb)
+        return [Number(rgb[1]), Number(rgb[2]), Number(rgb[3])];
+    return undefined;
+}
+const distance = (a, b) => Math.hypot(a[0] - b[0], a[1] - b[1], a[2] - b[2]);
+// Semantic token group that fits a property best, used to break ties between equal colors.
+function colorContext(prop) {
+    if (prop === "color" || prop.startsWith("text-") || prop === "caret-color")
+        return "color.text.";
+    if (prop.startsWith("background"))
+        return "color.surface.";
+    if (prop.startsWith("border") || prop.startsWith("outline") || prop.startsWith("column-rule"))
+        return "color.border.";
+    return "";
+}
+function nearestColor(contract, rgb, prop) {
+    const context = colorContext(prop);
+    const scored = contract.tokens
+        .filter((t) => t.type === "color" && typeof t.resolved === "string")
+        .map((t) => ({ t, rgb: parseColor(t.resolved) }))
+        .filter((x) => x.rgb !== undefined)
+        .map(({ t, rgb: c }) => ({
+        t,
+        key: [distance(rgb, c), context && t.path.startsWith(context) ? 0 : 1, t.aliasOf ? 1 : 0],
+    }))
+        .sort((a, b) => a.key[0] - b.key[0] || a.key[1] - b.key[1] || a.key[2] - b.key[2] || a.t.path.localeCompare(b.t.path));
+    const best = scored[0];
+    return best ? { token: best.t, exact: best.key[0] === 0 } : undefined;
+}
+function toPx(value) {
+    if (typeof value === "string") {
+        const m = /^(-?\d*\.?\d+)(px|rem)$/.exec(value);
+        return m ? Number(m[1]) * (m[2] === "rem" ? 16 : 1) : undefined;
+    }
+    if (value && typeof value === "object" && "value" in value && "unit" in value) {
+        const v = value;
+        return v.unit === "rem" ? v.value * 16 : v.unit === "px" ? v.value : undefined;
+    }
+    return undefined;
+}
+function nearestSize(contract, px, group) {
+    const best = contract.tokens
+        .filter((t) => t.type === "dimension" && t.path.startsWith(`${group}.`))
+        .map((t) => ({ t, px: toPx(t.resolved) }))
+        .filter((x) => x.px !== undefined)
+        .sort((a, b) => Math.abs(a.px - px) - Math.abs(b.px - px) || (a.t.aliasOf ? 1 : 0) - (b.t.aliasOf ? 1 : 0))[0];
+    return best ? { token: best.t, px: best.px, exact: best.px === px } : undefined;
+}
+function levenshtein(a, b) {
+    const row = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        let prev = row[0];
+        row[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const tmp = row[j];
+            row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+            prev = tmp;
+        }
+    }
+    return row[b.length];
+}
+const label = (t) => (t.description ? `${t.path} (${t.description})` : t.path);
+/**
+ * Checks one CSS declaration (or inline style property). `prop` may be camelCase.
+ * Token variables, 0, auto, inherit, transparent, currentColor and percentages are fine.
+ */
+export function checkCssValue(contract, rawProp, value) {
+    const prop = toKebab(rawProp.trim()).toLowerCase();
+    if (prop.startsWith("--"))
+        return [];
+    const findings = [];
+    for (const m of value.matchAll(VAR)) {
+        const name = m[1];
+        // A name finished by a substitution (`var(--kit-space-${gap})`) is only known at runtime.
+        if (value[m.index + m[0].length] === SUBSTITUTION)
+            continue;
+        if (!name.startsWith("--kit-") || contract.cssVars.has(name))
+            continue;
+        // Ties go to names of the same length: --kit-color-brand-650 is nearer 600 than 50.
+        const closest = [...contract.cssVars].sort((a, b) => levenshtein(name, a) - levenshtein(name, b) ||
+            Math.abs(a.length - name.length) - Math.abs(b.length - name.length))[0];
+        findings.push({
+            kind: "unknown-token",
+            literal: name,
+            message: `var(${name}) isn't a token in the design system. Check the spelling${closest ? `; did you mean var(${closest})?` : ", or pick an existing token."}`,
+            ...(closest ? { suggestion: `var(${closest})` } : {}),
+        });
+    }
+    // Token references are fine; check only what's left once they're removed.
+    let rest = value.replaceAll(SUBSTITUTION, " ");
+    while (/var\([^()]*\)/.test(rest))
+        rest = rest.replace(/var\([^()]*\)/g, " ");
+    if (COLOR_PROP.test(prop)) {
+        const literals = [...rest.matchAll(HEX), ...rest.matchAll(COLOR_FN), ...rest.matchAll(NAMED)].map((m) => m[0]);
+        for (const literal of literals) {
+            const rgb = parseColor(literal);
+            const hit = rgb && nearestColor(contract, rgb, prop);
+            const suggestion = hit ? `var(${tokenCssVar(hit.token.path)})` : undefined;
+            findings.push({
+                kind: "color",
+                literal,
+                message: !hit
+                    ? `This color (${literal}) isn't from the palette. Use a color token instead.`
+                    : hit.exact
+                        ? `${literal} is ${label(hit.token)} in the palette. Use the token instead of typing the color, so it stays in sync with the design system.`
+                        : `This color (${literal}) isn't in the palette. Use ${label(hit.token)} instead; it's the closest match.`,
+                ...(suggestion ? { suggestion } : {}),
+            });
+        }
+    }
+    const size = SIZE_GROUPS.find((g) => g.prop.test(prop));
+    if (size) {
+        for (const m of rest.matchAll(LENGTH)) {
+            const amount = Number(m[1]);
+            if (amount === 0)
+                continue;
+            const px = amount * (m[2] === "px" ? 1 : 16);
+            const hit = nearestSize(contract, px, size.group);
+            const suggestion = hit ? `var(${tokenCssVar(hit.token.path)})` : undefined;
+            findings.push({
+                kind: "size",
+                literal: m[0],
+                message: !hit
+                    ? `${m[0]} isn't on the ${size.scale}. Use a ${size.group} token instead.`
+                    : hit.exact
+                        ? `${m[0]} is ${hit.token.path} on the ${size.scale}. Use the token instead of typing the size.`
+                        : `${m[0]} isn't on the ${size.scale}. Use ${hit.token.path} (${hit.px}px) instead; it's the closest size.`,
+                ...(suggestion ? { suggestion } : {}),
+            });
+        }
+    }
+    return findings;
+}
+/** A bare number in a React inline style means pixels. */
+export function checkCssNumber(contract, rawProp, n) {
+    if (n === 0)
+        return [];
+    const prop = toKebab(rawProp).toLowerCase();
+    if (!SIZE_GROUPS.some((g) => g.prop.test(prop)))
+        return [];
+    return checkCssValue(contract, prop, `${n}px`);
+}
+export const FINDING_CODES = {
+    color: "code-hardcoded-color",
+    size: "code-hardcoded-size",
+    "unknown-token": "code-unknown-token",
+};
+//# sourceMappingURL=css-values.js.map

package/dist/rules/css-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-values.js","sourceRoot":"","sources":["../../src/rules/css-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,oBAAoB,CAAC;AAGrE,+EAA+E;AAC/E,MAAM,UAAU,GACd,wOAAwO,CAAC;AAE3O,MAAM,WAAW,GAAqD;IACpE,EAAE,IAAI,EAAE,gGAAgG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;IAClJ,EAAE,IAAI,EAAE,uEAAuE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,EAAE;IAChI,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE;CACtE,CAAC;AAEF,gGAAgG;AAChG,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;IACrF,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;IACzF,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS;IACvF,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS;IACvF,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS;IAC3F,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS;IAC5F,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;IAC7F,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;IACpF,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS;CACtF,CAAC;AAEF,MAAM,GAAG,GAAG,sDAAsD,CAAC;AACnE,MAAM,QAAQ,GAAG,2DAA2D,CAAC;AAC7E,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAChG,MAAM,MAAM,GAAG,wCAAwC,CAAC;AACxD,MAAM,GAAG,GAAG,6BAA6B,CAAC;AAE1C,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAOrC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAIvF,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,IAAI,OAAO,CAAC;IAC/B,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAQ,CAAC;IACzE,CAAC;IACD,MAAM,GAAG,GAAG,yCAAyC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,GAAG;QAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvF,2FAA2F;AAC3F,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IACjG,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,eAAe,CAAC;IACtH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,QAAsB,EAAE,GAAQ,EAAE,IAAY;IAClE,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;SACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,QAAkB,CAAC,EAAE,CAAC,CAAC;SAC1D,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC;SACvE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAU;KACnG,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC9E,MAAM,CAAC,GAAG,KAAwC,CAAC;QACnD,OAAO,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,QAAsB,EAAE,EAAU,EAAE,KAAa;IACpE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;SACzC,MAAM,CAAC,CAAC,CAAC,EAAyC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC;SACxE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjH,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACnB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;YACpB,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxF,IAAI,GAAG,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC;AACxB,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE9F;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB,EAAE,OAAe,EAAE,KAAa;IAClF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,0FAA0F;QAC1F,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,YAAY;YAAE,SAAS;QAC5D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACvE,oFAAoF;QACpF,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CACtE,CAAC,CAAC,CAAC,CAAC;QACL,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO,IAAI,2DAA2D,OAAO,CAAC,CAAC,CAAC,sBAAsB,OAAO,IAAI,CAAC,CAAC,CAAC,8BAA8B,EAAE;YAC7J,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,IAAI,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAE9E,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/G,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3E,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO;gBACb,OAAO;gBACP,OAAO,EAAE,CAAC,GAAG;oBACX,CAAC,CAAC,eAAe,OAAO,sDAAsD;oBAC9E,CAAC,CAAC,GAAG,CAAC,KAAK;wBACT,CAAC,CAAC,GAAG,OAAO,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,yGAAyG;wBAC5I,CAAC,CAAC,eAAe,OAAO,+BAA+B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,mCAAmC;gBAC9G,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC3B,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3E,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBACb,OAAO,EAAE,CAAC,GAAG;oBACX,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,iBAAiB;oBAC1E,CAAC,CAAC,GAAG,CAAC,KAAK;wBACT,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,KAAK,6CAA6C;wBAChG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,KAAK,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,qCAAqC;gBAC/G,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,QAAsB,EAAE,OAAe,EAAE,CAAS;IAC/E,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3D,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,sBAAsB;IAC7B,IAAI,EAAE,qBAAqB;IAC3B,eAAe,EAAE,oBAAoB;CAC7B,CAAC"}

package/dist/rules/css.d.ts

@@ -0,0 +1,4 @@
+import type { Issue } from "../issue.js";
+import type { ContractView } from "../project.js";
+/** Token rule for a .css / .module.css file. */
+export declare function checkCssFile(file: string, text: string, contract: ContractView): Issue[];

package/dist/rules/css.js

@@ -0,0 +1,39 @@
+import postcss from "postcss";
+import { FINDING_CODES, checkCssValue } from "./css-values.js";
+/** Token rule for a .css / .module.css file. */
+export function checkCssFile(file, text, contract) {
+    let root;
+    try {
+        root = postcss.parse(text, { from: file });
+    }
+    catch (e) {
+        const err = e;
+        return [
+            {
+                code: "code-css-unreadable",
+                severity: "error",
+                file,
+                path: "",
+                ...(err.line ? { line: err.line } : {}),
+                ...(err.column ? { column: err.column } : {}),
+                message: `This stylesheet has a typo Cogitato can't read past (${err.reason ?? "invalid CSS"}).`,
+            },
+        ];
+    }
+    const issues = [];
+    root.walkDecls((decl) => {
+        for (const f of checkCssValue(contract, decl.prop, decl.value)) {
+            issues.push({
+                code: FINDING_CODES[f.kind],
+                severity: "error",
+                file,
+                path: "",
+                ...(decl.source?.start ? { line: decl.source.start.line, column: decl.source.start.column } : {}),
+                message: f.message,
+                ...(f.suggestion ? { suggestion: f.suggestion } : {}),
+            });
+        }
+    });
+    return issues;
+}
+//# sourceMappingURL=css.js.map

package/dist/rules/css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/rules/css.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE/D,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY,EAAE,QAAsB;IAC7E,IAAI,IAAkB,CAAC;IACvB,IAAI,CAAC;QACH,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAwD,CAAC;QACrE,OAAO;YACL;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,IAAI;gBACJ,IAAI,EAAE,EAAE;gBACR,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,OAAO,EAAE,wDAAwD,GAAG,CAAC,MAAM,IAAI,aAAa,IAAI;aACjG;SACF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QACtB,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,IAAI;gBACJ,IAAI,EAAE,EAAE;gBACR,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjG,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/rules/tsx.d.ts

@@ -0,0 +1,24 @@
+import ts from "typescript";
+import { type Issue } from "../issue.js";
+import { type ContractView } from "../project.js";
+import { type ScreenEntry } from "../registry.js";
+/** A literal data-kit-id found in code, for duplicate detection across a screen's files. */
+export interface KitIdUse {
+    id: string;
+    owner?: ScreenEntry;
+    file: string;
+    line: number;
+    column: number;
+}
+export interface TsxContext {
+    contract: ContractView;
+    /** The screen whose folder contains this file, if any. */
+    owner?: ScreenEntry;
+}
+/** Token, component and data-kit-id rules for one .ts/.tsx file. */
+export declare function checkTsxFile(sf: ts.SourceFile, ctx: TsxContext): {
+    issues: Issue[];
+    kitIds: KitIdUse[];
+};
+/** Duplicate data-kit-ids within one screen. Reported where the later use is. */
+export declare function duplicateKitIds(uses: KitIdUse[]): Issue[];

package/dist/rules/tsx.js

@@ -0,0 +1,190 @@
+import { posix } from "node:path";
+import ts from "typescript";
+import { issueAt, literalText, propertyName } from "../issue.js";
+import { LAYOUT, isKitFile } from "../project.js";
+import { ID_PATTERNS } from "../registry.js";
+import { FINDING_CODES, SUBSTITUTION, checkCssNumber, checkCssValue } from "./css-values.js";
+const NATIVE_INTERACTIVE = new Set(["button", "a", "input", "select", "textarea"]);
+/** Kit component name for an import specifier, or undefined if it doesn't point into src/kit. */
+function kitImportName(file, specifier) {
+    let rest;
+    if (specifier.startsWith("@/kit/"))
+        rest = specifier.slice("@/kit/".length);
+    else if (specifier.startsWith(".")) {
+        const target = posix.normalize(posix.join(posix.dirname(file), specifier));
+        if (target.startsWith(`${LAYOUT.kit}/`))
+            rest = target.slice(LAYOUT.kit.length + 1);
+    }
+    const name = rest?.split("/")[0]?.replace(/\.(tsx?|jsx?)$/, "");
+    // Lowercase files and stylesheets in the kit folder are helpers, not components.
+    return name && /^[A-Z][A-Za-z0-9]*$/.test(name) ? name : undefined;
+}
+const slugify = (s) => s
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 30)
+    .replace(/-+$/, "");
+// A readable element name for a suggested id: from its label, aria-label, name or text.
+function suggestElementName(el, sf) {
+    for (const attr of el.attributes.properties) {
+        if (!ts.isJsxAttribute(attr) || !attr.initializer)
+            continue;
+        const name = attr.name.getText(sf);
+        if (!["label", "aria-label", "name", "placeholder", "title"].includes(name))
+            continue;
+        const text = ts.isStringLiteral(attr.initializer) ? attr.initializer.text : undefined;
+        if (text && slugify(text))
+            return slugify(text);
+    }
+    const parent = el.parent;
+    if (ts.isJsxElement(parent)) {
+        const text = parent.children
+            .filter(ts.isJsxText)
+            .map((c) => c.text)
+            .join(" ")
+            .trim();
+        if (text && slugify(text))
+            return slugify(text);
+    }
+    return slugify(el.tagName.getText(sf)) || "element";
+}
+/** Token, component and data-kit-id rules for one .ts/.tsx file. */
+export function checkTsxFile(sf, ctx) {
+    const issues = [];
+    const kitIds = [];
+    const file = sf.fileName;
+    const inKit = isKitFile(file);
+    const { contract, owner } = ctx;
+    // Local identifier -> kit component name, from this file's imports.
+    const kitLocals = new Map();
+    const styleFindings = (prop, node) => {
+        const findings = ts.isNumericLiteral(node)
+            ? checkCssNumber(contract, prop, Number(node.text))
+            : ts.isTemplateExpression(node)
+                ? checkCssValue(contract, prop, [node.head.text, ...node.templateSpans.map((s) => s.literal.text)].join(SUBSTITUTION))
+                : literalText(node) !== undefined
+                    ? checkCssValue(contract, prop, literalText(node))
+                    : [];
+        for (const f of findings) {
+            issues.push(issueAt(FINDING_CODES[f.kind], sf, node, f.message, f.suggestion ? { suggestion: f.suggestion } : {}));
+        }
+    };
+    const checkKitId = (el, what) => {
+        let idAttr;
+        let hasSpread = false;
+        for (const a of el.attributes.properties) {
+            if (ts.isJsxSpreadAttribute(a))
+                hasSpread = true;
+            else if (a.name.getText(sf) === "data-kit-id")
+                idAttr = a;
+        }
+        const prefix = owner?.id;
+        const example = `${prefix ?? "screen.id"}.${suggestElementName(el, sf)}`;
+        if (!idAttr) {
+            // A spread may be passing the id through; that's the kit-wrapper pattern.
+            if (hasSpread)
+                return;
+            issues.push(issueAt("code-missing-kit-id", sf, el, `This ${what} needs a data-kit-id so comments can be pinned to it. Add data-kit-id="${example}".`, {
+                suggestion: example,
+            }));
+            return;
+        }
+        const init = idAttr.initializer;
+        const expr = init && ts.isJsxExpression(init) ? init.expression : init;
+        const id = literalText(expr);
+        if (id === undefined) {
+            if (expr && ts.isTemplateExpression(expr) && prefix && !expr.head.text.startsWith(`${prefix}.`)) {
+                issues.push(issueAt("code-invalid-kit-id", sf, expr, `This element id doesn't start with "${prefix}.", the ${owner.title} screen's id. Element ids start with their screen's id.`));
+            }
+            else if (!expr || !ts.isTemplateExpression(expr)) {
+                issues.push(issueAt("code-kit-id-unchecked", sf, idAttr, `This data-kit-id is computed, so Cogitato can't check it. Prefer plain text, like data-kit-id="${example}".`, {
+                    severity: "warning",
+                }));
+            }
+            return;
+        }
+        if (!ID_PATTERNS.kitId.test(id)) {
+            issues.push(issueAt("code-invalid-kit-id", sf, idAttr, `"${id}" isn't a valid element id. Element ids are the screen id plus an element name, lowercase and dot-separated, like "${example}".`, {
+                suggestion: example,
+            }));
+            return;
+        }
+        if (prefix && !id.startsWith(`${prefix}.`)) {
+            const fixed = `${prefix}.${id.slice(id.lastIndexOf(".") + 1)}`;
+            issues.push(issueAt("code-invalid-kit-id", sf, idAttr, `"${id}" doesn't start with this screen's id. Elements on the ${owner.title} screen need ids starting with "${prefix}.", like "${fixed}".`, {
+                suggestion: fixed,
+            }));
+            return;
+        }
+        const { line, character } = sf.getLineAndCharacterOfPosition(idAttr.getStart(sf));
+        kitIds.push({ id, owner, file, line: line + 1, column: character + 1 });
+    };
+    const visit = (node) => {
+        if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
+            const name = kitImportName(file, node.moduleSpecifier.text);
+            if (name && !inKit) {
+                if (!contract.manifests.has(name)) {
+                    issues.push(issueAt("code-unknown-component", sf, node, `${name} isn't in the design system yet, so it can't be used here. Use an existing component from the kit, or record it as a gap so the team can add it.`));
+                }
+                const clause = node.importClause;
+                if (clause?.name)
+                    kitLocals.set(clause.name.text, name);
+                if (clause?.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+                    for (const el of clause.namedBindings.elements) {
+                        kitLocals.set(el.name.text, (el.propertyName ?? el.name).text);
+                    }
+                }
+            }
+        }
+        if ((ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node)) && !inKit) {
+            const tag = node.tagName.getText(sf);
+            const handlers = node.attributes.properties.some((a) => ts.isJsxAttribute(a) && /^on[A-Z]/.test(a.name.getText(sf)));
+            const kitName = kitLocals.get(tag);
+            const manifest = kitName ? contract.manifests.get(kitName) : undefined;
+            const kitInteractive = manifest ? Object.values(manifest.props).some((p) => p?.type === "event") : false;
+            if (NATIVE_INTERACTIVE.has(tag) || handlers || kitInteractive) {
+                checkKitId(node, kitName ? `${kitName}` : /^[a-z]/.test(tag) ? `<${tag}>` : `${tag}`);
+            }
+        }
+        if (ts.isJsxAttribute(node) && node.name.getText(sf) === "style" && node.initializer && ts.isJsxExpression(node.initializer)) {
+            const obj = node.initializer.expression;
+            if (obj && ts.isObjectLiteralExpression(obj)) {
+                for (const p of obj.properties) {
+                    if (!ts.isPropertyAssignment(p))
+                        continue;
+                    const prop = propertyName(p.name);
+                    if (prop)
+                        styleFindings(prop, p.initializer);
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return { issues, kitIds };
+}
+/** Duplicate data-kit-ids within one screen. Reported where the later use is. */
+export function duplicateKitIds(uses) {
+    const first = new Map();
+    const issues = [];
+    for (const u of uses) {
+        const key = `${u.owner?.id ?? ""}|${u.id}`;
+        const prev = first.get(key);
+        if (!prev) {
+            first.set(key, u);
+            continue;
+        }
+        issues.push({
+            code: "code-duplicate-kit-id",
+            severity: "error",
+            file: u.file,
+            path: "",
+            line: u.line,
+            column: u.column,
+            message: `"${u.id}" is used twice${u.owner ? ` on the ${u.owner.title} screen` : ""} (also at ${prev.file}, line ${prev.line}). Each element needs its own id so comments land on the right one.`,
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=tsx.js.map

package/dist/rules/tsx.js.map

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

package/dist/save.d.ts

@@ -0,0 +1,27 @@
+import type { FlowManifest, Issue } from "@cogitato/contract";
+import { type Project } from "./project.js";
+export interface SaveOptions {
+    /** Replaces the generated first line of the commit message. */
+    message?: string;
+    /** For tests. */
+    now?: Date;
+}
+export interface SaveResult {
+    saved: boolean;
+    branch?: string;
+    /** Short commit id. */
+    commit?: string;
+    /** The commit message's first line. */
+    summary?: string;
+    pushed: boolean;
+    /** The branch's hosted canvas, when the prototype has hosting set up and the push worked. */
+    preview?: string;
+    /** One or two plain sentences for the designer. */
+    message: string;
+    /** Validation problems at the time of saving. They don't stop the save. */
+    issues: Issue[];
+}
+/** What changed between two flows.json versions, as short phrases: "add screen checkout.review". */
+export declare function describeChanges(before: FlowManifest | undefined, after: FlowManifest): string[];
+/** Saves a version of the prototype: commit on a design branch, then push if there's a remote. */
+export declare function saveVersion(project: Project, opts?: SaveOptions): SaveResult;

package/dist/save.js

@@ -0,0 +1,125 @@
+import { spawnSync } from "node:child_process";
+import { KitError } from "./errors.js";
+import { exportFlows } from "./export-flows.js";
+import { sameManifest } from "./flows.js";
+import { previewLink } from "./links.js";
+import { LAYOUT } from "./project.js";
+import { statusLabel } from "./status.js";
+import { validate } from "./validate.js";
+function git(project, args, raw = false) {
+    const r = spawnSync("git", args, { cwd: project.root, encoding: "utf8" });
+    return { ok: r.status === 0, out: raw ? (r.stdout ?? "") : (r.stdout ?? "").trim(), err: (r.stderr ?? "").trim() };
+}
+const slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "designer";
+/** What changed between two flows.json versions, as short phrases: "add screen checkout.review". */
+export function describeChanges(before, after) {
+    const states = (m) => new Map((m?.screens ?? []).flatMap((s) => s.states.map((st) => [`${s.id}.${st.id}`, s.id])));
+    const screens = (m) => new Set((m?.screens ?? []).map((s) => s.id));
+    const [s0, s1, st0, st1] = [screens(before), screens(after), states(before), states(after)];
+    const out = [];
+    for (const id of s1)
+        if (!s0.has(id))
+            out.push(`add screen ${id}`);
+    for (const [node, screen] of st1)
+        if (!st0.has(node) && s0.has(screen))
+            out.push(`add state ${node}`);
+    for (const id of s0)
+        if (!s1.has(id))
+            out.push(`remove screen ${id}`);
+    for (const [node, screen] of st0)
+        if (!st1.has(node) && s1.has(screen))
+            out.push(`remove state ${node}`);
+    for (const [node, status] of Object.entries(after.status ?? {})) {
+        if (st1.has(node) && before?.status?.[node] !== status)
+            out.push(`mark ${node} ${statusLabel(status ?? "exploring").toLowerCase()}`);
+    }
+    const edges = (m) => new Set((m?.flows ?? []).flatMap((f) => f.edges.map((e) => `${e.from}>${e.to}`)));
+    const [e0, e1] = [edges(before), edges(after)];
+    const newEdges = [...e1].filter((e) => !e0.has(e)).length;
+    if (newEdges && !out.length)
+        out.push(`connect ${newEdges} step${newEdges === 1 ? "" : "s"} in the flow`);
+    return out;
+}
+function summarize(changes, files) {
+    if (changes.length) {
+        const line = changes.join("; ");
+        const text = line.length <= 68 ? line : `${changes[0]} and ${changes.length - 1} more change${changes.length === 2 ? "" : "s"}`;
+        return text.charAt(0).toUpperCase() + text.slice(1);
+    }
+    const screens = [...new Set(files.map((f) => /^src\/screens\/(.+)\/[^/]+$/.exec(f)?.[1]).filter(Boolean))];
+    if (screens.length === 1)
+        return `Update ${screens[0].split("/").join(".")}`;
+    if (screens.length > 1)
+        return `Update ${screens.length} screens`;
+    if (files.some((f) => f.startsWith(`${LAYOUT.contract}/`)))
+        return "Update the design contract";
+    return "Update the prototype";
+}
+/** Saves a version of the prototype: commit on a design branch, then push if there's a remote. */
+export function saveVersion(project, opts = {}) {
+    if (!git(project, ["rev-parse", "--is-inside-work-tree"]).ok) {
+        throw new KitError("This prototype doesn't keep a history yet, so versions can't be saved. Ask a developer to set it up with git.");
+    }
+    const exported = exportFlows(project);
+    const before = git(project, ["show", `HEAD:${LAYOUT.flowsJson}`]);
+    let previous;
+    try {
+        previous = before.ok ? JSON.parse(before.out) : undefined;
+    }
+    catch {
+        previous = undefined;
+    }
+    const status = git(project, ["status", "--porcelain", "--untracked-files=all"], true);
+    const files = status.out
+        .split("\n")
+        .filter(Boolean)
+        .map((l) => l.slice(3).replace(/^"|"$/g, "").split(" -> ").pop())
+        // A flows.json whose only change is the commit it was exported at isn't worth a version.
+        .filter((f) => !(f === LAYOUT.flowsJson && previous && sameManifest(previous, exported.manifest, { status: true })));
+    const issues = validate(project).issues.filter((i) => i.severity === "error");
+    if (!files.length)
+        return { saved: false, pushed: false, message: "Nothing new to save: everything is already saved.", issues };
+    const user = git(project, ["config", "user.name"]).out;
+    if (!user || !git(project, ["config", "user.email"]).out) {
+        throw new KitError("Saving needs your name and email set up once on this computer. Ask Claude to set them (git config user.name and user.email).");
+    }
+    let branch = git(project, ["rev-parse", "--abbrev-ref", "HEAD"]).out;
+    if (branch === "main" || branch === "master" || branch === "HEAD") {
+        const d = (opts.now ?? new Date()).toISOString().slice(0, 10).replace(/-/g, "");
+        const base = `design/${slug(user)}-${d}`;
+        branch = base;
+        for (let n = 2; git(project, ["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`]).ok; n++)
+            branch = `${base}-${n}`;
+        const sw = git(project, ["switch", "-c", branch]);
+        if (!sw.ok)
+            throw new KitError(`Couldn't start a design branch for your work (${sw.err}).`);
+    }
+    const changes = describeChanges(previous, exported.manifest);
+    const summary = opts.message?.trim() || summarize(changes, files);
+    const body = [
+        ...(changes.length > 1 ? changes.map((c) => `- ${c}`) : []),
+        ...(issues.length ? [`Saved with ${issues.length} validation problem${issues.length === 1 ? "" : "s"} still open.`] : []),
+    ].join("\n");
+    if (!git(project, ["add", "-A"]).ok)
+        throw new KitError("Couldn't collect your changes to save them.");
+    const commit = git(project, ["commit", "-q", "-m", summary, ...(body ? ["-m", body] : [])]);
+    if (!commit.ok)
+        throw new KitError(`Couldn't save the version (${commit.err || commit.out}).`);
+    const sha = git(project, ["rev-parse", "--short", "HEAD"]).out;
+    const remote = git(project, ["remote"]).out.split("\n").filter(Boolean)[0];
+    let pushed = false;
+    let where = "Saved on this computer (there's no shared copy to send it to yet).";
+    if (remote) {
+        const push = git(project, ["push", "-u", remote, branch]);
+        pushed = push.ok;
+        where = push.ok
+            ? `Saved and shared on the "${branch}" branch.`
+            : `Saved on this computer, but sharing it failed (${push.err.split("\n")[0]}). Try saving again later.`;
+    }
+    const preview = pushed ? previewLink(project, branch) : undefined;
+    if (preview)
+        where += ` Your preview will be at ${preview} in a minute or two.`;
+    const problems = issues.length ? ` Heads up: ${issues.length} validation problem${issues.length === 1 ? " is" : "s are"} still open.` : "";
+    return { saved: true, branch, commit: sha, summary, pushed, ...(preview ? { preview } : {}), message: `${where} Version: "${summary}".${problems}`, issues };
+}
+//# sourceMappingURL=save.js.map