@lyse-labs/lyse 0.1.0-alpha.2

package/dist/rules/tokens-dtcg-conformance.js

@@ -0,0 +1,363 @@
+import { readFileSync, statSync } from "node:fs";
+import { isAbsolute, join, relative } from "node:path";
+import fg from "fast-glob";
+import { isPathExcluded } from "./_exclude.js";
+import { createLyseRule } from "./_rule-module.js";
+import { isDtcgAlias, isDtcgGroup, isDtcgToken, parseAliasPath, } from "../tokens/dtcg-model.js";
+import { normalizeToDtcg } from "../tokens/normalizer.js";
+const MAX_FILE_BYTES = 1_000_000;
+const RULE_ID = "tokens/dtcg-conformance";
+/**
+ * Discovers DTCG-shaped JSON files under the repo:
+ *   - `**\/*.tokens.json`
+ *   - `tokens/**\/*.json`
+ *   - any `*.json` whose top-level value contains a `$value` somewhere (heuristic)
+ *
+ * Files larger than 1 MB are skipped to avoid pathological cases. Files
+ * matched by `ctx.excludePaths` are skipped.
+ */
+function discoverDtcgFiles(ctx) {
+    if (!ctx.repoRoot)
+        return [];
+    let entries = [];
+    try {
+        entries = fg.sync(["**/*.tokens.json", "tokens/**/*.json", "**/tokens/**/*.json"], {
+            cwd: ctx.repoRoot,
+            absolute: false,
+            dot: false,
+            ignore: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**"],
+            followSymbolicLinks: false,
+        });
+    }
+    catch {
+        return [];
+    }
+    const out = new Set();
+    for (const rel of entries) {
+        if (isPathExcluded(rel, ctx.excludePaths))
+            continue;
+        out.add(rel);
+    }
+    return Array.from(out).sort();
+}
+function readJsonIfSmall(absPath) {
+    try {
+        const stat = statSync(absPath);
+        if (!stat.isFile())
+            return null;
+        if (stat.size > MAX_FILE_BYTES)
+            return null;
+        const raw = readFileSync(absPath, "utf8");
+        if (raw.trim().length === 0)
+            return null;
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function looksLikeDtcg(data) {
+    if (typeof data !== "object" || data === null || Array.isArray(data))
+        return false;
+    return hasAnyValueKey(data, 4);
+}
+function hasAnyValueKey(node, depthBudget) {
+    if (depthBudget < 0)
+        return false;
+    if (typeof node !== "object" || node === null || Array.isArray(node))
+        return false;
+    for (const [k, v] of Object.entries(node)) {
+        if (k === "$value")
+            return true;
+        if (typeof v === "object" && v !== null && hasAnyValueKey(v, depthBudget - 1))
+            return true;
+    }
+    return false;
+}
+/**
+ * Heuristic that infers a likely `$type` from a token's value, used to flag
+ * tokens that have `$value` but no `$type` when one is clearly inferable.
+ */
+function inferTypeFromValue(value) {
+    if (typeof value === "string") {
+        const v = value.trim();
+        if (isDtcgAlias(v))
+            return null;
+        if (/^#[0-9a-f]{3,8}$/i.test(v))
+            return "color";
+        if (/^(rgb|rgba|hsl|hsla|oklch|oklab|color|lab|lch)\s*\(/i.test(v))
+            return "color";
+        if (/^-?\d+(\.\d+)?(px|rem|em|%|vh|vw|ch|ex|pt|pc|cm|mm|in)$/i.test(v))
+            return "dimension";
+        if (/^-?\d+(\.\d+)?(ms|s)$/i.test(v))
+            return "duration";
+        if (/^cubic-bezier\s*\(/i.test(v))
+            return "cubicBezier";
+        return null;
+    }
+    if (typeof value === "number")
+        return "number";
+    if (Array.isArray(value)) {
+        if (value.length === 4 && value.every((n) => typeof n === "number"))
+            return "cubicBezier";
+    }
+    if (typeof value === "object" && value !== null) {
+        const obj = value;
+        if ("offsetX" in obj && "offsetY" in obj && "blur" in obj && "color" in obj)
+            return "shadow";
+        if (("fontFamily" in obj || "fontSize" in obj || "fontWeight" in obj || "lineHeight" in obj) && !("offsetX" in obj)) {
+            return "typography";
+        }
+        if ("color" in obj && "width" in obj && "style" in obj)
+            return "border";
+    }
+    return null;
+}
+function validateShadowValue(value) {
+    if (isDtcgAlias(value))
+        return { ok: true };
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { ok: false, reason: "shadow $value must be an object (or array of objects) with offsetX/offsetY/blur/color" };
+    }
+    const obj = value;
+    for (const field of ["offsetX", "offsetY", "blur", "color"]) {
+        if (!(field in obj))
+            return { ok: false, reason: `shadow $value missing required field "${field}"` };
+    }
+    return { ok: true };
+}
+function validateTypographyValue(value) {
+    if (isDtcgAlias(value))
+        return { ok: true };
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { ok: false, reason: "typography $value must be an object with at least one of fontFamily/fontSize/fontWeight/lineHeight/letterSpacing" };
+    }
+    const obj = value;
+    const known = ["fontFamily", "fontSize", "fontWeight", "lineHeight", "letterSpacing"];
+    if (!known.some((k) => k in obj)) {
+        return { ok: false, reason: "typography $value has no recognized typography field" };
+    }
+    return { ok: true };
+}
+function validateBorderValue(value) {
+    if (isDtcgAlias(value))
+        return { ok: true };
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { ok: false, reason: "border $value must be an object with color/width/style" };
+    }
+    const obj = value;
+    for (const field of ["color", "width", "style"]) {
+        if (!(field in obj))
+            return { ok: false, reason: `border $value missing required field "${field}"` };
+    }
+    return { ok: true };
+}
+function aliasResolves(doc, alias) {
+    const segments = parseAliasPath(alias);
+    if (segments.length === 0)
+        return false;
+    let cur = doc;
+    for (const seg of segments) {
+        if (typeof cur !== "object" || cur === null)
+            return false;
+        cur = cur[seg];
+        if (cur === undefined)
+            return false;
+    }
+    return isDtcgToken(cur) || isDtcgGroup(cur);
+}
+function walkDocument(doc) {
+    const result = {
+        tokenCount: 0,
+        inheritedTypeConflicts: [],
+        brokenAliases: [],
+        missingInferableTypes: [],
+        shapeIssues: [],
+    };
+    const visit = (node, path, inheritedType) => {
+        if (typeof node !== "object" || node === null || Array.isArray(node))
+            return;
+        if (isDtcgToken(node)) {
+            result.tokenCount++;
+            const token = node;
+            const value = token.$value;
+            const effectiveType = token.$type ?? inheritedType;
+            if (token.$type !== undefined && inheritedType !== undefined && token.$type !== inheritedType) {
+                // Note: child overriding parent is allowed per DTCG; not flagged here.
+            }
+            if (token.$type === undefined) {
+                const inferred = inferTypeFromValue(value);
+                if (inferred && !isDtcgAlias(value)) {
+                    result.missingInferableTypes.push({ path: path.join("."), inferred });
+                }
+            }
+            if (isDtcgAlias(value)) {
+                // Alias is validated against the document root by the caller.
+                result.brokenAliases.push({ path: path.join("."), alias: value });
+            }
+            else {
+                if (effectiveType === "shadow") {
+                    const r = validateShadowValue(value);
+                    if (!r.ok && r.reason)
+                        result.shapeIssues.push({ path: path.join("."), reason: r.reason });
+                }
+                else if (effectiveType === "typography") {
+                    const r = validateTypographyValue(value);
+                    if (!r.ok && r.reason)
+                        result.shapeIssues.push({ path: path.join("."), reason: r.reason });
+                }
+                else if (effectiveType === "border") {
+                    const r = validateBorderValue(value);
+                    if (!r.ok && r.reason)
+                        result.shapeIssues.push({ path: path.join("."), reason: r.reason });
+                }
+            }
+            return;
+        }
+        if (!isDtcgGroup(node))
+            return;
+        const groupType = node.$type ?? inheritedType;
+        for (const [k, v] of Object.entries(node)) {
+            if (k.startsWith("$"))
+                continue;
+            const child = v;
+            const childPath = [...path, k];
+            // Group/token $type conflict: if a child group declares a different $type
+            // than its parent group's $type, flag (DTCG allows it but it's usually a bug).
+            if (isDtcgGroup(child) &&
+                child.$type !== undefined &&
+                inheritedType !== undefined &&
+                child.$type !== inheritedType) {
+                // Not a hard error — DTCG permits group-level $type overrides. Skip for now.
+            }
+            if (isDtcgToken(child) &&
+                groupType !== undefined &&
+                child.$type !== undefined &&
+                child.$type !== groupType) {
+                result.inheritedTypeConflicts.push({
+                    path: childPath.join("."),
+                    groupType,
+                    tokenType: child.$type,
+                });
+            }
+            visit(child, childPath, groupType);
+        }
+    };
+    visit(doc, [], undefined);
+    // Filter brokenAliases: remove ones that resolve.
+    result.brokenAliases = result.brokenAliases.filter((b) => !aliasResolves(doc, b.alias));
+    return result;
+}
+const evaluate = async (ctx, _files) => {
+    const findings = [];
+    let opportunities = 0;
+    const relFiles = discoverDtcgFiles(ctx);
+    for (const rel of relFiles) {
+        const abs = isAbsolute(rel) ? rel : join(ctx.repoRoot, rel);
+        const data = readJsonIfSmall(abs);
+        if (data === null)
+            continue;
+        if (!looksLikeDtcg(data))
+            continue;
+        const display = relative(ctx.repoRoot, abs) || rel;
+        const normalized = normalizeToDtcg({ source: "dtcg", data });
+        for (const w of normalized.warnings) {
+            // The normalizer also emits "token at X has no $type" — we re-emit
+            // those below with richer "inferred type" context, so suppress the
+            // normalizer's duplicate here.
+            if (w.startsWith("dtcg: token at") && w.includes("has no $type"))
+                continue;
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "tokens",
+                severity: "warning",
+                location: { file: display, line: 1, column: 1 },
+                message: `DTCG: ${w}`,
+            });
+        }
+        const walked = walkDocument(normalized.document);
+        opportunities += walked.tokenCount;
+        for (const m of walked.missingInferableTypes) {
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "tokens",
+                severity: "warning",
+                location: { file: display, line: 1, column: 1 },
+                message: `Token "${m.path}" has $value but no $type (value looks like ${m.inferred})`,
+                suggestion: `add "$type": "${m.inferred}"`,
+            });
+        }
+        for (const a of walked.brokenAliases) {
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "tokens",
+                severity: "warning",
+                location: { file: display, line: 1, column: 1 },
+                message: `Token "${a.path}" references unresolved alias ${a.alias}`,
+            });
+        }
+        for (const s of walked.shapeIssues) {
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "tokens",
+                severity: "warning",
+                location: { file: display, line: 1, column: 1 },
+                message: `Token "${s.path}": ${s.reason}`,
+            });
+        }
+        for (const c of walked.inheritedTypeConflicts) {
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "tokens",
+                severity: "warning",
+                location: { file: display, line: 1, column: 1 },
+                message: `Token "${c.path}" has $type "${c.tokenType}" but parent group declares $type "${c.groupType}"`,
+            });
+        }
+    }
+    return { findings, opportunities };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "tokens",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "warning",
+        shortDescription: "DTCG v2025.10 conformance for token JSON files",
+        fullDescription: "Validates token JSON files (`*.tokens.json`, files under `tokens/**`) against the W3C Design Tokens Community Group spec (DTCG v2025.10). Flags tokens missing `$type` when it can be inferred from the value, broken aliases (`{group.token}` references that don't resolve), and composite tokens (shadow, typography, border) with the wrong shape.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/tokens-dtcg-conformance.md",
+        rationale: `Why it matters
+
+DTCG conformance is the contract between design and code. Non-conformant token files don't survive round-trips through Style Dictionary, Tokens Studio, or Figma Tokens plugins — they silently corrupt theming and break dark-mode propagation.
+
+The most common drift modes are: tokens with \`$value\` but no \`$type\` (Style Dictionary can't infer the right transform), aliases that point to renamed paths after a refactor, and composite shadow tokens with legacy string shapes that no longer parse.`,
+        examples: [
+            {
+                good: '{ "color": { "brand": { "$value": "#2563eb", "$type": "color" } } }',
+                bad: '{ "color": { "brand": { "$value": "#2563eb" } } }',
+            },
+            {
+                good: '{ "shadow": { "sm": { "$type": "shadow", "$value": { "offsetX": "0", "offsetY": "1px", "blur": "2px", "color": "rgba(0,0,0,0.1)" } } } }',
+                bad: '{ "shadow": { "sm": { "$type": "shadow", "$value": "0 1px 2px rgba(0,0,0,0.1)" } } }',
+            },
+            {
+                good: '{ "semantic": { "primary": { "$value": "{color.brand}", "$type": "color" } } } (when color.brand exists)',
+                bad: '{ "semantic": { "primary": { "$value": "{color.brandd}", "$type": "color" } } } (typo, no such path)',
+            },
+        ],
+        allowlist: [
+            "files matching `*.tokens.json` heuristic but containing only $-prefixed metadata (no $value anywhere) — skipped, not flagged",
+            "files larger than 1 MB — skipped to avoid pathological cases",
+            "files matching `ctx.excludePaths` config",
+        ],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+});
+// Exported for unit tests
+export const _internal = {
+    discoverDtcgFiles,
+    walkDocument,
+    looksLikeDtcg,
+    inferTypeFromValue,
+};
+//# sourceMappingURL=tokens-dtcg-conformance.js.map

package/dist/rules/tokens-dtcg-conformance.js.map

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

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

@@ -0,0 +1,18 @@
+import type { Rule } from "../types.js";
+/**
+ * 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 declare function countCompliantColorUses(source: string, fileExt: string): number;
+export declare function detectInText(source: string, _path?: string): {
+    match: string;
+    index: number;
+}[];
+export declare const rule: Rule;