@salesforce-ux/slds-linter 1.0.10-internal → 1.1.0-internal

package/build/commands/lint.js

@@ -27,7 +27,7 @@ function registerLintCommand(program) {
         ));
       }
       const lintResults = await lint(normalizedOptions);
-      const { totalErrors } = printLintResults(lintResults, normalizedOptions.editor);
+      const { totalErrors } = printLintResults(lintResults, { editor: normalizedOptions.editor });
       const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
       Logger.newLine().success(`Linting completed in ${elapsedTime} seconds.`);
       process.exit(totalErrors > 0 ? 1 : 0);

package/build/executor/index.d.ts

@@ -17,4 +17,13 @@ export declare function lint(config: LintConfig): Promise<LintResult[]>;
  * @throws Error if report generation fails
  */
 export declare function report(config: ReportConfig, results?: LintResult[]): Promise<Readable>;
+/**
+ * This function supports user to supply array of files to be linted
+ *
+ * @param files Array of file paths to be linted
+ * @param config Linting configuration options
+ * @returns Promise resolving to an array of lint results
+ * @throws Error if linting fails or if any file is not found
+ */
+export declare function lintFiles(files: string[], config: LintConfig): Promise<LintResult[]>;
 export type { LintResult, LintResultEntry, LintConfig, ReportConfig, ExitCode, WorkerResult, SarifResultEntry } from '../types';

package/build/executor/index.js

@@ -69,7 +69,31 @@ async function report(config, results) {
     throw new Error(errorMessage);
   }
 }
+async function lintFiles(files, config) {
+  try {
+    Logger.debug("Starting linting with Node API");
+    const normalizedConfig = normalizeCliOptions(config, {
+      configEslint: DEFAULT_ESLINT_CONFIG_PATH
+    });
+    const batches = FileScanner.createBatches(files, FileScanner.DEFAULT_BATCH_SIZE);
+    Logger.debug(
+      `Found ${files.length} files, split into ${batches.length} batches`
+    );
+    const results = await LintRunner.runLinting(batches, {
+      fix: normalizedConfig.fix,
+      configPath: normalizedConfig.configEslint,
+      // when linting files, use the directory of the files as the working directory
+      cwd: normalizedConfig.directory
+    });
+    return results;
+  } catch (error) {
+    const errorMessage = `Linting failed: ${error.message}`;
+    Logger.error(errorMessage);
+    throw new Error(errorMessage);
+  }
+}
 export {
   lint,
+  lintFiles,
   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.10-internal");
+  program.description("SLDS Linter CLI tool for linting styles and components").version("1.1.0-internal");
 }
 registerLintCommand(program);
 registerReportCommand(program);

package/build/services/config.resolver.js

@@ -3,7 +3,7 @@ import { resolvePath } from "../utils/nodeVersionUtil.js";
 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.10-internal";
+var LINTER_CLI_VERSION = "1.1.0-internal";
 var getRuleDescription = (ruleId) => {
   const ruleIdWithoutNameSpace = `${ruleId}`.replace(/\@salesforce-ux\//, "").replace(/^slds\//, "");
   return ruleMessages[ruleIdWithoutNameSpace]?.description || "--";

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

@@ -1,6 +1,6 @@
 import { ScanOptions, ScanResult } from "../types";
 export declare class FileScanner {
-    private static DEFAULT_BATCH_SIZE;
+    static DEFAULT_BATCH_SIZE: number;
     /**
      * Scans directory for files matching the given patterns
      * @param directory Base directory to scan
@@ -15,5 +15,5 @@ export declare class FileScanner {
     /**
      * Splits array of files into batches
      */
-    private static createBatches;
+    static createBatches(files: string[], batchSize: number): string[][];
 }

package/build/services/lint-runner.js

@@ -18,7 +18,8 @@ var LintRunner = class {
       const configPath = await ConfigLoader.processConfig(options.configPath);
       const workerConfig = {
         configPath,
-        fix: options.fix
+        fix: options.fix,
+        cwd: options.cwd
       };
       const results = await BatchProcessor.processBatches(
         fileBatches,

package/build/types/index.d.ts

@@ -27,18 +27,17 @@ export interface LintConfig extends BaseConfig {
 export interface ReportConfig extends BaseConfig {
     format?: 'sarif' | 'csv';
 }
-export interface LintRunnerOptions {
-    fix?: boolean;
-    configPath?: string;
-    maxWorkers?: number;
-    timeoutMs?: number;
-}
 export type LintResultEntry = Linter.LintMessage;
 export type LintResult = ESLint.LintResult;
 export type ExitCode = 0 | 1 | 2;
 export interface WorkerConfig {
     configPath?: string;
     fix?: boolean;
+    cwd?: string;
+}
+export interface LintRunnerOptions extends WorkerConfig {
+    maxWorkers?: number;
+    timeoutMs?: number;
 }
 export interface WorkerResult {
     filePath: string;
@@ -74,3 +73,7 @@ export interface ScanResult {
     filesCount: number;
     batches: string[][];
 }
+export interface PrintOptions {
+    editor?: string;
+    cwd?: string;
+}

package/build/utils/lintResultsUtil.d.ts

@@ -1,4 +1,4 @@
-import { LintResult, LintResultEntry, SarifResultEntry, LintResultSummary } from '../types';
+import { LintResult, LintResultEntry, SarifResultEntry, LintResultSummary, PrintOptions } 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): LintResultSummary;
+export declare function printLintResults(results: LintResult[], options?: PrintOptions): LintResultSummary;
 export declare function transformedResults(lintResult: LintResult, entry: LintResultEntry, level: 'error' | 'warning'): SarifResultEntry;

package/build/utils/lintResultsUtil.js

@@ -44,7 +44,7 @@ function printFixableViolationsSummary(fixableErrors, fixableWarnings) {
   }
   console.log(`  ${fixableBreakdown.join(" and ")} potentially fixable with the \`--fix\` option.`);
 }
-function printLintResults(results, editor) {
+function printLintResults(results, options) {
   let totalErrors = 0;
   let totalWarnings = 0;
   let fixableErrors = 0;
@@ -52,7 +52,7 @@ function printLintResults(results, editor) {
   results.forEach((result) => {
     if (!result.messages || result.messages.length === 0) return;
     const absolutePath = result.filePath || "";
-    const relativeFile = path.relative(process.cwd(), absolutePath) || "Unknown file";
+    const relativeFile = path.relative(options?.cwd || process.cwd(), absolutePath) || "Unknown file";
     console.log(`
 ${Colors.info.underline(relativeFile)}
 `);
@@ -68,7 +68,7 @@ ${Colors.info.underline(relativeFile)}
         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 clickableLineCol = msg.line && msg.column ? createClickableLineCol(lineCol, absolutePath, msg.line, msg.column, options?.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)) : "";

package/build/workers/eslint.worker.js

@@ -6,10 +6,14 @@ var ESLintWorker = class extends BaseWorker {
   eslint;
   constructor() {
     super();
-    this.eslint = new ESLint({
+    const linterOptions = {
       overrideConfigFile: this.task.config.configPath,
       fix: this.task.config.fix
-    });
+    };
+    if ("cwd" in this.task.config) {
+      linterOptions.cwd = this.task.config.cwd;
+    }
+    this.eslint = new ESLint(linterOptions);
   }
   async processFile(filePath) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce-ux/slds-linter",
-  "version": "1.0.10-internal",
+  "version": "1.1.0-internal",
   "description": "SLDS Linter CLI tool for linting styles and components",
   "keywords": [
     "lightning design system linter",
@@ -29,7 +29,7 @@
   ],
   "bin": "build/index.js",
   "dependencies": {
-    "@salesforce-ux/eslint-plugin-slds": "1.0.10-internal",
+    "@salesforce-ux/eslint-plugin-slds": "1.1.0-internal",
     "@typescript-eslint/eslint-plugin": "^8.36.0",
     "@typescript-eslint/parser": "^8.36.0",
     "chalk": "^4.1.2",