@bleedingdev/modern-js-create 3.4.0-ultramodern.9 → 3.5.0-ultramodern.1

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

@@ -1,11 +1,12 @@
 import "node:module";
 import node_fs from "node:fs";
+import { createApiClient, createApiServiceEntry, createSharedApi, createShellApiClient } from "./api.js";
 import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createPostcssConfig, createSharedDesignTokensCss, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
-import { createDevelopmentOverlay, createGeneratedContract, createOwnership, createPackageSourceMetadata, createTemplateManifest, createTopology } from "./contracts.js";
+import { normalizeUltramodernBridgeConfig } from "./bridge-config.js";
+import { createDevelopmentOverlay, createOwnership, createTopology, createUltramodernConfig } from "./contracts.js";
 import { createLayout, createRemoteEntry, createRemoteExposeComponent, createRemotePage, createShellPage, createShellRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
-import { GENERATED_CONTRACT_PATH, appHasEffectApi, appI18nNamespace, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
-import { createEffectClient, createEffectServiceEntry, createEffectSharedApi, createShellEffectClient } from "./effect-api.js";
-import { copyRootTemplate, writeFile, writeJson } from "./fs-io.js";
+import { ULTRAMODERN_CONFIG_PATH, appHasApi, appI18nNamespace, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
+import { copyRootTemplate, formatGeneratedWorkspaceFiles, writeFile, writeFileReplacing, writeJson } from "./fs-io.js";
 import { createFileSnapshot, createGenerationResult, diffFileSnapshots } from "./generation-result.js";
 import { createAppPublicLocaleMessages } from "./locales.js";
 import { createAppModernConfig, createRemoteModuleFederationConfig, createShellModuleFederationConfig, createUltramodernBuildModule, createUltramodernBuildReexportModule } from "./module-federation.js";
@@ -14,15 +15,15 @@ import { runCodeSmithOverlays } from "./overlays.js";
 import { createAppMfTypesTsConfig, createAppPackage, createAppTsConfig, createRootPackageJson, createRootTsConfig, createSharedContractsIndex, createSharedPackage, createSharedPackageTsConfig, createTsConfigBase } from "./package-json.js";
 import { resolvePackageSource } from "./package-source.js";
 import { createPublicWebAppArtifacts } from "./public-surface.js";
-import { NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
+import { EFFECT_VERSION, EFFECT_VITEST_VERSION, NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
 import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
-function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = []) {
+function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = [], bridge) {
     const resolvedApp = 'shell' === app.kind ? createShellHost(remotes) : app;
     const publicWeb = createPublicWebAppArtifacts(resolvedApp);
     const writeAppFile = (relativePath, content)=>{
         writeFile(targetDir, `${resolvedApp.directory}/${relativePath}`, content);
     };
-    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes, bridge));
     writeJson(targetDir, `${resolvedApp.directory}/tsconfig.json`, createAppTsConfig(resolvedApp, remotes));
     writeJson(targetDir, `${resolvedApp.directory}/tsconfig.mf-types.json`, createAppMfTypesTsConfig(resolvedApp));
     writeFile(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(resolvedApp, remotes));
@@ -50,12 +51,12 @@ function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes
     if ('shell' === resolvedApp.kind) {
         writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(scope, remotes));
         writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent());
-        writeFile(targetDir, `${resolvedApp.directory}/src/effect/vertical-clients.ts`, createShellEffectClient(scope, remotes));
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, remotes));
     }
-    if (appHasEffectApi(resolvedApp)) {
-        writeFile(targetDir, `${resolvedApp.directory}/shared/effect/api.ts`, createEffectSharedApi(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/api/effect/index.ts`, createEffectServiceEntry(resolvedApp, '../../shared/effect/api.ts'));
-        writeFile(targetDir, `${resolvedApp.directory}/src/effect/${resolvedApp.effectApi.stem}-client.ts`, createEffectClient(resolvedApp, '../../shared/effect/api'));
+    if (appHasApi(resolvedApp)) {
+        writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, '../shared/api.ts'));
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api'));
     }
     if ('vertical' === resolvedApp.kind) {
         writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));
@@ -81,10 +82,36 @@ function writeSharedPackages(targetDir, scope) {
 `);
     writeFile(targetDir, 'packages/shared-design-tokens/src/tokens.css', createSharedDesignTokensCss());
 }
+function createCompactRootPackageJson(scope, packageSource, remotes, bridge) {
+    const rootPackage = createRootPackageJson(scope, packageSource, remotes, bridge);
+    if (rootPackage.modernjs?.packageSource && 'object' == typeof rootPackage.modernjs.packageSource) rootPackage.modernjs.packageSource.config = `./${ULTRAMODERN_CONFIG_PATH}`;
+    return rootPackage;
+}
+function createCompactUltramodernConfig(scope, modernVersion, packageSource, apps = [
+    createShellHost()
+], enableTailwind = true, bridge) {
+    const config = createUltramodernConfig(scope, modernVersion, packageSource, apps, enableTailwind, bridge);
+    if (config.packageSource && 'object' == typeof config.packageSource && !Array.isArray(config.packageSource)) delete config.packageSource.metadata;
+    return config;
+}
+function writePnpmWorkspacePackages(targetDir, bridge) {
+    if (!bridge) return;
+    const pnpmWorkspacePath = `${targetDir}/pnpm-workspace.yaml`;
+    const pnpmWorkspace = node_fs.readFileSync(pnpmWorkspacePath, 'utf-8');
+    const packages = [
+        'apps/*',
+        'verticals/*',
+        'packages/*',
+        ...bridge.workspacePackages.map((entry)=>entry.pattern)
+    ];
+    const renderedPackages = packages.map((pattern)=>`  - ${pattern}`).join('\n');
+    writeFileReplacing(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\n(?: {2}- .+\n)+/u, `packages:\n${renderedPackages}\n`));
+}
 function generateUltramodernWorkspace(options) {
     const beforeFiles = createFileSnapshot(options.targetDir);
     const scope = toPackageScope(options.packageName);
     const packageSource = resolvePackageSource(options);
+    const bridge = normalizeUltramodernBridgeConfig(options.bridge);
     const enableTailwind = false !== options.enableTailwind;
     const initialVerticals = [];
     const createdApps = [
@@ -104,39 +131,52 @@ function generateUltramodernWorkspace(options) {
         nodeVersion: NODE_VERSION,
         pnpmVersion: PNPM_VERSION,
         nodeFetchVersion: NODE_FETCH_VERSION,
+        effectVersion: EFFECT_VERSION,
+        effectVitestVersion: EFFECT_VITEST_VERSION,
+        tanstackRouterCoreVersion: TANSTACK_ROUTER_CORE_VERSION,
         tanstackRouterVersion: TANSTACK_ROUTER_VERSION,
         typescriptVersion: TYPESCRIPT_VERSION,
         tailwindEnabled: String(enableTailwind)
     });
-    writeJson(options.targetDir, 'package.json', createRootPackageJson(scope, packageSource, initialVerticals));
+    writePnpmWorkspacePackages(options.targetDir, bridge);
+    writeJson(options.targetDir, 'package.json', createCompactRootPackageJson(scope, packageSource, initialVerticals, bridge));
     writeJson(options.targetDir, 'tsconfig.base.json', createTsConfigBase());
     writeJson(options.targetDir, 'tsconfig.json', createRootTsConfig(createdApps));
     writeJson(options.targetDir, 'topology/reference-topology.json', createTopology(scope, initialVerticals));
     writeJson(options.targetDir, 'topology/ownership.json', createOwnership(scope, initialVerticals));
     writeJson(options.targetDir, 'topology/local-overlays/development.json', createDevelopmentOverlay(initialVerticals));
-    writeJson(options.targetDir, '.modernjs/ultramodern-workspace-template-manifest.json', createTemplateManifest(options.modernVersion, packageSource));
-    writeJson(options.targetDir, '.modernjs/ultramodern-package-source.json', createPackageSourceMetadata(scope, packageSource));
-    writeJson(options.targetDir, GENERATED_CONTRACT_PATH, createGeneratedContract(scope, createdApps, enableTailwind));
-    writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals);
-    for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals);
+    writeJson(options.targetDir, ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
+    writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals, bridge);
+    for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
     writeSharedPackages(options.targetDir, scope);
     writeGeneratedWorkspaceScripts(options.targetDir, scope, enableTailwind, initialVerticals);
-    const afterFiles = createFileSnapshot(options.targetDir);
-    const { createdPaths, rewrittenPaths } = diffFileSnapshots(beforeFiles, afterFiles);
-    const result = createGenerationResult({
+    const preliminaryAfterFiles = createFileSnapshot(options.targetDir);
+    const preliminaryDiff = diffFileSnapshots(beforeFiles, preliminaryAfterFiles);
+    const preliminaryResult = createGenerationResult({
         operation: 'workspace',
         workspaceRoot: options.targetDir,
         packageScope: scope,
         packageSource,
         createdApps,
-        createdPaths,
-        rewrittenPaths
+        createdPaths: preliminaryDiff.createdPaths,
+        rewrittenPaths: preliminaryDiff.rewrittenPaths
     });
     runCodeSmithOverlays({
         workspaceRoot: options.targetDir,
         overlays: options.overlays,
-        result
+        result: preliminaryResult
+    });
+    formatGeneratedWorkspaceFiles(options.targetDir);
+    const afterFiles = createFileSnapshot(options.targetDir);
+    const { createdPaths, rewrittenPaths } = diffFileSnapshots(beforeFiles, afterFiles);
+    return createGenerationResult({
+        operation: 'workspace',
+        workspaceRoot: options.targetDir,
+        packageScope: scope,
+        packageSource,
+        createdApps,
+        createdPaths,
+        rewrittenPaths
     });
-    return result;
 }
-export { generateUltramodernWorkspace, writeApp, writeSharedPackages };
+export { createCompactUltramodernConfig, generateUltramodernWorkspace, writeApp, writeSharedPackages };

package/dist/types/locale/en.d.ts

@@ -38,6 +38,16 @@ export declare const EN_LOCALE: {
         optionUltramodernPackageRegistry: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
+        optionBridge: string;
+        optionBridgeParentRoot: string;
+        optionBridgeWorkspacePackage: string;
+        optionBridgeWorkspacePackageName: string;
+        optionBridgeTestAlias: string;
+        optionBridgeDependency: string;
+        optionBridgeLockfilePolicy: string;
+        optionBridgeGate: string;
+        optionBridgeGateCwd: string;
+        optionBridgeReactSingleton: string;
         optionVertical: string;
         optionVerticalName: string;
         optionDryRun: string;

package/dist/types/locale/index.d.ts

@@ -40,6 +40,16 @@ declare const localeKeys: {
         optionUltramodernPackageRegistry: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
+        optionBridge: string;
+        optionBridgeParentRoot: string;
+        optionBridgeWorkspacePackage: string;
+        optionBridgeWorkspacePackageName: string;
+        optionBridgeTestAlias: string;
+        optionBridgeDependency: string;
+        optionBridgeLockfilePolicy: string;
+        optionBridgeGate: string;
+        optionBridgeGateCwd: string;
+        optionBridgeReactSingleton: string;
         optionVertical: string;
         optionVerticalName: string;
         optionDryRun: string;
@@ -101,6 +111,16 @@ declare const localeKeys: {
         optionUltramodernPackageRegistry: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
+        optionBridge: string;
+        optionBridgeParentRoot: string;
+        optionBridgeWorkspacePackage: string;
+        optionBridgeWorkspacePackageName: string;
+        optionBridgeTestAlias: string;
+        optionBridgeDependency: string;
+        optionBridgeLockfilePolicy: string;
+        optionBridgeGate: string;
+        optionBridgeGateCwd: string;
+        optionBridgeReactSingleton: string;
         optionVertical: string;
         optionVerticalName: string;
         optionDryRun: string;

package/dist/types/locale/zh.d.ts

@@ -38,6 +38,16 @@ export declare const ZH_LOCALE: {
         optionUltramodernPackageRegistry: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
+        optionBridge: string;
+        optionBridgeParentRoot: string;
+        optionBridgeWorkspacePackage: string;
+        optionBridgeWorkspacePackageName: string;
+        optionBridgeTestAlias: string;
+        optionBridgeDependency: string;
+        optionBridgeLockfilePolicy: string;
+        optionBridgeGate: string;
+        optionBridgeGateCwd: string;
+        optionBridgeReactSingleton: string;
         optionVertical: string;
         optionVerticalName: string;
         optionDryRun: string;

package/dist/types/ultramodern-tooling/commands.d.ts

@@ -0,0 +1 @@
+export declare function runUltramodernToolingCli(args: string[], workspaceRoot?: any): Promise<number>;

package/dist/types/ultramodern-tooling/config.d.ts

@@ -0,0 +1,43 @@
+import { type UltramodernBridgeConfig } from '../ultramodern-workspace/bridge-config';
+import type { ResolvedPackageSource, WorkspaceApi, WorkspaceApp } from '../ultramodern-workspace/types';
+export type UltramodernToolingConfigSource = 'compact';
+export type UltramodernToolingConfigApp = {
+    id: string;
+    kind: WorkspaceApp['kind'];
+    path: string;
+    package?: string;
+    packageSuffix?: string;
+    displayName?: string;
+    domain?: string;
+    port?: number;
+    portEnv?: string;
+    moduleFederation?: {
+        role?: 'host' | 'remote';
+        name?: string;
+        exposes?: string[];
+        exposePaths?: Record<string, string>;
+        verticalRefs?: string[];
+        hostOnly?: boolean;
+        noExposes?: boolean;
+    };
+    api?: WorkspaceApi;
+};
+export type UltramodernToolingConfig = {
+    schemaVersion: number;
+    profile?: string;
+    source: UltramodernToolingConfigSource;
+    sourcePath: string;
+    workspace: {
+        packageScope: string;
+    };
+    packageSource?: ResolvedPackageSource;
+    features: {
+        tailwind: boolean;
+    };
+    bridge?: UltramodernBridgeConfig;
+    topology: {
+        apps: UltramodernToolingConfigApp[];
+    };
+};
+export declare function readUltramodernConfig(workspaceRoot?: any): UltramodernToolingConfig;
+export declare function workspaceAppsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];

package/dist/types/ultramodern-workspace/add-vertical.d.ts

@@ -1,3 +1,4 @@
+import type { UltramodernBridgeConfig } from './bridge-config';
 import type { AddUltramodernVerticalOptions, JsonValue, Ownership, ResolvedPackageSource, UltramodernGenerationResult, UltramodernVerticalPlan, UltramodernWorkspaceOptions, WorkspaceApp } from './types';
 export type AddUltramodernVerticalPreflight = {
     name: string;
@@ -11,16 +12,18 @@ export type AddUltramodernVerticalPreflight = {
     overlay: Record<string, any>;
     packageSource: ResolvedPackageSource;
     enableTailwind: boolean;
+    bridge?: UltramodernBridgeConfig;
     vertical: WorkspaceApp;
     updatedVerticals: WorkspaceApp[];
 };
 export declare function existingPackageSource(workspaceRoot: string, modernVersion: string, packageSource?: UltramodernWorkspaceOptions['packageSource']): ResolvedPackageSource;
 export declare function existingTailwindEnabled(workspaceRoot: string): boolean;
+export declare function existingBridgeConfig(workspaceRoot: string): UltramodernBridgeConfig | undefined;
 export declare function assertValidVerticalName(name: string): string;
 export declare function nextAvailablePort(ports: Record<string, unknown>): number;
 export declare function assertCanCreate(workspaceRoot: string, relativePath: string): void;
-export declare function updateRootWorkspaceScripts(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, remotes: WorkspaceApp[]): void;
-export declare function rewriteShellAppFiles(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes: WorkspaceApp[]): void;
+export declare function updateRootWorkspaceScripts(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig): void;
+export declare function rewriteShellAppFiles(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig): void;
 export declare function addShellZephyrDependency(workspaceRoot: string, scope: string, remote: WorkspaceApp): void;
 export declare function addShellWorkspaceDependency(workspaceRoot: string, scope: string, remote: WorkspaceApp): void;
 export declare function verticalTopologyEntry(scope: string, vertical: WorkspaceApp, remotes?: WorkspaceApp[]): JsonValue;

package/dist/types/ultramodern-workspace/api.d.ts

@@ -0,0 +1,73 @@
+import type { JsonValue, WorkspaceApi, WorkspaceApp } from './types';
+export declare function verticalApiExport(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiGroupName(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiName(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiSchemaExport(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiMarkerSchemaExport(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiReadinessSchemaExport(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiErrorStem(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiCreatePayloadSchemaExport(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiNotFoundErrorExport(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function verticalApiNotFoundSchemaExport(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function createSharedApiImports(): string;
+export declare function createSharedApiContract(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function createSharedApi(service: {
+    id: string;
+    api?: WorkspaceApi;
+}): string;
+export declare function createApiServiceEntry(service: {
+    id: string;
+    api?: WorkspaceApi;
+}, contractImportPath: string): string;
+export declare function createApiClient(service: {
+    id: string;
+    api?: WorkspaceApi;
+}, contractImportPath: string): string;
+export declare function createShellApiClient(scope: string, remotes?: WorkspaceApp[]): string;
+export declare function createApiReadinessContract(app: {
+    id: string;
+    api?: WorkspaceApi;
+}): JsonValue;
+export declare function createApiRequestContextContract(): JsonValue;
+export declare function createApiDomainOperations(app: {
+    id: string;
+    api?: WorkspaceApi;
+}): JsonValue;
+export declare function apiTopologyMetadata(app: WorkspaceApp): JsonValue | undefined;
+export declare function createApiOperationContract(target: {
+    id: string;
+    api?: WorkspaceApi;
+}): JsonValue;

package/dist/types/ultramodern-workspace/bridge-config.d.ts

@@ -0,0 +1,64 @@
+export declare const ultramodernBridgeCliFlags: {
+    readonly enabled: '--bridge';
+    readonly parentRoot: '--bridge-parent-root';
+    readonly workspacePackage: '--bridge-workspace-package';
+    readonly workspacePackageName: '--bridge-workspace-package-name';
+    readonly testAlias: '--bridge-test-alias';
+    readonly dependency: '--bridge-dependency';
+    readonly lockfilePolicy: '--bridge-lockfile-policy';
+    readonly gate: '--bridge-gate';
+    readonly gateCwd: '--bridge-gate-cwd';
+    readonly reactSingleton: '--bridge-react-singleton';
+};
+export declare const ultramodernBridgeCliValueFlags: readonly ["--bridge-parent-root", "--bridge-workspace-package", "--bridge-workspace-package-name", "--bridge-test-alias", "--bridge-dependency", "--bridge-lockfile-policy", "--bridge-gate", "--bridge-gate-cwd", "--bridge-react-singleton"];
+export declare const ultramodernBridgeCliBooleanFlags: readonly ["--bridge"];
+export declare const ultramodernBridgeLockfilePolicies: readonly ['nested', 'parent'];
+export type UltramodernBridgeLockfilePolicy = (typeof ultramodernBridgeLockfilePolicies)[number];
+export type UltramodernBridgeTestAlias = {
+    alias: string;
+    target: string;
+};
+export type UltramodernBridgeWorkspacePackage = {
+    pattern: string;
+    packageNames?: string[];
+    testAliases?: UltramodernBridgeTestAlias[];
+};
+export type UltramodernBridgeGate = {
+    name: string;
+    command: string;
+    cwd?: string;
+};
+export type UltramodernBridgeConfig = {
+    enabled: true;
+    parentRoot: string;
+    workspacePackages: UltramodernBridgeWorkspacePackage[];
+    dependencies: string[];
+    lockfilePolicy: UltramodernBridgeLockfilePolicy;
+    gates: UltramodernBridgeGate[];
+    reactSingletons: string[];
+};
+export type UltramodernBridgeWorkspacePackageInput = {
+    pattern: string;
+    packageNames?: readonly string[];
+    testAliases?: readonly UltramodernBridgeTestAlias[];
+};
+export type UltramodernBridgeGateInput = {
+    name: string;
+    command: string;
+    cwd?: string;
+};
+export type UltramodernEnabledBridgeConfigInput = {
+    enabled?: true;
+    parentRoot: string;
+    workspacePackages: readonly UltramodernBridgeWorkspacePackageInput[];
+    dependencies: readonly string[];
+    lockfilePolicy?: UltramodernBridgeLockfilePolicy;
+    gates: readonly UltramodernBridgeGateInput[];
+    reactSingletons?: readonly string[];
+};
+export type UltramodernBridgeConfigInput = UltramodernEnabledBridgeConfigInput | {
+    enabled: false;
+};
+export declare function hasUltramodernBridgeCliOptions(args: string[]): boolean;
+export declare function parseUltramodernBridgeCliOptions(args: string[]): UltramodernBridgeConfig | undefined;
+export declare function normalizeUltramodernBridgeConfig(bridge: UltramodernBridgeConfigInput | undefined): UltramodernBridgeConfig | undefined;

package/dist/types/ultramodern-workspace/codesmith.d.ts

@@ -12,6 +12,7 @@ export type UltramodernCodeSmithConfig = {
     tailwind?: boolean;
     dryRun?: boolean;
     logResult?: boolean;
+    bridge?: UltramodernWorkspaceOptions['bridge'];
     overlays?: UltramodernWorkspaceOptions['overlays'];
     packageSource?: UltramodernWorkspaceOptions['packageSource'];
     packageSourceStrategy?: NonNullable<UltramodernWorkspaceOptions['packageSource']>['strategy'];

package/dist/types/ultramodern-workspace/contracts.d.ts

@@ -1,21 +1,6 @@
+import type { UltramodernBridgeConfig } from './bridge-config';
 import type { JsonValue, ResolvedPackageSource, WorkspaceApp } from './types';
-export declare const baselineAgentSkills: string[];
-export declare const moduleFederationAgentSkills: string[];
-export declare const privateAgentSkills: string[];
 export declare function createTopology(scope: string, remotes?: WorkspaceApp[]): JsonValue;
 export declare function createOwnership(scope: string, remotes?: WorkspaceApp[]): JsonValue;
 export declare function createDevelopmentOverlay(remotes?: WorkspaceApp[]): JsonValue;
-export declare function createPackageSourceMetadata(scope: string, packageSource: ResolvedPackageSource): JsonValue;
-export declare function createAppConfigContract(app: WorkspaceApp): JsonValue;
-export declare function createPerformanceReadinessContract(): JsonValue;
-export declare function cssLayerName(app: WorkspaceApp): string;
-export declare function cssRole(app: WorkspaceApp): string;
-export declare function cssClassPrefix(app: WorkspaceApp): string;
-export declare function createCssDedupeContract(scope: string): JsonValue;
-export declare function createCssSsrContract(app: WorkspaceApp): JsonValue;
-export declare function createAppCssFederationContract(scope: string, app: WorkspaceApp): JsonValue;
-export declare function createCssFederationContract(scope: string): JsonValue;
-export declare function createStylingContract(scope: string, app: WorkspaceApp, enableTailwind: boolean): JsonValue;
-export declare function createAppGeneratedContract(scope: string, app: WorkspaceApp, apps: WorkspaceApp[], enableTailwind: boolean): JsonValue;
-export declare function createGeneratedContract(scope: string, apps?: WorkspaceApp[], enableTailwind?: boolean): JsonValue;
-export declare function createTemplateManifest(modernVersion: string, packageSource: ResolvedPackageSource): JsonValue;
+export declare function createUltramodernConfig(scope: string, modernVersion: string, packageSource: ResolvedPackageSource, apps?: WorkspaceApp[], enableTailwind?: boolean, bridge?: UltramodernBridgeConfig): JsonValue;

package/dist/types/ultramodern-workspace/descriptors.d.ts

@@ -1,5 +1,5 @@
-import type { Ownership, WorkspaceApp, WorkspaceEffectApi } from './types';
-export declare const GENERATED_CONTRACT_PATH = ".modernjs/ultramodern-generated-contract.json";
+import type { Ownership, WorkspaceApi, WorkspaceApp } from './types';
+export declare const ULTRAMODERN_CONFIG_PATH = ".modernjs/ultramodern.json";
 export declare const shellApp: WorkspaceApp;
 export declare function createShellHost(remotes?: WorkspaceApp[]): WorkspaceApp;
 export declare const sharedPackages: {
@@ -9,19 +9,19 @@ export declare const sharedPackages: {
 }[];
 export declare function createNeutralOwnership(id: string, tier?: string): Ownership;
 export declare function createVerticalDescriptor(name: string, port: number): WorkspaceApp;
-export declare function appHasEffectApi(app: WorkspaceApp): app is WorkspaceApp & {
-    effectApi: WorkspaceEffectApi;
+export declare function appHasApi(app: WorkspaceApp): app is WorkspaceApp & {
+    api: WorkspaceApi;
 };
-export declare function effectApiPrefix(target: {
+export declare function resolveApiPrefix(target: {
     id: string;
-    effectApi?: WorkspaceEffectApi;
+    api?: WorkspaceApi;
 }): string;
-export declare function effectApiStem(target: {
+export declare function resolveApiStem(target: {
     id: string;
-    effectApi?: WorkspaceEffectApi;
+    api?: WorkspaceApi;
 }): string;
-export declare function verticalEffectApps(remotes?: WorkspaceApp[]): (WorkspaceApp & {
-    effectApi: WorkspaceEffectApi;
+export declare function verticalApiApps(remotes?: WorkspaceApp[]): (WorkspaceApp & {
+    api: WorkspaceApi;
 })[];
 export declare function remoteDependencyAlias(remote: WorkspaceApp): string;
 export declare function zephyrRemoteDependency(scope: string, remote: WorkspaceApp): string;

package/dist/types/ultramodern-workspace/fs-io.d.ts

@@ -9,6 +9,7 @@ export declare function ensureInsideRoot(root: string, targetPath: string): void
 export declare function writeFile(targetDir: string, relativePath: string, content: string): void;
 export declare function writeFileReplacing(targetDir: string, relativePath: string, content: string): void;
 export declare function writeJson(targetDir: string, relativePath: string, value: JsonValue): void;
+export declare function formatGeneratedWorkspaceFiles(targetDir: string, relativePaths?: readonly string[]): void;
 export declare function renderTemplate(template: string, data: Record<string, string>): string;
 export declare function collectTemplateFiles(dir: string): string[];
 export declare function hashFile(filePath: string): string;

package/dist/types/ultramodern-workspace/index.d.ts

@@ -1,4 +1,6 @@
 export { addUltramodernVertical, planUltramodernVertical, } from './add-vertical';
+export type { UltramodernBridgeConfig, UltramodernBridgeConfigInput, UltramodernBridgeGate, UltramodernBridgeGateInput, UltramodernBridgeLockfilePolicy, UltramodernBridgeTestAlias, UltramodernBridgeWorkspacePackage, UltramodernBridgeWorkspacePackageInput, UltramodernEnabledBridgeConfigInput, } from './bridge-config';
+export { normalizeUltramodernBridgeConfig } from './bridge-config';
 export type { AddUltramodernVerticalOptions, UltramodernCodeSmithOverlay, UltramodernCodeSmithOverlayRuntimeConfig, UltramodernGeneratedAppDescriptor, UltramodernGeneratedContractChange, UltramodernGenerationOperation, UltramodernGenerationResult, UltramodernGenerationWarning, UltramodernJsonMutation, UltramodernShellDependencyChange, UltramodernVerticalPlan, UltramodernWorkspaceOptions, } from './types';
 export { ultramodernWorkspaceVersions } from './versions';
 export { generateUltramodernWorkspace } from './write-workspace';

package/dist/types/ultramodern-workspace/mf-validation.d.ts

@@ -0,0 +1,27 @@
+export type ModuleFederationConfigInspection = {
+    appDir: string;
+    configPath: string;
+    dts: {
+        compilerInstance?: string;
+        tsConfigPath?: string;
+    };
+    exposes: string[];
+    hostOnlyNoExposes: boolean;
+};
+export type ModuleFederationDiscoveredConfig = {
+    appDir: string;
+    configPath: string;
+};
+export type ModuleFederationValidationResult = {
+    configCount: number;
+    exposedAppCount: number;
+    hostOnlyAppCount: number;
+    apps: ModuleFederationConfigInspection[];
+};
+export type ModuleFederationValidationOptions = {
+    workspaceRoot: string;
+    appDirs?: string[];
+};
+export declare function discoverModuleFederationConfigs(options: ModuleFederationValidationOptions): ModuleFederationDiscoveredConfig[];
+export declare function inspectModuleFederationConfigSource(source: string, appDir: string, configPath: string): ModuleFederationConfigInspection;
+export declare function validateModuleFederationTypes(options: ModuleFederationValidationOptions): ModuleFederationValidationResult;

package/dist/types/ultramodern-workspace/package-json.d.ts

@@ -1,9 +1,10 @@
+import type { UltramodernBridgeConfig } from './bridge-config';
 import type { JsonValue, ResolvedPackageSource, WorkspaceApp } from './types';
-export declare const createEffectTsgoTypecheckCommand: (packageDir: string) => string;
+export declare const createStrictTsgoTypecheckCommand: (packageDir: string) => string;
 export declare const effectDiagnostics: string[];
-export declare function appDependencies(scope: string, packageSource: ResolvedPackageSource, app: WorkspaceApp, remotes?: WorkspaceApp[]): Record<string, string>;
+export declare function appDependencies(scope: string, packageSource: ResolvedPackageSource, app: WorkspaceApp, remotes?: WorkspaceApp[], bridge?: UltramodernBridgeConfig): Record<string, string>;
 export declare function appDevDependencies(packageSource: ResolvedPackageSource, enableTailwind: boolean): Record<string, string>;
-export declare function createRootPackageJson(scope: string, packageSource: ResolvedPackageSource, remotes?: WorkspaceApp[]): JsonValue;
+export declare function createRootPackageJson(scope: string, packageSource: ResolvedPackageSource, remotes?: WorkspaceApp[], bridge?: UltramodernBridgeConfig): JsonValue;
 export declare function createZephyrDependencies(scope: string, app: WorkspaceApp, remotes?: WorkspaceApp[]): JsonValue;
 export declare function createTsConfigBase(): JsonValue;
 type CreatePackageTsConfigOptions = {
@@ -16,7 +17,7 @@ export declare function createAppTsConfig(app: WorkspaceApp, remotes?: Workspace
 export declare function createAppMfTypesTsConfig(app: WorkspaceApp): JsonValue;
 export declare function createSharedPackageTsConfig(packageDir: string): JsonValue;
 export declare function createRootTsConfig(apps?: WorkspaceApp[]): JsonValue;
-export declare function createAppPackage(scope: string, app: WorkspaceApp, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes?: WorkspaceApp[]): JsonValue;
+export declare function createAppPackage(scope: string, app: WorkspaceApp, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes?: WorkspaceApp[], bridge?: UltramodernBridgeConfig): JsonValue;
 export declare function createSharedPackage(scope: string, id: string, description: string): JsonValue;
 export declare function createSharedContractsIndex(): string;
 export {};

package/dist/types/ultramodern-workspace/public-api.d.ts

@@ -1,3 +1,5 @@
 export { addUltramodernVertical, planUltramodernVertical, } from './add-vertical';
+export type { UltramodernBridgeConfig, UltramodernBridgeConfigInput, UltramodernBridgeGate, UltramodernBridgeGateInput, UltramodernBridgeLockfilePolicy, UltramodernBridgeTestAlias, UltramodernBridgeWorkspacePackage, UltramodernBridgeWorkspacePackageInput, UltramodernEnabledBridgeConfigInput, } from './bridge-config';
+export { normalizeUltramodernBridgeConfig } from './bridge-config';
 export type { AddUltramodernVerticalOptions, UltramodernCodeSmithOverlay, UltramodernCodeSmithOverlayRuntimeConfig, UltramodernGeneratedAppDescriptor, UltramodernGeneratedContractChange, UltramodernGenerationOperation, UltramodernGenerationResult, UltramodernGenerationWarning, UltramodernJsonMutation, UltramodernShellDependencyChange, UltramodernVerticalPlan, UltramodernWorkspaceOptions, } from './types';
 export { generateUltramodernWorkspace } from './write-workspace';