@futdevpro/dynamo-eslint 1.14.3 → 1.14.6

package/build/scripts/fix-return-types.js

@@ -1,14 +1,56 @@
 #!/usr/bin/env node
 "use strict";
+/**
+ * @fileoverview TypeScript Type Annotation Fix Script
+ *
+ * This script uses TypeScript's AST (Abstract Syntax Tree) to automatically add
+ * type annotations to functions and arrow functions. It analyzes TypeScript files,
+ * infers return types using the TypeScript compiler, and adds explicit type
+ * annotations where missing.
+ *
+ * @usage
+ * ```bash
+ * dynamo-fix-return-types
+ * ```
+ *
+ * @example
+ * ```bash
+ * # Fix type annotations in all TypeScript files
+ * npx dynamo-fix-return-types
+ *
+ * # Or run via npm script
+ * npm run fix:types
+ * ```
+ *
+ * @author Future Development Program Ltd.
+ * @version 1.14.3
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const ts = tslib_1.__importStar(require("typescript"));
 const fs = tslib_1.__importStar(require("fs"));
 const fast_glob_1 = tslib_1.__importDefault(require("fast-glob"));
 const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-function addReturnTypesToFile(filePath) {
+/**
+ * Adds type annotations to functions and arrow functions in a TypeScript file
+ *
+ * Uses TypeScript's compiler API to analyze the file, infer return types,
+ * and automatically add explicit type annotations where missing.
+ *
+ * @param filePath - Path to the TypeScript file to process
+ * @returns FixResult object containing statistics about the changes made
+ *
+ * @example
+ * ```typescript
+ * const result = addTypesToFile('./src/utils.ts');
+ * console.log(`Added ${result.changes} type annotations to ${result.file}`);
+ * ```
+ */
+function addTypesToFile(filePath) {
+    // Read and parse the source file
     const sourceCode = fs.readFileSync(filePath, 'utf8');
     const sourceFile = ts.createSourceFile(filePath, sourceCode, ts.ScriptTarget.Latest, true);
+    // Create TypeScript program for type checking
     const program = ts.createProgram([filePath], {
         target: ts.ScriptTarget.Latest,
         module: ts.ModuleKind.ESNext,
@@ -18,13 +60,20 @@ function addReturnTypesToFile(filePath) {
     const checker = program.getTypeChecker();
     let changes = 0;
     let hasChanges = false;
+    /**
+     * Recursively visits AST nodes and adds type annotations where needed
+     *
+     * @param node - The current AST node being visited
+     * @returns The potentially modified AST node
+     */
     function visit(node) {
-        // Handle function declarations
+        // Handle function declarations without return types
         if (ts.isFunctionDeclaration(node) && !node.type) {
             const signature = checker.getSignatureFromDeclaration(node);
             if (signature) {
                 const returnType = checker.getReturnTypeOfSignature(signature);
                 const typeString = checker.typeToString(returnType);
+                // Add type annotation if it's not void or any
                 if (typeString !== 'void' && typeString !== 'any') {
                     const newType = ts.factory.createTypeReferenceNode(typeString);
                     const updatedNode = ts.factory.updateFunctionDeclaration(node, node.modifiers, node.asteriskToken, node.name, node.typeParameters, node.parameters, newType, node.body);
@@ -34,12 +83,13 @@ function addReturnTypesToFile(filePath) {
                 }
             }
         }
-        // Handle arrow functions
+        // Handle arrow functions without return types
         if (ts.isArrowFunction(node) && !node.type) {
             const signature = checker.getSignatureFromDeclaration(node);
             if (signature) {
                 const returnType = checker.getReturnTypeOfSignature(signature);
                 const typeString = checker.typeToString(returnType);
+                // Add type annotation if it's not void or any
                 if (typeString !== 'void' && typeString !== 'any') {
                     const newType = ts.factory.createTypeReferenceNode(typeString);
                     const updatedNode = ts.factory.updateArrowFunction(node, node.modifiers, node.typeParameters, node.parameters, newType, node.equalsGreaterThanToken, node.body);
@@ -49,9 +99,14 @@ function addReturnTypesToFile(filePath) {
                 }
             }
         }
+        // Note: Variable declarations, parameters, and class properties
+        // are handled by the existing @typescript-eslint/typedef rule
+        // and can be auto-fixed with eslint --fix
         return ts.visitEachChild(node, visit, {});
     }
+    // Transform the AST and apply changes
     const result = ts.visitEachChild(sourceFile, visit, {});
+    // Write the modified code back to the file if changes were made
     if (hasChanges) {
         const printer = ts.createPrinter();
         const newSourceCode = printer.printFile(result);
@@ -63,7 +118,18 @@ function addReturnTypesToFile(filePath) {
         changes,
     };
 }
+/**
+ * Main function that processes all TypeScript files and adds type annotations
+ *
+ * Scans for all .ts and .tsx files in the project, processes each file to add
+ * missing type annotations, and provides comprehensive reporting on the results.
+ *
+ * @returns Promise that resolves when all files have been processed
+ *
+ * @throws {Error} When file processing fails
+ */
 async function main() {
+    // Find all TypeScript files, excluding common directories and test files
     const files = await (0, fast_glob_1.default)(['**/*.{ts,tsx}'], {
         ignore: [
             '**/node_modules/**',
@@ -73,35 +139,40 @@ async function main() {
             '**/*.test.ts',
         ],
     });
-    fsm_dynamo_1.DyFM_Log.log(`[fix-return-types] Processing ${files.length} files...`);
+    fsm_dynamo_1.DyFM_Log.log(`[fix-types] Processing ${files.length} files...`);
     const results = [];
     let totalFixed = 0;
     let totalChanges = 0;
+    // Process each file individually
     for (const file of files) {
         try {
-            const result = addReturnTypesToFile(file);
+            const result = addTypesToFile(file);
             results.push(result);
+            // Track successful fixes
             if (result.fixed) {
                 totalFixed++;
                 totalChanges += result.changes;
-                fsm_dynamo_1.DyFM_Log.log(`✅ Fixed ${result.changes} return types in ${file}`);
+                fsm_dynamo_1.DyFM_Log.log(`✅ Fixed ${result.changes} type annotations in ${file}`);
             }
         }
         catch (error) {
             fsm_dynamo_1.DyFM_Log.error(`❌ Error processing ${file}:`, error);
         }
     }
+    // Generate comprehensive summary report
     fsm_dynamo_1.DyFM_Log.log(`\n📊 Fix Summary:`);
     fsm_dynamo_1.DyFM_Log.log(`   Files processed: ${files.length}`);
     fsm_dynamo_1.DyFM_Log.log(`   Files fixed: ${totalFixed}`);
-    fsm_dynamo_1.DyFM_Log.log(`   Total return types added: ${totalChanges}`);
+    fsm_dynamo_1.DyFM_Log.log(`   Total type annotations added: ${totalChanges}`);
+    // Provide appropriate success/failure message
     if (totalFixed > 0) {
-        fsm_dynamo_1.DyFM_Log.log(`🎉 Successfully added return types to ${totalFixed} files!`);
+        fsm_dynamo_1.DyFM_Log.log(`🎉 Successfully added type annotations to ${totalFixed} files!`);
     }
     else {
-        fsm_dynamo_1.DyFM_Log.log('✅ No files needed return type fixes!');
+        fsm_dynamo_1.DyFM_Log.log('✅ No files needed type annotation fixes!');
     }
 }
+// Execute the main function and handle any errors
 main().catch((err) => {
     fsm_dynamo_1.DyFM_Log.error('Fix script failed:', err);
     process.exit(1);

package/build/scripts/fix-return-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"fix-return-types.js","sourceRoot":"","sources":["../../src/scripts/fix-return-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fix-return-types.js","sourceRoot":"","sources":["../../src/scripts/fix-return-types.ts"],"names":[],"mappings":"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"}

package/build/scripts/validate-imports.d.ts

@@ -1,3 +1,27 @@
 #!/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
+ */
 export {};
 //# sourceMappingURL=validate-imports.d.ts.map

package/build/scripts/validate-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-imports.d.ts","sourceRoot":"","sources":["../../src/scripts/validate-imports.ts"],"names":[],"mappings":""}
+{"version":3,"file":"validate-imports.d.ts","sourceRoot":"","sources":["../../src/scripts/validate-imports.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/build/scripts/validate-imports.js

@@ -1,11 +1,53 @@
 #!/usr/bin/env node
 "use strict";
+/**
+ * @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
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
 const fast_glob_1 = tslib_1.__importDefault(require("fast-glob"));
 const eslint_1 = require("eslint");
+/**
+ * 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) {
+    // Configure ESLint with Dynamo import-order rule
     const eslint = new eslint_1.ESLint({
         baseConfig: {
             parser: '@typescript-eslint/parser',
@@ -25,8 +67,10 @@ async function validateImportsInFile(filePath) {
             },
         },
     });
+    // 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 => ({
@@ -37,13 +81,26 @@ async function validateImportsInFile(filePath) {
         })),
     };
 }
+/**
+ * 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 (0, fast_glob_1.default)(['**/*.{ts,tsx}'], {
         ignore: ['**/node_modules/**', '**/build/**', '**/dist/**', '**/*.spec.ts', '**/*.test.ts'],
     });
     fsm_dynamo_1.DyFM_Log.log(`[dynamo-validate-imports] Scanning ${files.length} files...`);
     const results = [];
     let totalErrors = 0;
+    // Process each file individually
     for (const file of files) {
         try {
             const result = await validateImportsInFile(file);
@@ -54,12 +111,14 @@ async function main() {
             fsm_dynamo_1.DyFM_Log.error(`Error processing ${file}:`, error);
         }
     }
-    // Report results
+    // 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) {
         fsm_dynamo_1.DyFM_Log.log('✅ All import validations passed!');
         return;
     }
+    // Report detailed error information
     fsm_dynamo_1.DyFM_Log.warn(`\n❌ Found ${totalErrors} import validation errors in ${filesWithErrors.length} files:\n`);
     filesWithErrors.forEach(result => {
         fsm_dynamo_1.DyFM_Log.log(`📁 ${result.file}:`);
@@ -68,8 +127,10 @@ async function main() {
         });
         fsm_dynamo_1.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) => {
     fsm_dynamo_1.DyFM_Log.error('Validation failed:', err);
     process.exit(1);

package/build/scripts/validate-imports.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-imports.js","sourceRoot":"","sources":["../../src/scripts/validate-imports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate-imports.js","sourceRoot":"","sources":["../../src/scripts/validate-imports.ts"],"names":[],"mappings":"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"}

package/build/scripts/validate-naming.d.ts

@@ -1,3 +1,27 @@
 #!/usr/bin/env node
+/**
+ * @fileoverview Naming Convention Validation Script
+ *
+ * This script validates naming conventions across all TypeScript files in the project
+ * using the Dynamo naming-patterns ESLint rule. It scans files, runs ESLint validation,
+ * and reports any naming convention violations.
+ *
+ * @usage
+ * ```bash
+ * dynamo-validate-naming
+ * ```
+ *
+ * @example
+ * ```bash
+ * # Validate naming conventions in all TypeScript files
+ * npx dynamo-validate-naming
+ *
+ * # Or run via npm script
+ * npm run validate:naming
+ * ```
+ *
+ * @author Future Development Program Ltd.
+ * @version 1.14.3
+ */
 export {};
 //# sourceMappingURL=validate-naming.d.ts.map

package/build/scripts/validate-naming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-naming.d.ts","sourceRoot":"","sources":["../../src/scripts/validate-naming.ts"],"names":[],"mappings":""}
+{"version":3,"file":"validate-naming.d.ts","sourceRoot":"","sources":["../../src/scripts/validate-naming.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/build/scripts/validate-naming.js

@@ -1,19 +1,64 @@
 #!/usr/bin/env node
 "use strict";
+/**
+ * @fileoverview Naming Convention Validation Script
+ *
+ * This script validates naming conventions across all TypeScript files in the project
+ * using the Dynamo naming-patterns ESLint rule. It scans files, runs ESLint validation,
+ * and reports any naming convention violations.
+ *
+ * @usage
+ * ```bash
+ * dynamo-validate-naming
+ * ```
+ *
+ * @example
+ * ```bash
+ * # Validate naming conventions in all TypeScript files
+ * npx dynamo-validate-naming
+ *
+ * # Or run via npm script
+ * npm run validate:naming
+ * ```
+ *
+ * @author Future Development Program Ltd.
+ * @version 1.14.3
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const fast_glob_1 = tslib_1.__importDefault(require("fast-glob"));
 const eslint_1 = require("eslint");
 const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * Validates naming conventions in a single TypeScript file
+ *
+ * Uses ESLint with the Dynamo naming-patterns rule to check for naming convention
+ * violations and returns detailed error information.
+ *
+ * @param filePath - Path to the TypeScript file to validate
+ * @returns Promise that resolves to a NamingValidationResult object
+ *
+ * @example
+ * ```typescript
+ * const result = await validateNamingInFile('./src/components/Button.tsx');
+ * if (result.errors.length > 0) {
+ *   console.log(`Found ${result.errors.length} naming violations`);
+ * }
+ * ```
+ */
 async function validateNamingInFile(filePath) {
+    // Configure ESLint using the main Dynamo configuration
     const eslint = new eslint_1.ESLint({
-        baseConfig: require('../eslint.config.js')[1], // Use the main config object from flat config array
+        // Use the main config object from flat config array
+        baseConfig: require('../eslint.config.js')[1],
     });
+    // 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 => ({
+        errors: result.messages.map((msg) => ({
             line: msg.line,
             column: msg.column,
             message: msg.message,
@@ -21,39 +66,57 @@ async function validateNamingInFile(filePath) {
         })),
     };
 }
+/**
+ * Main function that validates naming conventions across all TypeScript files
+ *
+ * Scans for all .ts and .tsx files in the project, validates naming conventions
+ * using the Dynamo naming-patterns 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 (0, fast_glob_1.default)(['**/*.{ts,tsx}'], {
         ignore: ['**/node_modules/**', '**/build/**', '**/dist/**', '**/*.spec.ts', '**/*.test.ts'],
     });
     fsm_dynamo_1.DyFM_Log.log(`[dynamo-validate-naming] Scanning ${files.length} files...`);
     const results = [];
     let totalErrors = 0;
-    for (const file of files) {
+    // Process each file individually
+    for (let i = 0; i < files.length; i++) {
+        const filePath = files[i];
         try {
-            const result = await validateNamingInFile(file);
+            const result = await validateNamingInFile(filePath);
             results.push(result);
             totalErrors += result.errors.length;
         }
         catch (error) {
-            fsm_dynamo_1.DyFM_Log.error(`Error processing ${file}:`, error);
+            fsm_dynamo_1.DyFM_Log.error(`Error processing ${filePath}:`, error);
         }
     }
-    // Report results
-    const filesWithErrors = results.filter(r => r.errors.length > 0);
+    // Filter files that have naming violations
+    const filesWithErrors = results.filter((r) => r.errors.length > 0);
+    // Report success if no violations found
     if (filesWithErrors.length === 0) {
         fsm_dynamo_1.DyFM_Log.log('✅ All naming validations passed!');
         return;
     }
+    // Report detailed error information
     fsm_dynamo_1.DyFM_Log.warn(`\n❌ Found ${totalErrors} naming validation errors in ${filesWithErrors.length} files:\n`);
-    filesWithErrors.forEach(result => {
+    filesWithErrors.forEach((result) => {
         fsm_dynamo_1.DyFM_Log.log(`📁 ${result.file}:`);
-        result.errors.forEach(error => {
+        result.errors.forEach((error) => {
             fsm_dynamo_1.DyFM_Log.log(`  ${error.line}:${error.column} - ${error.message}`);
         });
         fsm_dynamo_1.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) => {
     fsm_dynamo_1.DyFM_Log.error('Validation failed:', err);
     process.exit(1);

package/build/scripts/validate-naming.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-naming.js","sourceRoot":"","sources":["../../src/scripts/validate-naming.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate-naming.js","sourceRoot":"","sources":["../../src/scripts/validate-naming.ts"],"names":[],"mappings":"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"}

package/eslint.config.js

@@ -1,55 +1,15 @@
-// ESLint v9 flat config for self-linting this package
-// Uses nts-package ruleset with Dynamo custom rules
-
-const tsParser = require('@typescript-eslint/parser');
-const tsPlugin = require('@typescript-eslint/eslint-plugin');
-const unusedImportsPlugin = require('eslint-plugin-unused-imports');
-const maxParamsNoConstructorPlugin = require('eslint-plugin-max-params-no-constructor');
-
-// Load our plugin from build-test to avoid requiring a prior build
-const dynamoPlugin = (function loadDynamoPlugin() {
-  try {
-    // build-test compiled output for quick iteration
-    return require('./build-test/plugin').default || require('./build-test/plugin');
-  } catch {
-    // fallback: try built output if present
-    return require('./build/plugin');
-  }
-})();
-
-// Load nts-package config
 const ntsPackageConfig = require('./build/configs/nts-package');
 
 module.exports = [
-  { 
-    ignores: [
-      'build/**', 
-      'dist/**', 
-      'node_modules/**'
-    ] 
-  },
+  ...ntsPackageConfig,
   {
-    files: [
-      'src/**/*.ts'
-    ],
+    files: ['**/*.ts', '**/*.tsx'],
     languageOptions: {
-      parser: tsParser,
-      parserOptions: { 
-        ecmaVersion: 'latest', 
-        sourceType: 'module' 
-      },
-    },
-    plugins: {
-      '@typescript-eslint': tsPlugin,
-      '@futdevpro/dynamo': dynamoPlugin,
-      'unused-imports': unusedImportsPlugin,
-      'max-params-no-constructor': maxParamsNoConstructorPlugin,
-    },
-    rules: {
-      // Apply all nts-package rules (they're all compatible now!)
-      ...ntsPackageConfig.rules,
-    },
-  },
+      parser: require('@typescript-eslint/parser'),
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module'
+      }
+    }
+  }
 ];
-
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/dynamo-eslint",
-  "version": "01.14.3",
+  "version": "1.14.6",
   "description": "Shared ESLint configs, Dynamo-powered plugin and validators for FutDevPro stacks",
   "author": "Future Development Program Ltd.",
   "license": "ISC",

package/samples/package.json.example

@@ -13,7 +13,7 @@
     "test": "npm run lint && npm run validate:imports && npm run validate:naming"
   },
   "devDependencies": {
-    "@futdevpro/dynamo-eslint": "^01.14.2",
+    "@futdevpro/dynamo-eslint": "1.14.4",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",