@ovh-ux/manager-static-analysis-kit 0.9.0 → 0.11.0

package/bin/utils/module-utils.js

@@ -0,0 +1,121 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { appsDir, librariesBasePaths, staticDiscoveredLibraries } from '../cli-path-config.js';
+import { readJsonSafe } from './file-utils.js';
+import { logWarn } from './log-utils.js';
+
+/**
+ * Determine whether a given package directory represents a React-based module.
+ *
+ * This function inspects the `package.json` file located at `pkgPath`
+ * and checks whether any of its dependencies, devDependencies, or peerDependencies
+ * include `react`. If the file does not exist, cannot be parsed, or the
+ * dependency is missing, it returns `false`.
+ *
+ * @param {string} pkgPath - Absolute path to a `package.json` file.
+ * @returns {boolean} `true` if the module depends on React, otherwise `false`.
+ *
+ * @example
+ * isReactModule('/path/to/package.json');
+ * // → true if the package declares React as a dependency
+ */
+export function isReactModule(pkgPath) {
+  try {
+    if (!fs.existsSync(pkgPath)) return false;
+
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    if (!pkg || typeof pkg !== 'object') return false;
+
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies, ...pkg.peerDependencies };
+    return Boolean(deps.react);
+  } catch (err) {
+    logWarn(`Failed to read or parse ${pkgPath}: ${err.message}`);
+    return false;
+  }
+}
+
+/**
+ * Discover all valid application or library modules by scanning predefined directories.
+ *
+ * Depending on the `isLibrary` flag, this function inspects:
+ * - Libraries under: `packages/manager/core`, `packages/manager/modules`, and `packages/components`
+ * - Applications under: `manager/apps`
+ *
+ * For each folder containing a `package.json` that represents a React module,
+ * a module descriptor object is created with metadata.
+ *
+ * @param {boolean} [isLibrary=false] - Whether to scan for libraries (`true`) or apps (`false`).
+ * @returns {Array<{ fullPath: string, shortPath: string, packageName: string }>}
+ * Array of discovered module descriptors.
+ *
+ * @example
+ * // Discover apps
+ * discoverModules();
+ * // → [{ fullPath: '/.../manager/apps/zimbra', shortPath: 'zimbra', packageName: '@ovh-ux/manager-zimbra-app' }]
+ *
+ * @example
+ * // Discover libraries
+ * discoverModules(true);
+ * // → [{ fullPath: '/.../packages/manager/core/core-shell', shortPath: 'core-shell', packageName: '@ovh-ux/manager-core-shell' }]
+ */
+export function discoverModules(isLibrary = false) {
+  const discovered = [];
+  const modulesPaths = isLibrary ? librariesBasePaths : [appsDir];
+
+  for (const moduleBasePath of modulesPaths) {
+    if (!fs.existsSync(moduleBasePath)) continue;
+
+    const items = fs.readdirSync(moduleBasePath, { withFileTypes: true });
+    for (const item of items) {
+      if (item.isDirectory()) {
+        const appFolder = path.join(moduleBasePath, item.name);
+        const pkgPath = path.join(appFolder, 'package.json');
+        if (fs.existsSync(pkgPath) && isReactModule(pkgPath)) {
+          const pkgDetails = readJsonSafe(pkgPath);
+          discovered.push({
+            fullPath: appFolder,
+            shortPath: item.name,
+            packageName: pkgDetails.name,
+          });
+        }
+      }
+    }
+  }
+
+  return isLibrary ? [...discovered, ...staticDiscoveredLibraries] : discovered;
+}
+
+/**
+ * Retrieve a single module (app or library) matching a given pattern.
+ *
+ * This function searches through discovered modules (via {@link discoverModules})
+ * and returns the first one matching any of the following:
+ * - The module's absolute path (`fullPath`)
+ * - The folder name (`shortPath`)
+ * - The npm package name (`packageName`)
+ *
+ * @param {string} modulePattern - Pattern to match against module identifiers.
+ * @param {boolean} [isLibrary=false] - Whether to search within libraries (`true`) or apps (`false`).
+ * @returns {{ fullPath: string, shortPath: string, packageName: string }}
+ * The matched module descriptor, or `undefined` if no match is found.
+ *
+ * @example
+ * // Match by folder name
+ * getModule('zimbra');
+ * // → { fullPath: '/.../manager/apps/zimbra', shortPath: 'zimbra', packageName: '@ovh-ux/manager-zimbra-app' }
+ *
+ * @example
+ * // Match by package name
+ * getModule('@ovh-ux/manager-core-shell', true);
+ * // → { fullPath: '/.../packages/manager/core/core-shell', shortPath: 'core-shell', packageName: '@ovh-ux/manager-core-shell' }
+ */
+export function getModule(modulePattern, isLibrary = false) {
+  const discoveredLibraries = discoverModules(isLibrary) || [];
+  return discoveredLibraries.find(
+    (library) =>
+      library.fullPath === modulePattern ||
+      library.shortPath === modulePattern ||
+      library.packageName === modulePattern,
+  );
+}

package/bin/utils/runner-utils.js

@@ -3,12 +3,23 @@ import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
 
-import { resolveAppInfo } from './apps-utils.js';
-import { generateCombinedReports } from './file-utils.js';
+import { generateCombinedReports, readJsonSafe } from './file-utils.js';
 import { logError, logInfo } from './log-utils.js';
+import { isReactModule } from './module-utils.js';
 
 /**
- * Ensure the given binary exists.
+ * Ensure that a required binary exists before running an analysis command.
+ *
+ * This function verifies that a binary file exists at the given path.
+ * If not found, it logs an error message and terminates the process
+ * with exit code `1`.
+ *
+ * @param {string} binPath - Absolute path to the binary executable.
+ * @param {string} label - Human-readable label for the binary (used in error logs).
+ *
+ * @example
+ * ensureBinExists('/usr/local/bin/jscpd', 'JSCPD');
+ * // → Exits process if binary is missing
  */
 export function ensureBinExists(binPath, label) {
   if (!fs.existsSync(binPath)) {
@@ -18,7 +29,20 @@ export function ensureBinExists(binPath, label) {
 }
 
 /**
- * Run a child process with consistent defaults.
+ * Execute a command synchronously using the system shell.
+ *
+ * This function spawns a child process that runs a binary or command
+ * with the provided arguments, inheriting the parent process's stdio streams.
+ * It returns `true` if the command completed successfully (exit code `0`).
+ *
+ * @param {string} bin - Executable name or absolute path to run.
+ * @param {string[]} args - Command-line arguments for the executable.
+ * @param {string} cwd - Working directory where the command will be executed.
+ * @returns {boolean} `true` if the process exits with status `0`, otherwise `false`.
+ *
+ * @example
+ * runCommand('eslint', ['--fix', '.'], process.cwd());
+ * // → Runs ESLint and returns true if successful
  */
 export function runCommand(bin, args, cwd) {
   const result = spawnSync(bin, args, {
@@ -30,14 +54,90 @@ export function runCommand(bin, args, cwd) {
 }
 
 /**
- * Generic per-app analysis runner with safety.
+ * Execute analysis for a single module.
+ *
+ * This internal helper encapsulates:
+ *  - Module validation (`fullPath`, `package.json`, React module check)
+ *  - Error handling for analysis execution
+ *  - Delegation to a provided analysis runner
+ *
+ * @param {Object} options - Analysis parameters.
+ * @param {Object} options.module - Module descriptor with metadata.
+ * @param {Function} options.analysisRunner - Function `(fullPath, shortPath, context) => boolean`
+ *   that performs the analysis for this module.
+ * @returns {boolean} `true` if analysis succeeded for the module, otherwise `false`.
+ *
+ * @example
+ * runModuleAnalysis({
+ *   module: { fullPath: '/apps/zimbra', shortPath: 'zimbra', packageName: '@ovh-ux/manager-zimbra-app' },
+ *   analysisRunner: runCoverageAnalysis,
+ * });
  */
-export function runAppsAnalysis({
-  appsDir,
-  appFolders,
-  requireReact = false,
+function runModuleAnalysis({ module, analysisRunner }) {
+  const { fullPath, shortPath, packageName } = module || {};
+  const pkgPath = path.join(fullPath, 'package.json');
+  let isAnalysisComplete = false;
+
+  if (!fs.existsSync(fullPath) || !fs.existsSync(pkgPath) || !isReactModule(pkgPath)) {
+    logError(`❌ Module folder not found: ${module} → skipping`);
+    return isAnalysisComplete;
+  }
+
+  try {
+    isAnalysisComplete = analysisRunner(fullPath, shortPath, {
+      pkgPath,
+      moduleDir: fullPath,
+      moduleFolder: shortPath,
+      moduleShortName: packageName,
+      pkg: readJsonSafe(pkgPath),
+    });
+  } catch (err) {
+    logError(`❌ Fatal error while analyzing ${shortPath}: ${err.stack || err.message}`);
+  }
+
+  return isAnalysisComplete;
+}
+
+/**
+ * Run a complete analysis across multiple modules and generate combined reports.
+ *
+ * This function orchestrates:
+ *  1. Iterating over provided modules.
+ *  2. Running analysis for each module (via `runModuleAnalysis`).
+ *  3. Aggregating successful results.
+ *  4. Generating combined JSON and HTML reports.
+ *
+ * If no modules are successfully analyzed, the process terminates with exit code `1`.
+ *
+ * @param {Object} options - Analysis configuration.
+ * @param {Object[]} options.modules - Array of module descriptors (`{ fullPath, shortPath, packageName }`).
+ * @param {string} options.binaryLabel - Label for the analysis type (e.g. "Type Coverage").
+ * @param {Function} options.analysisRunner - Function executed per module to run analysis logic.
+ * @param {string} options.reportsRootDirName - Directory under the output root to store reports.
+ * @param {string} options.combinedJson - Filename for the combined JSON report.
+ * @param {string} options.combinedHtml - Filename for the combined HTML report.
+ * @param {Function} options.collectFn - Function used to aggregate individual module data.
+ * @param {Function} options.generateHtmlFn - Function used to generate the combined HTML output.
+ * @param {string} options.outputRootDir - Base path where reports should be written.
+ * @returns {string[]} Array of successfully analyzed module short names.
+ *
+ * @example
+ * runModulesAnalysis({
+ *   modules,
+ *   binaryLabel: 'Type Coverage',
+ *   analysisRunner: runTypeCoverage,
+ *   reportsRootDirName: 'types-coverage-reports',
+ *   combinedJson: 'types-coverage-combined-report.json',
+ *   combinedHtml: 'types-coverage-combined-report.html',
+ *   collectFn: collectTypeCoverage,
+ *   generateHtmlFn: generateTypeCoverageHtml,
+ *   outputRootDir: './reports',
+ * });
+ */
+export function runModulesAnalysis({
+  modules,
   binaryLabel,
-  appRunner, // (appDir, appShortName, appInfo) => boolean
+  analysisRunner,
   reportsRootDirName,
   combinedJson,
   combinedHtml,
@@ -45,21 +145,16 @@ export function runAppsAnalysis({
   generateHtmlFn,
   outputRootDir,
 }) {
+  /** @type {string[]} */
   const analyzed = [];
 
-  for (const appFolder of appFolders) {
-    const appInfo = resolveAppInfo(appsDir, appFolder, { requireReact });
-    if (!appInfo) continue;
+  for (const module of modules) {
+    const isAnalysisComplete = runModuleAnalysis({
+      module,
+      analysisRunner,
+    });
 
-    let ok = false;
-    try {
-      ok = appRunner(appInfo.appDir, appInfo.appShortName, appInfo);
-    } catch (err) {
-      logError(
-        `❌ Fatal error while analyzing ${appInfo.appShortName}: ${err.stack || err.message}`,
-      );
-    }
-    if (ok) analyzed.push(appInfo.appShortName);
+    if (isAnalysisComplete) analyzed.push(module.shortPath);
   }
 
   if (analyzed.length > 0) {

package/bin/utils/turbo-utils.js

@@ -1,76 +1,6 @@
 import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
 
-import { logError, logInfo, logWarn } from './log-utils.js';
-
-/**
- * Convert app folder names into Turbo filters by resolving their package.json names.
- *
- * Each app folder must contain a valid `package.json`. If not found, the app is skipped.
- *
- * @param {string} appsDir - Absolute path to the apps root directory.
- * @param {string[]} appFolders - List of app folder names inside the apps directory.
- * @returns {string[]} Array of package names to be used as Turbo filters.
- *
- * @example
- * // appsDir = "/workspace/manager/apps"
- * // appFolders = ["zimbra", "web"]
- * // Returns: ["@ovh-ux/manager-zimbra-app", "@ovh-ux/manager-web-app"]
- */
-function resolveTurboFiltersFromAppFolders(appsDir, appFolders) {
-  return appFolders
-    .map((appFolder) => {
-      const pkgPath = path.join(appsDir, appFolder, 'package.json');
-      if (!fs.existsSync(pkgPath)) {
-        logError(`❌ No package.json for app folder ${appFolder}, skipping`);
-        return null;
-      }
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-      return pkg.name;
-    })
-    .filter(Boolean);
-}
-
-/**
- * Resolve Turbo filters (package names) based on input mode.
- *
- * - If only `appFolders` are provided, resolves their corresponding package names.
- * - If `packageNames` are provided, they are used directly as filters.
- *
- * @param {Object} options
- * @param {string} options.appsDir - Absolute path to the apps root directory.
- * @param {string[]} options.appFolders - List of app folders to analyze.
- * @param {string[]} options.packageNames - List of package names (overrides appFolders).
- * @returns {string[]} List of resolved Turbo filters (package names).
- *
- * @example
- * resolveTurboFilters({
- *   appsDir: "/workspace/manager/apps",
- *   appFolders: ["zimbra"],
- *   packageNames: []
- * });
- * // → ["@ovh-ux/manager-zimbra-app"]
- *
- * @example
- * resolveTurboFilters({
- *   appsDir: "/workspace/manager/apps",
- *   appFolders: [],
- *   packageNames: ["@ovh-ux/manager-web-app"]
- * });
- * // → ["@ovh-ux/manager-web-app"]
- */
-export function resolveTurboFilters({ appsDir, appFolders, packageNames }) {
-  let filters = [];
-
-  if (appFolders.length > 0 && packageNames.length === 0) {
-    filters = resolveTurboFiltersFromAppFolders(appsDir, appFolders);
-  } else if (packageNames.length > 0) {
-    filters = packageNames;
-  }
-
-  return filters;
-}
+import { logInfo, logWarn } from './log-utils.js';
 
 /**
  * Run a Turbo build for the provided filters.
@@ -81,19 +11,25 @@ export function resolveTurboFilters({ appsDir, appFolders, packageNames }) {
  *
  * @param {string} rootDir - Root directory where Turbo should be executed.
  * @param {string[]} filters - List of Turbo build filters (package names).
+ * @param {string[]} [extraArgs=[]] - Additional arguments to forward to Turbo.
  * @returns {void}
  *
  * @example
  * runTurboBuild("/workspace", ["@ovh-ux/manager-zimbra-app"]);
  * // Executes: turbo run build --filter @ovh-ux/manager-zimbra-app
  */
-export function runTurboBuild(rootDir, filters) {
+export function runTurboBuild(rootDir, filters, extraArgs = []) {
   if (filters.length === 0) {
     logWarn('⚠️ No Turbo build filters provided, skipping build step.');
     return;
   }
 
-  const turboArgs = ['run', 'build', ...filters.flatMap((pkgName) => ['--filter', pkgName])];
+  const turboArgs = [
+    'run',
+    'build',
+    ...filters.flatMap((pkgName) => ['--filter', pkgName]),
+    ...extraArgs,
+  ];
   logInfo(`Building with Turbo (filters: ${filters.join(', ')})`);
 
   const buildResult = spawnSync('turbo', turboArgs, {
@@ -124,7 +60,12 @@ export function runTurboBuild(rootDir, filters) {
  * runTurboTests(process.cwd(), ['web', 'zimbra'], ['--', '--coverage']);
  */
 export function runTurboTests(rootDir, filters, extraArgs = []) {
-  const args = ['run', 'test', ...filters.flatMap((pkg) => ['--filter', pkg]), ...extraArgs];
+  const args = [
+    'run',
+    'test',
+    ...filters.flatMap((pkgName) => ['--filter', pkgName]),
+    ...extraArgs,
+  ];
   logInfo(`Testing with Turbo (filters: ${filters.join(', ')})`);
 
   const res = spawnSync('turbo', args, {

package/dist/adapters/code-duplication/helpers/code-duplication-analysis-helper.d.ts

@@ -1,6 +1,9 @@
 import { CombinedCodeDuplicationSummary, JscpdReportV4, WorstCodeDuplicationFile } from '../types/CodeDuplication.js';
 export declare const extPriority: (file: string) => number;
-export declare function extractWorstFiles(report: JscpdReportV4): WorstCodeDuplicationFile[];
+export declare function extractWorstFiles(report: JscpdReportV4): {
+    files: WorstCodeDuplicationFile[];
+    fileCount: number;
+};
 export declare function collectCodeDuplication(reportOutputDir: string): CombinedCodeDuplicationSummary;
 export declare function generateCodeDuplicationHtml(summary: CombinedCodeDuplicationSummary): string;
 //# sourceMappingURL=code-duplication-analysis-helper.d.ts.map

package/dist/adapters/code-duplication/helpers/code-duplication-analysis-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-duplication-analysis-helper.d.ts","sourceRoot":"","sources":["../../../../src/adapters/code-duplication/helpers/code-duplication-analysis-helper.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,8BAA8B,EAC9B,aAAa,EACb,wBAAwB,EAEzB,MAAM,0BAA0B,CAAC;AAUlC,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAc1C,CAAC;AAkEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,wBAAwB,EAAE,CAsEnF;AAkED,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,8BAA8B,CA+B9F;AAyGD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM,CAmC3F"}
+{"version":3,"file":"code-duplication-analysis-helper.d.ts","sourceRoot":"","sources":["../../../../src/adapters/code-duplication/helpers/code-duplication-analysis-helper.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,8BAA8B,EAC9B,aAAa,EACb,wBAAwB,EAEzB,MAAM,0BAA0B,CAAC;AAUlC,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAc1C,CAAC;AAmEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG;IACxD,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB,CAwEA;AA4ED,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,8BAA8B,CA+B9F;AAsGD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM,CAyD3F"}

package/dist/adapters/code-duplication/helpers/code-duplication-analysis-helper.js

@@ -32,7 +32,7 @@ function shortPathFromAppsRoot(filePath, app) {
 export function extractWorstFiles(report) {
     const dups = Array.isArray(report?.duplicates) ? report.duplicates : [];
     if (dups.length === 0)
-        return [];
+        return { files: [], fileCount: 0 };
     const { threshold, count } = codeDuplicationConfig.worstFiles;
     const fileMap = {};
     for (const dup of dups) {
@@ -56,7 +56,7 @@ export function extractWorstFiles(report) {
         const estTotal = fileMap[file].estimatedTotal;
         fileMap[file].total = Math.max(realTotal || estTotal || 0, fileMap[file].dup);
     }
-    return Object.entries(fileMap)
+    const files = Object.entries(fileMap)
         .map(([file, { dup, total = 0 }]) => {
         const percentage = total > 0 ? (dup / total) * 100 : 0;
         const stats = {
@@ -84,6 +84,7 @@ export function extractWorstFiles(report) {
         return a[0].localeCompare(b[0]);
     })
         .slice(0, count);
+    return { files, fileCount: Object.keys(fileMap).length };
 }
 function parseAppCodeDuplicationReport(jsonPath) {
     try {
@@ -91,14 +92,22 @@ function parseAppCodeDuplicationReport(jsonPath) {
         const total = report.statistics?.total ?? {};
         const totalLines = total.lines ?? 0;
         const duplicateLines = total.duplicatedLines ?? 0;
+        const percentage = total.percentage ?? (totalLines > 0 ? (duplicateLines / totalLines) * 100 : 0);
+        const { files: worstFiles, fileCount } = extractWorstFiles(report);
+        const perFilePercentages = worstFiles.map(([, f]) => f.percentage);
+        const minPercentage = perFilePercentages.length ? Math.min(...perFilePercentages) : percentage;
+        const maxPercentage = perFilePercentages.length ? Math.max(...perFilePercentages) : percentage;
         return {
             totalLines,
             totalTokens: total.tokens ?? 0,
             duplicateLines,
             duplicateTokens: total.duplicatedTokens ?? 0,
             clonesCount: total.clones ?? 0,
-            percentage: total.percentage ?? (totalLines > 0 ? (duplicateLines / totalLines) * 100 : 0),
-            worstFiles: extractWorstFiles(report),
+            percentage,
+            minPercentage,
+            maxPercentage,
+            worstFiles,
+            filesWithDuplication: fileCount,
         };
     }
     catch (err) {
@@ -109,8 +118,11 @@ function parseAppCodeDuplicationReport(jsonPath) {
             duplicateTokens: 0,
             clonesCount: 0,
             percentage: 0,
+            minPercentage: 0,
+            maxPercentage: 0,
             error: err.message,
             worstFiles: [],
+            filesWithDuplication: 0,
         };
     }
 }
@@ -157,11 +169,12 @@ const getColorForDuplicationStatus = (pct) => {
     return pct < green ? 'green' : pct < orange ? 'orange' : 'red';
 };
 function renderWorstFiles(app, worstFiles = []) {
+    const threshold = codeDuplicationConfig.worstFiles.threshold;
     if (!worstFiles.length) {
         return `
-      <details>
-        <summary>⚠️ Worst duplicated files</summary>
-        <p style="margin:0.5rem 0; color:#888;">No files above threshold 🎉</p>
+      <details class="coverage-details">
+        <summary>📊 Duplication Overview for <strong>${app}</strong></summary>
+        <p class="coverage-empty">No files above threshold 🎉</p>
       </details>`;
     }
     const rows = worstFiles
@@ -169,21 +182,39 @@ function renderWorstFiles(app, worstFiles = []) {
         const short = shortPathFromAppsRoot(file, app);
         const color = getColorForDuplicationStatus(f.percentage);
         return `
-      <tr>
-        <td colspan="2" title="${file}">${short}</td>
-        <td>${f.duplicatedLines}/${f.totalLines}</td>
-        <td style="color:${color}">${f.percentage.toFixed(2)}%</td>
-      </tr>`;
+        <tr>
+          <td colspan="2" title="${file}">${short}</td>
+          <td>${f.duplicatedLines}/${f.totalLines}</td>
+          <td style="color:${color}">${f.percentage.toFixed(2)}%</td>
+        </tr>`;
     })
         .join('');
     return `
-    <details>
-      <summary>⚠️ Worst duplicated files (≥ ${codeDuplicationConfig.worstFiles.threshold}%)</summary>
-      <table style="margin:0.5rem 0; border:1px solid #ccc; width:95%;">
+    <details class="coverage-details">
+      <summary>📊 Duplication Overview for <strong>${app}</strong> (≥ ${threshold}%)</summary>
+      <table class="coverage-subtable">
         <tbody>${rows}</tbody>
       </table>
     </details>`;
 }
+function renderDuplicationCell(stats) {
+    const min = stats.minPercentage ?? stats.percentage;
+    const max = stats.maxPercentage ?? stats.percentage;
+    if (stats.duplicateLines === 0) {
+        return `<span style="color:${getColorForDuplicationStatus(0)}">0.00%</span>`;
+    }
+    if (min.toFixed(2) === max.toFixed(2)) {
+        return `
+      ${stats.percentage.toFixed(2)}% (${stats.filesWithDuplication} files cluster at
+      <span style="color:${getColorForDuplicationStatus(min)}">${min.toFixed(2)}%</span>)
+    `;
+    }
+    return `
+    ${stats.percentage.toFixed(2)}% (range:
+      <span style="color:${getColorForDuplicationStatus(min)}">${min.toFixed(2)}%</span> –
+      <span style="color:${getColorForDuplicationStatus(max)}">${max.toFixed(2)}%</span>)
+  `;
+}
 function buildAppRow(app, stats) {
     if (stats.error) {
         return `<tr style="background:#ffe0e0">
@@ -191,15 +222,16 @@ function buildAppRow(app, stats) {
       <td colspan="5" style="color:red">${stats.error}</td>
     </tr>`;
     }
-    const color = getColorForDuplicationStatus(stats.percentage);
-    const bg = color === 'green' ? '#e6ffed' : color === 'orange' ? '#fff8e1' : '#ffe6e6';
+    const max = stats.maxPercentage ?? stats.percentage;
+    const rowColor = getColorForDuplicationStatus(max);
+    const bg = rowColor === 'green' ? '#e6ffed' : rowColor === 'orange' ? '#fff8e1' : '#ffe6e6';
     return `
 <tr style="background:${bg}">
   <td>${app}</td>
   <td>${stats.totalLines}</td>
   <td>${stats.duplicateLines}</td>
   <td>${stats.clonesCount}</td>
-  <td style="font-weight:bold; color:${color};">${stats.percentage.toFixed(2)}%</td>
+  <td style="font-weight:bold;">${renderDuplicationCell(stats)}</td>
 </tr>
 <tr><td colspan="5">${renderWorstFiles(app, stats.worstFiles)}</td></tr>`;
 }
@@ -217,6 +249,28 @@ export function generateCodeDuplicationHtml(summary) {
           table { border-collapse: collapse; width: 100%; }
           th, td { border: 1px solid #ccc; padding: 0.5rem; text-align: left; }
           th { background: #f0f0f0; }
+          .coverage-details {
+            margin: 0.3rem 0 0.8rem 1.5rem;
+            padding: 0.5rem;
+            border-left: 3px solid #ccc;
+            background: #fafafa;
+            border-radius: 4px;
+          }
+          .coverage-details summary {
+            font-weight: bold;
+            cursor: pointer;
+          }
+          .coverage-subtable {
+            margin-top: 0.5rem;
+            border: 1px solid #ddd;
+            width: 95%;
+            font-size: 0.9em;
+          }
+          .coverage-empty {
+            margin: 0.5rem 0;
+            color: #888;
+            font-style: italic;
+          }
         </style>
       </head>
       <body>

package/dist/adapters/code-duplication/types/CodeDuplication.d.ts

@@ -4,7 +4,10 @@ export interface AppCodeDuplicationSummary {
     duplicateLines: number;
     duplicateTokens: number;
     percentage: number;
+    minPercentage: number;
+    maxPercentage: number;
     clonesCount: number;
+    filesWithDuplication: number;
     error?: string;
     worstFiles?: WorstCodeDuplicationFile[];
 }

package/dist/adapters/code-duplication/types/CodeDuplication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodeDuplication.d.ts","sourceRoot":"","sources":["../../../../src/adapters/code-duplication/types/CodeDuplication.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,yBAAyB;IAExC,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,MAAM,CAAC;IAGpB,cAAc,EAAE,MAAM,CAAC;IAGvB,eAAe,EAAE,MAAM,CAAC;IAMxB,UAAU,EAAE,MAAM,CAAC;IAMnB,WAAW,EAAE,MAAM,CAAC;IAMpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAMf,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACzC;AAKD,MAAM,WAAW,8BAA8B;IAK7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAGhD,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,MAAM,CAAC;IAGpB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;IAM7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM;IACN;QAEE,eAAe,EAAE,MAAM,CAAC;QAGxB,UAAU,EAAE,MAAM,CAAC;QAGnB,UAAU,EAAE,MAAM,CAAC;KACpB;CACF,CAAC;AAKF,MAAM,WAAW,cAAc;IAE7B,eAAe,EAAE,MAAM,CAAC;IAGxB,UAAU,EAAE,MAAM,CAAC;IAGnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,UAAU,kBAAkB;IAE1B,IAAI,EAAE,MAAM,CAAC;IAMb,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAM7B,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAKD,UAAU,cAAc;IAKtB,KAAK,EAAE,MAAM,CAAC;IAGd,SAAS,EAAE,kBAAkB,CAAC;IAG9B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAMD,MAAM,WAAW,aAAa;IAK5B,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE;YAEN,KAAK,CAAC,EAAE,MAAM,CAAC;YAGf,MAAM,CAAC,EAAE,MAAM,CAAC;YAGhB,eAAe,CAAC,EAAE,MAAM,CAAC;YAGzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAG1B,MAAM,CAAC,EAAE,MAAM,CAAC;YAMhB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IAMF,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B"}
+{"version":3,"file":"CodeDuplication.d.ts","sourceRoot":"","sources":["../../../../src/adapters/code-duplication/types/CodeDuplication.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,yBAAyB;IAExC,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,MAAM,CAAC;IAGpB,cAAc,EAAE,MAAM,CAAC;IAGvB,eAAe,EAAE,MAAM,CAAC;IAMxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IAMtB,WAAW,EAAE,MAAM,CAAC;IAMpB,oBAAoB,EAAE,MAAM,CAAC;IAM7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAMf,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACzC;AAKD,MAAM,WAAW,8BAA8B;IAK7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAGhD,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,MAAM,CAAC;IAGpB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;IAM7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM;IACN;QAEE,eAAe,EAAE,MAAM,CAAC;QAGxB,UAAU,EAAE,MAAM,CAAC;QAGnB,UAAU,EAAE,MAAM,CAAC;KACpB;CACF,CAAC;AAKF,MAAM,WAAW,cAAc;IAE7B,eAAe,EAAE,MAAM,CAAC;IAGxB,UAAU,EAAE,MAAM,CAAC;IAGnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,UAAU,kBAAkB;IAE1B,IAAI,EAAE,MAAM,CAAC;IAMb,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAM7B,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAKD,UAAU,cAAc;IAKtB,KAAK,EAAE,MAAM,CAAC;IAGd,SAAS,EAAE,kBAAkB,CAAC;IAG9B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAMD,MAAM,WAAW,aAAa;IAK5B,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE;YAEN,KAAK,CAAC,EAAE,MAAM,CAAC;YAGf,MAAM,CAAC,EAAE,MAAM,CAAC;YAGhB,eAAe,CAAC,EAAE,MAAM,CAAC;YAGzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAG1B,MAAM,CAAC,EAAE,MAAM,CAAC;YAMhB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IAMF,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B"}

package/dist/adapters/perf-budgets/helpers/perfs-bundle-analysis-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"perfs-bundle-analysis-helper.d.ts","sourceRoot":"","sources":["../../../../src/adapters/perf-budgets/helpers/perfs-bundle-analysis-helper.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKtE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAmCD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,YAAY,CAgBlE;AASD,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,kBAAkB,CAmC9E;AASD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAwJ3E"}
+{"version":3,"file":"perfs-bundle-analysis-helper.d.ts","sourceRoot":"","sources":["../../../../src/adapters/perf-budgets/helpers/perfs-bundle-analysis-helper.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKtE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAyCD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,YAAY,CAgBlE;AASD,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,kBAAkB,CAmC9E;AASD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAwJ3E"}

package/dist/adapters/perf-budgets/helpers/perfs-bundle-analysis-helper.js

@@ -15,14 +15,18 @@ const buildAssetsInfos = (data) => data.map((entry) => {
     const filename = entry?.filename ?? 'unknown';
     const sizeKb = typeof entry?.parsedSize === 'number' ? entry.parsedSize / 1024 : 0;
     let type = 'other';
-    if (/\.js$/i.test(filename))
+    if (/\.(js|mjs|cjs|ts|tsx)$/i.test(filename)) {
         type = 'js';
-    else if (/\.css$/i.test(filename))
+    }
+    else if (/\.css$/i.test(filename)) {
         type = 'css';
-    else if (/\.html$/i.test(filename))
+    }
+    else if (/\.html?$/i.test(filename)) {
         type = 'html';
-    else if (/\.(png|jpe?g|gif|svg|webp)$/i.test(filename))
+    }
+    else if (/\.(png|jpe?g|gif|svg|webp)$/i.test(filename)) {
         type = 'img';
+    }
     return { filename, type, sizeKb };
 });
 export function parseAnalyzerJson(raw) {

package/dist/adapters/tests-coverage/helpers/tests-coverage-analysis-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tests-coverage-analysis-helper.d.ts","sourceRoot":"","sources":["../../../../src/adapters/tests-coverage/helpers/tests-coverage-analysis-helper.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,qBAAqB,EAKtB,MAAM,wBAAwB,CAAC;AA2HhC,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAmC9E;AAiED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,UAAU,EAAE,MAAM,GACjB,MAAM,CAuER"}
+{"version":3,"file":"tests-coverage-analysis-helper.d.ts","sourceRoot":"","sources":["../../../../src/adapters/tests-coverage/helpers/tests-coverage-analysis-helper.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,qBAAqB,EAKtB,MAAM,wBAAwB,CAAC;AA2HhC,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAmC9E;AAiED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,UAAU,EAAE,MAAM,GACjB,MAAM,CA6FR"}