@breadstone-infrastructure/token-linter 0.0.231

package/rules/includes-consistency.rule.js

@@ -0,0 +1,153 @@
+// #region Imports
+import * as fs from 'fs';
+import { promptSelect, SKIP, SKIP_ALL } from '../core/interaction.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+import { groupByComponent } from '../utils.js';
+// #endregion
+/**
+ * @description Ensures $includes arrays are consistent across themes for the same component.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? $includes differs from 'memphis' for 'button': missing: [ripple]; extra: [shadow].
+ *   > Use memphis's includes: [focusRing, ripple]
+ *     Use cosmopolitan's includes: [focusRing, ripple]
+ *     Union all: [focusRing, ripple, shadow]
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export class IncludesConsistencyRule {
+    // #region Fields
+    name = 'includes-consistency';
+    description = 'Ensures $includes arrays are consistent across themes for the same component.';
+    defaultSeverity = RuleSeverity.Warning;
+    fixable = false;
+    interactive = true;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        const grouped = groupByComponent(context.entries);
+        for (const [component, entries] of grouped.entries()) {
+            const includesMap = new Map();
+            for (const entry of entries) {
+                const includes = entry.content['$includes'];
+                const normalized = Array.isArray(includes) ? includes : [];
+                includesMap.set(entry.theme, normalized);
+            }
+            const signatures = new Set(Array.from(includesMap.values()).map(arr => [...arr].sort().join(',')));
+            if (signatures.size <= 1) {
+                continue;
+            }
+            const referenceEntry = entries[0];
+            const referenceIncludes = includesMap.get(referenceEntry.theme) ?? [];
+            const referenceSet = new Set(referenceIncludes);
+            for (const entry of entries.slice(1)) {
+                const entryIncludes = includesMap.get(entry.theme) ?? [];
+                const entrySet = new Set(entryIncludes);
+                const missingInEntry = referenceIncludes.filter(i => !entrySet.has(i));
+                const extraInEntry = entryIncludes.filter(i => !referenceSet.has(i));
+                if (missingInEntry.length > 0 || extraInEntry.length > 0) {
+                    const parts = [];
+                    if (missingInEntry.length > 0) {
+                        parts.push(`missing: [${missingInEntry.join(', ')}]`);
+                    }
+                    if (extraInEntry.length > 0) {
+                        parts.push(`extra: [${extraInEntry.join(', ')}]`);
+                    }
+                    findings.push({
+                        component,
+                        theme: entry.theme,
+                        key: '$includes',
+                        message: `$includes differs from '${referenceEntry.theme}' for '${component}': ${parts.join('; ')}.`,
+                        severity: this.defaultSeverity,
+                        filePath: entry.filePath,
+                        fixed: false,
+                    });
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+    async interact(context, findings) {
+        const grouped = groupByComponent(context.entries);
+        const pendingWrites = new Map();
+        const result = [];
+        let skipAll = false;
+        for (const finding of findings) {
+            if (skipAll) {
+                result.push(finding);
+                continue;
+            }
+            const entries = grouped.get(finding.component);
+            if (!entries || !finding.filePath) {
+                result.push(finding);
+                continue;
+            }
+            const targetEntry = entries.find(e => e.theme === finding.theme);
+            if (!targetEntry) {
+                result.push(finding);
+                continue;
+            }
+            const otherEntries = entries.filter(e => e.theme !== finding.theme);
+            const choices = [];
+            for (const other of otherEntries) {
+                const includes = Array.isArray(other.content['$includes']) ? other.content['$includes'] : [];
+                choices.push({
+                    name: `use-${other.theme}`,
+                    message: `Use ${other.theme}'s includes: [${includes.join(', ')}]`,
+                });
+            }
+            const allIncludes = new Set();
+            for (const entry of entries) {
+                const includes = Array.isArray(entry.content['$includes']) ? entry.content['$includes'] : [];
+                for (const inc of includes) {
+                    allIncludes.add(inc);
+                }
+            }
+            choices.push({
+                name: 'union',
+                message: `Union all: [${[...allIncludes].sort().join(', ')}]`,
+            });
+            const action = await promptSelect(finding.message, choices);
+            if (action === SKIP_ALL) {
+                skipAll = true;
+                result.push(finding);
+                continue;
+            }
+            if (action === SKIP) {
+                result.push(finding);
+                continue;
+            }
+            let newIncludes;
+            if (action === 'union') {
+                newIncludes = [...allIncludes].sort();
+            }
+            else if (action.startsWith('use-')) {
+                const sourceTheme = action.substring(4);
+                const sourceEntry = entries.find(e => e.theme === sourceTheme);
+                if (sourceEntry) {
+                    newIncludes = Array.isArray(sourceEntry.content['$includes'])
+                        ? [...sourceEntry.content['$includes']]
+                        : [];
+                }
+            }
+            if (newIncludes !== undefined) {
+                targetEntry.content['$includes'] = newIncludes;
+                pendingWrites.set(targetEntry.filePath, targetEntry);
+                result.push({ ...finding, fixed: true });
+            }
+            else {
+                result.push(finding);
+            }
+        }
+        for (const entry of pendingWrites.values()) {
+            fs.writeFileSync(entry.filePath, JSON.stringify(entry.content, null, 2) + '\n', 'utf-8');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=includes-consistency.rule.js.map

package/rules/includes-consistency.rule.js.map

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

package/rules/index.d.ts

@@ -0,0 +1,7 @@
+import type { IRule } from '../core/rule.js';
+/**
+ * @description Creates and returns all built-in token linter rules.
+ * @public
+ */
+export declare function builtInRules(): IRule[];
+//# sourceMappingURL=index.d.ts.map

package/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAoB7C;;;GAGG;AACH,wBAAgB,YAAY,IAAI,KAAK,EAAE,CA0BtC"}

package/rules/index.js

@@ -0,0 +1,47 @@
+// #region Imports
+import { AlphabeticalSortRule } from './alphabetical-sort.rule.js';
+import { ComponentPresenceRule } from './component-presence.rule.js';
+import { DuplicateValueRule } from './duplicate-value.rule.js';
+import { EmptyJsonRule } from './empty-json.rule.js';
+import { ForbiddenKeyRule } from './forbidden-key.rule.js';
+import { ForbiddenValueRule } from './forbidden-value.rule.js';
+import { IncludesConsistencyRule } from './includes-consistency.rule.js';
+import { KeyConsistencyRule } from './key-consistency.rule.js';
+import { MissingIncludesRule } from './missing-includes.rule.js';
+import { MixinReferenceRule } from './mixin-reference.rule.js';
+import { NamingConventionRule } from './naming-convention.rule.js';
+import { NestedDepthRule } from './nested-depth.rule.js';
+import { RequiredIncludesRule } from './required-includes.rule.js';
+import { ValueConsistencyRule } from './value-consistency.rule.js';
+import { ValueSchemaRule } from './value-schema.rule.js';
+import { ValueTypeRule } from './value-type.rule.js';
+// #endregion
+/**
+ * @description Creates and returns all built-in token linter rules.
+ * @public
+ */
+export function builtInRules() {
+    return [
+        // Core structural rules
+        new ComponentPresenceRule(),
+        new KeyConsistencyRule(),
+        new IncludesConsistencyRule(),
+        new MissingIncludesRule(),
+        new RequiredIncludesRule(),
+        new EmptyJsonRule(),
+        // Quality rules
+        new ForbiddenValueRule(),
+        new ForbiddenKeyRule(),
+        new NamingConventionRule(),
+        new ValueSchemaRule(),
+        new ValueTypeRule(),
+        new ValueConsistencyRule(),
+        new DuplicateValueRule(),
+        // Structural depth
+        new NestedDepthRule(),
+        new MixinReferenceRule(),
+        // Formatting
+        new AlphabeticalSortRule(),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAGlB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,aAAa;AAEb;;;GAGG;AACH,MAAM,UAAU,YAAY;IACxB,OAAO;QACH,wBAAwB;QACxB,IAAI,qBAAqB,EAAE;QAC3B,IAAI,kBAAkB,EAAE;QACxB,IAAI,uBAAuB,EAAE;QAC7B,IAAI,mBAAmB,EAAE;QACzB,IAAI,oBAAoB,EAAE;QAC1B,IAAI,aAAa,EAAE;QAEnB,gBAAgB;QAChB,IAAI,kBAAkB,EAAE;QACxB,IAAI,gBAAgB,EAAE;QACtB,IAAI,oBAAoB,EAAE;QAC1B,IAAI,eAAe,EAAE;QACrB,IAAI,aAAa,EAAE;QACnB,IAAI,oBAAoB,EAAE;QAC1B,IAAI,kBAAkB,EAAE;QAExB,mBAAmB;QACnB,IAAI,eAAe,EAAE;QACrB,IAAI,kBAAkB,EAAE;QAExB,aAAa;QACb,IAAI,oBAAoB,EAAE;KAC7B,CAAC;AACN,CAAC"}

package/rules/key-consistency.rule.d.ts

@@ -0,0 +1,38 @@
+import type { IRule } from '../core/rule.js';
+import type { IRuleContext } from '../models/rule-context.js';
+import type { IRuleFinding } from '../models/rule-finding.js';
+import type { IRuleResult } from '../models/rule-result.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+/**
+ * @description Ensures all themes use the same set of keys for each component.
+ * Keys that are provided by `$includes` mixins are excluded from the consistency check.
+ * When auto-fix is enabled, missing keys are copied from the first theme that defines them,
+ * with theme-specific CSS variable prefixes automatically replaced.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Key 'borderRadius' is missing in component 'button' for theme 'joy'.
+ *   > Copy from 'memphis'
+ *     Copy from 'cosmopolitan'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export declare class KeyConsistencyRule implements IRule {
+    readonly name = "key-consistency";
+    readonly description = "Ensures all themes use the same keys for each component.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = true;
+    readonly interactive = true;
+    run(context: IRuleContext): IRuleResult;
+    fix(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): IRuleFinding[];
+    interact(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): Promise<IRuleFinding[]>;
+    /**
+     * @description Deep-clones a value and replaces occurrences of the source theme prefix with the target theme prefix
+     * in all CSS variable references (e.g. `--memphis-` → `--joy-`).
+     */
+    private _replaceThemePrefix;
+}
+//# sourceMappingURL=key-consistency.rule.d.ts.map

package/rules/key-consistency.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-consistency.rule.d.ts","sourceRoot":"","sources":["../../src/rules/key-consistency.rule.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM1D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,YAAW,KAAK;IAI5C,SAAgB,IAAI,qBAAqB;IACzC,SAAgB,WAAW,8DAA8D;IACzF,SAAgB,eAAe,EAAE,YAAY,CAAsB;IACnE,SAAgB,OAAO,QAAQ;IAC/B,SAAgB,WAAW,QAAQ;IAM5B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAiDvC,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,YAAY,EAAE;IAqC3E,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyE5G;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAK9B"}

package/rules/key-consistency.rule.js

@@ -0,0 +1,161 @@
+// #region Imports
+import * as fs from 'fs';
+import { promptSelect, SKIP, SKIP_ALL } from '../core/interaction.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+import { getTokenKeys, groupByComponent, replaceThemePrefix, resolveMixinKeys } from '../utils.js';
+// #endregion
+/**
+ * @description Ensures all themes use the same set of keys for each component.
+ * Keys that are provided by `$includes` mixins are excluded from the consistency check.
+ * When auto-fix is enabled, missing keys are copied from the first theme that defines them,
+ * with theme-specific CSS variable prefixes automatically replaced.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Key 'borderRadius' is missing in component 'button' for theme 'joy'.
+ *   > Copy from 'memphis'
+ *     Copy from 'cosmopolitan'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export class KeyConsistencyRule {
+    // #region Fields
+    name = 'key-consistency';
+    description = 'Ensures all themes use the same keys for each component.';
+    defaultSeverity = RuleSeverity.Error;
+    fixable = true;
+    interactive = true;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        const grouped = groupByComponent(context.entries);
+        for (const [component, entries] of grouped.entries()) {
+            const themeEntryMap = new Map(entries.map(e => [e.theme, e]));
+            const allKeys = new Set();
+            for (const entry of entries) {
+                for (const key of getTokenKeys(entry.content)) {
+                    allKeys.add(key);
+                }
+            }
+            for (const key of allKeys) {
+                for (const theme of context.themes) {
+                    const entry = themeEntryMap.get(theme);
+                    if (!entry || Object.prototype.hasOwnProperty.call(entry.content, key)) {
+                        continue;
+                    }
+                    // Check if the key is provided by one of the entry's $includes mixins
+                    const includes = entry.content['$includes'];
+                    if (Array.isArray(includes)) {
+                        const mixinProvidedKeys = resolveMixinKeys(includes, context.mixinKeys);
+                        if (mixinProvidedKeys.has(key)) {
+                            continue;
+                        }
+                    }
+                    findings.push({
+                        component,
+                        theme,
+                        key,
+                        message: `Key '${key}' is missing in component '${component}' for theme '${theme}'.`,
+                        severity: this.defaultSeverity,
+                        filePath: entry.filePath,
+                        fixed: false,
+                    });
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+    fix(context, findings) {
+        const grouped = groupByComponent(context.entries);
+        const pendingWrites = new Map();
+        const result = [];
+        for (const finding of findings) {
+            const entries = grouped.get(finding.component);
+            if (!entries || !finding.key || !finding.filePath) {
+                result.push(finding);
+                continue;
+            }
+            const targetEntry = entries.find(e => e.theme === finding.theme);
+            const sourceEntry = entries.find(e => e.theme !== finding.theme && Object.prototype.hasOwnProperty.call(e.content, finding.key));
+            if (targetEntry && sourceEntry) {
+                const sourceValue = sourceEntry.content[finding.key];
+                targetEntry.content[finding.key] = replaceThemePrefix(sourceValue, sourceEntry.theme, finding.theme);
+                pendingWrites.set(targetEntry.filePath, targetEntry);
+                result.push({ ...finding, fixed: true });
+            }
+            else {
+                result.push(finding);
+            }
+        }
+        for (const entry of pendingWrites.values()) {
+            fs.writeFileSync(entry.filePath, JSON.stringify(entry.content, null, 2) + '\n', 'utf-8');
+        }
+        return result;
+    }
+    async interact(context, findings) {
+        const grouped = groupByComponent(context.entries);
+        const pendingWrites = new Map();
+        const result = [];
+        let skipAll = false;
+        for (const finding of findings) {
+            if (skipAll) {
+                result.push(finding);
+                continue;
+            }
+            const entries = grouped.get(finding.component);
+            if (!entries || !finding.key || !finding.filePath) {
+                result.push(finding);
+                continue;
+            }
+            const targetEntry = entries.find(e => e.theme === finding.theme);
+            const sourceThemes = entries
+                .filter(e => e.theme !== finding.theme && Object.prototype.hasOwnProperty.call(e.content, finding.key))
+                .map(e => e.theme);
+            if (!targetEntry || sourceThemes.length === 0) {
+                result.push(finding);
+                continue;
+            }
+            const choices = sourceThemes.map(theme => ({
+                name: `copy-${theme}`,
+                message: `Copy from '${theme}'`,
+            }));
+            const action = await promptSelect(finding.message, choices);
+            if (action === SKIP_ALL) {
+                skipAll = true;
+                result.push(finding);
+                continue;
+            }
+            if (action === SKIP) {
+                result.push(finding);
+                continue;
+            }
+            const sourceTheme = action.startsWith('copy-') ? action.substring(5) : undefined;
+            const sourceEntry = sourceTheme ? entries.find(e => e.theme === sourceTheme) : undefined;
+            if (sourceEntry && Object.prototype.hasOwnProperty.call(sourceEntry.content, finding.key)) {
+                const sourceValue = sourceEntry.content[finding.key];
+                targetEntry.content[finding.key] = replaceThemePrefix(sourceValue, sourceEntry.theme, finding.theme);
+                pendingWrites.set(targetEntry.filePath, targetEntry);
+                result.push({ ...finding, fixed: true });
+            }
+            else {
+                result.push(finding);
+            }
+        }
+        for (const entry of pendingWrites.values()) {
+            fs.writeFileSync(entry.filePath, JSON.stringify(entry.content, null, 2) + '\n', 'utf-8');
+        }
+        return result;
+    }
+    /**
+     * @description Deep-clones a value and replaces occurrences of the source theme prefix with the target theme prefix
+     * in all CSS variable references (e.g. `--memphis-` → `--joy-`).
+     */
+    _replaceThemePrefix(value, sourceTheme, targetTheme) {
+        return replaceThemePrefix(value, sourceTheme, targetTheme);
+    }
+}
+//# sourceMappingURL=key-consistency.rule.js.map

package/rules/key-consistency.rule.js.map

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

package/rules/missing-includes.rule.d.ts

@@ -0,0 +1,19 @@
+import type { IRule } from '../core/rule.js';
+import type { IRuleContext } from '../models/rule-context.js';
+import type { IRuleFinding } from '../models/rule-finding.js';
+import type { IRuleResult } from '../models/rule-result.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+/**
+ * @description Ensures all component token files have a `$includes` field. Auto-fixable.
+ * @public
+ */
+export declare class MissingIncludesRule implements IRule {
+    readonly name = "missing-includes";
+    readonly description = "Ensures all component token files have a $includes field. Auto-fixable.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = true;
+    readonly interactive = false;
+    run(context: IRuleContext): IRuleResult;
+    fix(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): IRuleFinding[];
+}
+//# sourceMappingURL=missing-includes.rule.d.ts.map

package/rules/missing-includes.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-includes.rule.d.ts","sourceRoot":"","sources":["../../src/rules/missing-includes.rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI1D;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,KAAK;IAI7C,SAAgB,IAAI,sBAAsB;IAC1C,SAAgB,WAAW,6EAA6E;IACxG,SAAgB,eAAe,EAAE,YAAY,CAAwB;IACrE,SAAgB,OAAO,QAAQ;IAC/B,SAAgB,WAAW,SAAS;IAM7B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAqBvC,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,YAAY,EAAE;CAuB3F"}

package/rules/missing-includes.rule.js

@@ -0,0 +1,51 @@
+// #region Imports
+import * as fs from 'fs';
+import { RuleSeverity } from '../models/rule-severity.js';
+// #endregion
+/**
+ * @description Ensures all component token files have a `$includes` field. Auto-fixable.
+ * @public
+ */
+export class MissingIncludesRule {
+    // #region Fields
+    name = 'missing-includes';
+    description = 'Ensures all component token files have a $includes field. Auto-fixable.';
+    defaultSeverity = RuleSeverity.Warning;
+    fixable = true;
+    interactive = false;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        for (const entry of context.entries) {
+            if (Array.isArray(entry.content['$includes'])) {
+                continue;
+            }
+            findings.push({
+                component: entry.component,
+                theme: entry.theme,
+                message: `Component '${entry.component}' in theme '${entry.theme}' is missing '$includes'.`,
+                severity: this.defaultSeverity,
+                filePath: entry.filePath,
+                fixed: false,
+            });
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+    fix(context, findings) {
+        const entryMap = new Map(context.entries.map(e => [e.filePath, e]));
+        const result = [];
+        for (const finding of findings) {
+            const entry = finding.filePath ? entryMap.get(finding.filePath) : undefined;
+            if (!entry) {
+                result.push(finding);
+                continue;
+            }
+            const updated = { '$includes': [], ...entry.content };
+            fs.writeFileSync(entry.filePath, JSON.stringify(updated, null, 2) + '\n', 'utf-8');
+            result.push({ ...finding, fixed: true });
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=missing-includes.rule.js.map

package/rules/missing-includes.rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-includes.rule.js","sourceRoot":"","sources":["../../src/rules/missing-includes.rule.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAKzB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAE5B,iBAAiB;IAED,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAAG,yEAAyE,CAAC;IACxF,eAAe,GAAiB,YAAY,CAAC,OAAO,CAAC;IACrD,OAAO,GAAG,IAAI,CAAC;IACf,WAAW,GAAG,KAAK,CAAC;IAEpC,aAAa;IAEb,kBAAkB;IAEX,GAAG,CAAC,OAAqB;QAC5B,MAAM,QAAQ,GAAmB,EAAE,CAAC;QAEpC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;gBAC5C,SAAS;YACb,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,cAAc,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,KAAK,2BAA2B;gBAC3F,QAAQ,EAAE,IAAI,CAAC,eAAe;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,KAAK;aACf,CAAC,CAAC;QACP,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC1D,CAAC;IAEM,GAAG,CAAC,OAAqB,EAAE,QAAqC;QACnE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,MAAM,GAAmB,EAAE,CAAC;QAElC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE5E,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAErB,SAAS;YACb,CAAC;YAED,MAAM,OAAO,GAA4B,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAE/E,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;YACnF,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CAGJ"}

package/rules/mixin-reference.rule.d.ts

@@ -0,0 +1,28 @@
+import type { IRule } from '../core/rule.js';
+import type { IRuleContext } from '../models/rule-context.js';
+import type { IRuleFinding } from '../models/rule-finding.js';
+import type { IRuleResult } from '../models/rule-result.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+/**
+ * @description Validates that $includes references point to existing mixin files.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Mixin 'glow' (base: 'glow') referenced in '$includes' does not exist as a mixin file.
+ *   > Remove 'glow' from $includes
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export declare class MixinReferenceRule implements IRule {
+    readonly name = "mixin-reference";
+    readonly description = "Validates that $includes references point to existing mixin files.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = true;
+    run(context: IRuleContext): IRuleResult;
+    interact(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): Promise<IRuleFinding[]>;
+}
+//# sourceMappingURL=mixin-reference.rule.d.ts.map

package/rules/mixin-reference.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin-reference.rule.d.ts","sourceRoot":"","sources":["../../src/rules/mixin-reference.rule.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK1D;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,KAAK;IAI5C,SAAgB,IAAI,qBAAqB;IACzC,SAAgB,WAAW,wEAAwE;IACnG,SAAgB,eAAe,EAAE,YAAY,CAAsB;IACnE,SAAgB,OAAO,SAAS;IAChC,SAAgB,WAAW,QAAQ;IAM5B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IA+BjC,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAwE/G"}