@breadstone-infrastructure/token-linter 0.0.231

package/rules/empty-json.rule.js

@@ -0,0 +1,100 @@
+// #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 } from '../utils.js';
+// #endregion
+// #region Functions
+/**
+ * @description Creates typed rule options for the `empty-json` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...emptyJsonRuleOptions({ allowIncludes: true }),
+ * }
+ * ```
+ */
+export function emptyJsonRuleOptions(options) {
+    return { 'empty-json': options };
+}
+// #endregion
+/**
+ * @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 class EmptyJsonRule {
+    // #region Fields
+    name = 'empty-json';
+    description = 'Detects component token files with no token definitions.';
+    defaultSeverity = RuleSeverity.Warning;
+    fixable = false;
+    interactive = true;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        const options = context.config.ruleOptions[this.name];
+        const allowIncludes = options?.allowIncludes ?? false;
+        for (const entry of context.entries) {
+            const tokenKeys = getTokenKeys(entry.content);
+            if (tokenKeys.length === 0) {
+                if (allowIncludes && Array.isArray(entry.content['$includes']) && entry.content['$includes'].length > 0) {
+                    continue;
+                }
+                findings.push({
+                    component: entry.component,
+                    theme: entry.theme,
+                    message: `Component '${entry.component}' in theme '${entry.theme}' has no token definitions.`,
+                    severity: this.defaultSeverity,
+                    filePath: entry.filePath,
+                    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;
+            }
+            if (!finding.filePath) {
+                result.push(finding);
+                continue;
+            }
+            const action = await promptSelect(finding.message, ['Delete file']);
+            if (action === SKIP_ALL) {
+                skipAll = true;
+                result.push(finding);
+                continue;
+            }
+            if (action === SKIP) {
+                result.push(finding);
+                continue;
+            }
+            if (fs.existsSync(finding.filePath)) {
+                fs.unlinkSync(finding.filePath);
+                result.push({ ...finding, fixed: true });
+            }
+            else {
+                result.push(finding);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=empty-json.rule.js.map

package/rules/empty-json.rule.js.map

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

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

@@ -0,0 +1,57 @@
+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 `forbidden-key` rule.
+ * @public
+ */
+export interface IForbiddenKeyRuleOptions extends IRuleOptionValues {
+    /**
+     * @description Keys that are forbidden in component token files. Overrides the built-in default list.
+     * @default ['transition', 'shadow']
+     */
+    readonly keys?: ReadonlyArray<string>;
+    /**
+     * @description If set, only these themes are checked for forbidden keys.
+     * @default undefined (all themes)
+     */
+    readonly themes?: ReadonlyArray<string>;
+}
+/**
+ * @description Creates typed rule options for the `forbidden-key` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenKeyRuleOptions({ keys: ['transition', 'shadow'], themes: ['joy'] }),
+ * }
+ * ```
+ */
+export declare function forbiddenKeyRuleOptions(options: IForbiddenKeyRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Detects forbidden keys in component token files.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Forbidden key 'transition' found in 'button' (joy).
+ *   > Remove key 'transition'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export declare class ForbiddenKeyRule implements IRule {
+    readonly name = "forbidden-key";
+    readonly description = "Detects forbidden keys in 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=forbidden-key.rule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden-key.rule.d.ts","sourceRoot":"","sources":["../../src/rules/forbidden-key.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;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAa7F;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IAE/D;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAE5F;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,YAAW,KAAK;IAI1C,SAAgB,IAAI,mBAAmB;IACvC,SAAgB,WAAW,sDAAsD;IACjF,SAAgB,eAAe,EAAE,YAAY,CAAwB;IACrE,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;CA6D/G"}

package/rules/forbidden-key.rule.js

@@ -0,0 +1,118 @@
+// #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 } from '../utils.js';
+// #endregion
+// #region Constants
+const DEFAULT_FORBIDDEN_KEYS = ['transition', 'shadow'];
+// #endregion
+// #region Functions
+/**
+ * @description Creates typed rule options for the `forbidden-key` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenKeyRuleOptions({ keys: ['transition', 'shadow'], themes: ['joy'] }),
+ * }
+ * ```
+ */
+export function forbiddenKeyRuleOptions(options) {
+    return { 'forbidden-key': options };
+}
+// #endregion
+/**
+ * @description Detects forbidden keys in component token files.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Forbidden key 'transition' found in 'button' (joy).
+ *   > Remove key 'transition'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export class ForbiddenKeyRule {
+    // #region Fields
+    name = 'forbidden-key';
+    description = 'Detects forbidden keys in component token files.';
+    defaultSeverity = RuleSeverity.Warning;
+    fixable = false;
+    interactive = true;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        const options = context.config.ruleOptions[this.name];
+        const forbiddenKeys = options?.keys ?? DEFAULT_FORBIDDEN_KEYS;
+        const restrictedThemes = options?.themes;
+        for (const entry of context.entries) {
+            if (restrictedThemes && !restrictedThemes.includes(entry.theme)) {
+                continue;
+            }
+            const keys = getTokenKeys(entry.content);
+            for (const key of keys) {
+                if (forbiddenKeys.includes(key)) {
+                    findings.push({
+                        component: entry.component,
+                        theme: entry.theme,
+                        key,
+                        message: `Forbidden key '${key}' found in '${entry.component}' (${entry.theme}).`,
+                        severity: this.defaultSeverity,
+                        filePath: entry.filePath,
+                        fixed: false,
+                    });
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+    async interact(context, findings) {
+        const entryMap = new Map(context.entries.map((e) => [`${e.theme}:${e.component}`, e]));
+        const pendingWrites = new Map();
+        const result = [];
+        let skipAll = false;
+        for (const finding of findings) {
+            if (skipAll) {
+                result.push(finding);
+                continue;
+            }
+            if (!finding.key || !finding.filePath) {
+                result.push(finding);
+                continue;
+            }
+            const entry = entryMap.get(`${finding.theme}:${finding.component}`);
+            if (!entry) {
+                result.push(finding);
+                continue;
+            }
+            const action = await promptSelect(finding.message, [`Remove key '${finding.key}'`]);
+            if (action === SKIP_ALL) {
+                skipAll = true;
+                result.push(finding);
+                continue;
+            }
+            if (action === SKIP) {
+                result.push(finding);
+                continue;
+            }
+            if (Object.prototype.hasOwnProperty.call(entry.content, finding.key)) {
+                delete entry.content[finding.key];
+                pendingWrites.set(entry.filePath, entry);
+                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=forbidden-key.rule.js.map

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

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

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

@@ -0,0 +1,53 @@
+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 `forbidden-value` rule.
+ * @public
+ */
+export interface IForbiddenValueRuleOptions extends IRuleOptionValues {
+    /**
+     * @description Values that are forbidden in token definitions. Overrides the built-in default list.
+     * @default ['unset', '0px', 'all']
+     */
+    readonly values?: ReadonlyArray<string>;
+}
+/**
+ * @description Creates typed rule options for the `forbidden-value` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenValueRuleOptions({ values: ['unset', '0px', 'none'] }),
+ * }
+ * ```
+ */
+export declare function forbiddenValueRuleOptions(options: IForbiddenValueRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Detects forbidden token values such as unset, 0px, all.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Forbidden value 'unset' found for key 'borderColor' in 'button' (joy).
+ *   > Remove key 'borderColor'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export declare class ForbiddenValueRule implements IRule {
+    readonly name = "forbidden-value";
+    readonly description = "Detects forbidden token values like unset, 0px, all.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = true;
+    run(context: IRuleContext): IRuleResult;
+    interact(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): Promise<IRuleFinding[]>;
+    private _deleteNestedKey;
+}
+//# sourceMappingURL=forbidden-value.rule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden-value.rule.d.ts","sourceRoot":"","sources":["../../src/rules/forbidden-value.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;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAa7F;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IAEjE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,iBAAiB,CAEhG;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,KAAK;IAI5C,SAAgB,IAAI,qBAAqB;IACzC,SAAgB,WAAW,0DAA0D;IACrF,SAAgB,eAAe,EAAE,YAAY,CAAwB;IACrE,SAAgB,OAAO,SAAS;IAChC,SAAgB,WAAW,QAAQ;IAM5B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IA0BjC,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2D5G,OAAO,CAAC,gBAAgB;CA0B3B"}

package/rules/forbidden-value.rule.js

@@ -0,0 +1,130 @@
+// #region Imports
+import * as fs from 'fs';
+import { promptSelect, SKIP, SKIP_ALL } from '../core/interaction.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+import { flattenTokenEntries } from '../utils.js';
+// #endregion
+// #region Constants
+const DEFAULT_FORBIDDEN_VALUES = ['unset', '0px', 'all'];
+// #endregion
+// #region Functions
+/**
+ * @description Creates typed rule options for the `forbidden-value` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenValueRuleOptions({ values: ['unset', '0px', 'none'] }),
+ * }
+ * ```
+ */
+export function forbiddenValueRuleOptions(options) {
+    return { 'forbidden-value': options };
+}
+// #endregion
+/**
+ * @description Detects forbidden token values such as unset, 0px, all.
+ *
+ * @example Interactive prompt
+ * ```
+ * ? Forbidden value 'unset' found for key 'borderColor' in 'button' (joy).
+ *   > Remove key 'borderColor'
+ *     Skip
+ *     Skip all remaining
+ * ```
+ *
+ * @public
+ */
+export class ForbiddenValueRule {
+    // #region Fields
+    name = 'forbidden-value';
+    description = 'Detects forbidden token values like unset, 0px, all.';
+    defaultSeverity = RuleSeverity.Warning;
+    fixable = false;
+    interactive = true;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        const options = context.config.ruleOptions[this.name];
+        const forbiddenValues = options?.values ?? DEFAULT_FORBIDDEN_VALUES;
+        for (const entry of context.entries) {
+            const flatEntries = flattenTokenEntries(entry.content);
+            for (const { key, value } of flatEntries) {
+                if (typeof value === 'string' && forbiddenValues.includes(value.trim())) {
+                    findings.push({
+                        component: entry.component,
+                        theme: entry.theme,
+                        key,
+                        message: `Forbidden value '${value}' found for key '${key}' in '${entry.component}' (${entry.theme}).`,
+                        severity: this.defaultSeverity,
+                        filePath: entry.filePath,
+                        fixed: false,
+                    });
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+    async interact(context, findings) {
+        const entryMap = new Map(context.entries.map((e) => [`${e.theme}:${e.component}`, e]));
+        const pendingWrites = new Map();
+        const result = [];
+        let skipAll = false;
+        for (const finding of findings) {
+            if (skipAll) {
+                result.push(finding);
+                continue;
+            }
+            if (!finding.key || !finding.filePath) {
+                result.push(finding);
+                continue;
+            }
+            const entry = entryMap.get(`${finding.theme}:${finding.component}`);
+            if (!entry) {
+                result.push(finding);
+                continue;
+            }
+            const action = await promptSelect(finding.message, [`Remove key '${finding.key}'`]);
+            if (action === SKIP_ALL) {
+                skipAll = true;
+                result.push(finding);
+                continue;
+            }
+            if (action === SKIP) {
+                result.push(finding);
+                continue;
+            }
+            if (this._deleteNestedKey(entry.content, finding.key)) {
+                pendingWrites.set(entry.filePath, entry);
+                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;
+    }
+    _deleteNestedKey(obj, dotPath) {
+        const parts = dotPath.split('.');
+        let current = obj;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const next = current[parts[i]];
+            if (typeof next !== 'object' || next === null) {
+                return false;
+            }
+            current = next;
+        }
+        const lastKey = parts[parts.length - 1];
+        if (Object.prototype.hasOwnProperty.call(current, lastKey)) {
+            delete current[lastKey];
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=forbidden-value.rule.js.map

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

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

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

@@ -0,0 +1,30 @@
+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 $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 declare class IncludesConsistencyRule implements IRule {
+    readonly name = "includes-consistency";
+    readonly description = "Ensures $includes arrays are consistent across themes for the same component.";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = true;
+    run(context: IRuleContext): IRuleResult;
+    interact(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): Promise<IRuleFinding[]>;
+}
+//# sourceMappingURL=includes-consistency.rule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"includes-consistency.rule.d.ts","sourceRoot":"","sources":["../../src/rules/includes-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;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAwB,YAAW,KAAK;IAIjD,SAAgB,IAAI,0BAA0B;IAC9C,SAAgB,WAAW,mFAAmF;IAC9G,SAAgB,eAAe,EAAE,YAAY,CAAwB;IACrE,SAAgB,OAAO,SAAS;IAChC,SAAgB,WAAW,QAAQ;IAM5B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IA4DjC,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAuG/G"}