@salesforce-ux/slds-linter 0.1.3 → 0.1.4-alpha.0

package/README.md

@@ -48,16 +48,14 @@ Usage: npx @salesforce-ux/slds-linter@latest [options] [command]
 SLDS Linter CLI tool for linting styles and components
 
 Options:
-  -V, --version              output the version number
-  -h, --help                 display help for command
+  -V, --version                 output the version number
+  -h, --help                    display help for command
 
 Commands:
-  lint:styles [options]      Run stylelint on all style files
-  lint:components [options]  Run eslint on all markup files
-  lint [options]             Run both style and component linting
-  report [options]           Generate SARIF report from linting results
-  emit [options]             Emits the configuration files used by slds-linter cli
-  help [command]             display help for command
+  lint [options] [directory]    Run both style and component linting
+  report [options] [directory]  Generate SARIF report from linting results
+  emit [options]                Emits the configuration files used by slds-linter cli
+  help [command]                display help for command
 ```
 
 ## Run SLDS Linter
@@ -70,14 +68,12 @@ In your project root directory, follow these steps.
 2. Run `npx @salesforce-ux/slds-linter lint`. 
     The linting output displayed in the console includes the row and column numbers on the left. Navigate to specific lines in your source code by clicking on the displayed numbers (Command + Click on Mac).
 
-3. (Optional) To see lint errors only on CSS files, run `npx @salesforce-ux/slds-linter lint:styles` .
-4. (Optional) To see lint errors only on component markup files (componentName.html or componentName.cmp files), run `npx @salesforce-ux/slds-linter lint:components` . 
-5. (Optional) To run SLDS Linter on a specific folder, add the `-d` option to specify the directory to be linted: `npx @salesforce-ux/slds-linter -d [directory name]` . This option accepts directories or folders using glob patterns, enabling flexible and efficient matching of multiple paths. For example, run `npx @salesforce-ux/slds-linter lint -d "com/CORE/**"` gives the lint output for all the files under `com/CORE`.
-6. To produce a SARIF report in your project root directory and specify an output directory, run  `npx @salesforce-ux/slds-linter report -o [output directory]`. The output file is named as `slds-linter-report.sarif`.
-7. Open the generated `.sarif` report file.
-8. Make a note of how many components SLDS Linter has identified that you must update.
-9. (Optional) To automatically fix validation errors in bulk, run the `lint` command with the `fix` option, `npx @salesforce-ux/slds-linter lint --fix`.
-7. (Optional) To emit the configuration files used by `slds-linter`, run `npx @salesforce-ux/slds-linter emit` in your component source directory. Note that this command defaults to current working directory. These configuration files are discovered by your VS Code ESLint and Stylelint extensions to display squiggly lines in CSS and HTML files when opened in your code editor. 
+3. (Optional) To run SLDS Linter on a specific folder, specify the directory to be linted: `npx @salesforce-ux/slds-linter [directory name]` . This option accepts directories or folders using [glob](https://github.com/sindresorhus/globby?tab=readme-ov-file#globbing-patterns) patterns, enabling flexible and efficient matching of multiple paths. For example, run `npx @salesforce-ux/slds-linter lint "com/CORE/**"` gives the lint output for all the files under `com/CORE`.
+4. To produce a SARIF report in your project root directory and specify an output directory, run  `npx @salesforce-ux/slds-linter report -o [output directory]`. The output file is named as `slds-linter-report.sarif`.
+5. Open the generated `.sarif` report file.
+6. Make a note of how many components SLDS Linter has identified that you must update.
+7. (Optional) To automatically fix validation errors in bulk, run the `lint` command with the `fix` option, `npx @salesforce-ux/slds-linter lint --fix`.
+8. (Optional) To emit the configuration files used by `slds-linter`, run `npx @salesforce-ux/slds-linter emit` in your component source directory. Note that this command defaults to current working directory. These configuration files are discovered by your VS Code ESLint and Stylelint extensions to display squiggly lines in CSS and HTML files when opened in your code editor.  
 
 
 ### Troubleshoot SARIF Viewer Navigation
@@ -94,8 +90,6 @@ If the SARIF viewer doesn’t automatically go to the line of code when you clic
 Use these commands to run SLDS Linter rules. Review the output violations and fix any issues to uplift your code to SLDS best practices.
 
 - `npx @salesforce-ux/slds-linter lint`. Runs ESlint and Stylelint rules on HTML, CSS, and CMP files.
-- `npx @salesforce-ux/slds-linter lint:styles`. Runs the Stylelint rules on your CSS files.
-- `npx @salesforce-ux/slds-linter lint:components`. Runs the ESlint rules on your HTML/CMP files.
 - `npx @salesforce-ux/slds-linter report`. Generates a SARIF report for static analysis.
 - `npx @salesforce-ux/slds-linter emit`. Emits the configuration files used by `slds-linter`. Defaults to current directory. 
 
@@ -103,13 +97,12 @@ These options are available on SLDS Linter commands.
 
 | **Option**              | **Description**                                                              | **Availability**                           |
 | ------------------------ | ---------------------------------------------------------------------------- | ------------------------------------------ |
-| `-d, --directory <path>` | Target directory to scan (defaults to current directory). Accepts glob patterns.                     | `lint`, `lint:styles`, `lint:components`, `report` |
+| `-d, --directory <path>` | Target directory to scan (defaults to current directory). Supports glob patterns.                     | `lint`, `report` |
 | `-o, --output <path>`    | Output directory for reports (defaults to current directory)                 | `report`                                     |
-| `--fix`                  | Automatically fix problems                                                   | `lint`, `lint:styles`, `lint:components`         |
-| `--config <path>`        | Path to eslint/stylelint config file'         | `lint:styles`, `lint:components`               |
-| `--config-style <path>`  | Path to stylelint config file'             | `lint`                                       |
-| `--config-eslint <path>` | Path to eslint config file'                    | `lint`                                       |
-| `--editor <editor>`      | Editor to open files with (e.g., vscode, atom, sublime). Defaults to vscode | `lint`, `lint:styles`, `lint:components`          |
+| `--fix`                  | Automatically fix problems                                                   | `lint`         |
+| `--config-stylelint <path>`  | Path to stylelint config file             | `lint`, `report`|
+| `--config-eslint <path>` | Path to eslint config file                    | `lint`, `report`|
+| `--editor <editor>`      | Editor to open files with (e.g., vscode, atom, sublime). Defaults to vscode | `lint` |
 
 To view help for these options, add `--help` to each command. For example, run `npx @salesforce-ux/slds-linter lint --help` to see which options you can use with `lint`.
 
@@ -124,6 +117,54 @@ To enhance your linting and error analysis experience, we recommend that you ins
 ## Best Practices
 
 - Run `npx @salesforce-ux/slds-linter lint` to see the lint output on Terminal. 
-- To run SLDS Linter on a specific folder, add option `-d` For example, `npx @salesforce-ux/slds-linter lint -d`
+- To run SLDS Linter on a specific folder, input as argument. For example, `npx @salesforce-ux/slds-linter lint <directory>`
 
-For any questions or issues, open an issue in this repository.
+### Example - single folder
+
+Recursively linting all style and markup files in the `aura` directory:
+
+```shell
+npx @salesforce-ux/slds-linter lint aura
+```
+
+### Example - multiple folders
+
+Recursively linting all style and markup files in the `aura` and `lwc` directory:
+
+```shell
+npx @salesforce-ux/slds-linter lint "**/{aura,lwc}/**"
+```
+
+### Example - lint style files
+
+Recursively linting all `.css` files in the `aura` directory:
+
+```shell
+npx @salesforce-ux/slds-linter lint "aura/**/*.css"
+```
+
+### Example - multiple style file extensions
+
+Linting all `.css`, `.scss`, and `.sass` files:
+
+```shell
+npx @salesforce-ux/slds-linter lint "**/*.{css,scss,sass}"
+```
+
+### Example - lint markeup files
+
+Recursively linting all `.html` files in the `aura` directory:
+
+```shell
+npx @salesforce-ux/slds-linter lint "aura/**/*.html"
+```
+
+### Example - multiple markup file extensions
+
+Linting all `.html` and `.cmp` files:
+
+```shell
+npx @salesforce-ux/slds-linter lint "**/*.{html,cmp}"
+```
+
+For any questions or issues, open an issue in this repository.

package/build/commands/emit.js

@@ -11,19 +11,19 @@ import { copyFile } from "fs/promises";
 function registerEmitCommand(program) {
   program.command("emit").description("Emits the configuration files used by slds-linter cli").option(
     "-d, --directory <path>",
-    "Target directory to emit (defaults to current directory)"
+    "Target directory to emit (defaults to current directory). Support glob patterns"
   ).action(async (options) => {
     try {
       Logger.info(chalk.blue("Emitting configuration files..."));
       const normalizedOptions = normalizeCliOptions(options, {
-        configStyle: DEFAULT_STYLELINT_CONFIG_PATH,
+        configStylelint: DEFAULT_STYLELINT_CONFIG_PATH,
         configEslint: DEFAULT_ESLINT_CONFIG_PATH
       });
       const destStyleConfigPath = path.join(
         normalizedOptions.directory,
-        path.basename(normalizedOptions.configStyle)
+        path.basename(normalizedOptions.configStylelint)
       );
-      await copyFile(normalizedOptions.configStyle, destStyleConfigPath);
+      await copyFile(normalizedOptions.configStylelint, destStyleConfigPath);
       Logger.success(chalk.green(`Stylelint configuration created at:
 ${destStyleConfigPath}
 `));

package/build/commands/lint.js

@@ -1,38 +1,50 @@
 // src/commands/lint.ts
+import { Option } from "commander";
 import chalk from "chalk";
 import { printLintResults } from "../utils/lintResultsUtil.js";
-import { normalizeCliOptions } from "../utils/cli-args.js";
+import { normalizeCliOptions, nomalizeDirPath } from "../utils/cli-args.js";
 import { Logger } from "../utils/logger.js";
 import { FileScanner } from "../services/file-scanner.js";
 import { StyleFilePatterns, ComponentFilePatterns } from "../services/file-patterns.js";
 import { LintRunner } from "../services/lint-runner.js";
 import { DEFAULT_ESLINT_CONFIG_PATH, DEFAULT_STYLELINT_CONFIG_PATH } from "../services/config.resolver.js";
 function registerLintCommand(program) {
-  program.command("lint").description("Run both style and component linting").option("-d, --directory <path>", "Target directory to scan (defaults to current directory)").option("--fix", "Automatically fix problems").option("--config-style <path>", "Path to stylelint config file").option("--config-eslint <path>", "Path to eslint config file").option("--editor <editor>", "Editor to open files with (e.g., vscode, atom, sublime). Defaults to vscode", "vscode").action(async (options) => {
+  program.command("lint").aliases(["lint:styles", "lint:components"]).configureHelp({
+    commandUsage: () => {
+      return `${program.name()} lint [directory] [options]`;
+    }
+  }).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-stylelint <path>", "Path to stylelint config file").option("--config-eslint <path>", "Path to eslint config file").option("--editor <editor>", "Editor to open files with (e.g., vscode, atom, sublime). Defaults to vscode", "vscode").action(async (directory, options) => {
     const startTime = Date.now();
     try {
       Logger.info(chalk.blue("Starting lint process..."));
       const normalizedOptions = normalizeCliOptions(options, {
-        configStyle: DEFAULT_STYLELINT_CONFIG_PATH,
+        configStylelint: DEFAULT_STYLELINT_CONFIG_PATH,
         configEslint: DEFAULT_ESLINT_CONFIG_PATH
       });
-      Logger.info(chalk.blue("\nScanning style files..."));
+      if (directory) {
+        normalizedOptions.directory = nomalizeDirPath(directory);
+      } else if (options.directory) {
+        Logger.newLine().warning(chalk.yellow(
+          `WARNING: --directory, -d option is deprecated. Supply as argument instead.
+            Example: npx @salesforce-ux/slds-linter lint ${options.directory}`
+        ));
+      }
+      Logger.newLine().info(chalk.blue("Scanning style files..."));
       const styleFileBatches = await FileScanner.scanFiles(normalizedOptions.directory, {
         patterns: StyleFilePatterns,
         batchSize: 100
       });
       const totalStyleFiles = styleFileBatches.reduce((sum, batch) => sum + batch.length, 0);
-      Logger.info(chalk.blue(`Found ${totalStyleFiles} style file(s). Running stylelint...
-`));
-      Logger.info(chalk.blue(`Running stylelint${normalizedOptions.fix ? " with autofix" : ""}...`));
+      Logger.info(chalk.blue(`Found ${totalStyleFiles} style file(s). Running stylelint...`));
+      Logger.newLine().info(chalk.blue(`Running stylelint${normalizedOptions.fix ? " with autofix" : ""}...`));
       const styleResults = await LintRunner.runLinting(styleFileBatches, "style", {
         fix: normalizedOptions.fix,
-        configPath: normalizedOptions.configStyle
+        configPath: normalizedOptions.configStylelint
       });
       printLintResults(styleResults, normalizedOptions.editor);
       const styleErrorCount = styleResults.reduce((sum, r) => sum + r.errors.length, 0);
       const styleWarningCount = styleResults.reduce((sum, r) => sum + r.warnings.length, 0);
-      Logger.info(chalk.blue("\nScanning component files..."));
+      Logger.newLine().info(chalk.blue("Scanning component files..."));
       const componentFileBatches = await FileScanner.scanFiles(normalizedOptions.directory, {
         patterns: ComponentFilePatterns,
         batchSize: 100
@@ -56,7 +68,7 @@ ${chalk.red(`${totalErrors} error${totalErrors !== 1 ? "s" : ""}`)}  ${chalk.yel
       );
       const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
       Logger.success(chalk.green(`
-Full linting completed in ${elapsedTime} seconds.`));
+Linting completed in ${elapsedTime} seconds.`));
       process.exit(totalErrors > 0 ? 1 : 0);
     } catch (error) {
       Logger.error(chalk.red(`Failed to complete linting: ${error.message}`));

package/build/commands/report.js

@@ -1,7 +1,9 @@
 // src/commands/report.ts
+import { Option } from "commander";
 import path from "path";
 import ora from "ora";
-import { normalizeCliOptions } from "../utils/cli-args.js";
+import chalk from "chalk";
+import { nomalizeDirPath, normalizeCliOptions } from "../utils/cli-args.js";
 import { Logger } from "../utils/logger.js";
 import { FileScanner } from "../services/file-scanner.js";
 import { StyleFilePatterns, ComponentFilePatterns } from "../services/file-patterns.js";
@@ -9,20 +11,30 @@ import { LintRunner } from "../services/lint-runner.js";
 import { ReportGenerator } from "../services/report-generator.js";
 import { DEFAULT_ESLINT_CONFIG_PATH, DEFAULT_STYLELINT_CONFIG_PATH, LINTER_CLI_VERSION } from "../services/config.resolver.js";
 function registerReportCommand(program) {
-  program.command("report").description("Generate SARIF report from linting results").option("-d, --directory <path>", "Target directory to scan (defaults to current directory)").option("-o, --output <path>", "Output directory for reports (defaults to current directory)").option("--config-style <path>", "Path to stylelint config file").option("--config-eslint <path>", "Path to eslint config file").action(async (options) => {
-    const spinner = ora("Starting report generation...").start();
+  program.command("report").description("Generate SARIF report from linting results").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("-o, --output <path>", "Output directory for reports (defaults to current directory)").option("--config-stylelint <path>", "Path to stylelint config file").option("--config-eslint <path>", "Path to eslint config file").action(async (directory, options) => {
+    const spinner = ora("Starting report generation...");
     try {
       const normalizedOptions = normalizeCliOptions(options, {
-        configStyle: DEFAULT_STYLELINT_CONFIG_PATH,
+        configStylelint: DEFAULT_STYLELINT_CONFIG_PATH,
         configEslint: DEFAULT_ESLINT_CONFIG_PATH
       });
+      if (directory) {
+        normalizedOptions.directory = nomalizeDirPath(directory);
+      } else if (options.directory) {
+        Logger.newLine().warning(chalk.yellow(
+          `WARNING: --directory, -d option is deprecated. Supply as argument instead.
+Example: npx @salesforce-ux/slds-linter report ${options.directory}
+`
+        ));
+      }
+      spinner.start();
       spinner.text = "Running styles linting...";
       const styleFileBatches = await FileScanner.scanFiles(normalizedOptions.directory, {
         patterns: StyleFilePatterns,
         batchSize: 100
       });
       const styleResults = await LintRunner.runLinting(styleFileBatches, "style", {
-        configPath: normalizedOptions.configStyle
+        configPath: normalizedOptions.configStylelint
       });
       spinner.text = "Running components linting...";
       const componentFileBatches = await FileScanner.scanFiles(normalizedOptions.directory, {
@@ -32,7 +44,7 @@ function registerReportCommand(program) {
       const componentResults = await LintRunner.runLinting(componentFileBatches, "component", {
         configPath: normalizedOptions.configEslint
       });
-      spinner.text = "Generating combined report...";
+      spinner.text = "Generating SARIF report...";
       const combinedReportPath = path.join(normalizedOptions.output, "slds-linter-report.sarif");
       await ReportGenerator.generateSarifReport([...styleResults, ...componentResults], {
         outputPath: combinedReportPath,
@@ -40,10 +52,12 @@ function registerReportCommand(program) {
         toolVersion: LINTER_CLI_VERSION
       });
       spinner.succeed("Report generation completed");
+      Logger.success(`SARIF report generated: ${combinedReportPath}
+`);
       process.exit(0);
     } catch (error) {
       spinner?.fail("Report generation failed");
-      Logger.error(`Failed to generate report: ${error.message}`);
+      Logger.error(`Failed to generate SARIF report: ${error.message}`);
       process.exit(1);
     }
   });

package/build/index.js

@@ -2,8 +2,6 @@
 
 // src/index.ts
 import { Command } from "commander";
-import { registerLintStylesCommand } from "./commands/lint-styles.js";
-import { registerLintComponentsCommand } from "./commands/lint-components.js";
 import { registerLintCommand } from "./commands/lint.js";
 import { registerReportCommand } from "./commands/report.js";
 import { registerEmitCommand } from "./commands/emit.js";
@@ -21,12 +19,15 @@ 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("0.1.3");
+  program.description("SLDS Linter CLI tool for linting styles and components").version("0.1.4-alpha.0");
 }
-registerLintStylesCommand(program);
-registerLintComponentsCommand(program);
 registerLintCommand(program);
 registerReportCommand(program);
 registerEmitCommand(program);
 registerVersion();
+program.configureHelp({
+  subcommandTerm: (cmd) => {
+    return cmd.name();
+  }
+});
 program.parse(process.argv);

package/build/services/__tests__/file-scanner.test.js

@@ -37,7 +37,7 @@ describe("FileScanner", () => {
   it("should handle invalid files gracefully", async () => {
     const options = {
       patterns: {
-        include: ["**/*.nonexistent"],
+        extensions: ["nonexistent"],
         exclude: []
       }
     };

package/build/services/config.resolver.js

@@ -5,7 +5,7 @@ var DEFAULT_ESLINT_CONFIG_PATH = resolvePath("@salesforce-ux/eslint-plugin-slds/
 var DEFAULT_STYLELINT_CONFIG_PATH = resolvePath("@salesforce-ux/stylelint-plugin-slds/.stylelintrc.yml", import.meta);
 var STYLELINT_VERSION = "16.14.1";
 var ESLINT_VERSION = "8.57.1";
-var LINTER_CLI_VERSION = "0.1.3";
+var LINTER_CLI_VERSION = "0.1.4-alpha.0";
 var getRuleDescription = (ruleId) => {
   const ruleIdWithoutNameSpace = `${ruleId}`.replace(/\@salesforce-ux\//, "");
   return ruleMetadata(ruleIdWithoutNameSpace)?.ruleDesc || "--";

package/build/services/file-patterns.js

@@ -1,11 +1,6 @@
 // src/services/file-patterns.ts
 var StyleFilePatterns = {
-  include: [
-    "**/*.css",
-    "**/*.scss",
-    "**/*.less",
-    "**/*.sass"
-  ],
+  extensions: ["css", "scss", "less", "sass"],
   exclude: [
     "**/node_modules/**",
     "**/dist/**",
@@ -13,14 +8,7 @@ var StyleFilePatterns = {
   ]
 };
 var ComponentFilePatterns = {
-  include: [
-    "**/*.html",
-    "**/*.cmp",
-    "**/*.component",
-    "**/*.app",
-    "**/*.page",
-    "**/*.interface"
-  ],
+  extensions: ["html", "cmp", "component", "app", "page", "interface"],
   exclude: [
     "**/node_modules/**",
     "**/dist/**",

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

@@ -1,5 +1,5 @@
 export interface FilePattern {
-    include: string[];
+    extensions: string[];
     exclude?: string[];
 }
 export interface ScanOptions {

package/build/services/file-scanner.js

@@ -1,7 +1,8 @@
 // src/services/file-scanner.ts
 import { promises as fs } from "fs";
-import { glob } from "glob";
 import { Logger } from "../utils/logger.js";
+import { globby } from "globby";
+import { extname } from "path";
 var FileScanner = class {
   static DEFAULT_BATCH_SIZE = 100;
   /**
@@ -13,24 +14,21 @@ var FileScanner = class {
   static async scanFiles(directory, options) {
     try {
       Logger.debug(`Scanning directory: ${directory}`);
-      Logger.debug(`Include patterns: ${options.patterns.include.join(", ")}`);
-      const allFiles = [];
-      for (const pattern of options.patterns.include) {
-        const files = await glob(`${directory}/${pattern}`, {
-          cwd: process.cwd(),
-          ignore: options.patterns.exclude,
-          withFileTypes: true,
-          dot: true
-          // Include .dot files
-        }).then(
-          (matches) => matches.filter((match) => match.isFile()).map((match) => {
-            return match.fullpath();
-          })
-        );
-        allFiles.push(...files);
-      }
-      const uniqueFiles = [...new Set(allFiles)];
-      const validFiles = await this.validateFiles(uniqueFiles);
+      const allFiles = await globby(directory, {
+        cwd: process.cwd(),
+        expandDirectories: true,
+        unique: true,
+        ignore: options.patterns.exclude,
+        onlyFiles: true,
+        dot: true,
+        // Include.dot files
+        absolute: true,
+        gitignore: true
+      }).then((matches) => matches.filter((match) => {
+        const fileExt = extname(match).substring(1);
+        return options.patterns.extensions.includes(fileExt);
+      }));
+      const validFiles = await this.validateFiles(allFiles);
       const batchSize = options.batchSize || this.DEFAULT_BATCH_SIZE;
       const batches = this.createBatches(validFiles, batchSize);
       Logger.debug(

package/build/services/report-generator.js

@@ -1,7 +1,6 @@
 // src/services/report-generator.ts
 import path from "path";
 import fs from "fs/promises";
-import { Logger } from "../utils/logger.js";
 import { SarifBuilder, SarifRunBuilder, SarifResultBuilder, SarifRuleBuilder } from "node-sarif-builder";
 import { createWriteStream } from "fs";
 import { JsonStreamStringify } from "json-stream-stringify";
@@ -12,38 +11,32 @@ var ReportGenerator = class {
    * Generate SARIF report from lint results
    */
   static async generateSarifReport(results, options) {
-    try {
-      const builder = new SarifBuilder();
-      const runBuilder = new SarifRunBuilder().initSimple({
-        toolDriverName: options.toolName,
-        toolDriverVersion: options.toolVersion,
-        url: "https://github.com/salesforce-ux/slds-linter"
+    const builder = new SarifBuilder();
+    const runBuilder = new SarifRunBuilder().initSimple({
+      toolDriverName: options.toolName,
+      toolDriverVersion: options.toolVersion,
+      url: "https://github.com/salesforce-ux/slds-linter"
+    });
+    const rules = this.extractRules(results);
+    for (const rule of rules) {
+      const ruleBuilder = new SarifRuleBuilder().initSimple({
+        ruleId: replaceNamespaceinRules(rule.id),
+        shortDescriptionText: rule.shortDescription?.text
       });
-      const rules = this.extractRules(results);
-      for (const rule of rules) {
-        const ruleBuilder = new SarifRuleBuilder().initSimple({
-          ruleId: replaceNamespaceinRules(rule.id),
-          shortDescriptionText: rule.shortDescription?.text
-        });
-        runBuilder.addRule(ruleBuilder);
-      }
-      for (const result of results) {
-        this.addResultsToSarif(runBuilder, result);
-      }
-      builder.addRun(runBuilder);
-      const sarifReport = builder.buildSarifOutput();
-      const outputDir = path.dirname(options.outputPath);
-      await fs.mkdir(outputDir, { recursive: true });
-      const writeStream = createWriteStream(options.outputPath);
-      const jsonStream = new JsonStreamStringify(sarifReport, null, 2);
-      await new Promise((resolve, reject) => {
-        jsonStream.pipe(writeStream).on("finish", resolve).on("error", reject);
-      });
-      Logger.success(`SARIF report generated: ${options.outputPath}`);
-    } catch (error) {
-      Logger.error(`Failed to generate SARIF report: ${error.message}`);
-      throw error;
+      runBuilder.addRule(ruleBuilder);
+    }
+    for (const result of results) {
+      this.addResultsToSarif(runBuilder, result);
     }
+    builder.addRun(runBuilder);
+    const sarifReport = builder.buildSarifOutput();
+    const outputDir = path.dirname(options.outputPath);
+    await fs.mkdir(outputDir, { recursive: true });
+    const writeStream = createWriteStream(options.outputPath);
+    const jsonStream = new JsonStreamStringify(sarifReport, null, 2);
+    await new Promise((resolve, reject) => {
+      jsonStream.pipe(writeStream).on("finish", resolve).on("error", reject);
+    });
   }
   /**
    * Extract unique rules from results

package/build/types/index.d.ts

@@ -2,8 +2,7 @@ export interface CliOptions {
     directory?: string;
     output?: string;
     fix?: boolean;
-    config?: string;
-    configStyle?: string;
+    configStylelint?: string;
     configEslint?: string;
     editor?: string;
 }

package/build/utils/cli-args.d.ts

@@ -1,4 +1,4 @@
 import { CliOptions } from "../types";
-export declare function validateAndNormalizeDirPath(inputPath?: string): string;
-export declare function validateAndNormalizeOutputPath(inputPath?: string): string;
+export declare function nomalizeAndValidatePath(inputPath?: string): string;
+export declare function nomalizeDirPath(inputPath?: string): string;
 export declare function normalizeCliOptions(options: CliOptions, defultOptions?: Partial<CliOptions>): Required<CliOptions>;

package/build/utils/cli-args.js

@@ -1,13 +1,8 @@
 // src/utils/cli-args.ts
 import path from "path";
 import { accessSync } from "fs";
-function validateAndNormalizeDirPath(inputPath) {
-  if (!inputPath) {
-    return process.cwd();
-  }
-  return inputPath;
-}
-function validateAndNormalizeOutputPath(inputPath) {
+import { isDynamicPattern } from "globby";
+function nomalizeAndValidatePath(inputPath) {
   if (!inputPath) {
     return process.cwd();
   }
@@ -19,21 +14,29 @@ function validateAndNormalizeOutputPath(inputPath) {
     throw new Error(`Invalid path: ${inputPath}`);
   }
 }
+function nomalizeDirPath(inputPath) {
+  if (!inputPath) {
+    return process.cwd();
+  }
+  if (isDynamicPattern(inputPath)) {
+    return inputPath;
+  }
+  return nomalizeAndValidatePath(inputPath);
+}
 function normalizeCliOptions(options, defultOptions = {}) {
   return {
     fix: false,
     editor: "vscode",
-    config: "",
-    configStyle: "",
+    configStylelint: "",
     configEslint: "",
     ...defultOptions,
     ...options,
-    directory: validateAndNormalizeDirPath(options.directory),
-    output: validateAndNormalizeOutputPath(options.output)
+    directory: nomalizeDirPath(options.directory),
+    output: nomalizeAndValidatePath(options.output)
   };
 }
 export {
-  normalizeCliOptions,
-  validateAndNormalizeDirPath,
-  validateAndNormalizeOutputPath
+  nomalizeAndValidatePath,
+  nomalizeDirPath,
+  normalizeCliOptions
 };

package/build/utils/lintResultsUtil.js

@@ -13,8 +13,7 @@ function printLintResults(results, editor) {
     if (!hasErrors && !hasWarnings) return;
     const absolutePath = result.filePath || "";
     const relativeFile = path.relative(process.cwd(), absolutePath) || "Unknown file";
-    Logger.info(`
-${chalk.bold(relativeFile)}`);
+    Logger.newLine().info(`${chalk.bold(relativeFile)}`);
     if (hasErrors) {
       result.errors.forEach((error) => {
         if (error.line && error.column && absolutePath) {

package/build/utils/logger.d.ts

@@ -1,4 +1,5 @@
 export declare class Logger {
+    static newLine(): typeof Logger;
     static info(message: string): void;
     static success(message: string): void;
     static warning(message: string): void;

package/build/utils/logger.js

@@ -1,6 +1,10 @@
 // src/utils/logger.ts
 import chalk from "chalk";
 var Logger = class {
+  static newLine() {
+    console.log("\n");
+    return this;
+  }
   static info(message) {
     console.log(chalk.blue("\u2139"), message);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce-ux/slds-linter",
-  "version": "0.1.3",
+  "version": "0.1.4-alpha.0",
   "description": "SLDS Linter CLI tool for linting styles and components",
   "keywords": [
     "lightning design system linter",
@@ -20,14 +20,14 @@
     "slds-linter": "./build/index.js"
   },
   "dependencies": {
-    "@salesforce-ux/eslint-plugin-slds": "0.1.3",
-    "@salesforce-ux/stylelint-plugin-slds": "0.1.3",
+    "@salesforce-ux/eslint-plugin-slds": "0.1.4-alpha.0",
+    "@salesforce-ux/stylelint-plugin-slds": "0.1.4-alpha.0",
     "@typescript-eslint/eslint-plugin": "^5.0.0",
     "@typescript-eslint/parser": "^5.0.0",
     "chalk": "^4.1.2",
     "commander": "^13.1.0",
     "eslint": "^8.0.0",
-    "glob": "^11.0.0",
+    "globby": "^14.1.0",
     "import-meta-resolve": "^4.1.0",
     "json-stream-stringify": "^3.1.6",
     "node-sarif-builder": "^3.2.0",

package/build/commands/lint-components.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerLintComponentsCommand(program: Command): void;

package/build/commands/lint-components.js

@@ -1,52 +0,0 @@
-// src/commands/lint-components.ts
-import chalk from "chalk";
-import { printLintResults } from "../utils/lintResultsUtil.js";
-import { normalizeCliOptions } from "../utils/cli-args.js";
-import { Logger } from "../utils/logger.js";
-import { FileScanner } from "../services/file-scanner.js";
-import { ComponentFilePatterns } from "../services/file-patterns.js";
-import { LintRunner } from "../services/lint-runner.js";
-import { DEFAULT_ESLINT_CONFIG_PATH } from "../services/config.resolver.js";
-function registerLintComponentsCommand(program) {
-  program.command("lint:components").description("Run eslint on all markup files").option("-d, --directory <path>", "Target directory to scan (defaults to current directory)").option("--fix", "Automatically fix problems").option("--config <path>", "Path to eslint config file").option("--editor <editor>", "Editor to open files with (vscode, atom, sublime). Defaults to vscode", "vscode").action(async (options) => {
-    const startTime = Date.now();
-    try {
-      Logger.info(chalk.blue("Starting linting of component files..."));
-      const normalizedOptions = normalizeCliOptions(options, {
-        config: DEFAULT_ESLINT_CONFIG_PATH
-      });
-      Logger.info(chalk.blue("Scanning for files..."));
-      const fileBatches = await FileScanner.scanFiles(normalizedOptions.directory, {
-        patterns: ComponentFilePatterns,
-        batchSize: 100
-      });
-      const totalFiles = fileBatches.reduce((sum, batch) => sum + batch.length, 0);
-      Logger.info(chalk.blue(`Scanned ${totalFiles} file(s).`));
-      Logger.info(chalk.blue(`Running linting${normalizedOptions.fix ? " with autofix" : ""}...`));
-      const results = await LintRunner.runLinting(fileBatches, "component", {
-        fix: normalizedOptions.fix,
-        configPath: normalizedOptions.config
-      });
-      printLintResults(results, normalizedOptions.editor);
-      const errorCount = results.reduce((sum, r) => sum + r.errors.length, 0);
-      const warningCount = results.reduce((sum, r) => sum + r.warnings.length, 0);
-      Logger.info(
-        chalk.blue(
-          `
-Summary: Processed ${totalFiles} file(s) with ${chalk.red(
-            errorCount.toString()
-          )} error(s) and ${chalk.yellow(warningCount.toString())} warning(s).`
-        )
-      );
-      const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
-      Logger.success(chalk.green(`Component files linting completed in ${elapsedTime} seconds.`));
-      process.exit(errorCount > 0 ? 1 : 0);
-    } catch (error) {
-      Logger.error(chalk.red(`Error during linting: ${error.message}`));
-      process.exit(1);
-    }
-  });
-}
-export {
-  registerLintComponentsCommand
-};

package/build/commands/lint-styles.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerLintStylesCommand(program: Command): void;

package/build/commands/lint-styles.js

@@ -1,52 +0,0 @@
-// src/commands/lint-styles.ts
-import chalk from "chalk";
-import { printLintResults } from "../utils/lintResultsUtil.js";
-import { normalizeCliOptions } from "../utils/cli-args.js";
-import { Logger } from "../utils/logger.js";
-import { FileScanner } from "../services/file-scanner.js";
-import { StyleFilePatterns } from "../services/file-patterns.js";
-import { LintRunner } from "../services/lint-runner.js";
-import { DEFAULT_STYLELINT_CONFIG_PATH } from "../services/config.resolver.js";
-function registerLintStylesCommand(program) {
-  program.command("lint:styles").description("Run stylelint on all style files").option("-d, --directory <path>", "Target directory to scan (defaults to current directory)").option("--fix", "Automatically fix problems").option("--config <path>", "Path to stylelint config file").option("--editor <editor>", "Editor to open files with (vscode, atom, sublime). Defaults to vscode", "vscode").action(async (options) => {
-    const startTime = Date.now();
-    try {
-      Logger.info(chalk.blue("Starting linting of style files..."));
-      const normalizedOptions = normalizeCliOptions(options, {
-        config: DEFAULT_STYLELINT_CONFIG_PATH
-      });
-      Logger.info(chalk.blue("Scanning for style files..."));
-      const fileBatches = await FileScanner.scanFiles(normalizedOptions.directory, {
-        patterns: StyleFilePatterns,
-        batchSize: 100
-      });
-      const totalFiles = fileBatches.reduce((sum, batch) => sum + batch.length, 0);
-      Logger.info(chalk.blue(`Scanned ${totalFiles} file(s).`));
-      Logger.info(chalk.blue(`Running stylelint${normalizedOptions.fix ? " with autofix" : ""}...`));
-      const results = await LintRunner.runLinting(fileBatches, "style", {
-        fix: normalizedOptions.fix,
-        configPath: normalizedOptions.config
-      });
-      printLintResults(results, normalizedOptions.editor);
-      const errorCount = results.reduce((sum, r) => sum + r.errors.length, 0);
-      const warningCount = results.reduce((sum, r) => sum + r.warnings.length, 0);
-      Logger.info(
-        chalk.blue(
-          `
-Summary: Processed ${totalFiles} file(s) with ${chalk.red(
-            errorCount.toString()
-          )} error(s) and ${chalk.yellow(warningCount.toString())} warning(s).`
-        )
-      );
-      const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
-      Logger.success(chalk.green(`Style files linting completed in ${elapsedTime} seconds.`));
-      process.exit(errorCount > 0 ? 1 : 0);
-    } catch (error) {
-      Logger.error(chalk.red(`Error during linting: ${error.message}`));
-      process.exit(1);
-    }
-  });
-}
-export {
-  registerLintStylesCommand
-};