@pythonidaer/complexity-report 1.0.5 → 1.0.6

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.6] - 2026-02-08
+
+### Fixed
+- **Threshold detection:** Regex now accepts single or double quotes around severity (e.g. `'warn'` or `"warn"`) in eslint.config.js.
+- **Report hang:** Built-in ESLint ignore patterns for `complexity/**`, `dist/**`, `build/**`, `.angular/**`, `**/coverage/**`, `node_modules/**` so the run does not hang on report output or build/cache dirs.
+
+### Added
+- README: Angular 21 / ESLint 10 note at Installation (legacy-peer-deps); Troubleshooting for peer dependency errors and slow runs.
+- README: Performance note updated to describe built-in ignores.
+
 ## [1.0.5] - 2026-02-08
 
 ### Fixed

package/README.md

@@ -21,6 +21,8 @@
 npm install -D @pythonidaer/complexity-report
 ```
 
+On **Angular 21** or other projects using **ESLint 10**, install may fail with peer dependency conflicts; use `npm install --legacy-peer-deps` or set `legacy-peer-deps=true` in `.npmrc`. See [Troubleshooting](#npm-install-fails-with-peer-dependency-errors-eg-angular-21-eslint-10).
+
 ## Requirements
 
 - **Node.js**: >=18 (to run the CLI)
@@ -28,16 +30,20 @@ npm install -D @pythonidaer/complexity-report
 
 The package bundles ESLint and uses your project's config to run complexity analysis. You do not need to install ESLint or TypeScript in your project for the tool to work.
 
+**Performance:** The tool runs ESLint with `lintFiles(['.'])` and applies built-in ignores for `complexity/**`, `dist/**`, `build/**`, `.angular/**`, `**/coverage/**`, and `node_modules/**` so the run does not hang on report output or build dirs. Your ESLint config's own ignores also apply; add any other large or generated dirs there if needed.
+
 ## Quick Start
 
 ### CLI Usage
 
-Run from your project root:
+Run from your project root (after installing above):
 
 ```bash
 npx complexity-report
 ```
 
+Use the hyphen: `complexity-report` (not `complexity report`). To run without adding to `package.json`: `npx @pythonidaer/complexity-report`
+
 This generates an interactive HTML report at `complexity/index.html`.
 
 ### With npm Scripts
@@ -98,6 +104,22 @@ console.log(`Total functions: ${result.stats.allFunctionsCount}`);
 - [Changelog](./CHANGELOG.md) — version history and migration from scripts
 - [Publishing to npm](./PUBLISH.md) — for maintainers
 
+## Troubleshooting
+
+### Report seems to hang on "Running ESLint to collect complexity..."
+
+The tool already ignores `complexity/**`, `dist/**`, `build/**`, `.angular/**`, `**/coverage/**`, and `node_modules/**`. If it still hangs, add other large or generated directories to your ESLint config's `ignore` (e.g. `.next/**`, `out/**`, `*.min.js`).
+
+### npm install fails with peer dependency errors (e.g. Angular 21, ESLint 10)
+
+Some setups (e.g. Angular 21 with ESLint 10) can trigger peer dependency conflicts. Install with:
+
+```bash
+npm install --legacy-peer-deps
+```
+
+Or add to your project's `.npmrc`: `legacy-peer-deps=true`. The report runs correctly with ESLint 10 once installed.
+
 ## License
 
 MIT © Johnny Hammond

package/integration/eslint/index.js

@@ -73,6 +73,13 @@ export async function runESLintComplexityCheck(projectRoot) {
         '**/__tests__/**',
         '**/*.test.{js,ts,tsx}',
         '**/*.spec.{js,ts,tsx}',
+        // Avoid linting report output and common build/cache dirs (prevents apparent hang)
+        'complexity/**',
+        'dist/**',
+        'build/**',
+        '.angular/**',
+        '**/coverage/**',
+        'node_modules/**',
       ],
       overrideConfig: {
         rules: {

package/integration/threshold/index.js

@@ -15,8 +15,8 @@ export function getComplexityThreshold(projectRoot) {
     const configContent = readFileSync(configPath, 'utf-8');
 
     // Extract all complexity max values using regex
-    // Pattern: complexity: ["warn", { max: <number>, variant: "classic" }]
-    const complexityMatches = configContent.match(/complexity:\s*\["warn",\s*\{\s*max:\s*(\d+)/g);
+    // Pattern: complexity: ["warn" | 'warn', { max: <number>, ... }] — accept single or double quotes
+    const complexityMatches = configContent.match(/complexity:\s*\[["'](?:warn|error)["'],\s*\{\s*max:\s*(\d+)/g);
 
     if (!complexityMatches || complexityMatches.length === 0) {
       // Default to 10 if not found

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pythonidaer/complexity-report",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "AST-based cyclomatic complexity analyzer with interactive HTML reports and detailed function breakdowns",
   "type": "module",
   "main": "index.js",