@futdevpro/dynamo-eslint 1.15.22 → 1.15.28

package/build/scripts/eslintrc-audit.js

@@ -1,101 +1,101 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * @fileoverview ESLint Configuration Audit Script
- *
- * This script analyzes ESLint configuration files (.eslintrc.json) across the project
- * to provide statistics on rule usage. It helps identify commonly used rules and
- * potential configuration inconsistencies.
- *
- * @usage
- * ```bash
- * dynamo-eslintrc-audit
- * ```
- *
- * @example
- * ```bash
- * # Audit all ESLint configurations in the project
- * npx dynamo-eslintrc-audit
- *
- * # Or run via npm script
- * npm run audit:eslintrc
- * ```
- *
- * @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 fs_1 = require("fs");
-/**
- * Safely parses a JSON file and returns the parsed object or null if parsing fails
- *
- * @param jsonPath - Path to the JSON file to parse
- * @returns Parsed JSON object or null if parsing fails
- *
- * @example
- * ```typescript
- * const config = safeParse('./.eslintrc.json');
- * if (config) {
- *   console.log('Rules:', Object.keys(config.rules || {}));
- * }
- * ```
- */
-function safeParse(jsonPath) {
-    try {
-        const content = (0, fs_1.readFileSync)(jsonPath, 'utf8');
-        return JSON.parse(content);
-    }
-    catch {
-        // Return null for any parsing errors (malformed JSON, file not found, etc.)
-        return null;
-    }
-}
-/**
- * Main function that analyzes ESLint configuration files and generates rule usage statistics
- *
- * Scans for all .eslintrc.json files in the project, extracts rule configurations,
- * and provides a sorted table of the most commonly used rules.
- *
- * @returns Promise that resolves when analysis is complete
- *
- * @example
- * ```typescript
- * // The function will output a table like:
- * // ┌─────────┬─────────────────────────┬───────┐
- * // │ (index) │          rule           │ count │
- * // ├─────────┼─────────────────────────┼───────┤
- * // │    0    │    'no-unused-vars'     │   5   │
- * // │    1    │    'semi'               │   4   │
- * // └─────────┴─────────────────────────┴───────┘
- * ```
- */
-async function main() {
-    // Find all ESLint configuration files, excluding node_modules
-    const files = await (0, fast_glob_1.default)(['**/.eslintrc.json'], { ignore: ['**/node_modules/**'] });
-    const ruleCounts = {};
-    const total = files.length;
-    // Process each configuration file
-    for (const p of files) {
-        const cfg = safeParse(p);
-        // Skip files without rules configuration
-        if (!cfg?.rules)
-            continue;
-        // Count each rule occurrence
-        for (const key of Object.keys(cfg.rules)) {
-            ruleCounts[key] = (ruleCounts[key] ?? 0) + 1;
-        }
-    }
-    // Sort rules by usage count (most used first)
-    const entries = Object.entries(ruleCounts).sort((a, b) => b[1] - a[1]);
-    // Display results
-    console.log(`[dynamo-eslintrc-audit] analyzed ${total} files`);
-    console.table(entries.slice(0, 50).map(([rule, count]) => ({ rule, count })));
-}
-// Execute the main function and handle any errors
-main().catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
+#!/usr/bin/env node
+"use strict";
+/**
+ * @fileoverview ESLint Configuration Audit Script
+ *
+ * This script analyzes ESLint configuration files (.eslintrc.json) across the project
+ * to provide statistics on rule usage. It helps identify commonly used rules and
+ * potential configuration inconsistencies.
+ *
+ * @usage
+ * ```bash
+ * dynamo-eslintrc-audit
+ * ```
+ *
+ * @example
+ * ```bash
+ * # Audit all ESLint configurations in the project
+ * npx dynamo-eslintrc-audit
+ *
+ * # Or run via npm script
+ * npm run audit:eslintrc
+ * ```
+ *
+ * @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 fs_1 = require("fs");
+/**
+ * Safely parses a JSON file and returns the parsed object or null if parsing fails
+ *
+ * @param jsonPath - Path to the JSON file to parse
+ * @returns Parsed JSON object or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const config = safeParse('./.eslintrc.json');
+ * if (config) {
+ *   console.log('Rules:', Object.keys(config.rules || {}));
+ * }
+ * ```
+ */
+function safeParse(jsonPath) {
+    try {
+        const content = (0, fs_1.readFileSync)(jsonPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        // Return null for any parsing errors (malformed JSON, file not found, etc.)
+        return null;
+    }
+}
+/**
+ * Main function that analyzes ESLint configuration files and generates rule usage statistics
+ *
+ * Scans for all .eslintrc.json files in the project, extracts rule configurations,
+ * and provides a sorted table of the most commonly used rules.
+ *
+ * @returns Promise that resolves when analysis is complete
+ *
+ * @example
+ * ```typescript
+ * // The function will output a table like:
+ * // ┌─────────┬─────────────────────────┬───────┐
+ * // │ (index) │          rule           │ count │
+ * // ├─────────┼─────────────────────────┼───────┤
+ * // │    0    │    'no-unused-vars'     │   5   │
+ * // │    1    │    'semi'               │   4   │
+ * // └─────────┴─────────────────────────┴───────┘
+ * ```
+ */
+async function main() {
+    // Find all ESLint configuration files, excluding node_modules
+    const files = await (0, fast_glob_1.default)(['**/.eslintrc.json'], { ignore: ['**/node_modules/**'] });
+    const ruleCounts = {};
+    const total = files.length;
+    // Process each configuration file
+    for (const p of files) {
+        const cfg = safeParse(p);
+        // Skip files without rules configuration
+        if (!cfg?.rules)
+            continue;
+        // Count each rule occurrence
+        for (const key of Object.keys(cfg.rules)) {
+            ruleCounts[key] = (ruleCounts[key] ?? 0) + 1;
+        }
+    }
+    // Sort rules by usage count (most used first)
+    const entries = Object.entries(ruleCounts).sort((a, b) => b[1] - a[1]);
+    // Display results
+    console.log(`[dynamo-eslintrc-audit] analyzed ${total} files`);
+    console.table(entries.slice(0, 50).map(([rule, count]) => ({ rule, count })));
+}
+// Execute the main function and handle any errors
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
 //# sourceMappingURL=eslintrc-audit.js.map

package/build/scripts/fix-return-types.d.ts

@@ -1,75 +1,75 @@
-#!/usr/bin/env node
-/**
- * @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
- */
-import * as ts from 'typescript';
-/**
- * Result of fixing type annotations in a single file
- */
-interface FixResult {
-    /** Path to the file that was processed */
-    file: string;
-    /** Whether the file was actually modified */
-    fixed: boolean;
-    /** Number of type annotations added to the file */
-    changes: number;
-}
-/**
- * Egy `checker.typeToString(...)`-bol jovo TIPUS-STRING-et valodi `ts.TypeNode`-da
- * alakit ugy, hogy egy eldobhato `type __T = <typeString>;` forrast parse-ol es
- * kiszedi belole a TypeNode-ot.
- *
- * MIERT: a regi megoldas `ts.factory.createTypeReferenceNode(typeString)`-et hivott,
- * ami CSAK bare identifier-t (entity-name-et) fogad el. Egy generic/union/stb.
- * tipus-string (pl. `Record<string, unknown>`) eseten ez tort node-ot epitett, amit
- * a printer csonka `Record`-kent (type-argumentumok nelkul) emittalt — ami EGYSZERRE
- * tsc-hiba ES uj lint-hiba, igy egyetlen fix-futas 0 → 1+ lint-szamot regresszalt.
- * A `typeToString` mindig syntactically valid TS tipus-syntaxot ad vissza, ezert a
- * `type __T = …;` parse-olas minden esetre korrekt TypeNode-ot allit elo.
- *
- * BAIL-OUT: ha a tipus nem alakithato biztonsagos node-da — pl. inline
- * `import("/abs/path").Foo` format tartalmaz, ami abszolut path-t szivarogtatna a
- * fajlba —, `undefined`-et adunk vissza. A hivo ilyenkor KIHAGYJA az annotaciot:
- * jobb annotalatlanul hagyni (marad a figyelmeztetes), mint tort kodot irni.
- */
-declare function buildTypeNodeFromString(typeString: string): ts.TypeNode | undefined;
-/**
- * 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}`);
- * ```
- */
-declare function addTypesToFile(filePath: string): FixResult;
-export { buildTypeNodeFromString, addTypesToFile };
+#!/usr/bin/env node
+/**
+ * @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
+ */
+import * as ts from 'typescript';
+/**
+ * Result of fixing type annotations in a single file
+ */
+interface FixResult {
+    /** Path to the file that was processed */
+    file: string;
+    /** Whether the file was actually modified */
+    fixed: boolean;
+    /** Number of type annotations added to the file */
+    changes: number;
+}
+/**
+ * Egy `checker.typeToString(...)`-bol jovo TIPUS-STRING-et valodi `ts.TypeNode`-da
+ * alakit ugy, hogy egy eldobhato `type __T = <typeString>;` forrast parse-ol es
+ * kiszedi belole a TypeNode-ot.
+ *
+ * MIERT: a regi megoldas `ts.factory.createTypeReferenceNode(typeString)`-et hivott,
+ * ami CSAK bare identifier-t (entity-name-et) fogad el. Egy generic/union/stb.
+ * tipus-string (pl. `Record<string, unknown>`) eseten ez tort node-ot epitett, amit
+ * a printer csonka `Record`-kent (type-argumentumok nelkul) emittalt — ami EGYSZERRE
+ * tsc-hiba ES uj lint-hiba, igy egyetlen fix-futas 0 → 1+ lint-szamot regresszalt.
+ * A `typeToString` mindig syntactically valid TS tipus-syntaxot ad vissza, ezert a
+ * `type __T = …;` parse-olas minden esetre korrekt TypeNode-ot allit elo.
+ *
+ * BAIL-OUT: ha a tipus nem alakithato biztonsagos node-da — pl. inline
+ * `import("/abs/path").Foo` format tartalmaz, ami abszolut path-t szivarogtatna a
+ * fajlba —, `undefined`-et adunk vissza. A hivo ilyenkor KIHAGYJA az annotaciot:
+ * jobb annotalatlanul hagyni (marad a figyelmeztetes), mint tort kodot irni.
+ */
+declare function buildTypeNodeFromString(typeString: string): ts.TypeNode | undefined;
+/**
+ * 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}`);
+ * ```
+ */
+declare function addTypesToFile(filePath: string): FixResult;
+export { buildTypeNodeFromString, addTypesToFile };
 //# sourceMappingURL=fix-return-types.d.ts.map