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

package/bin/modern-api-check-files.mjs

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
 import { runMicroVerticalApiCheckCli } from '../dist/esm-node/cli/microvertical-api-check.js';
 
-process.exitCode = runMicroVerticalApiCheckCli(process.argv.slice(2), true);
+process.exitCode = await runMicroVerticalApiCheckCli(
+  process.argv.slice(2),
+  true,
+);

package/bin/modern-api-check.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
 import { runMicroVerticalApiCheckCli } from '../dist/esm-node/cli/microvertical-api-check.js';
 
-process.exitCode = runMicroVerticalApiCheckCli();
+process.exitCode = await runMicroVerticalApiCheckCli();

package/bin/modern-i18n-check.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runWorkspaceSourceCheckCli } from '../dist/esm-node/cli/workspace-source-check.js';
+
+process.exitCode = runWorkspaceSourceCheckCli();

package/dist/cjs/cli/microvertical-api-check.cjs

@@ -1,5 +1,14 @@
 "use strict";
 var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
 (()=>{
     __webpack_require__.d = (exports1, getters, values)=>{
         var define = (defs, kind)=>{
@@ -30,30 +39,50 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     runMicroVerticalApiCheckCli: ()=>runMicroVerticalApiCheckCli
 });
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const external_node_url_namespaceObject = require("node:url");
 const external_microvertical_api_boundary_cjs_namespaceObject = require("../microvertical-api-boundary.cjs");
-function runMicroVerticalApiCheckCli(args = process.argv.slice(2), filesOnly = false) {
+const flags = [
+    '--workspace-root',
+    '--baseline-package-directory',
+    '--rules'
+];
+async function loadContractRules(file) {
+    const rules = (await import((0, external_node_url_namespaceObject.pathToFileURL)(external_node_path_default().resolve(file)).href)).default;
+    if (!Array.isArray(rules) || !rules.every((rule)=>'function' == typeof rule)) throw new Error(`${file}: default export must be an array of contract rule functions, e.g. \`export default [myRule]\``);
+    return rules;
+}
+async function runMicroVerticalApiCheckCli(args = process.argv.slice(2), filesOnly = false) {
     let workspaceRoot = process.env.ULTRAMODERN_WORKSPACE_ROOT ?? process.cwd();
     let baselinePackageDirectory;
+    const ruleFiles = [];
     for(let index = 0; index < args.length; index += 1){
         const argument = args[index];
         if ('--help' === argument || '-h' === argument) {
-            console.log(`${filesOnly ? 'modern-api-check-files' : 'modern-api-check'} [--workspace-root <path>] [--baseline-package-directory <path>]\n${filesOnly ? 'Checks consumer files, contracts, package exports and owner identity. Does not analyze runtime topology; run the strict Effect source phase separately.' : 'Checks consumer files, contracts, package exports, owner identity and runtime topology once per API entry.'}\nWorkspace defaults to ULTRAMODERN_WORKSPACE_ROOT then cwd. Exit codes: 0 valid, 1 consumer violation, 2 tool/configuration failure.`);
+            console.log(`${filesOnly ? 'modern-api-check-files' : 'modern-api-check'} [--workspace-root <path>] [--baseline-package-directory <path>] [--rules <module>]...\n${filesOnly ? 'Checks consumer files, contracts, package exports and owner identity. Does not analyze runtime topology; run the strict Effect source phase separately.' : 'Checks consumer files, contracts, package exports, owner identity and runtime topology once per API entry.'}\n--rules loads a module whose default export is an array of contract rules; each rule receives the module graph of every API contract.\nWorkspace defaults to ULTRAMODERN_WORKSPACE_ROOT then cwd. Exit codes: 0 valid, 1 consumer violation, 2 tool/configuration failure.`);
             return 0;
         }
-        if (![
-            '--workspace-root',
-            '--baseline-package-directory'
-        ].includes(argument ?? '') || !args[index + 1] || args[index + 1]?.startsWith('--')) {
+        if (!flags.includes(argument ?? '') || !args[index + 1] || args[index + 1]?.startsWith('--')) {
             console.error(`Invalid argument: ${argument ?? ''}. Use --help.`);
             return 2;
         }
         const value = args[++index];
         if ('--workspace-root' === argument) workspaceRoot = value;
+        else if ('--rules' === argument) ruleFiles.push(value);
         else baselinePackageDirectory = value;
     }
+    const contractRules = [];
+    for (const file of ruleFiles)try {
+        contractRules.push(...await loadContractRules(file));
+    } catch (error) {
+        console.error(`API tool error: --rules ${error instanceof Error ? error.message : String(error)}`);
+        return 2;
+    }
     const result = (filesOnly ? external_microvertical_api_boundary_cjs_namespaceObject.checkMicroVerticalApiConsumerFiles : external_microvertical_api_boundary_cjs_namespaceObject.checkMicroVerticalApiBoundaries)({
         workspaceRoot,
-        baselinePackageDirectory
+        baselinePackageDirectory,
+        contractRules
     });
     for (const diagnostic of result.diagnostics)console.error(`API violation: ${diagnostic}`);
     for (const error of result.toolErrors)console.error(`API tool error: ${error}`);

package/dist/cjs/cli/workspace-source-check.cjs

@@ -37,8 +37,8 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    main: ()=>main,
-    runWorkspaceSourceCheck: ()=>runWorkspaceSourceCheck
+    runWorkspaceSourceCheck: ()=>runWorkspaceSourceCheck,
+    runWorkspaceSourceCheckCli: ()=>runWorkspaceSourceCheckCli
 });
 const external_node_fs_namespaceObject = require("node:fs");
 var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
@@ -50,6 +50,11 @@ const DEFAULT_LOCALES = [
     'en',
     'cs'
 ];
+const DEFAULT_SOURCE_ROOTS = [
+    'apps',
+    'verticals',
+    'packages'
+];
 const ignoredDirectories = new Set([
     '.modern',
     '.modernjs',
@@ -83,6 +88,8 @@ const createLocaleJsonMatcher = (locales)=>{
 const resolvePluralCategories = (locale, overrides)=>overrides?.[locale] ?? new Intl.PluralRules(locale).resolvedOptions().pluralCategories;
 const readText = (filePath)=>external_node_fs_default().readFileSync(filePath, 'utf-8');
 const localeImportPattern = (locale)=>new RegExp(`import\\s+(?:\\*\\s+as\\s+)?[A-Za-z_$][\\w$]*\\s+from\\s+['"]\\.\\./locales/${escapeRegExp(locale)}/[^'"]+\\.json['"]`, 'u');
+class SourceViolation extends Error {
+}
 const checkRuntimeResources = (root, filePath, text, locales)=>{
     const relative = relativePath(root, filePath);
     if (!relative.endsWith('/src/modern.runtime.ts')) return;
@@ -90,7 +97,7 @@ const checkRuntimeResources = (root, filePath, text, locales)=>{
     const registersResources = /initOptions\s*:\s*\{[\s\S]*?\bresources\s*[,:}]/u.test(text);
     if (missingLocales.length > 0 || !registersResources) {
         const detail = missingLocales.length > 0 ? `missing locale JSON imports for: ${missingLocales.join(', ')}` : 'initOptions does not register a `resources` entry';
-        throw new Error(`${relative} must register locale JSON resources in modern.runtime.ts so Worker SSR and hydration use the same first-render translations (${detail}).`);
+        throw new SourceViolation(`${relative} must register locale JSON resources in modern.runtime.ts so Worker SSR and hydration use the same first-render translations (${detail}).`);
     }
 };
 const visitLocaleKeys = (value, visitor, pathParts = [])=>{
@@ -110,7 +117,7 @@ const checkPluralResources = (root, filePath, json, requiredSuffixes, pluralSuff
     visitLocaleKeys(json, (key, value, pathParts)=>{
         if ('string' != typeof value || !value.includes('{{count}}')) return;
         const suffixMatch = key.match(pluralSuffixPattern);
-        if (!suffixMatch) throw new Error(`${relative} key ${pathParts.join('.')} contains {{count}} but is not plural-suffixed.`);
+        if (!suffixMatch) throw new SourceViolation(`${relative} key ${pathParts.join('.')} contains {{count}} but is not plural-suffixed.`);
         const [, base = '', suffix = ''] = suffixMatch;
         const parentPath = pathParts.slice(0, -1).join('.');
         const groupKey = `${parentPath}.${base}`;
@@ -118,7 +125,7 @@ const checkPluralResources = (root, filePath, json, requiredSuffixes, pluralSuff
         existing.add(suffix);
         groups.set(groupKey, existing);
     });
-    for (const [group, suffixes] of groups)for (const suffix of requiredSuffixes)if (!suffixes.has(suffix)) throw new Error(`${relative} plural group ${group} is missing _${suffix}.`);
+    for (const [group, suffixes] of groups)for (const suffix of requiredSuffixes)if (!suffixes.has(suffix)) throw new SourceViolation(`${relative} plural group ${group} is missing _${suffix}.`);
 };
 const runRuntimeAndLocaleResourceChecks = (root, sourceRoots, locales, pluralCategories)=>{
     if (0 === locales.length) return;
@@ -140,11 +147,7 @@ const runRuntimeAndLocaleResourceChecks = (root, sourceRoots, locales, pluralCat
         checkPluralResources(root, filePath, JSON.parse(readText(filePath)), localeCategories.get(language) ?? [], pluralSuffixPattern);
     }
 };
-const runWorkspaceSourceCheck = ({ cwd = process.cwd(), sourceRoots = [
-    'apps',
-    'verticals',
-    'packages'
-], locales = DEFAULT_LOCALES, pluralCategories } = {})=>{
+const runWorkspaceSourceCheck = ({ cwd = process.cwd(), sourceRoots = DEFAULT_SOURCE_ROOTS, locales = DEFAULT_LOCALES, pluralCategories } = {})=>{
     const oxlintResult = (0, external_oxlint_cjs_namespaceObject.runOxlintRules)({
         cwd,
         targets: sourceRoots,
@@ -177,20 +180,90 @@ const runWorkspaceSourceCheck = ({ cwd = process.cwd(), sourceRoots = [
     try {
         runRuntimeAndLocaleResourceChecks(cwd, sourceRoots, locales, pluralCategories);
     } catch (error) {
-        console.error(error instanceof Error ? error.message : 'UltraModern workspace source checks failed.');
-        return 1;
+        console.error(error instanceof Error ? error.message : String(error));
+        return error instanceof SourceViolation ? 1 : 2;
     }
     console.log(WORKSPACE_SOURCE_SUCCESS);
     return 0;
 };
-const main = ()=>{
-    process.exitCode = runWorkspaceSourceCheck();
+const USAGE = `modern-i18n-check [--workspace-root <path>]
+Runs the UltraModern i18n and boundary source checks for a workspace.
+Workspace defaults to ULTRAMODERN_WORKSPACE_ROOT then cwd. Options come from
+package.json "modernjs.i18nCheck": { sourceRoots, locales, pluralCategories }.
+Exit codes: 0 valid, 1 source violation, 2 tool/configuration failure.`;
+const isStringArray = (value)=>Array.isArray(value) && value.every((entry)=>'string' == typeof entry && entry.length > 0);
+const isLocaleArray = (value)=>{
+    if (!isStringArray(value)) return false;
+    try {
+        Intl.getCanonicalLocales(value);
+        return true;
+    } catch  {
+        return false;
+    }
+};
+const isRecord = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const isWorkspaceDirectory = (root, entry)=>{
+    if (external_node_path_default().isAbsolute(entry)) return false;
+    const target = external_node_path_default().resolve(root, entry);
+    if (!external_node_fs_default().existsSync(target) || !external_node_fs_default().statSync(target).isDirectory()) return false;
+    const relative = external_node_path_default().relative(external_node_fs_default().realpathSync(root), external_node_fs_default().realpathSync(target));
+    return '' !== relative && '..' !== relative && !relative.startsWith(`..${external_node_path_default().sep}`) && !external_node_path_default().isAbsolute(relative);
+};
+const CLDR_PLURAL_CATEGORIES = new Set([
+    'zero',
+    'one',
+    'two',
+    'few',
+    'many',
+    'other'
+]);
+const isPluralCategories = (value)=>isRecord(value) && Object.values(value).every((categories)=>isStringArray(categories) && categories.includes('other') && categories.every((category)=>CLDR_PLURAL_CATEGORIES.has(category)));
+const readWorkspaceCheckOptions = (root)=>{
+    const manifestPath = external_node_path_default().join(root, 'package.json');
+    const modernjs = JSON.parse(readText(manifestPath)).modernjs;
+    const config = isRecord(modernjs) && Object.hasOwn(modernjs, 'i18nCheck') ? modernjs.i18nCheck : {};
+    const invalid = (field, expected)=>new Error(`${manifestPath} "modernjs.i18nCheck${field}" must be ${expected}.`);
+    if (!isRecord(config)) throw invalid('', 'an object');
+    const { locales, pluralCategories } = config;
+    if (void 0 !== locales && !isLocaleArray(locales)) throw invalid('.locales', 'an array of BCP 47 locale codes');
+    if (void 0 !== pluralCategories && !isPluralCategories(pluralCategories)) throw invalid('.pluralCategories', 'an object of locale -> CLDR plural categories including "other"');
+    const sourceRoots = Object.hasOwn(config, 'sourceRoots') ? config.sourceRoots : DEFAULT_SOURCE_ROOTS.filter((entry)=>isWorkspaceDirectory(root, entry));
+    if (!isStringArray(sourceRoots) || 0 === sourceRoots.length || !sourceRoots.every((entry)=>isWorkspaceDirectory(root, entry))) throw invalid('.sourceRoots', `a non-empty array of existing workspace-relative directories (default: whichever of ${DEFAULT_SOURCE_ROOTS.join(', ')} exist)`);
+    return {
+        cwd: root,
+        sourceRoots,
+        locales,
+        pluralCategories
+    };
+};
+const runWorkspaceSourceCheckCli = (args = process.argv.slice(2))=>{
+    let workspaceRoot = process.env.ULTRAMODERN_WORKSPACE_ROOT ?? process.cwd();
+    for(let index = 0; index < args.length; index += 1){
+        const argument = args[index];
+        if ('--help' === argument || '-h' === argument) {
+            console.log(USAGE);
+            return 0;
+        }
+        const value = args[index + 1];
+        if ('--workspace-root' !== argument || !value || value.startsWith('--')) {
+            console.error(`Invalid argument: ${argument ?? ''}. Use --help.`);
+            return 2;
+        }
+        workspaceRoot = value;
+        index += 1;
+    }
+    try {
+        return runWorkspaceSourceCheck(readWorkspaceCheckOptions(external_node_path_default().resolve(workspaceRoot)));
+    } catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        return 2;
+    }
 };
-exports.main = __webpack_exports__.main;
 exports.runWorkspaceSourceCheck = __webpack_exports__.runWorkspaceSourceCheck;
+exports.runWorkspaceSourceCheckCli = __webpack_exports__.runWorkspaceSourceCheckCli;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "main",
-    "runWorkspaceSourceCheck"
+    "runWorkspaceSourceCheck",
+    "runWorkspaceSourceCheckCli"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/cjs/microvertical-api-baseline.cjs

@@ -1,14 +1,5 @@
 "use strict";
 var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.n = (module)=>{
-        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
-        __webpack_require__.d(getter, {
-            a: getter
-        });
-        return getter;
-    };
-})();
 (()=>{
     __webpack_require__.d = (exports1, getters, values)=>{
         var define = (defs, kind)=>{
@@ -40,40 +31,16 @@ __webpack_require__.d(__webpack_exports__, {
     configuredMicroVerticalApiStem: ()=>configuredMicroVerticalApiStem,
     microVerticalApiBaselineViolation: ()=>microVerticalApiBaselineViolation
 });
-const external_node_fs_namespaceObject = require("node:fs");
-var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
-const external_node_module_namespaceObject = require("node:module");
-const external_node_path_namespaceObject = require("node:path");
-var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 const types_namespaceObject = require("@babel/types");
-const external_resolve_exports_namespaceObject = require("resolve.exports");
 const external_microvertical_api_owner_cjs_namespaceObject = require("./microvertical-api-owner.cjs");
+const external_module_graph_cjs_namespaceObject = require("./module-graph.cjs");
 const external_source_analysis_cjs_namespaceObject = require("./source-analysis.cjs");
-function parseConsumer(filePath) {
-    if (external_node_fs_default().statSync(filePath).size > 1000000) throw new Error(`${filePath}: consumer source exceeds 1 MB analysis budget`);
-    const file = (0, external_source_analysis_cjs_namespaceObject.parseSource)(external_node_fs_default().readFileSync(filePath, 'utf8'), filePath);
-    (0, external_source_analysis_cjs_namespaceObject.traverseSource)(file, {
-        AssignmentExpression (p) {
-            throw new external_source_analysis_cjs_namespaceObject.SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
-        },
-        UpdateExpression (p) {
-            throw new external_source_analysis_cjs_namespaceObject.SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
-        },
-        TSModuleDeclaration () {
-            throw new external_source_analysis_cjs_namespaceObject.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 && types_namespaceObject.isIdentifier(node) ? node.name : void 0;
-const propertyName = (node)=>{
-    if (void 0 !== node && (types_namespaceObject.isIdentifier(node) || types_namespaceObject.isStringLiteral(node) || types_namespaceObject.isNumericLiteral(node))) return types_namespaceObject.isIdentifier(node) ? node.name : String(node.value);
-};
 const accessPath = (node)=>{
     if (types_namespaceObject.isIdentifier(node)) return [
         node.name
@@ -102,201 +69,6 @@ const callExpression = (expression, callee)=>{
     const unwrapped = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
     return types_namespaceObject.isCallExpression(unwrapped) && isAccessPath(unwrapped.callee, callee) ? unwrapped : void 0;
 };
-const localConst = (sourceFile, name)=>{
-    for (const item of sourceFile.program.body){
-        const statement = types_namespaceObject.isExportNamedDeclaration(item) ? item.declaration : item;
-        if (!types_namespaceObject.isVariableDeclaration(statement) || 'const' !== statement.kind) continue;
-        const matches = statement.declarations.filter((declaration)=>types_namespaceObject.isIdentifier(declaration.id, {
-                name
-            }));
-        if (1 === matches.length) return matches[0];
-    }
-};
-const exportedConst = (sourceFile, name)=>{
-    for (const statement of sourceFile.program.body)if (types_namespaceObject.isExportNamedDeclaration(statement) && 'type' !== statement.exportKind) {
-        if (types_namespaceObject.isVariableDeclaration(statement.declaration) && 'const' === statement.declaration.kind) {
-            const declaration = statement.declaration.declarations.find((value)=>types_namespaceObject.isIdentifier(value.id, {
-                    name
-                }));
-            if (declaration) return declaration;
-        }
-        if (!statement.source && statement.specifiers.some((value)=>types_namespaceObject.isExportSpecifier(value) && 'type' !== value.exportKind && types_namespaceObject.isIdentifier(value.local, {
-                name
-            }) && types_namespaceObject.isIdentifier(value.exported, {
-                name
-            }))) return localConst(sourceFile, name);
-    }
-};
-const inside = (file, boundary)=>file === boundary || file.startsWith(`${boundary}${external_node_path_default().sep}`);
-const containingWorkspace = (file)=>{
-    for(let directory = external_node_path_default().dirname(file);; directory = external_node_path_default().dirname(directory)){
-        if (external_node_fs_default().existsSync(external_node_path_default().join(directory, 'pnpm-workspace.yaml'))) return external_node_fs_default().realpathSync(directory);
-        if (directory === external_node_path_default().dirname(directory)) return;
-    }
-};
-const sourceBoundary = (file, workspace)=>{
-    for(let directory = external_node_path_default().dirname(file);; directory = external_node_path_default().dirname(directory)){
-        if (external_node_fs_default().existsSync(external_node_path_default().join(directory, 'package.json')) && directory !== workspace) return external_node_fs_default().realpathSync(directory);
-        if (directory === workspace || directory === external_node_path_default().dirname(directory)) return external_node_fs_default().realpathSync(external_node_path_default().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,
-        external_node_path_default().join(target, 'index.ts'),
-        external_node_path_default().join(target, 'index.tsx')
-    ])try {
-        const real = external_node_fs_default().realpathSync(candidate);
-        if (inside(real, boundary) && external_node_fs_default().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(external_node_path_default().resolve(external_node_path_default().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 = (0, external_node_module_namespaceObject.createRequire)(module.path).resolve.paths(entry.name) ?? [];
-    for (const lookup of paths){
-        const directory = external_node_path_default().join(lookup, entry.name);
-        const manifest = external_node_path_default().join(directory, 'package.json');
-        if (!external_node_fs_default().existsSync(manifest)) continue;
-        const boundary = external_node_fs_default().realpathSync(directory);
-        if (!inside(boundary, workspace) || boundary.split(external_node_path_default().sep).includes('node_modules')) break;
-        const pkg = JSON.parse(external_node_fs_default().readFileSync(manifest, 'utf8'));
-        if (pkg.name !== entry.name || void 0 === pkg.exports) break;
-        let target;
-        try {
-            const targets = (0, external_resolve_exports_namespaceObject.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(external_node_path_default().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 (types_namespaceObject.isImportDeclaration(statement) && 'type' !== statement.importKind) {
-        for (const specifier of statement.specifiers)if (types_namespaceObject.isIdentifier(specifier.local, {
-            name
-        })) {
-            if (types_namespaceObject.isImportSpecifier(specifier) && 'type' !== specifier.importKind) return {
-                imported: propertyName(specifier.imported) ?? name,
-                specifier: statement.source.value
-            };
-            if (types_namespaceObject.isImportDefaultSpecifier(specifier)) return {
-                imported: 'default',
-                specifier: statement.source.value
-            };
-        }
-    }
-};
-const reexportedBinding = (module, name)=>{
-    for (const statement of module.file.program.body){
-        if (!types_namespaceObject.isExportNamedDeclaration(statement) || 'type' === statement.exportKind) continue;
-        const specifier = statement.specifiers.find((value)=>types_namespaceObject.isExportSpecifier(value) && 'type' !== value.exportKind && propertyName(value.exported) === name);
-        if (void 0 !== specifier && types_namespaceObject.isExportSpecifier(specifier)) return {
-            local: types_namespaceObject.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 (!types_namespaceObject.isExportDefaultDeclaration(statement)) continue;
-        const declaration = statement.declaration;
-        if (types_namespaceObject.isIdentifier(declaration)) return declaration.name;
-        return types_namespaceObject.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 (!types_namespaceObject.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 = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
@@ -306,7 +78,7 @@ const propertyAssignments = (properties)=>{
     const assignments = new Map();
     for (const property of properties){
         if (!types_namespaceObject.isObjectProperty(property) || property.computed || property.shorthand) return;
-        const name = propertyName(property.key);
+        const name = (0, external_module_graph_cjs_namespaceObject.propertyName)(property.key);
         if (void 0 === name || assignments.has(name)) return;
         assignments.set(name, property);
     }
@@ -424,9 +196,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: {
@@ -442,9 +218,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();
@@ -466,8 +240,8 @@ const reachableEndpoints = (rootModule, declaration)=>{
         active.add(node);
         try {
             if (types_namespaceObject.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 (!types_namespaceObject.isCallExpression(node) || node.arguments.length < 2 || node.arguments.length > 3) return false;
@@ -522,7 +296,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, [
@@ -615,7 +389,7 @@ const markerSchemaIsShared = (sourceFile, declaration)=>{
         'version'
     ]);
     if (void 0 === schema || schema.identity) return schema?.identity === true;
-    const brandedField = (property, brand)=>identifierName(property.value) === `${brand}Schema` && brandedStringSchemaIsExact(localConst(sourceFile, `${brand}Schema`), brand);
+    const brandedField = (property, brand)=>identifierName(property.value) === `${brand}Schema` && brandedStringSchemaIsExact((0, external_module_graph_cjs_namespaceObject.localConst)(sourceFile, `${brand}Schema`), brand);
     const validators = new Map([
         [
             'appId',
@@ -653,13 +427,13 @@ 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((0, external_source_analysis_cjs_namespaceObject.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`;
     const readinessSchemaName = `${exportStem}ReadinessSchema`;
-    const markerDeclaration = exportedConst(sourceFile, markerSchemaName);
+    const markerDeclaration = (0, external_module_graph_cjs_namespaceObject.exportedConst)(sourceFile, markerSchemaName);
     if (!importsExactBindings(sourceFile, expectation.effectClientPackage, [
         'HttpApi',
         'HttpApiEndpoint',
@@ -668,13 +442,13 @@ const validateParsedContract = (module, stem, expectation)=>{
     ])) return 'MicroVertical root contract must import exact Effect API primitives from the framework client package';
     if (!importsSharedBaselinePrimitives(sourceFile, expectation.baselinePackage)) return 'MicroVertical root contract must import exact baseline primitives from the framework baseline package';
     if (!markerSchemaIsShared(sourceFile, markerDeclaration)) return 'MicroVertical root contract must consume the shared build marker schema without overriding shared fields';
-    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`));
+    if (!readinessSchemaIsShared((0, external_module_graph_cjs_namespaceObject.exportedConst)(sourceFile, readinessSchemaName), markerSchemaName, declarationIsIdentifier(markerDeclaration, 'MicroVerticalBuildMarkerSchema'))) return 'MicroVertical readiness schema must consume the shared readiness schema without overriding shared fields';
+    if (!foundationIsExact((0, external_module_graph_cjs_namespaceObject.exportedConst)(sourceFile, foundationName), stem, readinessSchemaName)) return 'MicroVertical readiness foundation API must directly compose its exact readiness endpoint and foundation identity';
+    if (!rootComposesFoundation(sourceFile, (0, external_module_graph_cjs_namespaceObject.exportedConst)(sourceFile, `${exportStem}Api`), stem, foundationName)) return 'MicroVertical root API must explicitly compose its readiness foundation API';
+    const endpoints = reachableEndpoints(graph, (0, external_module_graph_cjs_namespaceObject.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';
+    if (!operationMapIsConnected((0, external_module_graph_cjs_namespaceObject.exportedConst)(sourceFile, `${exportStem}OperationContexts`), stem, expectation.operationPaths ?? {}, endpoints)) return 'MicroVertical operation map must construct every operation with the shared context constructor';
+    if (!metadataIsExact((0, external_module_graph_cjs_namespaceObject.exportedConst)(sourceFile, `${exportStem}ApiContract`), expectation, endpoints)) return 'MicroVertical root contract must keep exact owner and API path metadata without forbidden fields';
 };
 const configuredMicroVerticalApiStem = (verticalPath, verticals)=>{
     const topologyVertical = verticals.find((vertical)=>(vertical.path ?? `verticals/${vertical.id}`) === verticalPath);
@@ -683,14 +457,9 @@ const configuredMicroVerticalApiStem = (verticalPath, verticals)=>{
 };
 const microVerticalApiBaselineViolation = (stem, filePath, expectation)=>{
     try {
-        const realPath = external_node_fs_default().realpathSync(filePath);
-        const sourceFile = parseConsumer(realPath);
+        const graph = (0, external_module_graph_cjs_namespaceObject.createModuleGraph)(filePath);
         if (!(0, external_microvertical_api_owner_cjs_namespaceObject.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 external_source_analysis_cjs_namespaceObject.SourceSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
         throw error;