@bleedingdev/modern-js-code-tools 3.9.0-ultramodern.17 → 3.9.0-ultramodern.18

package/dist/esm/microvertical-api-baseline.js

@@ -1,35 +1,13 @@
-import node_fs from "node:fs";
-import { createRequire } from "node:module";
-import node_path from "node:path";
-import { exports as external_resolve_exports_exports } from "resolve.exports";
 import { baselinePublicIdentityIsExact } from "./microvertical-api-owner.js";
-import { SourceSyntaxError, parseSource, traverseSource, unwrapExpression } from "./source-analysis.js";
+import { createModuleGraph, exportedConst, localConst, propertyName } from "./module-graph.js";
+import { SourceSyntaxError, unwrapExpression } from "./source-analysis.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
-function parseConsumer(filePath) {
-    if (node_fs.statSync(filePath).size > 1000000) throw new Error(`${filePath}: consumer source exceeds 1 MB analysis budget`);
-    const file = parseSource(node_fs.readFileSync(filePath, 'utf8'), filePath);
-    traverseSource(file, {
-        AssignmentExpression (p) {
-            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
-        },
-        UpdateExpression (p) {
-            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
-        },
-        TSModuleDeclaration () {
-            throw new SourceSyntaxError('contract bindings must not be merged with namespaces');
-        }
-    });
-    return file;
-}
 const camelCaseStem = (stem)=>stem.replaceAll(/-([a-z0-9])/gu, (_match, letter)=>letter.toUpperCase());
 const pascalCaseStem = (stem)=>{
     const camelStem = camelCaseStem(stem);
     return `${camelStem.slice(0, 1).toUpperCase()}${camelStem.slice(1)}`;
 };
 const identifierName = (node)=>void 0 !== node && __rspack_external__babel_types_6e8337dd.isIdentifier(node) ? node.name : void 0;
-const propertyName = (node)=>{
-    if (void 0 !== node && (__rspack_external__babel_types_6e8337dd.isIdentifier(node) || __rspack_external__babel_types_6e8337dd.isStringLiteral(node) || __rspack_external__babel_types_6e8337dd.isNumericLiteral(node))) return __rspack_external__babel_types_6e8337dd.isIdentifier(node) ? node.name : String(node.value);
-};
 const accessPath = (node)=>{
     if (__rspack_external__babel_types_6e8337dd.isIdentifier(node)) return [
         node.name
@@ -58,201 +36,6 @@ const callExpression = (expression, callee)=>{
     const unwrapped = unwrapExpression(expression);
     return __rspack_external__babel_types_6e8337dd.isCallExpression(unwrapped) && isAccessPath(unwrapped.callee, callee) ? unwrapped : void 0;
 };
-const localConst = (sourceFile, name)=>{
-    for (const item of sourceFile.program.body){
-        const statement = __rspack_external__babel_types_6e8337dd.isExportNamedDeclaration(item) ? item.declaration : item;
-        if (!__rspack_external__babel_types_6e8337dd.isVariableDeclaration(statement) || 'const' !== statement.kind) continue;
-        const matches = statement.declarations.filter((declaration)=>__rspack_external__babel_types_6e8337dd.isIdentifier(declaration.id, {
-                name
-            }));
-        if (1 === matches.length) return matches[0];
-    }
-};
-const exportedConst = (sourceFile, name)=>{
-    for (const statement of sourceFile.program.body)if (__rspack_external__babel_types_6e8337dd.isExportNamedDeclaration(statement) && 'type' !== statement.exportKind) {
-        if (__rspack_external__babel_types_6e8337dd.isVariableDeclaration(statement.declaration) && 'const' === statement.declaration.kind) {
-            const declaration = statement.declaration.declarations.find((value)=>__rspack_external__babel_types_6e8337dd.isIdentifier(value.id, {
-                    name
-                }));
-            if (declaration) return declaration;
-        }
-        if (!statement.source && statement.specifiers.some((value)=>__rspack_external__babel_types_6e8337dd.isExportSpecifier(value) && 'type' !== value.exportKind && __rspack_external__babel_types_6e8337dd.isIdentifier(value.local, {
-                name
-            }) && __rspack_external__babel_types_6e8337dd.isIdentifier(value.exported, {
-                name
-            }))) return localConst(sourceFile, name);
-    }
-};
-const inside = (file, boundary)=>file === boundary || file.startsWith(`${boundary}${node_path.sep}`);
-const containingWorkspace = (file)=>{
-    for(let directory = node_path.dirname(file);; directory = node_path.dirname(directory)){
-        if (node_fs.existsSync(node_path.join(directory, 'pnpm-workspace.yaml'))) return node_fs.realpathSync(directory);
-        if (directory === node_path.dirname(directory)) return;
-    }
-};
-const sourceBoundary = (file, workspace)=>{
-    for(let directory = node_path.dirname(file);; directory = node_path.dirname(directory)){
-        if (node_fs.existsSync(node_path.join(directory, 'package.json')) && directory !== workspace) return node_fs.realpathSync(directory);
-        if (directory === workspace || directory === node_path.dirname(directory)) return node_fs.realpathSync(node_path.dirname(file));
-    }
-};
-const sourceFileAt = (target, boundary)=>{
-    const stem = target.replace(/\.(?:[cm]?[jt]sx?)$/u, '');
-    for (const candidate of [
-        `${stem}.ts`,
-        `${stem}.tsx`,
-        `${stem}.mts`,
-        `${stem}.cts`,
-        target,
-        node_path.join(target, 'index.ts'),
-        node_path.join(target, 'index.tsx')
-    ])try {
-        const real = node_fs.realpathSync(candidate);
-        if (inside(real, boundary) && node_fs.statSync(real).isFile()) return real;
-    } catch  {}
-};
-const packageEntry = (specifier)=>{
-    if (specifier.startsWith('.') || specifier.startsWith('/') || specifier.startsWith('#')) return;
-    const parts = specifier.split('/');
-    const count = specifier.startsWith('@') ? 2 : 1;
-    if (parts.length < count || parts.slice(0, count).some((part)=>!part)) return;
-    return {
-        name: parts.slice(0, count).join('/'),
-        exportKey: parts.length === count ? '.' : `./${parts.slice(count).join('/')}`
-    };
-};
-const resolveModulePath = (module, specifier, workspace)=>{
-    if (/^\.\.?\//u.test(specifier)) {
-        const file = sourceFileAt(node_path.resolve(node_path.dirname(module.path), specifier), module.boundary);
-        return void 0 === file ? void 0 : {
-            path: file,
-            boundary: module.boundary
-        };
-    }
-    const entry = packageEntry(specifier);
-    if (!entry || !workspace) return;
-    const paths = createRequire(module.path).resolve.paths(entry.name) ?? [];
-    for (const lookup of paths){
-        const directory = node_path.join(lookup, entry.name);
-        const manifest = node_path.join(directory, 'package.json');
-        if (!node_fs.existsSync(manifest)) continue;
-        const boundary = node_fs.realpathSync(directory);
-        if (!inside(boundary, workspace) || boundary.split(node_path.sep).includes('node_modules')) break;
-        const pkg = JSON.parse(node_fs.readFileSync(manifest, 'utf8'));
-        if (pkg.name !== entry.name || void 0 === pkg.exports) break;
-        let target;
-        try {
-            const targets = external_resolve_exports_exports(pkg, entry.exportKey, {
-                conditions: [
-                    'modern:source'
-                ]
-            });
-            target = Array.isArray(targets) ? targets[0] : void 0;
-        } catch  {
-            break;
-        }
-        if (!target || !target.startsWith('./')) break;
-        const file = sourceFileAt(node_path.resolve(boundary, target), boundary);
-        return void 0 === file ? void 0 : {
-            path: file,
-            boundary
-        };
-    }
-};
-const createModuleReader = (root)=>{
-    const modules = new Map([
-        [
-            root.path,
-            root
-        ]
-    ]);
-    return (filePath, boundary)=>{
-        if (modules.has(filePath)) return modules.get(filePath);
-        if (modules.size >= 256) return;
-        let module;
-        try {
-            module = {
-                file: parseConsumer(filePath),
-                path: filePath,
-                boundary
-            };
-        } catch  {
-            module = void 0;
-        }
-        modules.set(filePath, module);
-        return module;
-    };
-};
-const importedBinding = (module, name)=>{
-    for (const statement of module.file.program.body)if (__rspack_external__babel_types_6e8337dd.isImportDeclaration(statement) && 'type' !== statement.importKind) {
-        for (const specifier of statement.specifiers)if (__rspack_external__babel_types_6e8337dd.isIdentifier(specifier.local, {
-            name
-        })) {
-            if (__rspack_external__babel_types_6e8337dd.isImportSpecifier(specifier) && 'type' !== specifier.importKind) return {
-                imported: propertyName(specifier.imported) ?? name,
-                specifier: statement.source.value
-            };
-            if (__rspack_external__babel_types_6e8337dd.isImportDefaultSpecifier(specifier)) return {
-                imported: 'default',
-                specifier: statement.source.value
-            };
-        }
-    }
-};
-const reexportedBinding = (module, name)=>{
-    for (const statement of module.file.program.body){
-        if (!__rspack_external__babel_types_6e8337dd.isExportNamedDeclaration(statement) || 'type' === statement.exportKind) continue;
-        const specifier = statement.specifiers.find((value)=>__rspack_external__babel_types_6e8337dd.isExportSpecifier(value) && 'type' !== value.exportKind && propertyName(value.exported) === name);
-        if (void 0 !== specifier && __rspack_external__babel_types_6e8337dd.isExportSpecifier(specifier)) return {
-            local: __rspack_external__babel_types_6e8337dd.isIdentifier(specifier.local) ? specifier.local.name : specifier.local.value,
-            ...statement.source ? {
-                specifier: statement.source.value
-            } : {}
-        };
-    }
-};
-const defaultExport = (module)=>{
-    for (const statement of module.file.program.body){
-        if (!__rspack_external__babel_types_6e8337dd.isExportDefaultDeclaration(statement)) continue;
-        const declaration = statement.declaration;
-        if (__rspack_external__babel_types_6e8337dd.isIdentifier(declaration)) return declaration.name;
-        return __rspack_external__babel_types_6e8337dd.isExpression(declaration) ? declaration : void 0;
-    }
-};
-const resolveBinding = (module, name, scope, readModule, workspace, seen)=>{
-    const key = `${scope}:${module.path}#${name}`;
-    if (seen.has(key) || seen.size >= 512) return;
-    seen.add(key);
-    const declaration = 'export' === scope ? exportedConst(module.file, name) : localConst(module.file, name);
-    if (declaration?.init) return {
-        expression: declaration.init,
-        module
-    };
-    const throughModule = (specifier, imported)=>{
-        const resolved = resolveModulePath(module, specifier, workspace);
-        const target = resolved && readModule(resolved.path, resolved.boundary);
-        return void 0 === target ? void 0 : resolveBinding(target, imported, 'export', readModule, workspace, seen);
-    };
-    if ('local' === scope) {
-        const imported = importedBinding(module, name);
-        return void 0 === imported ? void 0 : throughModule(imported.specifier, imported.imported);
-    }
-    if ('default' === name) {
-        const exported = defaultExport(module);
-        if ('string' == typeof exported) return resolveBinding(module, exported, 'local', readModule, workspace, seen);
-        return void 0 === exported ? void 0 : {
-            expression: exported,
-            module
-        };
-    }
-    const reexported = reexportedBinding(module, name);
-    if (void 0 !== reexported) return void 0 === reexported.specifier ? resolveBinding(module, reexported.local, 'local', readModule, workspace, seen) : throughModule(reexported.specifier, reexported.local);
-    for (const statement of module.file.program.body){
-        if (!__rspack_external__babel_types_6e8337dd.isExportAllDeclaration(statement) || 'type' === statement.exportKind) continue;
-        const resolved = throughModule(statement.source.value, name);
-        if (void 0 !== resolved) return resolved;
-    }
-};
 const objectLiteral = (expression)=>{
     if (null == expression) return;
     const unwrapped = unwrapExpression(expression);
@@ -380,9 +163,13 @@ const rootComposesFoundation = (sourceFile, declaration, stem, foundationName)=>
     return void 0 !== chain && isAccessPath(chain.base.callee, [
         'HttpApi',
         'make'
-    ]) && 1 === chain.base.arguments.length && stringLiteral(chain.base.arguments[0]) === `${pascalCaseStem(stem)}Api` && chain.methods.length > 0 && chain.methods.every((method, index)=>1 === method.arguments.length && ('add' === method.name || 'addHttpApi' === method.name || index === chain.methods.length - 1 && 'pipe' === method.name && 'identity' === identifierName(method.arguments[0]) && importsExactBindings(sourceFile, 'effect', [
+    ]) && 1 === chain.base.arguments.length && stringLiteral(chain.base.arguments[0]) === `${pascalCaseStem(stem)}Api` && chain.methods.length > 0 && chain.methods.every((method, index)=>{
+        const combinatorArity = nonEndpointCombinators.api[method.name];
+        if (void 0 !== combinatorArity) return method.arguments.length === combinatorArity;
+        return 1 === method.arguments.length && ('add' === method.name || 'addHttpApi' === method.name || index === chain.methods.length - 1 && 'pipe' === method.name && 'identity' === identifierName(method.arguments[0]) && importsExactBindings(sourceFile, 'effect', [
             'identity'
-        ]))) && first?.name === 'addHttpApi' && identifierName(first.arguments[0]) === foundationName;
+        ]));
+    }) && first?.name === 'addHttpApi' && identifierName(first.arguments[0]) === foundationName;
 };
 const nonEndpointCombinators = {
     api: {
@@ -398,9 +185,7 @@ const nonEndpointCombinators = {
         middleware: 1
     }
 };
-const reachableEndpoints = (rootModule, declaration)=>{
-    const readModule = createModuleReader(rootModule);
-    const workspace = containingWorkspace(rootModule.path);
+const reachableEndpoints = (graph, declaration)=>{
     const active = new Set();
     const endpoints = [];
     const identities = new Set();
@@ -422,8 +207,8 @@ const reachableEndpoints = (rootModule, declaration)=>{
         active.add(node);
         try {
             if (__rspack_external__babel_types_6e8337dd.isIdentifier(node)) {
-                const resolved = resolveBinding(module, node.name, 'local', readModule, workspace, new Set());
-                return void 0 !== resolved && visit(resolved.expression, resolved.module, kind, group);
+                const resolved = graph.resolve(module, node.name, 'local');
+                return resolved?.kind === 'declaration' && visit(resolved.expression, resolved.module, kind, group);
             }
             if ('endpoint' === kind) {
                 if (!__rspack_external__babel_types_6e8337dd.isCallExpression(node) || node.arguments.length < 2 || node.arguments.length > 3) return false;
@@ -478,7 +263,7 @@ const reachableEndpoints = (rootModule, declaration)=>{
             active.delete(node);
         }
     };
-    return visit(declaration?.init, rootModule, 'api') ? endpoints : void 0;
+    return visit(declaration?.init, graph.root, 'api') ? endpoints : void 0;
 };
 const operationContextFields = (property)=>{
     const constructorCall = exactCall(property.value, [
@@ -609,8 +394,8 @@ const readinessSchemaIsShared = (declaration, markerSchemaName, ownerMarkerIsIde
     return void 0 !== schema && (schema.identity && ownerMarkerIsIdentity || 1 === schema.assignments.size && identifierName(schema.assignments.get('marker')?.value) === markerSchemaName);
 };
 const declarationIsIdentifier = (declaration, identifier)=>declaration?.init != null && identifierName(unwrapExpression(declaration.init)) === identifier;
-const validateParsedContract = (module, stem, expectation)=>{
-    const sourceFile = module.file;
+const validateParsedContract = (graph, stem, expectation)=>{
+    const sourceFile = graph.root.file;
     const exportStem = camelCaseStem(stem);
     const foundationName = `${exportStem}FoundationApi`;
     const markerSchemaName = `${exportStem}MarkerSchema`;
@@ -627,7 +412,7 @@ const validateParsedContract = (module, stem, expectation)=>{
     if (!readinessSchemaIsShared(exportedConst(sourceFile, readinessSchemaName), markerSchemaName, declarationIsIdentifier(markerDeclaration, 'MicroVerticalBuildMarkerSchema'))) return 'MicroVertical readiness schema must consume the shared readiness schema without overriding shared fields';
     if (!foundationIsExact(exportedConst(sourceFile, foundationName), stem, readinessSchemaName)) return 'MicroVertical readiness foundation API must directly compose its exact readiness endpoint and foundation identity';
     if (!rootComposesFoundation(sourceFile, exportedConst(sourceFile, `${exportStem}Api`), stem, foundationName)) return 'MicroVertical root API must explicitly compose its readiness foundation API';
-    const endpoints = reachableEndpoints(module, exportedConst(sourceFile, `${exportStem}Api`));
+    const endpoints = reachableEndpoints(graph, exportedConst(sourceFile, `${exportStem}Api`));
     if (!endpoints) return 'MicroVertical root API must compose bounded native endpoint declarations without ambiguous identities';
     if (!operationMapIsConnected(exportedConst(sourceFile, `${exportStem}OperationContexts`), stem, expectation.operationPaths ?? {}, endpoints)) return 'MicroVertical operation map must construct every operation with the shared context constructor';
     if (!metadataIsExact(exportedConst(sourceFile, `${exportStem}ApiContract`), expectation, endpoints)) return 'MicroVertical root contract must keep exact owner and API path metadata without forbidden fields';
@@ -639,14 +424,9 @@ const configuredMicroVerticalApiStem = (verticalPath, verticals)=>{
 };
 const microVerticalApiBaselineViolation = (stem, filePath, expectation)=>{
     try {
-        const realPath = node_fs.realpathSync(filePath);
-        const sourceFile = parseConsumer(realPath);
+        const graph = createModuleGraph(filePath);
         if (!baselinePublicIdentityIsExact(filePath, expectation)) return 'MicroVertical baseline imports must resolve the exact framework owner public export and schema identity';
-        return validateParsedContract({
-            file: sourceFile,
-            path: realPath,
-            boundary: sourceBoundary(realPath, containingWorkspace(realPath))
-        }, stem, expectation);
+        return validateParsedContract(graph, stem, expectation);
     } catch (error) {
         if (error instanceof SourceSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
         throw error;

package/dist/esm/microvertical-api-boundary.js

@@ -3,7 +3,8 @@ import node_path from "node:path";
 import { parse } from "@babel/parser";
 import { configuredMicroVerticalApiStem, microVerticalApiBaselineViolation } from "./microvertical-api-baseline.js";
 import { baselinePackage, resolveBaselinePackageDirectory } from "./microvertical-api-owner.js";
-import { consumerParserPlugins } from "./source-analysis.js";
+import { createModuleGraph } from "./module-graph.js";
+import { SourceSyntaxError, consumerParserPlugins } from "./source-analysis.js";
 import { createEffectApiImportResolver, strictEffectRuntimeTopologyViolation } from "./strict-effect-runtime.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
 const ignored = new Set([
@@ -407,6 +408,27 @@ function check(options, topology) {
                 const violation = microVerticalApiBaselineViolation(stem, absolute(contract), expectation);
                 if (violation) diagnostics.push(`${contract}: ${violation}`);
             }
+            if (options.contractRules?.length && exists(contract)) {
+                let graph;
+                try {
+                    graph = createModuleGraph(absolute(contract));
+                } catch (error) {
+                    if (!(error instanceof SourceSyntaxError)) throw error;
+                    diagnostics.push(`${contract}: contract rules need a parseable contract with immutable bindings (${error.message})`);
+                }
+                if (graph) {
+                    const context = {
+                        appPath,
+                        protocol: rpc ? 'rpc' : 'rest',
+                        graph
+                    };
+                    for (const rule of options.contractRules)guarded(`${contract} (rule ${rule.name || 'anonymous'})`, ()=>{
+                        const messages = rule(context);
+                        if (!Array.isArray(messages) || !messages.every((message)=>'string' == typeof message)) throw new Error('contract rule must return an array of violation messages (return [] when the contract passes)');
+                        for (const message of messages)diagnostics.push(`${contract}: ${message}`);
+                    });
+                }
+            }
             if (client) {
                 const relativeContract = node_path.posix.relative(node_path.posix.dirname(client), contract);
                 moduleShape(client, [
@@ -500,4 +522,4 @@ function check(options, topology) {
 }
 const checkMicroVerticalApiBoundaries = (options)=>check(options, true);
 const checkMicroVerticalApiConsumerFiles = (options)=>check(options, false);
-export { checkMicroVerticalApiBoundaries, checkMicroVerticalApiConsumerFiles, configuredMicroVerticalApiStem, microVerticalApiBaselineViolation };
+export { checkMicroVerticalApiBoundaries, checkMicroVerticalApiConsumerFiles, configuredMicroVerticalApiStem, createModuleGraph, microVerticalApiBaselineViolation };

package/dist/esm/module-graph.js

@@ -0,0 +1,260 @@
+import node_fs from "node:fs";
+import { createRequire } from "node:module";
+import node_path from "node:path";
+import { exports as external_resolve_exports_exports } from "resolve.exports";
+import { SourceSyntaxError, parseSource, traverseSource } from "./source-analysis.js";
+import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
+const MAX_MODULES = 256;
+const MAX_LOOKUPS = 512;
+function parseConsumer(filePath) {
+    if (node_fs.statSync(filePath).size > 1000000) throw new Error(`${filePath}: consumer source exceeds 1 MB analysis budget`);
+    const file = parseSource(node_fs.readFileSync(filePath, 'utf8'), filePath);
+    traverseSource(file, {
+        AssignmentExpression (p) {
+            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+        },
+        UpdateExpression (p) {
+            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+        },
+        TSModuleDeclaration () {
+            throw new SourceSyntaxError('contract bindings must not be merged with namespaces');
+        }
+    });
+    return file;
+}
+const propertyName = (node)=>{
+    if (void 0 !== node && (__rspack_external__babel_types_6e8337dd.isIdentifier(node) || __rspack_external__babel_types_6e8337dd.isStringLiteral(node) || __rspack_external__babel_types_6e8337dd.isNumericLiteral(node))) return __rspack_external__babel_types_6e8337dd.isIdentifier(node) ? node.name : String(node.value);
+};
+const localConst = (sourceFile, name)=>{
+    for (const item of sourceFile.program.body){
+        const statement = __rspack_external__babel_types_6e8337dd.isExportNamedDeclaration(item) ? item.declaration : item;
+        if (!__rspack_external__babel_types_6e8337dd.isVariableDeclaration(statement) || 'const' !== statement.kind) continue;
+        const matches = statement.declarations.filter((declaration)=>__rspack_external__babel_types_6e8337dd.isIdentifier(declaration.id, {
+                name
+            }));
+        if (1 === matches.length) return matches[0];
+    }
+};
+const exportedConst = (sourceFile, name)=>{
+    for (const statement of sourceFile.program.body)if (__rspack_external__babel_types_6e8337dd.isExportNamedDeclaration(statement) && 'type' !== statement.exportKind) {
+        if (__rspack_external__babel_types_6e8337dd.isVariableDeclaration(statement.declaration) && 'const' === statement.declaration.kind) {
+            const declaration = statement.declaration.declarations.find((value)=>__rspack_external__babel_types_6e8337dd.isIdentifier(value.id, {
+                    name
+                }));
+            if (declaration) return declaration;
+        }
+        if (!statement.source && statement.specifiers.some((value)=>__rspack_external__babel_types_6e8337dd.isExportSpecifier(value) && 'type' !== value.exportKind && __rspack_external__babel_types_6e8337dd.isIdentifier(value.local, {
+                name
+            }) && __rspack_external__babel_types_6e8337dd.isIdentifier(value.exported, {
+                name
+            }))) return localConst(sourceFile, name);
+    }
+};
+const inside = (file, boundary)=>file === boundary || file.startsWith(`${boundary}${node_path.sep}`);
+const containingWorkspace = (file)=>{
+    for(let directory = node_path.dirname(file);; directory = node_path.dirname(directory)){
+        if (node_fs.existsSync(node_path.join(directory, 'pnpm-workspace.yaml'))) return node_fs.realpathSync(directory);
+        if (directory === node_path.dirname(directory)) return;
+    }
+};
+const sourceBoundary = (file, workspace)=>{
+    for(let directory = node_path.dirname(file);; directory = node_path.dirname(directory)){
+        if (node_fs.existsSync(node_path.join(directory, 'package.json')) && directory !== workspace) return node_fs.realpathSync(directory);
+        if (directory === workspace || directory === node_path.dirname(directory)) return node_fs.realpathSync(node_path.dirname(file));
+    }
+};
+const sourceFileAt = (target, boundary)=>{
+    const stem = target.replace(/\.(?:[cm]?[jt]sx?)$/u, '');
+    for (const candidate of [
+        `${stem}.ts`,
+        `${stem}.tsx`,
+        `${stem}.mts`,
+        `${stem}.cts`,
+        target,
+        node_path.join(target, 'index.ts'),
+        node_path.join(target, 'index.tsx')
+    ])try {
+        const real = node_fs.realpathSync(candidate);
+        if (inside(real, boundary) && node_fs.statSync(real).isFile()) return real;
+    } catch  {}
+};
+const packageEntry = (specifier)=>{
+    if (specifier.startsWith('.') || specifier.startsWith('/') || specifier.startsWith('#')) return;
+    const parts = specifier.split('/');
+    const count = specifier.startsWith('@') ? 2 : 1;
+    if (parts.length < count || parts.slice(0, count).some((part)=>!part)) return;
+    return {
+        name: parts.slice(0, count).join('/'),
+        exportKey: parts.length === count ? '.' : `./${parts.slice(count).join('/')}`
+    };
+};
+const resolveModulePath = (module, specifier, workspace)=>{
+    if (/^\.\.?\//u.test(specifier)) {
+        const file = sourceFileAt(node_path.resolve(node_path.dirname(module.path), specifier), module.boundary);
+        return void 0 === file ? void 0 : {
+            kind: 'module',
+            path: file,
+            boundary: module.boundary
+        };
+    }
+    const entry = packageEntry(specifier);
+    if (!entry) return;
+    if (!workspace) return {
+        kind: 'external'
+    };
+    const paths = createRequire(module.path).resolve.paths(entry.name) ?? [];
+    for (const lookup of paths){
+        const directory = node_path.join(lookup, entry.name);
+        const manifest = node_path.join(directory, 'package.json');
+        if (!node_fs.existsSync(manifest)) continue;
+        const boundary = node_fs.realpathSync(directory);
+        if (!inside(boundary, workspace) || boundary.split(node_path.sep).includes('node_modules')) break;
+        const pkg = JSON.parse(node_fs.readFileSync(manifest, 'utf8'));
+        if (pkg.name !== entry.name || void 0 === pkg.exports) return;
+        let target;
+        try {
+            const targets = external_resolve_exports_exports(pkg, entry.exportKey, {
+                conditions: [
+                    'modern:source'
+                ]
+            });
+            target = Array.isArray(targets) ? targets[0] : void 0;
+        } catch  {
+            return;
+        }
+        if (!target || !target.startsWith('./')) return;
+        const file = sourceFileAt(node_path.resolve(boundary, target), boundary);
+        return void 0 === file ? void 0 : {
+            kind: 'module',
+            path: file,
+            boundary
+        };
+    }
+    return {
+        kind: 'external'
+    };
+};
+const importedBinding = (module, name)=>{
+    for (const statement of module.file.program.body)if (__rspack_external__babel_types_6e8337dd.isImportDeclaration(statement) && 'type' !== statement.importKind) {
+        for (const specifier of statement.specifiers)if (__rspack_external__babel_types_6e8337dd.isIdentifier(specifier.local, {
+            name
+        })) {
+            if (__rspack_external__babel_types_6e8337dd.isImportSpecifier(specifier) && 'type' !== specifier.importKind) return {
+                imported: propertyName(specifier.imported) ?? name,
+                specifier: statement.source.value
+            };
+            if (__rspack_external__babel_types_6e8337dd.isImportDefaultSpecifier(specifier)) return {
+                imported: 'default',
+                specifier: statement.source.value
+            };
+        }
+    }
+};
+const reexportedBinding = (module, name)=>{
+    for (const statement of module.file.program.body){
+        if (!__rspack_external__babel_types_6e8337dd.isExportNamedDeclaration(statement) || 'type' === statement.exportKind) continue;
+        const specifier = statement.specifiers.find((value)=>__rspack_external__babel_types_6e8337dd.isExportSpecifier(value) && 'type' !== value.exportKind && propertyName(value.exported) === name);
+        if (void 0 !== specifier && __rspack_external__babel_types_6e8337dd.isExportSpecifier(specifier)) return {
+            local: __rspack_external__babel_types_6e8337dd.isIdentifier(specifier.local) ? specifier.local.name : specifier.local.value,
+            ...statement.source ? {
+                specifier: statement.source.value
+            } : {}
+        };
+    }
+};
+const defaultExport = (module)=>{
+    for (const statement of module.file.program.body){
+        if (!__rspack_external__babel_types_6e8337dd.isExportDefaultDeclaration(statement)) continue;
+        const declaration = statement.declaration;
+        if (__rspack_external__babel_types_6e8337dd.isIdentifier(declaration)) return declaration.name;
+        return __rspack_external__babel_types_6e8337dd.isExpression(declaration) ? declaration : void 0;
+    }
+};
+function createModuleGraph(filePath) {
+    const realPath = node_fs.realpathSync(filePath);
+    const workspace = containingWorkspace(realPath);
+    const root = {
+        file: parseConsumer(realPath),
+        path: realPath,
+        boundary: sourceBoundary(realPath, workspace)
+    };
+    const modules = new Map([
+        [
+            root.path,
+            root
+        ]
+    ]);
+    const readModule = (modulePath, boundary)=>{
+        if (modules.has(modulePath)) return modules.get(modulePath);
+        if (modules.size >= MAX_MODULES) return;
+        let module;
+        try {
+            module = {
+                file: parseConsumer(modulePath),
+                path: modulePath,
+                boundary
+            };
+        } catch  {
+            module = void 0;
+        }
+        modules.set(modulePath, module);
+        return module;
+    };
+    const resolveBinding = (module, name, scope, chain, seen)=>{
+        const key = `${scope}:${module.path}#${name}`;
+        if (seen.has(key) || seen.size >= MAX_LOOKUPS) return;
+        seen.add(key);
+        const last = chain.at(-1);
+        const hops = last?.path === module.path && last.name === name ? chain : [
+            ...chain,
+            {
+                path: module.path,
+                name
+            }
+        ];
+        const declaration = 'export' === scope ? exportedConst(module.file, name) : localConst(module.file, name);
+        if (declaration?.init) return {
+            kind: 'declaration',
+            expression: declaration.init,
+            module,
+            chain: hops
+        };
+        const throughModule = (specifier, imported, allowExternal)=>{
+            const target = resolveModulePath(module, specifier, workspace);
+            if (target?.kind === 'external') return allowExternal ? {
+                kind: 'external',
+                specifier,
+                name: imported,
+                chain: hops
+            } : void 0;
+            const next = target && readModule(target.path, target.boundary);
+            return void 0 === next ? void 0 : resolveBinding(next, imported, 'export', hops, seen);
+        };
+        if ('local' === scope) {
+            const imported = importedBinding(module, name);
+            return void 0 === imported ? void 0 : throughModule(imported.specifier, imported.imported, true);
+        }
+        if ('default' === name) {
+            const exported = defaultExport(module);
+            if ('string' == typeof exported) return resolveBinding(module, exported, 'local', hops, seen);
+            return void 0 === exported ? void 0 : {
+                kind: 'declaration',
+                expression: exported,
+                module,
+                chain: hops
+            };
+        }
+        const reexported = reexportedBinding(module, name);
+        if (void 0 !== reexported) return void 0 === reexported.specifier ? resolveBinding(module, reexported.local, 'local', hops, seen) : throughModule(reexported.specifier, reexported.local, true);
+        for (const statement of module.file.program.body){
+            if (!__rspack_external__babel_types_6e8337dd.isExportAllDeclaration(statement) || 'type' === statement.exportKind) continue;
+            const resolved = throughModule(statement.source.value, name, false);
+            if (void 0 !== resolved) return resolved;
+        }
+    };
+    return {
+        root,
+        resolve: (module, name, scope)=>resolveBinding(module, name, scope, [], new Set())
+    };
+}
+export { createModuleGraph, exportedConst, localConst, parseConsumer, propertyName };