@lyse-labs/lyse 0.1.0-alpha.2

package/dist/rules/tokens-no-hardcoded-color.js

@@ -0,0 +1,436 @@
+import { isAbsolute, join } from "node:path";
+import { isInsideCodeDisplay, isCssCustomPropertyDeclaration } from "./_skip-context.js";
+import { isPathExcluded } from "./_exclude.js";
+import { fixHardcodedColor } from "../codemods/tokens-color.js";
+import { adaptOldCodemodResult } from "./_codemod-adapter.js";
+import { createLyseRule } from "./_rule-module.js";
+import { getTsMorphProject } from "../parsers/ts-morph-project.js";
+// Allow one level of nested parens so hsl(var(--token)) is captured whole.
+// Pattern: (?:[^)(]|\([^)]*\))* matches any mix of non-paren chars and
+// single-level nested groups.
+const COLOR_FUNC = /(#([0-9a-fA-F]{3,4}){1,2})\b|rgb[a]?\((?:[^)(]|\([^)]*\))*\)|hsl[a]?\((?:[^)(]|\([^)]*\))*\)|oklch\((?:[^)(]|\([^)]*\))*\)/g;
+const TW_ARBITRARY = /\b(bg|text|border|fill|stroke|ring|shadow|from|to|via|outline|caret|accent|decoration|divide|placeholder)-\[#[0-9a-fA-F]{3,8}\]/g;
+const ALLOWLIST = new Set(["currentColor", "transparent", "inherit", "initial", "unset", "none", "auto"]);
+/**
+ * Matches color function calls whose ENTIRE argument is a CSS variable
+ * reference — e.g. hsl(var(--background)), rgba(var(--brand), 0.5),
+ * oklch(var(--c)). These are token USES (shadcn/radix theming pattern), not
+ * hardcoded colors.
+ *
+ * The regex allows an optional alpha comma-arg: var(--x), 0.5
+ */
+const COLOR_VAR_REF = /^(?:hsl[a]?|rgb[a]?|oklch)\(\s*var\(--[a-zA-Z0-9_-]+\)(?:\s*,\s*[^)]+)?\s*\)$/;
+function shouldSkip(value) {
+    return ALLOWLIST.has(value.trim());
+}
+/**
+ * Reads the function name immediately before the opening paren at `parenIdx`.
+ * E.g. for "var(" it returns "var", for "linear-gradient(" it returns "linear-gradient".
+ */
+function readFunctionNameBackwards(source, parenIdx) {
+    const end = parenIdx; // exclusive — the char at parenIdx is '('
+    // walk back over identifier chars (letters, digits, hyphens)
+    let i = end - 1;
+    while (i >= 0 && /[a-zA-Z0-9_-]/.test(source[i])) {
+        i--;
+    }
+    return source.slice(i + 1, end);
+}
+/**
+ * Returns true if the hit at `hitStart` is nested inside a `var(...)` call.
+ * Walks backwards counting unmatched parens; when the first unmatched opening
+ * paren is found, checks whether it belongs to a `var` call.
+ *
+ * Handles:
+ *   var(--token, #hex)              → true
+ *   var(--a, var(--b, #hex))        → true (inner var is the unmatched paren)
+ *   linear-gradient(red, #hex)      → false (outer = linear-gradient)
+ *   linear-gradient(r, var(--v, #h), b) → true (outer of #h is var)
+ */
+function isInsideVarCall(source, hitStart) {
+    let depth = 0;
+    for (let i = hitStart - 1; i >= 0; i--) {
+        const c = source[i];
+        if (c === ")") {
+            depth++;
+        }
+        else if (c === "(") {
+            if (depth === 0) {
+                // found the first unmatched opening paren — check its function name
+                const funcName = readFunctionNameBackwards(source, i);
+                return funcName === "var";
+            }
+            depth--;
+        }
+    }
+    return false;
+}
+/**
+ * Returns true if the hit at `hitStart` is on a comment line or inside a URL
+ * fragment, which means the "color" is not a real CSS value.
+ *
+ * Detects:
+ *   // comment with #issue-ref
+ *   /* block comment with #hex *\/
+ *    * doc-comment line with #hex
+ *   https://example.com#fragment or similar URL fragment
+ */
+function isInCommentOrUrl(source, hitStart) {
+    // Find the start of the current line
+    const lineStart = source.lastIndexOf("\n", hitStart - 1) + 1;
+    const linePrefix = source.slice(lineStart, hitStart).trimStart();
+    // // single-line comment
+    if (linePrefix.startsWith("//"))
+        return true;
+    // /* block comment or * continuation line
+    if (linePrefix.startsWith("/*") || linePrefix.startsWith("*"))
+        return true;
+    // URL fragment: look back ~60 chars for "://" then check we're after a "#"
+    // that follows something that looks like a URL (no whitespace between)
+    const lookback = source.slice(Math.max(0, hitStart - 60), hitStart);
+    // If there's "://" in the lookback and no whitespace between it and our position
+    if (lookback.includes("://") && !/\s/.test(lookback.split("://").pop() ?? "")) {
+        return true;
+    }
+    return false;
+}
+function matchCount(source, pattern) {
+    pattern.lastIndex = 0;
+    const matches = source.match(pattern);
+    return matches ? matches.length : 0;
+}
+// ---------------------------------------------------------------------------
+// Tailwind default color palette — static list, no eval risk.
+// Covers all named colors in Tailwind v3/v4 default theme.
+// ---------------------------------------------------------------------------
+const TW_COLOR_NAMES = [
+    "slate", "gray", "zinc", "neutral", "stone",
+    "red", "orange", "amber", "yellow", "lime",
+    "green", "emerald", "teal", "cyan", "sky",
+    "blue", "indigo", "violet", "purple", "fuchsia",
+    "pink", "rose",
+];
+const TW_COLOR_SHADES = ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
+// e.g. bg-slate-900, text-red-500, border-blue-200
+const TW_COLOR_PREFIXES = "bg|text|border|ring|fill|stroke|divide|decoration|outline";
+const TW_NAMED_SCALE = `(?:${TW_COLOR_NAMES.join("|")})-(?:${TW_COLOR_SHADES.join("|")})`;
+// Build the regex string
+const TW_COLOR_UTILITY_RE = new RegExp(`\\b(?:${TW_COLOR_PREFIXES})-(?:${TW_NAMED_SCALE}|white|black|transparent|current|inherit)\\b`, "g");
+// Simple special cases: bg-white, text-transparent, etc. (already covered above via the trailing alternation)
+/**
+ * Counts compliant (tokenized) color usages that should be counted as
+ * opportunities without being counted as findings. This gives the score
+ * formula a proper denominator so compliant repos score > 0.
+ *
+ * Counts:
+ *  - hsl/hsla/rgb/rgba/oklch wrapping a var() ref (CSS variable theming pattern)
+ *  - standalone var(--token) in CSS declaration position
+ *  - theme.colors.X / theme.palette.X / palette.X.Y / tokens.color.X in TS/TSX/JSX
+ *  - Tailwind utility color classes: bg-slate-900, text-white, border-red-500, etc.
+ */
+export function countCompliantColorUses(source, fileExt) {
+    let count = 0;
+    // Pattern 1: hsl(var(...)), rgba(var(...)), oklch(var(...)), etc.
+    count += matchCount(source, /\b(?:hsl[a]?|rgb[a]?|oklch)\s*\(\s*var\(/g);
+    // Pattern 2: standalone `var(--token)` in CSS declaration value position
+    // Matches `: var(--foo)` followed by ; or } (skips hsl(var()) which pattern 1 already handles)
+    if (fileExt === ".css" || fileExt === ".scss") {
+        count += matchCount(source, /:\s*var\(--[a-zA-Z][\w-]*\)\s*[;},]/g);
+    }
+    // Pattern 3: theme.colors.X / theme.palette.X / palette.X.Y / tokens.color.X in TS/JSX
+    if (fileExt === ".ts" || fileExt === ".tsx" || fileExt === ".jsx" || fileExt === ".js") {
+        count += matchCount(source, /\btheme\.(?:colors|palette)\.[\w.[\]'"`]+/g);
+        count += matchCount(source, /\btokens\.color\.[\w.[\]'"`]+/g);
+        count += matchCount(source, /\bpalette\.[\w]+\.\w+/g);
+    }
+    // Pattern 4: Tailwind utility color classes in TSX/JSX/TS/JS files
+    // bg-slate-900, text-white, border-red-500, ring-blue-200, etc.
+    if (fileExt === ".ts" || fileExt === ".tsx" || fileExt === ".jsx" || fileExt === ".js") {
+        TW_COLOR_UTILITY_RE.lastIndex = 0;
+        count += matchCount(source, TW_COLOR_UTILITY_RE);
+    }
+    return count;
+}
+export function detectInText(source, _path) {
+    const hits = [];
+    COLOR_FUNC.lastIndex = 0;
+    let m;
+    while ((m = COLOR_FUNC.exec(source)) !== null) {
+        if (shouldSkip(m[0]))
+            continue;
+        // Skip any color function whose entire argument is a CSS variable reference
+        // (canonical shadcn / radix-ui theming pattern — NOT hardcoded drift).
+        if (COLOR_VAR_REF.test(m[0]))
+            continue;
+        // Skip values inside <code>...</code> or <pre>...</pre> on the same line
+        // (display-only CSS examples — e.g. shadcn theme customizer).
+        // NOTE: multi-line code blocks are not detected here; V1 needs AST context.
+        if (isInsideCodeDisplay(source, m.index))
+            continue;
+        // Skip hex/color literals that are inside a var() fallback argument.
+        // e.g. var(--token, #8c959f) — the #hex is a safe CSS fallback, not drift.
+        if (isInsideVarCall(source, m.index))
+            continue;
+        // Skip color literals in comments (// /* *) and URL fragments (#anchor).
+        if (isInCommentOrUrl(source, m.index))
+            continue;
+        if (isCssCustomPropertyDeclaration(source, m.index))
+            continue;
+        hits.push({ match: m[0], index: m.index });
+    }
+    TW_ARBITRARY.lastIndex = 0;
+    while ((m = TW_ARBITRARY.exec(source)) !== null) {
+        if (isInsideCodeDisplay(source, m.index))
+            continue;
+        if (isInCommentOrUrl(source, m.index))
+            continue;
+        if (isCssCustomPropertyDeclaration(source, m.index))
+            continue;
+        hits.push({ match: m[0], index: m.index });
+    }
+    return hits;
+}
+function locationFromIndex(source, index) {
+    let line = 1;
+    let column = 1;
+    for (let i = 0; i < index && i < source.length; i++) {
+        if (source.charCodeAt(i) === 10) {
+            line++;
+            column = 1;
+        }
+        else {
+            column++;
+        }
+    }
+    return { line, column };
+}
+function suggestToken(ctx, raw) {
+    if (!ctx.tokens)
+        return undefined;
+    // Extract the hex from a Tailwind arbitrary value like bg-[#fff]
+    const key = raw.replace(/^.*\[(.*)\]$/, "$1").toLowerCase();
+    const tokens = ctx.tokens.colors.get(key) ?? ctx.tokens.colors.get(raw.toLowerCase());
+    if (!tokens || tokens.length === 0)
+        return undefined;
+    if (tokens.length === 1)
+        return `consider replacing with token ${tokens[0]}`;
+    return `consider replacing — multiple candidate tokens: ${tokens.join(", ")}`;
+}
+const evaluate = async (ctx, files) => {
+    const findings = [];
+    let opportunities = 0;
+    for (const f of files.ts) {
+        if (isPathExcluded(f.path, ctx.excludePaths))
+            continue;
+        const fileExt = f.path.match(/\.[^.]+$/)?.[0] ?? ".ts";
+        const hits = detectInText(f.source);
+        const compliantCount = countCompliantColorUses(f.source, fileExt);
+        opportunities += hits.length + compliantCount;
+        for (const h of hits) {
+            const loc = locationFromIndex(f.source, h.index);
+            const suggestion = suggestToken(ctx, h.match);
+            const lineText = f.source.split("\n")[loc.line - 1]?.trim().slice(0, 120);
+            findings.push({
+                ruleId: "tokens/no-hardcoded-color",
+                axis: "tokens",
+                severity: "warning",
+                location: { file: f.path, line: loc.line, column: loc.column },
+                message: `Hardcoded color value: ${h.match}`,
+                ...(suggestion !== undefined && { suggestion }),
+                ...(lineText !== undefined && { context: lineText }),
+            });
+        }
+    }
+    for (const c of files.css) {
+        if (isPathExcluded(c.path, ctx.excludePaths))
+            continue;
+        const fileExt = c.path.match(/\.[^.]+$/)?.[0] ?? ".css";
+        const hits = detectInText(c.source);
+        const compliantCount = countCompliantColorUses(c.source, fileExt);
+        opportunities += hits.length + compliantCount;
+        for (const h of hits) {
+            const loc = locationFromIndex(c.source, h.index);
+            const suggestion = suggestToken(ctx, h.match);
+            findings.push({
+                ruleId: "tokens/no-hardcoded-color",
+                axis: "tokens",
+                severity: "warning",
+                location: { file: c.path, line: loc.line, column: loc.column },
+                message: `Hardcoded color value: ${h.match}`,
+                ...(suggestion !== undefined && { suggestion }),
+            });
+        }
+    }
+    for (const b of files.cssInJs) {
+        if (isPathExcluded(b.path, ctx.excludePaths))
+            continue;
+        const fileExt = b.path.match(/\.[^.]+$/)?.[0] ?? ".tsx";
+        const hits = detectInText(b.content);
+        const compliantCount = countCompliantColorUses(b.content, fileExt);
+        opportunities += hits.length + compliantCount;
+        for (const h of hits) {
+            const suggestion = suggestToken(ctx, h.match);
+            findings.push({
+                ruleId: "tokens/no-hardcoded-color",
+                axis: "tokens",
+                severity: "warning",
+                location: { file: b.path, line: b.line, column: 1 },
+                message: `Hardcoded color value in styled-components: ${h.match}`,
+                ...(suggestion !== undefined && { suggestion }),
+            });
+        }
+    }
+    return { findings, opportunities };
+};
+const TOKEN_DEF_EXPORT_NAME = /^(colors|theme|tokens|palette|brand)$/i;
+const HEX_LITERAL = /^#[0-9a-fA-F]{3,8}$/;
+/**
+ * Uses ts-morph to determine whether `filePath` is the canonical design-token
+ * definition file (e.g. exports `theme = { primary: "#ff0000", ... }`).
+ *
+ * Heuristic: the file's exported declarations include at least one name in
+ * `/^(colors|theme|tokens|palette|brand)$/i` whose initializer is an object
+ * literal with >= 3 string-valued properties, where most string values look
+ * like hex color literals.
+ *
+ * Returns `false` on any error (missing file, parse failure, etc.) so the
+ * check never introduces false negatives — at worst confidence stays "high".
+ */
+function isTokenDefinitionFile(filePath, repoRoot) {
+    if (!/\.(ts|tsx|js|jsx|mjs|cjs)$/.test(filePath))
+        return false;
+    const absolute = isAbsolute(filePath) ? filePath : join(repoRoot, filePath);
+    try {
+        const tsm = getTsMorphProject(repoRoot);
+        const sf = tsm.getSourceFile(absolute);
+        if (!sf)
+            return false;
+        const exported = sf.getExportedDeclarations();
+        for (const [name, decls] of exported) {
+            if (!TOKEN_DEF_EXPORT_NAME.test(name))
+                continue;
+            for (const decl of decls) {
+                if (looksLikeTokenObjectLiteral(decl))
+                    return true;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true if `decl` is (or contains) an object literal with >= 3
+ * string-valued properties of which >= half are hex-color literals.
+ */
+function looksLikeTokenObjectLiteral(decl) {
+    const d = decl;
+    // Variable declarations carry an initializer; object-literal nodes carry
+    // properties directly.
+    let obj;
+    if (typeof d.getInitializer === "function") {
+        const init = d.getInitializer();
+        if (init && typeof init.getProperties === "function") {
+            obj = init;
+        }
+    }
+    else if (typeof d.getProperties === "function") {
+        obj = d;
+    }
+    if (!obj?.getProperties)
+        return false;
+    const props = obj.getProperties();
+    if (props.length < 3)
+        return false;
+    let stringValueCount = 0;
+    let hexishCount = 0;
+    for (const p of props) {
+        const prop = p;
+        if (typeof prop.getInitializer !== "function")
+            continue;
+        const init = prop.getInitializer();
+        if (!init)
+            continue;
+        const raw = typeof init.getLiteralText === "function"
+            ? init.getLiteralText()
+            : typeof init.getText === "function"
+                ? init.getText().replace(/^['"`]|['"`]$/g, "")
+                : undefined;
+        if (typeof raw !== "string")
+            continue;
+        stringValueCount++;
+        if (HEX_LITERAL.test(raw.trim()))
+            hexishCount++;
+    }
+    if (stringValueCount < 3)
+        return false;
+    // Require at least half the string values to look like hex — guards against
+    // false positives on unrelated string maps named "theme" / "brand".
+    return hexishCount * 2 >= stringValueCount;
+}
+const classifyConfidence = (finding, ctx) => {
+    // Extract color value from message — format: "Hardcoded color value: <value>"
+    const colorMatch = finding.message.match(/:\s*(.+)$/);
+    const raw = colorMatch?.[1]?.trim() ?? "";
+    // Alpha channel means uncertain replacement — the token may not carry opacity
+    const hasAlpha = /rgba?\([^)]+,\s*[\d.]+\)|#[0-9a-fA-F]{8}\b/.test(raw);
+    if (hasAlpha)
+        return "medium";
+    if (!raw)
+        return "low";
+    const key = raw.toLowerCase();
+    const candidates = ctx.tokens.colors.get(key) ?? ctx.tokens.colors.get(key.replace(/^.*\[(.*)\]$/, "$1"));
+    if (!candidates || candidates.length === 0)
+        return "low";
+    // Token-definition files (where hex literals are EXPECTED) get medium
+    // confidence so they are not auto-fixed by default. Requires ctx.repoRoot
+    // to be set; if absent, fall through to "high".
+    if (ctx.repoRoot && isTokenDefinitionFile(finding.location.file, ctx.repoRoot)) {
+        return "medium";
+    }
+    return "high";
+};
+const applyCodemod = (finding, ctx) => {
+    const ruleCtx = {
+        repoRoot: "",
+        tokens: ctx.tokens,
+        componentsModule: ctx.config.designSystem?.componentsModule ?? null,
+        componentInventory: [],
+        storyIndex: null,
+        excludePaths: [],
+    };
+    const oldResult = fixHardcodedColor({
+        source: ctx.fileContent,
+        path: finding.location.file,
+        finding,
+        ctx: ruleCtx,
+    });
+    return adaptOldCodemodResult(oldResult);
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "tokens",
+        lyseRuleId: "tokens/no-hardcoded-color",
+        defaultSeverity: "warning",
+        shortDescription: "Disallow hardcoded color values",
+        fullDescription: "Hardcoded color values (#hex, rgb(), hsl(), oklch(), Tailwind arbitrary `bg-[#fff]`) bypass the design system. They survive token changes silently (a brand refresh becomes a manual hunt) and break dark-mode propagation through CSS variables.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/tokens-no-hardcoded-color.md",
+        rationale: `Why it matters
+
+Hardcoded colors are the #1 signal that an AI agent ignored the design contract. They silently fork the design system: each #2563eb that should be color.action.primary is a token-rename bomb waiting to detonate.
+
+When the rule fires, the suggestion includes the matching token from the project's TokenMap when the reverse-lookup yields exactly one candidate. When multiple tokens map to the same color value (common with primitive vs semantic token layers), all candidates are listed — the agent or human picks.`,
+        examples: [
+            { good: '<div className="bg-action-primary text-on-action">', bad: '<div style={{ background: "#2563eb", color: "#fff" }}>' },
+            { good: '<div className="bg-action-primary">', bad: '<div className="bg-[#2563eb]">' },
+            { good: "color: var(--color-action-primary);", bad: "color: hsl(214, 86%, 53%);" },
+        ],
+        allowlist: ["currentColor", "transparent", "inherit", "initial", "unset", "none", "auto"],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+    classifyConfidence,
+    applyCodemod,
+});
+//# sourceMappingURL=tokens-no-hardcoded-color.js.map

package/dist/rules/tokens-no-hardcoded-color.js.map

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

package/dist/rules/tokens-no-hardcoded-spacing.d.ts

@@ -0,0 +1,8 @@
+import type { Rule } from "../types.js";
+/**
+ * Counts compliant Tailwind spacing utility usages in TSX/JSX/TS/JS files.
+ * p-4, m-2, gap-8, space-x-4, w-full, h-screen, etc.
+ * These are on-scale token usages encoded as class names.
+ */
+export declare function countCompliantSpacingUses(source: string, fileExt: string): number;
+export declare const rule: Rule;

package/dist/rules/tokens-no-hardcoded-spacing.js

@@ -0,0 +1,193 @@
+import { isInsideSkippedJsxAttr, isInsideCodeDisplay, isCssCustomPropertyDeclaration } from "./_skip-context.js";
+import { isPathExcluded } from "./_exclude.js";
+import { fixHardcodedSpacing } from "../codemods/tokens-spacing.js";
+import { adaptOldCodemodResult } from "./_codemod-adapter.js";
+import { createLyseRule } from "./_rule-module.js";
+const PX_REM_EM = /\b(\d+(\.\d+)?)(px|rem|em)\b/g;
+const ALLOW_PX_VALUES = new Set(["0", "1", "100"]);
+const ALLOW_KEYWORDS = new Set(["auto", "100%", "100vh", "100vw", "0"]);
+// ---------------------------------------------------------------------------
+// Tailwind spacing scale — standard Tailwind v3/v4 spacing values.
+// Static list; no eval risk.
+// ---------------------------------------------------------------------------
+// Standard numeric scale (including 0.5 / 1.5 etc. represented as "0\.5")
+const TW_SPACING_SCALE_NUMS = [
+    "0", "0\\.5", "1", "1\\.5", "2", "2\\.5", "3", "3\\.5",
+    "4", "5", "6", "7", "8", "9", "10", "11", "12", "14",
+    "16", "20", "24", "28", "32", "36", "40", "44", "48",
+    "52", "56", "60", "64", "72", "80", "96",
+];
+const TW_SPACING_KEYWORDS = ["px", "full", "screen", "auto", "svh", "dvh", "lvh"];
+const TW_SPACING_VALUES = `(?:${TW_SPACING_SCALE_NUMS.join("|")}|${TW_SPACING_KEYWORDS.join("|")})`;
+// Spacing utility prefixes:
+//   p, px, py, pt, pr, pb, pl  — padding
+//   m, mx, my, mt, mr, mb, ml  — margin
+//   gap, gap-x, gap-y
+//   space-x, space-y
+//   w, h, min-w, min-h, max-w, max-h
+//   inset, inset-x, inset-y, top, right, bottom, left
+const TW_SPACING_PREFIXES = "p[xytblr]?|m[xytblr]?|gap(?:-[xy])?|space-[xy]|w|h|min-[wh]|max-[wh]|inset(?:-[xy])?|top|right|bottom|left|size";
+const TW_SPACING_UTILITY_RE = new RegExp(`\\b(?:${TW_SPACING_PREFIXES})-${TW_SPACING_VALUES}\\b`, "g");
+/**
+ * Counts compliant Tailwind spacing utility usages in TSX/JSX/TS/JS files.
+ * p-4, m-2, gap-8, space-x-4, w-full, h-screen, etc.
+ * These are on-scale token usages encoded as class names.
+ */
+export function countCompliantSpacingUses(source, fileExt) {
+    if (fileExt !== ".ts" && fileExt !== ".tsx" && fileExt !== ".jsx" && fileExt !== ".js") {
+        return 0;
+    }
+    TW_SPACING_UTILITY_RE.lastIndex = 0;
+    const matches = source.match(TW_SPACING_UTILITY_RE);
+    return matches ? matches.length : 0;
+}
+function locationFromIndex(source, index) {
+    let line = 1, column = 1;
+    for (let i = 0; i < index && i < source.length; i++) {
+        if (source.charCodeAt(i) === 10) {
+            line++;
+            column = 1;
+        }
+        else {
+            column++;
+        }
+    }
+    return { line, column };
+}
+function isOnScale(ctx, value) {
+    if (!ctx.tokens)
+        return false;
+    return ctx.tokens.spacing.has(String(value));
+}
+function suggestSpacing(ctx, raw) {
+    if (!ctx.tokens)
+        return undefined;
+    const m = raw.match(/^(\d+(\.\d+)?)(px|rem|em)$/);
+    if (!m)
+        return undefined;
+    const candidates = ctx.tokens.spacing.get(m[1]);
+    if (!candidates || candidates.length === 0)
+        return undefined;
+    return candidates.length === 1 ? `consider token ${candidates[0]}` : `candidate tokens: ${candidates.join(", ")}`;
+}
+const evaluate = async (ctx, files) => {
+    const findings = [];
+    let opportunities = 0;
+    const scan = (path, source, blockLine = 0) => {
+        PX_REM_EM.lastIndex = 0;
+        let m;
+        while ((m = PX_REM_EM.exec(source)) !== null) {
+            const raw = m[0];
+            const num = m[1];
+            const unit = m[3];
+            opportunities++;
+            if (unit === "px" && ALLOW_PX_VALUES.has(num))
+                continue;
+            if (isOnScale(ctx, parseFloat(num)))
+                continue;
+            // Skip px/rem/em values inside JSX attributes that carry media-query
+            // breakpoints (sizes, srcSet, media). These are responsive image
+            // markup — not spacing tokens. NOTE: sizes={"..."} (JSX expression
+            // form) is NOT handled here; requires AST traversal — deferred to V1.
+            if (isInsideSkippedJsxAttr(source, m.index))
+                continue;
+            // Skip values inside same-line <code>...</code> or <pre>...</pre>
+            // blocks (display-only examples). Multi-line blocks are V1 work.
+            if (isInsideCodeDisplay(source, m.index))
+                continue;
+            if (isCssCustomPropertyDeclaration(source, m.index))
+                continue;
+            const loc = blockLine > 0 ? { line: blockLine, column: 1 } : locationFromIndex(source, m.index);
+            const suggestion = suggestSpacing(ctx, raw);
+            findings.push({
+                ruleId: "tokens/no-hardcoded-spacing",
+                axis: "tokens",
+                severity: "warning",
+                location: { file: path, line: loc.line, column: loc.column },
+                message: `Off-scale spacing: ${raw}`,
+                ...(suggestion !== undefined && { suggestion }),
+            });
+        }
+    };
+    for (const f of files.ts) {
+        if (isPathExcluded(f.path, ctx.excludePaths))
+            continue;
+        scan(f.path, f.source);
+        // Also count Tailwind spacing utility classes as compliant opportunities
+        const fileExt = f.path.match(/\.[^.]+$/)?.[0] ?? ".ts";
+        opportunities += countCompliantSpacingUses(f.source, fileExt);
+    }
+    for (const c of files.css) {
+        if (!isPathExcluded(c.path, ctx.excludePaths))
+            scan(c.path, c.source);
+    }
+    for (const b of files.cssInJs) {
+        if (!isPathExcluded(b.path, ctx.excludePaths))
+            scan(b.path, b.content, b.line);
+    }
+    return { findings, opportunities };
+};
+const classifyConfidence = (finding, ctx) => {
+    // Extract spacing value from message — format: "Off-scale spacing: 16px"
+    const rawMatch = finding.message.match(/:\s*(.+)$/);
+    const raw = rawMatch?.[1]?.trim() ?? "";
+    // Negative spacing is unusual — may be intentional, flag for human review
+    const isNegative = /^-\d/.test(raw) || (finding.context !== undefined && /-\d+px/.test(finding.context));
+    if (isNegative)
+        return "medium";
+    const numMatch = raw.match(/^(\d+(\.\d+)?)(px|rem|em)$/);
+    if (!numMatch)
+        return "low";
+    const numericValue = numMatch[1];
+    const candidates = ctx.tokens.spacing.get(numericValue);
+    if (!candidates || candidates.length === 0)
+        return "low";
+    // Multiple matches require human choice
+    if (candidates.length > 1)
+        return "medium";
+    return "high";
+};
+const applyCodemod = (finding, ctx) => {
+    const ruleCtx = {
+        repoRoot: "",
+        tokens: ctx.tokens,
+        componentsModule: ctx.config.designSystem?.componentsModule ?? null,
+        componentInventory: [],
+        storyIndex: null,
+        excludePaths: [],
+    };
+    const oldResult = fixHardcodedSpacing({
+        source: ctx.fileContent,
+        path: finding.location.file,
+        finding,
+        ctx: ruleCtx,
+    });
+    return adaptOldCodemodResult(oldResult);
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "tokens",
+        lyseRuleId: "tokens/no-hardcoded-spacing",
+        defaultSeverity: "warning",
+        shortDescription: "Disallow off-scale spacing values",
+        fullDescription: "Padding, margin, gap, and similar properties using raw px/rem/em values outside the documented spacing scale (Tailwind config, DTCG dimension tokens, or CSS variables) produce inconsistent rhythm and break theming.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/tokens-no-hardcoded-spacing.md",
+        rationale: `Why it matters
+
+The spacing scale encodes the rhythm of the product. A one-off \`padding: 7px\` survives every design-pass and slowly desynchronizes layouts. When the rule fires, the suggestion includes the matching scale step when the value maps to exactly one token.
+
+The allowlist accommodates 1px borders (\`border: 1px solid\`), zero, and full-viewport keywords — these are not design-system tokens but pragmatic primitives.`,
+        examples: [
+            { good: '<div className="p-2">', bad: '<div style={{ padding: "7px" }}>' },
+            { good: "gap: var(--spacing-4);", bad: "gap: 13px;" },
+        ],
+        allowlist: ["0", "auto", "100%", "100vh", "100vw"],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+    classifyConfidence,
+    applyCodemod,
+});
+// silence "unused" — keyword detection is for future expansion.
+void ALLOW_KEYWORDS;
+//# sourceMappingURL=tokens-no-hardcoded-spacing.js.map