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

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

@@ -0,0 +1,97 @@
+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/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-oxlint.js

@@ -0,0 +1,61 @@
+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/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-removal.js

@@ -0,0 +1,16 @@
+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/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-typescript.js

@@ -0,0 +1,230 @@
+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/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-zerops.js

@@ -0,0 +1,10 @@
+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/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts.js

@@ -0,0 +1,8 @@
+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/ultramodern-tooling/commands/migrate-strict-effect/generated-patches.js

@@ -0,0 +1,15 @@
+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 };

package/dist/esm/ultramodern-tooling/commands/migrate-strict-effect/generated-ui-source.js

@@ -0,0 +1,100 @@
+import node_fs from "node:fs";
+import { isDeepStrictEqual } from "node:util";
+import "./io.js";
+const multiCharacterTokens = [
+    '===',
+    '!==',
+    '**=',
+    '&&=',
+    '||=',
+    '??=',
+    '...',
+    '=>',
+    '==',
+    '!=',
+    '<=',
+    '>=',
+    '++',
+    '--',
+    '&&',
+    '||',
+    '??',
+    '?.',
+    '**',
+    '+=',
+    '-=',
+    '*=',
+    '/=',
+    '%=',
+    '&=',
+    '|=',
+    '^=',
+    '</',
+    '/>'
+];
+function isIdentifierPart(character) {
+    return /[$_\p{ID_Continue}\u200C\u200D]/u.test(character);
+}
+function generatedUiSourceTokens(source) {
+    const tokens = [];
+    let index = 0;
+    while(index < source.length){
+        const character = source[index] ?? '';
+        if (/\s/u.test(character)) {
+            index += 1;
+            continue;
+        }
+        if (source.startsWith('//', index)) {
+            const lineEnd = source.indexOf('\n', index + 2);
+            index = lineEnd < 0 ? source.length : lineEnd + 1;
+            continue;
+        }
+        if (source.startsWith('/*', index)) {
+            const commentEnd = source.indexOf('*/', index + 2);
+            index = commentEnd < 0 ? source.length : commentEnd + 2;
+            continue;
+        }
+        if ("'" === character || '"' === character || '`' === character) {
+            const quote = character;
+            const start = index;
+            index += 1;
+            let escaped = false;
+            while(index < source.length){
+                const current = source[index] ?? '';
+                index += 1;
+                if (escaped) escaped = false;
+                else if ('\\' === current) escaped = true;
+                else if (current === quote) break;
+            }
+            tokens.push(`literal:${source.slice(start, index)}`);
+            continue;
+        }
+        if (isIdentifierPart(character)) {
+            const start = index;
+            index += 1;
+            while(isIdentifierPart(source[index] ?? ''))index += 1;
+            tokens.push(`word:${source.slice(start, index)}`);
+            continue;
+        }
+        const multiCharacterToken = multiCharacterTokens.find((token)=>source.startsWith(token, index));
+        if (multiCharacterToken) {
+            tokens.push(`punctuator:${multiCharacterToken}`);
+            index += multiCharacterToken.length;
+            continue;
+        }
+        tokens.push(`punctuator:${character}`);
+        index += 1;
+    }
+    return tokens;
+}
+function generatedUiSourceRequiresRewrite(existingSource, nextSource) {
+    return !isDeepStrictEqual(generatedUiSourceTokens(existingSource), generatedUiSourceTokens(nextSource));
+}
+function writeGeneratedUiSourceIfChanged(io, filePath, nextSource) {
+    if (node_fs.existsSync(filePath)) {
+        const existingSource = node_fs.readFileSync(filePath, 'utf-8');
+        if (!generatedUiSourceRequiresRewrite(existingSource, nextSource)) return io.writeGenerated(filePath, existingSource);
+    }
+    return io.writeGenerated(filePath, nextSource);
+}
+export { generatedUiSourceRequiresRewrite, writeGeneratedUiSourceIfChanged };

package/dist/esm/ultramodern-tooling/commands/migrate-strict-effect/help.js

@@ -0,0 +1,29 @@
+const migrateStrictEffectHelp = `Usage:
+  ultramodern-create ultramodern migrate-strict-effect --version <version> [--dry-run] [--skip-install]
+
+Updates generated UltraModern package-source metadata, Modern package aliases,
+framework-owned toolchain pins, direct Effect API topology metadata, strict
+Effect pnpm overrides/trust policy, framework-owned TypeScript config
+surfaces, and the pnpm lockfile. Source code still has to pass pnpm api:check
+and pnpm contract:check.
+
+Existing Modern configs are treated as consumer-owned unless generated
+ownership can be proven. Package scripts and TypeScript configs are merged at
+their framework-owned boundaries so consumer command segments, includes,
+references, plugins, and diagnostic overrides survive. An ambiguous Module
+Federation config that requires a bridge update is refused before any file is
+written, with the config path and the manual resolution required.
+
+The obsolete react-router dependency is dropped from every generated app that
+does not import React Router in its own source. Each generated Module
+Federation config then declares bridge.enableBridgeRouter from what its app
+still depends on: true where the app declares react-router or react-router-dom,
+the router-free false everywhere else.
+
+When the compact config is absent but legacy UltraModern 3.2 metadata is
+present, the compact config is synthesized from it first. Shell-only
+workspaces skip the backend-federation and Zerops runtime stages. Pass
+--dry-run to print the planned filesystem changes without writing anything
+(including preserved consumer overlays; implies --skip-install).
+`;
+export { migrateStrictEffectHelp };

package/dist/esm/ultramodern-tooling/commands/migrate-strict-effect/install.js

@@ -0,0 +1,14 @@
+import { spawnSync } from "node:child_process";
+function runPnpmLockfileRefresh(context) {
+    const result = spawnSync('pnpm', [
+        'install',
+        '--lockfile-only',
+        "--ignore-scripts"
+    ], {
+        cwd: context.workspaceRoot,
+        stdio: 'inherit'
+    });
+    if (result.error) throw result.error;
+    return result.status ?? 1;
+}
+export { runPnpmLockfileRefresh };