@breadstone-infrastructure/token-linter 0.0.231

package/reporters/console.reporter.js

@@ -0,0 +1,75 @@
+// #region Imports
+import { bold, ConsoleLogger, gray, green, red, yellow } from '@breadstone-infrastructure/utilities';
+import { RuleSeverity } from '../models/rule-severity.js';
+// #endregion
+/**
+ * @description Outputs lint results as formatted console output with severity colors.
+ * @public
+ */
+export class ConsoleReporter {
+    // #region Fields
+    name = 'console';
+    _logger = new ConsoleLogger();
+    // #endregion
+    // #region Methods
+    report(result) {
+        this._logger.info('');
+        for (const ruleResult of result.results) {
+            this.reportRule(ruleResult);
+        }
+        this.reportSummary(result);
+    }
+    reportRule(ruleResult) {
+        if (ruleResult.findings.length === 0) {
+            this._logger.info(green(`  ✔ Passed - ${ruleResult.ruleName}`));
+            return;
+        }
+        this._logger.info(bold(`  Rule: ${ruleResult.ruleName}`));
+        this._logger.info(gray(`  ${'─'.repeat(60)}`));
+        for (const finding of ruleResult.findings) {
+            const severityLabel = this.formatSeverity(finding.severity);
+            const fixedLabel = finding.fixed ? green(' [FIXED]') : '';
+            const location = [finding.component, finding.theme].filter(Boolean).join(' / ');
+            this._logger.info(`  ${severityLabel} ${gray(`[${location}]`)} ${finding.message}${fixedLabel}`);
+        }
+        this._logger.info('');
+    }
+    reportSummary(result) {
+        this._logger.info(gray(`  ${'═'.repeat(60)}`));
+        this._logger.info(bold('  Summary'));
+        const parts = [];
+        if (result.totalErrors > 0) {
+            parts.push(red(`${result.totalErrors} error(s)`));
+        }
+        if (result.totalWarnings > 0) {
+            parts.push(yellow(`${result.totalWarnings} warning(s)`));
+        }
+        if (result.totalInfos > 0) {
+            parts.push(gray(`${result.totalInfos} info(s)`));
+        }
+        if (result.totalFixes > 0) {
+            parts.push(green(`${result.totalFixes} fix(es) applied`));
+        }
+        if (parts.length === 0) {
+            this._logger.info(green('  All checks passed.'));
+        }
+        else {
+            this._logger.info(`  ${parts.join('  |  ')}`);
+        }
+        this._logger.info(gray(`  Duration: ${result.duration}ms`));
+        this._logger.info('');
+    }
+    formatSeverity(severity) {
+        switch (severity) {
+            case RuleSeverity.Error:
+                return red(bold('ERROR'));
+            case RuleSeverity.Warning:
+                return yellow(bold('WARN '));
+            case RuleSeverity.Info:
+                return gray(bold('INFO '));
+            default:
+                return gray('     ');
+        }
+    }
+}
+//# sourceMappingURL=console.reporter.js.map

package/reporters/console.reporter.js.map

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

package/reporters/json.reporter.d.ts

@@ -0,0 +1,11 @@
+import type { ILintResult } from '../models/lint-result.js';
+import type { IReporter } from './reporter.js';
+/**
+ * @description Outputs lint results as structured JSON for CI/pipeline consumption.
+ * @public
+ */
+export declare class JsonReporter implements IReporter {
+    readonly name = "json";
+    report(result: ILintResult): void;
+}
+//# sourceMappingURL=json.reporter.d.ts.map

package/reporters/json.reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/json.reporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;GAGG;AACH,qBAAa,YAAa,YAAW,SAAS;IAI1C,SAAgB,IAAI,UAAU;IAMvB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CA2B3C"}

package/reporters/json.reporter.js

@@ -0,0 +1,37 @@
+// #region Imports
+// #endregion
+/**
+ * @description Outputs lint results as structured JSON for CI/pipeline consumption.
+ * @public
+ */
+export class JsonReporter {
+    // #region Fields
+    name = 'json';
+    // #endregion
+    // #region Methods
+    report(result) {
+        const output = {
+            totalErrors: result.totalErrors,
+            totalWarnings: result.totalWarnings,
+            totalInfos: result.totalInfos,
+            totalFixes: result.totalFixes,
+            duration: result.duration,
+            rules: result.results.map(r => ({
+                rule: r.ruleName,
+                findingsCount: r.findings.length,
+                duration: r.duration,
+                findings: r.findings.map(f => ({
+                    component: f.component,
+                    theme: f.theme,
+                    key: f.key,
+                    message: f.message,
+                    severity: f.severity,
+                    filePath: f.filePath,
+                    fixed: f.fixed,
+                })),
+            })),
+        };
+        console.log(JSON.stringify(output, null, 2));
+    }
+}
+//# sourceMappingURL=json.reporter.js.map

package/reporters/json.reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.reporter.js","sourceRoot":"","sources":["../../src/reporters/json.reporter.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAKlB,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,YAAY;IAErB,iBAAiB;IAED,IAAI,GAAG,MAAM,CAAC;IAE9B,aAAa;IAEb,kBAAkB;IAEX,MAAM,CAAC,MAAmB;QAC7B,MAAM,MAAM,GAAG;YACX,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC5B,IAAI,EAAE,CAAC,CAAC,QAAQ;gBAChB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM;gBAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC3B,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;iBACjB,CAAC,CAAC;aACN,CAAC,CAAC;SACN,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;CAGJ"}

package/reporters/reporter.d.ts

@@ -0,0 +1,16 @@
+import type { ILintResult } from '../models/lint-result.js';
+/**
+ * @description Contract for a token linter output reporter.
+ * @public
+ */
+export interface IReporter {
+    /**
+     * @description Unique identifier of the reporter.
+     */
+    readonly name: string;
+    /**
+     * @description Formats and outputs the lint result.
+     */
+    report(result: ILintResult): void;
+}
+//# sourceMappingURL=reporter.d.ts.map

package/reporters/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/reporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;;GAGG;AACH,MAAM,WAAW,SAAS;IAEtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACrC"}

package/reporters/reporter.js

@@ -0,0 +1,3 @@
+// #region Imports
+export {};
+//# sourceMappingURL=reporter.js.map

package/reporters/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/reporters/reporter.ts"],"names":[],"mappings":"AAAA,kBAAkB"}

package/reporters/summary.reporter.d.ts

@@ -0,0 +1,12 @@
+import type { ILintResult } from '../models/lint-result.js';
+import type { IReporter } from './reporter.js';
+/**
+ * @description Outputs a compact summary of lint results with per-rule pass/fail counts.
+ * @public
+ */
+export declare class SummaryReporter implements IReporter {
+    readonly name = "summary";
+    private readonly _logger;
+    report(result: ILintResult): void;
+}
+//# sourceMappingURL=summary.reporter.d.ts.map

package/reporters/summary.reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/summary.reporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;GAGG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAI7C,SAAgB,IAAI,aAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAMxC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CA2C3C"}

package/reporters/summary.reporter.js

@@ -0,0 +1,48 @@
+// #region Imports
+import { bold, ConsoleLogger, gray, green, red, yellow } from '@breadstone-infrastructure/utilities';
+// #endregion
+/**
+ * @description Outputs a compact summary of lint results with per-rule pass/fail counts.
+ * @public
+ */
+export class SummaryReporter {
+    // #region Fields
+    name = 'summary';
+    _logger = new ConsoleLogger();
+    // #endregion
+    // #region Methods
+    report(result) {
+        this._logger.info('');
+        this._logger.info(bold('  Token Linter Summary'));
+        this._logger.info(gray(`  ${'─'.repeat(40)}`));
+        for (const ruleResult of result.results) {
+            const count = ruleResult.findings.length;
+            if (count === 0) {
+                this._logger.info(`  ${green('✓')} ${ruleResult.ruleName}`);
+            }
+            else {
+                const fixedCount = ruleResult.findings.filter(f => f.fixed).length;
+                const label = fixedCount > 0
+                    ? `${count} finding(s), ${fixedCount} fixed`
+                    : `${count} finding(s)`;
+                this._logger.info(`  ${yellow('✗')} ${ruleResult.ruleName} — ${label}`);
+            }
+        }
+        this._logger.info(gray(`  ${'─'.repeat(40)}`));
+        if (result.totalErrors > 0) {
+            this._logger.info(red(`  ${result.totalErrors} error(s)`));
+        }
+        if (result.totalWarnings > 0) {
+            this._logger.info(yellow(`  ${result.totalWarnings} warning(s)`));
+        }
+        if (result.totalFixes > 0) {
+            this._logger.info(green(`  ${result.totalFixes} fix(es) applied`));
+        }
+        if (result.totalErrors === 0 && result.totalWarnings === 0) {
+            this._logger.info(green('  All checks passed.'));
+        }
+        this._logger.info(gray(`  Duration: ${result.duration}ms`));
+        this._logger.info('');
+    }
+}
+//# sourceMappingURL=summary.reporter.js.map

package/reporters/summary.reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.reporter.js","sourceRoot":"","sources":["../../src/reporters/summary.reporter.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAIrG,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,eAAe;IAExB,iBAAiB;IAED,IAAI,GAAG,SAAS,CAAC;IAChB,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;IAE/C,aAAa;IAEb,kBAAkB;IAEX,MAAM,CAAC,MAAmB;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAE/C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;YAEzC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACJ,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;gBACnE,MAAM,KAAK,GAAG,UAAU,GAAG,CAAC;oBACxB,CAAC,CAAC,GAAG,KAAK,gBAAgB,UAAU,QAAQ;oBAC5C,CAAC,CAAC,GAAG,KAAK,aAAa,CAAC;gBAE5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,MAAM,KAAK,EAAE,CAAC,CAAC;YAC5E,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAE/C,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,WAAW,WAAW,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,aAAa,aAAa,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,UAAU,kBAAkB,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,KAAK,CAAC,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;CAGJ"}

package/rules/alphabetical-sort.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 token keys are sorted alphabetically within each file. Auto-fixable.
+ * @public
+ */
+export declare class AlphabeticalSortRule implements IRule {
+    readonly name = "alphabetical-sort";
+    readonly description = "Ensures token keys are sorted alphabetically. Auto-fixable.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = true;
+    readonly interactive = false;
+    run(context: IRuleContext): IRuleResult;
+    fix(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): IRuleFinding[];
+}
+//# sourceMappingURL=alphabetical-sort.rule.d.ts.map

package/rules/alphabetical-sort.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphabetical-sort.rule.d.ts","sourceRoot":"","sources":["../../src/rules/alphabetical-sort.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,oBAAqB,YAAW,KAAK;IAI9C,SAAgB,IAAI,uBAAuB;IAC3C,SAAgB,WAAW,iEAAiE;IAC5F,SAAgB,eAAe,EAAE,YAAY,CAAwB;IACrE,SAAgB,OAAO,QAAQ;IAC/B,SAAgB,WAAW,SAAS;IAM7B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAsCvC,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,YAAY,EAAE;CAkC3F"}

package/rules/alphabetical-sort.rule.js

@@ -0,0 +1,72 @@
+// #region Imports
+import * as fs from 'fs';
+import { RuleSeverity } from '../models/rule-severity.js';
+// #endregion
+/**
+ * @description Ensures token keys are sorted alphabetically within each file. Auto-fixable.
+ * @public
+ */
+export class AlphabeticalSortRule {
+    // #region Fields
+    name = 'alphabetical-sort';
+    description = 'Ensures token keys are sorted alphabetically. Auto-fixable.';
+    defaultSeverity = RuleSeverity.Warning;
+    fixable = true;
+    interactive = false;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        for (const entry of context.entries) {
+            const keys = Object.keys(entry.content);
+            if (keys.length === 0) {
+                continue;
+            }
+            const sortedKeys = [...keys].sort((a, b) => a.localeCompare(b));
+            let needsSort = !keys.every((key, i) => key === sortedKeys[i]);
+            // Also check $includes array sorting
+            if (!needsSort && Array.isArray(entry.content['$includes'])) {
+                const includes = entry.content['$includes'];
+                const sortedIncludes = [...includes].sort((a, b) => a.localeCompare(b));
+                needsSort = !includes.every((val, i) => val === sortedIncludes[i]);
+            }
+            if (!needsSort) {
+                continue;
+            }
+            findings.push({
+                component: entry.component,
+                theme: entry.theme,
+                message: `Keys in '${entry.component}' (${entry.theme}) are not sorted alphabetically.`,
+                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 keys = Object.keys(entry.content);
+            const sortedKeys = [...keys].sort((a, b) => a.localeCompare(b));
+            const sorted = sortedKeys.reduce((acc, key) => {
+                acc[key] = entry.content[key];
+                return acc;
+            }, {});
+            // Sort $includes array values
+            if (Array.isArray(entry.content['$includes'])) {
+                sorted['$includes'] = [...entry.content['$includes']].sort((a, b) => a.localeCompare(b));
+            }
+            fs.writeFileSync(entry.filePath, JSON.stringify(sorted, null, 2) + '\n', 'utf-8');
+            result.push({ ...finding, fixed: true });
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=alphabetical-sort.rule.js.map

package/rules/alphabetical-sort.rule.js.map

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

package/rules/component-presence.rule.d.ts

@@ -0,0 +1,29 @@
+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 contain the same set of component token files.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Component 'card' is missing in theme 'joy'.
+ *   > Create from 'memphis'
+ *     Create from 'cosmopolitan'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export declare class ComponentPresenceRule implements IRule {
+    readonly name = "component-presence";
+    readonly description = "Ensures all themes contain the same set of component token files.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = true;
+    run(context: IRuleContext): IRuleResult;
+    interact(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): Promise<IRuleFinding[]>;
+}
+//# sourceMappingURL=component-presence.rule.d.ts.map

package/rules/component-presence.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-presence.rule.d.ts","sourceRoot":"","sources":["../../src/rules/component-presence.rule.ts"],"names":[],"mappings":"AAKA,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;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,YAAW,KAAK;IAI/C,SAAgB,IAAI,wBAAwB;IAC5C,SAAgB,WAAW,uEAAuE;IAClG,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;CAiE/G"}

package/rules/component-presence.rule.js

@@ -0,0 +1,102 @@
+// #region Imports
+import * as fs from 'fs';
+import * as path from 'path';
+import { promptSelect, SKIP, SKIP_ALL } from '../core/interaction.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+import { replaceThemePrefix } from '../utils.js';
+// #endregion
+/**
+ * @description Ensures all themes contain the same set of component token files.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Component 'card' is missing in theme 'joy'.
+ *   > Create from 'memphis'
+ *     Create from 'cosmopolitan'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export class ComponentPresenceRule {
+    // #region Fields
+    name = 'component-presence';
+    description = 'Ensures all themes contain the same set of component token files.';
+    defaultSeverity = RuleSeverity.Error;
+    fixable = false;
+    interactive = true;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        const themeMap = new Map();
+        for (const theme of context.themes) {
+            themeMap.set(theme, new Set());
+        }
+        for (const entry of context.entries) {
+            themeMap.get(entry.theme)?.add(entry.component);
+        }
+        const allComponents = new Set(context.entries.map(e => e.component));
+        for (const component of allComponents) {
+            for (const theme of context.themes) {
+                if (!themeMap.get(theme)?.has(component)) {
+                    findings.push({
+                        component,
+                        theme,
+                        message: `Component '${component}' is missing in theme '${theme}'.`,
+                        severity: this.defaultSeverity,
+                        fixed: false,
+                    });
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+    async interact(context, findings) {
+        const result = [];
+        let skipAll = false;
+        for (const finding of findings) {
+            if (skipAll) {
+                result.push(finding);
+                continue;
+            }
+            const sourceEntries = context.entries.filter((e) => e.component === finding.component && e.theme !== finding.theme);
+            if (sourceEntries.length === 0) {
+                result.push(finding);
+                continue;
+            }
+            const choices = sourceEntries.map((entry) => ({
+                name: `create-from-${entry.theme}`,
+                message: `Create from '${entry.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('create-from-') ? action.substring(12) : undefined;
+            const sourceEntry = sourceTheme ? sourceEntries.find((e) => e.theme === sourceTheme) : undefined;
+            if (sourceEntry) {
+                const targetPath = sourceEntry.filePath.replace(`/${sourceEntry.theme}/`, `/${finding.theme}/`);
+                const targetDir = path.dirname(targetPath);
+                if (!fs.existsSync(targetDir)) {
+                    fs.mkdirSync(targetDir, { recursive: true });
+                }
+                const newContent = replaceThemePrefix(sourceEntry.content, sourceEntry.theme, finding.theme);
+                fs.writeFileSync(targetPath, JSON.stringify(newContent, null, 2) + '\n', 'utf-8');
+                result.push({ ...finding, fixed: true });
+            }
+            else {
+                result.push(finding);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=component-presence.rule.js.map

package/rules/component-presence.rule.js.map

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

package/rules/duplicate-value.rule.d.ts

@@ -0,0 +1,17 @@
+import type { IRule } from '../core/rule.js';
+import type { IRuleContext } from '../models/rule-context.js';
+import type { IRuleResult } from '../models/rule-result.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+/**
+ * @description Detects duplicate token values within the same component that could be abstracted into a shared variable.
+ * @public
+ */
+export declare class DuplicateValueRule implements IRule {
+    readonly name = "duplicate-value";
+    readonly description = "Detects duplicate token values within the same component that could be abstracted.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = false;
+    run(context: IRuleContext): IRuleResult;
+}
+//# sourceMappingURL=duplicate-value.rule.d.ts.map

package/rules/duplicate-value.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-value.rule.d.ts","sourceRoot":"","sources":["../../src/rules/duplicate-value.rule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK1D;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,KAAK;IAI5C,SAAgB,IAAI,qBAAqB;IACzC,SAAgB,WAAW,wFAAwF;IACnH,SAAgB,eAAe,EAAE,YAAY,CAAqB;IAClE,SAAgB,OAAO,SAAS;IAChC,SAAgB,WAAW,SAAS;IAM7B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;CAuCjD"}

package/rules/duplicate-value.rule.js

@@ -0,0 +1,49 @@
+// #region Imports
+import { RuleSeverity } from '../models/rule-severity.js';
+import { flattenTokenEntries } from '../utils.js';
+// #endregion
+/**
+ * @description Detects duplicate token values within the same component that could be abstracted into a shared variable.
+ * @public
+ */
+export class DuplicateValueRule {
+    // #region Fields
+    name = 'duplicate-value';
+    description = 'Detects duplicate token values within the same component that could be abstracted.';
+    defaultSeverity = RuleSeverity.Info;
+    fixable = false;
+    interactive = false;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        for (const entry of context.entries) {
+            const flatEntries = flattenTokenEntries(entry.content);
+            const valueMap = new Map();
+            for (const { key, value } of flatEntries) {
+                if (typeof value !== 'string') {
+                    continue;
+                }
+                const trimmed = value.trim();
+                if (!valueMap.has(trimmed)) {
+                    valueMap.set(trimmed, []);
+                }
+                valueMap.get(trimmed).push(key);
+            }
+            for (const [value, keys] of valueMap.entries()) {
+                if (keys.length > 1) {
+                    findings.push({
+                        component: entry.component,
+                        theme: entry.theme,
+                        message: `Duplicate value '${value}' used by keys: ${keys.join(', ')}. Consider extracting to a shared variable.`,
+                        severity: this.defaultSeverity,
+                        filePath: entry.filePath,
+                        fixed: false,
+                    });
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+}
+//# sourceMappingURL=duplicate-value.rule.js.map

package/rules/duplicate-value.rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-value.rule.js","sourceRoot":"","sources":["../../src/rules/duplicate-value.rule.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAMlB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAE3B,iBAAiB;IAED,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,oFAAoF,CAAC;IACnG,eAAe,GAAiB,YAAY,CAAC,IAAI,CAAC;IAClD,OAAO,GAAG,KAAK,CAAC;IAChB,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,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;YAE7C,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC;gBACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC5B,SAAS;gBACb,CAAC;gBAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBAE7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzB,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC9B,CAAC;gBAED,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;YAED,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC;wBACV,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,OAAO,EAAE,oBAAoB,KAAK,mBAAmB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,6CAA6C;wBACjH,QAAQ,EAAE,IAAI,CAAC,eAAe;wBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,KAAK,EAAE,KAAK;qBACf,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC1D,CAAC;CAGJ"}

package/rules/empty-json.rule.d.ts

@@ -0,0 +1,52 @@
+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';
+import type { IRuleOptionsEntry, IRuleOptionValues } from '../models/token-linter-config.js';
+/**
+ * @description Options for the `empty-json` rule.
+ * @public
+ */
+export interface IEmptyJsonRuleOptions extends IRuleOptionValues {
+    /**
+     * @description When `true`, files that contain only `$includes` (but no token keys) are not flagged.
+     * @default false
+     */
+    readonly allowIncludes?: boolean;
+}
+/**
+ * @description Creates typed rule options for the `empty-json` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...emptyJsonRuleOptions({ allowIncludes: true }),
+ * }
+ * ```
+ */
+export declare function emptyJsonRuleOptions(options: IEmptyJsonRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Detects component token files with no token definitions.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Component 'divider' in theme 'joy' has no token definitions.
+ *   > Delete file
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export declare class EmptyJsonRule implements IRule {
+    readonly name = "empty-json";
+    readonly description = "Detects component token files with no token definitions.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = true;
+    run(context: IRuleContext): IRuleResult;
+    interact(_context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): Promise<IRuleFinding[]>;
+}
+//# sourceMappingURL=empty-json.rule.d.ts.map

package/rules/empty-json.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-json.rule.d.ts","sourceRoot":"","sources":["../../src/rules/empty-json.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;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAO7F;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAE5D;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CACpC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAEtF;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,KAAK;IAIvC,SAAgB,IAAI,gBAAgB;IACpC,SAAgB,WAAW,8DAA8D;IACzF,SAAgB,eAAe,EAAE,YAAY,CAAwB;IACrE,SAAgB,OAAO,SAAS;IAChC,SAAgB,WAAW,QAAQ;IAM5B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IA2BjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA4ChH"}