@bleedingdev/modern-js-surface-resolution 3.9.0-ultramodern.9 → 3.9.3-ultramodern.10

package/dist/cjs/surface-resolution/env-static-provider.js

@@ -30,7 +30,8 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     DEFAULT_LOCAL_ENVIRONMENTS: ()=>DEFAULT_LOCAL_ENVIRONMENTS,
     ENV_STATIC_PROVIDER_NAME: ()=>ENV_STATIC_PROVIDER_NAME,
-    createEnvStaticSurfaceResolutionProvider: ()=>createEnvStaticSurfaceResolutionProvider
+    createEnvStaticSurfaceResolutionProvider: ()=>createEnvStaticSurfaceResolutionProvider,
+    resolveBrowserManifestAddress: ()=>resolveBrowserManifestAddress
 });
 const external_surface_ref_js_namespaceObject = require("./surface-ref.js");
 const external_validation_js_namespaceObject = require("./validation.js");
@@ -54,12 +55,11 @@ function createEnvContext(env, allowLocalFallback) {
         env,
         allowLocalFallback,
         cloudflareDeployEnabled: 'cloudflare' === env.MODERNJS_DEPLOY,
-        workersDevSubdomain: envValue(env, 'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN'),
-        requireCloudflarePublicUrls: 'true' === env.ULTRAMODERN_CLOUDFLARE_REQUIRE_PUBLIC_URLS
+        workersDevSubdomain: envValue(env, 'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN')
     };
 }
 function resolveBaseUrl(context, unit) {
-    const publicUrlEnv = `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`;
+    const { publicUrlEnv } = unit;
     const configuredPublicUrl = envValue(context.env, publicUrlEnv);
     if (void 0 !== configuredPublicUrl) return {
         ok: true,
@@ -69,13 +69,6 @@ function resolveBaseUrl(context, unit) {
         ok: true,
         baseUrl: `https://${unit.workerName}.${context.workersDevSubdomain}.workers.dev`
     };
-    if (context.cloudflareDeployEnabled && context.requireCloudflarePublicUrls) return {
-        ok: false,
-        reason: `Cloudflare deploy requires ${publicUrlEnv} (or a configured manifest env / ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN with a worker name)`,
-        details: {
-            publicUrlEnv
-        }
-    };
     if (void 0 !== unit.port && context.allowLocalFallback) return {
         ok: true,
         baseUrl: `http://localhost:${unit.port}`
@@ -95,15 +88,15 @@ function resolveBaseUrl(context, unit) {
         }
     };
 }
-function resolveBrowserMfManifest(context, unit) {
-    const manifestEnv = `VERTICAL_${unit.envSegment}_MF_MANIFEST`;
+function resolveBrowserManifestAddress(env, unit, environment, localEnvironments = DEFAULT_LOCAL_ENVIRONMENTS) {
+    return resolveBrowserManifestAddressInContext(createEnvContext(env, localEnvironments.includes(environment)), unit);
+}
+function resolveBrowserManifestAddressInContext(context, unit) {
+    const { manifestEnv } = unit;
     const configuredManifest = envValue(context.env, manifestEnv);
     if (void 0 !== configuredManifest) return {
         ok: true,
-        location: {
-            platform: 'browser-mf-manifest',
-            manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName)
-        }
+        manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName)
     };
     const base = resolveBaseUrl(context, unit);
     if (!base.ok) return {
@@ -116,10 +109,7 @@ function resolveBrowserMfManifest(context, unit) {
     };
     return {
         ok: true,
-        location: {
-            platform: 'browser-mf-manifest',
-            manifestUrl: `${base.baseUrl}/mf-manifest.json`
-        }
+        manifestUrl: `${base.baseUrl}/mf-manifest.json`
     };
 }
 function resolveNodeMfManifest(context, unit) {
@@ -155,7 +145,10 @@ function resolveNodeMfManifest(context, unit) {
     };
 }
 function resolveHttpApi(context, unit, config) {
-    const base = resolveBaseUrl(context, unit);
+    const base = resolveBaseUrl(context, {
+        ...unit,
+        publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`
+    });
     if (!base.ok) return {
         ok: false,
         reason: `http-api unavailable (${base.reason})`,
@@ -188,7 +181,20 @@ function resolveCloudflareServiceBinding(config) {
 }
 function resolveSurfaceLocations(context, unit, surface) {
     const outcomes = [];
-    if (surface.platforms.browserMfManifest) outcomes.push(resolveBrowserMfManifest(context, unit));
+    if (surface.platforms.browserMfManifest) {
+        const address = resolveBrowserManifestAddressInContext(context, {
+            ...unit,
+            manifestEnv: `VERTICAL_${unit.envSegment}_MF_MANIFEST`,
+            publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`
+        });
+        outcomes.push(address.ok ? {
+            ok: true,
+            location: {
+                platform: 'browser-mf-manifest',
+                manifestUrl: address.manifestUrl
+            }
+        } : address);
+    }
     if (surface.platforms.nodeMfManifest) outcomes.push(resolveNodeMfManifest(context, unit));
     if (void 0 !== surface.platforms.httpApi) outcomes.push(resolveHttpApi(context, unit, surface.platforms.httpApi));
     if (void 0 !== surface.platforms.cloudflareServiceBinding) outcomes.push(resolveCloudflareServiceBinding(surface.platforms.cloudflareServiceBinding));
@@ -308,10 +314,12 @@ function createEnvStaticSurfaceResolutionProvider(options) {
 exports.DEFAULT_LOCAL_ENVIRONMENTS = __webpack_exports__.DEFAULT_LOCAL_ENVIRONMENTS;
 exports.ENV_STATIC_PROVIDER_NAME = __webpack_exports__.ENV_STATIC_PROVIDER_NAME;
 exports.createEnvStaticSurfaceResolutionProvider = __webpack_exports__.createEnvStaticSurfaceResolutionProvider;
+exports.resolveBrowserManifestAddress = __webpack_exports__.resolveBrowserManifestAddress;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "DEFAULT_LOCAL_ENVIRONMENTS",
     "ENV_STATIC_PROVIDER_NAME",
-    "createEnvStaticSurfaceResolutionProvider"
+    "createEnvStaticSurfaceResolutionProvider",
+    "resolveBrowserManifestAddress"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/cjs/surface-resolution/index.js

@@ -35,6 +35,7 @@ __webpack_require__.d(__webpack_exports__, {
     formatSurfaceRef: ()=>external_surface_ref_js_namespaceObject.formatSurfaceRef,
     matchDeliveryUnitIdentity: ()=>external_validation_js_namespaceObject.matchDeliveryUnitIdentity,
     parseSurfaceRef: ()=>external_surface_ref_js_namespaceObject.parseSurfaceRef,
+    resolveBrowserManifestAddress: ()=>external_env_static_provider_js_namespaceObject.resolveBrowserManifestAddress,
     selectResolvedSurface: ()=>external_validation_js_namespaceObject.selectResolvedSurface,
     validateResolvedDeliveryUnit: ()=>external_validation_js_namespaceObject.validateResolvedDeliveryUnit,
     validateSurfaceRef: ()=>external_surface_ref_js_namespaceObject.validateSurfaceRef
@@ -49,6 +50,7 @@ exports.createEnvStaticSurfaceResolutionProvider = __webpack_exports__.createEnv
 exports.formatSurfaceRef = __webpack_exports__.formatSurfaceRef;
 exports.matchDeliveryUnitIdentity = __webpack_exports__.matchDeliveryUnitIdentity;
 exports.parseSurfaceRef = __webpack_exports__.parseSurfaceRef;
+exports.resolveBrowserManifestAddress = __webpack_exports__.resolveBrowserManifestAddress;
 exports.selectResolvedSurface = __webpack_exports__.selectResolvedSurface;
 exports.validateResolvedDeliveryUnit = __webpack_exports__.validateResolvedDeliveryUnit;
 exports.validateSurfaceRef = __webpack_exports__.validateSurfaceRef;
@@ -60,6 +62,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "formatSurfaceRef",
     "matchDeliveryUnitIdentity",
     "parseSurfaceRef",
+    "resolveBrowserManifestAddress",
     "selectResolvedSurface",
     "validateResolvedDeliveryUnit",
     "validateSurfaceRef"

package/dist/esm/surface-resolution/env-static-provider.mjs

@@ -20,12 +20,11 @@ function createEnvContext(env, allowLocalFallback) {
         env,
         allowLocalFallback,
         cloudflareDeployEnabled: 'cloudflare' === env.MODERNJS_DEPLOY,
-        workersDevSubdomain: envValue(env, 'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN'),
-        requireCloudflarePublicUrls: 'true' === env.ULTRAMODERN_CLOUDFLARE_REQUIRE_PUBLIC_URLS
+        workersDevSubdomain: envValue(env, 'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN')
     };
 }
 function resolveBaseUrl(context, unit) {
-    const publicUrlEnv = `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`;
+    const { publicUrlEnv } = unit;
     const configuredPublicUrl = envValue(context.env, publicUrlEnv);
     if (void 0 !== configuredPublicUrl) return {
         ok: true,
@@ -35,13 +34,6 @@ function resolveBaseUrl(context, unit) {
         ok: true,
         baseUrl: `https://${unit.workerName}.${context.workersDevSubdomain}.workers.dev`
     };
-    if (context.cloudflareDeployEnabled && context.requireCloudflarePublicUrls) return {
-        ok: false,
-        reason: `Cloudflare deploy requires ${publicUrlEnv} (or a configured manifest env / ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN with a worker name)`,
-        details: {
-            publicUrlEnv
-        }
-    };
     if (void 0 !== unit.port && context.allowLocalFallback) return {
         ok: true,
         baseUrl: `http://localhost:${unit.port}`
@@ -61,15 +53,15 @@ function resolveBaseUrl(context, unit) {
         }
     };
 }
-function resolveBrowserMfManifest(context, unit) {
-    const manifestEnv = `VERTICAL_${unit.envSegment}_MF_MANIFEST`;
+function resolveBrowserManifestAddress(env, unit, environment, localEnvironments = DEFAULT_LOCAL_ENVIRONMENTS) {
+    return resolveBrowserManifestAddressInContext(createEnvContext(env, localEnvironments.includes(environment)), unit);
+}
+function resolveBrowserManifestAddressInContext(context, unit) {
+    const { manifestEnv } = unit;
     const configuredManifest = envValue(context.env, manifestEnv);
     if (void 0 !== configuredManifest) return {
         ok: true,
-        location: {
-            platform: 'browser-mf-manifest',
-            manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName)
-        }
+        manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName)
     };
     const base = resolveBaseUrl(context, unit);
     if (!base.ok) return {
@@ -82,10 +74,7 @@ function resolveBrowserMfManifest(context, unit) {
     };
     return {
         ok: true,
-        location: {
-            platform: 'browser-mf-manifest',
-            manifestUrl: `${base.baseUrl}/mf-manifest.json`
-        }
+        manifestUrl: `${base.baseUrl}/mf-manifest.json`
     };
 }
 function resolveNodeMfManifest(context, unit) {
@@ -121,7 +110,10 @@ function resolveNodeMfManifest(context, unit) {
     };
 }
 function resolveHttpApi(context, unit, config) {
-    const base = resolveBaseUrl(context, unit);
+    const base = resolveBaseUrl(context, {
+        ...unit,
+        publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`
+    });
     if (!base.ok) return {
         ok: false,
         reason: `http-api unavailable (${base.reason})`,
@@ -154,7 +146,20 @@ function resolveCloudflareServiceBinding(config) {
 }
 function resolveSurfaceLocations(context, unit, surface) {
     const outcomes = [];
-    if (surface.platforms.browserMfManifest) outcomes.push(resolveBrowserMfManifest(context, unit));
+    if (surface.platforms.browserMfManifest) {
+        const address = resolveBrowserManifestAddressInContext(context, {
+            ...unit,
+            manifestEnv: `VERTICAL_${unit.envSegment}_MF_MANIFEST`,
+            publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`
+        });
+        outcomes.push(address.ok ? {
+            ok: true,
+            location: {
+                platform: 'browser-mf-manifest',
+                manifestUrl: address.manifestUrl
+            }
+        } : address);
+    }
     if (surface.platforms.nodeMfManifest) outcomes.push(resolveNodeMfManifest(context, unit));
     if (void 0 !== surface.platforms.httpApi) outcomes.push(resolveHttpApi(context, unit, surface.platforms.httpApi));
     if (void 0 !== surface.platforms.cloudflareServiceBinding) outcomes.push(resolveCloudflareServiceBinding(surface.platforms.cloudflareServiceBinding));
@@ -271,4 +276,4 @@ function createEnvStaticSurfaceResolutionProvider(options) {
         }
     };
 }
-export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider };
+export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider, resolveBrowserManifestAddress };

package/dist/esm/surface-resolution/index.mjs

@@ -1,3 +1,3 @@
-export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider } from "./env-static-provider.mjs";
+export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider, resolveBrowserManifestAddress } from "./env-static-provider.mjs";
 export { formatSurfaceRef, parseSurfaceRef, validateSurfaceRef } from "./surface-ref.mjs";
 export { createDiscoveryError, matchDeliveryUnitIdentity, selectResolvedSurface, validateResolvedDeliveryUnit } from "./validation.mjs";

package/dist/esm-node/surface-resolution/env-static-provider.mjs

@@ -21,12 +21,11 @@ function createEnvContext(env, allowLocalFallback) {
         env,
         allowLocalFallback,
         cloudflareDeployEnabled: 'cloudflare' === env.MODERNJS_DEPLOY,
-        workersDevSubdomain: envValue(env, 'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN'),
-        requireCloudflarePublicUrls: 'true' === env.ULTRAMODERN_CLOUDFLARE_REQUIRE_PUBLIC_URLS
+        workersDevSubdomain: envValue(env, 'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN')
     };
 }
 function resolveBaseUrl(context, unit) {
-    const publicUrlEnv = `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`;
+    const { publicUrlEnv } = unit;
     const configuredPublicUrl = envValue(context.env, publicUrlEnv);
     if (void 0 !== configuredPublicUrl) return {
         ok: true,
@@ -36,13 +35,6 @@ function resolveBaseUrl(context, unit) {
         ok: true,
         baseUrl: `https://${unit.workerName}.${context.workersDevSubdomain}.workers.dev`
     };
-    if (context.cloudflareDeployEnabled && context.requireCloudflarePublicUrls) return {
-        ok: false,
-        reason: `Cloudflare deploy requires ${publicUrlEnv} (or a configured manifest env / ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN with a worker name)`,
-        details: {
-            publicUrlEnv
-        }
-    };
     if (void 0 !== unit.port && context.allowLocalFallback) return {
         ok: true,
         baseUrl: `http://localhost:${unit.port}`
@@ -62,15 +54,15 @@ function resolveBaseUrl(context, unit) {
         }
     };
 }
-function resolveBrowserMfManifest(context, unit) {
-    const manifestEnv = `VERTICAL_${unit.envSegment}_MF_MANIFEST`;
+function resolveBrowserManifestAddress(env, unit, environment, localEnvironments = DEFAULT_LOCAL_ENVIRONMENTS) {
+    return resolveBrowserManifestAddressInContext(createEnvContext(env, localEnvironments.includes(environment)), unit);
+}
+function resolveBrowserManifestAddressInContext(context, unit) {
+    const { manifestEnv } = unit;
     const configuredManifest = envValue(context.env, manifestEnv);
     if (void 0 !== configuredManifest) return {
         ok: true,
-        location: {
-            platform: 'browser-mf-manifest',
-            manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName)
-        }
+        manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName)
     };
     const base = resolveBaseUrl(context, unit);
     if (!base.ok) return {
@@ -83,10 +75,7 @@ function resolveBrowserMfManifest(context, unit) {
     };
     return {
         ok: true,
-        location: {
-            platform: 'browser-mf-manifest',
-            manifestUrl: `${base.baseUrl}/mf-manifest.json`
-        }
+        manifestUrl: `${base.baseUrl}/mf-manifest.json`
     };
 }
 function resolveNodeMfManifest(context, unit) {
@@ -122,7 +111,10 @@ function resolveNodeMfManifest(context, unit) {
     };
 }
 function resolveHttpApi(context, unit, config) {
-    const base = resolveBaseUrl(context, unit);
+    const base = resolveBaseUrl(context, {
+        ...unit,
+        publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`
+    });
     if (!base.ok) return {
         ok: false,
         reason: `http-api unavailable (${base.reason})`,
@@ -155,7 +147,20 @@ function resolveCloudflareServiceBinding(config) {
 }
 function resolveSurfaceLocations(context, unit, surface) {
     const outcomes = [];
-    if (surface.platforms.browserMfManifest) outcomes.push(resolveBrowserMfManifest(context, unit));
+    if (surface.platforms.browserMfManifest) {
+        const address = resolveBrowserManifestAddressInContext(context, {
+            ...unit,
+            manifestEnv: `VERTICAL_${unit.envSegment}_MF_MANIFEST`,
+            publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`
+        });
+        outcomes.push(address.ok ? {
+            ok: true,
+            location: {
+                platform: 'browser-mf-manifest',
+                manifestUrl: address.manifestUrl
+            }
+        } : address);
+    }
     if (surface.platforms.nodeMfManifest) outcomes.push(resolveNodeMfManifest(context, unit));
     if (void 0 !== surface.platforms.httpApi) outcomes.push(resolveHttpApi(context, unit, surface.platforms.httpApi));
     if (void 0 !== surface.platforms.cloudflareServiceBinding) outcomes.push(resolveCloudflareServiceBinding(surface.platforms.cloudflareServiceBinding));
@@ -272,4 +277,4 @@ function createEnvStaticSurfaceResolutionProvider(options) {
         }
     };
 }
-export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider };
+export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider, resolveBrowserManifestAddress };

package/dist/esm-node/surface-resolution/index.mjs

@@ -1,4 +1,4 @@
 import "node:module";
-export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider } from "./env-static-provider.mjs";
+export { DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, createEnvStaticSurfaceResolutionProvider, resolveBrowserManifestAddress } from "./env-static-provider.mjs";
 export { formatSurfaceRef, parseSurfaceRef, validateSurfaceRef } from "./surface-ref.mjs";
 export { createDiscoveryError, matchDeliveryUnitIdentity, selectResolvedSurface, validateResolvedDeliveryUnit } from "./validation.mjs";

package/dist/types/surface-resolution/env-static-provider.d.ts

@@ -98,6 +98,22 @@ export type EnvStaticProviderOptions = {
     identityVerification?: EnvStaticIdentityVerification;
 };
 export declare const ENV_STATIC_PROVIDER_NAME = "env-static";
+export type BrowserManifestAddressOptions = {
+    manifestEnv: string;
+    publicUrlEnv: string;
+    mfName: string;
+    workerName?: string;
+    port?: number;
+};
+/** Shared address policy for runtime discovery and build-time remote refs. */
+export declare function resolveBrowserManifestAddress(env: EnvRecord, unit: BrowserManifestAddressOptions, environment: EnvironmentId, localEnvironments?: readonly EnvironmentId[]): {
+    ok: true;
+    manifestUrl: string;
+} | {
+    ok: false;
+    reason: string;
+    details?: Record<string, unknown>;
+};
 /**
  * Create the baseline env/static provider. Resolution is all-or-nothing per
  * RESOLUTION-0001: every declared platform location for every surface of the

package/dist/types/surface-resolution/index.d.ts

@@ -1,4 +1,4 @@
-export { createEnvStaticSurfaceResolutionProvider, DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, type EnvRecord, type EnvStaticIdentityVerification, type EnvStaticMajorConfig, type EnvStaticProviderOptions, type EnvStaticSurfaceConfig, type EnvStaticSurfacePlatforms, type EnvStaticUnitConfig, } from './env-static-provider.js';
+export { type BrowserManifestAddressOptions, createEnvStaticSurfaceResolutionProvider, DEFAULT_LOCAL_ENVIRONMENTS, ENV_STATIC_PROVIDER_NAME, type EnvRecord, type EnvStaticIdentityVerification, type EnvStaticMajorConfig, type EnvStaticProviderOptions, type EnvStaticSurfaceConfig, type EnvStaticSurfacePlatforms, type EnvStaticUnitConfig, resolveBrowserManifestAddress, } from './env-static-provider.js';
 export { formatSurfaceRef, type ParsedSurfaceRef, parseSurfaceRef, type SurfaceRefParseError, type SurfaceRefParseResult, validateSurfaceRef, } from './surface-ref.js';
 export type { CompatibilityStatus, CompatibilityVerdict, DiscoveryError, DiscoveryErrorCode, DiscoveryResult, EnvironmentId, ResolvedDeliveryUnit, ResolvedSurface, ResolvedSurfaceKind, ResolvedSurfaceLocation, ResolvedSurfaceLocationPlatform, SurfaceResolutionProvider, } from './types.js';
 export { createDiscoveryError, type ExpectedDeliveryUnitIdentity, matchDeliveryUnitIdentity, type ResolvedDeliveryUnitIssue, type ResolvedDeliveryUnitValidationResult, selectResolvedSurface, validateResolvedDeliveryUnit, } from './validation.js';

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@bleedingdev/modern-js-surface-resolution",
-  "version": "3.9.0-ultramodern.9",
+  "version": "3.9.3-ultramodern.10",
   "description": "Universal surface references, atomic discovery records, and environment-static resolution.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "url": "git+https://github.com/ultramodernjs/ultramodern.js.git",
     "directory": "packages/toolkit/surface-resolution"
   },
   "main": "./dist/cjs/surface-resolution/index.js",
@@ -27,15 +27,14 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.9"
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.10"
   },
   "devDependencies": {
-    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.0-ultramodern.9",
-    "@rslib/core": "1.0.0",
-    "@rstest/core": "0.11.12",
+    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.3-ultramodern.10",
+    "@rslib/core": "1.0.3",
+    "@rstest/core": "0.12.3",
     "@scripts/rstest-config": "2.66.0",
-    "@types/node": "^26.4.1",
-    "@typescript/native-preview": "7.0.0-dev.20260707.2"
+    "@types/node": "^26.6.5"
   },
   "publishConfig": {
     "access": "public"
@@ -45,8 +44,11 @@
     "dev": "rslib build --watch",
     "test": "rstest run"
   },
-  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "homepage": "https://github.com/ultramodernjs/ultramodern.js#readme",
   "bugs": {
-    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+    "url": "https://github.com/ultramodernjs/ultramodern.js/issues"
+  },
+  "ultramodern": {
+    "sourceName": "@modern-js/surface-resolution"
   }
 }

package/src/surface-resolution/env-static-provider.ts

@@ -192,7 +192,6 @@ type EnvContext = {
   env: EnvRecord;
   cloudflareDeployEnabled: boolean;
   workersDevSubdomain: string | undefined;
-  requireCloudflarePublicUrls: boolean;
   /**
    * Whether localhost dev fallbacks may be used. True only in designated
    * local environments; everywhere else missing config fails closed.
@@ -212,8 +211,6 @@ function createEnvContext(
       env,
       'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN',
     ),
-    requireCloudflarePublicUrls:
-      env.ULTRAMODERN_CLOUDFLARE_REQUIRE_PUBLIC_URLS === 'true',
   };
 }
 
@@ -223,9 +220,9 @@ function createEnvContext(
  */
 function resolveBaseUrl(
   context: EnvContext,
-  unit: EnvStaticUnitConfig,
+  unit: { publicUrlEnv: string; workerName?: string; port?: number },
 ): LocationOutcomeBase {
-  const publicUrlEnv = `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`;
+  const { publicUrlEnv } = unit;
   const configuredPublicUrl = envValue(context.env, publicUrlEnv);
   if (configuredPublicUrl !== undefined) {
     return { ok: true, baseUrl: trimTrailingSlashes(configuredPublicUrl) };
@@ -242,14 +239,6 @@ function resolveBaseUrl(
     };
   }
 
-  if (context.cloudflareDeployEnabled && context.requireCloudflarePublicUrls) {
-    return {
-      ok: false,
-      reason: `Cloudflare deploy requires ${publicUrlEnv} (or a configured manifest env / ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN with a worker name)`,
-      details: { publicUrlEnv },
-    };
-  }
-
   if (unit.port !== undefined && context.allowLocalFallback) {
     return { ok: true, baseUrl: `http://localhost:${unit.port}` };
   }
@@ -273,19 +262,39 @@ type LocationOutcomeBase =
   | { ok: true; baseUrl: string }
   | { ok: false; reason: string; details?: Record<string, unknown> };
 
-function resolveBrowserMfManifest(
+export type BrowserManifestAddressOptions = {
+  manifestEnv: string;
+  publicUrlEnv: string;
+  mfName: string;
+  workerName?: string;
+  port?: number;
+};
+
+/** Shared address policy for runtime discovery and build-time remote refs. */
+export function resolveBrowserManifestAddress(
+  env: EnvRecord,
+  unit: BrowserManifestAddressOptions,
+  environment: EnvironmentId,
+  localEnvironments: readonly EnvironmentId[] = DEFAULT_LOCAL_ENVIRONMENTS,
+):
+  | { ok: true; manifestUrl: string }
+  | { ok: false; reason: string; details?: Record<string, unknown> } {
+  return resolveBrowserManifestAddressInContext(
+    createEnvContext(env, localEnvironments.includes(environment)),
+    unit,
+  );
+}
+
+function resolveBrowserManifestAddressInContext(
   context: EnvContext,
-  unit: EnvStaticUnitConfig,
-): LocationOutcome {
-  const manifestEnv = `VERTICAL_${unit.envSegment}_MF_MANIFEST`;
+  unit: BrowserManifestAddressOptions,
+): ReturnType<typeof resolveBrowserManifestAddress> {
+  const { manifestEnv } = unit;
   const configuredManifest = envValue(context.env, manifestEnv);
   if (configuredManifest !== undefined) {
     return {
       ok: true,
-      location: {
-        platform: 'browser-mf-manifest',
-        manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName),
-      },
+      manifestUrl: stripMfNamePrefix(configuredManifest, unit.mfName),
     };
   }
 
@@ -300,10 +309,7 @@ function resolveBrowserMfManifest(
 
   return {
     ok: true,
-    location: {
-      platform: 'browser-mf-manifest',
-      manifestUrl: `${base.baseUrl}/mf-manifest.json`,
-    },
+    manifestUrl: `${base.baseUrl}/mf-manifest.json`,
   };
 }
 
@@ -353,7 +359,10 @@ function resolveHttpApi(
   unit: EnvStaticUnitConfig,
   config: { prefix: string },
 ): LocationOutcome {
-  const base = resolveBaseUrl(context, unit);
+  const base = resolveBaseUrl(context, {
+    ...unit,
+    publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`,
+  });
   if (!base.ok) {
     return {
       ok: false,
@@ -402,7 +411,22 @@ function resolveSurfaceLocations(
   | { ok: false; reason: string; details?: Record<string, unknown> } {
   const outcomes: LocationOutcome[] = [];
   if (surface.platforms.browserMfManifest) {
-    outcomes.push(resolveBrowserMfManifest(context, unit));
+    const address = resolveBrowserManifestAddressInContext(context, {
+      ...unit,
+      manifestEnv: `VERTICAL_${unit.envSegment}_MF_MANIFEST`,
+      publicUrlEnv: `ULTRAMODERN_PUBLIC_URL_${unit.envSegment}`,
+    });
+    outcomes.push(
+      address.ok
+        ? {
+            ok: true,
+            location: {
+              platform: 'browser-mf-manifest',
+              manifestUrl: address.manifestUrl,
+            },
+          }
+        : address,
+    );
   }
   if (surface.platforms.nodeMfManifest) {
     outcomes.push(resolveNodeMfManifest(context, unit));

package/src/surface-resolution/index.ts

@@ -1,4 +1,5 @@
 export {
+  type BrowserManifestAddressOptions,
   createEnvStaticSurfaceResolutionProvider,
   DEFAULT_LOCAL_ENVIRONMENTS,
   ENV_STATIC_PROVIDER_NAME,
@@ -9,6 +10,7 @@ export {
   type EnvStaticSurfaceConfig,
   type EnvStaticSurfacePlatforms,
   type EnvStaticUnitConfig,
+  resolveBrowserManifestAddress,
 } from './env-static-provider';
 export {
   formatSurfaceRef,