@hyperfrontend/project-scope 0.1.0 → 0.2.1

package/heuristics/framework/index.esm.js

@@ -12,7 +12,6 @@ import { existsSync, readFileSync, statSync, lstatSync, readdirSync } from 'node
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/map
  */
-// Capture references at module initialization time
 const _Map = globalThis.Map;
 const _Reflect$2 = globalThis.Reflect;
 /**
@@ -32,7 +31,6 @@ const createMap = (iterable) => _Reflect$2.construct(_Map, iterable ? [iterable]
  *
  * @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,
@@ -67,7 +65,6 @@ const defineProperties = _Object.defineProperties;
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
  */
-// Capture references at module initialization time
 const _Set = globalThis.Set;
 const _Reflect$1 = globalThis.Reflect;
 /**
@@ -117,7 +114,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.
@@ -168,12 +164,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
@@ -206,7 +200,6 @@ function createCache(options) {
             return [...insertionOrder];
         },
     };
-    // Register cache for global operations
     cacheRegistry.add(cache);
     return freeze(cache);
 }
@@ -219,7 +212,6 @@ function createCache(options) {
  *
  * @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.
@@ -234,7 +226,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.
@@ -317,7 +308,6 @@ _console.timeLog.bind(_console);
  *
  * @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.
@@ -364,7 +354,6 @@ const getType = (target) => {
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
  */
-// Capture references at module initialization time
 const _Error = globalThis.Error;
 const _Reflect = globalThis.Reflect;
 /**
@@ -385,7 +374,6 @@ const createError = (message, options) => _Reflect.construct(_Error, [message, o
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/math
  */
-// Capture references at module initialization time
 const _Math = globalThis.Math;
 /**
  * (Safe copy) Returns the smaller of zero or more numbers.
@@ -658,14 +646,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),
@@ -676,7 +661,6 @@ function createScopedLogger(namespace, options = {}) {
         setLogLevel: baseLogger.setLogLevel,
         getLogLevel: baseLogger.getLogLevel,
     });
-    // Register logger for global level management
     loggerRegistry.add(scopedLogger);
     return scopedLogger;
 }
@@ -956,7 +940,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];
@@ -1017,7 +1000,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' });
@@ -1053,13 +1035,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' });
@@ -1110,7 +1090,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' });
@@ -1145,7 +1124,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' });
@@ -1688,7 +1666,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']);
@@ -1964,7 +1941,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']);
@@ -2043,13 +2019,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' });
@@ -2142,23 +2116,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' });
@@ -2189,23 +2159,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' });
@@ -2236,18 +2202,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' });
@@ -2278,18 +2241,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' });
@@ -2418,7 +2378,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' });
@@ -2513,7 +2472,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']);
@@ -2782,7 +2740,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;
@@ -3125,7 +3083,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;
@@ -3148,19 +3105,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))) {
@@ -3169,7 +3123,6 @@ function typescriptDetector(projectPath, packageJson) {
             break;
         }
     }
-    // @types packages
     const typePackages = keys(deps).filter((d) => d.startsWith('@types/'));
     if (typePackages.length > 0) {
         confidence += 10;
@@ -3203,24 +3156,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' });
@@ -3244,7 +3193,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 {') ||
@@ -3263,14 +3211,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) {
@@ -3287,12 +3232,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 {
@@ -3343,8 +3286,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;
 }
 /**
@@ -3376,9 +3317,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) {
@@ -3429,7 +3368,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;
 }