@futdevpro/dynamo-eslint 1.14.3 → 1.14.4

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": "01.14.4",
   "description": "Shared ESLint configs, Dynamo-powered plugin and validators for FutDevPro stacks",
   "author": "Future Development Program Ltd.",
   "license": "ISC",

package/src/configs/base.ts

@@ -51,7 +51,7 @@ module.exports = [
       // ESLint recommended rules
       'no-warning-comments': ['warn', { terms: ['todo', 'fixme', 'removable', '??'], location: 'anywhere' }],
       'indent': ['warn', 2, { SwitchCase: 1 }],
-      'max-len': ['warn', { code: 100, comments: 120 }],
+      'max-len': ['warn', { code: 120, comments: 120 }],
       'max-lines': ['warn', 1000],
       'linebreak-style': 'off',
       'semi': ['warn', 'always'],
@@ -85,6 +85,7 @@ module.exports = [
       '@typescript-eslint/typedef': 'warn',
       
       // Dynamo custom rules
+      '@futdevpro/dynamo/explicit-types': 'warn',
       '@futdevpro/dynamo/import-order': 'warn',
       '@futdevpro/dynamo/naming-patterns': 'warn',
       '@futdevpro/dynamo/no-import-type': 'warn',

package/src/plugin/index.ts

@@ -1,3 +1,4 @@
+import explicitTypesRule from './rules/explicit-types';
 import importOrderRule from './rules/import/import-order';
 import namingPatternsRule from './rules/naming-patterns';
 import noImportTypeRule from './rules/import/no-import-type';
@@ -5,6 +6,7 @@ import noJsExtensionRule from './rules/import/no-js-import';
 
 export = {
   rules: {
+    'explicit-types': explicitTypesRule,
     'import-order': importOrderRule,
     'no-import-type': noImportTypeRule,
     'no-js-import': noJsExtensionRule,
@@ -14,6 +16,7 @@ export = {
   configs: {
     recommended: {
       rules: {
+        '@futdevpro/dynamo/explicit-types': 'warn',
         '@futdevpro/dynamo/import-order': 'warn',
         '@futdevpro/dynamo/no-import-type': 'warn',
         '@futdevpro/dynamo/no-js-import': 'warn',

package/src/plugin/rules/explicit-types.spec.ts

@@ -0,0 +1,190 @@
+import explicitTypesRule from './explicit-types';
+
+describe('| explicit-types', () => {
+  it('| should be a valid ESLint rule', () => {
+    expect(explicitTypesRule.meta?.type).toBe('suggestion');
+    expect(explicitTypesRule.meta?.docs?.description).toContain('explicit type annotations');
+  });
+
+  it('| should have create function that returns visitor object', () => {
+    const mockContext = {
+      report: () => {},
+    } as any;
+
+    const result = explicitTypesRule.create(mockContext);
+
+    expect(typeof result).toBe('object');
+    expect(typeof result.FunctionDeclaration).toBe('function');
+    expect(typeof result.ArrowFunctionExpression).toBe('function');
+    expect(typeof result.VariableDeclarator).toBe('function');
+    expect(typeof result.PropertyDefinition).toBe('function');
+  });
+
+  it('| should report missing return types on function declarations', () => {
+    const mockContext = {
+      report: (options: any) => {
+        expect(options.messageId).toBe('missingReturnType');
+        expect(options.data.name).toBe('testFunction');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'FunctionDeclaration' as const,
+      id: { name: 'testFunction' },
+      returnType: null,
+      params: [],
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.FunctionDeclaration(mockNode);
+  });
+
+  it('| should not report when function has return type', () => {
+    const mockContext = {
+      report: (options: any) => {
+        fail('Should not report when function has return type');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'FunctionDeclaration' as const,
+      id: { name: 'testFunction' },
+      returnType: { type: 'TSTypeAnnotation' },
+      params: [],
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.FunctionDeclaration(mockNode);
+  });
+
+  it('| should report missing return types on arrow functions', () => {
+    const mockContext = {
+      report: (options: any) => {
+        expect(options.messageId).toBe('missingArrowReturnType');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'ArrowFunctionExpression' as const,
+      returnType: null,
+      params: [],
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.ArrowFunctionExpression(mockNode);
+  });
+
+  it('| should report missing types on variable declarations', () => {
+    const mockContext = {
+      report: (options: any) => {
+        expect(options.messageId).toBe('missingVariableType');
+        expect(options.data.name).toBe('testVar');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'VariableDeclarator' as const,
+      id: { name: 'testVar', typeAnnotation: null },
+      init: null,
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.VariableDeclarator(mockNode);
+  });
+
+  it('| should not report when variable has type annotation', () => {
+    const mockContext = {
+      report: (options: any) => {
+        fail('Should not report when variable has type annotation');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'VariableDeclarator' as const,
+      id: { name: 'testVar', typeAnnotation: { type: 'TSTypeAnnotation' } },
+      init: null,
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.VariableDeclarator(mockNode);
+  });
+
+  it('| should not report when variable has typed initializer', () => {
+    const mockContext = {
+      report: (options: any) => {
+        fail('Should not report when variable has typed initializer');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'VariableDeclarator' as const,
+      id: { name: 'testVar', typeAnnotation: null },
+      init: { type: 'CallExpression' },
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.VariableDeclarator(mockNode);
+  });
+
+  it('| should report missing parameter types', () => {
+    const mockContext = {
+      report: (options: any) => {
+        expect(options.messageId).toBe('missingParameterType');
+        expect(options.data.name).toBe('param');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'FunctionDeclaration' as const,
+      id: { name: 'testFunction' },
+      returnType: { type: 'TSTypeAnnotation' },
+      params: [
+        { type: 'Identifier', name: 'param', typeAnnotation: null }
+      ],
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.FunctionDeclaration(mockNode);
+  });
+
+  it('| should report missing class property types', () => {
+    const mockContext = {
+      report: (options: any) => {
+        expect(options.messageId).toBe('missingPropertyType');
+        expect(options.data.name).toBe('property');
+      },
+    } as any;
+
+    const mockNode = {
+      type: 'PropertyDefinition' as const,
+      key: { name: 'property' },
+      typeAnnotation: null,
+      value: null,
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.PropertyDefinition(mockNode);
+  });
+
+  it('| should report missing destructuring types', () => {
+    const mockContext = {
+      report: (options: any) => {
+        expect(options.messageId).toBe('missingDestructuringType');
+      },
+    } as any;
+
+    const objectPatternNode = {
+      type: 'ObjectPattern' as const,
+      typeAnnotation: null,
+    } as any;
+
+    const arrayPatternNode = {
+      type: 'ArrayPattern' as const,
+      typeAnnotation: null,
+    } as any;
+
+    const rule = explicitTypesRule.create(mockContext);
+    rule.ObjectPattern(objectPatternNode);
+    rule.ArrayPattern(arrayPatternNode);
+  });
+});