@breadstone-infrastructure/token-linter 0.0.231 → 0.0.232

package/cli/Cli.js

@@ -13,9 +13,9 @@ export class Cli extends Program {
     // #region Ctor
     constructor() {
         super({
-            moduleName: 'token-linter',
-            prog: 'token-linter',
-            description: 'Token Linter — A configurable linter for Style Dictionary token JSON files.',
+            moduleName: 'tokenlinter',
+            prog: 'tokenlinter',
+            description: 'Token Linter - A configurable linter for Style Dictionary token JSON files.',
             version: '@@VERSION',
             addHelp: true,
             debug: true,

package/cli/Cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"Cli.js","sourceRoot":"","sources":["../../src/cli/Cli.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAuB,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAEvF,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,GAAI,SAAQ,OAAuB;IAE5C,eAAe;IAEf;QACI,KAAK,CAAC;YACF,UAAU,EAAE,cAAc;YAC1B,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,6EAA6E;YAC1F,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM;aACN,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAErC,IAAI,CAAC,IAAI;aACJ,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC;QAE3B,MAAM,UAAU,GAAoD,GAAG,EAAE,CAAC,CAAC,gCAAgC,CAAC,CAAC;QAE7G,IAAI,CAAC,QAAQ;aACR,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;CAGJ"}
+{"version":3,"file":"Cli.js","sourceRoot":"","sources":["../../src/cli/Cli.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAuB,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAEvF,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,GAAI,SAAQ,OAAuB;IAE5C,eAAe;IAEf;QACI,KAAK,CAAC;YACF,UAAU,EAAE,aAAa;YACzB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,6EAA6E;YAC1F,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM;aACN,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAErC,IAAI,CAAC,IAAI;aACJ,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC;QAE3B,MAAM,UAAU,GAAoD,GAAG,EAAE,CAAC,CAAC,gCAAgC,CAAC,CAAC;QAE7G,IAAI,CAAC,QAAQ;aACR,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;CAGJ"}

package/core/interaction.d.ts

@@ -15,11 +15,22 @@ export declare const SKIP_ALL: "__skip_all__";
 export interface IPromptChoice {
     readonly name: string;
     readonly message: string;
+    readonly hint?: string;
+    readonly shortcut?: string;
 }
 /**
- * @description Presents a select prompt to the user with the given choices plus Skip / Skip all remaining.
- * Returns the selected choice name string, or one of the sentinel values (SKIP / SKIP_ALL).
+ * @description Progress information rendered in the interactive prompt footer.
  * @public
  */
-export declare function promptSelect(message: string, choices: ReadonlyArray<string | IPromptChoice>): Promise<string>;
+export interface IInteractiveProgress {
+    readonly current: number;
+    readonly total: number;
+}
+/**
+ * @description Runs an interactive session with a global progress state.
+ * Every `promptSelect()` call inside the callback automatically advances and renders the footer status.
+ * @public
+ */
+export declare function withInteractiveProgress<T>(total: number, callback: () => Promise<T>): Promise<T>;
+export declare function promptSelect(message: string, choices: ReadonlyArray<string | IPromptChoice>, progress?: IInteractiveProgress): Promise<string>;
 //# sourceMappingURL=interaction.d.ts.map

package/core/interaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/core/interaction.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAG,UAAmB,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAG,cAAuB,CAAC;AAMhD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBnH"}
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/core/interaction.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAG,UAAmB,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAG,cAAuB,CAAC;AAMhD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AA6CD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC3C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CAWZ;AAyFD,wBAAsB,YAAY,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,EAC9C,QAAQ,CAAC,EAAE,oBAAoB,GAChC,OAAO,CAAC,MAAM,CAAC,CA6EjB"}

package/core/interaction.js

@@ -20,23 +20,158 @@ export const SKIP_ALL = '__skip_all__';
  * Returns the selected choice name string, or one of the sentinel values (SKIP / SKIP_ALL).
  * @public
  */
-export async function promptSelect(message, choices) {
+let _interactiveProgressState;
+const DEFAULT_KEY_ACTIONS = {
+    pageup: 'pageUp',
+    pagedown: 'pageDown',
+    home: 'home',
+    end: 'end',
+    cancel: 'cancel',
+    delete: 'deleteForward',
+    backspace: 'delete',
+    down: 'down',
+    enter: 'submit',
+    escape: 'cancel',
+    left: 'left',
+    space: 'space',
+    number: 'number',
+    return: 'submit',
+    right: 'right',
+    tab: 'next',
+    up: 'up',
+};
+/**
+ * @description Runs an interactive session with a global progress state.
+ * Every `promptSelect()` call inside the callback automatically advances and renders the footer status.
+ * @public
+ */
+export async function withInteractiveProgress(total, callback) {
+    _interactiveProgressState = {
+        current: 0,
+        total: Math.max(total, 0),
+    };
+    try {
+        return await callback();
+    }
+    finally {
+        _interactiveProgressState = undefined;
+    }
+}
+function getProgressFooter(progress) {
+    if (progress) {
+        return `[${progress.current}/${progress.total}]`;
+    }
+    if (!_interactiveProgressState || _interactiveProgressState.total <= 0) {
+        return undefined;
+    }
+    _interactiveProgressState.current = Math.min(_interactiveProgressState.current + 1, _interactiveProgressState.total);
+    return `[${_interactiveProgressState.current}/${_interactiveProgressState.total}]`;
+}
+function addShortcutHint(choice, shortcut) {
+    const shortcutHint = `[${shortcut.toUpperCase()}]`;
+    if (!choice.hint) {
+        choice.hint = shortcutHint;
+        return;
+    }
+    if (!choice.hint.includes(shortcutHint)) {
+        choice.hint = `${choice.hint} ${shortcutHint}`;
+    }
+}
+function sanitizeShortcut(value) {
+    const normalized = value.trim().toLowerCase();
+    if (!/^[a-z0-9]$/.test(normalized)) {
+        return undefined;
+    }
+    return normalized;
+}
+function getPreferredShortcut(message, usedShortcuts) {
+    for (const character of message.toLowerCase()) {
+        if (!/^[a-z0-9]$/.test(character)) {
+            continue;
+        }
+        if (usedShortcuts.has(character)) {
+            continue;
+        }
+        return character;
+    }
+    return undefined;
+}
+function selectChoiceByName(promptInstance, choiceName) {
+    const index = promptInstance.findIndex(choiceName);
+    if (index >= 0) {
+        promptInstance.index = index;
+        return promptInstance.submit();
+    }
+    promptInstance.alert();
+}
+function applyShortcut(choice, shortcut, usedShortcuts, keyActions, actionHandlers) {
+    const actionName = `shortcut_${shortcut}`;
+    choice.shortcut = shortcut;
+    addShortcutHint(choice, shortcut);
+    usedShortcuts.add(shortcut);
+    keyActions[shortcut] = actionName;
+    actionHandlers[actionName] = function () {
+        return selectChoiceByName(this, choice.name);
+    };
+}
+export async function promptSelect(message, choices, progress) {
     const normalizedChoices = choices.map(choice => {
         if (typeof choice === 'string') {
             return { name: choice, message: choice };
         }
-        return choice;
+        return {
+            name: choice.name,
+            message: choice.message,
+            hint: choice.hint,
+            shortcut: choice.shortcut,
+        };
     });
+    const keyActions = { ...DEFAULT_KEY_ACTIONS };
+    const actionHandlers = {};
+    const usedShortcuts = new Set(['s', 'a']);
+    const deleteChoice = normalizedChoices.find(choice => /delete/i.test(choice.message) || /delete/i.test(choice.name));
+    if (deleteChoice) {
+        applyShortcut(deleteChoice, 'd', usedShortcuts, keyActions, actionHandlers);
+    }
+    for (const choice of normalizedChoices) {
+        if (choice.shortcut) {
+            const explicitShortcut = sanitizeShortcut(choice.shortcut);
+            if (explicitShortcut && !usedShortcuts.has(explicitShortcut)) {
+                applyShortcut(choice, explicitShortcut, usedShortcuts, keyActions, actionHandlers);
+                continue;
+            }
+        }
+        if (choice.shortcut) {
+            continue;
+        }
+        const preferredShortcut = getPreferredShortcut(choice.message, usedShortcuts);
+        if (preferredShortcut) {
+            applyShortcut(choice, preferredShortcut, usedShortcuts, keyActions, actionHandlers);
+        }
+    }
     const allChoices = [
         ...normalizedChoices,
-        { name: SKIP, message: 'Skip' },
-        { name: SKIP_ALL, message: 'Skip all remaining' },
+        { name: SKIP, message: 'Skip', hint: '[S]', shortcut: 's' },
+        { name: SKIP_ALL, message: 'Skip all remaining', hint: '[A]', shortcut: 'a' },
     ];
+    actionHandlers['shortcut_s'] = function () {
+        return selectChoiceByName(this, SKIP);
+    };
+    actionHandlers['shortcut_a'] = function () {
+        return selectChoiceByName(this, SKIP_ALL);
+    };
+    keyActions['s'] = 'shortcut_s';
+    keyActions['a'] = 'shortcut_a';
     const options = {
         type: 'select',
         name: 'action',
         message,
         choices: allChoices,
+        footer: getProgressFooter(progress),
+        actions: {
+            keys: keyActions,
+        },
+        ...actionHandlers,
     };
     const result = await prompt(options);
     return result.action;

package/core/interaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/core/interaction.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;AAE5B,aAAa;AAEb,oBAAoB;AAEpB;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,UAAmB,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAuB,CAAC;AAehD,aAAa;AAEb,oBAAoB;AAEpB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,OAA8C;IAC9F,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7C,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG;QACf,GAAG,iBAAiB;QACpB,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;QAC/B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE;KACpD,CAAC;IAEF,MAAM,OAAO,GAAY;QACrB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,OAAO;QACP,OAAO,EAAE,UAAU;KACtB,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAqB,OAAuC,CAAC,CAAC;IAEzF,OAAO,MAAM,CAAC,MAAM,CAAC;AACzB,CAAC;AAED,aAAa"}
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/core/interaction.ts"],"names":[],"mappings":"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"}

package/core/resolver.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @description Represents a single resolved design token with its CSS custom property name, value, and type.
+ * @public
+ */
+export interface IResolvedToken {
+    /** The camelCase token key as defined in the JSON (e.g. `backgroundColor`). */
+    readonly key: string;
+    /** The token value (e.g. `var(--joy-scheme-background)` or `solid`). */
+    readonly value: string | string[];
+    /** The optional type annotation from the token JSON (e.g. `color`, `alias`). */
+    readonly type: string | undefined;
+}
+/**
+ * @description Options for resolving component tokens.
+ * @public
+ */
+export interface ITokenResolverOptions {
+    /** Absolute path to the component token JSON file. */
+    readonly componentFilePath: string;
+    /** Absolute path to the base `components.json` file. */
+    readonly baseTokensPath: string;
+    /** Absolute path to the mixins directory. */
+    readonly mixinsDir: string;
+}
+/**
+ * @description Resolves all design tokens for a component by merging base tokens, mixin tokens,
+ * and component-specific tokens. Handles `$includes` with optional prefix syntax (e.g. `color:background`).
+ * @public
+ */
+export declare namespace TokenResolver {
+    /**
+     * @description Resolves all tokens for a component, merging base → mixins → component overrides.
+     * @param options - The resolver options containing file paths.
+     * @returns An array of resolved tokens sorted alphabetically by key.
+     * @public
+     */
+    function resolve(options: ITokenResolverOptions): IResolvedToken[];
+}
+//# sourceMappingURL=resolver.d.ts.map

package/core/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,sDAAsD;IACtD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,yBAAiB,aAAa,CAAC;IAI3B;;;;;OAKG;IACH,SAAgB,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAiBxE;CA0IJ"}

package/core/resolver.js

@@ -0,0 +1,138 @@
+// #region Imports
+import * as fs from 'fs';
+import * as path from 'path';
+import { isTokenValue } from '../utils.js';
+/**
+ * @description Resolves all design tokens for a component by merging base tokens, mixin tokens,
+ * and component-specific tokens. Handles `$includes` with optional prefix syntax (e.g. `color:background`).
+ * @public
+ */
+export var TokenResolver;
+(function (TokenResolver) {
+    // #region Methods
+    /**
+     * @description Resolves all tokens for a component, merging base → mixins → component overrides.
+     * @param options - The resolver options containing file paths.
+     * @returns An array of resolved tokens sorted alphabetically by key.
+     * @public
+     */
+    function resolve(options) {
+        const baseTokens = _readJson(options.baseTokensPath);
+        const componentTokens = _readJson(options.componentFilePath);
+        const mixinTokens = _resolveMixinTokens(componentTokens['$includes'], options.mixinsDir);
+        // Remove $includes from component tokens before merge
+        const cleanComponentTokens = { ...componentTokens };
+        delete cleanComponentTokens['$includes'];
+        // Merge order: base (lowest) → mixins → component (highest)
+        const merged = _deepAssign(_deepAssign(baseTokens, mixinTokens), cleanComponentTokens);
+        return _flattenToResolvedTokens(merged).sort((a, b) => a.key.localeCompare(b.key));
+    }
+    TokenResolver.resolve = resolve;
+    // #endregion
+    // #region Private
+    /**
+     * @description Reads and parses a JSON file.
+     */
+    function _readJson(filePath) {
+        if (!fs.existsSync(filePath)) {
+            return {};
+        }
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        try {
+            return JSON.parse(raw);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to parse JSON file "${filePath}": ${message}`);
+        }
+    }
+    /**
+     * @description Resolves mixin tokens from the `$includes` array.
+     * Handles the `name:prefix` syntax (e.g. `color:background` → `backgroundColor`).
+     */
+    function _resolveMixinTokens(includes, mixinsDir) {
+        const result = {};
+        if (!includes) {
+            return result;
+        }
+        for (const entry of includes) {
+            let mixinName = entry;
+            let prefix;
+            if (entry.includes(':')) {
+                const [name, pfx] = entry.split(':');
+                mixinName = name;
+                prefix = pfx;
+            }
+            const mixinPath = path.join(mixinsDir, `${mixinName}.json`);
+            if (!fs.existsSync(mixinPath)) {
+                continue;
+            }
+            const mixinJson = _readJson(mixinPath);
+            if (prefix) {
+                for (const [key, value] of Object.entries(mixinJson)) {
+                    if (key.startsWith('$')) {
+                        continue;
+                    }
+                    const prefixedKey = prefix + key.charAt(0).toUpperCase() + key.slice(1);
+                    result[prefixedKey] = value;
+                }
+            }
+            else {
+                for (const [key, value] of Object.entries(mixinJson)) {
+                    if (key.startsWith('$')) {
+                        continue;
+                    }
+                    result[key] = value;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * @description Flattens merged token content into an array of resolved tokens.
+     * Handles both flat token values and nested token groups.
+     */
+    function _flattenToResolvedTokens(content, prefix) {
+        const tokens = [];
+        for (const [key, val] of Object.entries(content)) {
+            if (key.startsWith('$')) {
+                continue;
+            }
+            const fullKey = prefix ? `${prefix}.${key}` : key;
+            if (isTokenValue(val)) {
+                const tokenObj = val;
+                const value = tokenObj.value;
+                tokens.push({
+                    key: fullKey,
+                    value: Array.isArray(value)
+                        ? value.map(String)
+                        : String(value),
+                    type: typeof tokenObj.type === 'string' ? tokenObj.type : undefined,
+                });
+            }
+            else if (typeof val === 'object' && val !== null) {
+                tokens.push(..._flattenToResolvedTokens(val, fullKey));
+            }
+        }
+        return tokens;
+    }
+    /**
+     * @description Deep-assigns source properties onto the target, recursively merging nested objects.
+     */
+    function _deepAssign(target, source) {
+        const result = { ...target };
+        for (const [key, sourceVal] of Object.entries(source)) {
+            const targetVal = result[key];
+            if (typeof sourceVal === 'object' && sourceVal !== null && !Array.isArray(sourceVal) && !('value' in sourceVal)
+                && typeof targetVal === 'object' && targetVal !== null && !Array.isArray(targetVal) && !('value' in targetVal)) {
+                result[key] = _deepAssign(targetVal, sourceVal);
+            }
+            else {
+                result[key] = sourceVal;
+            }
+        }
+        return result;
+    }
+    // #endregion
+})(TokenResolver || (TokenResolver = {}));
+//# sourceMappingURL=resolver.js.map

package/core/resolver.js.map

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

package/core/runner.d.ts

@@ -13,9 +13,9 @@ export declare namespace LintRunner {
      * Rules not listed in the config are not executed (opt-in model).
      *
      * Execution phases per rule:
-     * 1. **Detect** — `rule.run()` identifies findings (side-effect free).
-     * 2. **Fix** — `rule.fix()` auto-fixes findings (only when `config.fix` is enabled and `rule.fixable` is `true`).
-     * 3. **Interact** — `rule.interact()` prompts the user for resolution of remaining findings
+     * 1. **Detect** - `rule.run()` identifies findings (side-effect free).
+     * 2. **Fix** - `rule.fix()` auto-fixes findings (only when `config.fix` is enabled and `rule.fixable` is `true`).
+     * 3. **Interact** - `rule.interact()` prompts the user for resolution of remaining findings
      *    (only when `config.interactive` is enabled and `rule.interactive` is `true`).
      */
     function run(registry: RuleRegistry, config: ITokenLinterConfig, entries: ReadonlyArray<ITokenEntry>, mixinNames: ReadonlyArray<string>, mixinKeys: ReadonlyMap<string, ReadonlyArray<string>>, logger: ILogger): Promise<ILintResult>;

package/core/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;GAGG;AACH,yBAAiB,UAAU,CAAC;IAIxB;;;;;;;;;OASG;IACH,SAAsB,GAAG,CACrB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,EACnC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EACjC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,EACrD,MAAM,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,CA2GtB;CAGJ"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;GAGG;AACH,yBAAiB,UAAU,CAAC;IAIxB;;;;;;;;;OASG;IACH,SAAsB,GAAG,CACrB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,EACnC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EACjC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,EACrD,MAAM,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,CA8GtB;CAGJ"}

package/core/runner.js

@@ -1,5 +1,6 @@
 // #region Imports
 import { RuleSeverity } from '../models/rule-severity.js';
+import { withInteractiveProgress } from './interaction.js';
 // #endregion
 /**
  * @description Orchestrates 3-phase rule execution (detect → fix → interact), severity overrides, and result aggregation.
@@ -13,9 +14,9 @@ export var LintRunner;
      * Rules not listed in the config are not executed (opt-in model).
      *
      * Execution phases per rule:
-     * 1. **Detect** — `rule.run()` identifies findings (side-effect free).
-     * 2. **Fix** — `rule.fix()` auto-fixes findings (only when `config.fix` is enabled and `rule.fixable` is `true`).
-     * 3. **Interact** — `rule.interact()` prompts the user for resolution of remaining findings
+     * 1. **Detect** - `rule.run()` identifies findings (side-effect free).
+     * 2. **Fix** - `rule.fix()` auto-fixes findings (only when `config.fix` is enabled and `rule.fixable` is `true`).
+     * 3. **Interact** - `rule.interact()` prompts the user for resolution of remaining findings
      *    (only when `config.interactive` is enabled and `rule.interactive` is `true`).
      */
     async function run(registry, config, entries, mixinNames, mixinKeys, logger) {
@@ -39,7 +40,7 @@ export var LintRunner;
             }
             const rule = registry.getByName(ruleName);
             if (!rule) {
-                logger.warn(`Unknown rule '${ruleName}' in configuration — skipping.`);
+                logger.warn(`Unknown rule '${ruleName}' in configuration - skipping.`);
                 continue;
             }
             const effectiveSeverity = severityOrOff;
@@ -70,7 +71,7 @@ export var LintRunner;
             if (config.interactive && rule.interactive && rule.interact) {
                 const unfixed = findings.filter(f => !f.fixed);
                 if (unfixed.length > 0) {
-                    const interactedFindings = await rule.interact(context, unfixed);
+                    const interactedFindings = await withInteractiveProgress(unfixed.length, async () => rule.interact(context, unfixed));
                     const interactedSet = new Set(unfixed);
                     findings = findings
                         .filter(f => !interactedSet.has(f))

package/core/runner.js.map

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

package/index.d.ts

@@ -8,6 +8,7 @@ export * from './models/token-linter-config.js';
 export * from './utils.js';
 export * from './core/interaction.js';
 export * from './core/loader.js';
+export * from './core/resolver.js';
 export * from './core/rule-registry.js';
 export * from './core/rule.js';
 export * from './core/runner.js';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAGhD,cAAc,YAAY,CAAC;AAG3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAChG,YAAY,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACvF,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACtG,YAAY,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAGpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAGhD,cAAc,YAAY,CAAC;AAG3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAChG,YAAY,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACvF,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACtG,YAAY,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAGpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC"}

package/index.js

@@ -11,6 +11,7 @@ export * from './utils.js';
 // Core
 export * from './core/interaction.js';
 export * from './core/loader.js';
+export * from './core/resolver.js';
 export * from './core/rule-registry.js';
 export * from './core/rule.js';
 export * from './core/runner.js';

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAEhD,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,OAAO;AACP,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAEhG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAEtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGjF,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAEpF,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAEhD,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,OAAO;AACP,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAEhG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAEtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGjF,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAEpF,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC"}

package/models/rule-finding.d.ts

@@ -10,6 +10,7 @@ export interface IRuleFinding {
     readonly message: string;
     readonly severity: RuleSeverity;
     readonly filePath?: string;
+    readonly line?: number;
     readonly fixed: boolean;
 }
 //# sourceMappingURL=rule-finding.d.ts.map

package/models/rule-finding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-finding.d.ts","sourceRoot":"","sources":["../../src/models/rule-finding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B"}
+{"version":3,"file":"rule-finding.d.ts","sourceRoot":"","sources":["../../src/models/rule-finding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B"}

package/orchestration/TokenLinterOrchestrator.js

@@ -47,7 +47,7 @@ export class TokenLinterOrchestrator {
      * @description Runs the token linter with an explicitly provided config.
      */
     async execute(rootPath, config) {
-        this._logger.info('Token Linter — Starting analysis...');
+        this._logger.info('Token Linter - Starting analysis...');
         const tokensBasePath = path.resolve(rootPath, config.tokensDir);
         const mixinsBasePath = path.resolve(rootPath, config.mixinsDir);
         // Load data

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@breadstone-infrastructure/token-linter",
     "description": "A configurable, extensible linter for Style Dictionary token JSON files. Validates structure, consistency, naming, and values across themes.",
-    "version": "0.0.231",
+    "version": "0.0.232",
     "license": "MIT",
     "author": "andre.wehlert <awehlert@breadstone.de> (https://www.breadstone.de)",
     "repository": {
@@ -10,11 +10,12 @@
     "type": "module",
     "main": "./index.js",
     "types": "./index.d.ts",
-    "bin": "./bin/token-linter.js",
+    "bin": {
+        "tokenlinter": "./bin/tokenlinter.js"
+    },
     "dependencies": {
-        "@breadstone-infrastructure/utilities": "0.0.231",
+        "@breadstone-infrastructure/utilities": "0.0.232",
         "enquirer": "^2.4.1",
-        "glob": "13.0.6",
         "tslib": "2.8.1"
     }
 }

package/presets/recommended.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommended.d.ts","sourceRoot":"","sources":["../../src/presets/recommended.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAiB9D,CAAC"}
+{"version":3,"file":"recommended.d.ts","sourceRoot":"","sources":["../../src/presets/recommended.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAkB9D,CAAC"}

package/presets/recommended.js

@@ -26,6 +26,7 @@ export const recommended = {
     'includes-consistency': 'warning',
     'missing-includes': 'warning',
     'required-includes': 'error',
+    'redundant-mixin-override': 'warning',
     'empty-json': 'warning',
     'forbidden-value': 'warning',
     'forbidden-key': 'warning',

package/presets/recommended.js.map

@@ -1 +1 @@
-{"version":3,"file":"recommended.js","sourceRoot":"","sources":["../../src/presets/recommended.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAIlB,aAAa;AAEb;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,WAAW,GAA2C;IAC/D,oBAAoB,EAAE,OAAO;IAC7B,iBAAiB,EAAE,OAAO;IAC1B,sBAAsB,EAAE,SAAS;IACjC,kBAAkB,EAAE,SAAS;IAC7B,mBAAmB,EAAE,OAAO;IAC5B,YAAY,EAAE,SAAS;IACvB,iBAAiB,EAAE,SAAS;IAC5B,eAAe,EAAE,SAAS;IAC1B,mBAAmB,EAAE,SAAS;IAC9B,cAAc,EAAE,MAAM;IACtB,YAAY,EAAE,OAAO;IACrB,mBAAmB,EAAE,MAAM;IAC3B,iBAAiB,EAAE,MAAM;IACzB,cAAc,EAAE,SAAS;IACzB,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,SAAS;CACjC,CAAC"}
+{"version":3,"file":"recommended.js","sourceRoot":"","sources":["../../src/presets/recommended.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAIlB,aAAa;AAEb;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,WAAW,GAA2C;IAC/D,oBAAoB,EAAE,OAAO;IAC7B,iBAAiB,EAAE,OAAO;IAC1B,sBAAsB,EAAE,SAAS;IACjC,kBAAkB,EAAE,SAAS;IAC7B,mBAAmB,EAAE,OAAO;IAC5B,0BAA0B,EAAE,SAAS;IACrC,YAAY,EAAE,SAAS;IACvB,iBAAiB,EAAE,SAAS;IAC5B,eAAe,EAAE,SAAS;IAC1B,mBAAmB,EAAE,SAAS;IAC9B,cAAc,EAAE,MAAM;IACtB,YAAY,EAAE,OAAO;IACrB,mBAAmB,EAAE,MAAM;IAC3B,iBAAiB,EAAE,MAAM;IACzB,cAAc,EAAE,SAAS;IACzB,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,SAAS;CACjC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"console.reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/console.reporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,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;IAUxC,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,cAAc;CAczB"}
+{"version":3,"file":"console.reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/console.reporter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,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;IAUxC,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,cAAc;CAczB"}