@bleedingdev/modern-js-create 3.4.0-ultramodern.12 → 3.4.0-ultramodern.14

package/dist/esm-node/ultramodern-workspace/mf-validation.js

@@ -0,0 +1,518 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+const moduleFederationConfigFile = 'module-federation.config.ts';
+const mfTypesArchive = 'dist/@mf-types.zip';
+const generatedMetadataPaths = [
+    '.modernjs/ultramodern.json',
+    '.modernjs/ultramodern-generated-contract.json'
+];
+const defaultAppRootDirs = [
+    'apps',
+    'verticals'
+];
+const skippedScanDirs = new Set([
+    '.git',
+    '.modernjs',
+    '.nx',
+    '.turbo',
+    'coverage',
+    'dist',
+    'node_modules'
+]);
+function isRecord(value) {
+    return null !== value && 'object' == typeof value && !Array.isArray(value);
+}
+function toPosixPath(value) {
+    return value.split(node_path.sep).join('/');
+}
+function normalizeRelativePath(value) {
+    const normalized = value.replace(/\\/g, '/').replace(/^\.\/+/u, '');
+    const trimmed = normalized.replace(/\/+$/u, '');
+    return '' === trimmed ? '.' : trimmed;
+}
+function relativePath(root, target) {
+    return normalizeRelativePath(toPosixPath(node_path.relative(root, target)));
+}
+function readJsonIfExists(filePath) {
+    if (!node_fs.existsSync(filePath)) return;
+    return JSON.parse(node_fs.readFileSync(filePath, 'utf-8'));
+}
+function addMetadataAppDir(value, appDirs, hint = '') {
+    if (!isRecord(value)) return;
+    const pathValue = 'string' == typeof value.path ? value.path : 'string' == typeof value.directory ? value.directory : void 0;
+    const hasModuleFederationDeclaration = isRecord(value.moduleFederation) || 'string' == typeof value.moduleFederationName || 'apps' === hint || 'verticals' === hint || 'remotes' === hint || 'moduleFederation' === hint;
+    if (pathValue && hasModuleFederationDeclaration && !node_path.isAbsolute(pathValue)) appDirs.add(normalizeRelativePath(pathValue));
+}
+function collectMetadataAppDirs(value, appDirs, hint = '') {
+    if (Array.isArray(value)) {
+        for (const entry of value)collectMetadataAppDirs(entry, appDirs, hint);
+        return;
+    }
+    if (!isRecord(value)) return;
+    addMetadataAppDir(value, appDirs, hint);
+    for (const [key, entry] of Object.entries(value))collectMetadataAppDirs(entry, appDirs, key);
+}
+function literalRootFromPattern(pattern) {
+    const normalized = normalizeRelativePath(pattern);
+    if ('.' === normalized || node_path.isAbsolute(normalized) || normalized.startsWith('../')) return;
+    const segments = normalized.split('/');
+    const literalSegments = [];
+    for (const segment of segments){
+        if (/[*?[\]{}]/u.test(segment)) break;
+        literalSegments.push(segment);
+    }
+    return literalSegments.length > 0 ? literalSegments.join('/') : void 0;
+}
+function collectBridgeScanRoots(value, roots) {
+    if (Array.isArray(value)) {
+        for (const entry of value)collectBridgeScanRoots(entry, roots);
+        return;
+    }
+    if (!isRecord(value)) return;
+    const workspacePackages = value.bridge;
+    if (isRecord(workspacePackages)) {
+        const entries = workspacePackages.workspacePackages;
+        if (Array.isArray(entries)) {
+            for (const entry of entries)if (isRecord(entry) && 'string' == typeof entry.pattern) {
+                const root = literalRootFromPattern(entry.pattern);
+                if (root) roots.add(root);
+            }
+        }
+    }
+    for (const entry of Object.values(value))collectBridgeScanRoots(entry, roots);
+}
+function readGeneratedMetadata(workspaceRoot) {
+    return generatedMetadataPaths.map((metadataPath)=>readJsonIfExists(node_path.join(workspaceRoot, metadataPath))).filter((metadata)=>void 0 !== metadata);
+}
+function firstSegment(appDir) {
+    if ('.' === appDir) return;
+    return appDir.split('/')[0];
+}
+function scanForModuleFederationConfigs(workspaceRoot, scanRoot, appDirs) {
+    const absoluteRoot = node_path.join(workspaceRoot, scanRoot);
+    if (!node_fs.existsSync(absoluteRoot) || !node_fs.statSync(absoluteRoot).isDirectory()) return;
+    const visit = (directory)=>{
+        for (const entry of node_fs.readdirSync(directory, {
+            withFileTypes: true
+        })){
+            if (entry.isDirectory()) {
+                if (!skippedScanDirs.has(entry.name)) visit(node_path.join(directory, entry.name));
+                continue;
+            }
+            if (entry.isFile() && entry.name === moduleFederationConfigFile) appDirs.add(relativePath(workspaceRoot, directory));
+        }
+    };
+    visit(absoluteRoot);
+}
+function discoverModuleFederationConfigs(options) {
+    const workspaceRoot = node_path.resolve(options.workspaceRoot);
+    const appDirs = new Set();
+    if (options.appDirs && options.appDirs.length > 0) for (const appDir of options.appDirs)appDirs.add(normalizeRelativePath(appDir));
+    else {
+        const metadata = readGeneratedMetadata(workspaceRoot);
+        const scanRoots = new Set(defaultAppRootDirs);
+        for (const metadataEntry of metadata){
+            collectMetadataAppDirs(metadataEntry, appDirs);
+            collectBridgeScanRoots(metadataEntry, scanRoots);
+        }
+        for (const appDir of appDirs){
+            const segment = firstSegment(appDir);
+            if (segment) scanRoots.add(segment);
+        }
+        if (node_fs.existsSync(node_path.join(workspaceRoot, moduleFederationConfigFile))) appDirs.add('.');
+        for (const scanRoot of scanRoots)scanForModuleFederationConfigs(workspaceRoot, scanRoot, appDirs);
+    }
+    return Array.from(appDirs).sort().map((appDir)=>({
+            appDir,
+            configPath: node_path.join(workspaceRoot, appDir, moduleFederationConfigFile)
+        }));
+}
+function isEscaped(source, index) {
+    let slashCount = 0;
+    for(let cursor = index - 1; cursor >= 0 && '\\' === source[cursor]; cursor -= 1)slashCount += 1;
+    return slashCount % 2 === 1;
+}
+function skipQuoted(source, start, quote) {
+    for(let index = start + 1; index < source.length; index += 1)if (source[index] === quote && !isEscaped(source, index)) return index + 1;
+    return source.length;
+}
+function skipLineComment(source, start) {
+    const newline = source.indexOf('\n', start + 2);
+    return -1 === newline ? source.length : newline + 1;
+}
+function skipBlockComment(source, start) {
+    const close = source.indexOf('*/', start + 2);
+    return -1 === close ? source.length : close + 2;
+}
+function skipTemplateExpression(source, start) {
+    let depth = 1;
+    for(let index = start + 1; index < source.length; index += 1){
+        const char = source[index];
+        const next = source[index + 1];
+        if ("'" === char) {
+            index = skipQuoted(source, index, "'") - 1;
+            continue;
+        }
+        if ('"' === char) {
+            index = skipQuoted(source, index, '"') - 1;
+            continue;
+        }
+        if ('`' === char) {
+            index = skipTemplate(source, index) - 1;
+            continue;
+        }
+        if ('/' === char && '/' === next) {
+            index = skipLineComment(source, index) - 1;
+            continue;
+        }
+        if ('/' === char && '*' === next) {
+            index = skipBlockComment(source, index) - 1;
+            continue;
+        }
+        if ('{' === char) {
+            depth += 1;
+            continue;
+        }
+        if ('}' === char) {
+            depth -= 1;
+            if (0 === depth) return index + 1;
+        }
+    }
+    return source.length;
+}
+function skipTemplate(source, start) {
+    for(let index = start + 1; index < source.length; index += 1){
+        const char = source[index];
+        const next = source[index + 1];
+        if ('`' === char && !isEscaped(source, index)) return index + 1;
+        if ('$' === char && '{' === next && !isEscaped(source, index)) index = skipTemplateExpression(source, index + 1) - 1;
+    }
+    return source.length;
+}
+function skipSyntax(source, index) {
+    const char = source[index];
+    const next = source[index + 1];
+    if ("'" === char) return skipQuoted(source, index, "'");
+    if ('"' === char) return skipQuoted(source, index, '"');
+    if ('`' === char) return skipTemplate(source, index);
+    if ('/' === char && '/' === next) return skipLineComment(source, index);
+    if ('/' === char && '*' === next) return skipBlockComment(source, index);
+    return index;
+}
+function findBalanced(source, start, open, close) {
+    let depth = 1;
+    for(let index = start + 1; index < source.length; index += 1){
+        const skipped = skipSyntax(source, index);
+        if (skipped !== index) {
+            index = skipped - 1;
+            continue;
+        }
+        if (source[index] === open) {
+            depth += 1;
+            continue;
+        }
+        if (source[index] === close) {
+            depth -= 1;
+            if (0 === depth) return index;
+        }
+    }
+}
+function skipWhitespaceAndComments(source, start) {
+    let index = start;
+    while(index < source.length){
+        const char = source[index];
+        const next = source[index + 1];
+        if (/\s/u.test(char ?? '')) {
+            index += 1;
+            continue;
+        }
+        if ('/' === char && '/' === next) {
+            index = skipLineComment(source, index);
+            continue;
+        }
+        if ('/' === char && '*' === next) {
+            index = skipBlockComment(source, index);
+            continue;
+        }
+        break;
+    }
+    return index;
+}
+function hasIdentifierBoundary(source, start, end) {
+    return !/[$\w]/u.test(source[start - 1] ?? '') && !/[$\w]/u.test(source[end] ?? '');
+}
+function findCreateModuleFederationConfigObject(source) {
+    const callee = 'createModuleFederationConfig';
+    let offset = 0;
+    while(offset < source.length){
+        const index = source.indexOf(callee, offset);
+        if (-1 === index) break;
+        offset = index + callee.length;
+        if (!hasIdentifierBoundary(source, index, offset)) continue;
+        const parenIndex = skipWhitespaceAndComments(source, offset);
+        if ('(' !== source[parenIndex]) continue;
+        const argumentIndex = skipWhitespaceAndComments(source, parenIndex + 1);
+        if ('{' !== source[argumentIndex]) throw new Error('Module Federation config must pass a static object literal to createModuleFederationConfig.');
+        const closeIndex = findBalanced(source, argumentIndex, '{', '}');
+        if (void 0 === closeIndex) throw new Error('Module Federation config object literal is not closed.');
+        return source.slice(argumentIndex, closeIndex + 1);
+    }
+}
+function findExportDefaultObject(source) {
+    const exportDefault = 'export default';
+    const index = source.indexOf(exportDefault);
+    if (-1 === index) return;
+    const objectStart = skipWhitespaceAndComments(source, index + exportDefault.length);
+    if ('{' !== source[objectStart]) return;
+    const objectEnd = findBalanced(source, objectStart, '{', '}');
+    if (void 0 === objectEnd) throw new Error('Module Federation export default object is not closed.');
+    return source.slice(objectStart, objectEnd + 1);
+}
+function getOuterBlock(source, open, close) {
+    const trimmed = source.trim();
+    if (trimmed[0] !== open) return;
+    const end = findBalanced(trimmed, 0, open, close);
+    if (void 0 === end) return;
+    const suffix = trimmed.slice(end + 1).trim();
+    if ('' !== suffix && !suffix.startsWith('as ') && !suffix.startsWith('satisfies ')) return;
+    return {
+        inner: trimmed.slice(1, end),
+        suffix
+    };
+}
+function splitTopLevelEntries(source) {
+    const entries = [];
+    let start = 0;
+    let braceDepth = 0;
+    let bracketDepth = 0;
+    let parenDepth = 0;
+    for(let index = 0; index < source.length; index += 1){
+        const skipped = skipSyntax(source, index);
+        if (skipped !== index) {
+            index = skipped - 1;
+            continue;
+        }
+        const char = source[index];
+        if ('{' === char) braceDepth += 1;
+        else if ('}' === char) braceDepth -= 1;
+        else if ('[' === char) bracketDepth += 1;
+        else if (']' === char) bracketDepth -= 1;
+        else if ('(' === char) parenDepth += 1;
+        else if (')' === char) parenDepth -= 1;
+        else if (',' === char && 0 === braceDepth && 0 === bracketDepth && 0 === parenDepth) {
+            const entry = source.slice(start, index).trim();
+            if (entry) entries.push(entry);
+            start = index + 1;
+        }
+    }
+    const finalEntry = source.slice(start).trim();
+    if (finalEntry) entries.push(finalEntry);
+    return entries;
+}
+function findTopLevelColon(source) {
+    let braceDepth = 0;
+    let bracketDepth = 0;
+    let parenDepth = 0;
+    for(let index = 0; index < source.length; index += 1){
+        const skipped = skipSyntax(source, index);
+        if (skipped !== index) {
+            index = skipped - 1;
+            continue;
+        }
+        const char = source[index];
+        if ('{' === char) braceDepth += 1;
+        else if ('}' === char) braceDepth -= 1;
+        else if ('[' === char) bracketDepth += 1;
+        else if (']' === char) bracketDepth -= 1;
+        else if ('(' === char) parenDepth += 1;
+        else if (')' === char) parenDepth -= 1;
+        else if (':' === char && 0 === braceDepth && 0 === bracketDepth && 0 === parenDepth) return index;
+    }
+    return -1;
+}
+function stripConstAssertion(source) {
+    return source.trim().replace(/\s+as\s+const\s*$/u, '').trim();
+}
+function unescapeSingleQuotedString(value) {
+    return value.replace(/\\(['"\\nrtbfv0])/gu, (_, sequence)=>{
+        switch(sequence){
+            case 'n':
+                return '\n';
+            case 'r':
+                return '\r';
+            case 't':
+                return '\t';
+            case 'b':
+                return '\b';
+            case 'f':
+                return '\f';
+            case 'v':
+                return '\v';
+            case '0':
+                return '\0';
+            default:
+                return sequence;
+        }
+    });
+}
+function parseLiteralString(source) {
+    if (void 0 === source) return;
+    const trimmed = stripConstAssertion(source);
+    const quote = trimmed[0];
+    if ("'" !== quote && '"' !== quote && '`' !== quote) return;
+    if ('`' === quote) {
+        if (trimmed.includes('${')) return;
+        const close = trimmed.lastIndexOf('`');
+        return close > 0 ? trimmed.slice(1, close).replaceAll('\\`', '`') : void 0;
+    }
+    const close = trimmed.lastIndexOf(quote);
+    if (close <= 0 || '' !== trimmed.slice(close + 1).trim()) return;
+    const content = trimmed.slice(1, close);
+    if ('"' === quote) try {
+        return JSON.parse(trimmed);
+    } catch  {
+        return;
+    }
+    return unescapeSingleQuotedString(content);
+}
+function parseObjectKey(source) {
+    const trimmed = source.trim();
+    const literal = parseLiteralString(trimmed);
+    if (void 0 !== literal) return literal;
+    return /^[$A-Z_a-z][$\w]*$/u.test(trimmed) ? trimmed : void 0;
+}
+function parseObjectLiteral(source) {
+    if (void 0 === source) return;
+    const block = getOuterBlock(source, '{', '}');
+    if (!block) return;
+    const properties = new Map();
+    let hasSpread = false;
+    for (const entry of splitTopLevelEntries(block.inner)){
+        if (entry.startsWith('...')) {
+            hasSpread = true;
+            continue;
+        }
+        const colon = findTopLevelColon(entry);
+        if (-1 === colon) {
+            hasSpread = true;
+            continue;
+        }
+        const key = parseObjectKey(entry.slice(0, colon));
+        if (void 0 === key) {
+            hasSpread = true;
+            continue;
+        }
+        properties.set(key, entry.slice(colon + 1).trim());
+    }
+    return {
+        hasSpread,
+        properties
+    };
+}
+function parseArrayLiteral(source) {
+    if (void 0 === source) return;
+    const block = getOuterBlock(source, '[', ']');
+    if (!block) return;
+    const entries = splitTopLevelEntries(block.inner);
+    const exposes = [];
+    for (const entry of entries){
+        const expose = parseLiteralString(entry);
+        if (void 0 === expose) return;
+        exposes.push(expose);
+    }
+    return exposes;
+}
+function extractExposes(configPath, value) {
+    if (void 0 === value) return [];
+    const object = parseObjectLiteral(value);
+    if (object) {
+        if (object.hasSpread) throw new Error(`Cannot statically extract Module Federation exposes from ${configPath}; use a literal exposes object without spreads.`);
+        return Array.from(object.properties.keys()).sort();
+    }
+    const array = parseArrayLiteral(value);
+    if (array) return array.sort();
+    throw new Error(`Cannot statically extract Module Federation exposes from ${configPath}; use a literal exposes object or string array.`);
+}
+function extractDtsSettings(configPath, value) {
+    if (void 0 === value) return {};
+    const dts = parseObjectLiteral(value);
+    if (!dts || dts.hasSpread) throw new Error(`Cannot statically extract Module Federation DTS settings from ${configPath}; use a literal dts object.`);
+    const generateTypes = parseObjectLiteral(dts.properties.get('generateTypes'));
+    if (generateTypes?.hasSpread) throw new Error(`Cannot statically extract Module Federation generateTypes settings from ${configPath}; use a literal generateTypes object.`);
+    return {
+        compilerInstance: parseLiteralString(generateTypes?.properties.get('compilerInstance')),
+        tsConfigPath: parseLiteralString(dts.properties.get('tsConfigPath'))
+    };
+}
+function hasHostOnlyNoExposesDeclaration(source) {
+    return /@?ultramodern-mf\s*:?\s*(?:host-only|no-exposes)\b/iu.test(source);
+}
+function inspectModuleFederationConfigSource(source, appDir, configPath) {
+    const configObject = findCreateModuleFederationConfigObject(source) ?? findExportDefaultObject(source);
+    if (!configObject) throw new Error(`Cannot statically inspect Module Federation config ${configPath}; export or pass a literal config object.`);
+    const properties = parseObjectLiteral(configObject);
+    if (!properties) throw new Error(`Cannot statically inspect Module Federation config ${configPath}; expected a literal config object.`);
+    if (properties.hasSpread) throw new Error(`Cannot statically inspect Module Federation config ${configPath}; top-level config spreads are not supported.`);
+    const exposes = extractExposes(configPath, properties.properties.get('exposes'));
+    const hostOnlyNoExposes = hasHostOnlyNoExposesDeclaration(source);
+    if (hostOnlyNoExposes && exposes.length > 0) throw new Error(`Module Federation host-only/no-exposes declaration conflicts with actual exposes in ${configPath}.`);
+    return {
+        appDir,
+        configPath,
+        dts: extractDtsSettings(configPath, properties.properties.get('dts')),
+        exposes,
+        hostOnlyNoExposes
+    };
+}
+function assertExposedAppDtsSettings(app) {
+    if ('tsgo' !== app.dts.compilerInstance) throw new Error(`Module Federation DTS compilerInstance must be "tsgo" for ${app.appDir}.`);
+    if ('./tsconfig.mf-types.json' !== app.dts.tsConfigPath) throw new Error(`Module Federation DTS tsConfigPath must be "./tsconfig.mf-types.json" for ${app.appDir}.`);
+}
+function assertTypesArchive(workspaceRoot, appDir) {
+    const typesArchivePath = node_path.join(workspaceRoot, appDir, mfTypesArchive);
+    if (!node_fs.existsSync(typesArchivePath)) throw new Error(`Missing Module Federation DTS archive: ${relativePath(workspaceRoot, typesArchivePath)}`);
+    if (0 === node_fs.statSync(typesArchivePath).size) throw new Error(`Empty Module Federation DTS archive: ${relativePath(workspaceRoot, typesArchivePath)}`);
+}
+function validateModuleFederationTypes(options) {
+    const workspaceRoot = node_path.resolve(options.workspaceRoot);
+    const discoveredConfigs = discoverModuleFederationConfigs({
+        ...options,
+        workspaceRoot
+    });
+    const apps = [];
+    const missingConfigPaths = [];
+    for (const discoveredConfig of discoveredConfigs){
+        if (!node_fs.existsSync(discoveredConfig.configPath)) {
+            missingConfigPaths.push(relativePath(workspaceRoot, discoveredConfig.configPath));
+            continue;
+        }
+        const configPath = relativePath(workspaceRoot, discoveredConfig.configPath);
+        apps.push(inspectModuleFederationConfigSource(node_fs.readFileSync(discoveredConfig.configPath, 'utf-8'), discoveredConfig.appDir, configPath));
+    }
+    if (missingConfigPaths.length > 0) throw new Error(`Missing Module Federation config: ${missingConfigPaths.join(', ')}`);
+    const noExposeApps = apps.filter((app)=>0 === app.exposes.length && !app.hostOnlyNoExposes);
+    if (noExposeApps.length > 0) {
+        const suffix = 0 === apps.filter((app)=>app.exposes.length > 0).length ? ' Validation would otherwise validate zero exposed apps.' : '';
+        throw new Error(`Module Federation configs declare no exposes without an explicit host-only/no-exposes declaration: ${noExposeApps.map((app)=>app.appDir).join(', ')}.${suffix}`);
+    }
+    let exposedAppCount = 0;
+    let hostOnlyAppCount = 0;
+    for (const app of apps){
+        if (app.hostOnlyNoExposes) {
+            hostOnlyAppCount += 1;
+            continue;
+        }
+        assertExposedAppDtsSettings(app);
+        assertTypesArchive(workspaceRoot, app.appDir);
+        exposedAppCount += 1;
+    }
+    if (apps.length > 0 && 0 === exposedAppCount && hostOnlyAppCount !== apps.length) throw new Error('Module Federation validation inspected configs but validated zero exposed apps. Declare host-only/no-exposes intent only for host apps without exposes.');
+    return {
+        apps,
+        configCount: apps.length,
+        exposedAppCount,
+        hostOnlyAppCount
+    };
+}
+export { discoverModuleFederationConfigs, inspectModuleFederationConfigSource, validateModuleFederationTypes };

package/dist/esm-node/ultramodern-workspace/module-federation.js

@@ -65,6 +65,8 @@ const configuredSiteUrl = envValue('MODERN_PUBLIC_SITE_URL');
 const configuredCloudflareUrl = envValue('${createCloudflarePublicUrlEnv(app)}');
 const configuredUltramodernAssetPrefix = envValue('ULTRAMODERN_ASSET_PREFIX');
 const configuredModernAssetPrefix = envValue('MODERN_ASSET_PREFIX');
+const moduleFederationDevServerOrigin =
+  envValue('ULTRAMODERN_MF_DEV_ORIGIN') || 'http://localhost:${shellApp.port}';
 const cloudflareWorkersDevSubdomain = envValue(
   'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN',
 );
@@ -188,6 +190,9 @@ ${bffPluginEntry}        moduleFederationPlugin(),
         },
         mainEntryName: 'index',
       },
+      splitChunks: {
+        chunks: 'async',
+      },
       tools: {
         autoprefixer: {
           overrideBrowserslist: ['defaults'],
@@ -197,6 +202,14 @@ ${bffPluginEntry}        moduleFederationPlugin(),
             .uniqueName('${createRspackUniqueName(app)}')
             .chunkLoadingGlobal('${createRspackChunkLoadingGlobal(app)}');
         },
+        devServer: {
+          headers: {
+            'Access-Control-Allow-Headers':
+              'Accept, Authorization, Content-Type, X-Requested-With',
+            'Access-Control-Allow-Methods': 'GET, HEAD, OPTIONS',
+            'Access-Control-Allow-Origin': moduleFederationDevServerOrigin,
+          },
+        },
       },
     },
     {
@@ -320,6 +333,7 @@ function createShellModuleFederationConfig(scope, remotes = []) {
         verticalRefs: remotes.map((remote)=>remote.id)
     };
     return `// @effect-diagnostics nodeBuiltinImport:off processEnv:off
+// ultramodern-mf: host-only
 import { createRequire } from 'node:module';
 import { createModuleFederationConfig } from '@module-federation/modern-js-v3';
 import { dependencies } from './package.json';

package/dist/esm-node/ultramodern-workspace/package-json.js

@@ -81,7 +81,7 @@ const effectDiagnostics = [
     'unnecessaryPipe',
     'unnecessaryPipeChain'
 ];
-function appDependencies(scope, packageSource, app, remotes = []) {
+function appDependencies(scope, packageSource, app, remotes = [], bridge) {
     const dependencies = {
         '@modern-js/plugin-tanstack': modernPackageSpecifier('@modern-js/plugin-tanstack', packageSource),
         '@modern-js/plugin-i18n': modernPackageSpecifier('@modern-js/plugin-i18n', packageSource),
@@ -98,6 +98,7 @@ function appDependencies(scope, packageSource, app, remotes = []) {
         'react-dom': REACT_DOM_VERSION,
         'react-router': REACT_ROUTER_VERSION
     };
+    for (const dependency of bridge?.dependencies ?? [])dependencies[dependency] = WORKSPACE_PACKAGE_VERSION;
     if ('shell' === app.kind) {
         dependencies['@modern-js/plugin-bff'] = modernPackageSpecifier('@modern-js/plugin-bff', packageSource);
         for (const remote of verticalEffectApps(remotes))dependencies[packageName(scope, remote.packageSuffix)] = WORKSPACE_PACKAGE_VERSION;
@@ -124,12 +125,28 @@ function appDevDependencies(packageSource, enableTailwind) {
         wrangler: WRANGLER_VERSION
     };
 }
-function createRootPackageJson(scope, packageSource, remotes = []) {
+function createRootPackageJson(scope, packageSource, remotes = [], bridge) {
     const shellFilter = `--filter ${packageName(scope, shellApp.packageSuffix)}`;
     const remoteFilters = remotes.map((remote)=>`--filter ${packageName(scope, remote.packageSuffix)}`);
     const remoteBuildPrefix = remotes.length > 0 ? 'ULTRAMODERN_ZEPHYR=false pnpm -r --filter "./verticals/*" run build && ' : '';
     const remoteCloudflareBuildPrefix = remotes.length > 0 ? 'pnpm -r --filter "./verticals/*" run cloudflare:build && ' : '';
     const remoteCloudflareDeployPrefix = remotes.length > 0 ? 'pnpm -r --filter "./verticals/*" run cloudflare:deploy && ' : '';
+    const generatedPackageTypecheck = 'pnpm -r --filter "./apps/*" --filter "./verticals/*" --filter "./packages/*" run typecheck';
+    const typecheck = bridge ? generatedPackageTypecheck : "node ./scripts/ultramodern-typecheck.mjs --build tsconfig.json";
+    const bridgeScripts = bridge ? {
+        ...Object.fromEntries(bridge.gates.map((gate)=>[
+                `bridge:${gate.name}`,
+                `${gate.cwd ? `cd ${gate.cwd} && ` : ''}${gate.command}`
+            ])),
+        'bridge:check': bridge.gates.map((gate)=>`pnpm run bridge:${gate.name}`).join(' && ')
+    } : {};
+    const bridgeCheck = bridge ? ' && pnpm bridge:check' : '';
+    const workspacePackages = [
+        'apps/*',
+        'verticals/*',
+        'packages/*',
+        ...bridge?.workspacePackages.map((entry)=>entry.pattern) ?? []
+    ];
     return {
         private: true,
         name: scope,
@@ -151,7 +168,7 @@ function createRootPackageJson(scope, packageSource, remotes = []) {
             'format:check': "oxfmt --check . '!repos/**'",
             lint: 'oxlint apps verticals packages',
             'lint:fix': 'oxlint apps verticals packages --fix',
-            typecheck: "node ./scripts/ultramodern-typecheck.mjs --build tsconfig.json",
+            typecheck,
             'cloudflare:build': `${remoteCloudflareBuildPrefix}pnpm --filter "./apps/shell-super-app" run cloudflare:build && pnpm mf:types`,
             'cloudflare:deploy': `${remoteCloudflareDeployPrefix}pnpm --filter "./apps/shell-super-app" run cloudflare:deploy`,
             'cloudflare:proof': "node ./scripts/proof-cloudflare-version.mjs --out .codex/reports/cloudflare-version-proof/public-url-proof.json",
@@ -163,18 +180,15 @@ function createRootPackageJson(scope, packageSource, remotes = []) {
             'performance:readiness': "node ./scripts/ultramodern-performance-readiness.mjs",
             'contract:check': "node ./scripts/validate-ultramodern-workspace.mjs",
             'i18n:boundaries': "node ./scripts/check-ultramodern-i18n-boundaries.mjs",
+            ...bridgeScripts,
             postinstall: "oxfmt . '!repos/**' && node ./scripts/bootstrap-agent-skills.mjs --postinstall",
-            check: 'pnpm format:check && pnpm lint && pnpm typecheck && pnpm skills:check && pnpm i18n:boundaries && pnpm contract:check && pnpm performance:readiness'
+            check: `pnpm format:check && pnpm lint && pnpm typecheck && pnpm skills:check && pnpm i18n:boundaries && pnpm contract:check && pnpm performance:readiness${bridgeCheck}`
         },
         engines: {
             node: '>=26',
             pnpm: '>=11'
         },
-        workspaces: [
-            'apps/*',
-            'verticals/*',
-            'packages/*'
-        ],
+        workspaces: workspacePackages,
         modernjs: {
             preset: 'presetUltramodern',
             workspace: 'ultramodern-superapp',
@@ -182,7 +196,7 @@ function createRootPackageJson(scope, packageSource, remotes = []) {
             ownership: './topology/ownership.json',
             packageSource: {
                 strategy: packageSource.strategy,
-                config: './.modernjs/ultramodern-package-source.json'
+                config: './.modernjs/ultramodern.json#packageSource'
             }
         },
         devDependencies: {
@@ -340,7 +354,7 @@ function createRootTsConfig(apps = []) {
         ]
     };
 }
-function createAppPackage(scope, app, packageSource, enableTailwind, remotes = []) {
+function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [], bridge) {
     const publicSurfaceBuildCommand = createPublicSurfaceGenerationCommand(app, 'dist');
     const publicSurfaceCloudflareBuildCommand = createPublicSurfaceGenerationCommand(app, 'dist');
     const publicSurfaceCloudflareOutputCommand = createPublicSurfaceGenerationCommand(app, 'cloudflare');
@@ -372,7 +386,7 @@ function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [
             } : {}
         },
         'zephyr:dependencies': createZephyrDependencies(scope, app, remotes),
-        dependencies: appDependencies(scope, packageSource, app, remotes),
+        dependencies: appDependencies(scope, packageSource, app, remotes, bridge),
         devDependencies: appDevDependencies(packageSource, enableTailwind)
     };
     if (appHasEffectApi(app)) Object.assign(packageExports, {

package/dist/esm-node/ultramodern-workspace/public-api.js

@@ -1,3 +1,4 @@
 import "node:module";
 export { addUltramodernVertical, planUltramodernVertical } from "./add-vertical.js";
+export { normalizeUltramodernBridgeConfig } from "./bridge-config.js";
 export { generateUltramodernWorkspace } from "./write-workspace.js";