@breadstone-infrastructure/token-linter 0.0.231

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+## 0.0.231 (2026-03-14)
+
+### 🚀 Features
+
+- **cli:** integrate CliParser for improved argument parsing and build scripts ([23b1773dce](https://github.com/RueDeRennes/mosaik/commit/23b1773dce))
+- **cli:** implement Prisma Seeds CLI with argument configuration and commands ([d7d3ab6ff9](https://github.com/RueDeRennes/mosaik/commit/d7d3ab6ff9))
+- **token-linter:** enhance rule options with detailed interfaces and functions ([396600ab78](https://github.com/RueDeRennes/mosaik/commit/396600ab78))
+- **buttons): add ripple prop to button components and related updates feat(components): implement ripple behavior in various components fix(theme:** remove duplicate ripple property in theme JSON files ([d31f695f82](https://github.com/RueDeRennes/mosaik/commit/d31f695f82))
+- **McpToolRegistrar): add overview and framework guide tools with enhanced descriptions feat(package:** update dependencies across multiple packages to latest versions ([45bc8fb4f6](https://github.com/RueDeRennes/mosaik/commit/45bc8fb4f6))
+- **Button, Banner:** add shadow properties and update related styles and tokens ([5d69398b19](https://github.com/RueDeRennes/mosaik/commit/5d69398b19))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 andre.wehlert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @breadstone-infrastructure/token-linter
+
+A configurable, extensible linter for **Style Dictionary** token JSON files. Validates structure, consistency, naming, and values across themes.
+
+## Features
+
+- **14 built-in rules** covering structural, quality, and formatting concerns
+- **Config-file driven** — place a `tokenlinter.config.mjs` in your project
+- **Rule severity overrides** — set rules to `error`, `warning`, `info`, or `off`
+- **Auto-fix support** — fixable rules (alphabetical sort, missing includes) can write corrections
+- **Multiple reporters** — console (colored), JSON (CI), summary (compact)
+- **Extensible** — register custom rules via the public `IRule` interface
+- **Standalone** — usable as a library, CLI, or via Nx executor
+
+## Usage
+
+### Config file (`tokenlinter.config.mjs`)
+
+```js
+import { defineConfig } from '@breadstone-infrastructure/token-linter';
+
+export default defineConfig({
+  themes: ['joy', 'memphis', 'cosmopolitan'],
+  tokensDir: 'tokens/themes',
+  mixinsDir: 'tokens/mixins',
+  reporter: 'console',
+  rules: {
+    'forbidden-value': 'warning',
+    'empty-json': 'off',
+  },
+  ruleOptions: {
+    'forbidden-key': { keys: ['transition', 'shadow'], themes: ['memphis'] },
+    'nested-depth': { maxDepth: 3 },
+  },
+});
+```
+
+### Nx Executor
+
+```jsonc
+{
+  "token-lint": {
+    "executor": "@breadstone-infrastructure/nx-tasks:token-linter",
+    "options": {
+      "configFile": "tokenlinter.config.mjs"
+    }
+  }
+}
+```
+
+## Built-in Rules
+
+| Rule | Default Severity | Fixable | Description |
+|---|---|---|---|
+| `component-presence` | error | — | All themes contain the same component files |
+| `key-consistency` | error | — | Same keys per component across themes |
+| `includes-consistency` | warning | — | `$includes` arrays match across themes |
+| `missing-includes` | warning | ✓ | All files have a `$includes` field |
+| `empty-json` | warning | — | No empty token files |
+| `forbidden-value` | warning | — | No forbidden values (unset, 0px, all) |
+| `forbidden-key` | warning | — | No forbidden keys (configurable) |
+| `naming-convention` | warning | — | camelCase token keys |
+| `value-schema` | info | — | Values match CSS patterns |
+| `value-consistency` | info | — | var() vs hardcoded drift detection |
+| `duplicate-value` | info | — | Duplicate values that could be shared |
+| `nested-depth` | warning | — | Max nesting depth enforcement |
+| `mixin-reference` | error | — | `$includes` refs point to real mixins |
+| `alphabetical-sort` | warning | ✓ | Keys sorted alphabetically |
+
+## License
+
+MIT

package/cli/Cli.d.ts

@@ -0,0 +1,10 @@
+import { Program } from '@breadstone-infrastructure/utilities';
+import { type ICliArgsConfig } from './CliArgsConfig.js';
+/**
+ * @description Token Linter CLI application.
+ * @public
+ */
+export declare class Cli extends Program<ICliArgsConfig> {
+    constructor();
+}
+//# sourceMappingURL=Cli.d.ts.map

package/cli/Cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cli.d.ts","sourceRoot":"","sources":["../../src/cli/Cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMlF;;;GAGG;AACH,qBAAa,GAAI,SAAQ,OAAO,CAAC,cAAc,CAAC;;CA2B/C"}

package/cli/Cli.js

@@ -0,0 +1,32 @@
+// #region Imports
+import { Program } from '@breadstone-infrastructure/utilities';
+import { CLI_ARGS } from './CliArgs.js';
+import { DEFAULT_CLI_ARGS_CONFIG } from './CliArgsConfig.js';
+import { LintCommand } from './commands/LintCommand.js';
+import { DEFAULT_LINT_COMMAND_ARGS_CONFIG } from './commands/LintCommandArgsConfig.js';
+// #endregion
+/**
+ * @description Token Linter CLI application.
+ * @public
+ */
+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.',
+            version: '@@VERSION',
+            addHelp: true,
+            debug: true,
+        });
+        this.config
+            .assign(DEFAULT_CLI_ARGS_CONFIG);
+        this.args
+            .register(...CLI_ARGS);
+        const lintCtorFn = () => [DEFAULT_LINT_COMMAND_ARGS_CONFIG];
+        this.commands
+            .register('lint', LintCommand, lintCtorFn);
+    }
+}
+//# sourceMappingURL=Cli.js.map

package/cli/Cli.js.map

@@ -0,0 +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"}

package/cli/CliArgs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CliArgs.d.ts.map

package/cli/CliArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliArgs.d.ts","sourceRoot":"","sources":["../../src/cli/CliArgs.ts"],"names":[],"mappings":""}

package/cli/CliArgs.js

@@ -0,0 +1,88 @@
+// #region Imports
+import { Boolean } from '@breadstone-infrastructure/utilities';
+import { DEFAULT_CLI_ARGS_CONFIG } from './CliArgsConfig.js';
+// #endregion
+// #region Arguments
+/**
+ * @description Enables auto-fix for fixable rule violations.
+ * @internal
+ */
+export const FIX_ARG = {
+    alias: ['-f', '--fix'],
+    options: {
+        type: (value) => Boolean.parse(value),
+        required: false,
+        default: DEFAULT_CLI_ARGS_CONFIG.fix,
+        metavar: 'boolean',
+        help: 'Enables auto-fix for fixable rule violations.',
+    },
+};
+/**
+ * @description Enables verbose logging output.
+ * @internal
+ */
+export const VERBOSE_ARG = {
+    alias: ['-v', '--verbose'],
+    options: {
+        type: (value) => Boolean.parse(value),
+        required: false,
+        default: DEFAULT_CLI_ARGS_CONFIG.verbose,
+        metavar: 'boolean',
+        help: 'Enables verbose logging output.',
+    },
+};
+/**
+ * @description Enables interactive mode for rule resolution.
+ * @internal
+ */
+export const INTERACTIVE_ARG = {
+    alias: ['-i', '--interactive'],
+    options: {
+        type: (value) => Boolean.parse(value),
+        required: false,
+        default: DEFAULT_CLI_ARGS_CONFIG.interactive,
+        metavar: 'boolean',
+        help: 'Enables interactive mode for rule resolution.',
+    },
+};
+/**
+ * @description Sets the reporter type for output formatting.
+ * @internal
+ */
+export const REPORTER_ARG = {
+    alias: ['-r', '--reporter'],
+    options: {
+        required: false,
+        default: DEFAULT_CLI_ARGS_CONFIG.reporter,
+        metavar: 'string',
+        help: 'Sets the reporter type (console, json, summary).',
+    },
+};
+/**
+ * @description Sets the current working directory.
+ * @internal
+ */
+export const CWD_ARG = {
+    alias: ['-c', '--cwd'],
+    options: {
+        required: false,
+        default: DEFAULT_CLI_ARGS_CONFIG.cwd,
+        metavar: 'string',
+        help: 'Specifies the current working directory for config discovery.',
+    },
+};
+// #endregion
+// #region Exports
+/**
+ * @description Aggregate export for all CLI arguments.
+ * @internal
+ */
+export const CLI_ARGS = [
+    FIX_ARG,
+    VERBOSE_ARG,
+    INTERACTIVE_ARG,
+    REPORTER_ARG,
+    CWD_ARG,
+];
+// #endregion
+//# sourceMappingURL=CliArgs.js.map

package/cli/CliArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliArgs.js","sourceRoot":"","sources":["../../src/cli/CliArgs.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,OAAO,EAAoB,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,aAAa;AAEb,oBAAoB;AAEpB;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAgB;IAChC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE;QACL,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7C,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,uBAAuB,CAAC,GAAG;QACpC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,+CAA+C;KACxD;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB;IACpC,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC;IAC1B,OAAO,EAAE;QACL,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7C,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,uBAAuB,CAAC,OAAO;QACxC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,iCAAiC;KAC1C;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB;IACxC,KAAK,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC;IAC9B,OAAO,EAAE;QACL,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7C,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,uBAAuB,CAAC,WAAW;QAC5C,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,+CAA+C;KACxD;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAgB;IACrC,KAAK,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE;QACL,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,uBAAuB,CAAC,QAAQ;QACzC,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,kDAAkD;KAC3D;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAgB;IAChC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE;QACL,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,uBAAuB,CAAC,GAAG;QACpC,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,+DAA+D;KACxE;CACJ,CAAC;AAEF,aAAa;AAEb,kBAAkB;AAElB;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,OAAO;IACP,WAAW;IACX,eAAe;IACf,YAAY;IACZ,OAAO;CACV,CAAC;AAEF,aAAa"}

package/cli/CliArgsConfig.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CliArgsConfig.d.ts.map

package/cli/CliArgsConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliArgsConfig.d.ts","sourceRoot":"","sources":["../../src/cli/CliArgsConfig.ts"],"names":[],"mappings":""}

package/cli/CliArgsConfig.js

@@ -0,0 +1,12 @@
+/**
+ * @description Default CLI argument values.
+ * @internal
+ */
+export const DEFAULT_CLI_ARGS_CONFIG = {
+    fix: false,
+    verbose: false,
+    interactive: false,
+    reporter: 'console',
+    cwd: process.cwd(),
+};
+//# sourceMappingURL=CliArgsConfig.js.map

package/cli/CliArgsConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliArgsConfig.js","sourceRoot":"","sources":["../../src/cli/CliArgsConfig.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACnD,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE,SAAS;IACnB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;CACrB,CAAC"}

package/cli/CliRun.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CliRun.d.ts.map

package/cli/CliRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliRun.d.ts","sourceRoot":"","sources":["../../src/cli/CliRun.ts"],"names":[],"mappings":""}

package/cli/CliRun.js

@@ -0,0 +1,34 @@
+// #region Imports
+import { ConsoleLogger } from '@breadstone-infrastructure/utilities';
+import { Cli } from './Cli.js';
+// #endregion
+const logger = new ConsoleLogger();
+/**
+ * @description Bootstrap the Token Linter CLI.
+ * @internal
+ */
+(async () => {
+    const catchAction = (error) => {
+        logger.error(String(error));
+    };
+    let cli = null;
+    try {
+        cli = new Cli();
+    }
+    catch (error) {
+        catchAction(error);
+        return;
+    }
+    try {
+        await cli.init();
+    }
+    catch (error) {
+        catchAction(error);
+        return;
+    }
+    await cli.run();
+})().catch((error) => {
+    logger.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=CliRun.js.map

package/cli/CliRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliRun.js","sourceRoot":"","sources":["../../src/cli/CliRun.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,aAAa;AAEb,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;AAEnC;;;GAGG;AACH,CAAC,KAAK,IAAI,EAAE;IACR,MAAM,WAAW,GAAG,CAAC,KAAY,EAAQ,EAAE;QACvC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,IAAI,GAAG,GAAe,IAAI,CAAC;IAC3B,IAAI,CAAC;QACD,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,WAAW,CAAC,KAAc,CAAC,CAAC;QAC5B,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,WAAW,CAAC,KAAc,CAAC,CAAC;QAC5B,OAAO;IACX,CAAC;IAED,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC1B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/cli/commands/LintCommand.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LintCommand.d.ts.map

package/cli/commands/LintCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LintCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/LintCommand.ts"],"names":[],"mappings":""}

package/cli/commands/LintCommand.js

@@ -0,0 +1,66 @@
+// #region Imports
+import { ProgramCommandBase } from '@breadstone-infrastructure/utilities';
+import { TokenLinterOrchestrator } from '../../orchestration/TokenLinterOrchestrator.js';
+import { DEFAULT_LINT_COMMAND_ARGS_CONFIG, LINT_COMMAND_ARGS } from './LintCommandArgsConfig.js';
+// #endregion
+/**
+ * @description CLI command that executes the token linter.
+ * @internal
+ */
+export class LintCommand extends ProgramCommandBase {
+    // #region Fields
+    _orchestrator;
+    // #endregion
+    // #region Ctor
+    constructor(config) {
+        super(config);
+        this._orchestrator = new TokenLinterOrchestrator();
+    }
+    // #endregion
+    // #region Properties
+    get name() {
+        return 'lint';
+    }
+    get args() {
+        return LINT_COMMAND_ARGS;
+    }
+    // #endregion
+    // #region Methods
+    configure(config) {
+        return Object.assign(this.config, DEFAULT_LINT_COMMAND_ARGS_CONFIG, super.configure(config));
+    }
+    async execute() {
+        const rootPath = this.config.cwd || process.cwd();
+        const overrides = {};
+        if (this.config.fix) {
+            overrides['fix'] = true;
+        }
+        if (this.config.verbose) {
+            overrides['verbose'] = true;
+        }
+        if (this.config.interactive) {
+            overrides['interactive'] = true;
+        }
+        if (this.config.reporter && this.config.reporter !== 'console') {
+            overrides['reporter'] = this.config.reporter;
+        }
+        if (this.config.tokensDir) {
+            overrides['tokensDir'] = this.config.tokensDir;
+        }
+        if (this.config.mixinsDir) {
+            overrides['mixinsDir'] = this.config.mixinsDir;
+        }
+        const hasOverrides = Object.keys(overrides).length > 0;
+        const result = hasOverrides
+            ? await this._orchestrator.executeWithOverrides(rootPath, overrides)
+            : await this._orchestrator.executeFromConfig(rootPath);
+        if (result.totalErrors > 0) {
+            return {
+                canceled: true,
+                error: Object.assign(new Error(`Token linting failed with ${result.totalErrors} error(s).`), { code: 1 }),
+            };
+        }
+        return { canceled: false, result };
+    }
+}
+//# sourceMappingURL=LintCommand.js.map

package/cli/commands/LintCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LintCommand.js","sourceRoot":"","sources":["../../../src/cli/commands/LintCommand.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAoB,kBAAkB,EAA6B,MAAM,sCAAsC,CAAC;AAEvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,gCAAgC,EAA+B,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE9H,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,kBAA0C;IAEvE,iBAAiB;IAEA,aAAa,CAA0B;IAExD,aAAa;IAEb,eAAe;IAEf,YAAmB,MAA8B;QAC7C,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,aAAa,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACvD,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB,IAAW,IAAI;QACX,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,IAAW,IAAI;QACX,OAAO,iBAAiB,CAAC;IAC7B,CAAC;IAED,aAAa;IAEb,kBAAkB;IAEF,SAAS,CAAC,MAA8B;QACpD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,gCAAgC,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACjG,CAAC;IAEe,KAAK,CAAC,OAAO;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAElD,MAAM,SAAS,GAA4B,EAAE,CAAC;QAE9C,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAClB,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1B,SAAS,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QACpC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC7D,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACxB,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACnD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACxB,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACnD,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,YAAY;YACvB,CAAC,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC;YACpE,CAAC,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE3D,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO;gBACH,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,WAAW,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;aAC5G,CAAC;QACN,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;CAGJ"}

package/cli/commands/LintCommandArgsConfig.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LintCommandArgsConfig.d.ts.map

package/cli/commands/LintCommandArgsConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LintCommandArgsConfig.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/LintCommandArgsConfig.ts"],"names":[],"mappings":""}

package/cli/commands/LintCommandArgsConfig.js

@@ -0,0 +1,46 @@
+// #region Imports
+import { DEFAULT_CLI_ARGS_CONFIG } from '../CliArgsConfig.js';
+/**
+ * @description Default lint command argument values.
+ * @internal
+ */
+export const DEFAULT_LINT_COMMAND_ARGS_CONFIG = {
+    ...DEFAULT_CLI_ARGS_CONFIG,
+    tokensDir: '',
+    mixinsDir: '',
+};
+/**
+ * @description Argument to override the tokens directory.
+ * @internal
+ */
+export const TOKENS_DIR_ARG = {
+    alias: ['-t', '--tokens-dir'],
+    options: {
+        required: false,
+        default: DEFAULT_LINT_COMMAND_ARGS_CONFIG.tokensDir,
+        metavar: 'string',
+        help: 'Overrides the tokens directory from the config file.',
+    },
+};
+/**
+ * @description Argument to override the mixins directory.
+ * @internal
+ */
+export const MIXINS_DIR_ARG = {
+    alias: ['-m', '--mixins-dir'],
+    options: {
+        required: false,
+        default: DEFAULT_LINT_COMMAND_ARGS_CONFIG.mixinsDir,
+        metavar: 'string',
+        help: 'Overrides the mixins directory from the config file.',
+    },
+};
+/**
+ * @description All lint command specific arguments.
+ * @internal
+ */
+export const LINT_COMMAND_ARGS = [
+    TOKENS_DIR_ARG,
+    MIXINS_DIR_ARG,
+];
+//# sourceMappingURL=LintCommandArgsConfig.js.map

package/cli/commands/LintCommandArgsConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LintCommandArgsConfig.js","sourceRoot":"","sources":["../../../src/cli/commands/LintCommandArgsConfig.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAGlB,OAAO,EAAE,uBAAuB,EAAuB,MAAM,qBAAqB,CAAC;AAanF;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA2B;IACpE,GAAG,uBAAuB;IAC1B,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC;IAC7B,OAAO,EAAE;QACL,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,gCAAgC,CAAC,SAAS;QACnD,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,sDAAsD;KAC/D;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC;IAC7B,OAAO,EAAE;QACL,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,gCAAgC,CAAC,SAAS;QACnD,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,sDAAsD;KAC/D;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACjD,cAAc;IACd,cAAc;CACjB,CAAC"}

package/cli/lint.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=lint.d.ts.map

package/cli/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/cli/lint.ts"],"names":[],"mappings":""}

package/cli/lint.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+// #region Imports
+import { ConsoleLogger } from '@breadstone-infrastructure/utilities';
+import { TokenLinterOrchestrator } from '../orchestration/TokenLinterOrchestrator.js';
+// #endregion
+/**
+ * @description CLI entry point for the token linter.
+ *
+ * Usage:
+ *   token-linter [rootPath]
+ *
+ * Options:
+ *   --fix       Auto-fix fixable rule violations
+ *   --verbose   Enable verbose logging
+ *
+ * The CLI discovers a `tokenlinter.config.mjs` file in the given root path (default: cwd).
+ */
+async function main() {
+    const logger = new ConsoleLogger();
+    const args = process.argv.slice(2);
+    // Parse flags
+    const fix = args.includes('--fix');
+    const verbose = args.includes('--verbose');
+    // Parse root path (first non-flag argument, default to cwd)
+    const rootPath = args.find(arg => !arg.startsWith('--')) ?? process.cwd();
+    const orchestrator = new TokenLinterOrchestrator(logger);
+    try {
+        const result = await orchestrator.executeFromConfig(rootPath);
+        // Override fix/verbose from CLI flags if provided
+        if (fix || verbose) {
+            const { TokenLinterConfigDiscovery } = await import('../config/TokenLinterConfigDiscovery.js');
+            const discovery = new TokenLinterConfigDiscovery();
+            const config = await discovery.discover(rootPath);
+            const mergedConfig = {
+                ...config,
+                fix: fix || config.fix,
+                verbose: verbose || config.verbose,
+            };
+            const overrideResult = await orchestrator.execute(rootPath, mergedConfig);
+            if (overrideResult.totalErrors > 0) {
+                process.exit(1);
+            }
+            return;
+        }
+        if (result.totalErrors > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        logger.error(`Token Linter failed: ${error.message}`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=lint.js.map

package/cli/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/cli/lint.ts"],"names":[],"mappings":";AAEA,kBAAkB;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,aAAa;AAEb;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,cAAc;IACd,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE3C,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1E,MAAM,YAAY,GAAG,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEzD,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE9D,kDAAkD;QAClD,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;YACjB,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAC;YAC/F,MAAM,SAAS,GAAG,IAAI,0BAA0B,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAElD,MAAM,YAAY,GAAG;gBACjB,GAAG,MAAM;gBACT,GAAG,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG;gBACtB,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO;aACrC,CAAC;YAEF,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAE1E,IAAI,cAAc,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YAED,OAAO;QACX,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,wBAAyB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

package/config/TokenLinterConfigDiscovery.d.ts

@@ -0,0 +1,16 @@
+import type { ITokenLinterConfig } from '../models/token-linter-config.js';
+/**
+ * @description Discovers and loads `tokenlinter.config.mjs` files from a given root path.
+ * @public
+ */
+export declare class TokenLinterConfigDiscovery {
+    private static readonly _CONFIG_FILE_NAME;
+    private readonly _fs;
+    constructor();
+    /**
+     * @description Discovers and loads the token linter config from the given root path.
+     */
+    discover(rootPath: string): Promise<ITokenLinterConfig>;
+    private loadConfig;
+}
+//# sourceMappingURL=TokenLinterConfigDiscovery.d.ts.map

package/config/TokenLinterConfigDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenLinterConfigDiscovery.d.ts","sourceRoot":"","sources":["../../src/config/TokenLinterConfigDiscovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAI3E;;;GAGG;AACH,qBAAa,0BAA0B;IAInC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IACrE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;;IAcjC;;OAEG;IACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAatD,UAAU;CAiB3B"}

package/config/TokenLinterConfigDiscovery.js

@@ -0,0 +1,44 @@
+// #region Imports
+import { FileSystem } from '@breadstone-infrastructure/utilities';
+// #endregion
+/**
+ * @description Discovers and loads `tokenlinter.config.mjs` files from a given root path.
+ * @public
+ */
+export class TokenLinterConfigDiscovery {
+    // #region Fields
+    static _CONFIG_FILE_NAME = 'tokenlinter.config.mjs';
+    _fs;
+    // #endregion
+    // #region Ctor
+    constructor() {
+        this._fs = new FileSystem();
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * @description Discovers and loads the token linter config from the given root path.
+     */
+    async discover(rootPath) {
+        const configPath = this._fs.pathCombine(rootPath, TokenLinterConfigDiscovery._CONFIG_FILE_NAME);
+        if (!this._fs.fileExists(configPath)) {
+            throw new Error(`No token linter config file found at: ${configPath}. ` +
+                `Create a '${TokenLinterConfigDiscovery._CONFIG_FILE_NAME}' file in your project root.`);
+        }
+        return this.loadConfig(configPath);
+    }
+    async loadConfig(configPath) {
+        const resolvedPath = this._fs.pathResolve(configPath);
+        if (!resolvedPath.endsWith('.mjs')) {
+            throw new Error(`Unsupported config file format: '${configPath}'. Only .mjs files are supported.`);
+        }
+        try {
+            const moduleResult = await import(resolvedPath);
+            return moduleResult.default || moduleResult;
+        }
+        catch (error) {
+            throw new Error(`Failed to load token linter config from ${resolvedPath}: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=TokenLinterConfigDiscovery.js.map

package/config/TokenLinterConfigDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenLinterConfigDiscovery.js","sourceRoot":"","sources":["../../src/config/TokenLinterConfigDiscovery.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAGlE,aAAa;AAEb;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAEnC,iBAAiB;IAET,MAAM,CAAU,iBAAiB,GAAG,wBAAwB,CAAC;IACpD,GAAG,CAAa;IAEjC,aAAa;IAEb,eAAe;IAEf;QACI,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAC;QAEhG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACX,yCAAyC,UAAU,IAAI;gBACvD,aAAa,0BAA0B,CAAC,iBAAiB,8BAA8B,CAC1F,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,UAAkB;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAEtD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,mCAAmC,CAAC,CAAC;QACvG,CAAC;QAED,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAEhD,OAAO,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2CAA2C,YAAY,KAAK,KAAK,EAAE,CAAC,CAAC;QACzF,CAAC;IACL,CAAC"}