@hyperfrontend/project-scope 0.1.0 → 0.2.1

package/heuristics/index.esm.js

@@ -9,7 +9,6 @@ import { existsSync, readFileSync, statSync, lstatSync, readdirSync } from 'node
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/json
  */
-// Capture references at module initialization time
 const _JSON = globalThis.JSON;
 /**
  * (Safe copy) Converts a JavaScript Object Notation (JSON) string into an object.
@@ -28,7 +27,6 @@ const stringify = _JSON.stringify;
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/math
  */
-// Capture references at module initialization time
 const _Math = globalThis.Math;
 /**
  * (Safe copy) Returns the value of a number rounded to the nearest integer.
@@ -47,7 +45,6 @@ const min = _Math.min;
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
  */
-// Capture references at module initialization time
 const _Object = globalThis.Object;
 /**
  * (Safe copy) Prevents modification of existing property attributes and values,
@@ -82,7 +79,6 @@ const defineProperties = _Object.defineProperties;
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
  */
-// Capture references at module initialization time
 const _Error = globalThis.Error;
 const _Reflect$2 = globalThis.Reflect;
 /**
@@ -103,7 +99,6 @@ const createError = (message, options) => _Reflect$2.construct(_Error, [message,
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/array
  */
-// Capture references at module initialization time
 const _Array = globalThis.Array;
 /**
  * (Safe copy) Determines whether the passed value is an Array.
@@ -118,7 +113,6 @@ const isArray = _Array.isArray;
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/console
  */
-// Capture references at module initialization time
 const _console = globalThis.console;
 /**
  * (Safe copy) Outputs a message to the console.
@@ -204,7 +198,6 @@ _console.timeLog.bind(_console);
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
  */
-// Capture references at module initialization time
 const _Set = globalThis.Set;
 const _Reflect$1 = globalThis.Reflect;
 /**
@@ -252,7 +245,6 @@ const getType = (target) => {
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/map
  */
-// Capture references at module initialization time
 const _Map = globalThis.Map;
 const _Reflect = globalThis.Reflect;
 /**
@@ -530,14 +522,11 @@ function formatMessage(namespace, message, meta) {
  */
 function createScopedLogger(namespace, options = {}) {
     const { level = 'error', sanitizeSecrets = true } = options;
-    // Create wrapper functions that add namespace prefix and sanitization
     const createLogFn = (baseFn) => (message, meta) => {
         const processedMeta = sanitizeSecrets && meta ? sanitize(meta) : meta;
         baseFn(formatMessage(namespace, message, processedMeta));
     };
-    // Create base logger with wrapped functions
     const baseLogger = createLogger(createLogFn(error), createLogFn(warn), createLogFn(log), createLogFn(info), createLogFn(debug));
-    // Set initial log level (use global override if set)
     baseLogger.setLogLevel(level);
     const scopedLogger = freeze({
         error: (message, meta) => baseLogger.error(message, meta),
@@ -548,7 +537,6 @@ function createScopedLogger(namespace, options = {}) {
         setLogLevel: baseLogger.setLogLevel,
         getLogLevel: baseLogger.getLogLevel,
     });
-    // Register logger for global level management
     loggerRegistry.add(scopedLogger);
     return scopedLogger;
 }
@@ -879,7 +867,6 @@ const cacheRegistry = createSet();
 function createCache(options) {
     const { ttl, maxSize } = options ?? {};
     const store = createMap();
-    // Track insertion order for FIFO eviction
     const insertionOrder = [];
     /**
      * Check if an entry is expired.
@@ -930,12 +917,10 @@ function createCache(options) {
             return entry.value;
         },
         set(key, value) {
-            // If key exists, remove from order first
             if (store.has(key)) {
                 removeFromOrder(key);
             }
             else {
-                // Evict if needed before adding new entry
                 evictIfNeeded();
             }
             // eslint-disable-next-line workspace/no-unsafe-builtin-methods -- Date.now() is needed for Jest fake timers compatibility
@@ -968,7 +953,6 @@ function createCache(options) {
             return [...insertionOrder];
         },
     };
-    // Register cache for global operations
     cacheRegistry.add(cache);
     return freeze(cache);
 }
@@ -999,7 +983,6 @@ function collectAllDependencies(packageJson) {
 function parseVersionString(versionString) {
     if (versionString === undefined || versionString === null)
         return undefined;
-    // Manual parsing instead of regex to avoid ReDoS
     let start = 0;
     while (start < versionString.length) {
         const char = versionString[start];
@@ -1060,7 +1043,6 @@ function expressDetector(projectPath, packageJson) {
         version = parseVersionString(deps['express']);
         sources.push({ type: 'package.json', field: 'dependencies.express' });
     }
-    // @types/express (indicates usage)
     if (deps['@types/express']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.@types/express' });
@@ -1096,13 +1078,11 @@ function nestDetector(projectPath, packageJson) {
     let version;
     let configPath;
     const deps = collectAllDependencies(pkg);
-    // @nestjs/core package
     if (deps['@nestjs/core']) {
         confidence += 70;
         version = parseVersionString(deps['@nestjs/core']);
         sources.push({ type: 'package.json', field: 'dependencies.@nestjs/core' });
     }
-    // @nestjs/common
     if (deps['@nestjs/common']) {
         confidence += 15;
         sources.push({ type: 'package.json', field: 'dependencies.@nestjs/common' });
@@ -1153,7 +1133,6 @@ function fastifyDetector(projectPath, packageJson) {
         confidence += 15;
         sources.push({ type: 'package.json', field: 'dependencies (fastify plugins)' });
     }
-    // @types/fastify (older versions)
     if (deps['@types/fastify']) {
         confidence += 5;
         sources.push({ type: 'package.json', field: 'dependencies.@types/fastify' });
@@ -1188,7 +1167,6 @@ function koaDetector(projectPath, packageJson) {
         version = parseVersionString(deps['koa']);
         sources.push({ type: 'package.json', field: 'dependencies.koa' });
     }
-    // @types/koa
     if (deps['@types/koa']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.@types/koa' });
@@ -1731,7 +1709,6 @@ function remixDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @remix-run packages
     if (deps['@remix-run/react']) {
         confidence += 70;
         version = parseVersionString(deps['@remix-run/react']);
@@ -2007,7 +1984,6 @@ function sveltekitDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @sveltejs/kit package
     if (deps['@sveltejs/kit']) {
         confidence += 70;
         version = parseVersionString(deps['@sveltejs/kit']);
@@ -2086,13 +2062,11 @@ function qwikDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @builder.io/qwik package
     if (deps['@builder.io/qwik']) {
         confidence += 70;
         version = parseVersionString(deps['@builder.io/qwik']);
         sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik' });
     }
-    // @builder.io/qwik-city
     if (deps['@builder.io/qwik-city']) {
         confidence += 20;
         sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik-city' });
@@ -2185,23 +2159,19 @@ function angularJSDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // AngularJS package (angular, not @angular/core)
     if (deps['angular']) {
         confidence += 70;
         version = parseVersionString(deps['angular']);
         sources.push({ type: 'package.json', field: 'dependencies.angular' });
     }
-    // AngularJS router
     if (deps['angular-route']) {
         confidence += 15;
         sources.push({ type: 'package.json', field: 'dependencies.angular-route' });
     }
-    // AngularJS resource
     if (deps['angular-resource']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.angular-resource' });
     }
-    // AngularJS animate
     if (deps['angular-animate']) {
         confidence += 5;
         sources.push({ type: 'package.json', field: 'dependencies.angular-animate' });
@@ -2232,23 +2202,19 @@ function backboneDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // Backbone package
     if (deps['backbone']) {
         confidence += 70;
         version = parseVersionString(deps['backbone']);
         sources.push({ type: 'package.json', field: 'dependencies.backbone' });
-        // Underscore (commonly used with Backbone)
         if (deps['underscore']) {
             confidence += 15;
             sources.push({ type: 'package.json', field: 'dependencies.underscore' });
         }
-        // Lodash can be used as underscore replacement
         if (deps['lodash']) {
             confidence += 5;
             sources.push({ type: 'package.json', field: 'dependencies.lodash' });
         }
     }
-    // Marionette (Backbone framework)
     if (deps['backbone.marionette'] || deps['marionette']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.backbone.marionette' });
@@ -2279,18 +2245,15 @@ function emberDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // Ember source package
     if (deps['ember-source']) {
         confidence += 70;
         version = parseVersionString(deps['ember-source']);
         sources.push({ type: 'package.json', field: 'dependencies.ember-source' });
     }
-    // Ember CLI
     if (deps['ember-cli']) {
         confidence += 20;
         sources.push({ type: 'package.json', field: 'devDependencies.ember-cli' });
     }
-    // Ember Data
     if (deps['ember-data']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.ember-data' });
@@ -2321,18 +2284,15 @@ function jqueryDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // jQuery package
     if (deps['jquery']) {
         confidence += 80;
         version = parseVersionString(deps['jquery']);
         sources.push({ type: 'package.json', field: 'dependencies.jquery' });
     }
-    // jQuery UI
     if (deps['jquery-ui']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.jquery-ui' });
     }
-    // jQuery plugins
     if (deps['jquery-validation']) {
         confidence += 5;
         sources.push({ type: 'package.json', field: 'dependencies.jquery-validation' });
@@ -2461,7 +2421,6 @@ function prettierDetector(projectPath, packageJson) {
         confidence += 30;
         sources.push({ type: 'package.json', field: 'prettier' });
     }
-    // .prettierignore file
     if (exists(join$1(projectPath, '.prettierignore'))) {
         confidence += 10;
         sources.push({ type: 'config-file', path: '.prettierignore' });
@@ -2556,7 +2515,6 @@ function biomeDetector(projectPath, packageJson) {
     let configPath;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @biomejs/biome package
     if (deps['@biomejs/biome']) {
         confidence += 70;
         version = parseVersionString(deps['@biomejs/biome']);
@@ -2825,7 +2783,7 @@ function npmWorkspacesDetector(workspacePath, packageJson) {
         sources.push({ type: 'lockfile', path: 'package-lock.json' });
     }
     if (exists(join$1(workspacePath, 'yarn.lock'))) {
-        return null; // Let yarn workspace detector handle this
+        return null;
     }
     if (confidence === 0) {
         return null;
@@ -3168,7 +3126,6 @@ function checkTsConfigStrict(projectPath) {
     if (!content)
         return undefined;
     try {
-        // Simple JSON parsing - doesn't handle comments but good enough for strict check
         const cleanContent = content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '');
         const parsed = parse(cleanContent);
         return parsed?.compilerOptions?.strict === true;
@@ -3191,19 +3148,16 @@ function typescriptDetector(projectPath, packageJson) {
     let configPath;
     let version;
     const deps = collectAllDependencies(pkg);
-    // TypeScript package
     if (deps['typescript']) {
         confidence += 50;
         version = parseVersionString(deps['typescript']);
         sources.push({ type: 'package.json', field: 'dependencies.typescript' });
     }
-    // tsconfig.json
     if (exists(join$1(projectPath, 'tsconfig.json'))) {
         confidence += 40;
         configPath = 'tsconfig.json';
         sources.push({ type: 'config-file', path: 'tsconfig.json' });
     }
-    // tsconfig.*.json variants
     const tsconfigVariants = ['tsconfig.build.json', 'tsconfig.lib.json', 'tsconfig.spec.json', 'tsconfig.app.json'];
     for (const variant of tsconfigVariants) {
         if (exists(join$1(projectPath, variant))) {
@@ -3212,7 +3166,6 @@ function typescriptDetector(projectPath, packageJson) {
             break;
         }
     }
-    // @types packages
     const typePackages = keys(deps).filter((d) => d.startsWith('@types/'));
     if (typePackages.length > 0) {
         confidence += 10;
@@ -3246,24 +3199,20 @@ function flowDetector(projectPath, packageJson) {
     let configPath;
     let version;
     const deps = collectAllDependencies(pkg);
-    // flow-bin package
     if (deps['flow-bin']) {
         confidence += 60;
         version = parseVersionString(deps['flow-bin']);
         sources.push({ type: 'package.json', field: 'dependencies.flow-bin' });
     }
-    // .flowconfig
     if (exists(join$1(projectPath, '.flowconfig'))) {
         confidence += 40;
         configPath = '.flowconfig';
         sources.push({ type: 'config-file', path: '.flowconfig' });
     }
-    // flow-typed directory
     if (exists(join$1(projectPath, 'flow-typed'))) {
         confidence += 10;
         sources.push({ type: 'directory', path: 'flow-typed/' });
     }
-    // @babel/preset-flow
     if (deps['@babel/preset-flow']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.@babel/preset-flow' });
@@ -3287,7 +3236,6 @@ function flowDetector(projectPath, packageJson) {
  * @returns `true` if the content contains JSDoc type annotations.
  */
 function hasJsDocTypes(content) {
-    // Check for JSDoc type annotations
     return (content.includes('@type {') ||
         content.includes('@param {') ||
         content.includes('@returns {') ||
@@ -3306,14 +3254,11 @@ function jsdocDetector(projectPath, packageJson) {
     const sources = [];
     let confidence = 0;
     const deps = collectAllDependencies(pkg);
-    // jsdoc package
     if (deps['jsdoc']) {
         confidence += 30;
         sources.push({ type: 'package.json', field: 'dependencies.jsdoc' });
     }
-    // typescript with checkJs (JSDoc type checking)
     if (deps['typescript']) {
-        // Check if checkJs is enabled in tsconfig
         const tsconfigPath = join$1(projectPath, 'tsconfig.json');
         const content = readFileIfExists(tsconfigPath);
         if (content) {
@@ -3330,12 +3275,10 @@ function jsdocDetector(projectPath, packageJson) {
             }
         }
     }
-    // Check for jsconfig.json (VS Code JS type checking)
     if (exists(join$1(projectPath, 'jsconfig.json'))) {
         confidence += 40;
         sources.push({ type: 'config-file', path: 'jsconfig.json' });
     }
-    // Sample check for JSDoc annotations in source files
     const srcDir = join$1(projectPath, 'src');
     if (exists(srcDir)) {
         try {
@@ -3386,8 +3329,6 @@ const detectAllCache = createCache({ ttl: 60000, maxSize: 50 });
 function isDetectAllOptions(value) {
     if (typeof value !== 'object' || value === null)
         return false;
-    // DetectAllOptions has skipCache or packageJson fields specifically
-    // PackageJson never has skipCache field
     return 'skipCache' in value || 'packageJson' in value;
 }
 /**
@@ -3419,9 +3360,7 @@ function isDetectAllOptions(value) {
  * ```
  */
 function detectAll(projectPath, packageJsonOrOptions) {
-    // Handle backward-compatible arguments
     const options = isDetectAllOptions(packageJsonOrOptions) ? packageJsonOrOptions : { packageJson: packageJsonOrOptions };
-    // Check cache first (unless skipCache is true)
     if (!options.skipCache) {
         const cached = detectAllCache.get(projectPath);
         if (cached) {
@@ -3472,7 +3411,6 @@ function detectAll(projectPath, packageJsonOrOptions) {
         legacyFrameworks: result.legacyFrameworks.map((f) => f.id),
         testingFrameworks: result.testingFrameworks.map((f) => f.id),
     });
-    // Cache the result
     detectAllCache.set(projectPath, result);
     return result;
 }
@@ -3842,10 +3780,6 @@ function usesFramework(projectPath, frameworkId, minConfidence = 50) {
     return allFrameworks.some((f) => f.id === frameworkId && f.confidence >= minConfidence);
 }
 
-/**
- * Pattern matching utilities with ReDoS protection.
- * Uses character-by-character matching instead of regex where possible.
- */
 /**
  * Match path against glob pattern using safe character iteration.
  * Avoids regex to prevent ReDoS attacks.
@@ -3883,17 +3817,14 @@ function matchGlobPattern(path, pattern) {
  * @returns True if remaining segments match
  */
 function matchSegments(pathParts, patternParts, pathIdx, patternIdx) {
-    // Base cases
     if (pathIdx === pathParts.length && patternIdx === patternParts.length) {
-        return true; // Both exhausted = match
+        return true;
     }
     if (patternIdx >= patternParts.length) {
-        return false; // Pattern exhausted but path remains
+        return false;
     }
     const patternPart = patternParts[patternIdx];
-    // Handle ** (globstar) - matches zero or more directories
     if (patternPart === '**') {
-        // Try matching rest of pattern against current position and all future positions
         for (let i = pathIdx; i <= pathParts.length; i++) {
             if (matchSegments(pathParts, patternParts, i, patternIdx + 1)) {
                 return true;
@@ -3902,10 +3833,9 @@ function matchSegments(pathParts, patternParts, pathIdx, patternIdx) {
         return false;
     }
     if (pathIdx >= pathParts.length) {
-        return false; // Path exhausted but pattern remains (and it's not **)
+        return false;
     }
     const pathPart = pathParts[pathIdx];
-    // Match current segment
     if (matchSegment(pathPart, patternPart)) {
         return matchSegments(pathParts, patternParts, pathIdx + 1, patternIdx + 1);
     }
@@ -3925,12 +3855,10 @@ function matchSegment(text, pattern) {
     while (patternIdx < pattern.length) {
         const char = pattern[patternIdx];
         if (char === '*') {
-            // * matches zero or more characters
             patternIdx++;
             if (patternIdx === pattern.length) {
-                return true; // * at end matches rest of string
+                return true;
             }
-            // Try matching rest of pattern at each position in text
             for (let i = textIdx; i <= text.length; i++) {
                 if (matchSegmentFrom(text, i, pattern, patternIdx)) {
                     return true;
@@ -3939,7 +3867,6 @@ function matchSegment(text, pattern) {
             return false;
         }
         else if (char === '?') {
-            // ? matches exactly one character
             if (textIdx >= text.length) {
                 return false;
             }
@@ -3947,10 +3874,8 @@ function matchSegment(text, pattern) {
             patternIdx++;
         }
         else if (char === '{') {
-            // {a,b,c} matches any alternative
             const closeIdx = findClosingBrace(pattern, patternIdx);
             if (closeIdx === -1) {
-                // Unmatched brace, treat as literal
                 if (textIdx >= text.length || text[textIdx] !== char) {
                     return false;
                 }
@@ -3968,7 +3893,6 @@ function matchSegment(text, pattern) {
             }
         }
         else {
-            // Literal character
             if (textIdx >= text.length || text[textIdx] !== char) {
                 return false;
             }
@@ -4254,7 +4178,8 @@ const entryPointLogger = createScopedLogger('project-scope:heuristics:entry-poin
  */
 const entryPointCache = createCache({ ttl: 60000, maxSize: 50 });
 /**
- * Common entry point patterns.
+ * Common entry point patterns by project type.
+ * Used for convention-based entry point discovery.
  */
 const ENTRY_POINT_PATTERNS = {
     /** Library entry patterns */
@@ -4520,29 +4445,23 @@ const depsLogger = createScopedLogger('project-scope:heuristics:deps');
  */
 function extractImports(content) {
     const imports = [];
-    // ES import with 'from': import X from 'path' or import { X } from 'path'
-    // Use non-greedy match and avoid nested quantifiers by matching "from" keyword directly
     const esImportFromRegex = /import\s+.+?\s+from\s+['"]([^'"]+)['"]/g;
     let match;
     while ((match = esImportFromRegex.exec(content)) !== null) {
         imports.push(match[1]);
     }
-    // Side-effect import: import 'path'
     const sideEffectImportRegex = /import\s+['"]([^'"]+)['"]/g;
     while ((match = sideEffectImportRegex.exec(content)) !== null) {
         imports.push(match[1]);
     }
-    // Dynamic import: import('path')
     const dynamicImportRegex = /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
     while ((match = dynamicImportRegex.exec(content)) !== null) {
         imports.push(match[1]);
     }
-    // require: require('path')
     const requireRegex = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
     while ((match = requireRegex.exec(content)) !== null) {
         imports.push(match[1]);
     }
-    // Re-export: export * from 'path' or export { X } from 'path'
     const exportFromRegex = /export\s+.+?\s+from\s+['"]([^'"]+)['"]/g;
     while ((match = exportFromRegex.exec(content)) !== null) {
         imports.push(match[1]);