@futdevpro/dynamo-eslint 1.15.25 → 1.15.28

package/src/scripts/validate-imports.ts

@@ -1,261 +1,278 @@
-#!/usr/bin/env node
-/**
- * @fileoverview Import Validation Script
- * 
- * This script validates import ordering across all TypeScript files in the project
- * using the Dynamo import-order ESLint rule. It scans files, runs ESLint validation,
- * and reports any import ordering violations.
- * 
- * @usage
- * ```bash
- * dynamo-validate-imports
- * ```
- * 
- * @example
- * ```bash
- * # Validate import ordering in all TypeScript files
- * npx dynamo-validate-imports
- * 
- * # Or run via npm script
- * npm run validate:imports
- * ```
- * 
- * @author Future Development Program Ltd.
- * @version 1.14.3
- */
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
-import fg from 'fast-glob';
-import { ESLint } from 'eslint';
-
-/**
- * Result of validating imports in a single file
- */
-interface ImportValidationResult {
-  /** Path to the file that was validated */
-  file: string;
-  /** Array of import validation errors found in the file */
-  errors: Array<{
-    /** Line number where the error occurred */
-    line: number;
-    /** Column number where the error occurred */
-    column: number;
-    /** Error message describing the violation */
-    message: string;
-    /** ID of the ESLint rule that was violated */
-    ruleId: string;
-  }>;
-}
-
-/**
- * Validates import ordering in a single TypeScript file
- * 
- * Uses ESLint with the Dynamo import-order rule to check for import ordering
- * violations and returns detailed error information.
- * 
- * @param filePath - Path to the TypeScript file to validate
- * @returns Promise that resolves to an ImportValidationResult object
- * 
- * @example
- * ```typescript
- * const result = await validateImportsInFile('./src/components/Button.tsx');
- * if (result.errors.length > 0) {
- *   console.log(`Found ${result.errors.length} import violations`);
- * }
- * ```
- */
-async function validateImportsInFile(filePath: string): Promise<ImportValidationResult> {
-  // Configure ESLint with Dynamo import-order rule
-  const eslint = new ESLint({
-    baseConfig: {
-      parser: '@typescript-eslint/parser',
-      parserOptions: {
-        ecmaVersion: 2020,
-        sourceType: 'module',
-      },
-      rules: {
-        '@futdevpro/dynamo/import-order': 'error',
-      },
-      plugins: {
-        '@futdevpro/dynamo': {
-          rules: {
-            'import-order': require('../plugin/rules/import/import-order').default,
-          },
-        },
-      },
-    } as any,
-  });
-
-  // Run ESLint on the file
-  const results = await eslint.lintFiles([ filePath ]);
-  const result = results[0];
-
-  // Transform ESLint messages into our result format
-  return {
-    file: filePath,
-    errors: result.messages.map(msg => ({
-      line: msg.line,
-      column: msg.column,
-      message: msg.message,
-      ruleId: msg.ruleId || 'unknown',
-    })),
-  };
-}
-
-/**
- * Main function that validates import ordering across all TypeScript files
- * 
- * Scans for all .ts and .tsx files in the project, validates import ordering
- * using the Dynamo import-order rule, and provides detailed reporting on any
- * violations found.
- * 
- * @returns Promise that resolves when all files have been validated
- * 
- * @throws {Error} When validation fails and process exits with code 1
- */
-async function main() {
-  // Find all TypeScript files, excluding common directories and test files
-  const files = await fg([ '**/*.{ts,tsx}' ], { 
-    ignore: [ '**/node_modules/**', '**/build/**', '**/dist/**', '**/*.spec.ts', '**/*.test.ts' ], 
-  });
-  
-  DyFM_Log.log(`[dynamo-validate-imports] Scanning ${files.length} files...`);
-  
-  const results: ImportValidationResult[] = [];
-  let totalErrors = 0;
-  let processingFailures = 0;
-
-  // Process each file individually
-  for (const file of files) {
-    try {
-      const result = await validateImportsInFile(file);
-
-      results.push(result);
-      totalErrors += result.errors.length;
-    } catch (error) {
-      DyFM_Log.error(`Error processing ${file}:`, error);
-      processingFailures++;
-    }
-  }
-
-  // BFR-PROTO-005: a feldolgozási hiba (pl. hiányzó runtime-modul) NEM nyelhető le zöldre —
-  // korábban minden fájl crash-elt, és a végén mégis "✅ passed" + exit 0 ment ki (fail-green).
-  if (processingFailures > 0) {
-    DyFM_Log.error(
-      `❌ ${processingFailures}/${files.length} file(s) FAILED to process (runtime/module error above) — ` +
-      'validation result is NOT trustworthy, failing hard.'
-    );
-    process.exit(1);
-  }
-
-  // Filter files that have import violations
-  const filesWithErrors = results.filter(r => r.errors.length > 0);
-
-  // Report success if no violations found
-  if (filesWithErrors.length === 0) {
-    DyFM_Log.log('✅ All import validations passed!');
-    return;
-  }
-
-  // Report detailed error information
-  DyFM_Log.warn(`\n❌ Found ${totalErrors} import validation errors in ${filesWithErrors.length} files:\n`);
-
-  filesWithErrors.forEach(result => {
-    DyFM_Log.log(`📁 ${result.file}:`);
-    result.errors.forEach(error => {
-      DyFM_Log.log(`  ${error.line}:${error.column} - ${error.message}`);
-    });
-    DyFM_Log.log('');
-  });
-
-  // Exit with error code to indicate validation failure
-  process.exit(1);
-}
-
-// Execute the main function and handle any errors
-main().catch((err) => {
-  DyFM_Log.error('Validation failed:', err);
-  process.exit(1);
-});
-
-
+#!/usr/bin/env node
+/**
+ * @fileoverview Import Validation Script
+ * 
+ * This script validates import ordering across all TypeScript files in the project
+ * using the Dynamo import-order ESLint rule. It scans files, runs ESLint validation,
+ * and reports any import ordering violations.
+ * 
+ * @usage
+ * ```bash
+ * dynamo-validate-imports
+ * ```
+ * 
+ * @example
+ * ```bash
+ * # Validate import ordering in all TypeScript files
+ * npx dynamo-validate-imports
+ * 
+ * # Or run via npm script
+ * npm run validate:imports
+ * ```
+ * 
+ * @author Future Development Program Ltd.
+ * @version 1.14.3
+ */
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+import { ESLint, Linter } from 'eslint';
+import fg from 'fast-glob';
+
+import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+import importOrderRule from '../plugin/rules/import/import-order';
+
+// The parser is a consumer-provided peer whose package exports require Node16 resolution, while this package
+// intentionally compiles with legacy Node resolution for fleet compatibility.
+// eslint-disable-next-line @futdevpro/dynamo/no-dynamic-imports, @typescript-eslint/no-require-imports
+const tsParser = require('@typescript-eslint/parser');
+
+/**
+ * Result of validating imports in a single file
+ */
+interface ImportValidationResult {
+  /** Path to the file that was validated */
+  file: string;
+  /** Array of import validation errors found in the file */
+  errors: {
+    /** Line number where the error occurred */
+    line: number;
+    /** Column number where the error occurred */
+    column: number;
+    /** Error message describing the violation */
+    message: string;
+    /** ID of the ESLint rule that was violated */
+    ruleId: string;
+  }[];
+}
+
+/**
+ * Validates import ordering in a single TypeScript file
+ * 
+ * Uses ESLint with the Dynamo import-order rule to check for import ordering
+ * violations and returns detailed error information.
+ * 
+ * @param filePath - Path to the TypeScript file to validate
+ * @returns Promise that resolves to an ImportValidationResult object
+ * 
+ * @example
+ * ```typescript
+ * const result = await validateImportsInFile('./src/components/Button.tsx');
+ * if (result.errors.length > 0) {
+ *   console.log(`Found ${result.errors.length} import violations`);
+ * }
+ * ```
+ */
+async function validateImportsInFile(filePath: string): Promise<ImportValidationResult> {
+  const eslint = new ESLint({
+    overrideConfigFile: true,
+    overrideConfig: [{
+      files: [ '**/*.{ts,tsx}' ],
+      linterOptions: {
+        reportUnusedDisableDirectives: 'off',
+      },
+      languageOptions: {
+        parser: tsParser,
+        parserOptions: {
+          ecmaVersion: 'latest',
+          sourceType: 'module',
+        },
+      },
+      plugins: {
+        '@futdevpro/dynamo': {
+          rules: {
+            'import-order': importOrderRule,
+          },
+        },
+      },
+      rules: {
+        '@futdevpro/dynamo/import-order': 'error',
+      },
+    }],
+  });
+
+  // Run ESLint on the file
+  const results: ESLint.LintResult[] = await eslint.lintFiles([ filePath ]);
+  const result: ESLint.LintResult = results[0];
+
+  // Transform ESLint messages into our result format
+  return {
+    file: filePath,
+    errors: result.messages.map((message: Linter.LintMessage): ImportValidationResult['errors'][number] => ({
+      line: message.line,
+      column: message.column,
+      message: message.message,
+      ruleId: message.ruleId || 'unknown',
+    })),
+  };
+}
+
+/**
+ * Main function that validates import ordering across all TypeScript files
+ * 
+ * Scans for all .ts and .tsx files in the project, validates import ordering
+ * using the Dynamo import-order rule, and provides detailed reporting on any
+ * violations found.
+ * 
+ * @returns Promise that resolves when all files have been validated
+ * 
+ * @throws {Error} When validation fails and process exits with code 1
+ */
+async function main(): Promise<void> {
+  // Find all TypeScript files, excluding common directories and test files
+  const files: string[] = await fg([ '**/*.{ts,tsx}' ], {
+    ignore: [ '**/node_modules/**', '**/build/**', '**/dist/**', '**/*.spec.ts', '**/*.test.ts' ], 
+  });
+  
+  DyFM_Log.log(`[dynamo-validate-imports] Scanning ${files.length} files...`);
+  
+  const results: ImportValidationResult[] = [];
+  let totalErrors = 0;
+  let processingFailures = 0;
+
+  // Process each file individually
+  for (const file of files) {
+    try {
+      const result: ImportValidationResult = await validateImportsInFile(file);
+
+      results.push(result);
+      totalErrors += result.errors.length;
+    } catch (error) {
+      DyFM_Log.error(`Error processing ${file}:`, error);
+      processingFailures++;
+    }
+  }
+
+  // BFR-PROTO-005: a feldolgozási hiba (pl. hiányzó runtime-modul) NEM nyelhető le zöldre —
+  // korábban minden fájl crash-elt, és a végén mégis "✅ passed" + exit 0 ment ki (fail-green).
+  if (processingFailures > 0) {
+    DyFM_Log.error(
+      `❌ ${processingFailures}/${files.length} file(s) FAILED to process (runtime/module error above) — ` +
+      'validation result is NOT trustworthy, failing hard.'
+    );
+    process.exit(1);
+  }
+
+  // Filter files that have import violations
+  const filesWithErrors: ImportValidationResult[] = results.filter(
+    (result: ImportValidationResult): boolean => result.errors.length > 0,
+  );
+
+  // Report success if no violations found
+  if (filesWithErrors.length === 0) {
+    DyFM_Log.log('✅ All import validations passed!');
+
+    return;
+  }
+
+  // Report detailed error information
+  DyFM_Log.warn(`\n❌ Found ${totalErrors} import validation errors in ${filesWithErrors.length} files:\n`);
+
+  filesWithErrors.forEach((result: ImportValidationResult): void => {
+    DyFM_Log.log(`📁 ${result.file}:`);
+    result.errors.forEach((error: ImportValidationResult['errors'][number]): void => {
+      DyFM_Log.log(`  ${error.line}:${error.column} - ${error.message}`);
+    });
+    DyFM_Log.log('');
+  });
+
+  // Exit with error code to indicate validation failure
+  process.exit(1);
+}
+
+// Execute the main function and handle any errors
+main().catch((err: Error): void => {
+  DyFM_Log.error('Validation failed:', err);
+  process.exit(1);
+});
+
+