@salesforce-ux/slds-linter 1.0.7 → 1.0.9-internal

package/build/commands/emit.js

@@ -1,6 +1,6 @@
 // src/commands/emit.ts
-import chalk from "chalk";
 import { Logger } from "../utils/logger.js";
+import { Colors } from "../utils/colors.js";
 import { normalizeCliOptions } from "../utils/config-utils.js";
 import {
   DEFAULT_ESLINT_CONFIG_PATH
@@ -47,20 +47,20 @@ function registerEmitCommand(program) {
     "Target directory to emit (defaults to current directory). Support glob patterns"
   ).action(async (options) => {
     try {
-      Logger.info(chalk.blue("Emitting configuration files..."));
+      Logger.info("Emitting configuration files...");
       const normalizedOptions = normalizeCliOptions(options, {
         configEslint: DEFAULT_ESLINT_CONFIG_PATH
       });
       const enhancedConfig = await generateEnhancedESLintConfig(normalizedOptions.configEslint);
       const destESLintConfigPath = path.join(normalizedOptions.directory, path.basename(normalizedOptions.configEslint));
       await writeFile(destESLintConfigPath, enhancedConfig, "utf8");
-      Logger.success(chalk.green(`ESLint configuration created at:
+      Logger.success(Colors.success(`ESLint configuration created at:
 ${destESLintConfigPath}
 `));
-      Logger.info(chalk.cyan("Rules are dynamically loaded based on extends configuration."));
+      Logger.info("Rules are dynamically loaded based on extends configuration.");
     } catch (error) {
       Logger.error(
-        chalk.red(`Failed to emit configuration: ${error.message}`)
+        Colors.error(`Failed to emit configuration: ${error.message}`)
       );
       process.exit(1);
     }

package/build/commands/lint.js

@@ -1,9 +1,9 @@
 // src/commands/lint.ts
 import { Option } from "commander";
-import chalk from "chalk";
 import { printLintResults } from "../utils/lintResultsUtil.js";
 import { normalizeCliOptions, normalizeDirectoryPath } from "../utils/config-utils.js";
 import { Logger } from "../utils/logger.js";
+import { Colors } from "../utils/colors.js";
 import { DEFAULT_ESLINT_CONFIG_PATH } from "../services/config.resolver.js";
 import { lint } from "../executor/index.js";
 function registerLintCommand(program) {
@@ -14,32 +14,25 @@ function registerLintCommand(program) {
   }).description("Run both style and component linting").argument("[directory]", "Target directory to scan (defaults to current directory). Support glob patterns").addOption(new Option("-d, --directory <path>", "Target directory to scan (defaults to current directory). Support glob patterns").hideHelp()).option("--fix", "Automatically fix problems").option("--config-eslint <path>", "Path to eslint config file").option("--editor <editor>", "Editor to open files with (e.g., vscode, atom, sublime). Auto-detects if not specified").action(async (directory, options) => {
     const startTime = Date.now();
     try {
-      Logger.info(chalk.blue("Starting lint process..."));
+      Logger.info("Starting lint process...");
       const normalizedOptions = normalizeCliOptions(options, {
         configEslint: DEFAULT_ESLINT_CONFIG_PATH
       });
       if (directory) {
         normalizedOptions.directory = normalizeDirectoryPath(directory);
       } else if (options.directory) {
-        Logger.newLine().warning(chalk.yellow(
+        Logger.newLine().warning(Colors.warning(
           `WARNING: --directory, -d option is deprecated. Supply as argument instead.
             Example: npx @salesforce-ux/slds-linter lint ${options.directory}`
         ));
       }
       const lintResults = await lint(normalizedOptions);
-      printLintResults(lintResults, normalizedOptions.editor);
-      const errorCount = lintResults.reduce((sum, r) => sum + r.errors.length, 0);
-      const warningCount = lintResults.reduce((sum, r) => sum + r.warnings.length, 0);
-      Logger.info(
-        `
-${chalk.red(`${errorCount} error${errorCount !== 1 ? "s" : ""}`)}  ${chalk.yellow(`${warningCount} warning${warningCount !== 1 ? "s" : ""}`)}`
-      );
+      const { totalErrors } = printLintResults(lintResults, normalizedOptions.editor);
       const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
-      Logger.success(chalk.green(`
-Linting completed in ${elapsedTime} seconds.`));
-      process.exit(errorCount > 0 ? 1 : 0);
+      Logger.newLine().success(`Linting completed in ${elapsedTime} seconds.`);
+      process.exit(totalErrors > 0 ? 1 : 0);
     } catch (error) {
-      Logger.error(chalk.red(`Failed to complete linting: ${error.message}`));
+      Logger.error(Colors.error(`Failed to complete linting: ${error.message}`));
       process.exit(1);
     }
   });

package/build/commands/report.js

@@ -2,10 +2,10 @@
 import { Option } from "commander";
 import path from "path";
 import ora from "ora";
-import chalk from "chalk";
 import fs from "fs";
 import { normalizeAndValidatePath, normalizeCliOptions, normalizeDirectoryPath } from "../utils/config-utils.js";
 import { Logger } from "../utils/logger.js";
+import { Colors } from "../utils/colors.js";
 import { DEFAULT_ESLINT_CONFIG_PATH } from "../services/config.resolver.js";
 import { report, lint } from "../executor/index.js";
 function registerReportCommand(program) {
@@ -19,7 +19,7 @@ function registerReportCommand(program) {
       if (directory) {
         normalizedOptions.directory = normalizeDirectoryPath(directory);
       } else if (options.directory) {
-        Logger.newLine().warning(chalk.yellow(
+        Logger.newLine().warning(Colors.warning(
           `WARNING: --directory, -d option is deprecated. Supply as argument instead.
             Example: npx @salesforce-ux/slds-linter report ${options.directory}`
         ));

package/build/executor/index.js

@@ -13,20 +13,25 @@ async function lint(config) {
     const normalizedConfig = normalizeCliOptions(config, {
       configEslint: DEFAULT_ESLINT_CONFIG_PATH
     });
-    const styleFiles = await FileScanner.scanFiles(normalizedConfig.directory, {
+    const { filesCount: styleFilesCount, batches: styleFiles } = await FileScanner.scanFiles(normalizedConfig.directory, {
       patterns: StyleFilePatterns,
       batchSize: 100
     });
-    const componentFiles = await FileScanner.scanFiles(normalizedConfig.directory, {
+    const { filesCount: componentFilesCount, batches: componentFiles } = await FileScanner.scanFiles(normalizedConfig.directory, {
       patterns: ComponentFilePatterns,
       batchSize: 100
     });
+    if (styleFilesCount > 0) {
+      Logger.info(`Total style files: ${styleFilesCount}`);
+    }
+    if (componentFilesCount > 0) {
+      Logger.info(`Total component files: ${componentFilesCount}`);
+    }
     const { fix, configEslint } = normalizedConfig;
-    const lintResults = await LintRunner.runLinting([...styleFiles, ...componentFiles], "component", {
+    return await LintRunner.runLinting([...styleFiles, ...componentFiles], {
       fix,
       configPath: configEslint
     });
-    return standardizeLintMessages(lintResults);
   } catch (error) {
     const errorMessage = `Linting failed: ${error.message}`;
     Logger.error(errorMessage);
@@ -64,33 +69,6 @@ async function report(config, results) {
     throw new Error(errorMessage);
   }
 }
-function standardizeLintMessages(results) {
-  return results.map((result) => ({
-    ...result,
-    errors: result.errors.map((entry) => {
-      let msgObj;
-      try {
-        msgObj = JSON.parse(entry.message);
-        if (typeof msgObj === "object" && "message" in msgObj) {
-          return { ...entry, ...msgObj };
-        }
-      } catch {
-      }
-      return { ...entry, message: entry.message };
-    }),
-    warnings: result.warnings.map((entry) => {
-      let msgObj;
-      try {
-        msgObj = JSON.parse(entry.message);
-        if (typeof msgObj === "object" && "message" in msgObj) {
-          return { ...entry, ...msgObj };
-        }
-      } catch {
-      }
-      return { ...entry, message: entry.message };
-    })
-  }));
-}
 export {
   lint,
   report

package/build/index.js

@@ -19,7 +19,7 @@ process.on("uncaughtException", (error) => {
 var program = new Command();
 program.name("npx @salesforce-ux/slds-linter@latest").showHelpAfterError();
 function registerVersion() {
-  program.description("SLDS Linter CLI tool for linting styles and components").version("1.0.7");
+  program.description("SLDS Linter CLI tool for linting styles and components").version("1.0.9-internal");
 }
 registerLintCommand(program);
 registerReportCommand(program);

package/build/services/batch-processor.js

@@ -2,6 +2,7 @@
 import { Worker } from "worker_threads";
 import os from "os";
 import { Logger } from "../utils/logger.js";
+import { ProgressHandler } from "./progress-handler.js";
 var AVAILABLE_CPUS = os.cpus().length - 1;
 var BatchProcessor = class {
   static DEFAULT_MAX_WORKERS = Math.max(1, Math.min(4, AVAILABLE_CPUS));
@@ -22,6 +23,7 @@ var BatchProcessor = class {
     const results = [];
     const activeWorkers = /* @__PURE__ */ new Set();
     let currentBatchIndex = 0;
+    const progress = new ProgressHandler({ total: batches.length });
     try {
       while (currentBatchIndex < batches.length || activeWorkers.size > 0) {
         while (activeWorkers.size < maxWorkers && currentBatchIndex < batches.length) {
@@ -36,6 +38,7 @@ var BatchProcessor = class {
           worker.on("message", (result) => {
             results.push(result);
             activeWorkers.delete(worker);
+            progress.increment();
             Logger.debug(`Completed batch ${batchIndex} of ${batches.length}`);
           }).on("error", (error) => {
             results.push({
@@ -44,6 +47,7 @@ var BatchProcessor = class {
               results: []
             });
             activeWorkers.delete(worker);
+            progress.increment();
             Logger.error(`Worker error in batch ${batchIndex}: ${error.message}`);
           }).on("exit", (code) => {
             if (code !== 0) {
@@ -54,8 +58,10 @@ var BatchProcessor = class {
         }
         await new Promise((resolve) => setTimeout(resolve, 100));
       }
+      progress.stop();
       return results;
     } catch (error) {
+      progress.stop();
       Logger.error(`Batch processing failed: ${error.message}`);
       throw error;
     } finally {

package/build/services/config.resolver.js

@@ -1,166 +1,12 @@
 // src/services/config.resolver.ts
 import { resolvePath } from "../utils/nodeVersionUtil.js";
-
-// yaml-file:/Users/ritesh.kumar2/Documents/projects/stylelint-sds/packages/eslint-plugin-slds/src/config/rule-messages.yml
-var rule_messages_default = {
-  "no-slds-class-overrides": {
-    "description": "Create new custom CSS classes instead of overriding SLDS selectors",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-class-overrides",
-    "type": "problem",
-    "messages": {
-      "sldsClassOverride": "Overriding .{{className}} isn't supported. To differentiate SLDS and custom classes, create a CSS class in your namespace. Examples: myapp-input, myapp-button."
-    }
-  },
-  "no-deprecated-slds-classes": {
-    "description": "Please replace the deprecated classes with a modern equivalent",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-slds-classes",
-    "type": "problem",
-    "messages": {
-      "deprecatedClass": "The class {{className}} is deprecated and not available in SLDS2. Please update to a supported class."
-    }
-  },
-  "no-deprecated-tokens-slds1": {
-    "description": "Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-tokens-slds1",
-    "type": "problem",
-    "messages": {
-      "deprecatedToken": "Consider removing {{oldValue}} or replacing it with {{newValue}}. Set the fallback to {{oldValue}}. For more info, see Styling Hooks on lightningdesignsystem.com.",
-      "noReplacement": "Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com."
-    }
-  },
-  "enforce-sds-to-slds-hooks": {
-    "description": "Convert your existing --sds styling hooks to --slds styling hooks. See lightningdesignsystem.com for more info.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-sds-to-slds-hooks",
-    "type": "problem",
-    "messages": {
-      "replaceSdsWithSlds": "Replace {{oldValue}} with {{suggestedMatch}} styling hook."
-    }
-  },
-  "enforce-bem-usage": {
-    "description": "Replace BEM double-dash syntax in class names with single underscore syntax",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-bem-usage",
-    "type": "problem",
-    "messages": {
-      "bemDoubleDash": "{{actual}} has been retired. Update it to the new name {{newValue}}.",
-      "fixBemNaming": "Update to correct BEM naming convention"
-    }
-  },
-  "modal-close-button-issue": {
-    "description": "Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#modal-close-button-issue",
-    "type": "problem",
-    "messages": {
-      "modalCloseButtonIssue": "Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint.",
-      "removeClass": "Remove the slds-button_icon-inverse class from the modal close button in components that use the SLDS modal blueprint.",
-      "changeVariant": "Change the variant attribute value from bare-inverse to bare in <lightning-button-icon> or <lightning-icon>.",
-      "removeVariant": "Remove the variant attribute from the <lightning-icon> component inside the <button> element.",
-      "ensureButtonClasses": "Add or move slds-button and slds-button_icon to the class attribute of the <button> element or <lightning-button-icon> component.",
-      "ensureSizeAttribute": "To size icons properly, set the size attribute \u200Cto large in the <lightning-icon> and <lightning-button-icon> components."
-    }
-  },
-  "no-deprecated-classes-slds2": {
-    "description": "Replace classes that aren't available with SLDS 2 classes",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-classes-slds2",
-    "type": "problem",
-    "messages": {
-      "deprecatedClass": "The class {{className}} isn't available in SLDS 2. Update it to a class supported in SLDS 2. See lightningdesignsystem.com for more information.",
-      "updateToModernClass": "Replace deprecated class with modern equivalent",
-      "checkDocumentation": "See lightningdesignsystem.com for SLDS 2 class alternatives"
-    }
-  },
-  "lwc-token-to-slds-hook": {
-    "description": "Replace the deprecated --lwc tokens with the latest --slds tokens. See lightningdesignsystem.com for more info.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#lwc-token-to-slds-hook",
-    "type": "problem",
-    "messages": {
-      "errorWithReplacement": "The '{{oldValue}}' design token is deprecated. Replace it with '{{newValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.",
-      "errorWithStyleHooks": "The '{{oldValue}}' design token is deprecated. Replace it with the SLDS 2 '{{newValue}}' styling hook and set the fallback to '{{oldValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.",
-      "errorWithNoRecommendation": "The '{{oldValue}}' design token is deprecated. For more info, see the New Global Styling Hook Guidance on lightningdesignsystem.com."
-    }
-  },
-  "no-sldshook-fallback-for-lwctoken": {
-    "description": "Avoid using --slds styling hooks as fallback values for --lwc tokens.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-sldshook-fallback-for-lwctoken",
-    "type": "problem",
-    "messages": {
-      "unsupportedFallback": "Remove the {{sldsToken}} styling hook that is used as a fallback value for {{lwcToken}}."
-    }
-  },
-  "no-unsupported-hooks-slds2": {
-    "description": "Identifies styling hooks that aren't present in SLDS 2. They must be replaced with styling hooks that have a similar effect, or they must be removed.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-unsupported-hooks-slds2",
-    "type": "problem",
-    "messages": {
-      "deprecated": "The {{token}} styling hook isn't present in SLDS 2 and there's no equivalent replacement. Remove it or replace it with a styling hook with a similar effect."
-    }
-  },
-  "no-slds-var-without-fallback": {
-    "description": "Add fallback values to SLDS styling hooks. The fallback values are used in Salesforce environments where styling hooks are unavailable.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-var-without-fallback",
-    "type": "problem",
-    "messages": {
-      "varWithoutFallback": "Your code uses the {{cssVar}} styling hook without a fallback value. Styling hooks are unavailable in some Salesforce environments. To render your component correctly in all environments, add this fallback value: var({{cssVar}}, {{recommendation}}). To make this fallback value brand-aware, use a branded design token instead of a static value. See Design Tokens on v1.lightningdesignsystem.com."
-    }
-  },
-  "no-slds-namespace-for-custom-hooks": {
-    "description": "To differentiate custom styling hooks from SLDS styling hooks, create custom styling hooks in your namespace.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-namespace-for-custom-hooks",
-    "type": "problem",
-    "messages": {
-      "customHookNamespace": "Using the --slds namespace for {{token}} isn't supported. Create the custom styling hook in your namespace. Example: --myapp-{{tokenWithoutNamespace}}"
-    }
-  },
-  "no-slds-private-var": {
-    "description": "Some SLDS styling hooks are private and reserved only for internal Salesforce use. Private SLDS styling hooks have prefixes --_slds- and --slds-s-. For more information, look up private CSS in lightningdesignsystem.com.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-private-var",
-    "type": "problem",
-    "messages": {
-      "privateVar": "This styling hook is reserved for internal Salesforce use. Remove the --_slds- or \u2013slds-s private variable within selector {{prop}}. For more information, look up private CSS in lightningdesignsystem.com."
-    }
-  },
-  "enforce-component-hook-naming-convention": {
-    "description": "Replace component styling hooks that use a deprecated naming convention.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-component-hook-naming-convention",
-    "type": "problem",
-    "messages": {
-      "replace": "Replace the deprecated {{oldValue}} component styling hook with {{suggestedMatch}}."
-    }
-  },
-  "no-hardcoded-values-slds1": {
-    "description": "Replace static values with SLDS 1 design tokens. For more information, look up design tokens on lightningdesignsystem.com.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-value",
-    "type": "suggestion",
-    "messages": {
-      "hardcodedValue": "Replace the {{oldValue}} static value with an SLDS 1 styling hook: {{newValue}}.",
-      "noReplacement": "There's no replacement styling hook for the {{oldValue}} static value. Remove the static value."
-    }
-  },
-  "no-hardcoded-values-slds2": {
-    "description": "Replace static values with SLDS 2 styling hooks. For more information, look up design tokens on lightningdesignsystem.com.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-values-slds2",
-    "type": "suggestion",
-    "messages": {
-      "hardcodedValue": "Consider replacing the {{oldValue}} static value with an SLDS 2 styling hook that has a similar value: {{newValue}}.",
-      "noReplacement": "There's no replacement styling hook for the {{oldValue}} static value. Remove the static value."
-    }
-  },
-  "reduce-annotations": {
-    "description": "Remove your annotations and update your code.",
-    "url": "https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#reduce-annotations",
-    "type": "problem",
-    "messages": {
-      "removeAnnotation": "Remove this annotation and update the code to SLDS best practices. For help, file an issue at https://github.com/salesforce-ux/slds-linter/"
-    }
-  }
-};
-
-// src/services/config.resolver.ts
+import ruleMessages from "@salesforce-ux/eslint-plugin-slds/rule-messages";
 var DEFAULT_ESLINT_CONFIG_PATH = resolvePath("@salesforce-ux/eslint-plugin-slds/config", import.meta);
 var ESLINT_VERSION = "9.36.0";
-var LINTER_CLI_VERSION = "1.0.7";
+var LINTER_CLI_VERSION = "1.0.9-internal";
 var getRuleDescription = (ruleId) => {
   const ruleIdWithoutNameSpace = `${ruleId}`.replace(/\@salesforce-ux\//, "").replace(/^slds\//, "");
-  return rule_messages_default[ruleIdWithoutNameSpace]?.description || "--";
+  return ruleMessages[ruleIdWithoutNameSpace]?.description || "--";
 };
 export {
   DEFAULT_ESLINT_CONFIG_PATH,

package/build/services/file-patterns.d.ts

@@ -1,3 +1,3 @@
-import { FilePattern } from './file-scanner';
+import { FilePattern } from '../types';
 export declare const StyleFilePatterns: FilePattern;
 export declare const ComponentFilePatterns: FilePattern;

package/build/services/file-scanner.d.ts

@@ -1,12 +1,4 @@
-export interface FilePattern {
-    extensions: string[];
-    exclude?: string[];
-}
-export interface ScanOptions {
-    patterns: FilePattern;
-    batchSize?: number;
-    gitignore?: boolean;
-}
+import { ScanOptions, ScanResult } from "../types";
 export declare class FileScanner {
     private static DEFAULT_BATCH_SIZE;
     /**
@@ -15,7 +7,7 @@ export declare class FileScanner {
      * @param options Scanning options including patterns and batch size
      * @returns Array of file paths in batches
      */
-    static scanFiles(directory: string, options: ScanOptions): Promise<string[][]>;
+    static scanFiles(directory: string, options: ScanOptions): Promise<ScanResult>;
     /**
      * Validates that files exist and are readable
      */

package/build/services/file-scanner.js

@@ -1,9 +1,8 @@
 // src/services/file-scanner.ts
+import path from "path";
 import { promises as fs } from "fs";
-import { Logger } from "../utils/logger.js";
 import { globby, isDynamicPattern } from "globby";
-import { extname } from "path";
-import path from "path";
+import { Logger } from "../utils/logger.js";
 var FileScanner = class {
   static DEFAULT_BATCH_SIZE = 100;
   /**
@@ -53,7 +52,7 @@ var FileScanner = class {
         absolute: true,
         gitignore: options.gitignore !== false
       }).then((matches) => matches.filter((match) => {
-        const fileExt = extname(match).substring(1);
+        const fileExt = path.extname(match).substring(1);
         return options.patterns.extensions.includes(fileExt);
       }));
       const validFiles = await this.validateFiles(allFiles);
@@ -62,7 +61,10 @@ var FileScanner = class {
       Logger.debug(
         `Found ${validFiles.length} files, split into ${batches.length} batches`
       );
-      return batches;
+      return {
+        filesCount: validFiles.length,
+        batches
+      };
     } catch (error) {
       Logger.error(`Failed to scan files: ${error.message}`);
       throw error;

package/build/services/lint-runner.d.ts

@@ -3,7 +3,7 @@ export declare class LintRunner {
     /**
      * Run linting on batches of files
      */
-    static runLinting(fileBatches: string[][], workerType: 'component', options?: LintRunnerOptions): Promise<LintResult[]>;
+    static runLinting(fileBatches: string[][], options?: LintRunnerOptions): Promise<LintResult[]>;
     /**
      * Process and normalize worker results
      */

package/build/services/lint-runner.js

@@ -8,7 +8,7 @@ var LintRunner = class {
   /**
    * Run linting on batches of files
    */
-  static async runLinting(fileBatches, workerType, options = {}) {
+  static async runLinting(fileBatches, options = {}) {
     try {
       const workerScript = path.resolve(
         resolveDirName(import.meta),
@@ -46,21 +46,11 @@ var LintRunner = class {
         continue;
       }
       for (const result of batch.results) {
-        if (result.error) {
-          Logger.warning(`File processing failed: ${result.file} - ${result.error}`);
+        if (result.error || !result.lintResult) {
+          Logger.warning(`File processing failed: ${result.filePath} - ${result.error}`);
           continue;
         }
-        results.push({
-          filePath: result.file,
-          errors: result.errors?.map((e) => ({
-            ...e,
-            severity: 2
-          })) || [],
-          warnings: result.warnings?.map((w) => ({
-            ...w,
-            severity: 1
-          })) || []
-        });
+        results.push(result.lintResult);
       }
     }
     return results;

package/build/services/progress-handler.d.ts

@@ -0,0 +1,25 @@
+export interface ProgressHandlerOptions {
+    total: number;
+    format?: string;
+}
+export declare class ProgressHandler {
+    private progressBar;
+    private completed;
+    constructor(options: ProgressHandlerOptions);
+    /**
+     * Increment progress by one unit
+     */
+    increment(): void;
+    /**
+     * Update progress to a specific value
+     */
+    update(value: number): void;
+    /**
+     * Stop and cleanup the progress bar
+     */
+    stop(): void;
+    /**
+     * Get current progress value
+     */
+    getCompleted(): number;
+}

package/build/services/progress-handler.js

@@ -0,0 +1,56 @@
+// src/services/progress-handler.ts
+import cliProgress from "cli-progress";
+import chalk from "chalk";
+var ProgressHandler = class {
+  progressBar = null;
+  completed = 0;
+  constructor(options) {
+    const format = options.format || `Processing [{bar}] {percentage}% ({value}/{total})`;
+    const isCI = String(process.env.CI || "").toLowerCase() === "true" || process.env.CI === "1";
+    const isTTY = Boolean(process.stdout.isTTY);
+    if (!isTTY || isCI) {
+      return;
+    }
+    this.progressBar = new cliProgress.SingleBar({
+      format,
+      barCompleteChar: "\u2588",
+      barIncompleteChar: "\u2591",
+      hideCursor: true,
+      formatBar: (progress, options2) => {
+        const completeSize = Math.round(progress * options2.barsize);
+        const incompleteSize = options2.barsize - completeSize;
+        return chalk.cyan(options2.barCompleteChar.repeat(completeSize)) + chalk.cyanBright(options2.barIncompleteChar.repeat(incompleteSize));
+      }
+    });
+    this.progressBar.start(options.total, 0);
+  }
+  /**
+   * Increment progress by one unit
+   */
+  increment() {
+    this.completed++;
+    this.progressBar?.update(this.completed);
+  }
+  /**
+   * Update progress to a specific value
+   */
+  update(value) {
+    this.completed = value;
+    this.progressBar?.update(value);
+  }
+  /**
+   * Stop and cleanup the progress bar
+   */
+  stop() {
+    this.progressBar?.stop();
+  }
+  /**
+   * Get current progress value
+   */
+  getCompleted() {
+    return this.completed;
+  }
+};
+export {
+  ProgressHandler
+};

package/build/services/report-generator.d.ts

@@ -31,11 +31,11 @@ export declare class CsvReportGenerator {
     /**
      * Generate CSV report and write to file
      */
-    static generate(results: any[]): Promise<string>;
+    static generate(results: LintResult[]): Promise<string>;
     /**
      * Generate CSV string from lint results
      */
-    static generateCsvString(results: any[]): string;
+    static generateCsvString(results: LintResult[]): string;
     /**
      * Convert lint results to CSV-compatible data format
      */

package/build/services/report-generator.js

@@ -75,46 +75,29 @@ var ReportGenerator = class {
    */
   static extractRules(results) {
     const rules = /* @__PURE__ */ new Map();
-    for (const result of results) {
-      for (const error of result.errors) {
-        if (!rules.has(error.ruleId)) {
-          rules.set(error.ruleId, {
-            id: replaceNamespaceinRules(error.ruleId),
+    results.forEach((result) => {
+      result.messages.forEach((message) => {
+        if (!rules.has(message.ruleId)) {
+          rules.set(message.ruleId, {
+            id: replaceNamespaceinRules(message.ruleId),
             shortDescription: {
-              text: getRuleDescription(replaceNamespaceinRules(error.ruleId))
+              text: getRuleDescription(replaceNamespaceinRules(message.ruleId))
             },
             properties: {
               category: "Style"
             }
           });
         }
-      }
-      for (const warning of result.warnings) {
-        if (!rules.has(warning.ruleId)) {
-          rules.set(warning.ruleId, {
-            id: replaceNamespaceinRules(warning.ruleId),
-            shortDescription: {
-              text: getRuleDescription(replaceNamespaceinRules(warning.ruleId))
-            },
-            properties: {
-              category: "Style"
-            }
-          });
-        }
-      }
-    }
+      });
+    });
     return Array.from(rules.values());
   }
   /**
    * Add lint results to SARIF report
    */
   static addResultsToSarif(runBuilder, lintResult) {
-    lintResult.errors.forEach((error) => {
-      const resultBuilder = new SarifResultBuilder().initSimple(transformedResults(lintResult, error, "error"));
-      runBuilder.addResult(resultBuilder);
-    });
-    lintResult.warnings.forEach((warning) => {
-      const resultBuilder = new SarifResultBuilder().initSimple(transformedResults(lintResult, warning, "warning"));
+    lintResult.messages.forEach((message) => {
+      const resultBuilder = new SarifResultBuilder().initSimple(transformedResults(lintResult, message, "error"));
       runBuilder.addResult(resultBuilder);
     });
   }
@@ -149,34 +132,23 @@ var CsvReportGenerator = class {
       useBom: true,
       useKeysAsHeaders: true
     });
-    const transformedResults2 = results.flatMap(
-      (result) => [
-        ...result.errors.map((error) => ({
+    const transformedResults2 = [];
+    results.forEach((result) => {
+      result.messages.forEach((message) => {
+        transformedResults2.push({
           "File Path": path.relative(cwd, result.filePath),
-          "Message": parseText(error.message),
+          "Message": parseText(message.message),
           "Severity": "error",
-          "Rule ID": replaceNamespaceinRules(error.ruleId || "N/A"),
-          "Start Line": error.line,
-          "Start Column": error.column,
-          "End Line": error.endLine || error.line,
+          "Rule ID": replaceNamespaceinRules(message.ruleId || "N/A"),
+          "Start Line": message.line,
+          "Start Column": message.column,
+          "End Line": message.endLine || message.line,
           // Default to start line if missing
-          "End Column": error.endColumn || error.column
+          "End Column": message.endColumn || message.column
           // Default to start column if missing
-        })),
-        ...result.warnings.map((warning) => ({
-          "File Path": path.relative(cwd, result.filePath),
-          "Message": parseText(warning.message),
-          "Severity": "warning",
-          "Rule ID": replaceNamespaceinRules(warning.ruleId || "N/A"),
-          "Start Line": warning.line,
-          "Start Column": warning.column,
-          "End Line": warning.endLine || warning.line,
-          // Default to start line if missing
-          "End Column": warning.endColumn || warning.column
-          // Default to start column if missing
-        }))
-      ]
-    );
+        });
+      });
+    });
     return generateCsv(csvConfig)(transformedResults2);
   }
 };

package/build/types/index.d.ts

@@ -1,3 +1,4 @@
+import type { ESLint, Linter } from 'eslint';
 export interface BaseConfig {
     directory?: string;
     files?: string[];
@@ -32,41 +33,17 @@ export interface LintRunnerOptions {
     maxWorkers?: number;
     timeoutMs?: number;
 }
-export interface LintResultEntry {
-    line: number;
-    column: number;
-    endColumn: number;
-    message: string;
-    ruleId: string;
-    severity: number;
-}
-export interface LintResult {
-    filePath: string;
-    errors: Array<LintResultEntry>;
-    warnings: Array<LintResultEntry>;
-}
+export type LintResultEntry = Linter.LintMessage;
+export type LintResult = ESLint.LintResult;
 export type ExitCode = 0 | 1 | 2;
 export interface WorkerConfig {
     configPath?: string;
     fix?: boolean;
 }
 export interface WorkerResult {
-    file: string;
+    filePath: string;
+    lintResult?: LintResult;
     error?: string;
-    warnings?: Array<{
-        line: number;
-        column: number;
-        endColumn: number;
-        message: string;
-        ruleId: string;
-    }>;
-    errors?: Array<{
-        line: number;
-        column: number;
-        endColumn: number;
-        message: string;
-        ruleId: string;
-    }>;
 }
 export interface SarifResultEntry {
     level: any;
@@ -78,3 +55,22 @@ export interface SarifResultEntry {
     endLine?: number;
     endColumn?: number;
 }
+export interface LintResultSummary {
+    totalErrors: number;
+    totalWarnings: number;
+    fixableErrors: number;
+    fixableWarnings: number;
+}
+export interface FilePattern {
+    extensions: string[];
+    exclude?: string[];
+}
+export interface ScanOptions {
+    patterns: FilePattern;
+    batchSize?: number;
+    gitignore?: boolean;
+}
+export interface ScanResult {
+    filesCount: number;
+    batches: string[][];
+}

package/build/utils/colors.d.ts

@@ -0,0 +1,16 @@
+import chalk from 'chalk';
+/**
+ * Color constants matching the UX design system syntax colors for dark mode
+ * Based on the mock design specifications
+ */
+export declare const Colors: {
+    readonly error: chalk.Chalk;
+    readonly warning: chalk.Chalk;
+    readonly success: chalk.Chalk;
+    readonly info: chalk.Chalk;
+    readonly hyperlink: chalk.Chalk;
+    readonly lowEmphasis: chalk.Chalk;
+    readonly standard: chalk.Chalk;
+    readonly errorBold: chalk.Chalk;
+    readonly warningBold: chalk.Chalk;
+};

package/build/utils/colors.js

@@ -0,0 +1,24 @@
+// src/utils/colors.ts
+import chalk from "chalk";
+var Colors = {
+  // Error: light red/salmon
+  error: chalk.hex("#FF8080"),
+  // Warning: vibrant yellow
+  warning: chalk.hex("#FFFF80"),
+  // Success: bright light green
+  success: chalk.hex("#66BB6A"),
+  // Informational: light cyan/aqua blue
+  info: chalk.hex("#80FFFF"),
+  // Hyperlink: light blue/lavender
+  hyperlink: chalk.hex("#8080FF"),
+  // Low-emphasis text: light gray
+  lowEmphasis: chalk.hex("#A9A9A9"),
+  // Standard text: white (default)
+  standard: chalk.white,
+  // Bold variants for emphasis
+  errorBold: chalk.hex("#FF8080").bold,
+  warningBold: chalk.hex("#FFFF80").bold
+};
+export {
+  Colors
+};

package/build/utils/editorLinkUtil.js

@@ -1,5 +1,5 @@
 // src/utils/editorLinkUtil.ts
-import chalk from "chalk";
+import { Colors } from "./colors.js";
 function detectCurrentEditor() {
   const editor = process.env.EDITOR || process.env.VISUAL;
   if (editor) {
@@ -43,7 +43,7 @@ function getEditorLink(editor, absolutePath, line, column) {
 function createClickableLineCol(lineCol, absolutePath, line, column, editor) {
   const detectedEditor = editor || detectCurrentEditor();
   const link = getEditorLink(detectedEditor, absolutePath, line, column);
-  return `\x1B]8;;${link}\x07${chalk.blueBright(lineCol)}\x1B]8;;\x07`;
+  return `\x1B]8;;${link}\x07${Colors.info(lineCol)}\x1B]8;;\x07`;
 }
 export {
   createClickableLineCol,

package/build/utils/lintResultsUtil.d.ts

@@ -1,4 +1,4 @@
-import { LintResult, LintResultEntry, SarifResultEntry } from '../types';
+import { LintResult, LintResultEntry, SarifResultEntry, LintResultSummary } from '../types';
 /**
  *
  * @param id - Rule id
@@ -17,5 +17,5 @@ export declare function parseText(text: string): string;
  * @param results - Array of lint results.
  * @param editor - The chosen editor for clickable links (e.g., "vscode", "atom", "sublime"). If not provided, will auto-detect.
  */
-export declare function printLintResults(results: LintResult[], editor?: string): void;
+export declare function printLintResults(results: LintResult[], editor?: string): LintResultSummary;
 export declare function transformedResults(lintResult: LintResult, entry: LintResultEntry, level: 'error' | 'warning'): SarifResultEntry;

package/build/utils/lintResultsUtil.js

@@ -1,8 +1,8 @@
 // src/utils/lintResultsUtil.ts
-import chalk from "chalk";
 import path from "path";
 import { createClickableLineCol } from "./editorLinkUtil.js";
 import { Logger } from "../utils/logger.js";
+import { Colors } from "./colors.js";
 function replaceNamespaceinRules(id) {
   return id.includes("@salesforce-ux/") ? id.replace("@salesforce-ux/", "") : id;
 }
@@ -16,39 +16,79 @@ function parseText(text) {
   }
   return safeText.endsWith(".") ? safeText : `${safeText}.`;
 }
+function printTotalViolationsSummary(totalErrors, totalWarnings) {
+  const totalProblems = totalErrors + totalWarnings;
+  let totalProblemsText = `${totalProblems} SLDS Violation${totalProblems !== 1 ? "s" : ""}`;
+  if (totalErrors > 0) {
+    totalProblemsText = Colors.error(`\u2716 ${totalProblemsText}`);
+  } else {
+    totalProblemsText = Colors.warning(`\u26A0 ${totalProblemsText}`);
+  }
+  const totalBreakdown = [
+    Colors.error(`${totalErrors} error${totalErrors !== 1 ? "s" : ""}`),
+    Colors.warning(`${totalWarnings} warning${totalWarnings !== 1 ? "s" : ""}`)
+  ];
+  console.log(`${totalProblemsText} (${totalBreakdown.join(", ")})`);
+}
+function printFixableViolationsSummary(fixableErrors, fixableWarnings) {
+  const fixableTotal = fixableErrors + fixableWarnings;
+  if (!fixableTotal) {
+    return;
+  }
+  const fixableBreakdown = [];
+  if (fixableErrors > 0) {
+    fixableBreakdown.push(Colors.error(`${fixableErrors} error${fixableErrors !== 1 ? "s" : ""}`));
+  }
+  if (fixableWarnings > 0) {
+    fixableBreakdown.push(Colors.warning(`${fixableWarnings} warning${fixableWarnings !== 1 ? "s" : ""}`));
+  }
+  console.log(`  ${fixableBreakdown.join(" and ")} potentially fixable with the \`--fix\` option.`);
+}
 function printLintResults(results, editor) {
+  let totalErrors = 0;
+  let totalWarnings = 0;
+  let fixableErrors = 0;
+  let fixableWarnings = 0;
   results.forEach((result) => {
-    const hasErrors = result.errors && result.errors.length > 0;
-    const hasWarnings = result.warnings && result.warnings.length > 0;
-    if (!hasErrors && !hasWarnings) return;
+    if (!result.messages || result.messages.length === 0) return;
     const absolutePath = result.filePath || "";
     const relativeFile = path.relative(process.cwd(), absolutePath) || "Unknown file";
-    Logger.newLine().info(`${chalk.bold(relativeFile)}`);
-    if (hasErrors) {
-      result.errors.forEach((error) => {
-        if (error.line && error.column && absolutePath) {
-          const lineCol = `${error.line}:${error.column}`;
-          const clickable = createClickableLineCol(lineCol, absolutePath, error.line, error.column, editor);
-          const ruleId = error.ruleId ? chalk.dim(replaceNamespaceinRules(error.ruleId)) : "";
-          Logger.error(`  ${clickable}  ${parseText(error.message)}  ${ruleId}`);
-        } else {
-          Logger.error(`  ${chalk.red("Error:")} ${parseText(error.message)}`);
-        }
-      });
-    }
-    if (hasWarnings) {
-      result.warnings.forEach((warn) => {
-        if (warn.line && warn.column && absolutePath) {
-          const lineCol = `${warn.line}:${warn.column}`;
-          const clickable = createClickableLineCol(lineCol, absolutePath, warn.line, warn.column, editor);
-          const ruleId = warn.ruleId ? chalk.dim(replaceNamespaceinRules(warn.ruleId)) : "";
-          Logger.warning(`  ${clickable}  ${parseText(warn.message)}  ${ruleId}`);
-        } else {
-          Logger.warning(`  ${chalk.yellow("Warning:")} ${parseText(warn.message)}`);
-        }
+    console.log(`
+${Colors.info.underline(relativeFile)}
+`);
+    const tableData = [];
+    result.messages.forEach((msg) => {
+      const isError = msg.severity === 2;
+      const isWarning = msg.severity === 1;
+      if (isError) {
+        totalErrors++;
+        if (msg.fix) fixableErrors++;
+      } else if (isWarning) {
+        totalWarnings++;
+        if (msg.fix) fixableWarnings++;
+      }
+      const lineCol = msg.line && msg.column ? `${msg.line}:${msg.column}` : "-";
+      const clickableLineCol = msg.line && msg.column ? createClickableLineCol(lineCol, absolutePath, msg.line, msg.column, editor) : lineCol;
+      const severityText = isError ? Colors.error("error") : Colors.warning("warning");
+      const message = parseText(msg.message);
+      const ruleId = msg.ruleId ? Colors.lowEmphasis(replaceNamespaceinRules(msg.ruleId)) : "";
+      tableData.push([clickableLineCol, severityText, message, ruleId]);
+    });
+    if (tableData.length > 0) {
+      tableData.forEach(([lineCol, severity, message, ruleId], index) => {
+        if (index > 0) console.log();
+        console.log(`  ${lineCol}  ${severity}  ${message}  ${ruleId}`);
       });
     }
   });
+  Logger.newLine();
+  if (totalErrors > 0 || totalWarnings > 0) {
+    printTotalViolationsSummary(totalErrors, totalWarnings);
+    printFixableViolationsSummary(fixableErrors, fixableWarnings);
+  } else {
+    Logger.success("No SLDS Violations found.");
+  }
+  return { totalErrors, totalWarnings, fixableErrors, fixableWarnings };
 }
 function transformedResults(lintResult, entry, level) {
   return {

package/build/utils/logger.js

@@ -1,25 +1,25 @@
 // src/utils/logger.ts
-import chalk from "chalk";
+import { Colors } from "./colors.js";
 var Logger = class {
   static newLine() {
-    console.log("\n");
+    console.log("");
     return this;
   }
   static info(message) {
-    console.log(chalk.blue("\u2139"), message);
+    console.log(Colors.info(`\u2139 ${message}`));
   }
   static success(message) {
-    console.log(chalk.green("\u2713"), message);
+    console.log(Colors.success("\u2713"), message);
   }
   static warning(message) {
-    console.warn(chalk.yellow("\u26A0"), message);
+    console.warn(Colors.warning("\u26A0"), message);
   }
   static error(message) {
-    console.error(chalk.red("\u2716"), message);
+    console.error(Colors.error("\u2716"), message);
   }
   static debug(message) {
     if (process.env.DEBUG) {
-      console.debug(chalk.gray("\u{1F50D}"), message);
+      console.debug(Colors.lowEmphasis("\u{1F50D}"), message);
     }
   }
 };

package/build/workers/eslint.worker.d.ts

@@ -1 +1,7 @@
-export {};
+import { BaseWorker } from './base.worker';
+import { WorkerConfig, WorkerResult } from '../types';
+export declare class ESLintWorker extends BaseWorker<WorkerConfig, WorkerResult> {
+    private eslint;
+    constructor();
+    protected processFile(filePath: string): Promise<WorkerResult>;
+}

package/build/workers/eslint.worker.js

@@ -1,5 +1,6 @@
 // src/workers/eslint.worker.ts
 import { ESLint } from "eslint";
+import { isMainThread } from "worker_threads";
 import { BaseWorker } from "./base.worker.js";
 var ESLintWorker = class extends BaseWorker {
   eslint;
@@ -18,32 +19,24 @@ var ESLintWorker = class extends BaseWorker {
         await ESLint.outputFixes(results);
       }
       return {
-        file: filePath,
-        warnings: fileResult.messages.filter((msg) => msg.severity === 1).map((warning) => ({
-          line: warning.line,
-          column: warning.column,
-          endColumn: warning.endColumn,
-          message: warning.message,
-          ruleId: warning.ruleId || "unknown"
-        })),
-        errors: fileResult.messages.filter((msg) => msg.severity === 2).map((error) => ({
-          line: error.line,
-          column: error.column,
-          endColumn: error.endColumn,
-          message: error.message,
-          ruleId: error.ruleId || "unknown"
-        }))
+        filePath,
+        lintResult: fileResult
       };
     } catch (error) {
       return {
-        file: filePath,
+        filePath,
         error: error.message
       };
     }
   }
 };
-var worker = new ESLintWorker();
-worker.process().catch((error) => {
-  console.error("Worker failed:", error);
-  process.exit(1);
-});
+if (!isMainThread) {
+  const worker = new ESLintWorker();
+  worker.process().catch((error) => {
+    console.error("Worker failed:", error);
+    process.exit(1);
+  });
+}
+export {
+  ESLintWorker
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce-ux/slds-linter",
-  "version": "1.0.7",
+  "version": "1.0.9-internal",
   "description": "SLDS Linter CLI tool for linting styles and components",
   "keywords": [
     "lightning design system linter",
@@ -29,10 +29,11 @@
   ],
   "bin": "build/index.js",
   "dependencies": {
-    "@salesforce-ux/eslint-plugin-slds": "1.0.7",
+    "@salesforce-ux/eslint-plugin-slds": "1.0.9-internal",
     "@typescript-eslint/eslint-plugin": "^8.36.0",
     "@typescript-eslint/parser": "^8.36.0",
     "chalk": "^4.1.2",
+    "cli-progress": "^3.12.0",
     "commander": "^13.1.0",
     "eslint": "^9.0.0",
     "export-to-csv": "^1.4.0",