@futdevpro/dynamo-eslint 1.15.25 → 1.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (146) hide show
  1. package/.c8rc.json +26 -26
  2. package/.cursor/rules/__assistant_guide.mdc +30 -30
  3. package/.cursor/rules/__main.mdc +64 -64
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_debug.mdc +7 -7
  7. package/.cursor/rules/_ag_documentation_writing_rules.mdc +372 -372
  8. package/.cursor/rules/_ag_file-refactoring.mdc +113 -113
  9. package/.cursor/rules/_ag_fixes_rules.mdc +5 -5
  10. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  11. package/.cursor/rules/_ag_frontend.mdc +39 -39
  12. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  13. package/.cursor/rules/_ag_naming.mdc +115 -115
  14. package/.cursor/rules/_ag_running_commands.mdc +4 -4
  15. package/.cursor/rules/_ag_server-controller.mdc +5 -5
  16. package/.cursor/rules/_ag_should-be.mdc +6 -6
  17. package/.cursor/rules/_ag_swearing.mdc +47 -47
  18. package/.cursor/rules/ai_development_guide.md +60 -60
  19. package/.cursor/rules/ai_directives.md +114 -114
  20. package/.cursor/rules/cursor-rules.md +160 -160
  21. package/.cursor/rules/default-command.mdc +464 -464
  22. package/.cursor/rules/error_code_pattern.md +39 -39
  23. package/.cursor/rules/saved rule mcp server use.md +15 -15
  24. package/.dynamo/pipeline.cicd.config.json +184 -184
  25. package/.dynamo/version-bump.config.json +5 -5
  26. package/.eslintrc.json +4 -4
  27. package/.github/workflows/main.yml +436 -436
  28. package/.husky/pre-commit +2 -2
  29. package/.vscode/settings.json +11 -11
  30. package/README.md +312 -315
  31. package/__documentations/2026-04-18-ccap-review-integration.md +173 -173
  32. package/__documentations/2026-08-18-bfr-ctm-005-eslint9-validator-report.md +45 -0
  33. package/__documentations/2026-08-22-angular-20-phase2-release.md +79 -0
  34. package/build/configs/base.d.ts +1 -2
  35. package/build/configs/base.d.ts.map +1 -1
  36. package/build/configs/base.js +3 -4
  37. package/build/configs/base.js.map +1 -1
  38. package/build/configs/ngx.d.ts +1 -3
  39. package/build/configs/ngx.d.ts.map +1 -1
  40. package/build/configs/ngx.js +4 -7
  41. package/build/configs/ngx.js.map +1 -1
  42. package/build/plugin/index.d.ts +24 -24
  43. package/build/plugin/rules/no-getter-logic.js +1 -1
  44. package/build/plugin/rules/no-getter-logic.js.map +1 -1
  45. package/build/plugin/rules/prefer-enum-over-string-union.js +7 -7
  46. package/build/plugin/rules/prefer-enum-over-string-union.js.map +1 -1
  47. package/build/plugin/rules/prefer-interface-over-duplicate-types.js +2 -2
  48. package/build/plugin/rules/prefer-interface-over-duplicate-types.js.map +1 -1
  49. package/build/plugin/rules/require-jsdoc-description.js +7 -7
  50. package/build/plugin/rules/require-jsdoc-description.js.map +1 -1
  51. package/build/scripts/dynamo-fix.js +1 -1
  52. package/build/scripts/dynamo-fix.js.map +1 -1
  53. package/build/scripts/fix-return-types.d.ts.map +1 -1
  54. package/build/scripts/fix-return-types.js.map +1 -1
  55. package/build/scripts/validate-imports.js +51 -27
  56. package/build/scripts/validate-imports.js.map +1 -1
  57. package/build/scripts/validate-naming.js +49 -10
  58. package/build/scripts/validate-naming.js.map +1 -1
  59. package/eslint.config.js +15 -15
  60. package/package.json +27 -28
  61. package/pnpm-workspace.yaml +2 -0
  62. package/samples/.vscode/settings.json +13 -13
  63. package/samples/base/.eslintrc.json +6 -6
  64. package/samples/base/eslint.config.js +3 -3
  65. package/samples/fsm/.eslintrc.json +4 -4
  66. package/samples/fsm/eslint.config.js +3 -3
  67. package/samples/ngx/.eslintrc.json +6 -6
  68. package/samples/ngx/eslint.config.js +3 -3
  69. package/samples/ngx-package/.eslintrc.json +4 -4
  70. package/samples/ngx-package/eslint.config.js +3 -3
  71. package/samples/nts/.eslintrc.json +6 -6
  72. package/samples/nts/eslint.config.js +3 -3
  73. package/samples/nts-package/.eslintrc.json +4 -4
  74. package/samples/nts-package/eslint.config.js +3 -3
  75. package/samples/package.json.example +22 -26
  76. package/samples/poc-sample.ts +38 -38
  77. package/samples/poc-violations.ts +54 -54
  78. package/scripts/run-coverage-tests.js +24 -24
  79. package/spec/support/helpers/ts-node-helper.js +9 -9
  80. package/spec/support/jasmine.coverage.json +23 -23
  81. package/spec/support/jasmine.json +24 -24
  82. package/src/configs/angular20-compatibility.spec.ts +62 -0
  83. package/src/configs/base.ts +156 -157
  84. package/src/configs/fsm.ts +10 -10
  85. package/src/configs/ngx-package.ts +10 -10
  86. package/src/configs/ngx.ts +92 -95
  87. package/src/configs/nts-package.ts +20 -20
  88. package/src/configs/nts.ts +34 -34
  89. package/src/index.ts +4 -4
  90. package/src/plugin/index.ts +86 -86
  91. package/src/plugin/rules/angular/angular-for-track-logic.spec.ts +44 -44
  92. package/src/plugin/rules/angular/angular-for-track-logic.ts +88 -88
  93. package/src/plugin/rules/angular/effect-signal-loop.spec.ts +89 -89
  94. package/src/plugin/rules/angular/effect-signal-loop.ts +125 -125
  95. package/src/plugin/rules/angular/no-async-ngoninit.spec.ts +50 -50
  96. package/src/plugin/rules/angular/no-async-ngoninit.ts +43 -43
  97. package/src/plugin/rules/angular/no-component-direct-api.spec.ts +78 -78
  98. package/src/plugin/rules/angular/no-component-direct-api.ts +82 -82
  99. package/src/plugin/rules/angular/no-method-call-in-template.spec.ts +63 -63
  100. package/src/plugin/rules/angular/no-method-call-in-template.ts +89 -89
  101. package/src/plugin/rules/angular/no-ngfor-directive.spec.ts +44 -44
  102. package/src/plugin/rules/angular/no-ngfor-directive.ts +62 -62
  103. package/src/plugin/rules/angular/no-ngif-directive.spec.ts +44 -44
  104. package/src/plugin/rules/angular/no-ngif-directive.ts +62 -62
  105. package/src/plugin/rules/explicit-types.spec.ts +190 -190
  106. package/src/plugin/rules/explicit-types.ts +186 -186
  107. package/src/plugin/rules/import/import-order.spec.ts +219 -219
  108. package/src/plugin/rules/import/import-order.ts +197 -197
  109. package/src/plugin/rules/import/no-import-type.spec.ts +69 -69
  110. package/src/plugin/rules/import/no-import-type.ts +46 -46
  111. package/src/plugin/rules/import/no-js-import.spec.ts +82 -82
  112. package/src/plugin/rules/import/no-js-import.ts +45 -45
  113. package/src/plugin/rules/naming-patterns.spec.ts +189 -189
  114. package/src/plugin/rules/naming-patterns.ts +426 -426
  115. package/src/plugin/rules/no-getter-logic.spec.ts +591 -591
  116. package/src/plugin/rules/no-getter-logic.ts +220 -220
  117. package/src/plugin/rules/prefer-enum-over-string-union.spec.ts +583 -583
  118. package/src/plugin/rules/prefer-enum-over-string-union.ts +333 -334
  119. package/src/plugin/rules/prefer-interface-over-duplicate-types.spec.ts +404 -404
  120. package/src/plugin/rules/prefer-interface-over-duplicate-types.ts +314 -314
  121. package/src/plugin/rules/require-jsdoc-description.spec.ts +779 -779
  122. package/src/plugin/rules/require-jsdoc-description.ts +572 -572
  123. package/src/plugin/rules/require-test-description-prefix.spec.ts +459 -459
  124. package/src/plugin/rules/require-test-description-prefix.ts +154 -154
  125. package/src/plugin/rules/ts/data-model-extends.spec.ts +84 -84
  126. package/src/plugin/rules/ts/data-model-extends.ts +100 -100
  127. package/src/plugin/rules/ts/no-any-type.spec.ts +28 -28
  128. package/src/plugin/rules/ts/no-any-type.ts +36 -36
  129. package/src/plugin/rules/ts/no-as-cast.spec.ts +51 -51
  130. package/src/plugin/rules/ts/no-as-cast.ts +51 -51
  131. package/src/plugin/rules/ts/no-dynamic-imports.spec.ts +54 -54
  132. package/src/plugin/rules/ts/no-dynamic-imports.ts +49 -49
  133. package/src/plugin/rules/ts/no-native-browser-dialogs.spec.ts +54 -54
  134. package/src/plugin/rules/ts/no-native-browser-dialogs.ts +84 -84
  135. package/src/plugin/rules/ts/no-plain-function-export.spec.ts +72 -72
  136. package/src/plugin/rules/ts/no-plain-function-export.ts +73 -73
  137. package/src/plugin/rules/ts/one-export-per-file.spec.ts +64 -64
  138. package/src/plugin/rules/ts/one-export-per-file.ts +77 -77
  139. package/src/scripts/dynamo-fix.ts +172 -172
  140. package/src/scripts/eslintrc-audit.ts +116 -116
  141. package/src/scripts/fix-return-types.spec.ts +65 -65
  142. package/src/scripts/fix-return-types.ts +286 -285
  143. package/src/scripts/validate-imports.ts +288 -257
  144. package/src/scripts/validate-naming.ts +209 -183
  145. package/src/scripts/validator-cli.integration.spec.ts +99 -0
  146. package/tsconfig.json +31 -31
@@ -1,64 +1,64 @@
1
- import oneExportPerFileRule from './one-export-per-file';
2
-
3
- describe('| one-export-per-file', () => {
4
- it('| should be a valid ESLint rule', () => {
5
- expect(oneExportPerFileRule.meta?.type).toBe('suggestion');
6
- expect(oneExportPerFileRule.meta?.messages?.tooManyExports).toBeDefined();
7
- });
8
-
9
- it('| should skip .const.ts (exception pattern)', () => {
10
- const mockContext: any = { filename: '/x/foo.const.ts', report: () => {}, options: [] };
11
- const result: any = oneExportPerFileRule.create(mockContext);
12
- expect(result.Program).toBeUndefined();
13
- });
14
-
15
- it('| should skip .data-model.ts (DataModel + DataParams allowed)', () => {
16
- const mockContext: any = { filename: '/x/user.data-model.ts', report: () => {}, options: [] };
17
- const result: any = oneExportPerFileRule.create(mockContext);
18
- expect(result.Program).toBeUndefined();
19
- });
20
-
21
- it('| should skip .spec.ts files', () => {
22
- const mockContext: any = { filename: '/x/foo.spec.ts', report: () => {}, options: [] };
23
- const result: any = oneExportPerFileRule.create(mockContext);
24
- expect(result.Program).toBeUndefined();
25
- });
26
-
27
- it('| should not report when file has 1 export', () => {
28
- let reportCalled: boolean = false;
29
- const mockContext: any = {
30
- filename: '/x/foo.ts',
31
- report: () => { reportCalled = true; },
32
- options: [],
33
- };
34
- const rule: any = oneExportPerFileRule.create(mockContext);
35
- const mockProgram: any = {
36
- body: [
37
- { type: 'ExportNamedDeclaration', declaration: { type: 'FunctionDeclaration' } },
38
- ],
39
- };
40
- rule.Program(mockProgram);
41
- expect(reportCalled).toBe(false);
42
- });
43
-
44
- it('| should report when file has 2+ exports', () => {
45
- let reportCalled: boolean = false;
46
- const mockContext: any = {
47
- filename: '/x/foo.ts',
48
- report: (options: any): void => {
49
- reportCalled = true;
50
- expect(options.messageId).toBe('tooManyExports');
51
- },
52
- options: [],
53
- };
54
- const rule: any = oneExportPerFileRule.create(mockContext);
55
- const mockProgram: any = {
56
- body: [
57
- { type: 'ExportNamedDeclaration', declaration: { type: 'ClassDeclaration' } },
58
- { type: 'ExportNamedDeclaration', declaration: { type: 'FunctionDeclaration' } },
59
- ],
60
- };
61
- rule.Program(mockProgram);
62
- expect(reportCalled).toBe(true);
63
- });
64
- });
1
+ import oneExportPerFileRule from './one-export-per-file';
2
+
3
+ describe('| one-export-per-file', () => {
4
+ it('| should be a valid ESLint rule', () => {
5
+ expect(oneExportPerFileRule.meta?.type).toBe('suggestion');
6
+ expect(oneExportPerFileRule.meta?.messages?.tooManyExports).toBeDefined();
7
+ });
8
+
9
+ it('| should skip .const.ts (exception pattern)', () => {
10
+ const mockContext: any = { filename: '/x/foo.const.ts', report: () => {}, options: [] };
11
+ const result: any = oneExportPerFileRule.create(mockContext);
12
+ expect(result.Program).toBeUndefined();
13
+ });
14
+
15
+ it('| should skip .data-model.ts (DataModel + DataParams allowed)', () => {
16
+ const mockContext: any = { filename: '/x/user.data-model.ts', report: () => {}, options: [] };
17
+ const result: any = oneExportPerFileRule.create(mockContext);
18
+ expect(result.Program).toBeUndefined();
19
+ });
20
+
21
+ it('| should skip .spec.ts files', () => {
22
+ const mockContext: any = { filename: '/x/foo.spec.ts', report: () => {}, options: [] };
23
+ const result: any = oneExportPerFileRule.create(mockContext);
24
+ expect(result.Program).toBeUndefined();
25
+ });
26
+
27
+ it('| should not report when file has 1 export', () => {
28
+ let reportCalled: boolean = false;
29
+ const mockContext: any = {
30
+ filename: '/x/foo.ts',
31
+ report: () => { reportCalled = true; },
32
+ options: [],
33
+ };
34
+ const rule: any = oneExportPerFileRule.create(mockContext);
35
+ const mockProgram: any = {
36
+ body: [
37
+ { type: 'ExportNamedDeclaration', declaration: { type: 'FunctionDeclaration' } },
38
+ ],
39
+ };
40
+ rule.Program(mockProgram);
41
+ expect(reportCalled).toBe(false);
42
+ });
43
+
44
+ it('| should report when file has 2+ exports', () => {
45
+ let reportCalled: boolean = false;
46
+ const mockContext: any = {
47
+ filename: '/x/foo.ts',
48
+ report: (options: any): void => {
49
+ reportCalled = true;
50
+ expect(options.messageId).toBe('tooManyExports');
51
+ },
52
+ options: [],
53
+ };
54
+ const rule: any = oneExportPerFileRule.create(mockContext);
55
+ const mockProgram: any = {
56
+ body: [
57
+ { type: 'ExportNamedDeclaration', declaration: { type: 'ClassDeclaration' } },
58
+ { type: 'ExportNamedDeclaration', declaration: { type: 'FunctionDeclaration' } },
59
+ ],
60
+ };
61
+ rule.Program(mockProgram);
62
+ expect(reportCalled).toBe(true);
63
+ });
64
+ });
@@ -1,77 +1,77 @@
1
- import { Rule } from 'eslint';
2
-
3
- /**
4
- * Kivétel fájl-minták – ezekben megengedett több export.
5
- * CCAP konvenció: `*.const.ts`, `*.type-enum.ts`, `*.interface.ts`, DataModel + DataParams.
6
- */
7
- const MULTI_EXPORT_EXCEPTION_PATTERNS: RegExp[] = [
8
- /\.const\.ts$/,
9
- /\.type-enum\.ts$/,
10
- /\.interface\.ts$/,
11
- /\.data-model\.ts$/,
12
- /\.control-model\.ts$/,
13
- ];
14
-
15
- /**
16
- * One-export-per-file szabály: nem-kivétel fájlokban max 1 exportált
17
- * class/interface/enum/type/function deklaráció lehet.
18
- * CCAP "one-export-per-file" review ESLint AST-portja.
19
- */
20
- const rule: Rule.RuleModule = {
21
- meta: {
22
- type: 'suggestion',
23
- docs: {
24
- description: 'Limit to one exported class/interface/enum/type/function per file (with named exceptions).',
25
- recommended: true,
26
- },
27
- schema: [],
28
- messages: {
29
- tooManyExports:
30
- '{{count}} export deklaráció a fájlban (max 1). Vegyél ki minden további exportot külön fájlba.',
31
- },
32
- },
33
- create(context: Rule.RuleContext): Rule.RuleListener {
34
- const filename: string = context.filename ?? '';
35
- if (MULTI_EXPORT_EXCEPTION_PATTERNS.some((p: RegExp): boolean => p.test(filename))) {
36
- return {};
37
- }
38
- if (filename.endsWith('.spec.ts') || filename.endsWith('.test.ts') || filename.endsWith('.d.ts')) {
39
- return {};
40
- }
41
-
42
- return {
43
- Program(node: any): void {
44
- try {
45
- const exportNodes: any[] = [];
46
- for (const statement of node.body) {
47
- if (statement.type === 'ExportNamedDeclaration' && statement.declaration) {
48
- const decl: any = statement.declaration;
49
- if (
50
- decl.type === 'ClassDeclaration'
51
- || decl.type === 'TSInterfaceDeclaration'
52
- || decl.type === 'TSEnumDeclaration'
53
- || decl.type === 'TSTypeAliasDeclaration'
54
- || decl.type === 'FunctionDeclaration'
55
- ) {
56
- exportNodes.push(statement);
57
- }
58
- } else if (statement.type === 'ExportDefaultDeclaration') {
59
- exportNodes.push(statement);
60
- }
61
- }
62
- if (exportNodes.length > 1) {
63
- context.report({
64
- node: exportNodes[1],
65
- messageId: 'tooManyExports',
66
- data: { count: String(exportNodes.length) },
67
- });
68
- }
69
- } catch (error) {
70
- console.error('[one-export-per-file] Error in Program visitor:', error);
71
- }
72
- },
73
- };
74
- },
75
- };
76
-
77
- export default rule;
1
+ import { Rule } from 'eslint';
2
+
3
+ /**
4
+ * Kivétel fájl-minták – ezekben megengedett több export.
5
+ * CCAP konvenció: `*.const.ts`, `*.type-enum.ts`, `*.interface.ts`, DataModel + DataParams.
6
+ */
7
+ const MULTI_EXPORT_EXCEPTION_PATTERNS: RegExp[] = [
8
+ /\.const\.ts$/,
9
+ /\.type-enum\.ts$/,
10
+ /\.interface\.ts$/,
11
+ /\.data-model\.ts$/,
12
+ /\.control-model\.ts$/,
13
+ ];
14
+
15
+ /**
16
+ * One-export-per-file szabály: nem-kivétel fájlokban max 1 exportált
17
+ * class/interface/enum/type/function deklaráció lehet.
18
+ * CCAP "one-export-per-file" review ESLint AST-portja.
19
+ */
20
+ const rule: Rule.RuleModule = {
21
+ meta: {
22
+ type: 'suggestion',
23
+ docs: {
24
+ description: 'Limit to one exported class/interface/enum/type/function per file (with named exceptions).',
25
+ recommended: true,
26
+ },
27
+ schema: [],
28
+ messages: {
29
+ tooManyExports:
30
+ '{{count}} export deklaráció a fájlban (max 1). Vegyél ki minden további exportot külön fájlba.',
31
+ },
32
+ },
33
+ create(context: Rule.RuleContext): Rule.RuleListener {
34
+ const filename: string = context.filename ?? '';
35
+ if (MULTI_EXPORT_EXCEPTION_PATTERNS.some((p: RegExp): boolean => p.test(filename))) {
36
+ return {};
37
+ }
38
+ if (filename.endsWith('.spec.ts') || filename.endsWith('.test.ts') || filename.endsWith('.d.ts')) {
39
+ return {};
40
+ }
41
+
42
+ return {
43
+ Program(node: any): void {
44
+ try {
45
+ const exportNodes: any[] = [];
46
+ for (const statement of node.body) {
47
+ if (statement.type === 'ExportNamedDeclaration' && statement.declaration) {
48
+ const decl: any = statement.declaration;
49
+ if (
50
+ decl.type === 'ClassDeclaration'
51
+ || decl.type === 'TSInterfaceDeclaration'
52
+ || decl.type === 'TSEnumDeclaration'
53
+ || decl.type === 'TSTypeAliasDeclaration'
54
+ || decl.type === 'FunctionDeclaration'
55
+ ) {
56
+ exportNodes.push(statement);
57
+ }
58
+ } else if (statement.type === 'ExportDefaultDeclaration') {
59
+ exportNodes.push(statement);
60
+ }
61
+ }
62
+ if (exportNodes.length > 1) {
63
+ context.report({
64
+ node: exportNodes[1],
65
+ messageId: 'tooManyExports',
66
+ data: { count: String(exportNodes.length) },
67
+ });
68
+ }
69
+ } catch (error) {
70
+ console.error('[one-export-per-file] Error in Program visitor:', error);
71
+ }
72
+ },
73
+ };
74
+ },
75
+ };
76
+
77
+ export default rule;
@@ -1,172 +1,172 @@
1
- #!/usr/bin/env node
2
- /**
3
- * @fileoverview Dynamo ESLint Auto-Fix Script
4
- *
5
- * This script runs ESLint with auto-fix capabilities on TypeScript files across the project.
6
- * It processes all .ts and .tsx files, applies Dynamo-specific rules, and automatically
7
- * fixes issues where possible.
8
- *
9
- * @usage
10
- * ```bash
11
- * dynamo-fix
12
- * ```
13
- *
14
- * @example
15
- * ```bash
16
- * # Fix all TypeScript files in the project
17
- * npx dynamo-fix
18
- *
19
- * # Or run via npm script
20
- * npm run fix
21
- * ```
22
- *
23
- * @author Future Development Program Ltd.
24
- * @version 1.14.3
25
- */
26
-
27
- import fg from 'fast-glob';
28
- import { ESLint } from 'eslint';
29
- import { writeFileSync } from 'fs';
30
-
31
- /**
32
- * Result of fixing a single file
33
- */
34
- interface FixResult {
35
- /** Path to the file that was processed */
36
- file: string;
37
- /** Whether the file was actually modified */
38
- fixed: boolean;
39
- /** Number of errors found in the file */
40
- errors: number;
41
- /** Number of warnings found in the file */
42
- warnings: number;
43
- /** Number of fixes applied to the file */
44
- fixes: number;
45
- }
46
-
47
- /**
48
- * Fixes a single TypeScript file using ESLint with auto-fix capabilities
49
- *
50
- * @param filePath - Path to the TypeScript file to fix
51
- * @returns Promise that resolves to a FixResult object containing fix statistics
52
- *
53
- * @example
54
- * ```typescript
55
- * const result = await fixFile('./src/components/Button.tsx');
56
- * console.log(`Fixed ${result.fixes} issues in ${result.file}`);
57
- * ```
58
- */
59
- async function fixFile(filePath: string): Promise<FixResult> {
60
- // Configure ESLint with Dynamo-specific rules and auto-fix enabled
61
- const eslint = new ESLint({
62
- baseConfig: [
63
- { ignores: [ 'build/**', 'dist/**', 'node_modules/**' ] },
64
- {
65
- files: [ '**/*.{ts,tsx}' ],
66
- languageOptions: {
67
- parser: require('@typescript-eslint/parser'),
68
- parserOptions: { ecmaVersion: 2020, sourceType: 'module' },
69
- },
70
- plugins: {
71
- '@futdevpro/dynamo': {
72
- rules: {
73
- 'import-order': require('../plugin/rules/import/import-order').default,
74
- 'naming-patterns': require('../plugin/rules/naming-patterns').default,
75
- },
76
- },
77
- },
78
- rules: {
79
- '@futdevpro/dynamo/import-order': 'error',
80
- '@futdevpro/dynamo/naming-patterns': 'warn',
81
- },
82
- },
83
- ],
84
- fix: true, // Enable auto-fixing
85
- });
86
-
87
- // Run ESLint on the file
88
- const results = await eslint.lintFiles([ filePath ]);
89
- const result = results[0];
90
-
91
- // Write the fixed content back to the file if changes were made
92
- if (result && result.output) {
93
- writeFileSync(filePath, result.output);
94
- }
95
-
96
- // Return comprehensive fix statistics
97
- return {
98
- file: filePath,
99
- fixed: result && result.output !== undefined,
100
- errors: result.messages.filter(msg => msg.severity === 2).length,
101
- warnings: result.messages.filter(msg => msg.severity === 1).length,
102
- fixes: result.fixableErrorCount + result.fixableWarningCount,
103
- };
104
- }
105
-
106
- /**
107
- * Main function that processes all TypeScript files in the project
108
- *
109
- * Scans for all .ts and .tsx files, applies ESLint fixes, and provides
110
- * comprehensive reporting on the results.
111
- *
112
- * @returns Promise that resolves when all files have been processed
113
- *
114
- * @throws {Error} When file processing fails
115
- */
116
- async function main() {
117
- // Find all TypeScript files, excluding common directories and test files
118
- const files = await fg([ '**/*.{ts,tsx}' ], {
119
- ignore: [ '**/node_modules/**', '**/build/**', '**/dist/**', '**/*.spec.ts', '**/*.test.ts' ],
120
- });
121
-
122
- console.log(`[dynamo-fix] Fixing ${files.length} files...`);
123
-
124
- const results: FixResult[] = [];
125
- let totalFixed = 0;
126
- let totalErrors = 0;
127
- let totalWarnings = 0;
128
- let totalFixes = 0;
129
-
130
- // Process each file individually
131
- for (const file of files) {
132
- try {
133
- const result = await fixFile(file);
134
-
135
- results.push(result);
136
-
137
- // Track successful fixes
138
- if (result.fixed) {
139
- totalFixed++;
140
- console.log(`✅ Fixed: ${result.file}`);
141
- }
142
-
143
- // Accumulate statistics
144
- totalErrors += result.errors;
145
- totalWarnings += result.warnings;
146
- totalFixes += result.fixes;
147
- } catch (error) {
148
- console.error(`❌ Error processing ${file}:`, error);
149
- }
150
- }
151
-
152
- // Generate comprehensive summary report
153
- console.log(`\n📊 Fix Summary:`);
154
- console.log(` Files processed: ${files.length}`);
155
- console.log(` Files fixed: ${totalFixed}`);
156
- console.log(` Total errors: ${totalErrors}`);
157
- console.log(` Total warnings: ${totalWarnings}`);
158
- console.log(` Total fixes applied: ${totalFixes}`);
159
-
160
- // Provide appropriate success/failure message
161
- if (totalFixed === 0) {
162
- console.log('✅ No files needed fixing!');
163
- } else {
164
- console.log(`\n🎉 Successfully fixed ${totalFixed} files!`);
165
- }
166
- }
167
-
168
- // Execute the main function and handle any errors
169
- main().catch((err) => {
170
- console.error('Fix failed:', err);
171
- process.exit(1);
172
- });
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @fileoverview Dynamo ESLint Auto-Fix Script
4
+ *
5
+ * This script runs ESLint with auto-fix capabilities on TypeScript files across the project.
6
+ * It processes all .ts and .tsx files, applies Dynamo-specific rules, and automatically
7
+ * fixes issues where possible.
8
+ *
9
+ * @usage
10
+ * ```bash
11
+ * dynamo-fix
12
+ * ```
13
+ *
14
+ * @example
15
+ * ```bash
16
+ * # Fix all TypeScript files in the project
17
+ * npx dynamo-fix
18
+ *
19
+ * # Or run via npm script
20
+ * npm run fix
21
+ * ```
22
+ *
23
+ * @author Future Development Program Ltd.
24
+ * @version 1.14.3
25
+ */
26
+
27
+ import fg from 'fast-glob';
28
+ import { ESLint } from 'eslint';
29
+ import { writeFileSync } from 'fs';
30
+
31
+ /**
32
+ * Result of fixing a single file
33
+ */
34
+ interface FixResult {
35
+ /** Path to the file that was processed */
36
+ file: string;
37
+ /** Whether the file was actually modified */
38
+ fixed: boolean;
39
+ /** Number of errors found in the file */
40
+ errors: number;
41
+ /** Number of warnings found in the file */
42
+ warnings: number;
43
+ /** Number of fixes applied to the file */
44
+ fixes: number;
45
+ }
46
+
47
+ /**
48
+ * Fixes a single TypeScript file using ESLint with auto-fix capabilities
49
+ *
50
+ * @param filePath - Path to the TypeScript file to fix
51
+ * @returns Promise that resolves to a FixResult object containing fix statistics
52
+ *
53
+ * @example
54
+ * ```typescript
55
+ * const result = await fixFile('./src/components/Button.tsx');
56
+ * console.log(`Fixed ${result.fixes} issues in ${result.file}`);
57
+ * ```
58
+ */
59
+ async function fixFile(filePath: string): Promise<FixResult> {
60
+ // Configure ESLint with Dynamo-specific rules and auto-fix enabled
61
+ const eslint = new ESLint({
62
+ baseConfig: [
63
+ { ignores: [ 'build/**', 'dist/**', 'node_modules/**' ] },
64
+ {
65
+ files: [ '**/*.{ts,tsx}' ],
66
+ languageOptions: {
67
+ parser: require('typescript-eslint').parser,
68
+ parserOptions: { ecmaVersion: 2020, sourceType: 'module' },
69
+ },
70
+ plugins: {
71
+ '@futdevpro/dynamo': {
72
+ rules: {
73
+ 'import-order': require('../plugin/rules/import/import-order').default,
74
+ 'naming-patterns': require('../plugin/rules/naming-patterns').default,
75
+ },
76
+ },
77
+ },
78
+ rules: {
79
+ '@futdevpro/dynamo/import-order': 'error',
80
+ '@futdevpro/dynamo/naming-patterns': 'warn',
81
+ },
82
+ },
83
+ ],
84
+ fix: true, // Enable auto-fixing
85
+ });
86
+
87
+ // Run ESLint on the file
88
+ const results = await eslint.lintFiles([ filePath ]);
89
+ const result = results[0];
90
+
91
+ // Write the fixed content back to the file if changes were made
92
+ if (result && result.output) {
93
+ writeFileSync(filePath, result.output);
94
+ }
95
+
96
+ // Return comprehensive fix statistics
97
+ return {
98
+ file: filePath,
99
+ fixed: result && result.output !== undefined,
100
+ errors: result.messages.filter(msg => msg.severity === 2).length,
101
+ warnings: result.messages.filter(msg => msg.severity === 1).length,
102
+ fixes: result.fixableErrorCount + result.fixableWarningCount,
103
+ };
104
+ }
105
+
106
+ /**
107
+ * Main function that processes all TypeScript files in the project
108
+ *
109
+ * Scans for all .ts and .tsx files, applies ESLint fixes, and provides
110
+ * comprehensive reporting on the results.
111
+ *
112
+ * @returns Promise that resolves when all files have been processed
113
+ *
114
+ * @throws {Error} When file processing fails
115
+ */
116
+ async function main() {
117
+ // Find all TypeScript files, excluding common directories and test files
118
+ const files = await fg([ '**/*.{ts,tsx}' ], {
119
+ ignore: [ '**/node_modules/**', '**/build/**', '**/dist/**', '**/*.spec.ts', '**/*.test.ts' ],
120
+ });
121
+
122
+ console.log(`[dynamo-fix] Fixing ${files.length} files...`);
123
+
124
+ const results: FixResult[] = [];
125
+ let totalFixed = 0;
126
+ let totalErrors = 0;
127
+ let totalWarnings = 0;
128
+ let totalFixes = 0;
129
+
130
+ // Process each file individually
131
+ for (const file of files) {
132
+ try {
133
+ const result = await fixFile(file);
134
+
135
+ results.push(result);
136
+
137
+ // Track successful fixes
138
+ if (result.fixed) {
139
+ totalFixed++;
140
+ console.log(`✅ Fixed: ${result.file}`);
141
+ }
142
+
143
+ // Accumulate statistics
144
+ totalErrors += result.errors;
145
+ totalWarnings += result.warnings;
146
+ totalFixes += result.fixes;
147
+ } catch (error) {
148
+ console.error(`❌ Error processing ${file}:`, error);
149
+ }
150
+ }
151
+
152
+ // Generate comprehensive summary report
153
+ console.log(`\n📊 Fix Summary:`);
154
+ console.log(` Files processed: ${files.length}`);
155
+ console.log(` Files fixed: ${totalFixed}`);
156
+ console.log(` Total errors: ${totalErrors}`);
157
+ console.log(` Total warnings: ${totalWarnings}`);
158
+ console.log(` Total fixes applied: ${totalFixes}`);
159
+
160
+ // Provide appropriate success/failure message
161
+ if (totalFixed === 0) {
162
+ console.log('✅ No files needed fixing!');
163
+ } else {
164
+ console.log(`\n🎉 Successfully fixed ${totalFixed} files!`);
165
+ }
166
+ }
167
+
168
+ // Execute the main function and handle any errors
169
+ main().catch((err) => {
170
+ console.error('Fix failed:', err);
171
+ process.exit(1);
172
+ });