@ogygia/core 0.11.4 → 0.12.0

package/dist/compiler/index.d.ts

@@ -1,4 +1,4 @@
-import { CLIENT_BINDING_STUB, DEFAULT_IMPORT_KEYS, ISLAND_DIR, ImportKeys, asRegionLocals, import_keys_hint, is_island_path, islandChunkFileName, islandId, islandPublicUrl, normalize_hydrate_value, normalize_import_keys, normalize_region_value, transformHost, transformTsRegions, wrapperVirtualId } from "./region/transform.js";
+import { CLIENT_BINDING_STUB, DEFAULT_IMPORT_KEYS, ISLAND_DIR, ImportKeys, STABLE_NAME_DIR, asRegionLocals, import_keys_hint, is_island_path, islandChunkFileName, islandId, islandPublicUrl, normalize_hydrate_value, normalize_import_keys, normalize_region_value, transformHost, transformTsRegions, wrapperVirtualId } from "./region/transform.js";
 import { RawParse, set_parser } from "./parse/oxc.js";
 import { CssReachOptions, FOUC_CSS_PREFIX, FOUC_SCOPED_PREFIX, FoucAlias, buildFoucCssModuleSource, collectFoucCssReachable, compileFoucScopedCss, foucCssVirtualId, foucRelFromId, foucScopedVirtualId, isFoucCssId, isFoucScopedId, listStaticImports, resolveFoucImportSpec, svelteHasStyle } from "./fouc-css.js";
 import { regionId, regionIdentity, strategyKey } from "./region/identity.js";
@@ -6,6 +6,6 @@ import { collectCaptureInfo, collectFreeIdentifiers, collectSnippetNames } from
 import { Compiler, Profiler } from "./driver.js";
 import { Program, host_key, strip_id } from "./program.js";
 import { CompileCtx, CompileCtxInit } from "./ctx.js";
-import { PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, RESOLVED, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, islandVirtualId, lazyEntryVirtualId, regionBindingVirtualId } from "./ids.js";
+import { PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, RESOLVED, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_FLAGS, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, islandVirtualId, lazyEntryVirtualId, regionBindingVirtualId } from "./ids.js";
 import { FLAGS_SPEC, FlagSite, collect_flag_sites, flags_manifest } from "./flags.js";
-export { CLIENT_BINDING_STUB, CompileCtx, type CompileCtxInit, Compiler, CssReachOptions, DEFAULT_IMPORT_KEYS, FLAGS_SPEC, FOUC_CSS_PREFIX, FOUC_SCOPED_PREFIX, type FlagSite, FoucAlias, ISLAND_DIR, ImportKeys, PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, type Profiler, Program, RESOLVED, type RawParse, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, asRegionLocals, buildFoucCssModuleSource, collectCaptureInfo, collectFoucCssReachable, collectFreeIdentifiers, collectSnippetNames, collect_flag_sites, compileFoucScopedCss, flags_manifest, foucCssVirtualId, foucRelFromId, foucScopedVirtualId, host_key, import_keys_hint, isFoucCssId, isFoucScopedId, is_island_path, islandChunkFileName, islandId, islandPublicUrl, islandVirtualId, lazyEntryVirtualId, listStaticImports, normalize_hydrate_value, normalize_import_keys, normalize_region_value, regionBindingVirtualId, regionId, regionIdentity, resolveFoucImportSpec, set_parser, strategyKey, strip_id, svelteHasStyle, transformHost, transformTsRegions, wrapperVirtualId };
+export { CLIENT_BINDING_STUB, CompileCtx, type CompileCtxInit, Compiler, CssReachOptions, DEFAULT_IMPORT_KEYS, FLAGS_SPEC, FOUC_CSS_PREFIX, FOUC_SCOPED_PREFIX, type FlagSite, FoucAlias, ISLAND_DIR, ImportKeys, PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, type Profiler, Program, RESOLVED, type RawParse, STABLE_NAME_DIR, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_FLAGS, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, asRegionLocals, buildFoucCssModuleSource, collectCaptureInfo, collectFoucCssReachable, collectFreeIdentifiers, collectSnippetNames, collect_flag_sites, compileFoucScopedCss, flags_manifest, foucCssVirtualId, foucRelFromId, foucScopedVirtualId, host_key, import_keys_hint, isFoucCssId, isFoucScopedId, is_island_path, islandChunkFileName, islandId, islandPublicUrl, islandVirtualId, lazyEntryVirtualId, listStaticImports, normalize_hydrate_value, normalize_import_keys, normalize_region_value, regionBindingVirtualId, regionId, regionIdentity, resolveFoucImportSpec, set_parser, strategyKey, strip_id, svelteHasStyle, transformHost, transformTsRegions, wrapperVirtualId };

package/dist/compiler/index.js

@@ -1,4 +1,4 @@
-import { CLIENT_BINDING_STUB, DEFAULT_IMPORT_KEYS, ISLAND_DIR, asRegionLocals, import_keys_hint, is_island_path, islandChunkFileName, islandId, islandPublicUrl, normalize_hydrate_value, normalize_import_keys, normalize_region_value, transformHost, transformTsRegions, wrapperVirtualId } from "./region/transform.js";
+import { CLIENT_BINDING_STUB, DEFAULT_IMPORT_KEYS, ISLAND_DIR, STABLE_NAME_DIR, asRegionLocals, import_keys_hint, is_island_path, islandChunkFileName, islandId, islandPublicUrl, normalize_hydrate_value, normalize_import_keys, normalize_region_value, transformHost, transformTsRegions, wrapperVirtualId } from "./region/transform.js";
 import { set_parser } from "./parse/oxc.js";
 import { FOUC_CSS_PREFIX, FOUC_SCOPED_PREFIX, buildFoucCssModuleSource, collectFoucCssReachable, compileFoucScopedCss, foucCssVirtualId, foucRelFromId, foucScopedVirtualId, isFoucCssId, isFoucScopedId, listStaticImports, resolveFoucImportSpec, svelteHasStyle } from "./fouc-css.js";
 import { regionId, regionIdentity, strategyKey } from "./region/identity.js";
@@ -6,6 +6,6 @@ import { collectCaptureInfo, collectFreeIdentifiers, collectSnippetNames } from
 import { Compiler } from "./driver.js";
 import { Program, host_key, strip_id } from "./program.js";
 import { CompileCtx } from "./ctx.js";
-import { PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, RESOLVED, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, islandVirtualId, lazyEntryVirtualId, regionBindingVirtualId } from "./ids.js";
+import { PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, RESOLVED, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_FLAGS, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, islandVirtualId, lazyEntryVirtualId, regionBindingVirtualId } from "./ids.js";
 import { FLAGS_SPEC, collect_flag_sites, flags_manifest } from "./flags.js";
-export { CLIENT_BINDING_STUB, CompileCtx, Compiler, DEFAULT_IMPORT_KEYS, FLAGS_SPEC, FOUC_CSS_PREFIX, FOUC_SCOPED_PREFIX, ISLAND_DIR, PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, Program, RESOLVED, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, asRegionLocals, buildFoucCssModuleSource, collectCaptureInfo, collectFoucCssReachable, collectFreeIdentifiers, collectSnippetNames, collect_flag_sites, compileFoucScopedCss, flags_manifest, foucCssVirtualId, foucRelFromId, foucScopedVirtualId, host_key, import_keys_hint, isFoucCssId, isFoucScopedId, is_island_path, islandChunkFileName, islandId, islandPublicUrl, islandVirtualId, lazyEntryVirtualId, listStaticImports, normalize_hydrate_value, normalize_import_keys, normalize_region_value, regionBindingVirtualId, regionId, regionIdentity, resolveFoucImportSpec, set_parser, strategyKey, strip_id, svelteHasStyle, transformHost, transformTsRegions, wrapperVirtualId };
+export { CLIENT_BINDING_STUB, CompileCtx, Compiler, DEFAULT_IMPORT_KEYS, FLAGS_SPEC, FOUC_CSS_PREFIX, FOUC_SCOPED_PREFIX, ISLAND_DIR, PROFILER_MAPS_GZ_PREFIX, PROFILER_MAPS_PLACEHOLDER, Program, RESOLVED, STABLE_NAME_DIR, V_DEVTOOLS_BOOT, V_DEVTOOLS_BOOT_URL, V_DEVTOOLS_META, V_DEV_HMR, V_DEV_HMR_URL, V_FN_MANIFEST, V_HYDRATE_FEATURES, V_ISLAND_DEPS, V_KIT_TRANSPORT, V_KIT_WIRE, V_MANIFEST, V_PROFILER_MAPS, V_RATE_LIMIT, V_REGION_ENDPOINT, V_REGION_TTL, V_REQUEST_EVENT, V_ROUTER_CONFIG, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_RUNTIME, V_RUNTIME_ENTRY, V_RUNTIME_FLAGS, V_RUNTIME_URL, V_SECRET, V_SERVER_ISLANDS, V_SERVER_MANIFEST, V_SERVER_PLUGINS, V_SESSION_COOKIE, V_SIGN, V_TRANSPORT, V_TRANSPORTABLES, V_TRANSPORTABLES_EAGER, asRegionLocals, buildFoucCssModuleSource, collectCaptureInfo, collectFoucCssReachable, collectFreeIdentifiers, collectSnippetNames, collect_flag_sites, compileFoucScopedCss, flags_manifest, foucCssVirtualId, foucRelFromId, foucScopedVirtualId, host_key, import_keys_hint, isFoucCssId, isFoucScopedId, is_island_path, islandChunkFileName, islandId, islandPublicUrl, islandVirtualId, lazyEntryVirtualId, listStaticImports, normalize_hydrate_value, normalize_import_keys, normalize_region_value, regionBindingVirtualId, regionId, regionIdentity, resolveFoucImportSpec, set_parser, strategyKey, strip_id, svelteHasStyle, transformHost, transformTsRegions, wrapperVirtualId };

package/dist/compiler/kit.d.ts

@@ -52,6 +52,13 @@ export declare function read_csr(file: string): boolean | undefined;
  * value is a build error: it is read at build time, so ogygia could not honour it.
  */
 export declare function read_route_config(file: string, keys: readonly string[]): Record<string, unknown>;
+/**
+ * A route COMPONENT of `kind`: `+page.svelte`, or the same file in any other extension the app
+ * compiles to a component (`+page.md`, `+page.svx`): every `+page.*` but the option scripts. Kit
+ * routes all of them alike, so the csr topology does too — a markdown page counted for nothing
+ * here, and its layout's world and its own client leg were decided as if it did not exist.
+ */
+export declare function is_route_component(name: string, kind: "page" | "layout"): boolean;
 /**
  * The ERROR-RENDER csr of every page route: Kit renders a page's `+error.svelte` with the LAYOUT
  * branch only (`PageNodes(layouts)` in its server renderer — the page node is dropped), so `csr`

package/dist/compiler/kit.js

@@ -197,6 +197,16 @@ const OPTION_FILES_LAYOUT = [
 	"+layout.server.js",
 	"+layout.server.ts"
 ];
+const SCRIPT_FILE_RE = /\.[cm]?[jt]s$/;
+/**
+* A route COMPONENT of `kind`: `+page.svelte`, or the same file in any other extension the app
+* compiles to a component (`+page.md`, `+page.svx`): every `+page.*` but the option scripts. Kit
+* routes all of them alike, so the csr topology does too — a markdown page counted for nothing
+* here, and its layout's world and its own client leg were decided as if it did not exist.
+*/
+function is_route_component(name, kind) {
+	return name.startsWith(`+${kind}.`) && !SCRIPT_FILE_RE.test(name);
+}
 /**
 * Own-chain Kit-effective `csr === false` for one route host — Kit's per-PAGE rule verbatim:
 * walk the layout option files root → host dir (then the page's own option files), deepest
@@ -217,7 +227,7 @@ function own_chain_csr_false(hostFile, routesDir, layouts_only = false) {
 		const v = read_csr(path.join(d, f));
 		if (v !== void 0) csr = v;
 	}
-	if (!layouts_only && path.basename(hostFile) === "+page.svelte") for (const f of OPTION_FILES_PAGE) {
+	if (!layouts_only && is_route_component(path.basename(hostFile), "page")) for (const f of OPTION_FILES_PAGE) {
 		const v = read_csr(path.join(dir, f));
 		if (v !== void 0) csr = v;
 	}
@@ -281,8 +291,8 @@ function layout_page_worlds(layoutDir, routesDir) {
 function routeCsrIsFalse(hostFile, routesDir) {
 	if (!hostFile.startsWith(routesDir)) return false;
 	const base = path.basename(hostFile);
-	if (base === "+page.svelte") return own_chain_csr_false(hostFile, routesDir);
-	if (base !== "+layout.svelte") return false;
+	if (is_route_component(base, "page")) return own_chain_csr_false(hostFile, routesDir);
+	if (!is_route_component(base, "layout")) return false;
 	const { any_false, any_true } = layout_page_worlds(path.dirname(hostFile), routesDir);
 	if (any_false && !any_true) return true;
 	if (any_false || any_true) return false;
@@ -298,9 +308,10 @@ function routeCsrIsFalse(hostFile, routesDir) {
 */
 function routeCsrIsTrue(hostFile, routesDir) {
 	const base = path.basename(hostFile);
-	if (base !== "+page.svelte" && base !== "+layout.svelte") return false;
+	const is_page = is_route_component(base, "page");
+	if (!is_page && !is_route_component(base, "layout")) return false;
 	if (!hostFile.startsWith(routesDir)) return false;
-	if (base === "+page.svelte") return !own_chain_csr_false(hostFile, routesDir);
+	if (is_page) return !own_chain_csr_false(hostFile, routesDir);
 	const { any_false, any_true } = layout_page_worlds(path.dirname(hostFile), routesDir);
 	if (any_false) return false;
 	if (any_true) return true;
@@ -339,7 +350,7 @@ function pageLeaves(routesDir) {
 		for (const e of route_entries(dir)) {
 			const full = path.join(dir, e.name);
 			if (e.is_dir) walk(full);
-			else if (e.name === "+page.svelte") leaves.push(full);
+			else if (is_route_component(e.name, "page")) leaves.push(full);
 		}
 	};
 	walk(routesDir);
@@ -378,7 +389,7 @@ function config_page_dirs(routesDir) {
 		for (const e of route_entries(dir)) {
 			const full = path.join(dir, e.name);
 			if (e.is_dir) walk(full);
-			else if (PAGE_FILE_RE.test(e.name)) dirs.add(dir);
+			else if (PAGE_FILE_RE.test(e.name) || is_route_component(e.name, "page")) dirs.add(dir);
 		}
 	};
 	walk(routesDir);
@@ -486,13 +497,14 @@ function collectNodeEffectiveCsr(routesDir) {
 		const entries = route_entries(dir);
 		const names = new Set(entries.filter((e) => e.is_file).map((e) => e.name));
 		const has = (list) => list.some((f) => names.has(f));
+		const has_component = (kind) => [...names].some((n) => is_route_component(n, kind));
 		const layout_own = own_csr(dir, LAYOUT_UNIVERSAL, LAYOUT_SERVER);
 		const chain = layout_own !== void 0 ? layout_own : inherited;
-		if (names.has("+layout.svelte") || has(LAYOUT_UNIVERSAL) || has(LAYOUT_SERVER)) {
+		if (has_component("layout") || has(LAYOUT_UNIVERSAL) || has(LAYOUT_SERVER)) {
 			if (is_root) saw_root_layout = true;
 			nodes.push(chain);
 		}
-		if (names.has("+page.svelte") || has(PAGE_UNIVERSAL) || has(PAGE_SERVER)) {
+		if (has_component("page") || has(PAGE_UNIVERSAL) || has(PAGE_SERVER)) {
 			const page_own = own_csr(dir, PAGE_UNIVERSAL, PAGE_SERVER);
 			nodes.push(page_own !== void 0 ? page_own : chain);
 		}
@@ -560,4 +572,4 @@ function clean_stale_ogygia_dirs(dir) {
 		clean_stale_ogygia_dirs(full);
 	}
 }
-export { DEFAULT_KIT_DIRS, KEEP_CLIENT_DIR, clean_stale_ogygia_dirs, clear_route_csr_cache, clientBuildWillSkip, csrTrueRouteIds, errorCsrTrueRouteIds, hasAnyCsrFalseRoute, hasAnyCsrTrueRoute, inject_keep_client_route, keep_client_dir, kit_dirs, kit_inline_style_threshold, kit_major, normalize_route_id, page_route_config, read_csr, read_route_config, resolve_kit_paths, rootLayoutCsrTrue, routeCsrIsFalse, routeCsrIsTrue, set_kit_dirs, set_kit_inline_style_threshold };
+export { DEFAULT_KIT_DIRS, KEEP_CLIENT_DIR, clean_stale_ogygia_dirs, clear_route_csr_cache, clientBuildWillSkip, csrTrueRouteIds, errorCsrTrueRouteIds, hasAnyCsrFalseRoute, hasAnyCsrTrueRoute, inject_keep_client_route, is_route_component, keep_client_dir, kit_dirs, kit_inline_style_threshold, kit_major, normalize_route_id, page_route_config, read_csr, read_route_config, resolve_kit_paths, rootLayoutCsrTrue, routeCsrIsFalse, routeCsrIsTrue, set_kit_dirs, set_kit_inline_style_threshold };

package/dist/compiler/link/caps.js

@@ -1,4 +1,5 @@
 import { csrTrueRouteIds, errorCsrTrueRouteIds, page_route_config, rootLayoutCsrTrue } from "../kit.js";
+import { dedent } from "../dedent.js";
 // src/compiler/link/caps.ts
 /**
 * Capability virtual-module emitters — the leg-split sources for the signed-capability family:
@@ -14,8 +15,14 @@ import { csrTrueRouteIds, errorCsrTrueRouteIds, page_route_config, rootLayoutCsr
 * counts — else this build's key.
 */
 function secret_module(ssr, build_secret, build_had_secret) {
-	if (!ssr) return `export const buildKey = '';\nexport const buildHadSecret = false;`;
-	return `export const buildKey = ${JSON.stringify(build_secret)};\nexport const buildHadSecret = ${build_had_secret};`;
+	if (!ssr) return dedent`
+			export const buildKey = '';
+			export const buildHadSecret = false;
+		`;
+	return dedent`
+		export const buildKey = ${JSON.stringify(build_secret)};
+		export const buildHadSecret = ${build_had_secret};
+	`;
 }
 /**
 * `virtual:ogygia/sign` — same split as secret: SSR mints with node:crypto (re-exports the real
@@ -23,12 +30,37 @@ function secret_module(ssr, build_secret, build_had_secret) {
 * length-prefixed canonical form the runtime compares against.
 */
 function sign_module(ssr, hmac_module) {
-	if (!ssr) return "export function sign(_secret, _message) { return ''; }\nexport function verify(_secret, _message, _sig) { return false; }\nexport function region_mac_message(id, exp, props, session = '', ttl = '', render = '') {\n  const enc = new TextEncoder();\n  const lp = (s) => enc.encode(String(s)).byteLength + ':' + String(s);\n  const v1 = lp(id) + '|' + lp(exp) + '|' + lp(props) + '|' + lp(session) + '|' + lp(ttl);\n  return render === '' ? 'v1|' + v1 : 'v2|' + v1 + '|' + lp(render);\n}\n";
-	return `export { sign, verify, region_mac_message } from ${JSON.stringify(hmac_module)};`;
+	if (!ssr) return dedent`
+			export function sign(_secret, _message) {
+				return '';
+			}
+
+			export function verify(_secret, _message, _sig) {
+				return false;
+			}
+
+			export function region_mac_message(id, exp, props, session = '', ttl = '', render = '') {
+				const enc = new TextEncoder();
+				const lp = (s) => enc.encode(String(s)).byteLength + ':' + String(s);
+				const v1 = lp(id) + '|' + lp(exp) + '|' + lp(props) + '|' + lp(session) + '|' + lp(ttl);
+				return render === '' ? 'v1|' + v1 : 'v2|' + v1 + '|' + lp(render);
+			}
+		`;
+	return dedent`
+		export { sign, verify, region_mac_message } from ${JSON.stringify(hmac_module)};
+	`;
 }
 function server_plugins_module(ssr, realms) {
 	if (!ssr || realms.length === 0) return `export const plugins = [];`;
-	return `${realms.map((r, i) => `import p${i} from ${JSON.stringify(r.module)};`).join("\n")}\nexport const plugins = [\n\t${realms.map((r, i) => `{ name: ${JSON.stringify(r.name)}, options: ${JSON.stringify(r.options)}, server: p${i} }`).join(",\n	")}\n];`;
+	const imports = realms.map((r, i) => `import p${i} from ${JSON.stringify(r.module)};`).join("\n");
+	const list = realms.map((r, i) => `{ name: ${JSON.stringify(r.name)}, options: ${JSON.stringify(r.options)}, server: p${i} }`).join(",\n	");
+	return dedent`
+		${imports}
+
+		export const plugins = [
+			${list}
+		];
+	`;
 }
 /** `virtual:ogygia/route-config` — SERVER only: every Kit page route id → the keys the plugins claim
 *  inside Kit's `config` page option, merged the way Kit merges it (a key no level sets is absent).
@@ -50,15 +82,33 @@ function session_cookie_module(ssr, session_cookie) {
 /** `virtual:ogygia/region-ttl` — SERVER only; the capability expiry window for mint, and how long
 *  after expiry an anonymous capability still renews. */
 function region_ttl_module(ssr, region_ttl, renew_window) {
-	if (!ssr) return `export const regionTtl = 3600;\nexport const renewWindow = 0;`;
-	return `export const regionTtl = ${region_ttl};\nexport const renewWindow = ${renew_window};`;
+	if (!ssr) return dedent`
+			export const regionTtl = 3600;
+			export const renewWindow = 0;
+		`;
+	return dedent`
+		export const regionTtl = ${region_ttl};
+		export const renewWindow = ${renew_window};
+	`;
 }
 /** `virtual:ogygia/route-csr` — SERVER only: the csr=true route ids, so a csr=false layout's islands
 *  degrade to inline when the LEAF page is csr=true (Kit hydrates the whole document). The CLIENT leg
 *  is an empty set — the client reads the identical signal from `kit_hydrates_page()`, and the route
 *  list never ships to the browser. */
 function route_csr_module(ssr, routesDir) {
-	if (!ssr) return "export const csr_true_routes = new Set();\nexport const error_csr_true_routes = new Set();\nexport const root_layout_csr_true = true;";
-	return `export const csr_true_routes = new Set(${JSON.stringify(csrTrueRouteIds(routesDir))});\nexport const error_csr_true_routes = new Set(${JSON.stringify(errorCsrTrueRouteIds(routesDir))});\nexport const root_layout_csr_true = ${rootLayoutCsrTrue(routesDir)};`;
+	if (!ssr) return dedent`
+			export const csr_true_routes = new Set();
+			export const error_csr_true_routes = new Set();
+			export const root_layout_csr_true = true;
+		`;
+	return dedent`
+		export const csr_true_routes = new Set(${JSON.stringify(csrTrueRouteIds(routesDir))});
+
+		// The error-render map beside the page map: Kit renders a route's error page with its LAYOUT
+		// branch only, so a 404 under a csr=false page is hydrated whenever the layouts say so.
+		export const error_csr_true_routes = new Set(${JSON.stringify(errorCsrTrueRouteIds(routesDir))});
+
+		export const root_layout_csr_true = ${rootLayoutCsrTrue(routesDir)};
+	`;
 }
 export { rate_limit_module, region_ttl_module, route_config_module, route_csr_module, secret_module, server_plugins_module, session_cookie_module, sign_module };

package/dist/compiler/link/island-deps.js

@@ -1,4 +1,5 @@
 import { path } from "../host.js";
+import { dedent } from "../dedent.js";
 import { merge_page_keys } from "./page-keys.js";
 import { hydration_hazards } from "../../insights/hydration-hazards.js";
 import { OWN_FILE_RE, OWN_PACKAGE_NAMES } from "../../own-package.js";
@@ -499,27 +500,229 @@ function collect_inline_css(bundle, hrefs, threshold) {
 	return out;
 }
 function island_deps_module(ssr, is_dev, out_dir_rel = ".svelte-kit") {
-	if (!ssr) return `export function islandDeps(_entry) { return []; }\nexport function islandCss(_entry) { return []; }\nexport function islandCssInline(_href) { return null; }\nexport function contentCss(_id) { return []; }\nexport function islandReadsPage(_entry) { return false; }\nexport function islandPageKeys(_entry) { return null; }\nexport function islandPageWhy(_entry) { return null; }\nexport function islandRemotes(_entry) { return null; }\nexport function islandInteractivity(_entry) { return null; }\nexport function islandHazards(_entry) { return null; }\nexport function chunkContents(_href) { return null; }\nexport function chunkHeavy(_href) { return null; }\nexport function chunkBarrels(_href) { return null; }\nexport function chunkDuplicates() { return null; }\nexport function fnManifest() { return null; }\nexport function entryLocation(_identity) { return null; }`;
-	if (is_dev) return `export function islandDeps(_entry) { return []; }\nexport function islandCss(entry) { return entry ? [entry] : []; }\nexport function islandCssInline(_href) { return null; }\nexport function contentCss(_id) { return []; }\nexport function islandReadsPage(_entry) { return true; }\nexport function islandPageKeys(_entry) { return null; }\nexport function islandPageWhy(_entry) { return null; }\nexport function islandRemotes(_entry) { return null; }\nexport function islandInteractivity(_entry) { return null; }\nexport function islandHazards(_entry) { return null; }\nexport function chunkContents(_href) { return null; }\nexport function chunkHeavy(_href) { return null; }\nexport function chunkBarrels(_href) { return null; }\nexport function chunkDuplicates() { return null; }\nexport function fnManifest() { return null; }\nexport function entryLocation(_identity) { return null; }`;
-	return `import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-const __OG_INLINE = '__OGYGIA_ISLAND_DEPS_INLINE__';
-let cache = null;
-try { if (__OG_INLINE.charCodeAt(0) === 123) cache = JSON.parse(__OG_INLINE); } catch {}
-function candidates() {
-  const out = [];
-  try {
-    let dir = path.dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 8; i++) {
-      out.push(path.join(dir, 'og-region-deps.json'));
-      const parent = path.dirname(dir);
-      if (parent === dir) break;
-      dir = parent;
-    }
-  } catch {}
-  if (typeof process !== 'undefined' && process.cwd) {
-    const cwd = process.cwd();
-    out.push(path.join(cwd, ${JSON.stringify(out_dir_rel)}, 'og-region-deps.json'));\n    out.push(path.join(cwd, ${JSON.stringify(out_dir_rel)}, 'output', 'server', 'og-region-deps.json'));\n  }\n  return out;\n}\nfunction load() {\n  if (cache) return cache;\n  for (const p of candidates()) {\n    try { cache = JSON.parse(fs.readFileSync(p, 'utf8')); return cache; } catch {}\n  }\n  cache = {};\n  return cache;\n}\n// map (pre-css build) degrades gracefully: js falls back to the root, css to [].\nfunction pick(kind, entry) {\n  const all = load();\n  const map = all && typeof all[kind] === 'object' ? all[kind] : kind === 'js' ? all : null;\n  const list = map ? map[entry] : null;\n  return Array.isArray(list) ? list : [];\n}\nexport function islandDeps(entry) {\n  return entry ? pick('js', entry) : [];\n}\nexport function islandCss(entry) {\n  return entry ? pick('css', entry) : [];\n}\nexport function islandCssInline(href) {\n  const all = load();\n  const map = all && typeof all.css_inline === 'object' && all.css_inline ? all.css_inline : null;\n  if (!map || !href) return null;\n  const v = map[href];\n  return typeof v === 'string' ? v : null;\n}\nexport function contentCss(id) {\n  return id ? pick('content_css', id) : [];\n}\nexport function islandReadsPage(entry) {\n  const all = load();\n  const map = all && typeof all.page === 'object' && all.page ? all.page : null;\n  if (!map || !entry) return true;\n  const v = map[entry];\n  return v === undefined ? true : !!v;\n}\nexport function islandPageKeys(entry) {\n  const all = load();\n  const map = all && typeof all.page_keys === 'object' && all.page_keys ? all.page_keys : null;\n  if (!map || !entry) return null;\n  const v = map[entry];\n  return Array.isArray(v) ? v : null;\n}\nexport function islandPageWhy(entry) {\n  const all = load();\n  const map = all && typeof all.page_why === 'object' && all.page_why ? all.page_why : null;\n  if (!map || !entry) return null;\n  const v = map[entry];\n  return Array.isArray(v) ? v : null;\n}\nexport function islandRemotes(entry) {\n  const all = load();\n  const map = all && typeof all.remotes === 'object' && all.remotes ? all.remotes : null;\n  if (!map || !entry) return null;\n  const v = map[entry];\n  return Array.isArray(v) ? v : null;\n}\nexport function islandInteractivity(entry) {\n  const all = load();\n  const map = all && typeof all.interactivity === 'object' && all.interactivity ? all.interactivity : null;\n  if (!map || !entry) return null;\n  const v = map[entry];\n  return v && typeof v === 'object' ? v : null;\n}\nexport function chunkContents(href) {\n  const all = load();\n  const map = all && typeof all.contents === 'object' && all.contents ? all.contents : null;\n  if (!map || !href) return null;\n  const key = href.startsWith('/') ? href : '/' + href.replace(/^\\.\\//, '');\n  const v = map[key] ?? map[href];\n  return Array.isArray(v) ? v : null;\n}\nexport function chunkHeavy(href) {\n  const all = load();\n  const map = all && typeof all.heavy === 'object' && all.heavy ? all.heavy : null;\n  if (!map || !href) return null;\n  const key = href.startsWith('/') ? href : '/' + href.replace(/^\\.\\//, '');\n  const v = map[key] ?? map[href];\n  return v && typeof v === 'object' && Array.isArray(v.top) ? v : null;\n}\nexport function chunkDuplicates() {\n  const all = load();\n  const v = all && Array.isArray(all.dupes) ? all.dupes : null;\n  return v && v.length ? v : null;\n}\nexport function islandHazards(entry) {\n  const all = load();\n  const map = all && typeof all.hazards === 'object' && all.hazards ? all.hazards : null;\n  if (!map || !entry) return null;\n  const v = map[entry];\n  return Array.isArray(v) ? v : null;\n}\nexport function chunkBarrels(href) {\n  const all = load();\n  const map = all && typeof all.barrels === 'object' && all.barrels ? all.barrels : null;\n  if (!map || !href) return null;\n  const key = href.startsWith('/') ? href : '/' + href.replace(/^\\.\\//, '');\n  const v = map[key] ?? map[href];\n  return Array.isArray(v) ? v : null;\n}\nexport function fnManifest() {\n  const m = load().fn_manifest;\n  return m && typeof m === 'object' && Object.keys(m).length ? m : null;\n}\nexport function entryLocation(identity) {\n  const m = load().entries;\n  const v = m && typeof m === 'object' && identity ? m[identity] : null;\n  return typeof v === 'string' ? v : null;\n}\n`;
+	if (!ssr) return dedent`
+			export function islandDeps(_entry) { return []; }
+			export function islandCss(_entry) { return []; }
+			export function islandCssInline(_href) { return null; }
+			export function contentCss(_id) { return []; }
+			export function islandReadsPage(_entry) { return false; }
+			export function islandPageKeys(_entry) { return null; }
+			export function islandPageWhy(_entry) { return null; }
+			export function islandRemotes(_entry) { return null; }
+			export function islandInteractivity(_entry) { return null; }
+			export function islandHazards(_entry) { return null; }
+			export function chunkContents(_href) { return null; }
+			export function chunkHeavy(_href) { return null; }
+			export function chunkBarrels(_href) { return null; }
+			export function chunkDuplicates() { return null; }
+			export function fnManifest() { return null; }
+			export function entryLocation(_identity) { return null; }
+			export function locationMap() { return null; }
+		`;
+	if (is_dev) return dedent`
+			export function islandDeps(_entry) { return []; }
+			export function islandCss(entry) { return entry ? [entry] : []; }
+			export function islandCssInline(_href) { return null; }
+			export function contentCss(_id) { return []; }
+			export function islandReadsPage(_entry) { return true; }
+			export function islandPageKeys(_entry) { return null; }
+			export function islandPageWhy(_entry) { return null; }
+			export function islandRemotes(_entry) { return null; }
+			export function islandInteractivity(_entry) { return null; }
+			export function islandHazards(_entry) { return null; }
+			export function chunkContents(_href) { return null; }
+			export function chunkHeavy(_href) { return null; }
+			export function chunkBarrels(_href) { return null; }
+			export function chunkDuplicates() { return null; }
+			export function fnManifest() { return null; }
+			export function entryLocation(identity) { return identity || null; }
+			export function locationMap() { return null; }
+		`;
+	const out_dir = JSON.stringify(out_dir_rel);
+	return dedent`
+		import fs from 'node:fs';
+		import path from 'node:path';
+		import { fileURLToPath } from 'node:url';
+
+		// PRIMARY source: a string slot the client build patches in place with the manifest JSON (see
+		// writeBundle). Inlined into the server bundle, it survives serverless tracing: Vercel/Netlify
+		// (@vercel/nft) bundle only imported files, not runtime fs reads, so the co-located JSON below
+		// is dropped there. The fs walk stays the fallback for adapter-node and dev-preview (the whole
+		// server dir ships). Unpatched, the token starts with '_' (char 95), the guard is false, and
+		// the walk runs. A bad patch degrades to the walk, never crashes the server at import.
+		const __OG_INLINE = '__OGYGIA_ISLAND_DEPS_INLINE__';
+		let cache = null;
+		try { if (__OG_INLINE.charCodeAt(0) === 123) cache = JSON.parse(__OG_INLINE); } catch {}
+
+		function candidates() {
+			const out = [];
+			try {
+				let dir = path.dirname(fileURLToPath(import.meta.url));
+				for (let i = 0; i < 8; i++) {
+					out.push(path.join(dir, 'og-region-deps.json'));
+					const parent = path.dirname(dir);
+					if (parent === dir) break;
+					dir = parent;
+				}
+			} catch {}
+			if (typeof process !== 'undefined' && process.cwd) {
+				const cwd = process.cwd();
+				out.push(path.join(cwd, ${out_dir}, 'og-region-deps.json'));
+				out.push(path.join(cwd, ${out_dir}, 'output', 'server', 'og-region-deps.json'));
+			}
+			return out;
+		}
+
+		function load() {
+			if (cache) return cache;
+			for (const p of candidates()) {
+				try { cache = JSON.parse(fs.readFileSync(p, 'utf8')); return cache; } catch {}
+			}
+			cache = {};
+			return cache;
+		}
+
+		// Handoff shape: { js: { entryUrl: [...] }, css: { entryUrl: [...] } }. A stale flat
+		// map (pre-css build) degrades gracefully: js falls back to the root, css to [].
+		function pick(kind, entry) {
+			const all = load();
+			const map = all && typeof all[kind] === 'object' ? all[kind] : kind === 'js' ? all : null;
+			const list = map ? map[entry] : null;
+			return Array.isArray(list) ? list : [];
+		}
+
+		/** One entry of a handoff map (\`field\`), or null: no map, no key, or the wrong shape. */
+		function lookup(field, key, ok) {
+			const all = load();
+			const map = all && typeof all[field] === 'object' && all[field] ? all[field] : null;
+			if (!map || !key) return null;
+			const v = map[key];
+			return ok(v) ? v : null;
+		}
+
+		/** A chunk href's key: root-absolute, as the build wrote it. */
+		function chunk_key(href) {
+			return href.startsWith('/') ? href : '/' + href.replace(/^\\.\\//, '');
+		}
+
+		export function islandDeps(entry) {
+			return entry ? pick('js', entry) : [];
+		}
+
+		export function islandCss(entry) {
+			return entry ? pick('css', entry) : [];
+		}
+
+		// INLINE REGION CSS: the text of a region CSS asset the build kept under Kit's
+		// inlineStyleThreshold (collect_inline_css), keyed by the same public href islandCss hands
+		// out. null = link it (over the threshold, no threshold, or a pre-inline handoff).
+		export function islandCssInline(href) {
+			return lookup('css_inline', href, (v) => typeof v === 'string');
+		}
+
+		export function contentCss(id) {
+			return id ? pick('content_css', id) : [];
+		}
+
+		// Does this island's client closure read $page? FAIL-OPEN: no map (a pre-page handoff), or an
+		// entry the build never saw (a foreign fragment's island mounted from another app) → true, so
+		// the seed ships and nothing that might read it finds it missing.
+		export function islandReadsPage(entry) {
+			const all = load();
+			const map = all && typeof all.page === 'object' && all.page ? all.page : null;
+			if (!map || !entry) return true;
+			const v = map[entry];
+			return v === undefined ? true : !!v;
+		}
+
+		// SEED SHAPING: which top-level page.data keys this island's closure reads. FAIL-OPEN as null
+		// ("ship all"): no map (a pre-shaping handoff), an entry the build never saw, or a closure
+		// whose reads could not be pinned to literal keys.
+		export function islandPageKeys(entry) {
+			return lookup('page_keys', entry, Array.isArray);
+		}
+
+		// Why this island ships all of page.data: the modules in its closure whose reads the build
+		// could not pin (file, line, why). Profiler builds only; null = none recorded.
+		export function islandPageWhy(entry) {
+			return lookup('page_why', entry, Array.isArray);
+		}
+
+		// Which remotes (Kit id-hashes) this island's client closure can call: REMOTE SEED ONLY WHEN
+		// REACHABLE. FAIL-OPEN as null ("may call anything"): no map (a pre-remotes handoff), or an
+		// entry the build never saw (a foreign fragment's island) → every SSR-resolved remote seeds.
+		export function islandRemotes(entry) {
+			return lookup('remotes', entry, Array.isArray);
+		}
+
+		// WAKE ADVISOR facts per entry (handlers / $state / bind: counts over the island's own
+		// components), for the profiler's Islands table. null = the handoff has none.
+		export function islandInteractivity(entry) {
+			return lookup('interactivity', entry, (v) => !!v && typeof v === 'object');
+		}
+
+		// each island's lines that draw differently in the browser (the profiler's mismatch findings)
+		export function islandHazards(entry) {
+			return lookup('hazards', entry, Array.isArray);
+		}
+
+		// WHAT IS INSIDE a chunk (readable source list): the profiler names hashed chunks with it
+		export function chunkContents(href) {
+			const all = load();
+			const map = all && typeof all.contents === 'object' && all.contents ? all.contents : null;
+			if (!map || !href) return null;
+			const v = map[chunk_key(href)] ?? map[href];
+			return Array.isArray(v) ? v : null;
+		}
+
+		// …and its heaviest modules with their rendered bytes (the report's heavy-module finding)
+		export function chunkHeavy(href) {
+			const all = load();
+			const map = all && typeof all.heavy === 'object' && all.heavy ? all.heavy : null;
+			if (!map || !href) return null;
+			const v = map[chunk_key(href)] ?? map[href];
+			return v && typeof v === 'object' && Array.isArray(v.top) ? v : null;
+		}
+
+		// …and the re-export barrels it still holds (the report's island-barrel note)
+		export function chunkBarrels(href) {
+			const all = load();
+			const map = all && typeof all.barrels === 'object' && all.barrels ? all.barrels : null;
+			if (!map || !href) return null;
+			const v = map[chunk_key(href)] ?? map[href];
+			return Array.isArray(v) ? v : null;
+		}
+
+		// the modules the build shipped twice, each copy's chunk (the report's duplicate-module finding)
+		export function chunkDuplicates() {
+			const all = load();
+			const v = all && Array.isArray(all.dupes) ? all.dupes : null;
+			return v && v.length ? v : null;
+		}
+
+		// og.$ factories for the page-inline registration script (CSP-clean prod path): written by
+		// the CLIENT build's writeBundle, read here at SSR render time, the same ordering-safe channel
+		// islandCss uses.
+		export function fnManifest() {
+			const m = load().fn_manifest;
+			return m && typeof m === 'object' && Object.keys(m).length ? m : null;
+		}
+
+		// IDENTITY → LOCATION: the content-hashed file an entry (an island's stable URL, the runtime's)
+		// is served from. null = no location known (a handoff from before hashing, a foreign island):
+		// the identity itself is written, and the browser finds it in the build's location maps.
+		export function entryLocation(identity) {
+			const m = load().entries;
+			const v = m && typeof m === 'object' && identity ? m[identity] : null;
+			return typeof v === 'string' ? v : null;
+		}
+
+		// The build's content-hashed location map (link/location-map.ts), the file the browser reads:
+		// its served path, base-less (asset() adds it), or null (no island, a handoff from before it).
+		export function locationMap() {
+			const v = load().locations;
+			return typeof v === 'string' ? v : null;
+		}
+	`;
 }
 export { chunk_module_bytes, collectIslandDepModulepreloads, collect_inline_css, duplicate_modules, interactivity_facts, islandDepsHandoffPath, island_deps_module, kit_remote_hash, module_key, module_origin, remote_hash_of, summarize_chunk_contents };

package/dist/compiler/link/location-map.d.ts

@@ -0,0 +1,10 @@
+/** The fixed-name map's file, in the app dir (beside Kit's `version.json`). */
+export declare const CURRENT_LOCATIONS_FILE = "ogygia.json";
+/**
+ * Both maps, as output files: the content-hashed one first. `pairs`: identity file → hashed file,
+ * output-relative. Empty when there is nothing to map.
+ */
+export declare function location_map_files(app_dir: string, pairs: Iterable<readonly [string, string]>, hash: (source: string) => string): {
+  fileName: string;
+  source: string;
+}[];

package/dist/compiler/link/location-map.js

@@ -0,0 +1,53 @@
+import { path } from "../host.js";
+// src/compiler/link/location-map.ts
+/**
+* THE LOCATION MAPS. Island entries are content-hashed files under `immutable/`; an island's IDENTITY
+* (`<appDir>/ogygia/og-region.<iid>.js`, the name every key uses) is a name, not a file. The build
+* writes its identity → location pairs twice, as the same map:
+*
+*  - `<appDir>/immutable/og-locations.<hash>.json`, named by its content. The runtime's script names
+*    it (`data-og-locations`), and a load that arrives with an identity alone (a region the browser
+*    rendered, a held region from the wire, a portable snippet) reads it: this build's locations, for
+*    this build's page.
+*  - `<appDir>/ogygia.json`, the ONE file at a fixed name: the current build's, beside Kit's own
+*    `<appDir>/version.json` and found from an identity alone (its app dir is the identity's, so any
+*    app's is found). A page that outlived its build reads it when its own files are gone, and wakes
+*    on the current code. Outside `immutable/`: a host revalidates it, as it does Kit's.
+*
+* Every other file the build writes is named by its content and lives in `immutable/`, so a host's
+* year-long rule fits all of them; no directory of ogygia's own is written (`ogygia/` in an identity
+* is a name). Both sides of each pair are written relative to the file holding them: the browser
+* resolves them against wherever the build is served (a base, an assets CDN), and an identity that
+* resolves elsewhere (another app's) never matches.
+*/
+/** The fixed-name map's file, in the app dir (beside Kit's `version.json`). */
+const CURRENT_LOCATIONS_FILE = "ogygia.json";
+/** A path from `from_file`'s directory to `to_file` (both output-relative), always dot-led. */
+function relative_specifier(from_file, to_file) {
+	const rel = path.posix.relative(path.posix.dirname(from_file), to_file);
+	return rel.startsWith(".") ? rel : "./" + rel;
+}
+function map_source(file, pairs) {
+	const map = {};
+	for (const [identity, location] of pairs) map[relative_specifier(file, identity)] = relative_specifier(file, location);
+	return JSON.stringify(map);
+}
+/**
+* Both maps, as output files: the content-hashed one first. `pairs`: identity file → hashed file,
+* output-relative. Empty when there is nothing to map.
+*/
+function location_map_files(app_dir, pairs, hash) {
+	const list = [...pairs];
+	if (!list.length) return [];
+	const hashed_dir = `${app_dir}/immutable`;
+	const hashed_source = map_source(hashed_dir + "/og-locations.json", list);
+	const current = `${app_dir}/${CURRENT_LOCATIONS_FILE}`;
+	return [{
+		fileName: `${hashed_dir}/og-locations.${hash(hashed_source)}.json`,
+		source: hashed_source
+	}, {
+		fileName: current,
+		source: map_source(current, list)
+	}];
+}
+export { CURRENT_LOCATIONS_FILE, location_map_files };

package/dist/compiler/link/manifest.js

@@ -1,9 +1,13 @@
+import { dedent } from "../dedent.js";
 // src/compiler/link/manifest.ts
 /**
 * `virtual:ogygia/manifest` emitter — a legacy stub. Hydrate modules are loaded via
 * `<ogygia-region entry>` URLs, not this map; only the `dev` flag is still read.
 */
 function manifest_module(is_dev) {
-	return `export const dev = ${is_dev ? "true" : "false"};\nexport const regions = {};`;
+	return dedent`
+		export const dev = ${is_dev ? "true" : "false"};
+		export const regions = {};
+	`;
 }
 export { manifest_module };

package/dist/compiler/link/runtime-entry.d.ts

@@ -20,8 +20,13 @@ export type RuntimeMarks = {
    *  driver's import scan; gates the cross-island context bridge (~4.7 kB) out of apps that never
    *  provide context. Read-only providers (`getContext`) don't set it — there's nothing to bridge. */
   context?: boolean;
+  /** Island code can reach Kit's page world: `$app/state` / `$app/stores` / `$app/navigation`
+   *  (anything under `$app/` but `environment` and `paths`), or code the driver's island-closure walk
+   *  cannot follow (a package, an unresolvable import), or a client plugin / federation that hands
+   *  the runtime islands the walk never saw. Gates the page seed and the MPA navigation handle. */
+  page?: boolean;
 };
-export type FeatureId = "remote-seeds" | "wire" | "frames" | "lakes" | "morph" | "live" | "interaction" | "forms" | "router" | "context";
+export type FeatureId = "remote-seeds" | "page" | "wire" | "wire-classes" | "frames" | "lakes" | "morph" | "live" | "interaction" | "forms" | "mpa-nav" | "router" | "context";
 /**
  * WHICH CHUNK a feature lives in. The runtime ships as two static, feature-sized phases:
  *
@@ -68,4 +73,16 @@ export declare function generateRuntimeEntrySource(marks: RuntimeMarks, runtimeD
 export declare function generateHydrateFeaturesSource(marks: RuntimeMarks, runtimeDir: string, all?: boolean): {
   code: string;
   features: FeatureId[];
-};
+};
+/**
+ * Emit `virtual:ogygia/runtime-flags`: build-time constants for code that lives INSIDE the always-on
+ * region element rather than in a feature module, because it works on the element's own state. The
+ * bundler inlines an imported `const` and drops the branches it switches off, so the code a flag
+ * guards ships exactly when the feature it serves does. Same marks as the entries; `all` (dev / no
+ * marks): every flag on.
+ *
+ * - `FRAMES`: the `frames` feature is in the build — some region streams HTML (a deferred hole, a
+ *   live region, a lake). Without the frame store a region's fetch has nowhere to land, so the
+ *   element's fetch / apply / morph / renew path is dead code then.
+ */
+export declare function generateRuntimeFlagsSource(marks: RuntimeMarks, all?: boolean): string;