@bleedingdev/modern-js-ultramodern-create 3.9.0-ultramodern.2 → 3.9.0-ultramodern.21

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

@@ -1,387 +1,76 @@
 import "node:module";
-import { ULTRAMODERN_CREATE_PACKAGE } from "../ultramodern-package-source.js";
-import { verticalApiGroupName } from "./api.js";
-import { createBackendFederationMetadata } from "./backend-federation.js";
-import { createDevelopmentOverlay, createOwnership, createTopology, createUltramodernConfig } from "./contracts.js";
-import { createDeliveryUnitRecord } from "./delivery-unit.js";
-import { remoteComponentOutputPath } from "./demo-components.js";
-import { appEmitsBrowserUi, appHasApi, appI18nNamespace, createShellHost, remoteDependencyAlias, resolveApiProtocol, resolveApiStem, sharedPackages, shellApp } from "./descriptors.js";
-import { packageName, tailwindPrefixForApp } from "./naming.js";
-import { createCloudflareSecurityContract } from "./policy.js";
-import { publicSurfaceManagedSourceAssetPaths } from "./public-surface.js";
-import { createLocalisedUrlsMap, createRouteMetaFilePath, createRouteOwnedI18nPaths, createRoutePageFilePath } from "./routes.js";
-import { createAdditionalShellConfigEntry, shellDeliveryUnitBlock } from "./shells.js";
-import { resolveOwnerAttribution } from "./types.js";
-import { CLOUDFLARE_COMPATIBILITY_DATE, CROSS_ENV_VERSION, EFFECT_VERSION, EFFECT_VITEST_VERSION, MODULE_FEDERATION_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_HISTORY_VERSION } from "./versions.js";
-import { createWorkspaceRootPackageScripts, createWorkspaceRootScriptPlan } from "./workspace-script-plan.js";
-const WORKSPACE_VALIDATION_CONTRACT_SCHEMA_VERSION = 2;
-const WORKSPACE_METADATA_SCHEMA_VERSION = 1;
-const WORKSPACE_VALIDATION_CONTRACT_KIND = 'modernjs.ultramodern-workspace-validation-contract';
-const modernPackageCohort = [
-    ULTRAMODERN_CREATE_PACKAGE,
-    '@modern-js/code-tools',
-    '@modern-js/app-tools',
-    '@modern-js/plugin-bff',
-    '@modern-js/plugin-i18n',
-    '@modern-js/plugin-tanstack',
-    '@modern-js/runtime'
-];
-const asJsonRecord = (value)=>value;
-function projectModuleFederationMetadata(value) {
-    const moduleFederation = asJsonRecord(value);
-    return {
-        ...moduleFederation,
-        ...Array.isArray(moduleFederation.remotes) ? {
-            remotes: moduleFederation.remotes.map((value)=>{
-                const remote = asJsonRecord(value);
-                return {
-                    id: remote.id,
-                    manifestUrl: remote.manifestUrl,
-                    name: remote.name
-                };
-            })
-        } : {}
-    };
-}
-function createReferenceTopologyExpectation(scope, remotes, primaryShell) {
-    const topology = asJsonRecord(createTopology(scope, remotes, primaryShell));
-    const shell = asJsonRecord(topology.shell);
-    return {
-        ...topology,
-        shell: {
-            ...shell,
-            moduleFederation: projectModuleFederationMetadata(shell.moduleFederation)
-        },
-        verticals: Array.isArray(topology.verticals) ? topology.verticals.map((value)=>{
-            const vertical = asJsonRecord(value);
-            return {
-                ...vertical,
-                moduleFederation: projectModuleFederationMetadata(vertical.moduleFederation)
-            };
-        }) : topology.verticals
-    };
-}
-const validationEvidencePolicy = {
-    schemaVersion: 1,
-    required: [
-        {
-            id: "typescript-compiler",
-            kind: 'compiler'
-        },
-        {
-            id: 'architecture-compiler',
-            kind: 'compiler'
-        },
-        {
-            id: 'executable-modern-config',
-            kind: 'runtime'
-        },
-        {
-            id: 'executable-runtime-config',
-            kind: 'runtime'
-        },
-        {
-            id: 'executable-module-federation-config',
-            kind: 'runtime'
-        },
-        {
-            id: 'executable-build-facade',
-            kind: 'runtime'
-        },
-        {
-            id: 'structured-package-config',
-            kind: 'structured'
-        },
-        {
-            id: 'structured-deploy-config',
-            kind: 'structured'
-        },
-        {
-            id: 'public-behavior-gates',
-            kind: 'behavior'
-        }
-    ]
-};
-function createStructuralShellPolicy(workspaceApps) {
-    return {
-        schemaVersion: 1,
-        shells: workspaceApps.filter((app)=>'shell' === app.kind).map((app)=>({
-                id: app.id,
-                packageDir: app.directory,
-                srcDir: `${app.directory}/src`
-            })),
-        forbiddenPathClasses: [
-            {
-                id: 'shell-api-surface',
-                path: 'api',
-                diagnostic: 'A thin Shell must not own an API surface (api/); business APIs belong to a MicroVertical.'
-            },
-            {
-                id: 'shell-server-surface',
-                path: 'server',
-                diagnostic: 'A thin Shell must not own a server surface (server/); server capability belongs to a MicroVertical.'
-            },
-            {
-                id: 'shell-backend-federation',
-                path: 'backend-federation.config.ts',
-                diagnostic: 'A thin Shell must not own backend-federation artifacts; backend federation belongs to a MicroVertical delivery unit.'
-            }
-        ]
-    };
-}
-function createFederatedCompositionPolicy(scope, hosts, remotes) {
-    const remotesById = new Map(remotes.map((remote)=>[
-            remote.id,
-            remote
-        ]));
-    return {
-        schemaVersion: 1,
-        hosts: [
-            ...new Map(hosts.map((host)=>[
-                    host.id,
-                    host
-                ])).values()
-        ].filter((host)=>(host.verticalRefs?.length ?? 0) > 0).map((host)=>({
-                id: host.id,
-                srcDir: `${host.directory}/src`,
-                remotes: (host.verticalRefs ?? []).map((remoteId)=>{
-                    const remote = remotesById.get(remoteId);
-                    if (void 0 === remote) throw new Error(`Unknown remote vertical reference ${remoteId} for ${host.id}.`);
-                    return {
-                        id: remote.id,
-                        directory: remote.directory,
-                        packageName: packageName(scope, remote.packageSuffix)
-                    };
-                })
-            }))
-    };
-}
-function createWorkspaceValidationContract(scope, enableTailwind, remotes = [], releaseCohort, additionalShells = [], primaryShell, compactConfigOverride, ownershipOverride, developmentOverlayOverride) {
-    const resolvedPrimaryShell = primaryShell ?? createShellHost(remotes);
-    const workspaceApps = [
-        resolvedPrimaryShell,
+import { ULTRAMODERN_WORKSPACE_MODERN_PACKAGES } from "../ultramodern-package-source.js";
+import { appEmitsBrowserUi, appHasApi, createShellHost } from "./descriptors.js";
+import { packageName } from "./naming.js";
+function createWorkspaceValidationContract(scope, enableTailwind, authoredSharedPackages, remotes = [], additionalShells = [], primaryShell = createShellHost(remotes)) {
+    if (!Array.isArray(authoredSharedPackages) || !authoredSharedPackages.every((pkg)=>pkg && 'string' == typeof pkg.id && pkg.id.length > 0 && 'string' == typeof pkg.path && pkg.path.length > 0 && 'string' == typeof pkg.package && pkg.package.length > 0)) throw new Error('Canonical shared package inventory is invalid.');
+    const apps = [
+        primaryShell,
+        ...additionalShells,
         ...remotes
     ];
-    const configuredShells = [
-        resolvedPrimaryShell,
-        ...additionalShells
-    ];
-    const compactConfig = asJsonRecord(compactConfigOverride ?? createUltramodernConfig(scope, 'workspace-validation-contract', {
-        strategy: 'workspace',
-        modernPackageVersion: 'workspace:*'
-    }, workspaceApps, enableTailwind, void 0, additionalShells, resolvedPrimaryShell));
-    const fullStackVerticals = remotes.map((remote)=>({
-            id: remote.id,
-            domain: remote.domain,
-            path: remote.directory,
-            port: remote.port,
-            mfName: remote.mfName,
-            emitsApi: appHasApi(remote),
-            emitsUi: appEmitsBrowserUi(remote),
-            surfaceProfile: remote.surfaceProfile ?? 'full-stack',
-            ...appHasApi(remote) ? {
-                stem: remote.api.stem,
-                group: verticalApiGroupName(remote),
-                apiPrefix: remote.api.prefix,
-                apiProtocol: resolveApiProtocol(remote),
-                apiContractExport: './api',
-                apiClientExport: 'rpc' === resolveApiProtocol(remote) ? './api/rpc-client' : './api/client',
-                apiContractPath: 'rpc' === resolveApiProtocol(remote) ? 'shared/rpc.ts' : 'shared/api.ts',
-                apiClientPath: `src/api/${resolveApiStem(remote)}-${'rpc' === resolveApiProtocol(remote) ? 'rpc-client' : 'client'}.ts`,
-                backendFederation: createBackendFederationMetadata(scope, remote)
-            } : {},
-            tailwindPrefix: tailwindPrefixForApp(remote),
-            zephyrAlias: remoteDependencyAlias(remote),
-            packageName: packageName(scope, remote.packageSuffix),
-            deliveryUnit: createDeliveryUnitRecord(scope, remote),
-            exposes: Object.keys(remote.exposes ?? {}),
-            componentPaths: Object.keys(remote.exposes ?? {}).map((expose)=>remoteComponentOutputPath(remote, expose)).filter((componentPath)=>Boolean(componentPath)),
-            namespace: appI18nNamespace(remote),
-            routePagePaths: createRouteOwnedI18nPaths(remote).filter((route)=>'/' !== route.canonicalPath).map((route)=>createRoutePageFilePath(remote, route.canonicalPath)),
-            routeMetaPaths: createRouteOwnedI18nPaths(remote).map((route)=>createRouteMetaFilePath(remote, route.canonicalPath)),
-            localisedUrls: createLocalisedUrlsMap(remote),
-            verticalRefs: remote.verticalRefs ?? []
-        }));
-    const additionalShellRecords = additionalShells.map((shell)=>{
-        const configEntry = createAdditionalShellConfigEntry(scope, shell, remotes);
-        return {
-            id: shell.id,
-            path: shell.directory,
-            packageName: packageName(scope, shell.packageSuffix),
-            port: shell.port,
-            portEnv: shell.portEnv,
-            mfName: shell.mfName,
-            tailwindPrefix: tailwindPrefixForApp(shell),
-            verticalRefs: shell.verticalRefs ?? [],
-            owner: resolveOwnerAttribution(shell.ownership),
-            deliveryUnit: shellDeliveryUnitBlock(scope, shell),
-            degradedState: {
-                required: (shell.verticalRefs ?? []).length > 0,
-                appId: shell.id,
-                status: 'degraded'
-            },
-            moduleFederation: configEntry.moduleFederation
-        };
-    });
     return {
-        schemaVersion: WORKSPACE_VALIDATION_CONTRACT_SCHEMA_VERSION,
-        kind: WORKSPACE_VALIDATION_CONTRACT_KIND,
-        metadata: {
-            compactConfig: {
-                path: '.modernjs/ultramodern.json',
-                schemaVersion: WORKSPACE_METADATA_SCHEMA_VERSION
-            },
-            referenceTopology: {
-                path: 'topology/reference-topology.json',
-                schemaVersion: WORKSPACE_METADATA_SCHEMA_VERSION
-            },
-            ownership: {
-                path: 'topology/ownership.json',
-                schemaVersion: WORKSPACE_METADATA_SCHEMA_VERSION
-            },
-            developmentOverlay: {
-                path: 'topology/local-overlays/development.json',
-                schemaVersion: WORKSPACE_METADATA_SCHEMA_VERSION
-            },
-            ...releaseCohort ? {
-                releaseCohort: {
-                    path: '.modernjs/release-cohort.json',
-                    schemaVersion: releaseCohort.schemaVersion
-                }
-            } : {}
-        },
-        cohort: {
-            modernPackages: [
-                ...modernPackageCohort
-            ],
-            ...releaseCohort ? {
-                releaseCohort
-            } : {},
-            appIds: workspaceApps.map((app)=>app.id),
-            ...additionalShells.length > 0 ? {
-                additionalShellIds: additionalShells.map((app)=>app.id),
-                additionalShellOwnerIds: additionalShells.map((app)=>app.id),
-                additionalShellDeliveryUnitIds: additionalShells.map((app)=>app.id),
-                additionalShellDegradedStateIds: additionalShells.map((app)=>app.id),
-                additionalShellBuildMarkerIds: additionalShells.map((app)=>app.id)
-            } : {},
-            backendAppIds: fullStackVerticals.filter((app)=>app.emitsApi).map((app)=>app.id),
-            verticalIds: remotes.map((app)=>app.id),
-            sharedPackageIds: sharedPackages.map((sharedPackage)=>sharedPackage.id),
-            ownerIds: [
-                ...workspaceApps.map((app)=>app.id),
-                ...sharedPackages.map((sharedPackage)=>sharedPackage.id)
-            ],
-            packageManifests: [
+        packageScope: scope,
+        tailwindEnabled: enableTailwind,
+        modernPackages: [
+            ...ULTRAMODERN_WORKSPACE_MODERN_PACKAGES
+        ],
+        apps: apps.map((app)=>({
+                id: app.id,
+                kind: app.kind,
+                path: app.directory,
+                packageName: packageName(scope, app.packageSuffix),
+                emitsApi: appHasApi(app),
+                emitsUi: appEmitsBrowserUi(app),
+                exposes: app.exposes ?? {},
+                verticalRefs: app.verticalRefs ?? []
+            })),
+        sharedPackages: authoredSharedPackages.map((pkg)=>({
+                id: pkg.id,
+                path: pkg.path,
+                packageName: pkg.package
+            })),
+        structuralShellPolicy: {
+            schemaVersion: 1,
+            shells: apps.filter((app)=>'shell' === app.kind).map((app)=>({
+                    id: app.id,
+                    packageDir: app.directory,
+                    srcDir: `${app.directory}/src`
+                })),
+            forbiddenPathClasses: [
                 {
-                    id: 'workspace-root',
-                    packageName: scope,
-                    path: 'package.json',
-                    role: 'workspace-root'
+                    id: 'shell-api-surface',
+                    path: 'api',
+                    diagnostic: 'A thin Shell must not own an API surface.'
                 },
-                ...workspaceApps.map((app)=>({
-                        id: app.id,
-                        packageName: packageName(scope, app.packageSuffix),
-                        path: `${app.directory}/package.json`,
-                        role: app.kind
-                    })),
-                ...sharedPackages.map((sharedPackage)=>({
-                        id: sharedPackage.id,
-                        packageName: packageName(scope, sharedPackage.id),
-                        path: `${sharedPackage.directory}/package.json`,
-                        role: 'shared-package'
-                    }))
-            ],
-            ...additionalShells.length > 0 ? {
-                additionalShellManifests: additionalShells.map((app)=>({
-                        id: app.id,
-                        packageName: packageName(scope, app.packageSuffix),
-                        path: `${app.directory}/package.json`,
-                        role: 'shell'
-                    }))
-            } : {}
-        },
-        topology: {
-            compactConfig: compactConfig.topology,
-            referenceTopology: createReferenceTopologyExpectation(scope, remotes, resolvedPrimaryShell),
-            ownership: ownershipOverride ?? createOwnership(scope, remotes),
-            developmentOverlay: developmentOverlayOverride ?? createDevelopmentOverlay(scope, remotes)
-        },
-        policy: {
-            compactConfig: {
-                schemaVersion: compactConfig.schemaVersion,
-                profile: compactConfig.profile,
-                workspace: compactConfig.workspace,
-                features: compactConfig.features,
-                deploy: compactConfig.deploy,
-                moduleFederation: compactConfig.moduleFederation,
-                backendFederation: compactConfig.backendFederation,
-                agentSkills: compactConfig.agentSkills,
-                tooling: compactConfig.tooling
-            }
-        },
-        legacy: {
-            retiredMetadataPaths: [
-                '.modernjs/ultramodern-generated-contract.json',
-                '.modernjs/ultramodern-package-source.json',
-                '.modernjs/ultramodern-workspace-template-manifest.json'
-            ],
-            forbiddenCompactConfigFields: [
-                'generatedContract',
-                'packageCohort',
-                'workspaceValidationContract'
-            ],
-            forbiddenPackageSourceFields: [
-                'generatedWorkspacePackages',
-                'metadata',
-                'modernPackages'
-            ],
-            forbiddenTopologyFields: [
-                'effectServices',
-                'remotes'
+                {
+                    id: 'shell-server-surface',
+                    path: 'server',
+                    diagnostic: 'A thin Shell must not own a server surface.'
+                },
+                {
+                    id: 'shell-backend-federation',
+                    path: 'backend-federation.config.ts',
+                    diagnostic: 'A thin Shell must not own backend federation.'
+                }
             ]
         },
-        validationEvidencePolicy: validationEvidencePolicy,
-        packageScope: scope,
-        node: {
-            version: NODE_VERSION,
-            engineRange: '>=26'
-        },
-        versions: {
-            cloudflareCompatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE,
-            crossEnv: CROSS_ENV_VERSION,
-            effect: EFFECT_VERSION,
-            effectVitest: EFFECT_VITEST_VERSION,
-            moduleFederation: MODULE_FEDERATION_VERSION,
-            node: NODE_VERSION,
-            pnpm: PNPM_VERSION,
-            tanstackHistory: TANSTACK_HISTORY_VERSION
-        },
-        tailwindEnabled: enableTailwind,
-        structuralShellPolicy: createStructuralShellPolicy(configuredShells),
-        federatedCompositionPolicy: createFederatedCompositionPolicy(scope, [
-            ...configuredShells,
-            ...remotes
-        ], remotes),
-        ...additionalShellRecords.length > 0 ? {
-            additionalShells: additionalShellRecords
-        } : {},
-        fullStackVerticals,
-        shellNamespace: appI18nNamespace(shellApp),
-        oldRemotePaths: [
-            'apps/remotes'
-        ],
-        scripts: createWorkspaceRootScriptPlan(remotes, {
-            shells: configuredShells
-        }),
-        packageScripts: createWorkspaceRootPackageScripts(remotes, {
-            shells: configuredShells
-        }),
-        cloudflareSecurity: createCloudflareSecurityContract(),
-        publicSurfaceManagedSourceAssetPaths: [
-            ...publicSurfaceManagedSourceAssetPaths
-        ],
-        shellRouteMetaPaths: createRouteOwnedI18nPaths(shellApp).map((route)=>createRouteMetaFilePath(shellApp, route.canonicalPath))
+        federatedCompositionPolicy: {
+            schemaVersion: 1,
+            hosts: apps.filter((app)=>(app.verticalRefs?.length ?? 0) > 0).map((app)=>({
+                    id: app.id,
+                    srcDir: `${app.directory}/src`,
+                    remotes: (app.verticalRefs ?? []).map((id)=>{
+                        const remote = remotes.find((candidate)=>candidate.id === id);
+                        if (!remote) throw new Error(`Unknown remote vertical reference ${id} for ${app.id}.`);
+                        return {
+                            id,
+                            directory: remote.directory,
+                            packageName: packageName(scope, remote.packageSuffix)
+                        };
+                    })
+                }))
+        }
     };
 }
 export { createWorkspaceValidationContract };

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

@@ -27,6 +27,7 @@ function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes
         enableTailwind: appTailwind,
         emitsUi,
         remotes: resolvedRemotes,
+        availableRemotes: remotes,
         bridge,
         devPorts,
         publicWeb,
@@ -41,12 +42,12 @@ function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes
 function rewriteAppModernConfig(targetDir, scope, app, remotes, enableTailwind, devPorts) {
     writeFileReplacing(targetDir, `${app.directory}/modern.config.ts`, createAppModernConfig(scope, app, remotes, enableTailwind, devPorts));
 }
-function writeAppConfigFiles({ targetDir, scope, resolvedApp, packageSource, enableTailwind, emitsUi, remotes, bridge, devPorts, publicWeb }) {
-    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes, bridge));
+function writeAppConfigFiles({ targetDir, scope, resolvedApp, packageSource, enableTailwind, emitsUi, remotes, availableRemotes, bridge, devPorts, publicWeb }) {
+    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, availableRemotes, 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, scope));
-    writeFile(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, createUltramodernBuildReexportModule());
+    if (emitsUi) writeFile(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(resolvedApp, remotes, scope));
+    if ('api-only' !== resolvedApp.surfaceProfile) writeFile(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, createUltramodernBuildReexportModule(resolvedApp));
     writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.ts`, createUltramodernBuildModule(scope, resolvedApp));
     writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.json`, createUltramodernBuildArtifactJson(scope, resolvedApp));
     if (emitsUi) {
@@ -55,7 +56,7 @@ function writeAppConfigFiles({ targetDir, scope, resolvedApp, packageSource, ena
         writeFile(targetDir, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
     }
     writeFile(targetDir, `${resolvedApp.directory}/modern.config.ts`, createAppModernConfig(scope, resolvedApp, remotes, enableTailwind, devPorts));
-    writeFile(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(resolvedApp, scope, remotes));
+    if (emitsUi) writeFile(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(resolvedApp, scope, remotes));
 }
 function writeAppLocaleAndStyleFiles({ targetDir, scope, resolvedApp, enableTailwind, emitsUi, remotes }) {
     writeJson(targetDir, `${resolvedApp.directory}/locales/en/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
@@ -69,7 +70,7 @@ function writeAppFederationConfigFiles({ targetDir, scope, resolvedApp, emitsUi,
     if (emitsUi) writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, resolvedApp, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
     if (appHasApi(resolvedApp)) writeFile(targetDir, `${resolvedApp.directory}/backend-federation.config.ts`, createBackendModuleFederationConfig(resolvedApp));
 }
-function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, remotes, publicWeb, writeAppFile }) {
+function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, remotes, availableRemotes, publicWeb, writeAppFile }) {
     if (!emitsUi) return;
     if ((resolvedApp.verticalRefs?.length ?? 0) > 0) {
         writeAppFile('src/federated-components.tsx', createFederatedComponentsRegistry(scope, resolvedApp, remotes));
@@ -83,17 +84,24 @@ function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, re
         writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
         writeAppFile('src/routes/vertical-components.worker.tsx', createShellWorkerRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
         writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, remotes));
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, availableRemotes));
     } else for (const expose of distributedSsrExposes(resolvedApp))writeAppFile(`src/routes/[lang]/_mf/fragment/${distributedSsrFragmentSlug(expose)}/page.tsx`, createRemoteExposeFragmentPage(resolvedApp, expose));
 }
 function writeAppApiAndRemoteExposeFiles({ targetDir, scope, resolvedApp, emitsUi, writeAppFile }) {
     if (appHasApi(resolvedApp)) {
         const rpcProtocol = 'rpc' === resolveApiProtocol(resolvedApp);
-        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/shared/rpc.ts`, createRpcContractFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts'));
+        const clientDirectory = emitsUi ? 'src/api' : 'shared';
+        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/shared/rpc.ts`, createRpcContractFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp, {
+            scope
+        }));
+        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts', {
+            scope
+        }));
         writeFile(targetDir, `${resolvedApp.directory}/api/backend-federation.ts`, createBackendFederationContractFile(resolvedApp));
         writeFile(targetDir, `${resolvedApp.directory}/api/effect-api.ts`, createBackendEffectApiExpose(scope, resolvedApp));
-        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-rpc-client.ts`, createRpcClientFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api'));
+        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/${clientDirectory}/${resolvedApp.api.stem}-rpc-client.ts`, createRpcClientFile(resolvedApp, emitsUi ? '../../shared/rpc.ts' : './rpc.ts')) : writeFile(targetDir, `${resolvedApp.directory}/${clientDirectory}/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, emitsUi ? '../../shared/api' : './api', {
+            scope
+        }));
     }
     if ('vertical' === resolvedApp.kind && emitsUi) {
         writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));