@bleedingdev/modern-js-ultramodern-create 3.8.3-ultramodern.2

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-modern-configs.js

@@ -0,0 +1,139 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { configuredDevelopmentPorts } from "../../../ultramodern-workspace/add-vertical/workspace-state.js";
+import { createFederatedComponentsRegistry, createRemoteExposeFragmentPage, createShellRemoteComponents, createShellWorkerRemoteComponents } from "../../../ultramodern-workspace/demo-components.js";
+import { appEmitsBrowserUi, appHasApi, distributedSsrExposes, distributedSsrFragmentSlug, resolveRemoteRefs } from "../../../ultramodern-workspace/descriptors.js";
+import { formatGeneratedSourceCandidates } from "../../../ultramodern-workspace/fs-io.js";
+import { createAppModernConfig, createBackendModuleFederationConfig, createRemoteModuleFederationConfig, createShellModuleFederationConfig } from "../../../ultramodern-workspace/module-federation.js";
+import { additionalShellsFromToolingConfig, allWorkspaceAppsFromToolingConfig } from "../../config.js";
+import { writeGeneratedUiSourceIfChanged } from "./generated-ui-source.js";
+import { readJsonFile } from "./io.js";
+import { appDeclaresReactRouter } from "./react-router-retirement.js";
+function isGeneratedShellComposition(source) {
+    return source.includes('const createRemoteComponent =') && source.includes('export const VerticalShowcase =');
+}
+function writeOwnedTypeScriptConfig(io, filePath, generatedSource, recognizedGeneratedSources = []) {
+    if (!node_fs.existsSync(filePath)) return io.writeGenerated(filePath, generatedSource);
+    const existingSource = node_fs.readFileSync(filePath, 'utf-8');
+    if (existingSource === generatedSource) return io.writeGenerated(filePath, existingSource);
+    if (recognizedGeneratedSources.includes(existingSource)) return io.writeGenerated(filePath, generatedSource);
+    io.log(`${node_path.relative(io.workspaceRoot, filePath)} was preserved: its generated ownership cannot be proven.`);
+    return false;
+}
+function removeOwnedTypeScriptConfig(io, filePath, recognizedGeneratedSources) {
+    if (!node_fs.existsSync(filePath)) return false;
+    if (recognizedGeneratedSources.includes(node_fs.readFileSync(filePath, 'utf-8'))) return io.remove(filePath);
+    io.log(`${node_path.relative(io.workspaceRoot, filePath)} was preserved: surface metadata cannot delete a config whose exact generated ownership cannot be proven.`);
+    return false;
+}
+function addLegacyGeneratedModernDefaults(source) {
+    const serverAnchor = "        publicDir: ['./locales', './assets'],\n";
+    const optionsEnd = '    },\n  ),\n);';
+    return source.replace(serverAnchor, `${serverAnchor}        ssr: {
+          mode: 'stream',
+          moduleFederationAppSSR: true,
+        },
+`).replace(optionsEnd, `      enableBffRequestId: true,
+      enableModuleFederationSSR: true,
+      enableTelemetryExporters: true,
+      telemetryFailLoudStartup: false,
+${optionsEnd}`);
+}
+function formatGeneratedModernConfigCandidates(generatedSources) {
+    return formatGeneratedSourceCandidates(generatedSources.map((source, index)=>[
+            `candidate-${index}.ts`,
+            source
+        ]));
+}
+const formatGeneratedTypeScriptConfig = (generatedSource)=>formatGeneratedModernConfigCandidates([
+        generatedSource
+    ])[0];
+function isGeneratedModernConfig(source, generatedSources) {
+    return generatedSources.includes(source);
+}
+function addPreviousTailwindOptimizationOverride(source) {
+    return source.replace('pluginTailwindcss()', 'pluginTailwindcss({ optimize: false })');
+}
+function removeTsCheckerBuildOverride(source) {
+    return source.replace(`        tsChecker: {
+          typescript: {
+            build: false,
+          },
+        },
+`, '');
+}
+function updateGeneratedModernConfigs(io, config) {
+    const apps = allWorkspaceAppsFromToolingConfig(config);
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    const overlayPath = node_path.join(io.workspaceRoot, 'topology/local-overlays/development.json');
+    const overlay = node_fs.existsSync(overlayPath) ? readJsonFile(overlayPath) : {};
+    const overlayPorts = overlay.ports && 'object' == typeof overlay.ports ? overlay.ports : Object.fromEntries(apps.map((app)=>[
+            app.id,
+            app.port
+        ]));
+    const primaryShell = apps.find((app)=>'shell' === app.kind);
+    const configuredPorts = primaryShell ? {
+        ...overlayPorts,
+        [primaryShell.id]: primaryShell.port
+    } : overlayPorts;
+    const additionalShells = additionalShellsFromToolingConfig(config);
+    const configuredDevPorts = additionalShells.length > 0 ? configuredDevelopmentPorts(configuredPorts, additionalShells).toSorted((left, right)=>left - right) : void 0;
+    for (const app of apps){
+        const modernConfigPath = node_path.join(io.workspaceRoot, app.directory, 'modern.config.ts');
+        const rawGeneratedModernConfig = createAppModernConfig(config.workspace.packageScope, app, remotes, config.features.tailwind, configuredDevPorts);
+        const previousTailwindModernConfig = addPreviousTailwindOptimizationOverride(rawGeneratedModernConfig);
+        const currentGeneratedModernConfigs = [
+            rawGeneratedModernConfig,
+            addLegacyGeneratedModernDefaults(rawGeneratedModernConfig),
+            previousTailwindModernConfig,
+            addLegacyGeneratedModernDefaults(previousTailwindModernConfig)
+        ];
+        const [generatedModernConfig, ...recognizedGeneratedModernConfigs] = formatGeneratedModernConfigCandidates(currentGeneratedModernConfigs.flatMap((source)=>[
+                source,
+                removeTsCheckerBuildOverride(source)
+            ]));
+        if (node_fs.existsSync(modernConfigPath)) {
+            const existingModernConfig = node_fs.readFileSync(modernConfigPath, 'utf-8');
+            if (existingModernConfig === generatedModernConfig) io.writeGenerated(modernConfigPath, existingModernConfig);
+            else if (isGeneratedModernConfig(existingModernConfig, [
+                generatedModernConfig,
+                ...recognizedGeneratedModernConfigs
+            ])) io.writeGenerated(modernConfigPath, generatedModernConfig);
+            else io.log(`${node_path.relative(io.workspaceRoot, modernConfigPath)} was preserved: an existing Modern config is consumer-owned unless its generated ownership can be proven.`);
+        } else io.writeGenerated(modernConfigPath, generatedModernConfig);
+        const moduleFederationConfigPath = node_path.join(io.workspaceRoot, app.directory, 'module-federation.config.ts');
+        const enableBridgeRouter = appDeclaresReactRouter(node_path.join(io.workspaceRoot, app.directory));
+        const createGeneratedModuleFederationConfig = (bridgeRouter)=>formatGeneratedTypeScriptConfig('shell' === app.kind ? createShellModuleFederationConfig(config.workspace.packageScope, app, remotes, bridgeRouter) : createRemoteModuleFederationConfig(config.workspace.packageScope, app, remotes, bridgeRouter));
+        const generatedModuleFederationConfig = createGeneratedModuleFederationConfig(enableBridgeRouter);
+        const recognizedModuleFederationConfigs = [
+            generatedModuleFederationConfig,
+            createGeneratedModuleFederationConfig(!enableBridgeRouter)
+        ];
+        if (appEmitsBrowserUi(app)) writeOwnedTypeScriptConfig(io, moduleFederationConfigPath, generatedModuleFederationConfig, recognizedModuleFederationConfigs);
+        else removeOwnedTypeScriptConfig(io, moduleFederationConfigPath, recognizedModuleFederationConfigs);
+        const backendFederationConfigPath = node_path.join(io.workspaceRoot, app.directory, 'backend-federation.config.ts');
+        const generatedBackendFederationConfig = formatGeneratedTypeScriptConfig(createBackendModuleFederationConfig(app));
+        if (appHasApi(app)) writeOwnedTypeScriptConfig(io, backendFederationConfigPath, generatedBackendFederationConfig, [
+            generatedBackendFederationConfig
+        ]);
+        else removeOwnedTypeScriptConfig(io, backendFederationConfigPath, [
+            generatedBackendFederationConfig
+        ]);
+        if ('shell' === app.kind) {
+            const shellUiRemotes = resolveRemoteRefs(app, remotes).filter(appEmitsBrowserUi);
+            const componentsPath = node_path.join(io.workspaceRoot, app.directory, 'src/routes/vertical-components.tsx');
+            const workerComponentsPath = node_path.join(io.workspaceRoot, app.directory, 'src/routes/vertical-components.worker.tsx');
+            const existingComponents = node_fs.existsSync(componentsPath) ? node_fs.readFileSync(componentsPath, 'utf-8') : void 0;
+            if (void 0 === existingComponents || isGeneratedShellComposition(existingComponents)) {
+                io.writeGenerated(componentsPath, createShellRemoteComponents(app, shellUiRemotes));
+                io.writeGenerated(workerComponentsPath, createShellWorkerRemoteComponents(app, shellUiRemotes));
+            } else if (node_fs.existsSync(workerComponentsPath) && isGeneratedShellComposition(node_fs.readFileSync(workerComponentsPath, 'utf-8'))) io.remove(workerComponentsPath);
+        } else for (const expose of distributedSsrExposes(app))writeGeneratedUiSourceIfChanged(io, node_path.join(io.workspaceRoot, app.directory, `src/routes/[lang]/_mf/fragment/${distributedSsrFragmentSlug(expose)}/page.tsx`), createRemoteExposeFragmentPage(app, expose));
+        if ((app.verticalRefs?.length ?? 0) > 0) {
+            writeGeneratedUiSourceIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'src/federated-components.tsx'), createFederatedComponentsRegistry(config.workspace.packageScope, app, remotes));
+            writeGeneratedUiSourceIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'src/federated-components.worker.tsx'), createFederatedComponentsRegistry(config.workspace.packageScope, app, remotes, true));
+        }
+    }
+}
+export { updateGeneratedModernConfigs };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-oxfmt.js

@@ -0,0 +1,98 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+function ensureGeneratedOxfmtIgnorePatterns(io) {
+    const configPath = node_path.join(io.workspaceRoot, 'oxfmt.config.ts');
+    if (!node_fs.existsSync(configPath)) return false;
+    const source = node_fs.readFileSync(configPath, 'utf-8');
+    const legacyPreset = /^([ \t]*)extends:\s*\[\s*ultracite\s*\],?[ \t]*$/mu;
+    const nextPresetSource = legacyPreset.test(source) ? source.replace(legacyPreset, '$1...ultracite,') : source;
+    const requiredPatterns = [
+        '.modernjs',
+        '.output',
+        'repos/**',
+        '**/modern-tanstack/**',
+        '**/routeTree.gen.*'
+    ];
+    const warnUnparseable = ()=>{
+        const message = `Could not update oxfmt.config.ts ignorePatterns automatically; add these entries manually: ${requiredPatterns.join(', ')}.`;
+        if (io.dryRun) io.log(message);
+        else process.stderr.write(`[ultramodern] ${message}\n`);
+    };
+    const writePresetReconciliation = ()=>{
+        if (nextPresetSource !== source) io.write(configPath, nextPresetSource);
+    };
+    const anchor = nextPresetSource.indexOf('ignorePatterns:');
+    if (-1 === anchor) {
+        warnUnparseable();
+        writePresetReconciliation();
+        return false;
+    }
+    const openBracket = nextPresetSource.indexOf('[', anchor);
+    if (-1 === openBracket) {
+        warnUnparseable();
+        writePresetReconciliation();
+        return false;
+    }
+    let depth = 0;
+    let closeBracket = -1;
+    let stringQuote;
+    for(let index = openBracket; index < nextPresetSource.length; index += 1){
+        const char = nextPresetSource[index];
+        if (stringQuote) {
+            if ('\\' === char) index += 1;
+            else if (char === stringQuote) stringQuote = void 0;
+            continue;
+        }
+        if ("'" === char || '"' === char || '`' === char) stringQuote = char;
+        else if ('[' === char) depth += 1;
+        else if (']' === char) {
+            depth -= 1;
+            if (0 === depth) {
+                closeBracket = index;
+                break;
+            }
+        }
+    }
+    if (-1 === closeBracket) {
+        warnUnparseable();
+        writePresetReconciliation();
+        return false;
+    }
+    const body = nextPresetSource.slice(openBracket + 1, closeBracket);
+    if (body.includes('...')) {
+        warnUnparseable();
+        writePresetReconciliation();
+        return false;
+    }
+    const literalPattern = /(['"`])((?:\\.|(?!\1).)*)\1/g;
+    const existing = new Set();
+    for (const match of body.matchAll(literalPattern))existing.add(match[2]);
+    const missing = requiredPatterns.filter((pattern)=>!existing.has(pattern));
+    if (0 === missing.length) {
+        writePresetReconciliation();
+        return true;
+    }
+    const bodyLines = body.split('\n');
+    let indent = '  ';
+    let quote = "'";
+    for(let index = bodyLines.length - 1; index >= 0; index -= 1){
+        const literal = bodyLines[index].match(/^(\s*)(['"`])/u);
+        if (literal) {
+            indent = literal[1];
+            quote = literal[2];
+            break;
+        }
+    }
+    const head = nextPresetSource.slice(0, closeBracket);
+    const rest = nextPresetSource.slice(closeBracket);
+    const tailMatch = head.match(/(\r?\n[ \t]*)$/u);
+    const tail = tailMatch ? tailMatch[1] : '\n';
+    let bodyContent = tailMatch ? head.slice(0, head.length - tail.length) : head;
+    if (!/[[,]\s*$/u.test(bodyContent)) bodyContent = `${bodyContent},`;
+    const insertionLines = missing.map((pattern)=>`${indent}${quote}${pattern}${quote},`).join('\n');
+    const nextSource = `${bodyContent}\n${insertionLines}${tail}${rest}`;
+    io.write(configPath, nextSource);
+    return true;
+}
+export { ensureGeneratedOxfmtIgnorePatterns };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-oxlint.js

@@ -0,0 +1,62 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+const functionStyleRule = `    'func-style': [
+      'error',
+      'declaration',
+      {
+        allowArrowFunctions: true,
+      },
+    ],`;
+const componentStyleRule = `    'react/function-component-definition': [
+      'error',
+      {
+        namedComponents: ['function-declaration', 'arrow-function'],
+      },
+    ],`;
+const componentStyleRules = `  rules: {
+${functionStyleRule}
+${componentStyleRule}
+  },`;
+const hasFunctionStyleRule = (source)=>/['"]func-style['"]/u.test(source);
+const hasComponentStyleRule = (source)=>/['"]react\/function-component-definition['"]/u.test(source);
+const rulesAnchor = /^ {2}rules:\s*\{[ \t]*$/mu;
+const legacyComponentStyleRules = `  rules: {
+    'react/function-component-definition': [
+      'error',
+      {
+        namedComponents: ['function-declaration', 'arrow-function'],
+      },
+    ],
+  },`;
+function ensureGeneratedOxlintComponentStyle(io) {
+    const configPath = node_path.join(io.workspaceRoot, 'oxlint.config.ts');
+    if (!node_fs.existsSync(configPath)) return false;
+    const source = node_fs.readFileSync(configPath, 'utf-8');
+    const hasFunctionStyle = hasFunctionStyleRule(source);
+    const hasComponentStyle = hasComponentStyleRule(source);
+    if (hasFunctionStyle && hasComponentStyle) return false;
+    const warnUnparseable = ()=>{
+        const message = 'Could not update oxlint.config.ts component style policy automatically; regenerate the framework-owned config.';
+        if (io.dryRun) io.log(message);
+        else process.stderr.write(`[ultramodern] ${message}\n`);
+    };
+    if (hasComponentStyle && !hasFunctionStyle) {
+        if (!source.includes(legacyComponentStyleRules)) {
+            warnUnparseable();
+            return false;
+        }
+        return io.write(configPath, source.replace(rulesAnchor, (match)=>`${match}\n${functionStyleRule}`));
+    }
+    if (/^[ \t]*rules\s*:/mu.test(source)) {
+        warnUnparseable();
+        return false;
+    }
+    const extendsAnchor = /^ {2}extends:\s*\[\s*core\s*,\s*react\s*\],[ \t]*$/mu;
+    if (!extendsAnchor.test(source)) {
+        warnUnparseable();
+        return false;
+    }
+    return io.write(configPath, source.replace(extendsAnchor, (match)=>`${match}\n${componentStyleRules}`));
+}
+export { ensureGeneratedOxlintComponentStyle };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-removal.js

@@ -0,0 +1,17 @@
+import "node:module";
+import node_path from "node:path";
+import { allWorkspaceAppsFromToolingConfig } from "../../config.js";
+function removeGeneratedFileIfExists(io, relativePath) {
+    return io.remove(node_path.join(io.workspaceRoot, relativePath));
+}
+function removeStaleBackendFederationArtifacts(io, config) {
+    let changed = false;
+    for (const relativePath of [
+        "scripts/generate-node-backend-federation.mts",
+        "scripts/proof-node-backend-federation.mts",
+        "scripts/verify-cloudflare-output.mts"
+    ])changed = removeGeneratedFileIfExists(io, relativePath) || changed;
+    for (const app of allWorkspaceAppsFromToolingConfig(config))changed = removeGeneratedFileIfExists(io, node_path.join(app.directory, 'api/backend-federation.ts')) || changed;
+    return changed;
+}
+export { removeGeneratedFileIfExists, removeStaleBackendFederationArtifacts };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-typescript.js

@@ -0,0 +1,231 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { ULTRAMODERN_CREATE_PACKAGE } from "../../../ultramodern-package-source.js";
+import { createAppEnvDts, createAppRuntimeConfig } from "../../../ultramodern-workspace/app-files.js";
+import { createRemoteExposeFragmentPage, regenerateGeneratedNavigationSurface, remoteComponentOutputPath } from "../../../ultramodern-workspace/demo-components.js";
+import { appI18nNamespace, distributedSsrExposes, distributedSsrFragmentSlug, resolveRemoteRefs } from "../../../ultramodern-workspace/descriptors.js";
+import { createAppMfTypesTsConfig, createAppTsConfig, createSharedPackageTsConfig, createTsConfigBase } from "../../../ultramodern-workspace/package-json.js";
+import { allWorkspaceAppsFromToolingConfig } from "../../config.js";
+import { writeGeneratedUiSourceIfChanged } from "./generated-ui-source.js";
+import { writeJsonFile } from "./io.js";
+function jsonObject(value) {
+    return null === value || 'object' != typeof value || Array.isArray(value) ? void 0 : value;
+}
+function hasStringName(value) {
+    return 'string' == typeof value?.name;
+}
+function readJsonObject(filePath) {
+    if (!node_fs.existsSync(filePath)) return;
+    return jsonObject(JSON.parse(node_fs.readFileSync(filePath, 'utf-8')));
+}
+function mergeUniqueJsonValues(generated, existing) {
+    const generatedValues = Array.isArray(generated) ? generated : [];
+    const existingValues = Array.isArray(existing) ? existing : [];
+    const seen = new Set(generatedValues.map((value)=>JSON.stringify(value)));
+    return [
+        ...generatedValues,
+        ...existingValues.filter((value)=>{
+            const key = JSON.stringify(value);
+            if (seen.has(key)) return false;
+            seen.add(key);
+            return true;
+        })
+    ];
+}
+function mergeTypeScriptPlugins(generated, existing) {
+    const generatedPlugins = Array.isArray(generated) ? generated : [];
+    const existingPlugins = Array.isArray(existing) ? existing : [];
+    const existingByName = new Map(existingPlugins.map(jsonObject).filter(hasStringName).map((plugin)=>[
+            plugin.name,
+            plugin
+        ]));
+    const merged = generatedPlugins.map((generatedPlugin)=>{
+        const generatedObject = jsonObject(generatedPlugin);
+        const existingObject = 'string' == typeof generatedObject?.name ? existingByName.get(generatedObject.name) : void 0;
+        if (!generatedObject || !existingObject) return generatedPlugin;
+        existingByName.delete(generatedObject.name);
+        return {
+            ...generatedObject,
+            ...existingObject,
+            diagnosticSeverity: {
+                ...jsonObject(generatedObject.diagnosticSeverity),
+                ...jsonObject(existingObject.diagnosticSeverity)
+            }
+        };
+    });
+    return [
+        ...merged,
+        ...existingByName.values()
+    ];
+}
+function mergeTypeScriptConfig(generated, existing) {
+    const generatedConfig = jsonObject(generated) ?? {};
+    const existingConfig = jsonObject(existing) ?? {};
+    const generatedCompilerOptions = jsonObject(generatedConfig.compilerOptions) ?? {};
+    const existingCompilerOptions = {
+        ...jsonObject(existingConfig.compilerOptions) ?? {}
+    };
+    delete existingCompilerOptions.skipLibCheck;
+    const compilerOptions = {
+        ...existingCompilerOptions,
+        ...generatedCompilerOptions
+    };
+    if (Array.isArray(generatedCompilerOptions.plugins) || Array.isArray(existingCompilerOptions.plugins)) compilerOptions.plugins = mergeTypeScriptPlugins(generatedCompilerOptions.plugins, existingCompilerOptions.plugins);
+    const merged = {
+        ...existingConfig,
+        ...generatedConfig
+    };
+    if (Object.keys(compilerOptions).length > 0) merged.compilerOptions = compilerOptions;
+    for (const key of [
+        'include',
+        'exclude',
+        'references'
+    ])if (Array.isArray(generatedConfig[key]) || Array.isArray(existingConfig[key])) merged[key] = mergeUniqueJsonValues(generatedConfig[key], existingConfig[key]);
+    return merged;
+}
+function writeMergedTypeScriptConfig(io, filePath, generated) {
+    const existing = readJsonObject(filePath);
+    const merged = mergeTypeScriptConfig(generated, existing);
+    if (existing && JSON.stringify(merged) !== JSON.stringify(generated)) io.log(`${node_path.relative(io.workspaceRoot, filePath)} preserved consumer-owned TypeScript configuration.`);
+    return writeJsonFile(io, filePath, merged);
+}
+function generatedManifest(io, config) {
+    const sourcePath = node_path.isAbsolute(config.sourcePath) ? config.sourcePath : node_path.join(io.workspaceRoot, config.sourcePath);
+    const manifest = readJsonObject(sourcePath);
+    const generator = jsonObject(manifest?.generator);
+    return generator?.package === ULTRAMODERN_CREATE_PACKAGE || generator?.package === '@modern-js/create' ? manifest : void 0;
+}
+function manifestApps(manifest) {
+    const topology = jsonObject(manifest.topology);
+    return Array.isArray(topology?.apps) ? topology.apps.map(jsonObject).filter((app)=>void 0 !== app) : [];
+}
+function packageManifest(io, appDirectory) {
+    return readJsonObject(node_path.join(io.workspaceRoot, appDirectory, 'package.json'));
+}
+function shellSurfaceIsOwned(io, app, manifestApp) {
+    const packageJson = packageManifest(io, app.directory);
+    const moduleFederation = jsonObject(manifestApp.moduleFederation);
+    return 'shell' === manifestApp.kind && manifestApp.path === app.directory && moduleFederation?.role === 'host' && 'string' == typeof manifestApp.package && packageJson?.name === manifestApp.package;
+}
+function deliveryUnitSurfaceIsOwned(io, config, app, manifestApp, expose, sourcePath) {
+    const deliveryUnit = jsonObject(manifestApp.deliveryUnit);
+    const moduleFederation = jsonObject(manifestApp.moduleFederation);
+    const packageJson = packageManifest(io, app.directory);
+    const packageExports = jsonObject(packageJson?.exports);
+    const exposedSurfaces = Array.isArray(moduleFederation?.exposes) ? moduleFederation.exposes : [];
+    const packageName = manifestApp.package;
+    return 'vertical' === manifestApp.kind && manifestApp.path === app.directory && 'string' == typeof packageName && packageJson?.name === packageName && deliveryUnit?.kind === 'microvertical-delivery-unit' && deliveryUnit.packageName === packageName && deliveryUnit.unitId === `${config.workspace.packageScope}/${app.id}` && exposedSurfaces.includes(expose) && packageExports?.[expose] === sourcePath;
+}
+function updateGeneratedNavigationSurfaces(io, config) {
+    const manifest = generatedManifest(io, config);
+    if (void 0 === manifest) return false;
+    const apps = allWorkspaceAppsFromToolingConfig(config);
+    const appsById = new Map(manifestApps(manifest).map((app)=>[
+            String(app.id ?? ''),
+            app
+        ]));
+    let changed = false;
+    for (const app of apps){
+        const manifestApp = appsById.get(app.id);
+        if (void 0 !== manifestApp) {
+            if ('shell' === app.kind && shellSurfaceIsOwned(io, app, manifestApp)) {
+                const filePath = node_path.join(io.workspaceRoot, app.directory, 'src/routes/shell-frame.tsx');
+                if (node_fs.existsSync(filePath)) {
+                    const source = node_fs.readFileSync(filePath, 'utf-8');
+                    changed = io.write(filePath, regenerateGeneratedNavigationSurface(source, 'shell-frame')) || changed;
+                }
+                continue;
+            }
+            for (const [expose, sourcePath] of Object.entries(app.exposes ?? {})){
+                const isCheckoutNavigationSurface = './AddToCart' === expose && './src/components/add-to-cart.tsx' === sourcePath || './CheckoutPage' === expose && './src/components/checkout-page.tsx' === sourcePath;
+                if ('checkout' !== app.id || !isCheckoutNavigationSurface) continue;
+                const relativePath = remoteComponentOutputPath(app, expose);
+                if (void 0 === relativePath || !deliveryUnitSurfaceIsOwned(io, config, app, manifestApp, expose, sourcePath)) continue;
+                const filePath = node_path.join(io.workspaceRoot, relativePath);
+                if (!node_fs.existsSync(filePath)) continue;
+                const source = node_fs.readFileSync(filePath, 'utf-8');
+                if (source.includes(`data-modern-boundary-id="${app.id}"`) && source.includes(`data-modern-mf-expose="${expose}"`)) changed = io.write(filePath, regenerateGeneratedNavigationSurface(source, 'demo-component')) || changed;
+            }
+        }
+    }
+    return changed;
+}
+function ensureGeneratedIgnoreRules(io) {
+    const gitignorePath = node_path.join(io.workspaceRoot, '.gitignore');
+    const existing = node_fs.existsSync(gitignorePath) ? node_fs.readFileSync(gitignorePath, 'utf-8') : '';
+    const lines = 0 === existing.trimEnd().length ? [] : existing.trimEnd().split(/\r?\n/u);
+    let changed = false;
+    for (const rule of [
+        '.mf/',
+        '**/.mf/',
+        'dist-cloudflare/',
+        '.output/',
+        '**/.output/',
+        '.modern-js/',
+        '**/.modern-js/',
+        '**/src/modern-tanstack/',
+        '**/.tsgo.*.resolved.json'
+    ])if (!lines.includes(rule)) {
+        lines.push(rule);
+        changed = true;
+    }
+    if (!changed) return false;
+    return io.write(gitignorePath, `${lines.join('\n')}\n`);
+}
+function updateGeneratedShellRuntimeSurfaces(io, config) {
+    const manifest = generatedManifest(io, config);
+    if (void 0 === manifest) return false;
+    const apps = allWorkspaceAppsFromToolingConfig(config);
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    const appsById = new Map(manifestApps(manifest).map((app)=>[
+            String(app.id ?? ''),
+            app
+        ]));
+    let changed = false;
+    for (const app of apps.filter((app)=>'shell' === app.kind)){
+        const manifestApp = appsById.get(app.id);
+        if (void 0 === manifestApp || !shellSurfaceIsOwned(io, app, manifestApp)) continue;
+        const runtimePath = node_path.join(io.workspaceRoot, app.directory, 'src/modern.runtime.ts');
+        if (!node_fs.existsSync(runtimePath)) continue;
+        const runtimeSource = node_fs.readFileSync(runtimePath, 'utf-8');
+        if (!runtimeSource.includes('/verticals/') || !runtimeSource.includes('/locales/')) continue;
+        const shellRemotes = resolveRemoteRefs(app, remotes);
+        for (const language of [
+            'en',
+            'cs'
+        ]){
+            const shellLocaleDirectory = node_path.join(io.workspaceRoot, app.directory, 'locales', language);
+            const shellLocale = readJsonObject(node_path.join(shellLocaleDirectory, `${appI18nNamespace(app)}.json`)) ?? {};
+            const mergedLocale = Object.assign({}, shellLocale, ...shellRemotes.map((remote)=>readJsonObject(node_path.join(io.workspaceRoot, remote.directory, 'locales', language, `${appI18nNamespace(remote)}.json`))));
+            changed = writeJsonFile(io, node_path.join(shellLocaleDirectory, `${appI18nNamespace(app)}.json`), mergedLocale) || changed;
+            changed = writeJsonFile(io, node_path.join(shellLocaleDirectory, 'translation.json'), mergedLocale) || changed;
+        }
+        changed = io.write(runtimePath, createAppRuntimeConfig(app, config.workspace.packageScope, remotes)) || changed;
+    }
+    return changed;
+}
+function updateGeneratedTypeScriptSurfaces(io, config) {
+    const apps = allWorkspaceAppsFromToolingConfig(config);
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    writeMergedTypeScriptConfig(io, node_path.join(io.workspaceRoot, 'tsconfig.base.json'), createTsConfigBase());
+    ensureGeneratedIgnoreRules(io);
+    for (const sharedPackage of [
+        'packages/shared-contracts',
+        'packages/shared-design-tokens'
+    ])writeMergedTypeScriptConfig(io, node_path.join(io.workspaceRoot, sharedPackage, 'tsconfig.json'), createSharedPackageTsConfig(sharedPackage));
+    for (const app of apps){
+        writeMergedTypeScriptConfig(io, node_path.join(io.workspaceRoot, app.directory, 'tsconfig.json'), createAppTsConfig(app, remotes));
+        writeMergedTypeScriptConfig(io, node_path.join(io.workspaceRoot, app.directory, 'tsconfig.mf-types.json'), createAppMfTypesTsConfig(app));
+        io.write(node_path.join(io.workspaceRoot, app.directory, 'src/modern-app-env.d.ts'), createAppEnvDts(app, remotes, config.workspace.packageScope));
+        if ('shell' !== app.kind) for (const expose of distributedSsrExposes(app)){
+            const fragmentPagePath = node_path.join(io.workspaceRoot, app.directory, 'src/routes/[lang]/_mf/fragment', distributedSsrFragmentSlug(expose), 'page.tsx');
+            if (!node_fs.existsSync(fragmentPagePath)) continue;
+            const fragmentPageSource = node_fs.readFileSync(fragmentPagePath, 'utf-8');
+            if (fragmentPageSource.includes("from '@modern-js/runtime/module-federation';") && fragmentPageSource.includes('data-modern-distributed-ssr-marker="start"')) writeGeneratedUiSourceIfChanged(io, fragmentPagePath, createRemoteExposeFragmentPage(app, expose));
+        }
+    }
+    updateGeneratedShellRuntimeSurfaces(io, config);
+    updateGeneratedNavigationSurfaces(io, config);
+}
+export { updateGeneratedTypeScriptSurfaces };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-zerops.js

@@ -0,0 +1,11 @@
+import "node:module";
+import node_path from "node:path";
+import { createZeropsRuntimeMaterializationScript } from "../../../ultramodern-workspace/workspace-scripts.js";
+import { createZeropsYaml } from "../../../ultramodern-workspace/zerops.js";
+import { allWorkspaceAppsFromToolingConfig } from "../../config.js";
+function updateGeneratedZeropsArtifacts(io, config) {
+    const apps = allWorkspaceAppsFromToolingConfig(config);
+    io.writeGenerated(node_path.join(io.workspaceRoot, 'zerops.yaml'), `${createZeropsYaml(config.workspace.packageScope, apps)}\n`);
+    io.writeGenerated(node_path.join(io.workspaceRoot, "scripts/materialize-zerops-runtime.mjs"), createZeropsRuntimeMaterializationScript());
+}
+export { updateGeneratedZeropsArtifacts };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts.js

@@ -0,0 +1,9 @@
+import "node:module";
+export { updateGeneratedBackendFederationContractFiles } from "./generated-artifacts-backend-federation.js";
+export { updateGeneratedBuildIdentityModules } from "./generated-artifacts-build-identity.js";
+export { updateGeneratedModernConfigs } from "./generated-artifacts-modern-configs.js";
+export { ensureGeneratedOxfmtIgnorePatterns } from "./generated-artifacts-oxfmt.js";
+export { ensureGeneratedOxlintComponentStyle } from "./generated-artifacts-oxlint.js";
+export { removeGeneratedFileIfExists, removeStaleBackendFederationArtifacts } from "./generated-artifacts-removal.js";
+export { updateGeneratedTypeScriptSurfaces } from "./generated-artifacts-typescript.js";
+export { updateGeneratedZeropsArtifacts } from "./generated-artifacts-zerops.js";

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-patches.js

@@ -0,0 +1,16 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+function ensureGeneratedPatchFile(io, relativePatchPath, sourcePatchPath) {
+    const targetPath = node_path.join(io.workspaceRoot, relativePatchPath);
+    const patch = node_fs.readFileSync(sourcePatchPath, 'utf-8');
+    return io.write(targetPath, patch);
+}
+function removeGeneratedPatchFileIfUnchanged(io, relativePatchPath, sourcePatchPath) {
+    const targetPath = node_path.join(io.workspaceRoot, relativePatchPath);
+    if (!node_fs.existsSync(targetPath)) return false;
+    const patch = node_fs.readFileSync(sourcePatchPath, 'utf-8');
+    if (node_fs.readFileSync(targetPath, 'utf-8') !== patch) return false;
+    return io.remove(targetPath);
+}
+export { ensureGeneratedPatchFile, removeGeneratedPatchFileIfUnchanged };