@lyse-labs/lyse 0.1.0-alpha.2

package/dist/rules/templates/naming-convention.js

@@ -0,0 +1,76 @@
+// packages/core/src/rules/templates/naming-convention.ts
+import { z } from 'zod';
+import { basename } from 'node:path';
+const ConfigSchema = z.object({
+    target: z.enum(['file', 'export']),
+    pattern: z.string(),
+    exceptions: z.array(z.string()).default([]),
+});
+export const namingConventionTemplate = {
+    name: 'naming-convention',
+    description: 'Flags file names or exported symbols that do not match a regex pattern.',
+    configSchema: ConfigSchema,
+    build({ ruleId, axis, severity, config }) {
+        const cfg = ConfigSchema.parse(config);
+        const id = ruleId;
+        // 'off' is not a runtime severity; fall back to 'info' if provided.
+        const sev = (severity === 'off' ? 'info' : severity);
+        const re = new RegExp(cfg.pattern);
+        const exceptionSet = new Set(cfg.exceptions);
+        const rule = {
+            id,
+            axis,
+            async evaluate(_ctx, parsed) {
+                const findings = [];
+                let opportunities = 0;
+                if (cfg.target === 'file') {
+                    for (const file of parsed.ts) {
+                        const name = basename(file.path);
+                        if (!name.endsWith('.tsx'))
+                            continue;
+                        opportunities++;
+                        if (exceptionSet.has(name))
+                            continue;
+                        if (re.test(name))
+                            continue;
+                        findings.push({
+                            ruleId: id,
+                            axis,
+                            severity: sev,
+                            location: { file: file.path, line: 1, column: 1 },
+                            message: `File "${name}" does not match naming pattern ${cfg.pattern}`,
+                        });
+                    }
+                }
+                else {
+                    // target === 'export'
+                    const exportRe = /export\s+(?:const|function|class)\s+(\w+)/g;
+                    for (const file of parsed.ts) {
+                        exportRe.lastIndex = 0;
+                        let m;
+                        while ((m = exportRe.exec(file.source)) !== null) {
+                            opportunities++;
+                            const name = m[1];
+                            if (exceptionSet.has(name))
+                                continue;
+                            if (re.test(name))
+                                continue;
+                            const before = file.source.slice(0, m.index);
+                            const line = before.split('\n').length;
+                            findings.push({
+                                ruleId: id,
+                                axis,
+                                severity: sev,
+                                location: { file: file.path, line, column: 1 },
+                                message: `Export "${name}" does not match naming pattern ${cfg.pattern}`,
+                            });
+                        }
+                    }
+                }
+                return { findings, opportunities };
+            },
+        };
+        return rule;
+    },
+};
+//# sourceMappingURL=naming-convention.js.map

package/dist/rules/templates/naming-convention.js.map

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

package/dist/rules/templates/registry.d.ts

@@ -0,0 +1,5 @@
+import type { RuleTemplate } from './types.js';
+export declare const TEMPLATE_CATALOG_VERSION = 1;
+export declare function getTemplate(name: string): RuleTemplate | undefined;
+export declare function listTemplates(): ReadonlyArray<RuleTemplate>;
+export declare function templateCatalogDescriptions(): string;

package/dist/rules/templates/registry.js

@@ -0,0 +1,30 @@
+import { jsPropTokenComplianceTemplate } from './js-prop-token-compliance.js';
+import { jsCallTokenComplianceTemplate } from './js-call-token-compliance.js';
+import { cssPropertyTokenComplianceTemplate } from './css-property-token-compliance.js';
+import { tailwindUtilityClassComplianceTemplate } from './tailwind-utility-class-compliance.js';
+import { importSourceRestrictionTemplate } from './import-source-restriction.js';
+import { namingConventionTemplate } from './naming-convention.js';
+import { storybookCoverageTemplate } from './storybook-coverage-template.js';
+import { a11yJsxTemplate } from './a11y-jsx-template.js';
+export const TEMPLATE_CATALOG_VERSION = 1;
+const TEMPLATES = [
+    jsPropTokenComplianceTemplate,
+    jsCallTokenComplianceTemplate,
+    cssPropertyTokenComplianceTemplate,
+    tailwindUtilityClassComplianceTemplate,
+    importSourceRestrictionTemplate,
+    namingConventionTemplate,
+    storybookCoverageTemplate,
+    a11yJsxTemplate,
+];
+const BY_NAME = new Map(TEMPLATES.map((t) => [t.name, t]));
+export function getTemplate(name) {
+    return BY_NAME.get(name);
+}
+export function listTemplates() {
+    return TEMPLATES;
+}
+export function templateCatalogDescriptions() {
+    return TEMPLATES.map((t) => `- ${t.name}: ${t.description}`).join('\n');
+}
+//# sourceMappingURL=registry.js.map

package/dist/rules/templates/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/rules/templates/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,kCAAkC,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,sCAAsC,EAAE,MAAM,wCAAwC,CAAC;AAChG,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C,MAAM,SAAS,GAAgC;IAC7C,6BAA6C;IAC7C,6BAA6C;IAC7C,kCAAkD;IAClD,sCAAsD;IACtD,+BAA+C;IAC/C,wBAAwC;IACxC,yBAAyC;IACzC,eAA+B;CAChC,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAuB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/dist/rules/templates/storybook-coverage-template.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { RuleTemplate } from './types.js';
+declare const ConfigSchema: z.ZodObject<{
+    component_glob: z.ZodString;
+    story_glob_template: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    component_glob: string;
+    story_glob_template: string;
+}, {
+    component_glob: string;
+    story_glob_template: string;
+}>;
+type Config = z.infer<typeof ConfigSchema>;
+export declare const storybookCoverageTemplate: RuleTemplate<Config>;
+export {};

package/dist/rules/templates/storybook-coverage-template.js

@@ -0,0 +1,58 @@
+// packages/core/src/rules/templates/storybook-coverage-template.ts
+import { z } from 'zod';
+import { basename, dirname } from 'node:path';
+const ConfigSchema = z.object({
+    component_glob: z.string(),
+    story_glob_template: z.string(), // e.g., "{stem}.stories.tsx"
+});
+export const storybookCoverageTemplate = {
+    name: 'storybook-coverage-template',
+    description: 'Flags components without a corresponding stories file based on a path template.',
+    configSchema: ConfigSchema,
+    build({ ruleId, axis, severity, config }) {
+        const cfg = ConfigSchema.parse(config);
+        const id = ruleId;
+        // 'off' is not a runtime severity; fall back to 'info' if provided.
+        const sev = (severity === 'off' ? 'info' : severity);
+        const componentRe = globToRegExp(cfg.component_glob);
+        const isStoryFile = (p) => /\.stories\.(tsx?|jsx?)$/.test(p);
+        const rule = {
+            id,
+            axis,
+            async evaluate(_ctx, parsed) {
+                const allPaths = new Set(parsed.ts.map((f) => f.path));
+                const findings = [];
+                let opportunities = 0;
+                for (const file of parsed.ts) {
+                    if (!componentRe.test(file.path))
+                        continue;
+                    if (isStoryFile(file.path))
+                        continue;
+                    opportunities++;
+                    const name = basename(file.path);
+                    const stem = name.replace(/\.tsx?$/, '');
+                    const expectedStory = dirname(file.path) + '/' + cfg.story_glob_template.replace('{stem}', stem);
+                    if (allPaths.has(expectedStory))
+                        continue;
+                    findings.push({
+                        ruleId: id,
+                        axis,
+                        severity: sev,
+                        location: { file: file.path, line: 1, column: 1 },
+                        message: `Missing story file: expected ${expectedStory}`,
+                    });
+                }
+                return { findings, opportunities };
+            },
+        };
+        return rule;
+    },
+};
+function globToRegExp(glob) {
+    const escaped = glob
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*\*/g, '.+')
+        .replace(/\*/g, '[^/]+');
+    return new RegExp('^' + escaped + '$');
+}
+//# sourceMappingURL=storybook-coverage-template.js.map

package/dist/rules/templates/storybook-coverage-template.js.map

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

package/dist/rules/templates/tailwind-utility-class-compliance.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { RuleTemplate } from './types.js';
+declare const ConfigSchema: z.ZodObject<{
+    class_prefixes: z.ZodArray<z.ZodString, "many">;
+    allow_arbitrary_for: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    class_prefixes: string[];
+    allow_arbitrary_for: string[];
+}, {
+    class_prefixes: string[];
+    allow_arbitrary_for?: string[] | undefined;
+}>;
+type Config = z.infer<typeof ConfigSchema>;
+export declare const tailwindUtilityClassComplianceTemplate: RuleTemplate<Config>;
+export {};

package/dist/rules/templates/tailwind-utility-class-compliance.js

@@ -0,0 +1,70 @@
+// packages/core/src/rules/templates/tailwind-utility-class-compliance.ts
+import { z } from 'zod';
+import { escapeRegExp } from './_regex-utils.js';
+const ConfigSchema = z.object({
+    class_prefixes: z.array(z.string()),
+    allow_arbitrary_for: z.array(z.string()).default([]),
+});
+export const tailwindUtilityClassComplianceTemplate = {
+    name: 'tailwind-utility-class-compliance',
+    description: 'Flags Tailwind utility classes with arbitrary values (e.g. bg-[#1e293b]) for the specified prefixes. ' +
+        'These bypass the configured scale.',
+    configSchema: ConfigSchema,
+    build({ ruleId, axis, severity, config }) {
+        const cfg = ConfigSchema.parse(config);
+        const id = ruleId;
+        // 'off' is not a runtime severity; fall back to 'info' if provided.
+        const sev = (severity === 'off' ? 'info' : severity);
+        const allowedSet = new Set(cfg.allow_arbitrary_for);
+        const prefixGroup = cfg.class_prefixes.map(escapeRegExp).join('|');
+        // Build regexes once at rule-construction time; not inside evaluate().
+        // Regex to detect prefix-[value] patterns (e.g. bg-[#1e293b], text-[1rem])
+        const arbitraryRe = new RegExp(`^(?:${prefixGroup})(?:-[a-z0-9]+)*-\\[`);
+        // Regex to check if class starts with any watched prefix
+        const prefixRe = new RegExp(`^(?:${prefixGroup})(?:-|$)`);
+        // Match className="..." or className={`...`} — capture the value
+        const classNameRe = /\bclassName\s*=\s*["'`]([^"'`]+)["'`]/g;
+        const rule = {
+            id,
+            axis,
+            async evaluate(_ctx, parsed) {
+                const findings = [];
+                let opportunities = 0;
+                for (const file of parsed.ts) {
+                    classNameRe.lastIndex = 0;
+                    let cm;
+                    while ((cm = classNameRe.exec(file.source)) !== null) {
+                        const classes = cm[1].split(/\s+/);
+                        for (const cls of classes) {
+                            if (!prefixRe.test(cls))
+                                continue;
+                            opportunities++;
+                            if (!cls.includes('['))
+                                continue;
+                            // Check if this prefix is explicitly allowed for arbitrary values
+                            const prefix = cls.split('-')[0];
+                            if (allowedSet.has(prefix))
+                                continue;
+                            if (!arbitraryRe.test(cls))
+                                continue;
+                            const classIndex = cm.index + cm[0].indexOf(cls);
+                            const before = file.source.slice(0, classIndex);
+                            const line = before.split('\n').length;
+                            const column = classIndex - before.lastIndexOf('\n');
+                            findings.push({
+                                ruleId: id,
+                                axis,
+                                severity: sev,
+                                location: { file: file.path, line, column },
+                                message: `Arbitrary Tailwind value "${cls}" bypasses the configured scale`,
+                            });
+                        }
+                    }
+                }
+                return { findings, opportunities };
+            },
+        };
+        return rule;
+    },
+};
+//# sourceMappingURL=tailwind-utility-class-compliance.js.map

package/dist/rules/templates/tailwind-utility-class-compliance.js.map

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

package/dist/rules/templates/types.d.ts

@@ -0,0 +1,16 @@
+import type { Rule } from '../../types.js';
+export interface RuleTemplate<TConfig = Record<string, unknown>> {
+    /** Template name as referenced in `.lyse/generated-rules.yaml`. */
+    readonly name: string;
+    /** One-line description shown to the LLM in the catalog. */
+    readonly description: string;
+    /** Zod schema (as a function returning z.ZodTypeAny). */
+    readonly configSchema: unknown;
+    /** Build a runnable Rule from a config + a generated rule id + axis + severity. */
+    build(args: {
+        ruleId: string;
+        axis: Rule['axis'];
+        severity: 'error' | 'warning' | 'info' | 'off';
+        config: TConfig;
+    }): Rule;
+}

package/dist/rules/templates/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rules/templates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rules/templates/types.ts"],"names":[],"mappings":""}

package/dist/rules/tokens-description-coverage.d.ts

@@ -0,0 +1,15 @@
+import type { Rule } from "../types.js";
+import { type DtcgDocument } from "../tokens/dtcg-model.js";
+export declare function isSemanticTokenPath(path: string[]): boolean;
+interface CoverageStats {
+    semanticCount: number;
+    semanticWithDescription: number;
+}
+declare function walkForCoverage(doc: DtcgDocument): CoverageStats;
+export declare const rule: Rule;
+export declare const _internal: {
+    walkForCoverage: typeof walkForCoverage;
+    isSemanticTokenPath: typeof isSemanticTokenPath;
+    COVERAGE_THRESHOLD: number;
+};
+export {};

package/dist/rules/tokens-description-coverage.js

@@ -0,0 +1,193 @@
+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 { isDtcgGroup, isDtcgToken, } from "../tokens/dtcg-model.js";
+const MAX_FILE_BYTES = 1_000_000;
+const RULE_ID = "tokens/description-coverage";
+const COVERAGE_THRESHOLD = 0.8; // 80 %
+const SEMANTIC_PATH_SEGMENTS = new Set([
+    "action",
+    "surface",
+    "text",
+    "background",
+    "border",
+    "feedback",
+    "state",
+    "interactive",
+    "link",
+    "semantic",
+]);
+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 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;
+}
+function looksLikeDtcg(data) {
+    if (typeof data !== "object" || data === null || Array.isArray(data))
+        return false;
+    return hasAnyValueKey(data, 4);
+}
+export function isSemanticTokenPath(path) {
+    if (path.length === 0)
+        return false;
+    // A path is semantic if any segment matches a known semantic prefix.
+    for (const seg of path) {
+        if (SEMANTIC_PATH_SEGMENTS.has(seg))
+            return true;
+    }
+    // brand.semantic.* — the "semantic" segment already matches above. Top-level
+    // primitives like color.blue.500 / spacing.16 / radius.md are intentionally
+    // excluded because none of their segments are in the semantic set.
+    return false;
+}
+function walkForCoverage(doc) {
+    const stats = { semanticCount: 0, semanticWithDescription: 0 };
+    const visit = (node, path) => {
+        if (typeof node !== "object" || node === null || Array.isArray(node))
+            return;
+        if (isDtcgToken(node)) {
+            if (isSemanticTokenPath(path)) {
+                stats.semanticCount++;
+                const desc = node.$description;
+                if (typeof desc === "string" && desc.trim().length > 0) {
+                    stats.semanticWithDescription++;
+                }
+            }
+            return;
+        }
+        if (!isDtcgGroup(node))
+            return;
+        for (const [k, v] of Object.entries(node)) {
+            if (k.startsWith("$"))
+                continue;
+            visit(v, [...path, k]);
+        }
+    };
+    visit(doc, []);
+    return stats;
+}
+const evaluate = async (ctx, _files) => {
+    const findings = [];
+    const relFiles = discoverDtcgFiles(ctx);
+    if (relFiles.length === 0) {
+        return { findings, opportunities: 0 };
+    }
+    let totalSemantic = 0;
+    let totalDescribed = 0;
+    let primaryFile = null;
+    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;
+        if (primaryFile === null)
+            primaryFile = relative(ctx.repoRoot, abs) || rel;
+        const stats = walkForCoverage(data);
+        totalSemantic += stats.semanticCount;
+        totalDescribed += stats.semanticWithDescription;
+    }
+    // No semantic tokens found — N/A
+    if (totalSemantic === 0) {
+        return { findings, opportunities: 0 };
+    }
+    const coverage = totalDescribed / totalSemantic;
+    if (coverage < COVERAGE_THRESHOLD) {
+        const pct = (coverage * 100).toFixed(coverage * 100 < 1 ? 0 : 1).replace(/\.0$/, "");
+        findings.push({
+            ruleId: RULE_ID,
+            axis: "tokens",
+            severity: "info",
+            location: { file: primaryFile ?? "lyse.tokens.json", line: 1, column: 1 },
+            message: `Semantic-layer $description coverage is ${pct}% (${totalDescribed}/${totalSemantic}); target is 80%`,
+            suggestion: "add $description to semantic tokens (action.*, surface.*, text.*, feedback.*, etc.)",
+        });
+    }
+    return { findings, opportunities: totalSemantic };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "tokens",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "info",
+        shortDescription: "Semantic tokens should declare a $description",
+        fullDescription: "Measures the fraction of semantic-layer tokens (`action.*`, `surface.*`, `text.*`, `background.*`, `border.*`, `feedback.*`, `state.*`, `interactive.*`, `link.*`, or any token under a `semantic` group) that declare a non-empty `$description`. Emits a single summary finding when coverage falls below 80%.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/tokens-description-coverage.md",
+        rationale: `Why it matters
+
+Semantic tokens are the contract surface between design and code. Their primitive counterparts (\`color.blue.500\`, \`spacing.16\`) are self-explanatory — a number or a hex. But \`action.primary\` only makes sense if the token explains *what* it's for: "the default action color for primary buttons, brand surfaces, and emphasized text".
+
+Undocumented semantic tokens cause AI agents and humans alike to pick the wrong token. \`$description\` is the cheapest documentation surface in a DS — and the one most often skipped.
+
+The rule is intentionally informational (severity: info) and computes coverage on the semantic layer only. Primitive tokens are excluded from the denominator.`,
+        examples: [
+            {
+                good: '{ "action": { "primary": { "$value": "{color.brand.500}", "$type": "color", "$description": "Default action color for primary CTAs and emphasized text" } } }',
+                bad: '{ "action": { "primary": { "$value": "{color.brand.500}", "$type": "color" } } }',
+            },
+        ],
+        allowlist: [
+            "primitive tokens — `color.blue.500`, `spacing.16`, `radius.md` — excluded from the denominator",
+            "repos with no DTCG file — rule is N/A (opportunities = 0)",
+        ],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+});
+export const _internal = {
+    walkForCoverage,
+    isSemanticTokenPath,
+    COVERAGE_THRESHOLD,
+};
+//# sourceMappingURL=tokens-description-coverage.js.map

package/dist/rules/tokens-description-coverage.js.map

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

package/dist/rules/tokens-dtcg-conformance.d.ts

@@ -0,0 +1,47 @@
+import type { Rule, RuleContext } from "../types.js";
+import { type DtcgDocument, type DtcgType } from "../tokens/dtcg-model.js";
+/**
+ * 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.
+ */
+declare function discoverDtcgFiles(ctx: RuleContext): string[];
+declare function looksLikeDtcg(data: unknown): boolean;
+/**
+ * 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.
+ */
+declare function inferTypeFromValue(value: unknown): DtcgType | null;
+interface WalkOutcome {
+    tokenCount: number;
+    inheritedTypeConflicts: {
+        path: string;
+        groupType: DtcgType;
+        tokenType: DtcgType;
+    }[];
+    brokenAliases: {
+        path: string;
+        alias: string;
+    }[];
+    missingInferableTypes: {
+        path: string;
+        inferred: DtcgType;
+    }[];
+    shapeIssues: {
+        path: string;
+        reason: string;
+    }[];
+}
+declare function walkDocument(doc: DtcgDocument): WalkOutcome;
+export declare const rule: Rule;
+export declare const _internal: {
+    discoverDtcgFiles: typeof discoverDtcgFiles;
+    walkDocument: typeof walkDocument;
+    looksLikeDtcg: typeof looksLikeDtcg;
+    inferTypeFromValue: typeof inferTypeFromValue;
+};
+export {};