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

package/dist/cjs/ultramodern-workspace/module-federation/reexport-module.cjs

@@ -34,6 +34,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const universal_namespaceObject = require("@modern-js/utils/universal");
 const external_delivery_unit_cjs_namespaceObject = require("../delivery-unit.cjs");
+const external_descriptors_cjs_namespaceObject = require("../descriptors.cjs");
 function deliveryUnitRecordFor(scope, app) {
     return app.deliveryUnit ? app.deliveryUnit : (0, external_delivery_unit_cjs_namespaceObject.createDeliveryUnitRecord)(scope, app);
 }
@@ -41,62 +42,28 @@ function createUltramodernBuildArtifactJson(scope, app) {
     const record = deliveryUnitRecordFor(scope, app);
     return `${JSON.stringify((0, universal_namespaceObject.createUltramodernBuildArtifact)(record), null, 2)}\n`;
 }
-function createUltramodernBuildModule(scope, app) {
+function createUltramodernBuildModule(scope, app, includeUiMarker = (0, external_descriptors_cjs_namespaceObject.appEmitsBrowserUi)(app)) {
     const record = deliveryUnitRecordFor(scope, app);
-    return `declare const ULTRAMODERN_BUILD_MARKER: string;
-declare const ULTRAMODERN_SOURCE_REVISION: string;
+    return `import { resolveUltramodernBuildArtifact } from '@modern-js/runtime-extensions/build-identity';
 
-const ultramodernGeneratedBuildArtifact = ${JSON.stringify((0, universal_namespaceObject.createUltramodernBuildArtifact)(record), null, 2)} as const;
-const ultramodernBuildMarker =
-  typeof ULTRAMODERN_BUILD_MARKER === 'string'
-    ? ULTRAMODERN_BUILD_MARKER
-    : ultramodernGeneratedBuildArtifact.deliveryUnit.buildMarker;
-const ultramodernSourceRevision =
-  typeof ULTRAMODERN_SOURCE_REVISION === 'string'
-    ? ULTRAMODERN_SOURCE_REVISION
-    : ultramodernGeneratedBuildArtifact.deliveryUnit.sourceRevision;
-const ultramodernBuildArtifact = {
-  ...ultramodernGeneratedBuildArtifact,
-  deliveryUnit: {
-    ...ultramodernGeneratedBuildArtifact.deliveryUnit,
-    build: ultramodernBuildMarker,
-    buildMarker: ultramodernBuildMarker,
-    sourceRevision: ultramodernSourceRevision,
-  },
-  surfaces: {
-    api: {
-      ...ultramodernGeneratedBuildArtifact.surfaces.api,
-      build: ultramodernBuildMarker,
-      buildMarker: ultramodernBuildMarker,
-      sourceRevision: ultramodernSourceRevision,
-    },
-    ui: {
-      ...ultramodernGeneratedBuildArtifact.surfaces.ui,
-      build: ultramodernBuildMarker,
-      buildMarker: ultramodernBuildMarker,
-      sourceRevision: ultramodernSourceRevision,
-    },
-  },
-} as const;
+declare const ULTRAMODERN_BUILD_MARKER: string;
+declare const ULTRAMODERN_SOURCE_REVISION: string;
 
-export { ultramodernBuildArtifact };
+const ultramodernBuildArtifact = resolveUltramodernBuildArtifact(${JSON.stringify((0, universal_namespaceObject.createUltramodernBuildArtifact)(record), null, 2)} as const, {
+  buildMarker: () => ULTRAMODERN_BUILD_MARKER,
+  sourceRevision: () => ULTRAMODERN_SOURCE_REVISION,
+});
 
-export const ultramodernDeliveryUnit =
-  ultramodernBuildArtifact.deliveryUnit;
-export const ultramodernVerticalIdentity = ultramodernDeliveryUnit;
-export const ultramodernUiMarker = ultramodernBuildArtifact.surfaces.ui;
-export const ultramodernApiMarker = ultramodernBuildArtifact.surfaces.api;
-`;
+export const ultramodernDeliveryUnit = ultramodernBuildArtifact.deliveryUnit;
+${includeUiMarker ? 'export const ultramodernUiMarker = ultramodernBuildArtifact.surfaces.ui;\n' : ''}${'shell' !== app.kind && (0, external_descriptors_cjs_namespaceObject.appHasApi)(app) ? 'export const ultramodernApiMarker = ultramodernBuildArtifact.surfaces.api;\n' : ''}`;
 }
-function createUltramodernBuildReexportModule() {
-    return `export {
-  ultramodernBuildArtifact,
-  ultramodernApiMarker,
-  ultramodernDeliveryUnit,
-  ultramodernUiMarker,
-  ultramodernVerticalIdentity,
-} from '../shared/ultramodern-build';
-`;
+function createUltramodernBuildReexportModule(app, includeUiMarker = (0, external_descriptors_cjs_namespaceObject.appEmitsBrowserUi)(app)) {
+    const names = [
+        'ultramodernDeliveryUnit'
+    ];
+    if (includeUiMarker) names.push('ultramodernUiMarker');
+    if ('shell' !== app.kind && (0, external_descriptors_cjs_namespaceObject.appHasApi)(app)) names.push('ultramodernApiMarker');
+    return `export { ${names.join(', ')} } from '../shared/ultramodern-build';\n`;
 }
 exports.createUltramodernBuildArtifactJson = __webpack_exports__.createUltramodernBuildArtifactJson;
 exports.createUltramodernBuildModule = __webpack_exports__.createUltramodernBuildModule;

package/dist/cjs/ultramodern-workspace/package-json.cjs

@@ -51,6 +51,7 @@ function appDependencies(scope, packageSource, app, remotes = [], bridge) {
     const dependencies = {
         '@modern-js/plugin-tanstack': (0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)('@modern-js/plugin-tanstack', packageSource),
         '@modern-js/plugin-i18n': (0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)('@modern-js/plugin-i18n', packageSource),
+        '@modern-js/runtime-extensions': (0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)('@modern-js/runtime-extensions', packageSource),
         '@modern-js/runtime': (0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)('@modern-js/runtime', packageSource),
         ...external_policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.appDependencies,
         [(0, external_naming_cjs_namespaceObject.packageName)(scope, 'shared-contracts')]: external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION,
@@ -214,7 +215,7 @@ function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [
     if (Object.keys(packageExports).length > 0) packageJson.exports = packageExports;
     return packageJson;
 }
-function createSharedPackage(scope, id, description) {
+function createSharedPackage(scope, id, description, packageSource) {
     const packageJson = {
         private: true,
         name: (0, external_naming_cjs_namespaceObject.packageName)(scope, id),
@@ -231,6 +232,17 @@ function createSharedPackage(scope, id, description) {
             '@effect/tsgo': external_policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.appDevDependencies["@effect/tsgo"]
         }
     };
+    if ('shared-contracts' === id) {
+        packageJson.exports = {
+            '.': './src/index.ts',
+            './microvertical-api-baseline': './src/microvertical-api-baseline.ts',
+            './server/effect-bff-runtime': './src/effect-bff-runtime.ts'
+        };
+        packageJson.dependencies = {
+            ...external_policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.bffEffectDependencies,
+            '@modern-js/plugin-bff': packageSource ? (0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)('@modern-js/plugin-bff', packageSource) : external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION
+        };
+    }
     if ('shared-design-tokens' === id) packageJson.exports = {
         ...packageJson.exports,
         './tokens.css': './src/tokens.css'

package/dist/cjs/ultramodern-workspace/policy.cjs

@@ -290,6 +290,7 @@ const ULTRAMODERN_PACKAGE_PINS = {
     rootDevDependencies: {
         '@effect/tsgo': external_versions_cjs_namespaceObject.EFFECT_TSGO_VERSION,
         "@typescript/native": `npm:typescript@${external_versions_cjs_namespaceObject.TYPESCRIPT_VERSION}`,
+        '@types/node': external_versions_cjs_namespaceObject.TYPES_NODE_VERSION,
         'cross-env': external_versions_cjs_namespaceObject.CROSS_ENV_VERSION,
         lefthook: external_versions_cjs_namespaceObject.LEFTHOOK_VERSION,
         miniflare: external_versions_cjs_namespaceObject.MINIFLARE_VERSION,

package/dist/cjs/ultramodern-workspace/tsconfigs.cjs

@@ -53,6 +53,9 @@ function createTsConfigBase() {
     return {
         compilerOptions: {
             target: 'ESNext',
+            types: [
+                'node'
+            ],
             lib: [
                 'ESNext',
                 'DOM',

package/dist/cjs/ultramodern-workspace/workspace-script-plan.cjs

@@ -175,7 +175,7 @@ function createWorkspaceRootScriptPlan(remotes = [], options = {}) {
         migrateStrictEffect: rootToolingWrapperCommand('migrateStrictEffect'),
         zeropsMaterialize: "node ./scripts/materialize-zerops-runtime.mjs",
         contractCheck: rootToolingWrapperCommand('validate'),
-        typecheck: options.typecheck ?? `${rootToolingWrapperCommand('typecheck')} --project tsconfig.json`,
+        typecheck: options.typecheck ?? `${rootToolingWrapperCommand('typecheck')} --build tsconfig.json`,
         check: `pnpm format:check && pnpm lint && pnpm typecheck && pnpm skills:check && pnpm i18n:boundaries && pnpm api:check && pnpm contract:check && pnpm performance:readiness${bridgeCheck}`
     };
 }

package/dist/cjs/ultramodern-workspace/workspace-scripts.cjs

@@ -176,6 +176,7 @@ function writeGeneratedWorkspaceScripts(targetDir, scope, enableTailwind, remote
     const hasBackendSurface = remotes.some(external_descriptors_cjs_namespaceObject.appHasApi);
     writeWorkspaceOwnedMtsScript(targetDir, 'check-ultramodern-i18n-boundaries', createWorkspaceI18nBoundaryValidationScript());
     writeWorkspaceOwnedMtsScript(targetDir, 'check-ultramodern-api-boundaries', createWorkspaceApiBoundaryValidationScript());
+    writeWorkspaceOwnedMtsScript(targetDir, 'microvertical-api-baseline-boundary', (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/microvertical-api-baseline-boundary.mts"));
     if (!shellOnly) {
         (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/materialize-zerops-runtime.mjs", createZeropsRuntimeMaterializationScript());
         writeWorkspaceOwnedMtsScript(targetDir, 'proof-workerd-ssr', createWorkerdSsrProofScript());
@@ -203,6 +204,10 @@ function migratedWorkspaceScriptArtifacts(options) {
             content: createWorkspaceI18nBoundaryValidationScript(),
             legacyPath: "scripts/check-ultramodern-i18n-boundaries.mjs"
         },
+        {
+            relativePath: "scripts/microvertical-api-baseline-boundary.mts",
+            content: (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/microvertical-api-baseline-boundary.mts")
+        },
         {
             relativePath: "scripts/check-ultramodern-api-boundaries.mts",
             content: createWorkspaceApiBoundaryValidationScript(),

package/dist/cjs/ultramodern-workspace/workspace-validation-contract.cjs

@@ -55,7 +55,8 @@ const modernPackageCohort = [
     '@modern-js/plugin-bff',
     '@modern-js/plugin-i18n',
     '@modern-js/plugin-tanstack',
-    '@modern-js/runtime'
+    '@modern-js/runtime',
+    '@modern-js/runtime-extensions'
 ];
 const asJsonRecord = (value)=>value;
 function projectModuleFederationMetadata(value) {

package/dist/cjs/ultramodern-workspace/write-app.cjs

@@ -78,7 +78,7 @@ function writeAppConfigFiles({ targetDir, scope, resolvedApp, packageSource, ena
     (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/tsconfig.json`, (0, external_package_json_cjs_namespaceObject.createAppTsConfig)(resolvedApp, remotes));
     (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/tsconfig.mf-types.json`, (0, external_package_json_cjs_namespaceObject.createAppMfTypesTsConfig)(resolvedApp));
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, (0, external_app_files_cjs_namespaceObject.createAppEnvDts)(resolvedApp, remotes, scope));
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, (0, external_module_federation_cjs_namespaceObject.createUltramodernBuildReexportModule)());
+    if ('api-only' !== resolvedApp.surfaceProfile) (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, (0, external_module_federation_cjs_namespaceObject.createUltramodernBuildReexportModule)(resolvedApp));
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.ts`, (0, external_module_federation_cjs_namespaceObject.createUltramodernBuildModule)(scope, resolvedApp));
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.json`, (0, external_module_federation_cjs_namespaceObject.createUltramodernBuildArtifactJson)(scope, resolvedApp));
     if (emitsUi) {
@@ -122,12 +122,18 @@ function writeAppApiAndRemoteExposeFiles({ targetDir, scope, resolvedApp, emitsU
     if ((0, external_descriptors_cjs_namespaceObject.appHasApi)(resolvedApp)) {
         const rpcProtocol = 'rpc' === (0, external_descriptors_cjs_namespaceObject.resolveApiProtocol)(resolvedApp);
         if (rpcProtocol) (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/rpc.ts`, (0, rpc_cjs_namespaceObject.createRpcContractFile)(resolvedApp));
-        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/api.ts`, (0, external_api_cjs_namespaceObject.createSharedApi)(resolvedApp));
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/index.ts`, (0, external_api_cjs_namespaceObject.createApiServiceEntry)(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts'));
+        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/api.ts`, (0, external_api_cjs_namespaceObject.createSharedApi)(resolvedApp, {
+            scope
+        }));
+        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/index.ts`, (0, external_api_cjs_namespaceObject.createApiServiceEntry)(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts', {
+            scope
+        }));
         (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/backend-federation.ts`, (0, external_backend_federation_cjs_namespaceObject.createBackendFederationContractFile)(resolvedApp));
         (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/effect-api.ts`, (0, external_api_cjs_namespaceObject.createBackendEffectApiExpose)(scope, resolvedApp));
         if (rpcProtocol) (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-rpc-client.ts`, (0, rpc_cjs_namespaceObject.createRpcClientFile)(resolvedApp));
-        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, (0, external_api_cjs_namespaceObject.createApiClient)(resolvedApp, '../../shared/api'));
+        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, (0, external_api_cjs_namespaceObject.createApiClient)(resolvedApp, '../../shared/api', {
+            scope
+        }));
     }
     if ('vertical' === resolvedApp.kind && emitsUi) {
         writeAppFile('src/federation-entry.tsx', (0, external_demo_components_cjs_namespaceObject.createRemoteEntry)(resolvedApp));

package/dist/cjs/ultramodern-workspace/write-workspace.cjs

@@ -63,12 +63,14 @@ const external_zerops_cjs_namespaceObject = require("./zerops.cjs");
 function hasExplicitInstallRequest(options) {
     return void 0 !== options.packageSource && 'workspace' !== options.packageSource.strategy;
 }
-function writeSharedPackages(targetDir, scope) {
+function writeSharedPackages(targetDir, scope, packageSource) {
     for (const sharedPackage of external_descriptors_cjs_namespaceObject.sharedPackages){
-        (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackage)(scope, sharedPackage.id, sharedPackage.description));
+        (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackage)(scope, sharedPackage.id, sharedPackage.description, packageSource));
         (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/tsconfig.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackageTsConfig)(sharedPackage.directory));
     }
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/index.ts', (0, external_package_json_cjs_namespaceObject.createSharedContractsIndex)());
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/microvertical-api-baseline.ts', (0, external_fs_io_cjs_namespaceObject.readFileTemplate)('packages/microvertical-api-baseline.ts'));
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/effect-bff-runtime.ts', (0, external_fs_io_cjs_namespaceObject.readFileTemplate)('packages/effect-bff-runtime.ts'));
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-design-tokens/src/index.ts', `export const sharedDesignTokens = {
   color: {
     accent: '#2f8f68',
@@ -188,7 +190,7 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
     (0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, external_descriptors_cjs_namespaceObject.shellApp, packageSource, enableTailwind, initialVerticals, bridge);
     for (const remote of initialVerticals)(0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
-    writeSharedPackages(options.targetDir, scope);
+    writeSharedPackages(options.targetDir, scope, packageSource);
     (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.targetDir, scope, enableTailwind, initialVerticals, releaseCohort);
     const preliminaryAfterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
     const preliminaryDiff = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, preliminaryAfterFiles);

package/dist/esm/ultramodern-package-source.js

@@ -24,7 +24,8 @@ const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES = [
     '@modern-js/plugin-bff',
     '@modern-js/plugin-i18n',
     '@modern-js/plugin-tanstack',
-    '@modern-js/runtime'
+    '@modern-js/runtime',
+    '@modern-js/runtime-extensions'
 ];
 function modernPackageVersion(packageSource) {
     return 'install' === packageSource.strategy ? packageSource.modernPackageVersion : WORKSPACE_PACKAGE_VERSION;

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

@@ -1,5 +1,6 @@
 import node_fs from "node:fs";
 import node_path from "node:path";
+import { appEmitsBrowserUi } from "../../../ultramodern-workspace/descriptors.js";
 import { createUltramodernBuildArtifactJson, createUltramodernBuildModule, createUltramodernBuildReexportModule } from "../../../ultramodern-workspace/module-federation.js";
 import { allWorkspaceAppsFromToolingConfig } from "../../config.js";
 const legacyApiMarkerPattern = /export const ultramodernApiMarker\s*=\s*\{[\s\S]*?\}\s+as const;\n?/u;
@@ -39,8 +40,10 @@ function updateGeneratedBuildIdentityModules(io, config) {
     for (const app of allWorkspaceAppsFromToolingConfig(config)){
         const sharedApiPath = node_path.join(io.workspaceRoot, app.directory, 'shared/api.ts');
         if (app.api && node_fs.existsSync(sharedApiPath)) io.write(sharedApiPath, rewriteApiMarkerIdentitySchema(rewriteLegacyApiMarkerBinding(node_fs.readFileSync(sharedApiPath, 'utf-8'))));
-        io.writeGenerated(node_path.join(io.workspaceRoot, app.directory, 'src/ultramodern-build.ts'), createUltramodernBuildReexportModule());
-        io.writeGenerated(node_path.join(io.workspaceRoot, app.directory, 'shared/ultramodern-build.ts'), createUltramodernBuildModule(config.workspace.packageScope, app));
+        const reexportPath = node_path.join(io.workspaceRoot, app.directory, 'src/ultramodern-build.ts');
+        const includeUiMarker = appEmitsBrowserUi(app) && ('shell' !== app.kind || node_fs.existsSync(reexportPath));
+        if (node_fs.existsSync(reexportPath)) io.writeGenerated(reexportPath, createUltramodernBuildReexportModule(app, includeUiMarker));
+        io.writeGenerated(node_path.join(io.workspaceRoot, app.directory, 'shared/ultramodern-build.ts'), createUltramodernBuildModule(config.workspace.packageScope, app, includeUiMarker));
         io.write(node_path.join(io.workspaceRoot, app.directory, 'shared/ultramodern-build.json'), createUltramodernBuildArtifactJson(config.workspace.packageScope, app));
     }
 }

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

@@ -117,6 +117,7 @@ function updateGeneratedModernConfigs(io, config) {
             generatedModuleFederationConfig,
             createGeneratedModuleFederationConfig(!enableBridgeRouter)
         ];
+        const ownsUiComposition = !node_fs.existsSync(moduleFederationConfigPath) || recognizedModuleFederationConfigs.includes(node_fs.readFileSync(moduleFederationConfigPath, 'utf8'));
         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');
@@ -127,6 +128,10 @@ function updateGeneratedModernConfigs(io, config) {
         else removeOwnedTypeScriptConfig(io, backendFederationConfigPath, [
             generatedBackendFederationConfig
         ]);
+        if (!ownsUiComposition) {
+            io.log(`${app.directory} preserves its consumer-owned federation composition instead of regenerating routes from unproven metadata.`);
+            continue;
+        }
         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');

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

@@ -70,6 +70,7 @@ function mergeTypeScriptConfig(generated, existing) {
         ...existingCompilerOptions,
         ...generatedCompilerOptions
     };
+    if (Array.isArray(generatedCompilerOptions.types)) compilerOptions.types = mergeUniqueJsonValues(generatedCompilerOptions.types, existingCompilerOptions.types);
     if (Array.isArray(generatedCompilerOptions.plugins) || Array.isArray(existingCompilerOptions.plugins)) compilerOptions.plugins = mergeTypeScriptPlugins(generatedCompilerOptions.plugins, existingCompilerOptions.plugins);
     const merged = {
         ...existingConfig,

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

@@ -24,13 +24,20 @@ function updateDeclaredDependencies(packageJson, pins) {
     }
     return changed;
 }
-function updateModernDependencies(packageJson, packageSource) {
+function updateModernDependencies(packageJson, packageSource, releaseCohort) {
     let changed = false;
     for (const section of [
         'dependencies',
         'devDependencies'
     ]){
         const dependencies = packageJson[section];
+        if (dependencies && Object.hasOwn(dependencies, '@modern-js/runtime')) {
+            const runtimeExtensions = modernPackageSpecifier('@modern-js/runtime-extensions', packageSource);
+            if (dependencies['@modern-js/runtime-extensions'] !== runtimeExtensions) {
+                dependencies['@modern-js/runtime-extensions'] = runtimeExtensions;
+                changed = true;
+            }
+        }
         if (dependencies && Object.hasOwn(dependencies, '@modern-js/create')) {
             dependencies[ULTRAMODERN_CREATE_PACKAGE] = modernPackageSpecifier(ULTRAMODERN_CREATE_PACKAGE, packageSource);
             delete dependencies['@modern-js/create'];
@@ -38,11 +45,23 @@ function updateModernDependencies(packageJson, packageSource) {
         }
     }
     return updateDeclaredDependencies(packageJson, new Map([
-        ...modernPackageNames
-    ].map((packageName)=>[
-            packageName,
-            modernPackageSpecifier(packageName, packageSource)
-        ]))) || changed;
+        ...[
+            ...modernPackageNames
+        ].map((packageName)=>[
+                packageName,
+                modernPackageSpecifier(packageName, packageSource)
+            ]),
+        ...(releaseCohort?.packages ?? []).flatMap((item)=>[
+                [
+                    item.sourceName,
+                    modernPackageSpecifier(item.sourceName, packageSource)
+                ],
+                [
+                    item.targetName,
+                    item.version
+                ]
+            ])
+    ])) || changed;
 }
 const generatedToolingDependencyPins = new Map(Object.entries({
     ...ULTRAMODERN_PACKAGE_PINS.appDependencies,
@@ -135,6 +154,8 @@ function mergeGeneratedScript(consumer, framework, canRetireLegacyOxfmtCliExclus
     const frameworkSegmentSet = new Set(frameworkSegments);
     const canonicalFrameworkSegment = (segment)=>{
         if (frameworkSegmentSet.has(segment)) return segment;
+        const referenceBuild = segment.replace('--project tsconfig.json', '--build tsconfig.json');
+        if (frameworkSegmentSet.has(referenceBuild)) return referenceBuild;
         const portableEnvironmentSegment = `cross-env ${segment}`;
         if (frameworkSegmentSet.has(portableEnvironmentSegment)) return portableEnvironmentSegment;
         const portableOxfmtSegment = segment.replace(/ '!repos\/\*\*'$/u, '');
@@ -187,12 +208,12 @@ function mergeGeneratedScript(consumer, framework, canRetireLegacyOxfmtCliExclus
         preservedConsumerSegments: consumerExtras.length > 0
     };
 }
-function rewriteMigratedScriptReferences(scripts) {
+function rewriteMigratedScriptReferences(scripts, preservedArtifacts) {
     let changed = false;
     const pattern = new RegExp(`(scripts/(?:${migratedWorkspaceScriptBasenames.join('|')}))\\.mjs`, 'gu');
     for (const [name, value] of Object.entries(scripts)){
         if ('string' != typeof value) continue;
-        const next = value.replace(pattern, '$1.mts');
+        const next = value.replace(pattern, (original, basename)=>preservedArtifacts?.has(`${basename}.mjs`) ? original : `${basename}.mts`);
         if (next !== value) {
             scripts[name] = next;
             changed = true;
@@ -207,7 +228,7 @@ function updateGeneratedPackageScripts(packageJson, options = {}) {
     const apps = options.apps ?? [];
     const app = apps.find((candidate)=>`${candidate.directory}/package.json` === options.relativePackageFile);
     const isRootPackage = 'package.json' === options.relativePackageFile;
-    if (rewriteMigratedScriptReferences(scripts)) changed = true;
+    if (rewriteMigratedScriptReferences(scripts, options.preservedArtifacts)) changed = true;
     if (isRootPackage) {
         for (const [name, [legacy, portable]] of legacyPortableRootScripts)if (true === options.canRetireLegacyOxfmtCliExclusion && scripts[name] === legacy) {
             scripts[name] = portable;

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

@@ -199,11 +199,7 @@ function reconcilePatchedDependencies(document, includeDrizzleOrmPatch) {
             patchKey(patch),
             patch
         ]));
-    const ownedPackageNames = new Set([
-        ...policy.required,
-        ...policy.conditional,
-        ...policy.stale
-    ].map((patch)=>patch.packageName));
+    const ownedPackageNames = new Set(expectedPatches.map((patch)=>patch.packageName));
     const patchedDependencies = ensureMap(document, 'patchedDependencies');
     for (const [selector, patchPath] of Object.entries(patchedDependencies)){
         const stalePatch = stale.get(selector);
@@ -212,15 +208,13 @@ function reconcilePatchedDependencies(document, includeDrizzleOrmPatch) {
             delete patchedDependencies[selector];
             continue;
         }
-        const parts = packageVersionParts(selector);
-        if (parts && ownedPackageNames.has(parts.packageName) && !expected.has(selector)) {
-            const conditionalPatch = policy.conditional.find((patch)=>patchKey(patch) === selector);
-            if (conditionalPatch && !includeDrizzleOrmPatch && patchPath === conditionalPatch.path) {
-                delete patchedDependencies[selector];
-                continue;
-            }
-            throw new Error(`Framework-owned patch selector ${selector} has unknown provenance.`);
+        const conditionalPatch = policy.conditional.find((patch)=>patchKey(patch) === selector);
+        if (conditionalPatch && !includeDrizzleOrmPatch && patchPath === conditionalPatch.path) {
+            delete patchedDependencies[selector];
+            continue;
         }
+        const parts = packageVersionParts(selector);
+        if (parts && ownedPackageNames.has(parts.packageName) && !expected.has(selector)) throw new Error(`Framework-owned patch selector ${selector} has unknown provenance.`);
     }
     for (const [selector, patchPath] of expected)patchedDependencies[selector] = patchPath;
 }
@@ -511,6 +505,8 @@ async function validateGeneratedPnpmLockReleaseAgePolicy(workspaceRoot, packageS
     const firstPartyTargetNames = new Set(releaseCohort?.packages.map((item)=>item.targetName) ?? []);
     const { document: lockfile } = parsePnpmWorkspaceYaml(node_fs.readFileSync(lockfilePath, 'utf-8'), lockfilePath);
     const closure = discoverReachablePnpmLockReleaseAgeClosure(lockfile);
+    const firstPartySourceNames = new Set(releaseCohort?.packages.map((item)=>item.sourceName) ?? []);
+    for (const tarball of closure.tarballs)if (firstPartyTargetNames.has(tarball.packageName) || firstPartySourceNames.has(tarball.packageName)) throw new Error(`First-party lock candidate ${tarball.packageName} must resolve through the authenticated release cohort, not a tarball URL.`);
     if (closure.unresolved.length > 0) {
         const unresolved = closure.unresolved.slice(0, 20).map((candidate)=>{
             const packageName = candidate.package ?? 'unknown package';

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

@@ -9,6 +9,11 @@ const integrityPattern = /^sha512-[A-Za-z0-9+/]+={0,2}$/u;
 function isExactSemver(version) {
     return semver.valid(version) === version;
 }
+function isHttpsTarballLocator(value) {
+    if (!value.startsWith('https://') || /[\s()]/u.test(value) || !URL.canParse(value)) return false;
+    const url = new URL(value);
+    return url.href === value && '' === url.username && '' === url.password && '' === url.hash;
+}
 function isYamlRecord(value) {
     return Boolean(value) && 'object' == typeof value && !Array.isArray(value);
 }
@@ -62,7 +67,7 @@ function splitPeerContext(locator) {
     for (const segment of segments){
         if (/^patch_hash=[a-f0-9]{32,128}$/u.test(segment) || /^[a-f0-9]{32,128}$/u.test(segment)) continue;
         const peer = parsePackageKey(segment);
-        if (!peer) return {
+        if (!peer || isHttpsTarballLocator(peer.version)) return {
             unresolved: locator
         };
         peers.push(peer);
@@ -74,11 +79,12 @@ function splitPeerContext(locator) {
 }
 function parsePackageLocator(rawLocator) {
     const locator = rawLocator.replace(/^\//u, '');
-    const separator = locator.lastIndexOf('@');
+    const tarballSeparator = locator.indexOf('@https://');
+    const separator = tarballSeparator > 0 ? tarballSeparator : locator.lastIndexOf('@');
     if (separator <= 0) return;
     const packageName = locator.slice(0, separator);
     const version = locator.slice(separator + 1);
-    if (!exactPackageNamePattern.test(packageName) || !isExactSemver(version)) return;
+    if (!exactPackageNamePattern.test(packageName) || !isExactSemver(version) && !isHttpsTarballLocator(version)) return;
     return {
         packageName,
         version,
@@ -122,6 +128,11 @@ function dependencyIdentity(dependencyName, rawValue) {
     const peerContext = splitPeerContext(value.startsWith('npm:') ? value.slice(4) : value);
     if ('unresolved' in peerContext) return peerContext;
     const { base, peers } = peerContext;
+    if (isHttpsTarballLocator(base) && exactPackageNamePattern.test(dependencyName)) return {
+        packageName: dependencyName,
+        version: base,
+        peers
+    };
     const full = parsePackageLocator(base);
     if (full) return {
         ...full,
@@ -264,13 +275,11 @@ function discoverReachablePnpmLockReleaseAgeClosure(lockfile) {
         const currentPath = shortestIdentityPaths.get(key);
         if (!currentPath || nodePath.length < currentPath.length) shortestIdentityPaths.set(key, nodePath);
     }
+    const tarballs = [];
     const candidates = [
         ...shortestIdentityPaths.entries()
     ].map(([key, path])=>{
-        const [packageName, version] = [
-            key.slice(0, key.lastIndexOf('@')),
-            key.slice(key.lastIndexOf('@') + 1)
-        ];
+        const { packageName, version } = nodes.get(nodeIdsByIdentity.get(key)[0]).identity;
         const packageRecordsForIdentity = packageRecordsByIdentity.get(key);
         if (!packageRecordsForIdentity?.length) return void recordUnresolved({
             packageName,
@@ -278,12 +287,25 @@ function discoverReachablePnpmLockReleaseAgeClosure(lockfile) {
             peers: []
         }, path, 'missing exact SHA-512 lock integrity');
         let integrity;
+        let tarballVersion;
         for (const [packageKey, packageRecord] of packageRecordsForIdentity){
             const resolution = requiredYamlRecord(requiredYamlRecord(packageRecord, `pnpm lockfile package ${packageKey}`).resolution, `pnpm lockfile package ${packageKey} resolution`);
             if ('string' != typeof resolution.integrity || !integrityPattern.test(resolution.integrity)) throw new Error(`pnpm lockfile package ${packageKey} has uncertain registry integrity.`);
             if (integrity && integrity !== resolution.integrity) throw new Error(`pnpm lockfile has conflicting registry integrity for ${key}.`);
             integrity = resolution.integrity;
+            if (isHttpsTarballLocator(version)) {
+                const metadata = requiredYamlRecord(packageRecord, `pnpm lockfile package ${packageKey}`);
+                if (resolution.tarball !== version || 'string' != typeof metadata.version || !isExactSemver(metadata.version) || void 0 !== tarballVersion && tarballVersion !== metadata.version) throw new Error(`pnpm lockfile package ${packageKey} has uncertain tarball identity.`);
+                tarballVersion = metadata.version;
+            }
         }
+        if (void 0 !== tarballVersion) return void tarballs.push({
+            packageName,
+            version: tarballVersion,
+            url: version,
+            integrity: integrity,
+            path
+        });
         return {
             packageName,
             version,
@@ -298,6 +320,7 @@ function discoverReachablePnpmLockReleaseAgeClosure(lockfile) {
     unresolved.sort((left, right)=>JSON.stringify(left).localeCompare(JSON.stringify(right)));
     return {
         candidates,
+        tarballs,
         unresolved
     };
 }

package/dist/esm/ultramodern-tooling/commands/migrate-strict-effect/shared-api-infrastructure.js

@@ -0,0 +1,50 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { readFileTemplate } from "../../../ultramodern-workspace/fs-io.js";
+import { createSharedPackage, createSharedPackageTsConfig } from "../../../ultramodern-workspace/package-json.js";
+import { readJsonFile, writeJsonFile } from "./io.js";
+const directory = 'packages/shared-contracts';
+function record(value, label) {
+    if (null === value || 'object' != typeof value || Array.isArray(value)) throw new Error(`${label} must be an object; resolve it before migration.`);
+    return value;
+}
+function ensureSharedApiInfrastructure(io, scope, packageSource) {
+    for (const relativePath of [
+        'packages',
+        directory,
+        `${directory}/package.json`,
+        `${directory}/src`,
+        `${directory}/src/index.ts`
+    ])if (node_fs.lstatSync(node_path.join(io.workspaceRoot, relativePath), {
+        throwIfNoEntry: false
+    })?.isSymbolicLink()) throw new Error(`Shared API migration cannot write through a symbolic link: ${relativePath}`);
+    const manifestPath = node_path.join(io.workspaceRoot, directory, 'package.json');
+    const defaults = createSharedPackage(scope, 'shared-contracts', 'Shared workspace contracts', packageSource);
+    const manifest = node_fs.existsSync(manifestPath) ? record(readJsonFile(manifestPath), `${directory}/package.json`) : defaults;
+    const exports = void 0 === manifest.exports ? {} : 'string' == typeof manifest.exports ? {
+        '.': manifest.exports
+    } : record(manifest.exports, `${directory}/package.json exports`);
+    if (Object.keys(exports).some((key)=>!key.startsWith('.')) || void 0 !== exports['.'] && './src/index.ts' !== exports['.']) throw new Error(`${directory}/package.json exports must expose ./src/index.ts at "." before adding shared API infrastructure; consumer exports were not overwritten.`);
+    for (const [subpath, target] of Object.entries(record(defaults.exports, 'Shared contract exports')))if (void 0 !== exports[subpath] && exports[subpath] !== target) throw new Error(`${directory}/package.json ${subpath} must expose ${String(target)}; consumer exports were not overwritten.`);
+    const dependencies = record(manifest.dependencies ?? {}, `${directory}/package.json dependencies`);
+    manifest.exports = {
+        ...record(defaults.exports, 'Shared contract exports'),
+        ...exports
+    };
+    manifest.dependencies = {
+        ...record(defaults.dependencies, 'Shared contract dependencies'),
+        ...dependencies
+    };
+    const writeMissing = (relativePath, content)=>{
+        const filePath = node_path.join(io.workspaceRoot, directory, relativePath);
+        if (void 0 === node_fs.lstatSync(filePath, {
+            throwIfNoEntry: false
+        })) io.writeGenerated(filePath, content);
+    };
+    writeMissing('src/effect-bff-runtime.ts', readFileTemplate('packages/effect-bff-runtime.ts'));
+    writeMissing('src/microvertical-api-baseline.ts', readFileTemplate('packages/microvertical-api-baseline.ts'));
+    writeMissing('tsconfig.json', `${JSON.stringify(createSharedPackageTsConfig(directory), null, 2)}\n`);
+    writeMissing('src/index.ts', readFileTemplate('packages/shared-contracts-index.ts'));
+    writeJsonFile(io, manifestPath, manifest);
+}
+export { ensureSharedApiInfrastructure };