@hyperfrontend/project-scope 0.2.1 → 0.2.2

package/cli/index.esm.js

@@ -1,445 +1,25 @@
+import { join as join$1, resolve, parse, dirname, basename } from 'node:path';
 import { parseArgs } from 'node:util';
-import { join as join$1, resolve, parse as parse$1, dirname, basename } from 'node:path';
+import { isArray } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.esm.js';
+import { stringify, parse as parse$1 } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/json/index.esm.js';
+import { freeze, entries, keys, defineProperties, values } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.esm.js';
+import { dateNow, createDate } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/date/index.esm.js';
 import { existsSync, readFileSync, statSync, lstatSync, readdirSync } from 'node:fs';
-
-/**
- * Safe copies of Console built-in methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/console
- */
-const _console = globalThis.console;
-/**
- * (Safe copy) Outputs a message to the console.
- */
-const log = _console.log.bind(_console);
-/**
- * (Safe copy) Outputs a warning message to the console.
- */
-const warn = _console.warn.bind(_console);
-/**
- * (Safe copy) Outputs an error message to the console.
- */
-const error = _console.error.bind(_console);
-/**
- * (Safe copy) Outputs an informational message to the console.
- */
-const info = _console.info.bind(_console);
-/**
- * (Safe copy) Outputs a debug message to the console.
- */
-const debug = _console.debug.bind(_console);
-/**
- * (Safe copy) Outputs a stack trace to the console.
- */
-_console.trace.bind(_console);
-/**
- * (Safe copy) Displays an interactive listing of the properties of a specified object.
- */
-_console.dir.bind(_console);
-/**
- * (Safe copy) Displays tabular data as a table.
- */
-_console.table.bind(_console);
-/**
- * (Safe copy) Writes an error message to the console if the assertion is false.
- */
-_console.assert.bind(_console);
-/**
- * (Safe copy) Clears the console.
- */
-_console.clear.bind(_console);
-/**
- * (Safe copy) Logs the number of times that this particular call to count() has been called.
- */
-_console.count.bind(_console);
-/**
- * (Safe copy) Resets the counter used with console.count().
- */
-_console.countReset.bind(_console);
-/**
- * (Safe copy) Creates a new inline group in the console.
- */
-_console.group.bind(_console);
-/**
- * (Safe copy) Creates a new inline group in the console that is initially collapsed.
- */
-_console.groupCollapsed.bind(_console);
-/**
- * (Safe copy) Exits the current inline group.
- */
-_console.groupEnd.bind(_console);
-/**
- * (Safe copy) Starts a timer with a name specified as an input parameter.
- */
-_console.time.bind(_console);
-/**
- * (Safe copy) Stops a timer that was previously started.
- */
-_console.timeEnd.bind(_console);
-/**
- * (Safe copy) Logs the current value of a timer that was previously started.
- */
-_console.timeLog.bind(_console);
-
-/**
- * Safe copies of Object built-in methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
- */
-const _Object = globalThis.Object;
-/**
- * (Safe copy) Prevents modification of existing property attributes and values,
- * and prevents the addition of new properties.
- */
-const freeze = _Object.freeze;
-/**
- * (Safe copy) Returns the names of the enumerable string properties and methods of an object.
- */
-const keys = _Object.keys;
-/**
- * (Safe copy) Returns an array of key/values of the enumerable own properties of an object.
- */
-const entries = _Object.entries;
-/**
- * (Safe copy) Returns an array of values of the enumerable own properties of an object.
- */
-const values = _Object.values;
-/**
- * (Safe copy) Adds one or more properties to an object, and/or modifies attributes of existing properties.
- */
-const defineProperties = _Object.defineProperties;
-
-const registeredClasses = [];
-
-/**
- * Safe copies of Array built-in static methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/array
- */
-const _Array = globalThis.Array;
-/**
- * (Safe copy) Determines whether the passed value is an Array.
- */
-const isArray = _Array.isArray;
-
-/**
- * Returns the data type of the target.
- * Uses native `typeof` operator, however, makes distinction between `null`, `array`, and `object`.
- * Also, when classes are registered via `registerClass`, it checks if objects are instance of any known registered class.
- *
- * @param target - The target to get the data type of.
- * @returns The data type of the target.
- */
-const getType = (target) => {
-    if (target === null)
-        return 'null';
-    const nativeDataType = typeof target;
-    if (nativeDataType === 'object') {
-        if (isArray(target))
-            return 'array';
-        for (const registeredClass of registeredClasses) {
-            if (target instanceof registeredClass)
-                return registeredClass.name;
-        }
-    }
-    return nativeDataType;
-};
-
-/**
- * Safe copies of Error built-ins via factory functions.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides factory functions that use Reflect.construct internally.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
- */
-const _Error = globalThis.Error;
-const _Reflect$3 = globalThis.Reflect;
-/**
- * (Safe copy) Creates a new Error using the captured Error constructor.
- * Use this instead of `new Error()`.
- *
- * @param message - Optional error message.
- * @param options - Optional error options.
- * @returns A new Error instance.
- */
-const createError = (message, options) => _Reflect$3.construct(_Error, [message, options]);
-
-/**
- * Safe copies of Map built-in via factory function.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides a factory function that uses Reflect.construct internally.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/map
- */
-const _Map = globalThis.Map;
-const _Reflect$2 = globalThis.Reflect;
-/**
- * (Safe copy) Creates a new Map using the captured Map constructor.
- * Use this instead of `new Map()`.
- *
- * @param iterable - Optional iterable of key-value pairs.
- * @returns A new Map instance.
- */
-const createMap = (iterable) => _Reflect$2.construct(_Map, iterable ? [iterable] : []);
-
-/**
- * Safe copies of Date built-in via factory function and static methods.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides a factory function that uses Reflect.construct internally.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/date
- */
-const _Date = globalThis.Date;
-const _Reflect$1 = globalThis.Reflect;
-function createDate(...args) {
-    return _Reflect$1.construct(_Date, args);
-}
-/**
- * (Safe copy) Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
- */
-const dateNow = _Date.now;
-
-/**
- * Safe copies of Math built-in methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/math
- */
-const _Math = globalThis.Math;
-/**
- * (Safe copy) Returns the value of a number rounded to the nearest integer.
- */
-const round = _Math.round;
-/**
- * (Safe copy) Returns the smaller of zero or more numbers.
- */
-const min = _Math.min;
-
-/**
- * Safe copies of Set built-in via factory function.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides a factory function that uses Reflect.construct internally.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
- */
-const _Set = globalThis.Set;
-const _Reflect = globalThis.Reflect;
-/**
- * (Safe copy) Creates a new Set using the captured Set constructor.
- * Use this instead of `new Set()`.
- *
- * @param iterable - Optional iterable of values.
- * @returns A new Set instance.
- */
-const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
-
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/**
- * Creates a wrapper function that only executes the wrapped function if the condition function returns true.
- *
- * @param func - The function to be conditionally executed.
- * @param conditionFunc - A function that returns a boolean, determining if `func` should be executed.
- * @returns A wrapped version of `func` that executes conditionally.
- */
-function createConditionalExecutionFunction(func, conditionFunc) {
-    return function (...args) {
-        if (conditionFunc()) {
-            return func(...args);
-        }
-    };
-}
-
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/**
- * Creates a wrapper function that silently ignores any errors thrown by the wrapped void function.
- * This function is specifically for wrapping functions that do not return a value (void functions).
- * Exceptions are swallowed without any logging or handling.
- *
- * @param func - The void function to be wrapped.
- * @returns A wrapped version of the input function that ignores errors.
- */
-function createErrorIgnoringFunction(func) {
-    return function (...args) {
-        try {
-            func(...args);
-        }
-        catch {
-            // Deliberately swallowing/ignoring the exception
-        }
-    };
-}
-
-/* eslint-disable @typescript-eslint/no-unused-vars */
-/**
- * A no-operation function (noop) that does nothing regardless of the arguments passed.
- * It is designed to be as permissive as possible in its typing without using the `Function` keyword.
- *
- * @param args - Any arguments passed to the function (ignored)
- */
-const noop = (...args) => {
-    // Intentionally does nothing
-};
-
-const logLevels = ['none', 'error', 'warn', 'log', 'info', 'debug'];
-const priority = {
-    error: 4,
-    warn: 3,
-    log: 2,
-    info: 1,
-    debug: 0,
-};
-/**
- * Validates whether a given string is a valid log level.
- *
- * @param level - The log level to validate
- * @returns True if the level is valid, false otherwise
- */
-function isValidLogLevel(level) {
-    return logLevels.includes(level);
-}
-/**
- * Creates a log level configuration manager for controlling logging behavior.
- * Provides methods to get, set, and evaluate log levels based on priority.
- *
- * @param level - The initial log level (defaults to 'error')
- * @returns A configuration object with log level management methods
- * @throws {Error} When the provided level is not a valid log level
- */
-function createLogLevelConfig(level = 'error') {
-    if (!isValidLogLevel(level)) {
-        throw createError('Cannot create log level configuration with a valid default log level');
-    }
-    const state = { level };
-    const getLogLevel = () => state.level;
-    const setLogLevel = (level) => {
-        if (!isValidLogLevel(level)) {
-            throw createError(`Cannot set value '${level}' level. Expected levels are ${logLevels}.`);
-        }
-        state.level = level;
-    };
-    const shouldLog = (level) => {
-        if (state.level === 'none' || level === 'none' || !isValidLogLevel(level)) {
-            return false;
-        }
-        return priority[level] >= priority[state.level];
-    };
-    return freeze({
-        getLogLevel,
-        setLogLevel,
-        shouldLog,
-    });
-}
-
-/**
- * Creates a logger instance with configurable log level filtering.
- * Each log function is wrapped to respect the current log level setting.
- *
- * @param error - Function to handle error-level logs (required)
- * @param warn - Function to handle warning-level logs (optional, defaults to noop)
- * @param log - Function to handle standard logs (optional, defaults to noop)
- * @param info - Function to handle info-level logs (optional, defaults to noop)
- * @param debug - Function to handle debug-level logs (optional, defaults to noop)
- * @returns A frozen logger object with log methods and level control
- * @throws {ErrorLevelFn} When any provided log function is invalid
- */
-function createLogger(error, warn = noop, log = noop, info = noop, debug = noop) {
-    if (notValidLogFn(error)) {
-        throw createError(notFnMsg('error'));
-    }
-    if (notValidLogFn(warn)) {
-        throw createError(notFnMsg('warn'));
-    }
-    if (notValidLogFn(log)) {
-        throw createError(notFnMsg('log'));
-    }
-    if (notValidLogFn(info)) {
-        throw createError(notFnMsg('info'));
-    }
-    if (notValidLogFn(debug)) {
-        throw createError(notFnMsg('debug'));
-    }
-    const { setLogLevel, getLogLevel, shouldLog } = createLogLevelConfig();
-    const wrapLogFn = (fn, level) => {
-        if (fn === noop)
-            return fn;
-        const condition = () => shouldLog(level);
-        return createConditionalExecutionFunction(createErrorIgnoringFunction(fn), condition);
-    };
-    return freeze({
-        error: wrapLogFn(error, 'error'),
-        warn: wrapLogFn(warn, 'warn'),
-        log: wrapLogFn(log, 'log'),
-        info: wrapLogFn(info, 'info'),
-        debug: wrapLogFn(debug, 'debug'),
-        setLogLevel,
-        getLogLevel,
-    });
-}
-/**
- * Validates whether a given value is a valid log function.
- *
- * @param fn - The value to validate
- * @returns True if the value is not a function (invalid), false if it is valid
- */
-function notValidLogFn(fn) {
-    return getType(fn) !== 'function' && fn !== noop;
-}
-/**
- * Generates an error message for invalid log function parameters.
- *
- * @param label - The name of the log function that failed validation
- * @returns A formatted error message string
- */
-function notFnMsg(label) {
-    return `Cannot create a logger when ${label} is not a function`;
-}
-
-createLogger(error, warn, log, info, debug);
-
-/**
- * Safe copies of JSON built-in methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/json
- */
-const _JSON = globalThis.JSON;
-/**
- * (Safe copy) Converts a JavaScript Object Notation (JSON) string into an object.
- */
-const parse = _JSON.parse;
-/**
- * (Safe copy) Converts a JavaScript value to a JavaScript Object Notation (JSON) string.
- */
-const stringify = _JSON.stringify;
+import { error, warn, log, info, debug } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/console/index.esm.js';
+import { createSet } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.esm.js';
+import { createLogger } from '../_dependencies/@hyperfrontend/logging/index.esm.js';
+import { createError } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.esm.js';
+import { createMap } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/map/index.esm.js';
+import { min, round } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/math/index.esm.js';
+import { parseInt, parseFloat } from '../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/number/index.esm.js';
+import { getFileStat, isDirectory, exists } from '../_shared/core/fs/stat/index.esm.js';
+import { join } from '../_shared/core/path/join/index.esm.js';
+import { createConfigError } from '../_shared/core/errors/structured-errors/index.esm.js';
+import { createCache } from '../_shared/core/cache/index.esm.js';
+import { matchGlobPattern } from '../_shared/core/patterns/glob/index.esm.js';
+import { collectAllDependencies, parseVersionString, locateConfigFile, filterScriptsByCommand } from '../_shared/tech/shared-utils/detector-helpers/index.esm.js';
+import { pnpmWorkspacesDetector } from '../_shared/tech/monorepo/pnpm-workspaces/index.esm.js';
+import { CONFIG_PATTERNS } from '../_shared/project/config/patterns/index.esm.js';
 
 /**
  * Global log level registry.
@@ -457,7 +37,7 @@ let globalLogLevel = null;
  *
  * @param level - The log level to set globally
  *
- * @example
+ * @example Enabling debug logging globally
  * ```typescript
  * import { setGlobalLogLevel } from '@hyperfrontend/project-scope/core'
  *
@@ -504,6 +84,13 @@ function isSensitiveKey(key) {
  *
  * @param obj - Object to sanitize
  * @returns New object with sensitive values redacted
+ *
+ * @example Sanitizing sensitive data
+ * ```typescript
+ * const config = { apiKey: 'secret123', endpoint: 'https://api.example.com' }
+ * const safe = sanitize(config)
+ * // => { apiKey: '[REDACTED]', endpoint: 'https://api.example.com' }
+ * ```
  */
 function sanitize(obj) {
     if (obj === null || obj === undefined) {
@@ -554,7 +141,7 @@ function formatMessage(namespace, message, meta) {
  * @param options - Logger configuration options
  * @returns A configured scoped logger instance
  *
- * @example
+ * @example Creating a scoped logger
  * ```typescript
  * const logger = createScopedLogger('project-scope')
  * logger.setLogLevel('debug')
@@ -591,7 +178,7 @@ function createScopedLogger(namespace, options = {}) {
  * Default logger instance for the project-scope library.
  * Use this for general logging within the library.
  *
- * @example
+ * @example Using the default logger
  * ```typescript
  * import { logger } from '@hyperfrontend/project-scope/core'
  *
@@ -609,6 +196,15 @@ const fsLogger = createScopedLogger('project-scope:fs');
  * @param code - The category code for this type of filesystem failure
  * @param context - Additional context including path, operation, and cause
  * @returns A configured Error object with code and context properties
+ *
+ * @example Creating a file system error
+ * ```typescript
+ * throw createFileSystemError(
+ *   'Cannot read file',
+ *   'FS_READ_ERROR',
+ *   { path: './missing.txt', operation: 'read' }
+ * )
+ * ```
  */
 function createFileSystemError(message, code, context) {
     const error = createError(message);
@@ -626,7 +222,7 @@ function createFileSystemError(message, code, context) {
  * @returns File contents as string
  * @throws {Error} If file doesn't exist or can't be read
  *
- * @example
+ * @example Reading file contents
  * ```typescript
  * import { readFileContent } from '@hyperfrontend/project-scope'
  *
@@ -653,6 +249,14 @@ function readFileContent(filePath, encoding = 'utf-8') {
  * @param filePath - Path to file
  * @param encoding - File encoding (default: utf-8)
  * @returns File contents or null if file doesn't exist
+ *
+ * @example Reading file if it exists
+ * ```typescript
+ * const content = readFileIfExists('./optional-config.json')
+ * if (content) {
+ *   // File existed, use content
+ * }
+ * ```
  */
 function readFileIfExists(filePath, encoding = 'utf-8') {
     if (!existsSync(filePath)) {
@@ -666,56 +270,6 @@ function readFileIfExists(filePath, encoding = 'utf-8') {
     }
 }
 
-createScopedLogger('project-scope:fs:write');
-
-/**
- * Get file stats with error handling.
- *
- * @param filePath - Path to file
- * @param followSymlinks - Whether to follow symlinks (default: true)
- * @returns File stats or null if path doesn't exist
- */
-function getFileStat(filePath, followSymlinks = true) {
-    if (!existsSync(filePath)) {
-        return null;
-    }
-    try {
-        const stat = followSymlinks ? statSync(filePath) : lstatSync(filePath);
-        return {
-            isFile: stat.isFile(),
-            isDirectory: stat.isDirectory(),
-            isSymlink: stat.isSymbolicLink(),
-            size: stat.size,
-            created: stat.birthtime,
-            modified: stat.mtime,
-            accessed: stat.atime,
-            mode: stat.mode,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Check if path is a directory.
- *
- * @param dirPath - Path to check
- * @returns True if path is a directory
- */
-function isDirectory(dirPath) {
-    const stats = getFileStat(dirPath);
-    return stats?.isDirectory ?? false;
-}
-/**
- * Check if path exists.
- *
- * @param filePath - Path to check
- * @returns True if path exists
- */
-function exists(filePath) {
-    return existsSync(filePath);
-}
-
 const fsDirLogger = createScopedLogger('project-scope:fs:dir');
 /**
  * List immediate contents of a directory.
@@ -724,7 +278,7 @@ const fsDirLogger = createScopedLogger('project-scope:fs:dir');
  * @returns Array of entries with metadata for each file/directory
  * @throws {Error} If directory doesn't exist or isn't a directory
  *
- * @example
+ * @example Listing directory contents
  * ```typescript
  * import { readDirectory } from '@hyperfrontend/project-scope'
  *
@@ -765,17 +319,6 @@ function readDirectory(dirPath) {
     }
 }
 
-/**
- * Join path segments.
- * Uses platform-specific separators (e.g., / or \).
- *
- * @param paths - Path segments to join
- * @returns Joined path
- */
-function join(...paths) {
-    return join$1(...paths);
-}
-
 const fsTraversalLogger = createScopedLogger('project-scope:fs:traversal');
 /**
  * Generic upward directory traversal.
@@ -784,11 +327,20 @@ const fsTraversalLogger = createScopedLogger('project-scope:fs:traversal');
  * @param startPath - Starting directory
  * @param predicate - Function to test each directory
  * @returns First matching directory or null
+ *
+ * @example Finding directory containing README
+ * ```typescript
+ * // Find first directory containing a README
+ * const readmeDir = traverseUpward('./src/utils', (dir) =>
+ *   existsSync(join(dir, 'README.md'))
+ * )
+ * // => '/project' or null
+ * ```
  */
 function traverseUpward(startPath, predicate) {
     fsTraversalLogger.debug('Starting upward traversal', { startPath });
     let currentPath = resolve(startPath);
-    const rootPath = parse$1(currentPath).root;
+    const rootPath = parse(currentPath).root;
     while (currentPath !== rootPath) {
         if (predicate(currentPath)) {
             fsTraversalLogger.debug('Upward traversal found match', { startPath, foundPath: currentPath });
@@ -809,6 +361,17 @@ function traverseUpward(startPath, predicate) {
  * @param startPath - Starting directory
  * @param markers - Array of marker file names to search for
  * @returns First directory containing any marker, or null
+ *
+ * @example Finding project root by marker files
+ * ```typescript
+ * // Find project root by looking for common marker files
+ * const projectRoot = locateByMarkers('./src/components', [
+ *   'package.json',
+ *   'nx.json',
+ *   'tsconfig.base.json'
+ * ])
+ * // => '/workspace/my-project'
+ * ```
  */
 function locateByMarkers(startPath, markers) {
     fsTraversalLogger.debug('Locating by markers', { startPath, markers });
@@ -819,42 +382,7 @@ function locateByMarkers(startPath, markers) {
     return result;
 }
 
-/**
- * Create a structured error with code and optional context.
- *
- * @param message - The human-readable error message
- * @param code - The machine-readable error code for programmatic handling
- * @param context - Additional contextual information about the error
- * @returns Structured error instance with code and context properties
- *
- * @example
- * ```typescript
- * import { createStructuredError } from '@hyperfrontend/project-scope'
- *
- * throw createStructuredError(
- *   'Configuration file not found',
- *   'CONFIG_NOT_FOUND',
- *   { path: './config.json', searched: ['./config.json', './settings.json'] }
- * )
- * ```
- */
-function createStructuredError(message, code, context) {
-    const error = createError(message);
-    error.code = code;
-    error.context = context ?? {};
-    return error;
-}
-/**
- * Create a configuration-related error.
- *
- * @param message - The human-readable error message
- * @param code - The machine-readable error code for programmatic handling
- * @param context - Additional contextual information (e.g., file path, config key)
- * @returns Structured error instance tagged with type 'config'
- */
-function createConfigError(message, code, context) {
-    return createStructuredError(message, code, { ...context, type: 'config' });
-}
+createScopedLogger('project-scope:fs:write');
 
 const packageLogger = createScopedLogger('project-scope:project:package');
 /**
@@ -926,13 +454,21 @@ function validatePackageJson(data) {
  * @param projectPath - Project directory path or path to package.json
  * @returns Parsed package.json
  * @throws {Error} Error if file doesn't exist or is invalid
+ *
+ * @example Reading package.json
+ * ```typescript
+ * import { readPackageJson } from '@hyperfrontend/project-scope'
+ *
+ * const pkg = readPackageJson('/path/to/project')
+ * console.log(pkg.name, pkg.version)
+ * ```
  */
 function readPackageJson(projectPath) {
     const packageJsonPath = projectPath.endsWith('package.json') ? projectPath : join$1(projectPath, 'package.json');
     packageLogger.debug('Reading package.json', { path: packageJsonPath });
     const content = readFileContent(packageJsonPath);
     try {
-        const data = parse(content);
+        const data = parse$1(content);
         const validated = validatePackageJson(data);
         packageLogger.debug('Package.json read successfully', { path: packageJsonPath, name: validated.name });
         return validated;
@@ -954,6 +490,16 @@ function readPackageJson(projectPath) {
  *
  * @param projectPath - Project directory path or path to package.json
  * @returns Parsed package.json or null if not found
+ *
+ * @example Reading package.json if it exists
+ * ```typescript
+ * import { readPackageJsonIfExists } from '@hyperfrontend/project-scope'
+ *
+ * const pkg = readPackageJsonIfExists('/path/to/project')
+ * if (pkg) {
+ *   console.log('Found:', pkg.name)
+ * }
+ * ```
  */
 function readPackageJsonIfExists(projectPath) {
     const packageJsonPath = projectPath.endsWith('package.json') ? projectPath : join$1(projectPath, 'package.json');
@@ -963,7 +509,7 @@ function readPackageJsonIfExists(projectPath) {
         return null;
     }
     try {
-        const validated = validatePackageJson(parse(content));
+        const validated = validatePackageJson(parse$1(content));
         packageLogger.debug('Package.json loaded', { path: packageJsonPath, name: validated.name });
         return validated;
     }
@@ -978,6 +524,15 @@ function readPackageJsonIfExists(projectPath) {
  *
  * @param packageJson - Parsed package.json
  * @returns All dependencies categorized
+ *
+ * @example Extracting all dependencies
+ * ```typescript
+ * import { getDependencies } from '@hyperfrontend/project-scope'
+ *
+ * const deps = getDependencies(packageJson)
+ * console.log('Runtime:', Object.keys(deps.dependencies))
+ * console.log('Dev:', Object.keys(deps.devDependencies))
+ * ```
  */
 function getDependencies(packageJson) {
     return {
@@ -994,6 +549,16 @@ createScopedLogger('project-scope:heuristics:deps');
  *
  * @param projectPath - Project directory
  * @returns Dependencies grouped by runtime, dev, peer, and optional
+ *
+ * @example Getting project dependencies
+ * ```typescript
+ * import { getProjectDependencies } from '@hyperfrontend/project-scope'
+ *
+ * const deps = getProjectDependencies('/path/to/project')
+ * console.log('Runtime:', deps.runtime)     // ['express', 'lodash']
+ * console.log('Dev:', deps.development)     // ['jest', 'typescript']
+ * console.log('Total:', deps.total)         // 15
+ * ```
  */
 function getProjectDependencies(projectPath) {
     const packageJson = readPackageJsonIfExists(projectPath);
@@ -1020,326 +585,6 @@ function getProjectDependencies(projectPath) {
     };
 }
 
-/**
- * Global registry of all caches for bulk operations.
- */
-const cacheRegistry = createSet();
-/**
- * Create a cache with optional TTL and size limits.
- *
- * The cache provides a simple key-value store with:
- * - Optional TTL (time-to-live) for automatic expiration
- * - Optional maxSize for limiting cache size with FIFO eviction
- * - Lazy expiration (entries are checked on access)
- *
- * @param options - Cache configuration options
- * @returns Cache instance
- *
- * @example
- * ```typescript
- * // Basic cache
- * const cache = createCache<string, number>()
- * cache.set('answer', 42)
- * cache.get('answer') // 42
- *
- * // Cache with TTL (expires after 60 seconds)
- * const ttlCache = createCache<string, object>({ ttl: 60000 })
- *
- * // Cache with max size (evicts oldest when full)
- * const lruCache = createCache<string, object>({ maxSize: 100 })
- *
- * // Combined options
- * const configCache = createCache<string, object>({
- *   ttl: 30000,
- *   maxSize: 50
- * })
- * ```
- */
-function createCache(options) {
-    const { ttl, maxSize } = options ?? {};
-    const store = createMap();
-    const insertionOrder = [];
-    /**
-     * Check if an entry is expired.
-     *
-     * @param entry - Cache entry to check
-     * @returns True if entry is expired
-     */
-    function isExpired(entry) {
-        if (ttl === undefined)
-            return false;
-        // eslint-disable-next-line workspace/no-unsafe-builtin-methods -- Date.now() is needed for Jest fake timers compatibility
-        return Date.now() - entry.timestamp > ttl;
-    }
-    /**
-     * Evict oldest entries to make room for new ones.
-     */
-    function evictIfNeeded() {
-        if (maxSize === undefined)
-            return;
-        while (store.size >= maxSize && insertionOrder.length > 0) {
-            const oldestKey = insertionOrder.shift();
-            if (oldestKey !== undefined) {
-                store.delete(oldestKey);
-            }
-        }
-    }
-    /**
-     * Remove key from insertion order tracking.
-     *
-     * @param key - Key to remove from order tracking
-     */
-    function removeFromOrder(key) {
-        const index = insertionOrder.indexOf(key);
-        if (index !== -1) {
-            insertionOrder.splice(index, 1);
-        }
-    }
-    const cache = {
-        get(key) {
-            const entry = store.get(key);
-            if (!entry)
-                return undefined;
-            if (isExpired(entry)) {
-                store.delete(key);
-                removeFromOrder(key);
-                return undefined;
-            }
-            return entry.value;
-        },
-        set(key, value) {
-            if (store.has(key)) {
-                removeFromOrder(key);
-            }
-            else {
-                evictIfNeeded();
-            }
-            // eslint-disable-next-line workspace/no-unsafe-builtin-methods -- Date.now() is needed for Jest fake timers compatibility
-            store.set(key, { value, timestamp: Date.now() });
-            insertionOrder.push(key);
-        },
-        has(key) {
-            const entry = store.get(key);
-            if (!entry)
-                return false;
-            if (isExpired(entry)) {
-                store.delete(key);
-                removeFromOrder(key);
-                return false;
-            }
-            return true;
-        },
-        delete(key) {
-            removeFromOrder(key);
-            return store.delete(key);
-        },
-        clear() {
-            store.clear();
-            insertionOrder.length = 0;
-        },
-        size() {
-            return store.size;
-        },
-        keys() {
-            return [...insertionOrder];
-        },
-    };
-    cacheRegistry.add(cache);
-    return freeze(cache);
-}
-
-/**
- * Match path against glob pattern using safe character iteration.
- * Avoids regex to prevent ReDoS attacks.
- *
- * Supported patterns:
- * - * matches any characters except /
- * - ** matches any characters including /
- * - ? matches exactly one character except /
- * - {a,b,c} matches any of the alternatives
- *
- * @param path - The filesystem path to test against the pattern
- * @param pattern - The glob pattern to match against
- * @returns True if path matches pattern
- *
- * @example
- * ```typescript
- * import { matchGlobPattern } from '@hyperfrontend/project-scope'
- *
- * matchGlobPattern('src/utils/helper.ts', '\*\*\/*.ts')     // true
- * matchGlobPattern('test.spec.ts', '\*.spec.ts')          // true
- * matchGlobPattern('config.json', '\*.{json,yaml}')       // true
- * matchGlobPattern('src/index.ts', 'src/\*.ts')           // true
- * ```
- */
-function matchGlobPattern(path, pattern) {
-    return matchSegments(path.split('/'), pattern.split('/'), 0, 0);
-}
-/**
- * Internal recursive function to match path segments against pattern segments.
- *
- * @param pathParts - Array of path segments split by '/'
- * @param patternParts - Array of pattern segments split by '/'
- * @param pathIdx - Current index in pathParts being examined
- * @param patternIdx - Current index in patternParts being examined
- * @returns True if remaining segments match
- */
-function matchSegments(pathParts, patternParts, pathIdx, patternIdx) {
-    if (pathIdx === pathParts.length && patternIdx === patternParts.length) {
-        return true;
-    }
-    if (patternIdx >= patternParts.length) {
-        return false;
-    }
-    const patternPart = patternParts[patternIdx];
-    if (patternPart === '**') {
-        for (let i = pathIdx; i <= pathParts.length; i++) {
-            if (matchSegments(pathParts, patternParts, i, patternIdx + 1)) {
-                return true;
-            }
-        }
-        return false;
-    }
-    if (pathIdx >= pathParts.length) {
-        return false;
-    }
-    const pathPart = pathParts[pathIdx];
-    if (matchSegment(pathPart, patternPart)) {
-        return matchSegments(pathParts, patternParts, pathIdx + 1, patternIdx + 1);
-    }
-    return false;
-}
-/**
- * Match a single path segment against a pattern segment.
- * Handles *, ?, and {a,b,c} patterns.
- *
- * @param text - The path segment text to match
- * @param pattern - The pattern segment to match against
- * @returns True if the text matches the pattern
- */
-function matchSegment(text, pattern) {
-    let textIdx = 0;
-    let patternIdx = 0;
-    while (patternIdx < pattern.length) {
-        const char = pattern[patternIdx];
-        if (char === '*') {
-            patternIdx++;
-            if (patternIdx === pattern.length) {
-                return true;
-            }
-            for (let i = textIdx; i <= text.length; i++) {
-                if (matchSegmentFrom(text, i, pattern, patternIdx)) {
-                    return true;
-                }
-            }
-            return false;
-        }
-        else if (char === '?') {
-            if (textIdx >= text.length) {
-                return false;
-            }
-            textIdx++;
-            patternIdx++;
-        }
-        else if (char === '{') {
-            const closeIdx = findClosingBrace(pattern, patternIdx);
-            if (closeIdx === -1) {
-                if (textIdx >= text.length || text[textIdx] !== char) {
-                    return false;
-                }
-                textIdx++;
-                patternIdx++;
-            }
-            else {
-                const alternatives = extractAlternatives(pattern.slice(patternIdx + 1, closeIdx));
-                for (const alt of alternatives) {
-                    if (matchSegmentFrom(text, textIdx, text.slice(0, textIdx) + alt + pattern.slice(closeIdx + 1), textIdx)) {
-                        return true;
-                    }
-                }
-                return false;
-            }
-        }
-        else {
-            if (textIdx >= text.length || text[textIdx] !== char) {
-                return false;
-            }
-            textIdx++;
-            patternIdx++;
-        }
-    }
-    return textIdx === text.length;
-}
-/**
- * Helper to match from a specific position.
- *
- * @param text - The full text being matched
- * @param textIdx - The starting index in text to match from
- * @param pattern - The full pattern being matched
- * @param patternIdx - The starting index in pattern to match from
- * @returns True if the text matches the pattern from the given positions
- */
-function matchSegmentFrom(text, textIdx, pattern, patternIdx) {
-    const remainingText = text.slice(textIdx);
-    const remainingPattern = pattern.slice(patternIdx);
-    return matchSegment(remainingText, remainingPattern);
-}
-/**
- * Find closing brace for {a,b,c} pattern.
- *
- * @param pattern - The pattern string to search within
- * @param startIdx - The index of the opening brace
- * @returns The index of the matching closing brace, or -1 if not found
- */
-function findClosingBrace(pattern, startIdx) {
-    let depth = 0;
-    for (let i = startIdx; i < pattern.length; i++) {
-        if (pattern[i] === '{') {
-            depth++;
-        }
-        else if (pattern[i] === '}') {
-            depth--;
-            if (depth === 0) {
-                return i;
-            }
-        }
-    }
-    return -1;
-}
-/**
- * Extract alternatives from {a,b,c} pattern content.
- *
- * @param content - The content between braces (without the braces themselves)
- * @returns Array of alternative strings split by commas at depth 0
- */
-function extractAlternatives(content) {
-    const alternatives = [];
-    let current = '';
-    let depth = 0;
-    for (let i = 0; i < content.length; i++) {
-        const char = content[i];
-        if (char === '{') {
-            depth++;
-            current += char;
-        }
-        else if (char === '}') {
-            depth--;
-            current += char;
-        }
-        else if (char === ',' && depth === 0) {
-            alternatives.push(current);
-            current = '';
-        }
-        else {
-            current += char;
-        }
-    }
-    if (current) {
-        alternatives.push(current);
-    }
-    return alternatives;
-}
-
 const walkLogger = createScopedLogger('project-scope:project:walk');
 /**
  * Reads .gitignore file from the given directory and extracts
@@ -1405,6 +650,18 @@ function matchPattern(path, pattern) {
  * @param startPath - Root directory to begin traversal
  * @param visitor - Callback function invoked for each file system entry
  * @param options - Configuration for traversal behavior
+ *
+ * @example Walking a directory tree
+ * ```typescript
+ * import { walkDirectory } from '@hyperfrontend/project-scope'
+ *
+ * const tsFiles: string[] = []
+ * walkDirectory('./src', (entry) => {
+ *   if (entry.isFile && entry.name.endsWith('.ts')) {
+ *     tsFiles.push(entry.relativePath)
+ *   }
+ * }, { maxDepth: 5, respectGitignore: true })
+ * ```
  */
 function walkDirectory(startPath, visitor, options) {
     walkLogger.debug('Starting directory walk', {
@@ -1501,7 +758,7 @@ function matchesPatterns(path, patterns) {
  * @param options - Configuration for search behavior
  * @returns List of relative file paths that match the patterns
  *
- * @example
+ * @example Finding files by pattern
  * ```typescript
  * import { findFiles } from '@hyperfrontend/project-scope'
  *
@@ -1615,7 +872,7 @@ function discoverFromExports(exports$1, entryPoints) {
  * @param options - Discovery options
  * @returns Array of discovered entry points sorted by confidence
  *
- * @example
+ * @example Discovering project entry points
  * ```typescript
  * import { discoverEntryPoints } from '@hyperfrontend/project-scope'
  *
@@ -1782,80 +1039,32 @@ function discoverEntryPoints(projectPath, options) {
     return result;
 }
 
-/**
- * Get combined dependencies from package.json.
- * Merges dependencies, devDependencies, peerDependencies, and optionalDependencies.
- *
- * @param packageJson - The package.json object to extract dependencies from
- * @returns Combined dependencies as a single record
- */
-function collectAllDependencies(packageJson) {
-    return {
-        ...packageJson?.dependencies,
-        ...packageJson?.devDependencies,
-        ...packageJson?.peerDependencies,
-        ...packageJson?.optionalDependencies,
-    };
-}
-/**
- * Extract clean version from dependency version string.
- * Removes semver prefixes like ^, ~, >=, etc.
- * Uses character-by-character parsing to avoid ReDoS vulnerabilities.
- *
- * @param versionString - The version string with optional prefix characters
- * @returns The cleaned version string without prefix characters
- */
-function parseVersionString(versionString) {
-    if (versionString === undefined || versionString === null)
-        return undefined;
-    let start = 0;
-    while (start < versionString.length) {
-        const char = versionString[start];
-        if (char !== '^' && char !== '~' && char !== '>' && char !== '=' && char !== '<') {
-            break;
-        }
-        start++;
-    }
-    return versionString.slice(start);
-}
-/**
- * Find first matching config file in project.
- * Note: Name avoids similarity to fs.readFile/fs.readFileSync.
- *
- * @param projectPath - The project directory path
- * @param patterns - Array of config file patterns to search for
- * @returns The first matching config file path or undefined
- */
-function locateConfigFile(projectPath, patterns) {
-    for (const pattern of patterns) {
-        const fullPath = join(projectPath, pattern);
-        if (exists(fullPath)) {
-            return pattern;
-        }
-    }
-    return undefined;
-}
-/**
- * Find scripts containing a specific command.
- *
- * @param scripts - The scripts object from package.json
- * @param command - The command string to search for
- * @returns Array of script names that contain the command
- */
-function filterScriptsByCommand(scripts, command) {
-    if (!scripts)
-        return [];
-    return entries(scripts)
-        .filter(([, script]) => script.includes(command))
-        .map(([name]) => name);
-}
-
 /**
  * Detect Express in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ * @example Detecting Express framework
+ * ```typescript
+ * const pkg = {
+ *   dependencies: { express: '^4.18.2', cors: '^2.8.5' },
+ *   devDependencies: { '@types/express': '^4.17.17' },
+ * }
+ *
+ * const result = expressDetector('/path/to/project', pkg)
+ * // => {
+ * //   id: 'express',
+ * //   name: 'Express',
+ * //   version: '4.18.2',
+ * //   confidence: 100,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.express' },
+ * //     { type: 'package.json', field: 'dependencies.@types/express' },
+ * //     { type: 'package.json', field: 'dependencies (express middleware)' },
+ * //   ],
+ * // }
+ * ```
  */
 function expressDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -1890,84 +1099,109 @@ function expressDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect NestJS in project.
+ * Detect Fastify in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ * @example Detecting Fastify framework
+ * ```typescript
+ * const pkg = {
+ *   dependencies: { fastify: '^4.24.0', '@fastify/cors': '^8.4.0' },
+ * }
+ *
+ * const result = fastifyDetector('/path/to/project', pkg)
+ * // => {
+ * //   id: 'fastify',
+ * //   name: 'Fastify',
+ * //   version: '4.24.0',
+ * //   confidence: 95,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.fastify' },
+ * //     { type: 'package.json', field: 'dependencies (fastify plugins)' },
+ * //   ],
+ * // }
+ * ```
  */
-function nestDetector(projectPath, packageJson) {
+function fastifyDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
-    let configPath;
     const deps = collectAllDependencies(pkg);
-    if (deps['@nestjs/core']) {
-        confidence += 70;
-        version = parseVersionString(deps['@nestjs/core']);
-        sources.push({ type: 'package.json', field: 'dependencies.@nestjs/core' });
-    }
-    if (deps['@nestjs/common']) {
-        confidence += 15;
-        sources.push({ type: 'package.json', field: 'dependencies.@nestjs/common' });
+    if (deps['fastify']) {
+        confidence += 80;
+        version = parseVersionString(deps['fastify']);
+        sources.push({ type: 'package.json', field: 'dependencies.fastify' });
     }
-    if (exists(join$1(projectPath, 'nest-cli.json'))) {
+    const fastifyPlugins = keys(deps).filter((d) => d.startsWith('@fastify/') || d.startsWith('fastify-'));
+    if (fastifyPlugins.length > 0) {
         confidence += 15;
-        configPath = 'nest-cli.json';
-        sources.push({ type: 'config-file', path: 'nest-cli.json' });
+        sources.push({ type: 'package.json', field: 'dependencies (fastify plugins)' });
     }
-    const nestPackages = keys(deps).filter((d) => d.startsWith('@nestjs/'));
-    if (nestPackages.length > 2) {
+    if (deps['@types/fastify']) {
         confidence += 5;
-        sources.push({ type: 'package.json', field: 'dependencies (@nestjs packages)' });
+        sources.push({ type: 'package.json', field: 'dependencies.@types/fastify' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'nestjs',
-        name: 'NestJS',
+        id: 'fastify',
+        name: 'Fastify',
         version,
-        configPath,
         confidence: min(confidence, 100),
         detectedFrom: sources,
     };
 }
 
 /**
- * Detect Fastify in project.
+ * Detect Hono in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ * @example Detecting Hono framework
+ * ```typescript
+ * const pkg = {
+ *   dependencies: { hono: '^3.11.0', '@hono/node-server': '^1.3.0' },
+ * }
+ *
+ * const result = honoDetector('/path/to/project', pkg)
+ * // => {
+ * //   id: 'hono',
+ * //   name: 'Hono',
+ * //   version: '3.11.0',
+ * //   confidence: 100,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.hono' },
+ * //     { type: 'package.json', field: 'dependencies (@hono adapters)' },
+ * //   ],
+ * // }
+ * ```
  */
-function fastifyDetector(projectPath, packageJson) {
+function honoDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['fastify']) {
-        confidence += 80;
-        version = parseVersionString(deps['fastify']);
-        sources.push({ type: 'package.json', field: 'dependencies.fastify' });
+    if (deps['hono']) {
+        confidence += 85;
+        version = parseVersionString(deps['hono']);
+        sources.push({ type: 'package.json', field: 'dependencies.hono' });
     }
-    const fastifyPlugins = keys(deps).filter((d) => d.startsWith('@fastify/') || d.startsWith('fastify-'));
-    if (fastifyPlugins.length > 0) {
+    const honoAdapters = keys(deps).filter((d) => d.startsWith('@hono/'));
+    if (honoAdapters.length > 0) {
         confidence += 15;
-        sources.push({ type: 'package.json', field: 'dependencies (fastify plugins)' });
-    }
-    if (deps['@types/fastify']) {
-        confidence += 5;
-        sources.push({ type: 'package.json', field: 'dependencies.@types/fastify' });
+        sources.push({ type: 'package.json', field: 'dependencies (@hono adapters)' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'fastify',
-        name: 'Fastify',
+        id: 'hono',
+        name: 'Hono',
         version,
         confidence: min(confidence, 100),
         detectedFrom: sources,
@@ -1980,6 +1214,26 @@ function fastifyDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ * @example Detecting Koa framework
+ * ```typescript
+ * const pkg = {
+ *   dependencies: { koa: '^2.14.2', 'koa-router': '^12.0.0' },
+ *   devDependencies: { '@types/koa': '^2.13.9' },
+ * }
+ *
+ * const result = koaDetector('/path/to/project', pkg)
+ * // => {
+ * //   id: 'koa',
+ * //   name: 'Koa',
+ * //   version: '2.14.2',
+ * //   confidence: 100,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.koa' },
+ * //     { type: 'package.json', field: 'dependencies.@types/koa' },
+ * //     { type: 'package.json', field: 'dependencies (koa middleware)' },
+ * //   ],
+ * // }
+ * ```
  */
 function koaDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -2014,35 +1268,72 @@ function koaDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect Hono in project.
+ * Detect NestJS in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ * @example Detecting NestJS framework
+ * ```typescript
+ * // Project with nest-cli.json and NestJS packages
+ * const pkg = {
+ *   dependencies: {
+ *     '@nestjs/core': '^10.2.0',
+ *     '@nestjs/common': '^10.2.0',
+ *     '@nestjs/platform-express': '^10.2.0',
+ *   },
+ * }
+ *
+ * const result = nestDetector('/path/to/nest-project', pkg)
+ * // => {
+ * //   id: 'nestjs',
+ * //   name: 'NestJS',
+ * //   version: '10.2.0',
+ * //   configPath: 'nest-cli.json',  // if present
+ * //   confidence: 100,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.@nestjs/core' },
+ * //     { type: 'package.json', field: 'dependencies.@nestjs/common' },
+ * //     { type: 'config-file', path: 'nest-cli.json' },
+ * //     { type: 'package.json', field: 'dependencies (@nestjs packages)' },
+ * //   ],
+ * // }
+ * ```
  */
-function honoDetector(projectPath, packageJson) {
+function nestDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
+    let configPath;
     const deps = collectAllDependencies(pkg);
-    if (deps['hono']) {
-        confidence += 85;
-        version = parseVersionString(deps['hono']);
-        sources.push({ type: 'package.json', field: 'dependencies.hono' });
+    if (deps['@nestjs/core']) {
+        confidence += 70;
+        version = parseVersionString(deps['@nestjs/core']);
+        sources.push({ type: 'package.json', field: 'dependencies.@nestjs/core' });
     }
-    const honoAdapters = keys(deps).filter((d) => d.startsWith('@hono/'));
-    if (honoAdapters.length > 0) {
+    if (deps['@nestjs/common']) {
         confidence += 15;
-        sources.push({ type: 'package.json', field: 'dependencies (@hono adapters)' });
+        sources.push({ type: 'package.json', field: 'dependencies.@nestjs/common' });
+    }
+    if (exists(join$1(projectPath, 'nest-cli.json'))) {
+        confidence += 15;
+        configPath = 'nest-cli.json';
+        sources.push({ type: 'config-file', path: 'nest-cli.json' });
+    }
+    const nestPackages = keys(deps).filter((d) => d.startsWith('@nestjs/'));
+    if (nestPackages.length > 2) {
+        confidence += 5;
+        sources.push({ type: 'package.json', field: 'dependencies (@nestjs packages)' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'hono',
-        name: 'Hono',
+        id: 'nestjs',
+        name: 'NestJS',
         version,
+        configPath,
         confidence: min(confidence, 100),
         detectedFrom: sources,
     };
@@ -2057,99 +1348,64 @@ const backendDetectors = [
     { id: 'hono', name: 'Hono', detect: honoDetector },
 ];
 
-/** Config patterns for Webpack */
-const WEBPACK_CONFIG_PATTERNS = [
-    'webpack.config.js',
-    'webpack.config.ts',
-    'webpack.config.cjs',
-    'webpack.config.mjs',
-    'webpack.config.babel.js',
-];
+/** Config patterns for Babel */
+const BABEL_CONFIG_PATTERNS = ['babel.config.js', 'babel.config.cjs', 'babel.config.mjs', 'babel.config.json', '.babelrc', '.babelrc.json', '.babelrc.js'];
 /**
- * Detect Webpack in project.
+ * Detect Babel in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Babel compiler
+ * ```typescript
+ * const result = babelDetector('/path/to/project', {
+ *   name: 'my-app',
+ *   devDependencies: { '@babel/core': '^7.23.0', '@babel/preset-env': '^7.23.0' }
+ * })
+ * // => {
+ * //   id: 'babel',
+ * //   name: 'Babel',
+ * //   version: '7.23.0',
+ * //   confidence: 60,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.@babel/core' },
+ * //     { type: 'package.json', field: 'dependencies (@babel packages)' }
+ * //   ]
+ * // }
+ * ```
  */
-function webpackDetector(projectPath, packageJson) {
+function babelDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['webpack']) {
+    if (deps['@babel/core']) {
         confidence += 50;
-        version = parseVersionString(deps['webpack']);
-        sources.push({ type: 'package.json', field: 'dependencies.webpack' });
+        version = parseVersionString(deps['@babel/core']);
+        sources.push({ type: 'package.json', field: 'dependencies.@babel/core' });
     }
-    const configPath = locateConfigFile(projectPath, WEBPACK_CONFIG_PATTERNS);
+    const configPath = locateConfigFile(projectPath, BABEL_CONFIG_PATTERNS);
     if (configPath) {
         confidence += 40;
         sources.push({ type: 'config-file', path: configPath });
     }
-    if (deps['webpack-cli']) {
-        confidence += 10;
-        sources.push({ type: 'package.json', field: 'dependencies.webpack-cli' });
-    }
-    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'webpack');
-    for (const name of scriptMatches) {
-        confidence = min(confidence + 5, 100);
-        sources.push({ type: 'package.json', field: `scripts.${name}` });
-    }
-    if (confidence === 0) {
-        return null;
-    }
-    return {
-        id: 'webpack',
-        name: 'Webpack',
-        version,
-        configPath,
-        confidence: min(confidence, 100),
-        detectedFrom: sources,
-    };
-}
-
-/** Config patterns for Vite */
-const VITE_CONFIG_PATTERNS = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs', 'vite.config.cjs'];
-/**
- * Detect Vite in project.
- *
- * @param projectPath - Project directory path
- * @param packageJson - Optional pre-loaded package.json
- * @returns Detection result or null if not detected
- */
-function viteDetector(projectPath, packageJson) {
-    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
-    const sources = [];
-    let confidence = 0;
-    let version;
-    const deps = collectAllDependencies(pkg);
-    if (deps['vite']) {
-        confidence += 60;
-        version = parseVersionString(deps['vite']);
-        sources.push({ type: 'package.json', field: 'dependencies.vite' });
-    }
-    const configPath = locateConfigFile(projectPath, VITE_CONFIG_PATTERNS);
-    if (configPath) {
-        confidence += 35;
-        sources.push({ type: 'config-file', path: configPath });
-    }
-    if (deps['vitest']) {
-        confidence += 10;
-        sources.push({ type: 'package.json', field: 'dependencies.vitest' });
+    if (pkg && 'babel' in pkg) {
+        confidence += 30;
+        sources.push({ type: 'package.json', field: 'babel' });
     }
-    const vitePlugins = keys(deps).filter((d) => d.startsWith('vite-plugin-') || d.startsWith('@vitejs/'));
-    if (vitePlugins.length > 0) {
+    const babelPackages = keys(deps).filter((d) => d.startsWith('@babel/'));
+    if (babelPackages.length > 1) {
         confidence += 10;
-        sources.push({ type: 'package.json', field: 'dependencies (vite plugins)' });
+        sources.push({ type: 'package.json', field: 'dependencies (@babel packages)' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'vite',
-        name: 'Vite',
+        id: 'babel',
+        name: 'Babel',
         version,
         configPath,
         confidence: min(confidence, 100),
@@ -2157,78 +1413,116 @@ function viteDetector(projectPath, packageJson) {
     };
 }
 
-/** Config patterns for Rollup */
-const ROLLUP_CONFIG_PATTERNS = ['rollup.config.js', 'rollup.config.ts', 'rollup.config.mjs', 'rollup.config.cjs'];
 /**
- * Detect Rollup in project.
+ * Detect esbuild in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting esbuild bundler
+ * ```typescript
+ * const result = esbuildDetector('/path/to/project', {
+ *   name: 'my-lib',
+ *   devDependencies: { 'esbuild': '^0.19.0' },
+ *   scripts: { 'build': 'esbuild src/index.ts --bundle --outfile=dist/index.js' }
+ * })
+ * // => {
+ * //   id: 'esbuild',
+ * //   name: 'esbuild',
+ * //   version: '0.19.0',
+ * //   confidence: 80,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.esbuild' },
+ * //     { type: 'package.json', field: 'scripts.build' }
+ * //   ]
+ * // }
+ * ```
  */
-function rollupDetector(projectPath, packageJson) {
+function esbuildDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['rollup']) {
-        confidence += 55;
-        version = parseVersionString(deps['rollup']);
-        sources.push({ type: 'package.json', field: 'dependencies.rollup' });
-    }
-    const configPath = locateConfigFile(projectPath, ROLLUP_CONFIG_PATTERNS);
-    if (configPath) {
-        confidence += 40;
-        sources.push({ type: 'config-file', path: configPath });
+    if (deps['esbuild']) {
+        confidence += 70;
+        version = parseVersionString(deps['esbuild']);
+        sources.push({ type: 'package.json', field: 'dependencies.esbuild' });
     }
-    const rollupPlugins = keys(deps).filter((d) => d.startsWith('@rollup/') || d.startsWith('rollup-plugin-'));
-    if (rollupPlugins.length > 0) {
-        confidence += 10;
-        sources.push({ type: 'package.json', field: 'dependencies (rollup plugins)' });
+    const esbuildPlugins = keys(deps).filter((d) => d.includes('esbuild-plugin') || d.includes('esbuild-'));
+    if (esbuildPlugins.length > 0) {
+        confidence += 15;
+        sources.push({ type: 'package.json', field: 'dependencies (esbuild plugins)' });
     }
-    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'rollup');
+    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'esbuild');
     for (const name of scriptMatches) {
-        confidence = min(confidence + 5, 100);
+        confidence = min(confidence + 10, 100);
         sources.push({ type: 'package.json', field: `scripts.${name}` });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'rollup',
-        name: 'Rollup',
+        id: 'esbuild',
+        name: 'esbuild',
         version,
-        configPath,
         confidence: min(confidence, 100),
         detectedFrom: sources,
     };
 }
 
+/** Config patterns for Parcel */
+const PARCEL_CONFIG_PATTERNS = ['.parcelrc'];
 /**
- * Detect esbuild in project.
+ * Detect Parcel in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Parcel bundler
+ * ```typescript
+ * const result = parcelDetector('/path/to/project', {
+ *   name: 'my-app',
+ *   devDependencies: { 'parcel': '^2.10.0' },
+ *   scripts: { 'dev': 'parcel src/index.html', 'build': 'parcel build src/index.html' }
+ * })
+ * // => {
+ * //   id: 'parcel',
+ * //   name: 'Parcel',
+ * //   version: '2.10.0',
+ * //   confidence: 80,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.parcel' },
+ * //     { type: 'package.json', field: 'scripts.dev' },
+ * //     { type: 'package.json', field: 'scripts.build' }
+ * //   ]
+ * // }
+ * ```
  */
-function esbuildDetector(projectPath, packageJson) {
+function parcelDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['esbuild']) {
-        confidence += 70;
-        version = parseVersionString(deps['esbuild']);
-        sources.push({ type: 'package.json', field: 'dependencies.esbuild' });
+    if (deps['parcel']) {
+        confidence += 60;
+        version = parseVersionString(deps['parcel']);
+        sources.push({ type: 'package.json', field: 'dependencies.parcel' });
     }
-    const esbuildPlugins = keys(deps).filter((d) => d.includes('esbuild-plugin') || d.includes('esbuild-'));
-    if (esbuildPlugins.length > 0) {
-        confidence += 15;
-        sources.push({ type: 'package.json', field: 'dependencies (esbuild plugins)' });
+    if (deps['parcel-bundler']) {
+        confidence += 60;
+        version = parseVersionString(deps['parcel-bundler']);
+        sources.push({ type: 'package.json', field: 'dependencies.parcel-bundler' });
     }
-    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'esbuild');
+    const configPath = locateConfigFile(projectPath, PARCEL_CONFIG_PATTERNS);
+    if (configPath) {
+        confidence += 30;
+        sources.push({ type: 'config-file', path: configPath });
+    }
+    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'parcel');
     for (const name of scriptMatches) {
         confidence = min(confidence + 10, 100);
         sources.push({ type: 'package.json', field: `scripts.${name}` });
@@ -2237,54 +1531,78 @@ function esbuildDetector(projectPath, packageJson) {
         return null;
     }
     return {
-        id: 'esbuild',
-        name: 'esbuild',
+        id: 'parcel',
+        name: 'Parcel',
         version,
+        configPath,
         confidence: min(confidence, 100),
         detectedFrom: sources,
     };
 }
 
-/** Config patterns for Babel */
-const BABEL_CONFIG_PATTERNS = ['babel.config.js', 'babel.config.cjs', 'babel.config.mjs', 'babel.config.json', '.babelrc', '.babelrc.json', '.babelrc.js'];
+/** Config patterns for Rollup */
+const ROLLUP_CONFIG_PATTERNS = ['rollup.config.js', 'rollup.config.ts', 'rollup.config.mjs', 'rollup.config.cjs'];
 /**
- * Detect Babel in project.
+ * Detect Rollup in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Rollup bundler
+ * ```typescript
+ * const result = rollupDetector('/path/to/project', {
+ *   name: 'my-lib',
+ *   devDependencies: {
+ *     'rollup': '^4.0.0',
+ *     '@rollup/plugin-node-resolve': '^15.0.0',
+ *     '@rollup/plugin-commonjs': '^25.0.0'
+ *   }
+ * })
+ * // => {
+ * //   id: 'rollup',
+ * //   name: 'Rollup',
+ * //   version: '4.0.0',
+ * //   confidence: 65,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.rollup' },
+ * //     { type: 'package.json', field: 'dependencies (rollup plugins)' }
+ * //   ]
+ * // }
+ * ```
  */
-function babelDetector(projectPath, packageJson) {
+function rollupDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['@babel/core']) {
-        confidence += 50;
-        version = parseVersionString(deps['@babel/core']);
-        sources.push({ type: 'package.json', field: 'dependencies.@babel/core' });
+    if (deps['rollup']) {
+        confidence += 55;
+        version = parseVersionString(deps['rollup']);
+        sources.push({ type: 'package.json', field: 'dependencies.rollup' });
     }
-    const configPath = locateConfigFile(projectPath, BABEL_CONFIG_PATTERNS);
+    const configPath = locateConfigFile(projectPath, ROLLUP_CONFIG_PATTERNS);
     if (configPath) {
         confidence += 40;
         sources.push({ type: 'config-file', path: configPath });
     }
-    if (pkg && 'babel' in pkg) {
-        confidence += 30;
-        sources.push({ type: 'package.json', field: 'babel' });
-    }
-    const babelPackages = keys(deps).filter((d) => d.startsWith('@babel/'));
-    if (babelPackages.length > 1) {
+    const rollupPlugins = keys(deps).filter((d) => d.startsWith('@rollup/') || d.startsWith('rollup-plugin-'));
+    if (rollupPlugins.length > 0) {
         confidence += 10;
-        sources.push({ type: 'package.json', field: 'dependencies (@babel packages)' });
+        sources.push({ type: 'package.json', field: 'dependencies (rollup plugins)' });
+    }
+    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'rollup');
+    for (const name of scriptMatches) {
+        confidence = min(confidence + 5, 100);
+        sources.push({ type: 'package.json', field: `scripts.${name}` });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'babel',
-        name: 'Babel',
+        id: 'rollup',
+        name: 'Rollup',
         version,
         configPath,
         confidence: min(confidence, 100),
@@ -2300,6 +1618,24 @@ const SWC_CONFIG_PATTERNS = ['.swcrc', 'swc.config.js'];
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting SWC compiler
+ * ```typescript
+ * const result = swcDetector('/path/to/project', {
+ *   name: 'my-app',
+ *   devDependencies: { '@swc/core': '^1.3.0', '@swc/cli': '^0.1.0' }
+ * })
+ * // => {
+ * //   id: 'swc',
+ * //   name: 'SWC',
+ * //   version: '1.3.0',
+ * //   confidence: 70,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.@swc/core' },
+ * //     { type: 'package.json', field: 'dependencies.@swc/cli' }
+ * //   ]
+ * // }
+ * ```
  */
 function swcDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -2339,47 +1675,142 @@ function swcDetector(projectPath, packageJson) {
     };
 }
 
-/** Config patterns for Parcel */
-const PARCEL_CONFIG_PATTERNS = ['.parcelrc'];
+/** Config patterns for Vite */
+const VITE_CONFIG_PATTERNS = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs', 'vite.config.cjs'];
 /**
- * Detect Parcel in project.
+ * Detect Vite in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Vite build tool
+ * ```typescript
+ * const result = viteDetector('/path/to/project', {
+ *   name: 'my-app',
+ *   devDependencies: {
+ *     'vite': '^5.0.0',
+ *     '@vitejs/plugin-react': '^4.0.0',
+ *     'vitest': '^1.0.0'
+ *   }
+ * })
+ * // => {
+ * //   id: 'vite',
+ * //   name: 'Vite',
+ * //   version: '5.0.0',
+ * //   confidence: 80,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.vite' },
+ * //     { type: 'package.json', field: 'dependencies.vitest' },
+ * //     { type: 'package.json', field: 'dependencies (vite plugins)' }
+ * //   ]
+ * // }
+ * ```
  */
-function parcelDetector(projectPath, packageJson) {
+function viteDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['parcel']) {
-        confidence += 60;
-        version = parseVersionString(deps['parcel']);
-        sources.push({ type: 'package.json', field: 'dependencies.parcel' });
-    }
-    if (deps['parcel-bundler']) {
+    if (deps['vite']) {
         confidence += 60;
-        version = parseVersionString(deps['parcel-bundler']);
-        sources.push({ type: 'package.json', field: 'dependencies.parcel-bundler' });
+        version = parseVersionString(deps['vite']);
+        sources.push({ type: 'package.json', field: 'dependencies.vite' });
     }
-    const configPath = locateConfigFile(projectPath, PARCEL_CONFIG_PATTERNS);
+    const configPath = locateConfigFile(projectPath, VITE_CONFIG_PATTERNS);
     if (configPath) {
-        confidence += 30;
+        confidence += 35;
         sources.push({ type: 'config-file', path: configPath });
     }
-    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'parcel');
-    for (const name of scriptMatches) {
-        confidence = min(confidence + 10, 100);
+    if (deps['vitest']) {
+        confidence += 10;
+        sources.push({ type: 'package.json', field: 'dependencies.vitest' });
+    }
+    const vitePlugins = keys(deps).filter((d) => d.startsWith('vite-plugin-') || d.startsWith('@vitejs/'));
+    if (vitePlugins.length > 0) {
+        confidence += 10;
+        sources.push({ type: 'package.json', field: 'dependencies (vite plugins)' });
+    }
+    if (confidence === 0) {
+        return null;
+    }
+    return {
+        id: 'vite',
+        name: 'Vite',
+        version,
+        configPath,
+        confidence: min(confidence, 100),
+        detectedFrom: sources,
+    };
+}
+
+/** Config patterns for Webpack */
+const WEBPACK_CONFIG_PATTERNS = [
+    'webpack.config.js',
+    'webpack.config.ts',
+    'webpack.config.cjs',
+    'webpack.config.mjs',
+    'webpack.config.babel.js',
+];
+/**
+ * Detect Webpack in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Webpack bundler
+ * ```typescript
+ * const result = webpackDetector('/path/to/project', {
+ *   name: 'my-app',
+ *   devDependencies: { 'webpack': '^5.89.0', 'webpack-cli': '^5.1.0' },
+ *   scripts: { 'build': 'webpack --mode production' }
+ * })
+ * // => {
+ * //   id: 'webpack',
+ * //   name: 'Webpack',
+ * //   version: '5.89.0',
+ * //   confidence: 65,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.webpack' },
+ * //     { type: 'package.json', field: 'dependencies.webpack-cli' },
+ * //     { type: 'package.json', field: 'scripts.build' }
+ * //   ]
+ * // }
+ * ```
+ */
+function webpackDetector(projectPath, packageJson) {
+    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
+    const sources = [];
+    let confidence = 0;
+    let version;
+    const deps = collectAllDependencies(pkg);
+    if (deps['webpack']) {
+        confidence += 50;
+        version = parseVersionString(deps['webpack']);
+        sources.push({ type: 'package.json', field: 'dependencies.webpack' });
+    }
+    const configPath = locateConfigFile(projectPath, WEBPACK_CONFIG_PATTERNS);
+    if (configPath) {
+        confidence += 40;
+        sources.push({ type: 'config-file', path: configPath });
+    }
+    if (deps['webpack-cli']) {
+        confidence += 10;
+        sources.push({ type: 'package.json', field: 'dependencies.webpack-cli' });
+    }
+    const scriptMatches = filterScriptsByCommand(pkg?.scripts, 'webpack');
+    for (const name of scriptMatches) {
+        confidence = min(confidence + 5, 100);
         sources.push({ type: 'package.json', field: `scripts.${name}` });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'parcel',
-        name: 'Parcel',
+        id: 'webpack',
+        name: 'Webpack',
         version,
         configPath,
         confidence: min(confidence, 100),
@@ -2399,81 +1830,187 @@ const buildToolDetectors = [
 ];
 
 /**
- * Detect React in project.
+ * Detect Angular in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Angular framework
+ * ```typescript
+ * const result = angularDetector('/path/to/angular-app', {
+ *   dependencies: { '@angular/core': '^17.0.0', '@angular/cli': '^17.0.0' }
+ * })
+ * // => {
+ * //   id: 'angular',
+ * //   name: 'Angular',
+ * //   category: 'frontend',
+ * //   version: '17.0.0',
+ * //   confidence: 85,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.@angular/core' },
+ * //     { type: 'package.json', field: 'dependencies.@angular/cli' }
+ * //   ]
+ * // }
+ * ```
  */
-function reactDetector(projectPath, packageJson) {
+function angularDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
-    const metaFrameworks = [];
     const deps = collectAllDependencies(pkg);
-    if (deps['react']) {
-        confidence += 60;
-        version = parseVersionString(deps['react']);
-        sources.push({ type: 'package.json', field: 'dependencies.react' });
+    if (deps['@angular/core']) {
+        confidence += 70;
+        version = parseVersionString(deps['@angular/core']);
+        sources.push({ type: 'package.json', field: 'dependencies.@angular/core' });
     }
-    if (deps['react-dom']) {
-        confidence += 20;
-        sources.push({ type: 'package.json', field: 'dependencies.react-dom' });
+    if (deps['@angular/cli']) {
+        confidence += 15;
+        sources.push({ type: 'package.json', field: 'dependencies.@angular/cli' });
     }
-    if (deps['react-native']) {
-        confidence += 20;
-        sources.push({ type: 'package.json', field: 'dependencies.react-native' });
+    if (exists(join$1(projectPath, 'angular.json'))) {
+        confidence += 15;
+        sources.push({ type: 'config-file', path: 'angular.json' });
     }
-    const hasJsxFiles = exists(join$1(projectPath, 'src', 'App.tsx')) ||
-        exists(join$1(projectPath, 'src', 'App.jsx')) ||
-        exists(join$1(projectPath, 'src', 'index.tsx')) ||
-        exists(join$1(projectPath, 'src', 'index.jsx'));
-    if (hasJsxFiles) {
-        confidence += 10;
-        sources.push({ type: 'directory', path: 'src/*.tsx or src/*.jsx' });
+    if (deps['angular'] && !deps['@angular/core']) {
+        return {
+            id: 'angularjs',
+            name: 'AngularJS (Legacy)',
+            category: 'frontend',
+            version: parseVersionString(deps['angular']),
+            confidence: 80,
+            detectedFrom: [{ type: 'package.json', field: 'dependencies.angular' }],
+        };
     }
-    if (deps['next']) {
-        metaFrameworks.push({
-            id: 'nextjs',
-            name: 'Next.js',
-            category: 'meta-framework',
-            version: parseVersionString(deps['next']),
-            confidence: 90,
-            detectedFrom: [{ type: 'package.json', field: 'dependencies.next' }],
-        });
+    if (confidence === 0) {
+        return null;
+    }
+    return {
+        id: 'angular',
+        name: 'Angular',
+        category: 'frontend',
+        version,
+        confidence: min(confidence, 100),
+        detectedFrom: sources,
+    };
+}
+
+/**
+ * Detect Astro in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Astro framework
+ * ```typescript
+ * const result = astroDetector('/path/to/astro-project', {
+ *   dependencies: { 'astro': '^4.0.0' }
+ * })
+ * // => {
+ * //   id: 'astro',
+ * //   name: 'Astro',
+ * //   category: 'meta-framework',
+ * //   version: '4.0.0',
+ * //   confidence: 70,
+ * //   detectedFrom: [{ type: 'package.json', field: 'dependencies.astro' }]
+ * // }
+ * ```
+ */
+function astroDetector(projectPath, packageJson) {
+    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
+    const sources = [];
+    let confidence = 0;
+    let version;
+    const deps = collectAllDependencies(pkg);
+    if (deps['astro']) {
+        confidence += 70;
+        version = parseVersionString(deps['astro']);
+        sources.push({ type: 'package.json', field: 'dependencies.astro' });
+    }
+    if (exists(join$1(projectPath, 'astro.config.mjs')) ||
+        exists(join$1(projectPath, 'astro.config.ts')) ||
+        exists(join$1(projectPath, 'astro.config.js'))) {
+        confidence += 25;
+        sources.push({ type: 'config-file', path: 'astro.config.*' });
     }
+    if (exists(join$1(projectPath, 'src', 'pages'))) {
+        confidence += 5;
+        sources.push({ type: 'directory', path: 'src/pages/' });
+    }
+    if (confidence === 0) {
+        return null;
+    }
+    return {
+        id: 'astro',
+        name: 'Astro',
+        category: 'meta-framework',
+        version,
+        confidence: min(confidence, 100),
+        detectedFrom: sources,
+    };
+}
+
+/**
+ * Detect Gatsby in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Gatsby framework
+ * ```typescript
+ * const result = gatsbyDetector('/path/to/gatsby-blog', {
+ *   dependencies: {
+ *     'gatsby': '^5.0.0',
+ *     'gatsby-plugin-image': '^3.0.0',
+ *     'gatsby-source-filesystem': '^5.0.0'
+ *   }
+ * })
+ * // => {
+ * //   id: 'gatsby',
+ * //   name: 'Gatsby',
+ * //   category: 'meta-framework',
+ * //   version: '5.0.0',
+ * //   confidence: 75,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.gatsby' },
+ * //     { type: 'package.json', field: 'dependencies (gatsby plugins)' }
+ * //   ]
+ * // }
+ * ```
+ */
+function gatsbyDetector(projectPath, packageJson) {
+    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
+    const sources = [];
+    let confidence = 0;
+    let version;
+    const deps = collectAllDependencies(pkg);
     if (deps['gatsby']) {
-        metaFrameworks.push({
-            id: 'gatsby',
-            name: 'Gatsby',
-            category: 'meta-framework',
-            version: parseVersionString(deps['gatsby']),
-            confidence: 90,
-            detectedFrom: [{ type: 'package.json', field: 'dependencies.gatsby' }],
-        });
+        confidence += 70;
+        version = parseVersionString(deps['gatsby']);
+        sources.push({ type: 'package.json', field: 'dependencies.gatsby' });
     }
-    if (deps['@remix-run/react'] || deps['remix']) {
-        metaFrameworks.push({
-            id: 'remix',
-            name: 'Remix',
-            category: 'meta-framework',
-            version: parseVersionString(deps['@remix-run/react'] ?? deps['remix']),
-            confidence: 90,
-            detectedFrom: [{ type: 'package.json', field: 'dependencies.@remix-run/react' }],
-        });
+    if (exists(join$1(projectPath, 'gatsby-config.js')) || exists(join$1(projectPath, 'gatsby-config.ts'))) {
+        confidence += 25;
+        sources.push({ type: 'config-file', path: 'gatsby-config.*' });
+    }
+    const gatsbyPlugins = keys(deps).filter((d) => d.startsWith('gatsby-plugin-') || d.startsWith('gatsby-source-'));
+    if (gatsbyPlugins.length > 0) {
+        confidence += 5;
+        sources.push({ type: 'package.json', field: 'dependencies (gatsby plugins)' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'react',
-        name: 'React',
-        category: 'frontend',
+        id: 'gatsby',
+        name: 'Gatsby',
+        category: 'meta-framework',
         version,
         confidence: min(confidence, 100),
         detectedFrom: sources,
-        metaFrameworks: metaFrameworks.length > 0 ? metaFrameworks : undefined,
     };
 }
 
@@ -2483,6 +2020,21 @@ function reactDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Next.js framework
+ * ```typescript
+ * const result = nextjsDetector('/path/to/nextjs-app', {
+ *   dependencies: { 'next': '^14.0.0', 'react': '^18.0.0' }
+ * })
+ * // => {
+ * //   id: 'nextjs',
+ * //   name: 'Next.js',
+ * //   category: 'meta-framework',
+ * //   version: '14.0.0',
+ * //   confidence: 70,
+ * //   detectedFrom: [{ type: 'package.json', field: 'dependencies.next' }]
+ * // }
+ * ```
  */
 function nextjsDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -2522,37 +2074,52 @@ function nextjsDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect Remix in project.
+ * Detect Nuxt in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Nuxt framework
+ * ```typescript
+ * const result = nuxtDetector('/path/to/nuxt-app', {
+ *   dependencies: { 'nuxt': '^3.0.0', 'vue': '^3.0.0' }
+ * })
+ * // => {
+ * //   id: 'nuxt',
+ * //   name: 'Nuxt',
+ * //   category: 'meta-framework',
+ * //   version: '3.0.0',
+ * //   confidence: 70,
+ * //   detectedFrom: [{ type: 'package.json', field: 'dependencies.nuxt' }]
+ * // }
+ * ```
  */
-function remixDetector(projectPath, packageJson) {
+function nuxtDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['@remix-run/react']) {
+    if (deps['nuxt'] || deps['nuxt3']) {
         confidence += 70;
-        version = parseVersionString(deps['@remix-run/react']);
-        sources.push({ type: 'package.json', field: 'dependencies.@remix-run/react' });
+        version = parseVersionString(deps['nuxt'] ?? deps['nuxt3']);
+        sources.push({ type: 'package.json', field: 'dependencies.nuxt' });
     }
-    if (deps['@remix-run/node'] || deps['@remix-run/cloudflare'] || deps['@remix-run/deno']) {
-        confidence += 20;
-        sources.push({ type: 'package.json', field: 'dependencies.@remix-run/*' });
+    if (exists(join$1(projectPath, 'nuxt.config.js')) || exists(join$1(projectPath, 'nuxt.config.ts'))) {
+        confidence += 25;
+        sources.push({ type: 'config-file', path: 'nuxt.config.*' });
     }
-    if (exists(join$1(projectPath, 'remix.config.js')) || exists(join$1(projectPath, 'remix.config.ts'))) {
-        confidence += 10;
-        sources.push({ type: 'config-file', path: 'remix.config.*' });
+    if (exists(join$1(projectPath, 'pages'))) {
+        confidence += 5;
+        sources.push({ type: 'directory', path: 'pages/' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'remix',
-        name: 'Remix',
+        id: 'nuxt',
+        name: 'Nuxt',
         category: 'meta-framework',
         version,
         confidence: min(confidence, 100),
@@ -2561,39 +2128,59 @@ function remixDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect Gatsby in project.
+ * Detect Qwik in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Qwik framework
+ * ```typescript
+ * const result = qwikDetector('/path/to/qwik-app', {
+ *   dependencies: {
+ *     '@builder.io/qwik': '^1.0.0',
+ *     '@builder.io/qwik-city': '^1.0.0'
+ *   }
+ * })
+ * // => {
+ * //   id: 'qwik',
+ * //   name: 'Qwik',
+ * //   category: 'frontend',
+ * //   version: '1.0.0',
+ * //   confidence: 90,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.@builder.io/qwik' },
+ * //     { type: 'package.json', field: 'dependencies.@builder.io/qwik-city' }
+ * //   ]
+ * // }
+ * ```
  */
-function gatsbyDetector(projectPath, packageJson) {
+function qwikDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['gatsby']) {
+    if (deps['@builder.io/qwik']) {
         confidence += 70;
-        version = parseVersionString(deps['gatsby']);
-        sources.push({ type: 'package.json', field: 'dependencies.gatsby' });
+        version = parseVersionString(deps['@builder.io/qwik']);
+        sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik' });
     }
-    if (exists(join$1(projectPath, 'gatsby-config.js')) || exists(join$1(projectPath, 'gatsby-config.ts'))) {
-        confidence += 25;
-        sources.push({ type: 'config-file', path: 'gatsby-config.*' });
+    if (deps['@builder.io/qwik-city']) {
+        confidence += 20;
+        sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik-city' });
     }
-    const gatsbyPlugins = keys(deps).filter((d) => d.startsWith('gatsby-plugin-') || d.startsWith('gatsby-source-'));
-    if (gatsbyPlugins.length > 0) {
-        confidence += 5;
-        sources.push({ type: 'package.json', field: 'dependencies (gatsby plugins)' });
+    if (exists(join$1(projectPath, 'qwik.config.ts')) || exists(join$1(projectPath, 'qwik.config.js'))) {
+        confidence += 10;
+        sources.push({ type: 'config-file', path: 'qwik.config.*' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'gatsby',
-        name: 'Gatsby',
-        category: 'meta-framework',
+        id: 'qwik',
+        name: 'Qwik',
+        category: 'frontend',
         version,
         confidence: min(confidence, 100),
         detectedFrom: sources,
@@ -2601,53 +2188,94 @@ function gatsbyDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect Vue in project.
+ * Detect React in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting React library
+ * ```typescript
+ * const result = reactDetector('/path/to/react-app', {
+ *   dependencies: { 'react': '^18.0.0', 'react-dom': '^18.0.0' }
+ * })
+ * // => {
+ * //   id: 'react',
+ * //   name: 'React',
+ * //   category: 'frontend',
+ * //   version: '18.0.0',
+ * //   confidence: 80,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.react' },
+ * //     { type: 'package.json', field: 'dependencies.react-dom' }
+ * //   ]
+ * // }
+ * ```
  */
-function vueDetector(projectPath, packageJson) {
+function reactDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const metaFrameworks = [];
     const deps = collectAllDependencies(pkg);
-    if (deps['vue']) {
-        confidence += 70;
-        version = parseVersionString(deps['vue']);
-        sources.push({ type: 'package.json', field: 'dependencies.vue' });
+    if (deps['react']) {
+        confidence += 60;
+        version = parseVersionString(deps['react']);
+        sources.push({ type: 'package.json', field: 'dependencies.react' });
     }
-    if (deps['@vue/cli-service']) {
-        confidence += 15;
-        sources.push({ type: 'package.json', field: 'dependencies.@vue/cli-service' });
+    if (deps['react-dom']) {
+        confidence += 20;
+        sources.push({ type: 'package.json', field: 'dependencies.react-dom' });
     }
-    const hasVueFiles = exists(join$1(projectPath, 'src', 'App.vue')) || exists(join$1(projectPath, 'src', 'main.vue'));
-    if (hasVueFiles) {
+    if (deps['react-native']) {
+        confidence += 20;
+        sources.push({ type: 'package.json', field: 'dependencies.react-native' });
+    }
+    const hasJsxFiles = exists(join$1(projectPath, 'src', 'App.tsx')) ||
+        exists(join$1(projectPath, 'src', 'App.jsx')) ||
+        exists(join$1(projectPath, 'src', 'index.tsx')) ||
+        exists(join$1(projectPath, 'src', 'index.jsx'));
+    if (hasJsxFiles) {
         confidence += 10;
-        sources.push({ type: 'directory', path: 'src/*.vue' });
+        sources.push({ type: 'directory', path: 'src/*.tsx or src/*.jsx' });
     }
-    if (exists(join$1(projectPath, 'vue.config.js'))) {
-        confidence += 5;
-        sources.push({ type: 'config-file', path: 'vue.config.js' });
+    if (deps['next']) {
+        metaFrameworks.push({
+            id: 'nextjs',
+            name: 'Next.js',
+            category: 'meta-framework',
+            version: parseVersionString(deps['next']),
+            confidence: 90,
+            detectedFrom: [{ type: 'package.json', field: 'dependencies.next' }],
+        });
     }
-    if (deps['nuxt'] || deps['nuxt3']) {
+    if (deps['gatsby']) {
         metaFrameworks.push({
-            id: 'nuxt',
-            name: 'Nuxt',
+            id: 'gatsby',
+            name: 'Gatsby',
             category: 'meta-framework',
-            version: parseVersionString(deps['nuxt'] ?? deps['nuxt3']),
+            version: parseVersionString(deps['gatsby']),
             confidence: 90,
-            detectedFrom: [{ type: 'package.json', field: 'dependencies.nuxt' }],
+            detectedFrom: [{ type: 'package.json', field: 'dependencies.gatsby' }],
+        });
+    }
+    if (deps['@remix-run/react'] || deps['remix']) {
+        metaFrameworks.push({
+            id: 'remix',
+            name: 'Remix',
+            category: 'meta-framework',
+            version: parseVersionString(deps['@remix-run/react'] ?? deps['remix']),
+            confidence: 90,
+            detectedFrom: [{ type: 'package.json', field: 'dependencies.@remix-run/react' }],
         });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'vue',
-        name: 'Vue',
+        id: 'react',
+        name: 'React',
         category: 'frontend',
         version,
         confidence: min(confidence, 100),
@@ -2657,37 +2285,58 @@ function vueDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect Nuxt in project.
+ * Detect Remix in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Remix framework
+ * ```typescript
+ * const result = remixDetector('/path/to/remix-app', {
+ *   dependencies: {
+ *     '@remix-run/react': '^2.0.0',
+ *     '@remix-run/node': '^2.0.0'
+ *   }
+ * })
+ * // => {
+ * //   id: 'remix',
+ * //   name: 'Remix',
+ * //   category: 'meta-framework',
+ * //   version: '2.0.0',
+ * //   confidence: 90,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.@remix-run/react' },
+ * //     { type: 'package.json', field: 'dependencies.@remix-run/*' }
+ * //   ]
+ * // }
+ * ```
  */
-function nuxtDetector(projectPath, packageJson) {
+function remixDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['nuxt'] || deps['nuxt3']) {
+    if (deps['@remix-run/react']) {
         confidence += 70;
-        version = parseVersionString(deps['nuxt'] ?? deps['nuxt3']);
-        sources.push({ type: 'package.json', field: 'dependencies.nuxt' });
+        version = parseVersionString(deps['@remix-run/react']);
+        sources.push({ type: 'package.json', field: 'dependencies.@remix-run/react' });
     }
-    if (exists(join$1(projectPath, 'nuxt.config.js')) || exists(join$1(projectPath, 'nuxt.config.ts'))) {
-        confidence += 25;
-        sources.push({ type: 'config-file', path: 'nuxt.config.*' });
+    if (deps['@remix-run/node'] || deps['@remix-run/cloudflare'] || deps['@remix-run/deno']) {
+        confidence += 20;
+        sources.push({ type: 'package.json', field: 'dependencies.@remix-run/*' });
     }
-    if (exists(join$1(projectPath, 'pages'))) {
-        confidence += 5;
-        sources.push({ type: 'directory', path: 'pages/' });
+    if (exists(join$1(projectPath, 'remix.config.js')) || exists(join$1(projectPath, 'remix.config.ts'))) {
+        confidence += 10;
+        sources.push({ type: 'config-file', path: 'remix.config.*' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'nuxt',
-        name: 'Nuxt',
+        id: 'remix',
+        name: 'Remix',
         category: 'meta-framework',
         version,
         confidence: min(confidence, 100),
@@ -2696,47 +2345,55 @@ function nuxtDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect Angular in project.
+ * Detect Solid in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Solid.js framework
+ * ```typescript
+ * const result = solidDetector('/path/to/solid-app', {
+ *   dependencies: { 'solid-js': '^1.8.0', 'vite-plugin-solid': '^2.0.0' }
+ * })
+ * // => {
+ * //   id: 'solid',
+ * //   name: 'Solid',
+ * //   category: 'frontend',
+ * //   version: '1.8.0',
+ * //   confidence: 90,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.solid-js' },
+ * //     { type: 'package.json', field: 'dependencies.vite-plugin-solid' }
+ * //   ]
+ * // }
+ * ```
  */
-function angularDetector(projectPath, packageJson) {
+function solidDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['@angular/core']) {
+    if (deps['solid-js']) {
         confidence += 70;
-        version = parseVersionString(deps['@angular/core']);
-        sources.push({ type: 'package.json', field: 'dependencies.@angular/core' });
-    }
-    if (deps['@angular/cli']) {
-        confidence += 15;
-        sources.push({ type: 'package.json', field: 'dependencies.@angular/cli' });
+        version = parseVersionString(deps['solid-js']);
+        sources.push({ type: 'package.json', field: 'dependencies.solid-js' });
     }
-    if (exists(join$1(projectPath, 'angular.json'))) {
-        confidence += 15;
-        sources.push({ type: 'config-file', path: 'angular.json' });
+    if (deps['vite-plugin-solid']) {
+        confidence += 20;
+        sources.push({ type: 'package.json', field: 'dependencies.vite-plugin-solid' });
     }
-    if (deps['angular'] && !deps['@angular/core']) {
-        return {
-            id: 'angularjs',
-            name: 'AngularJS (Legacy)',
-            category: 'frontend',
-            version: parseVersionString(deps['angular']),
-            confidence: 80,
-            detectedFrom: [{ type: 'package.json', field: 'dependencies.angular' }],
-        };
+    if (deps['solid-start'] || deps['@solidjs/start']) {
+        confidence += 10;
+        sources.push({ type: 'package.json', field: 'dependencies.solid-start' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'angular',
-        name: 'Angular',
+        id: 'solid',
+        name: 'Solid',
         category: 'frontend',
         version,
         confidence: min(confidence, 100),
@@ -2750,6 +2407,21 @@ function angularDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Svelte framework
+ * ```typescript
+ * const result = svelteDetector('/path/to/svelte-app', {
+ *   devDependencies: { 'svelte': '^4.0.0' }
+ * })
+ * // => {
+ * //   id: 'svelte',
+ * //   name: 'Svelte',
+ * //   category: 'frontend',
+ * //   version: '4.0.0',
+ * //   confidence: 70,
+ * //   detectedFrom: [{ type: 'package.json', field: 'dependencies.svelte' }]
+ * // }
+ * ```
  */
 function svelteDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -2802,6 +2474,21 @@ function svelteDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting SvelteKit framework
+ * ```typescript
+ * const result = sveltekitDetector('/path/to/sveltekit-app', {
+ *   devDependencies: { '@sveltejs/kit': '^2.0.0', 'svelte': '^4.0.0' }
+ * })
+ * // => {
+ * //   id: 'sveltekit',
+ * //   name: 'SvelteKit',
+ * //   category: 'meta-framework',
+ * //   version: '2.0.0',
+ * //   confidence: 70,
+ * //   detectedFrom: [{ type: 'package.json', field: 'dependencies.@sveltejs/kit' }]
+ * // }
+ * ```
  */
 function sveltekitDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -2836,121 +2523,76 @@ function sveltekitDetector(projectPath, packageJson) {
 }
 
 /**
- * Detect Solid in project.
+ * Detect Vue in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
- */
-function solidDetector(projectPath, packageJson) {
-    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
-    const sources = [];
-    let confidence = 0;
-    let version;
-    const deps = collectAllDependencies(pkg);
-    if (deps['solid-js']) {
-        confidence += 70;
-        version = parseVersionString(deps['solid-js']);
-        sources.push({ type: 'package.json', field: 'dependencies.solid-js' });
-    }
-    if (deps['vite-plugin-solid']) {
-        confidence += 20;
-        sources.push({ type: 'package.json', field: 'dependencies.vite-plugin-solid' });
-    }
-    if (deps['solid-start'] || deps['@solidjs/start']) {
-        confidence += 10;
-        sources.push({ type: 'package.json', field: 'dependencies.solid-start' });
-    }
-    if (confidence === 0) {
-        return null;
-    }
-    return {
-        id: 'solid',
-        name: 'Solid',
-        category: 'frontend',
-        version,
-        confidence: min(confidence, 100),
-        detectedFrom: sources,
-    };
-}
-
-/**
- * Detect Qwik in project.
  *
- * @param projectPath - Project directory path
- * @param packageJson - Optional pre-loaded package.json
- * @returns Detection result or null if not detected
+ * @example Detecting Vue.js framework
+ * ```typescript
+ * const result = vueDetector('/path/to/vue-app', {
+ *   dependencies: { 'vue': '^3.0.0', '@vue/cli-service': '^5.0.0' }
+ * })
+ * // => {
+ * //   id: 'vue',
+ * //   name: 'Vue',
+ * //   category: 'frontend',
+ * //   version: '3.0.0',
+ * //   confidence: 85,
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'dependencies.vue' },
+ * //     { type: 'package.json', field: 'dependencies.@vue/cli-service' }
+ * //   ]
+ * // }
+ * ```
  */
-function qwikDetector(projectPath, packageJson) {
+function vueDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
+    const metaFrameworks = [];
     const deps = collectAllDependencies(pkg);
-    if (deps['@builder.io/qwik']) {
+    if (deps['vue']) {
         confidence += 70;
-        version = parseVersionString(deps['@builder.io/qwik']);
-        sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik' });
+        version = parseVersionString(deps['vue']);
+        sources.push({ type: 'package.json', field: 'dependencies.vue' });
     }
-    if (deps['@builder.io/qwik-city']) {
-        confidence += 20;
-        sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik-city' });
+    if (deps['@vue/cli-service']) {
+        confidence += 15;
+        sources.push({ type: 'package.json', field: 'dependencies.@vue/cli-service' });
     }
-    if (exists(join$1(projectPath, 'qwik.config.ts')) || exists(join$1(projectPath, 'qwik.config.js'))) {
+    const hasVueFiles = exists(join$1(projectPath, 'src', 'App.vue')) || exists(join$1(projectPath, 'src', 'main.vue'));
+    if (hasVueFiles) {
         confidence += 10;
-        sources.push({ type: 'config-file', path: 'qwik.config.*' });
-    }
-    if (confidence === 0) {
-        return null;
-    }
-    return {
-        id: 'qwik',
-        name: 'Qwik',
-        category: 'frontend',
-        version,
-        confidence: min(confidence, 100),
-        detectedFrom: sources,
-    };
-}
-
-/**
- * Detect Astro in project.
- *
- * @param projectPath - Project directory path
- * @param packageJson - Optional pre-loaded package.json
- * @returns Detection result or null if not detected
- */
-function astroDetector(projectPath, packageJson) {
-    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
-    const sources = [];
-    let confidence = 0;
-    let version;
-    const deps = collectAllDependencies(pkg);
-    if (deps['astro']) {
-        confidence += 70;
-        version = parseVersionString(deps['astro']);
-        sources.push({ type: 'package.json', field: 'dependencies.astro' });
-    }
-    if (exists(join$1(projectPath, 'astro.config.mjs')) ||
-        exists(join$1(projectPath, 'astro.config.ts')) ||
-        exists(join$1(projectPath, 'astro.config.js'))) {
-        confidence += 25;
-        sources.push({ type: 'config-file', path: 'astro.config.*' });
+        sources.push({ type: 'directory', path: 'src/*.vue' });
     }
-    if (exists(join$1(projectPath, 'src', 'pages'))) {
+    if (exists(join$1(projectPath, 'vue.config.js'))) {
         confidence += 5;
-        sources.push({ type: 'directory', path: 'src/pages/' });
+        sources.push({ type: 'config-file', path: 'vue.config.js' });
+    }
+    if (deps['nuxt'] || deps['nuxt3']) {
+        metaFrameworks.push({
+            id: 'nuxt',
+            name: 'Nuxt',
+            category: 'meta-framework',
+            version: parseVersionString(deps['nuxt'] ?? deps['nuxt3']),
+            confidence: 90,
+            detectedFrom: [{ type: 'package.json', field: 'dependencies.nuxt' }],
+        });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'astro',
-        name: 'Astro',
-        category: 'meta-framework',
+        id: 'vue',
+        name: 'Vue',
+        category: 'frontend',
         version,
         confidence: min(confidence, 100),
         detectedFrom: sources,
+        metaFrameworks: metaFrameworks.length > 0 ? metaFrameworks : undefined,
     };
 }
 
@@ -2977,6 +2619,14 @@ const frameworkDetectors = [
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting AngularJS framework
+ * ```typescript
+ * const result = angularJSDetector('/path/to/project', {
+ *   dependencies: { angular: '^1.8.0', 'angular-route': '^1.8.0' },
+ * })
+ * // => { id: 'angularjs', name: 'AngularJS', confidence: 85, version: '1.8.0', ... }
+ * ```
  */
 function angularJSDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3020,6 +2670,14 @@ function angularJSDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Backbone.js framework
+ * ```typescript
+ * const result = backboneDetector('/path/to/project', {
+ *   dependencies: { backbone: '^1.4.0', underscore: '^1.13.0' },
+ * })
+ * // => { id: 'backbone', name: 'Backbone.js', confidence: 85, version: '1.4.0', ... }
+ * ```
  */
 function backboneDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3063,6 +2721,15 @@ function backboneDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Ember.js framework
+ * ```typescript
+ * const result = emberDetector('/path/to/project', {
+ *   dependencies: { 'ember-source': '^4.0.0' },
+ *   devDependencies: { 'ember-cli': '^4.0.0' },
+ * })
+ * // => { id: 'ember', name: 'Ember.js', confidence: 90, version: '4.0.0', ... }
+ * ```
  */
 function emberDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3102,6 +2769,14 @@ function emberDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting jQuery library
+ * ```typescript
+ * const result = jqueryDetector('/path/to/project', {
+ *   dependencies: { jquery: '^3.6.0', 'jquery-ui': '^1.13.0' },
+ * })
+ * // => { id: 'jquery', name: 'jQuery', confidence: 90, version: '3.6.0', ... }
+ * ```
  */
 function jqueryDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3143,6 +2818,56 @@ const legacyDetectors = [
     { id: 'jquery', name: 'jQuery', category: 'legacy-frontend', detect: jqueryDetector },
 ];
 
+/**
+ * Detect Biome in project.
+ *
+ * @param projectPath - Project directory path
+ * @param packageJson - Optional pre-loaded package.json
+ * @returns Detection result or null if not detected
+ *
+ * @example Detecting Biome linter
+ * ```typescript
+ * const result = biomeDetector('/path/to/project', {
+ *   devDependencies: { '@biomejs/biome': '^1.5.0' },
+ * })
+ * // => { id: 'biome', name: 'Biome', confidence: 70, version: '1.5.0', ... }
+ * ```
+ */
+function biomeDetector(projectPath, packageJson) {
+    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
+    const sources = [];
+    let confidence = 0;
+    let configPath;
+    let version;
+    const deps = collectAllDependencies(pkg);
+    if (deps['@biomejs/biome']) {
+        confidence += 70;
+        version = parseVersionString(deps['@biomejs/biome']);
+        sources.push({ type: 'package.json', field: 'dependencies.@biomejs/biome' });
+    }
+    if (exists(join$1(projectPath, 'biome.json'))) {
+        confidence += 30;
+        configPath = 'biome.json';
+        sources.push({ type: 'config-file', path: 'biome.json' });
+    }
+    if (!configPath && exists(join$1(projectPath, 'biome.jsonc'))) {
+        confidence += 30;
+        configPath = 'biome.jsonc';
+        sources.push({ type: 'config-file', path: 'biome.jsonc' });
+    }
+    if (confidence === 0) {
+        return null;
+    }
+    return {
+        id: 'biome',
+        name: 'Biome',
+        version,
+        configPath,
+        confidence: min(confidence, 100),
+        detectedFrom: sources,
+    };
+}
+
 /** Config patterns for ESLint */
 const ESLINT_CONFIG_PATTERNS = [
     'eslint.config.js',
@@ -3162,6 +2887,15 @@ const ESLINT_CONFIG_PATTERNS = [
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting ESLint linter
+ * ```typescript
+ * const result = eslintDetector('/path/to/project', {
+ *   devDependencies: { eslint: '^8.50.0', '@typescript-eslint/parser': '^6.0.0' },
+ *   scripts: { lint: 'eslint src/' },
+ * })
+ * // => { id: 'eslint', name: 'ESLint', confidence: 65, version: '8.50.0', ... }
+ * ```
  */
 function eslintDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3225,6 +2959,15 @@ const PRETTIER_CONFIG_PATTERNS = [
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Prettier formatter
+ * ```typescript
+ * const result = prettierDetector('/path/to/project', {
+ *   devDependencies: { prettier: '^3.0.0' },
+ *   scripts: { format: 'prettier --write .' },
+ * })
+ * // => { id: 'prettier', name: 'Prettier', confidence: 55, version: '3.0.0', ... }
+ * ```
  */
 function prettierDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3287,6 +3030,14 @@ const STYLELINT_CONFIG_PATTERNS = [
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Stylelint linter
+ * ```typescript
+ * const result = stylelintDetector('/path/to/project', {
+ *   devDependencies: { stylelint: '^15.0.0', 'stylelint-config-standard': '^30.0.0' },
+ * })
+ * // => { id: 'stylelint', name: 'Stylelint', confidence: 65, version: '15.0.0', ... }
+ * ```
  */
 function stylelintDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3308,59 +3059,17 @@ function stylelintDetector(projectPath, packageJson) {
             break;
         }
     }
-    const stylelintPlugins = keys(deps).filter((d) => d.startsWith('stylelint-'));
-    if (stylelintPlugins.length > 0) {
-        confidence += 5;
-        sources.push({ type: 'package.json', field: 'dependencies (stylelint plugins)' });
-    }
-    if (confidence === 0) {
-        return null;
-    }
-    return {
-        id: 'stylelint',
-        name: 'Stylelint',
-        version,
-        configPath,
-        confidence: min(confidence, 100),
-        detectedFrom: sources,
-    };
-}
-
-/**
- * Detect Biome in project.
- *
- * @param projectPath - Project directory path
- * @param packageJson - Optional pre-loaded package.json
- * @returns Detection result or null if not detected
- */
-function biomeDetector(projectPath, packageJson) {
-    const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
-    const sources = [];
-    let confidence = 0;
-    let configPath;
-    let version;
-    const deps = collectAllDependencies(pkg);
-    if (deps['@biomejs/biome']) {
-        confidence += 70;
-        version = parseVersionString(deps['@biomejs/biome']);
-        sources.push({ type: 'package.json', field: 'dependencies.@biomejs/biome' });
-    }
-    if (exists(join$1(projectPath, 'biome.json'))) {
-        confidence += 30;
-        configPath = 'biome.json';
-        sources.push({ type: 'config-file', path: 'biome.json' });
-    }
-    if (!configPath && exists(join$1(projectPath, 'biome.jsonc'))) {
-        confidence += 30;
-        configPath = 'biome.jsonc';
-        sources.push({ type: 'config-file', path: 'biome.jsonc' });
+    const stylelintPlugins = keys(deps).filter((d) => d.startsWith('stylelint-'));
+    if (stylelintPlugins.length > 0) {
+        confidence += 5;
+        sources.push({ type: 'package.json', field: 'dependencies (stylelint plugins)' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'biome',
-        name: 'Biome',
+        id: 'stylelint',
+        name: 'Stylelint',
         version,
         configPath,
         confidence: min(confidence, 100),
@@ -3377,140 +3086,179 @@ const lintingDetectors = [
 ];
 
 /**
- * Detect NX in project.
+ * Detect Lerna in project.
  *
  * @param workspacePath - Workspace directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Lerna monorepo
+ * ```typescript
+ * // Project with lerna.json config file
+ * const result = lernaDetector('/path/to/lerna-project')
+ * // => {
+ * //   id: 'lerna',
+ * //   name: 'Lerna',
+ * //   confidence: 80,
+ * //   configPath: 'lerna.json',
+ * //   detectedFrom: [{ type: 'config-file', path: 'lerna.json' }]
+ * // }
+ * ```
  */
-function nxDetector(workspacePath, packageJson) {
+function lernaDetector(workspacePath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(workspacePath);
     const sources = [];
     let confidence = 0;
     let version;
-    let workspaceLayout;
-    const nxJsonPath = join$1(workspacePath, 'nx.json');
-    if (exists(nxJsonPath)) {
-        confidence += 70;
-        sources.push({ type: 'config-file', path: 'nx.json' });
+    let configPath;
+    const lernaJsonPath = join$1(workspacePath, 'lerna.json');
+    if (exists(lernaJsonPath)) {
+        confidence += 80;
+        configPath = 'lerna.json';
+        sources.push({ type: 'config-file', path: 'lerna.json' });
     }
     const deps = collectAllDependencies(pkg);
-    if (deps['nx']) {
-        confidence += 20;
-        version = parseVersionString(deps['nx']);
-        sources.push({ type: 'package.json', field: 'dependencies.nx' });
-    }
-    const hasApps = exists(join$1(workspacePath, 'apps'));
-    const hasLibs = exists(join$1(workspacePath, 'libs'));
-    if (hasApps || hasLibs) {
-        confidence += 10;
-        sources.push({ type: 'directory', path: 'apps/ or libs/' });
-        workspaceLayout = {
-            appsDir: hasApps ? 'apps' : '',
-            libsDir: hasLibs ? 'libs' : '',
-        };
+    if (deps['lerna']) {
+        confidence += 15;
+        version = parseVersionString(deps['lerna']);
+        sources.push({ type: 'package.json', field: 'dependencies.lerna' });
     }
-    const nxPackages = keys(deps).filter((d) => d.startsWith('@nx/') || d.startsWith('@nrwl/'));
-    if (nxPackages.length > 0) {
-        confidence += 10;
-        sources.push({ type: 'package.json', field: '@nx/* packages' });
+    if (exists(join$1(workspacePath, 'packages'))) {
+        confidence += 5;
+        sources.push({ type: 'directory', path: 'packages/' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'nx',
-        name: 'NX',
+        id: 'lerna',
+        name: 'Lerna',
         version,
-        configPath: exists(nxJsonPath) ? 'nx.json' : undefined,
+        configPath,
         confidence: min(confidence, 100),
         detectedFrom: sources,
-        workspaceLayout,
     };
 }
 
 /**
- * Detect Turborepo in project.
+ * Detect npm workspaces in project.
  *
  * @param workspacePath - Workspace directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting npm workspaces
+ * ```typescript
+ * // Project with workspaces in package.json and package-lock.json
+ * const result = npmWorkspacesDetector('/path/to/npm-project')
+ * // => {
+ * //   id: 'npm-workspaces',
+ * //   name: 'npm Workspaces',
+ * //   confidence: 90,
+ * //   configPath: 'package.json',
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'workspaces' },
+ * //     { type: 'lockfile', path: 'package-lock.json' }
+ * //   ]
+ * // }
+ * ```
  */
-function turborepoDetector(workspacePath, packageJson) {
+function npmWorkspacesDetector(workspacePath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(workspacePath);
     const sources = [];
     let confidence = 0;
-    let version;
-    let configPath;
-    const turboJsonPath = join$1(workspacePath, 'turbo.json');
-    if (exists(turboJsonPath)) {
+    if (pkg?.workspaces) {
         confidence += 80;
-        configPath = 'turbo.json';
-        sources.push({ type: 'config-file', path: 'turbo.json' });
+        sources.push({ type: 'package.json', field: 'workspaces' });
     }
-    const deps = collectAllDependencies(pkg);
-    if (deps['turbo']) {
-        confidence += 15;
-        version = parseVersionString(deps['turbo']);
-        sources.push({ type: 'package.json', field: 'dependencies.turbo' });
+    if (exists(join$1(workspacePath, 'package-lock.json'))) {
+        confidence += 10;
+        sources.push({ type: 'lockfile', path: 'package-lock.json' });
     }
-    const scripts = pkg?.scripts ?? {};
-    if (values(scripts).some((s) => s?.includes('turbo'))) {
-        confidence += 5;
-        sources.push({ type: 'package.json', field: 'scripts (turbo commands)' });
+    if (exists(join$1(workspacePath, 'yarn.lock'))) {
+        return null;
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'turborepo',
-        name: 'Turborepo',
-        version,
-        configPath,
+        id: 'npm-workspaces',
+        name: 'npm Workspaces',
+        configPath: 'package.json',
         confidence: min(confidence, 100),
         detectedFrom: sources,
     };
 }
 
 /**
- * Detect Lerna in project.
+ * Detect NX in project.
  *
  * @param workspacePath - Workspace directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting NX workspace
+ * ```typescript
+ * // Project with nx.json and apps/libs directories
+ * const result = nxDetector('/path/to/nx-workspace')
+ * // => {
+ * //   id: 'nx',
+ * //   name: 'NX',
+ * //   confidence: 100,
+ * //   configPath: 'nx.json',
+ * //   version: '17.0.0',
+ * //   workspaceLayout: { appsDir: 'apps', libsDir: 'libs' },
+ * //   detectedFrom: [
+ * //     { type: 'config-file', path: 'nx.json' },
+ * //     { type: 'package.json', field: 'dependencies.nx' },
+ * //     { type: 'directory', path: 'apps/ or libs/' }
+ * //   ]
+ * // }
+ * ```
  */
-function lernaDetector(workspacePath, packageJson) {
+function nxDetector(workspacePath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(workspacePath);
     const sources = [];
     let confidence = 0;
     let version;
-    let configPath;
-    const lernaJsonPath = join$1(workspacePath, 'lerna.json');
-    if (exists(lernaJsonPath)) {
-        confidence += 80;
-        configPath = 'lerna.json';
-        sources.push({ type: 'config-file', path: 'lerna.json' });
+    let workspaceLayout;
+    const nxJsonPath = join$1(workspacePath, 'nx.json');
+    if (exists(nxJsonPath)) {
+        confidence += 70;
+        sources.push({ type: 'config-file', path: 'nx.json' });
     }
     const deps = collectAllDependencies(pkg);
-    if (deps['lerna']) {
-        confidence += 15;
-        version = parseVersionString(deps['lerna']);
-        sources.push({ type: 'package.json', field: 'dependencies.lerna' });
+    if (deps['nx']) {
+        confidence += 20;
+        version = parseVersionString(deps['nx']);
+        sources.push({ type: 'package.json', field: 'dependencies.nx' });
     }
-    if (exists(join$1(workspacePath, 'packages'))) {
-        confidence += 5;
-        sources.push({ type: 'directory', path: 'packages/' });
+    const hasApps = exists(join$1(workspacePath, 'apps'));
+    const hasLibs = exists(join$1(workspacePath, 'libs'));
+    if (hasApps || hasLibs) {
+        confidence += 10;
+        sources.push({ type: 'directory', path: 'apps/ or libs/' });
+        workspaceLayout = {
+            appsDir: hasApps ? 'apps' : '',
+            libsDir: hasLibs ? 'libs' : '',
+        };
+    }
+    const nxPackages = keys(deps).filter((d) => d.startsWith('@nx/') || d.startsWith('@nrwl/'));
+    if (nxPackages.length > 0) {
+        confidence += 10;
+        sources.push({ type: 'package.json', field: '@nx/* packages' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'lerna',
-        name: 'Lerna',
+        id: 'nx',
+        name: 'NX',
         version,
-        configPath,
+        configPath: exists(nxJsonPath) ? 'nx.json' : undefined,
         confidence: min(confidence, 100),
         detectedFrom: sources,
+        workspaceLayout,
     };
 }
 
@@ -3520,6 +3268,19 @@ function lernaDetector(workspacePath, packageJson) {
  * @param workspacePath - Workspace directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Rush monorepo
+ * ```typescript
+ * // Project with rush.json config file
+ * const result = rushDetector('/path/to/rush-project')
+ * // => {
+ * //   id: 'rush',
+ * //   name: 'Rush',
+ * //   confidence: 90,
+ * //   configPath: 'rush.json',
+ * //   detectedFrom: [{ type: 'config-file', path: 'rush.json' }]
+ * // }
+ * ```
  */
 function rushDetector(workspacePath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(workspacePath);
@@ -3557,66 +3318,60 @@ function rushDetector(workspacePath, packageJson) {
 }
 
 /**
- * Detect pnpm workspaces in project.
- *
- * @param workspacePath - Workspace directory path
- * @returns Detection result or null if not detected
- */
-function pnpmWorkspacesDetector(workspacePath) {
-    const sources = [];
-    let confidence = 0;
-    let configPath;
-    const pnpmWorkspacePath = join$1(workspacePath, 'pnpm-workspace.yaml');
-    if (exists(pnpmWorkspacePath)) {
-        confidence += 90;
-        configPath = 'pnpm-workspace.yaml';
-        sources.push({ type: 'config-file', path: 'pnpm-workspace.yaml' });
-    }
-    if (exists(join$1(workspacePath, 'pnpm-lock.yaml'))) {
-        confidence += 10;
-        sources.push({ type: 'lockfile', path: 'pnpm-lock.yaml' });
-    }
-    if (confidence === 0) {
-        return null;
-    }
-    return {
-        id: 'pnpm-workspaces',
-        name: 'pnpm Workspaces',
-        configPath,
-        confidence: min(confidence, 100),
-        detectedFrom: sources,
-    };
-}
-
-/**
- * Detect npm workspaces in project.
+ * Detect Turborepo in project.
  *
  * @param workspacePath - Workspace directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Turborepo monorepo
+ * ```typescript
+ * // Project with turbo.json and turbo dependency
+ * const result = turborepoDetector('/path/to/turbo-project')
+ * // => {
+ * //   id: 'turborepo',
+ * //   name: 'Turborepo',
+ * //   confidence: 95,
+ * //   configPath: 'turbo.json',
+ * //   version: '2.0.0',
+ * //   detectedFrom: [
+ * //     { type: 'config-file', path: 'turbo.json' },
+ * //     { type: 'package.json', field: 'dependencies.turbo' }
+ * //   ]
+ * // }
+ * ```
  */
-function npmWorkspacesDetector(workspacePath, packageJson) {
+function turborepoDetector(workspacePath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(workspacePath);
     const sources = [];
     let confidence = 0;
-    if (pkg?.workspaces) {
+    let version;
+    let configPath;
+    const turboJsonPath = join$1(workspacePath, 'turbo.json');
+    if (exists(turboJsonPath)) {
         confidence += 80;
-        sources.push({ type: 'package.json', field: 'workspaces' });
+        configPath = 'turbo.json';
+        sources.push({ type: 'config-file', path: 'turbo.json' });
     }
-    if (exists(join$1(workspacePath, 'package-lock.json'))) {
-        confidence += 10;
-        sources.push({ type: 'lockfile', path: 'package-lock.json' });
+    const deps = collectAllDependencies(pkg);
+    if (deps['turbo']) {
+        confidence += 15;
+        version = parseVersionString(deps['turbo']);
+        sources.push({ type: 'package.json', field: 'dependencies.turbo' });
     }
-    if (exists(join$1(workspacePath, 'yarn.lock'))) {
-        return null;
+    const scripts = pkg?.scripts ?? {};
+    if (values(scripts).some((s) => s?.includes('turbo'))) {
+        confidence += 5;
+        sources.push({ type: 'package.json', field: 'scripts (turbo commands)' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'npm-workspaces',
-        name: 'npm Workspaces',
-        configPath: 'package.json',
+        id: 'turborepo',
+        name: 'Turborepo',
+        version,
+        configPath,
         confidence: min(confidence, 100),
         detectedFrom: sources,
     };
@@ -3628,6 +3383,23 @@ function npmWorkspacesDetector(workspacePath, packageJson) {
  * @param workspacePath - Workspace directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting yarn workspaces
+ * ```typescript
+ * // Project with workspaces in package.json and yarn.lock
+ * const result = yarnWorkspacesDetector('/path/to/yarn-project')
+ * // => {
+ * //   id: 'yarn-workspaces',
+ * //   name: 'Yarn Workspaces',
+ * //   confidence: 100,
+ * //   configPath: 'package.json',
+ * //   detectedFrom: [
+ * //     { type: 'package.json', field: 'workspaces' },
+ * //     { type: 'lockfile', path: 'yarn.lock' },
+ * //     { type: 'config-file', path: '.yarnrc.yml' }
+ * //   ]
+ * // }
+ * ```
  */
 function yarnWorkspacesDetector(workspacePath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(workspacePath);
@@ -3668,107 +3440,125 @@ const monorepoDetectors = [
     { id: 'yarn-workspaces', name: 'Yarn Workspaces', detect: yarnWorkspacesDetector },
 ];
 
-/** Config patterns for Jest */
-const JEST_CONFIG_PATTERNS = ['jest.config.js', 'jest.config.ts', 'jest.config.mjs', 'jest.config.cjs', 'jest.config.json'];
+/** Config patterns for Cypress */
+const CYPRESS_CONFIG_PATTERNS = ['cypress.config.js', 'cypress.config.ts', 'cypress.config.mjs', 'cypress.json'];
 /**
- * Detect Jest in project.
+ * Detect Cypress in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Cypress testing framework
+ * ```typescript
+ * import { cypressDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = cypressDetector('./my-project')
+ * if (result) {
+ *   console.log(`Cypress ${result.version} detected (${result.confidence}% confidence)`)
+ *   // => "Cypress 13.6.0 detected (95% confidence)"
+ * }
+ * ```
  */
-function jestDetector(projectPath, packageJson) {
+function cypressDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['jest']) {
+    if (deps['cypress']) {
         confidence += 60;
-        version = parseVersionString(deps['jest']);
-        sources.push({ type: 'package.json', field: 'dependencies.jest' });
+        version = parseVersionString(deps['cypress']);
+        sources.push({ type: 'package.json', field: 'dependencies.cypress' });
     }
-    const configPath = locateConfigFile(projectPath, JEST_CONFIG_PATTERNS);
+    const configPath = locateConfigFile(projectPath, CYPRESS_CONFIG_PATTERNS);
     if (configPath) {
         confidence += 30;
         sources.push({ type: 'config-file', path: configPath });
     }
-    if (pkg && 'jest' in pkg) {
-        confidence += 20;
-        sources.push({ type: 'package.json', field: 'jest' });
-    }
-    const testScript = pkg?.scripts?.['test'] ?? '';
-    if (testScript.includes('jest')) {
+    if (exists(join$1(projectPath, 'cypress'))) {
         confidence += 10;
-        sources.push({ type: 'package.json', field: 'scripts.test' });
-    }
-    if (deps['@types/jest']) {
-        confidence += 5;
-        sources.push({ type: 'package.json', field: 'dependencies.@types/jest' });
+        sources.push({ type: 'directory', path: 'cypress/' });
     }
-    if (deps['ts-jest']) {
+    const e2eScript = pkg?.scripts?.['e2e'] ?? pkg?.scripts?.['test:e2e'] ?? '';
+    if (e2eScript.includes('cypress')) {
         confidence += 5;
-        sources.push({ type: 'package.json', field: 'dependencies.ts-jest' });
+        sources.push({ type: 'package.json', field: 'scripts.e2e or scripts.test:e2e' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'jest',
-        name: 'Jest',
-        type: 'unit',
+        id: 'cypress',
+        name: 'Cypress',
+        type: 'e2e',
         version,
         configPath,
         confidence: min(confidence, 100),
         detectedFrom: sources,
     };
 }
-
-/** Config patterns for Vitest */
-const VITEST_CONFIG_PATTERNS = ['vitest.config.js', 'vitest.config.ts', 'vitest.config.mjs'];
+
+/** Config patterns for Jest */
+const JEST_CONFIG_PATTERNS = ['jest.config.js', 'jest.config.ts', 'jest.config.mjs', 'jest.config.cjs', 'jest.config.json'];
 /**
- * Detect Vitest in project.
+ * Detect Jest in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Jest testing framework
+ * ```typescript
+ * import { jestDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = jestDetector('./my-project')
+ * if (result) {
+ *   console.log(`Jest ${result.version} detected`)
+ *   console.log('Sources:', result.detectedFrom.map(s => s.type))
+ *   // => "Sources: ['package.json', 'config-file']"
+ * }
+ * ```
  */
-function vitestDetector(projectPath, packageJson) {
+function jestDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['vitest']) {
-        confidence += 70;
-        version = parseVersionString(deps['vitest']);
-        sources.push({ type: 'package.json', field: 'dependencies.vitest' });
+    if (deps['jest']) {
+        confidence += 60;
+        version = parseVersionString(deps['jest']);
+        sources.push({ type: 'package.json', field: 'dependencies.jest' });
     }
-    const configPath = locateConfigFile(projectPath, VITEST_CONFIG_PATTERNS);
+    const configPath = locateConfigFile(projectPath, JEST_CONFIG_PATTERNS);
     if (configPath) {
-        confidence += 25;
+        confidence += 30;
         sources.push({ type: 'config-file', path: configPath });
     }
-    if (!configPath) {
-        const viteConfig = exists(join$1(projectPath, 'vite.config.ts')) ||
-            exists(join$1(projectPath, 'vite.config.js')) ||
-            exists(join$1(projectPath, 'vite.config.mjs'));
-        if (viteConfig && deps['vitest']) {
-            confidence += 5;
-            sources.push({ type: 'config-file', path: 'vite.config.*' });
-        }
+    if (pkg && 'jest' in pkg) {
+        confidence += 20;
+        sources.push({ type: 'package.json', field: 'jest' });
     }
     const testScript = pkg?.scripts?.['test'] ?? '';
-    if (testScript.includes('vitest')) {
+    if (testScript.includes('jest')) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'scripts.test' });
     }
+    if (deps['@types/jest']) {
+        confidence += 5;
+        sources.push({ type: 'package.json', field: 'dependencies.@types/jest' });
+    }
+    if (deps['ts-jest']) {
+        confidence += 5;
+        sources.push({ type: 'package.json', field: 'dependencies.ts-jest' });
+    }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'vitest',
-        name: 'Vitest',
+        id: 'jest',
+        name: 'Jest',
         type: 'unit',
         version,
         configPath,
@@ -3785,6 +3575,17 @@ const MOCHA_CONFIG_PATTERNS = ['.mocharc.js', '.mocharc.json', '.mocharc.yaml',
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Mocha testing framework
+ * ```typescript
+ * import { mochaDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = mochaDetector('./my-project')
+ * if (result) {
+ *   console.log(`Mocha ${result.version} detected (${result.confidence}%)`)
+ *   // => "Mocha 10.2.0 detected (95%)"
+ * }
+ * ```
  */
 function mochaDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -3829,37 +3630,53 @@ function mochaDetector(projectPath, packageJson) {
     };
 }
 
-/** Config patterns for Cypress */
-const CYPRESS_CONFIG_PATTERNS = ['cypress.config.js', 'cypress.config.ts', 'cypress.config.mjs', 'cypress.json'];
+/** Config patterns for Playwright */
+const PLAYWRIGHT_CONFIG_PATTERNS = ['playwright.config.js', 'playwright.config.ts', 'playwright.config.mjs'];
 /**
- * Detect Cypress in project.
+ * Detect Playwright in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Playwright testing framework
+ * ```typescript
+ * import { playwrightDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = playwrightDetector('./my-project')
+ * if (result) {
+ *   console.log(`Playwright ${result.version} (${result.type} tests)`)
+ *   // => "Playwright 1.42.0 (e2e tests)"
+ * }
+ * ```
  */
-function cypressDetector(projectPath, packageJson) {
+function playwrightDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['cypress']) {
-        confidence += 60;
-        version = parseVersionString(deps['cypress']);
-        sources.push({ type: 'package.json', field: 'dependencies.cypress' });
+    if (deps['@playwright/test']) {
+        confidence += 70;
+        version = parseVersionString(deps['@playwright/test']);
+        sources.push({ type: 'package.json', field: 'dependencies.@playwright/test' });
     }
-    const configPath = locateConfigFile(projectPath, CYPRESS_CONFIG_PATTERNS);
+    if (deps['playwright']) {
+        confidence += 50;
+        version = version ?? parseVersionString(deps['playwright']);
+        sources.push({ type: 'package.json', field: 'dependencies.playwright' });
+    }
+    const configPath = locateConfigFile(projectPath, PLAYWRIGHT_CONFIG_PATTERNS);
     if (configPath) {
-        confidence += 30;
+        confidence += 25;
         sources.push({ type: 'config-file', path: configPath });
     }
-    if (exists(join$1(projectPath, 'cypress'))) {
-        confidence += 10;
-        sources.push({ type: 'directory', path: 'cypress/' });
+    if (exists(join$1(projectPath, 'e2e')) || exists(join$1(projectPath, 'tests'))) {
+        confidence += 5;
+        sources.push({ type: 'directory', path: 'e2e/ or tests/' });
     }
     const e2eScript = pkg?.scripts?.['e2e'] ?? pkg?.scripts?.['test:e2e'] ?? '';
-    if (e2eScript.includes('cypress')) {
+    if (e2eScript.includes('playwright')) {
         confidence += 5;
         sources.push({ type: 'package.json', field: 'scripts.e2e or scripts.test:e2e' });
     }
@@ -3867,8 +3684,8 @@ function cypressDetector(projectPath, packageJson) {
         return null;
     }
     return {
-        id: 'cypress',
-        name: 'Cypress',
+        id: 'playwright',
+        name: 'Playwright',
         type: 'e2e',
         version,
         configPath,
@@ -3877,52 +3694,64 @@ function cypressDetector(projectPath, packageJson) {
     };
 }
 
-/** Config patterns for Playwright */
-const PLAYWRIGHT_CONFIG_PATTERNS = ['playwright.config.js', 'playwright.config.ts', 'playwright.config.mjs'];
+/** Config patterns for Vitest */
+const VITEST_CONFIG_PATTERNS = ['vitest.config.js', 'vitest.config.ts', 'vitest.config.mjs'];
 /**
- * Detect Playwright in project.
+ * Detect Vitest in project.
  *
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Vitest testing framework
+ * ```typescript
+ * import { vitestDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = vitestDetector('./my-project')
+ * if (result) {
+ *   console.log(`Vitest ${result.version} detected`)
+ *   console.log('Config:', result.configPath)
+ *   // => "Config: vitest.config.ts"
+ * }
+ * ```
  */
-function playwrightDetector(projectPath, packageJson) {
+function vitestDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
     const sources = [];
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    if (deps['@playwright/test']) {
+    if (deps['vitest']) {
         confidence += 70;
-        version = parseVersionString(deps['@playwright/test']);
-        sources.push({ type: 'package.json', field: 'dependencies.@playwright/test' });
-    }
-    if (deps['playwright']) {
-        confidence += 50;
-        version = version ?? parseVersionString(deps['playwright']);
-        sources.push({ type: 'package.json', field: 'dependencies.playwright' });
+        version = parseVersionString(deps['vitest']);
+        sources.push({ type: 'package.json', field: 'dependencies.vitest' });
     }
-    const configPath = locateConfigFile(projectPath, PLAYWRIGHT_CONFIG_PATTERNS);
+    const configPath = locateConfigFile(projectPath, VITEST_CONFIG_PATTERNS);
     if (configPath) {
         confidence += 25;
         sources.push({ type: 'config-file', path: configPath });
     }
-    if (exists(join$1(projectPath, 'e2e')) || exists(join$1(projectPath, 'tests'))) {
-        confidence += 5;
-        sources.push({ type: 'directory', path: 'e2e/ or tests/' });
+    if (!configPath) {
+        const viteConfig = exists(join$1(projectPath, 'vite.config.ts')) ||
+            exists(join$1(projectPath, 'vite.config.js')) ||
+            exists(join$1(projectPath, 'vite.config.mjs'));
+        if (viteConfig && deps['vitest']) {
+            confidence += 5;
+            sources.push({ type: 'config-file', path: 'vite.config.*' });
+        }
     }
-    const e2eScript = pkg?.scripts?.['e2e'] ?? pkg?.scripts?.['test:e2e'] ?? '';
-    if (e2eScript.includes('playwright')) {
-        confidence += 5;
-        sources.push({ type: 'package.json', field: 'scripts.e2e or scripts.test:e2e' });
+    const testScript = pkg?.scripts?.['test'] ?? '';
+    if (testScript.includes('vitest')) {
+        confidence += 10;
+        sources.push({ type: 'package.json', field: 'scripts.test' });
     }
     if (confidence === 0) {
         return null;
     }
     return {
-        id: 'playwright',
-        name: 'Playwright',
-        type: 'e2e',
+        id: 'vitest',
+        name: 'Vitest',
+        type: 'unit',
         version,
         configPath,
         confidence: min(confidence, 100),
@@ -3952,7 +3781,7 @@ function checkTsConfigStrict(projectPath) {
         return undefined;
     try {
         const cleanContent = content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '');
-        const parsed = parse(cleanContent);
+        const parsed = parse$1(cleanContent);
         return parsed?.compilerOptions?.strict === true;
     }
     catch {
@@ -3965,6 +3794,19 @@ function checkTsConfigStrict(projectPath) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting TypeScript
+ * ```typescript
+ * import { typescriptDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = typescriptDetector('./my-project')
+ * if (result) {
+ *   console.log(`TypeScript ${result.version}`)
+ *   console.log(`Strict mode: ${result.strictMode ?? 'unknown'}`)
+ *   // => "TypeScript 5.3.0"
+ *   // => "Strict mode: true"
+ * }
+ * ```
  */
 function typescriptDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -4016,6 +3858,17 @@ function typescriptDetector(projectPath, packageJson) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting Flow type system
+ * ```typescript
+ * import { flowDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = flowDetector('./my-project')
+ * if (result) {
+ *   console.log(`Flow ${result.version} with config: ${result.configPath}`)
+ *   // => "Flow 0.232.0 with config: .flowconfig"
+ * }
+ * ```
  */
 function flowDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -4073,6 +3926,18 @@ function hasJsDocTypes(content) {
  * @param projectPath - Project directory path
  * @param packageJson - Optional pre-loaded package.json
  * @returns Detection result or null if not detected
+ *
+ * @example Detecting JSDoc type annotations
+ * ```typescript
+ * import { jsdocDetector } from '@hyperfrontend/project-scope'
+ *
+ * const result = jsdocDetector('./my-project')
+ * if (result) {
+ *   console.log('JSDoc types detected')
+ *   console.log('Sources:', result.detectedFrom.map(s => s.path ?? s.field))
+ *   // => "Sources: ['jsconfig.json', 'src/utils.js (JSDoc annotations)']"
+ * }
+ * ```
  */
 function jsdocDetector(projectPath, packageJson) {
     const pkg = packageJson ?? readPackageJsonIfExists(projectPath);
@@ -4089,7 +3954,7 @@ function jsdocDetector(projectPath, packageJson) {
         if (content) {
             try {
                 const cleanContent = content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '');
-                const parsed = parse(cleanContent);
+                const parsed = parse$1(cleanContent);
                 if (parsed?.compilerOptions?.checkJs === true || parsed?.compilerOptions?.allowJs === true) {
                     confidence += 30;
                     sources.push({ type: 'config-file', path: 'tsconfig.json (checkJs/allowJs)' });
@@ -4166,7 +4031,7 @@ function isDetectAllOptions(value) {
  * @param packageJsonOrOptions - Optional pre-loaded package.json or options object
  * @returns All detection results organized by category
  *
- * @example
+ * @example Running all tech detectors
  * ```typescript
  * import { detectAll } from '@hyperfrontend/project-scope'
  *
@@ -4258,7 +4123,7 @@ const projectTypeLogger = createScopedLogger('project-scope:heuristics:project-t
  * @param options - Detection options
  * @returns Project type detection result with confidence score
  *
- * @example
+ * @example Detecting project type
  * ```typescript
  * import { detectProjectType } from '@hyperfrontend/project-scope'
  *
@@ -4376,7 +4241,7 @@ function detectProjectType(projectPath, options) {
     const projectJsonContent = readFileIfExists(projectJsonPath);
     if (projectJsonContent) {
         try {
-            const projectJson = parse(projectJsonContent);
+            const projectJson = parse$1(projectJsonContent);
             if (projectJson.projectType) {
                 const nxType = projectJson.projectType === 'library' ? 'library' : 'application';
                 typeScores[nxType] += 50;
@@ -4436,6 +4301,15 @@ createScopedLogger('project-scope:root');
  * @param startPath - Starting path
  * @param markers - Files to search for
  * @returns Root directory path or null
+ *
+ * @example Finding root by marker files
+ * ```typescript
+ * import { findRootDirectory } from '@hyperfrontend/project-scope'
+ *
+ * // Find monorepo root by looking for nx.json or lerna.json
+ * const root = findRootDirectory('./libs/my-lib', ['nx.json', 'lerna.json'])
+ * // => '/path/to/monorepo'
+ * ```
  */
 function findRootDirectory(startPath, markers) {
     return locateByMarkers(startPath, markers);
@@ -4452,7 +4326,7 @@ const NX_CONFIG_FILES = ['nx.json', 'workspace.json'];
  * @param path - Directory path to check
  * @returns True if the directory contains nx.json or workspace.json
  *
- * @example
+ * @example Checking for NX workspace
  * ```typescript
  * import { isNxWorkspace } from '@hyperfrontend/project-scope'
  *
@@ -4477,7 +4351,7 @@ function isNxWorkspace(path) {
  * @param startPath - Starting path to search from
  * @returns Workspace root path or null if not found
  *
- * @example
+ * @example Finding NX workspace root
  * ```typescript
  * import { findNxWorkspaceRoot } from '@hyperfrontend/project-scope'
  *
@@ -4499,178 +4373,8 @@ function findNxWorkspaceRoot(startPath) {
     return result;
 }
 
-createScopedLogger('project-scope:nx:devkit');
-
 createScopedLogger('project-scope:nx:config');
 
-/**
- * Known configuration file patterns organized by type.
- */
-const CONFIG_PATTERNS = {
-    'package.json': {
-        patterns: ['package.json'],
-        format: 'json',
-        description: 'NPM package manifest',
-    },
-    'package-lock.json': {
-        patterns: ['package-lock.json'],
-        format: 'json',
-        description: 'NPM lockfile',
-    },
-    'pnpm-lock.yaml': {
-        patterns: ['pnpm-lock.yaml'],
-        format: 'yaml',
-        description: 'PNPM lockfile',
-    },
-    'yarn.lock': {
-        patterns: ['yarn.lock'],
-        format: 'text',
-        description: 'Yarn lockfile',
-    },
-    '.npmrc': {
-        patterns: ['.npmrc'],
-        format: 'ini',
-        description: 'NPM configuration',
-        sensitive: true,
-    },
-    tsconfig: {
-        patterns: ['tsconfig.json', 'tsconfig.*.json'],
-        format: 'jsonc',
-        description: 'TypeScript configuration',
-        canExtend: true,
-    },
-    nx: {
-        patterns: ['nx.json'],
-        format: 'json',
-        description: 'NX workspace configuration',
-    },
-    'project.json': {
-        patterns: ['project.json', '**/project.json'],
-        format: 'json',
-        description: 'NX project configuration',
-    },
-    'workspace.json': {
-        patterns: ['workspace.json'],
-        format: 'json',
-        description: 'NX workspace projects (deprecated)',
-    },
-    turbo: {
-        patterns: ['turbo.json'],
-        format: 'jsonc',
-        description: 'TurboRepo configuration',
-    },
-    lerna: {
-        patterns: ['lerna.json'],
-        format: 'json',
-        description: 'Lerna configuration',
-    },
-    webpack: {
-        patterns: ['webpack.config.js', 'webpack.config.ts', 'webpack.config.cjs', 'webpack.config.mjs'],
-        format: 'js',
-        description: 'Webpack configuration',
-    },
-    rollup: {
-        patterns: ['rollup.config.js', 'rollup.config.ts', 'rollup.config.mjs'],
-        format: 'js',
-        description: 'Rollup configuration',
-    },
-    vite: {
-        patterns: ['vite.config.js', 'vite.config.ts', 'vite.config.mjs'],
-        format: 'js',
-        description: 'Vite configuration',
-    },
-    esbuild: {
-        patterns: ['esbuild.config.js', 'esbuild.config.ts', 'esbuild.config.mjs'],
-        format: 'js',
-        description: 'esbuild configuration',
-    },
-    babel: {
-        patterns: ['babel.config.js', 'babel.config.json', '.babelrc', '.babelrc.js', '.babelrc.json'],
-        format: 'json',
-        description: 'Babel configuration',
-    },
-    swc: {
-        patterns: ['.swcrc'],
-        format: 'json',
-        description: 'SWC configuration',
-    },
-    jest: {
-        patterns: ['jest.config.js', 'jest.config.ts', 'jest.config.mjs'],
-        description: 'Jest configuration',
-    },
-    vitest: {
-        patterns: ['vitest.config.js', 'vitest.config.ts'],
-        description: 'Vitest configuration',
-    },
-    cypress: {
-        patterns: ['cypress.config.js', 'cypress.config.ts'],
-        description: 'Cypress configuration',
-    },
-    playwright: {
-        patterns: ['playwright.config.js', 'playwright.config.ts'],
-        description: 'Playwright configuration',
-    },
-    next: {
-        patterns: ['next.config.js', 'next.config.mjs', 'next.config.ts'],
-        format: 'js',
-        description: 'Next.js configuration',
-    },
-    angular: {
-        patterns: ['angular.json'],
-        format: 'json',
-        description: 'Angular CLI configuration',
-    },
-    nuxt: {
-        patterns: ['nuxt.config.js', 'nuxt.config.ts'],
-        format: 'js',
-        description: 'Nuxt.js configuration',
-    },
-    svelte: {
-        patterns: ['svelte.config.js', 'svelte.config.ts'],
-        format: 'js',
-        description: 'SvelteKit configuration',
-    },
-    astro: {
-        patterns: ['astro.config.js', 'astro.config.ts', 'astro.config.mjs'],
-        format: 'js',
-        description: 'Astro configuration',
-    },
-    eslint: {
-        patterns: [
-            'eslint.config.js',
-            'eslint.config.cjs',
-            'eslint.config.mjs',
-            '.eslintrc',
-            '.eslintrc.js',
-            '.eslintrc.json',
-            '.eslintrc.yml',
-        ],
-        format: 'js',
-        description: 'ESLint configuration',
-    },
-    prettier: {
-        patterns: ['prettier.config.js', 'prettier.config.cjs', '.prettierrc', '.prettierrc.js', '.prettierrc.json', '.prettierrc.yml'],
-        format: 'json',
-        description: 'Prettier configuration',
-    },
-    env: {
-        patterns: ['.env', '.env.*', '*.env'],
-        format: 'dotenv',
-        description: 'Environment variables',
-        sensitive: true,
-    },
-    '.gitignore': {
-        patterns: ['.gitignore'],
-        format: 'text',
-        description: 'Git ignore patterns',
-    },
-    '.gitattributes': {
-        patterns: ['.gitattributes'],
-        format: 'text',
-        description: 'Git attributes',
-    },
-};
-
 const configLogger = createScopedLogger('project-scope:config');
 /**
  * Cache for config detection results.
@@ -4688,7 +4392,7 @@ const configDetectionCache = createCache({ ttl: 30000, maxSize: 50 });
  * @param options - Detection options
  * @returns Array of detected configuration files
  *
- * @example
+ * @example Detecting configuration files
  * ```typescript
  * import { detectConfigs } from '@hyperfrontend/project-scope'
  *
@@ -4765,25 +4469,6 @@ function detectConfigs(rootPath, types, options) {
     return results;
 }
 
-/**
- * Safe copies of Number built-in methods and constants.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/number
- */
-const _parseInt = globalThis.parseInt;
-const _parseFloat = globalThis.parseFloat;
-/**
- * (Safe copy) Parses a string and returns an integer.
- */
-const parseInt = _parseInt;
-/**
- * (Safe copy) Parses a string and returns a floating point number.
- */
-const parseFloat = _parseFloat;
-
 /**
  * Detect config type from file name.
  * Uses safe character-by-character matching to prevent ReDoS attacks.
@@ -4995,11 +4680,23 @@ function parseDotenv(content) {
  * @param type - Category of configuration (e.g., typescript, eslint)
  * @param format - Whether to strip comments (jsonc) or parse strictly (json)
  * @returns Configuration object with parsed data and extends references
+ *
+ * @example Parsing JSON configuration
+ * ```typescript
+ * import { parseJsonConfig } from '@hyperfrontend/project-scope'
+ *
+ * const config = parseJsonConfig(
+ *   'tsconfig.json',
+ *   '{ "extends": "./base.json", "compilerOptions": {} }',
+ *   'typescript'
+ * )
+ * // => { type: 'typescript', path: 'tsconfig.json', data: {...}, extends: ['./base.json'] }
+ * ```
  */
 function parseJsonConfig(filePath, content, type, format = 'json') {
     const cleanContent = format === 'jsonc' ? stripJsonComments(content) : content;
     try {
-        const data = parse(cleanContent);
+        const data = parse$1(cleanContent);
         let extendsPath;
         if (typeof data['extends'] === 'string') {
             extendsPath = [data['extends']];
@@ -5030,6 +4727,14 @@ function parseJsonConfig(filePath, content, type, format = 'json') {
  * @param content - Raw file content to parse
  * @param type - Category of configuration (e.g., github-actions, docker-compose)
  * @returns Configuration object with parsed YAML data
+ *
+ * @example Parsing YAML configuration
+ * ```typescript
+ * import { parseYamlConfig } from '@hyperfrontend/project-scope'
+ *
+ * const config = parseYamlConfig('.github/workflows/ci.yml', yamlContent, 'github-actions')
+ * // => { type: 'github-actions', path: '...', format: 'yaml', data: {...} }
+ * ```
  */
 function parseYamlConfig(filePath, content, type) {
     const data = parseSimpleYaml(content);
@@ -5046,6 +4751,14 @@ function parseYamlConfig(filePath, content, type) {
  * @param filePath - Path to config file
  * @param type - Optional config type (auto-detected if not provided)
  * @returns Parsed configuration
+ *
+ * @example Parsing a configuration file
+ * ```typescript
+ * import { parseConfig } from '@hyperfrontend/project-scope'
+ *
+ * const tsConfig = parseConfig('/project/tsconfig.json')
+ * const eslintConfig = parseConfig('/project/.eslintrc.yml', 'eslint')
+ * ```
  */
 function parseConfig(filePath, type) {
     const content = readFileContent(filePath);
@@ -5178,7 +4891,7 @@ function normalizeConfigFormat(format) {
  * @param options - Analysis options
  * @returns Complete analysis result
  *
- * @example
+ * @example Basic project analysis
  * ```typescript
  * const result = analyzeProject('./my-project')
  * console.log(result.projectType) // 'application' | 'library' | ...
@@ -5511,6 +5224,26 @@ function parseAnalyzeArgs(args) {
  *
  * @param options - Configuration for the analyze operation
  * @returns Command execution result with exit code and output
+ *
+ * @example Basic analysis of current directory
+ * ```typescript
+ * const result = analyzeCommand({ depth: 'basic' })
+ * if (result.exitCode === 0) {
+ *   console.log(result.output)
+ *   // => "Project Type: Library\nWorkspace: NX Monorepo\n..."
+ * }
+ * ```
+ *
+ * @example JSON output with filters
+ * ```typescript
+ * const result = analyzeCommand({
+ *   path: './apps/frontend',
+ *   format: 'json',
+ *   depth: 'deep',
+ *   exclude: ['node_modules', 'dist'],
+ * })
+ * // => { exitCode: 0, output: '{"type":"application",...}' }
+ * ```
  */
 function analyzeCommand(options) {
     const projectPath = options.path ? resolve(options.path) : process.cwd();
@@ -5790,6 +5523,26 @@ function parseConfigArgs(args) {
  *
  * @param options - Configuration command options
  * @returns Command execution result with exit code and output
+ *
+ * @example Detect all configs in a project
+ * ```typescript
+ * const result = configCommand({ path: './my-project' })
+ * if (result.exitCode === 0) {
+ *   console.log(result.output)
+ *   // => "TypeScript: tsconfig.json\nLinting: eslint.config.js\n..."
+ * }
+ * ```
+ *
+ * @example Filter by type with contents
+ * ```typescript
+ * const result = configCommand({
+ *   path: './my-project',
+ *   type: 'tsconfig',
+ *   showContents: true,
+ *   format: 'json',
+ * })
+ * // => { exitCode: 0, output: '[{"type":"tsconfig","path":"tsconfig.json",...}]' }
+ * ```
  */
 function configCommand(options) {
     const projectPath = options.path ? resolve(options.path) : process.cwd();
@@ -5999,6 +5752,25 @@ function parseDepsArgs(args) {
  *
  * @param options - Parsed command options
  * @returns Command execution result with exit code and output
+ *
+ * @example List all dependencies
+ * ```typescript
+ * const result = depsCommand({ path: './my-project' })
+ * if (result.exitCode === 0) {
+ *   console.log(result.output)
+ *   // => "Dependencies\n============\nProduction (3):\n  react  ^18.2.0\n..."
+ * }
+ * ```
+ *
+ * @example Filter to dev dependencies as JSON
+ * ```typescript
+ * const result = depsCommand({
+ *   path: './my-project',
+ *   type: 'development',
+ *   format: 'json',
+ * })
+ * // => { exitCode: 0, output: '{"devDependencies":{"typescript":"^5.0.0",...}}' }
+ * ```
  */
 function depsCommand(options) {
     const projectPath = options.path ? resolve(options.path) : process.cwd();
@@ -6275,6 +6047,27 @@ function parseTreeArgs(args) {
  *
  * @param options - Configuration for the tree operation
  * @returns Command execution result with exit code and output
+ *
+ * @example Basic tree of current directory
+ * ```typescript
+ * const result = treeCommand({ depth: 2 })
+ * if (result.exitCode === 0) {
+ *   console.log(result.output)
+ *   // => "src/\n├── index.ts\n├── lib/\n│   └── utils.ts\n..."
+ * }
+ * ```
+ *
+ * @example Directories only with metadata
+ * ```typescript
+ * const result = treeCommand({
+ *   path: './project',
+ *   dirsOnly: true,
+ *   showSize: true,
+ *   ignore: ['node_modules', '.git'],
+ *   format: 'json',
+ * })
+ * // => { exitCode: 0, output: '[{"name":"src","isDirectory":true,...}]' }
+ * ```
  */
 function treeCommand(options) {
     const rootPath = options.path ? resolve(options.path) : process.cwd();
@@ -6432,7 +6225,7 @@ function parseGlobalOptions(args) {
  * @param args - Command line arguments (typically process.argv.slice(2))
  * @returns Command result with exit code and optional output/error
  *
- * @example
+ * @example Running analysis via CLI
  * ```typescript
  * import { run } from '@hyperfrontend/project-scope'
  *
@@ -6493,4 +6286,3 @@ function run(args) {
 }
 
 export { analyzeCommand, analyzeCommandDef, configCommand, configCommandDef, depsCommand, depsCommandDef, run, treeCommand, treeCommandDef };
-//# sourceMappingURL=index.esm.js.map