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

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

@@ -0,0 +1,52 @@
+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 { 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, writeTextIfChanged } from "./io.js";
+function isGeneratedShellComposition(source) {
+    return source.includes('const createRemoteComponent =') && source.includes('export const VerticalShowcase =');
+}
+function updateGeneratedModernConfigs(io, config) {
+    let changed = false;
+    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){
+        changed = writeTextIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'modern.config.ts'), createAppModernConfig(config.workspace.packageScope, app, remotes, config.features.tailwind, configuredDevPorts)) || changed;
+        changed = appEmitsBrowserUi(app) ? writeTextIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'module-federation.config.ts'), 'shell' === app.kind ? createShellModuleFederationConfig(config.workspace.packageScope, app, remotes) : createRemoteModuleFederationConfig(config.workspace.packageScope, app, remotes)) || changed : io.remove(node_path.join(io.workspaceRoot, app.directory, 'module-federation.config.ts')) || changed;
+        changed = appHasApi(app) ? writeTextIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'backend-federation.config.ts'), createBackendModuleFederationConfig(app)) || changed : io.remove(node_path.join(io.workspaceRoot, app.directory, 'backend-federation.config.ts')) || changed;
+        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)) {
+                changed = writeTextIfChanged(io, componentsPath, createShellRemoteComponents(app, shellUiRemotes)) || changed;
+                changed = writeTextIfChanged(io, workerComponentsPath, createShellWorkerRemoteComponents(app, shellUiRemotes)) || changed;
+            } else if (node_fs.existsSync(workerComponentsPath) && isGeneratedShellComposition(node_fs.readFileSync(workerComponentsPath, 'utf-8'))) changed = io.remove(workerComponentsPath) || changed;
+        } else for (const expose of distributedSsrExposes(app))changed = writeGeneratedUiSourceIfChanged(io, node_path.join(io.workspaceRoot, app.directory, `src/routes/[lang]/_mf/fragment/${distributedSsrFragmentSlug(expose)}/page.tsx`), createRemoteExposeFragmentPage(app, expose)) || changed;
+        if ((app.verticalRefs?.length ?? 0) > 0) {
+            changed = writeGeneratedUiSourceIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'src/federated-components.tsx'), createFederatedComponentsRegistry(config.workspace.packageScope, app, remotes)) || changed;
+            changed = writeGeneratedUiSourceIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'src/federated-components.worker.tsx'), createFederatedComponentsRegistry(config.workspace.packageScope, app, remotes, true)) || changed;
+        }
+    }
+    return changed;
+}
+export { updateGeneratedModernConfigs };

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

@@ -0,0 +1,84 @@
+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 requiredPatterns = [
+        '.modernjs',
+        '.output',
+        '**/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 anchor = source.indexOf('ignorePatterns:');
+    if (-1 === anchor) {
+        warnUnparseable();
+        return false;
+    }
+    const openBracket = source.indexOf('[', anchor);
+    if (-1 === openBracket) {
+        warnUnparseable();
+        return false;
+    }
+    let depth = 0;
+    let closeBracket = -1;
+    let stringQuote;
+    for(let index = openBracket; index < source.length; index += 1){
+        const char = source[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();
+        return false;
+    }
+    const body = source.slice(openBracket + 1, closeBracket);
+    if (body.includes('...')) {
+        warnUnparseable();
+        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) return false;
+    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 = source.slice(0, closeBracket);
+    const rest = source.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}`;
+    return io.write(configPath, nextSource);
+}
+export { ensureGeneratedOxfmtIgnorePatterns };

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,158 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+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 { writeJsonIfChanged, writeTextIfChanged } from "./io.js";
+function jsonObject(value) {
+    return null === value || 'object' != typeof value || Array.isArray(value) ? void 0 : value;
+}
+function readJsonObject(filePath) {
+    if (!node_fs.existsSync(filePath)) return;
+    return jsonObject(JSON.parse(node_fs.readFileSync(filePath, 'utf-8')));
+}
+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 === '@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 = writeTextIfChanged(io, 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 = writeTextIfChanged(io, 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 = writeJsonIfChanged(io, node_path.join(shellLocaleDirectory, `${appI18nNamespace(app)}.json`), mergedLocale) || changed;
+            changed = writeJsonIfChanged(io, node_path.join(shellLocaleDirectory, 'translation.json'), mergedLocale) || changed;
+        }
+        changed = writeTextIfChanged(io, runtimePath, createAppRuntimeConfig(app, config.workspace.packageScope, remotes)) || changed;
+    }
+    return changed;
+}
+function updateGeneratedTypeScriptSurfaces(io, config) {
+    let changed = false;
+    const apps = allWorkspaceAppsFromToolingConfig(config);
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    changed = writeJsonIfChanged(io, node_path.join(io.workspaceRoot, 'tsconfig.base.json'), createTsConfigBase()) || changed;
+    changed = ensureGeneratedIgnoreRules(io) || changed;
+    for (const sharedPackage of [
+        'packages/shared-contracts',
+        'packages/shared-design-tokens'
+    ])changed = writeJsonIfChanged(io, node_path.join(io.workspaceRoot, sharedPackage, 'tsconfig.json'), createSharedPackageTsConfig(sharedPackage)) || changed;
+    for (const app of apps){
+        changed = writeJsonIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'tsconfig.json'), createAppTsConfig(app, remotes)) || changed;
+        changed = writeJsonIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'tsconfig.mf-types.json'), createAppMfTypesTsConfig(app)) || changed;
+        changed = writeTextIfChanged(io, node_path.join(io.workspaceRoot, app.directory, 'src/modern-app-env.d.ts'), createAppEnvDts(app, remotes, config.workspace.packageScope)) || changed;
+        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"')) changed = writeGeneratedUiSourceIfChanged(io, fragmentPagePath, createRemoteExposeFragmentPage(app, expose)) || changed;
+        }
+    }
+    changed = updateGeneratedShellRuntimeSurfaces(io, config) || changed;
+    changed = updateGeneratedNavigationSurfaces(io, config) || changed;
+    return changed;
+}
+export { updateGeneratedTypeScriptSurfaces };

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

@@ -0,0 +1,13 @@
+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";
+import { writeTextIfChanged } from "./io.js";
+function updateGeneratedZeropsArtifacts(io, config) {
+    const apps = allWorkspaceAppsFromToolingConfig(config);
+    let changed = writeTextIfChanged(io, node_path.join(io.workspaceRoot, 'zerops.yaml'), `${createZeropsYaml(config.workspace.packageScope, apps)}\n`);
+    changed = writeTextIfChanged(io, node_path.join(io.workspaceRoot, "scripts/materialize-zerops-runtime.mjs"), createZeropsRuntimeMaterializationScript()) || changed;
+    return changed;
+}
+export { updateGeneratedZeropsArtifacts };

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

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

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

@@ -0,0 +1,98 @@
+import "node:module";
+import node_fs from "node:fs";
+import { isDeepStrictEqual } from "node:util";
+import { writeTextIfChanged } from "./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) && !generatedUiSourceRequiresRewrite(node_fs.readFileSync(filePath, 'utf-8'), nextSource)) return false;
+    return writeTextIfChanged(io, filePath, nextSource);
+}
+export { generatedUiSourceRequiresRewrite, writeGeneratedUiSourceIfChanged };

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

@@ -0,0 +1,17 @@
+import "node:module";
+const migrateStrictEffectHelp = `Usage:
+  modern-js-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.
+
+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
+(implies --skip-install).
+`;
+export { migrateStrictEffectHelp };

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

@@ -0,0 +1,15 @@
+import "node:module";
+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 };