@ogygia/core 0.12.2 → 0.13.0

package/dist/vite/index.js

@@ -4,8 +4,8 @@ import { island_sourcemaps_plugin } from "./sourcemaps.js";
 import { server_sourcemaps_plugin } from "./server-sourcemaps.js";
 import { install_dev_client_maps, install_dev_maps, install_dev_page_keys } from "./dev-maps.js";
 import { CLIENT_BINDING_STUB, DEFAULT_IMPORT_KEYS, asRegionLocals, import_keys_hint, is_island_path, islandChunkFileName, islandId, islandPublicUrl, normalize_import_keys, wrapperVirtualId } from "../compiler/region/transform.js";
-import { regionId, regionIdentity, strategyKey } from "../compiler/region/identity.js";
 import { rewrite_lake_import_to_placeholder } from "../compiler/region/emit.js";
+import { regionId, regionIdentity, strategyKey } from "../compiler/region/identity.js";
 import { debarrel } from "../compiler/debarrel/plugin.js";
 import { definePlugin, find_plugins, resolve_plugins } from "./plugin-api.js";
 import { assert_no_legacy_options, resolve_options, validate_region_presets } from "./options.js";
@@ -16,7 +16,7 @@ import { fill_profiler_maps } from "./profiler-maps.js";
 import { DEFAULT_REGION_TTL_SEC } from "../server/endpoint.js";
 import { RENEW_WINDOW_SEC } from "../server/shared-cache.js";
 import { derive_id_salt, secret_has_min_entropy } from "../server/hmac.js";
-import { buildFoucCssModuleSource, collectFoucCssReachable, compileFoucScopedCss, foucRelFromId, isFoucCssId, isFoucScopedId } from "../compiler/fouc-css.js";
+import { buildFoucCssModuleSource, collectFoucCssReachable, compileFoucScopedCss, foucRelFromId, isFoucCssId, isFoucScopedId, svelteHasStyle } from "../compiler/fouc-css.js";
 import { preprocess_component_for_css } from "./style-preprocess.js";
 import { needs_csr_false_full_reload, needs_island_entry_full_reload } from "../compiler/dev/hmr.js";
 import { derive_css_scope_owners } from "../compiler/dev/css-scope.js";
@@ -34,7 +34,8 @@ import { async_twin_redirect, svelte_async_enabled } from "./late-island.js";
 import { flags_manifest } from "../compiler/flags.js";
 import { RESOLVED, V_ROUTER_CSS, V_ROUTE_CONFIG, V_ROUTE_CSR, V_SERVER_ISLANDS, V_SERVER_MANIFEST } from "../compiler/ids.js";
 import { OWN_PACKAGE_NAMES, is_own_specifier } from "../own-package.js";
-import { APP_SHIMS, CLIENT_BINDING_STUB_FILE, HMAC_MODULE, KIT_REMOTE_CLIENT, KIT_REMOTE_STATE, OGYGIA_INJECTED_FILES, OGYGIA_INJECTED_IMPORTS, OGYGIA_REGION_MODULES, PKG_ROOT, PKG_ROOT_ID, REGION_ENDPOINT_MODULE, RUNTIME_DIR, RUNTIME_HASH, STUB_CLIENT, STUB_PATHS, STUB_STATE, real_posix, scan_entry_pattern } from "./paths.js";
+import { APP_SHIMS, CLIENT_BINDING_STUB_FILE, HMAC_MODULE, KIT_REMOTE_CLIENT, KIT_REMOTE_STATE, OGYGIA_INJECTED_FILES, OGYGIA_INJECTED_IMPORTS, OGYGIA_REGION_MODULES, OGYGIA_VERSION, PKG_ROOT, PKG_ROOT_ID, REGION_ENDPOINT_MODULE, RUNTIME_DIR, RUNTIME_HASH, STUB_CLIENT, STUB_PATHS, STUB_STATE, real_posix, scan_entry_pattern } from "./paths.js";
+import { OgygiaError, line, warn } from "../messages/build.js";
 import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
@@ -44,6 +45,7 @@ import { loadEnv } from "vite";
 const KIT_CLIENT_APP_RE = /\/generated\/(?:build\/|dev\/)?client(-optimized)?\/app\.js$/;
 const ROUTE_HOST_OR_OPTION_RE = /[\\/]\+(page|layout)(\.server)?\.(svelte|js|ts)$/;
 const KIT_PAGE_THREAD = "\nimport { page as __og_kit_page, navigating as __og_kit_nav } from '$app/state';\nimport * as __og_kit_navigation from '$app/navigation';\nglobalThis[Symbol.for('ogygia.kit-page')] = { page: __og_kit_page, navigating: __og_kit_nav, navigation: __og_kit_navigation };\n";
+const KIT_DISCLOSE_VERSION = `((globalThis.__ogygia ??= {}).v ??= new Set()).add(${JSON.stringify(OGYGIA_VERSION)});\n`;
 /** css-ish file the dev bridge manages (mirrors the bridge's glob). */
 const DEV_CSS_FILE_RE = /\.(css|scss|sass|less|styl)$/;
 const CSS_EXT_RE = /\.css$/;
@@ -104,6 +106,31 @@ function ogygia(options = {}) {
 	let id_salt = "";
 	/** content_css_key → emitted CSS asset referenceId (client leg). Resolved to hrefs in writeBundle. */
 	const content_css_refs = /* @__PURE__ */ new Map();
+	const compiled_css = /* @__PURE__ */ new Map();
+	const tree_css_walk = (ctx) => {
+		const walk_resolve = bundler_resolve(ctx);
+		return async (abs, opts = {}) => {
+			const { own, skip } = opts;
+			const parts = [];
+			for (const e of await collectFoucCssReachable(abs, {
+				root,
+				libDir,
+				readFile: own == null ? readFile : (p) => p === abs ? own : readFile(p),
+				alias: resolve_alias,
+				resolve: walk_resolve
+			})) {
+				if (own != null && e.abs === abs || skip?.(e.abs)) continue;
+				let css = compiled_css.get(e.abs);
+				if (css === void 0) {
+					const src = readFile(e.abs);
+					css = src == null ? null : e.kind === "scoped" ? compileFoucScopedCss(e.abs, await preprocess_component_for_css(src, e.abs, root), { keepScript: true }) : CSS_EXT_RE.test(e.abs) ? src : null;
+					compiled_css.set(e.abs, css);
+				}
+				if (css) parts.push(css);
+			}
+			return parts.join("\n");
+		};
+	};
 	/** router-css `rcss:<rel>` key → emitted CSS asset referenceId (client leg). A server router page
 	*  component's whole-tree scoped CSS, compiled + emitted as a dedicated asset (link/router-css.ts). */
 	const router_css_refs = /* @__PURE__ */ new Map();
@@ -265,9 +292,11 @@ function ogygia(options = {}) {
 							__OGYGIA_SERVER_DELTA__: JSON.stringify(server_delta),
 							__OGYGIA_DEVTOOLS__: JSON.stringify(devtools_effective),
 							__OGYGIA_DEVTOOLS_LAZY__: JSON.stringify(devtools_lazy),
+							__OGYGIA_RULES__: JSON.stringify(process.env.OGYGIA_RULES === "1"),
 							__OGYGIA_BEACON__: JSON.stringify(measure || devtools_effective),
 							__OGYGIA_CLIENT_PLUGINS__: JSON.stringify(client_plugins.length > 0),
-							__OGYGIA_KIT_MAJOR__: JSON.stringify(kit_major(path.resolve(userConfig.root ?? ".")))
+							__OGYGIA_KIT_MAJOR__: JSON.stringify(kit_major(path.resolve(userConfig.root ?? "."))),
+							__OGYGIA_VERSION__: JSON.stringify(OGYGIA_VERSION)
 						},
 						server: { fs: { allow: [PKG_ROOT] } },
 						build: { rolldownOptions: { preserveEntrySignatures: "exports-only" } }
@@ -280,7 +309,10 @@ function ogygia(options = {}) {
 				svelte_async = svelte_async_enabled(config.plugins);
 				if (config.command === "serve") {
 					const own = (config.optimizeDeps?.include ?? []).filter((d) => is_own_specifier(d));
-					if (own.length) config.logger.warn(`[ogygia] optimizeDeps.include lists ${own.join(", ")}: ogygia must not be pre-bundled in dev (the page would run two copies of its runtime, and islands with snippet props fail to hydrate). Remove ${own.length === 1 ? "it" : "them"}.`);
+					if (own.length) config.logger.warn(line("optimize_deps_includes_ogygia", {
+						specifiers: own.join(", "),
+						count: own.length
+					}));
 				}
 				const app_dir_define = config.define?.["__SVELTEKIT_APP_DIR__"];
 				if (typeof app_dir_define === "string") try {
@@ -313,7 +345,7 @@ function ogygia(options = {}) {
 				}
 				const env_secret = process.env.OGYGIA_SECRET?.trim() || "";
 				if (env_secret) {
-					if (is_build && !secret_has_min_entropy(env_secret)) throw new Error(`[ogygia] OGYGIA_SECRET is too short for production builds (need ≥16 UTF-8 bytes).`);
+					if (is_build && !secret_has_min_entropy(env_secret)) throw new OgygiaError("secret_too_short", { min_bytes: 16 });
 					id_salt = derive_id_salt(env_secret);
 				} else id_salt = "";
 				({kit_wire_path, kit_remote_index, universal_hooks, client_hooks, kit_transport_init} = resolve_kit_paths(root));
@@ -393,86 +425,33 @@ function ogygia(options = {}) {
 						emitRuntime: emit_runtime,
 						loaded
 					});
-					if (skipped && isMainThread) console.log(`[ogygia] ${skipped} island chunk(s) not emitted: their host modules are not in the server bundle (unreachable from this build's routes).`);
+					if (skipped && isMainThread) console.log(line("island_chunks_not_emitted", { count: skipped }));
+					compiled_css.clear();
+					const tree_css = tree_css_walk(this);
 					router_css_refs.clear();
-					const walk_resolve = bundler_resolve(this);
 					for (const abs of compiler.router_css_roots()) {
-						const parts = [];
-						for (const e of await collectFoucCssReachable(abs, {
-							root,
-							libDir,
-							readFile,
-							alias: resolve_alias,
-							resolve: walk_resolve
-						})) if (e.kind === "scoped") {
-							const src = readFile(e.abs);
-							if (src == null) continue;
-							const css = compileFoucScopedCss(e.abs, await preprocess_component_for_css(src, e.abs, root), { keepScript: true });
-							if (css) parts.push(css);
-						} else if (CSS_EXT_RE.test(e.abs)) {
-							const css = readFile(e.abs);
-							if (css) parts.push(css);
-						}
-						if (!parts.length) continue;
-						const ref = this.emitFile({
+						const source = await tree_css(abs);
+						if (source) router_css_refs.set(router_css_key(root, abs), this.emitFile({
 							type: "asset",
 							name: "og-rcss.css",
-							source: parts.join("\n")
-						});
-						router_css_refs.set(router_css_key(root, abs), ref);
+							source
+						}));
 					}
 					hole_css_refs.clear();
 					const hole_css_by_abs = /* @__PURE__ */ new Map();
 					for (const { iid, abs } of compiler.server_island_css_roots()) {
 						let ref = hole_css_by_abs.get(abs);
 						if (ref === void 0) {
-							const parts = [];
-							for (const e of await collectFoucCssReachable(abs, {
-								root,
-								libDir,
-								readFile,
-								alias: resolve_alias,
-								resolve: walk_resolve
-							})) if (e.kind === "scoped") {
-								const src = readFile(e.abs);
-								if (src == null) continue;
-								const css = compileFoucScopedCss(e.abs, await preprocess_component_for_css(src, e.abs, root), { keepScript: true });
-								if (css) parts.push(css);
-							} else if (CSS_EXT_RE.test(e.abs)) {
-								const css = readFile(e.abs);
-								if (css) parts.push(css);
-							}
-							ref = parts.length ? this.emitFile({
+							const source = await tree_css(abs);
+							ref = source ? this.emitFile({
 								type: "asset",
 								name: "og-hole.css",
-								source: parts.join("\n")
+								source
 							}) : "";
 							hole_css_by_abs.set(abs, ref);
 						}
 						if (ref) hole_css_refs.set(iid, ref);
 					}
-					content_css_refs.clear();
-					const styles = markup.flatMap((m) => m.styles ? [...m.styles] : []);
-					if (styles.length) {
-						const { compile } = await import("svelte/compiler");
-						for (const [abs, source] of styles) try {
-							const { css } = compile(source, {
-								filename: abs,
-								css: "external",
-								dev: false,
-								generate: "client",
-								experimental: { async: true }
-							});
-							if (css?.code) {
-								const ref = this.emitFile({
-									type: "asset",
-									name: "og-content.css",
-									source: css.code
-								});
-								content_css_refs.set(content_css_key(abs), ref);
-							}
-						} catch {}
-					}
 				}
 			},
 			configureServer(server) {
@@ -532,7 +511,7 @@ function ogygia(options = {}) {
 					fs.mkdirSync(path.dirname(handoff), { recursive: true });
 					fs.writeFileSync(handoff, JSON.stringify(compiler.ssr_transformed_hosts()));
 				} catch (e) {
-					if (isMainThread) console.warn("[ogygia] could not write the server-leg island handoff:", e);
+					if (isMainThread) warn("island_handoff_write_failed", e);
 				}
 				if (__P) {
 					const keys = [...__outHash.keys()].sort();
@@ -599,7 +578,7 @@ function ogygia(options = {}) {
 				}
 				const ssr = options?.ssr === true;
 				if (!ssr && source === "__sveltekit/remote") {
-					if (!kit_remote_index) throw new Error("[ogygia] could not locate Kit's client remote-functions (src). Use an @sveltejs/kit that publishes its `src/` (2.70.2 or later, or 3.x).");
+					if (!kit_remote_index) throw new OgygiaError("kit_remote_src_missing");
 					return kit_remote_index;
 				}
 				if (!ssr && importer && importer.includes("/remote-functions/")) {
@@ -669,7 +648,7 @@ function ogygia(options = {}) {
 			},
 			async transform(code, id, options) {
 				let source = code;
-				if (!options?.ssr && KIT_CLIENT_APP_RE.test(id)) source += KIT_PAGE_THREAD;
+				if (!options?.ssr && KIT_CLIENT_APP_RE.test(id)) source += KIT_PAGE_THREAD + KIT_DISCLOSE_VERSION;
 				const result = await compiler.transform_module(source, id, {
 					ssr: options?.ssr === true,
 					emitFile: (chunk) => this.emitFile(chunk)
@@ -699,13 +678,43 @@ function ogygia(options = {}) {
 					chunkFileNames: ours(output.chunkFileNames, "[name]-[hash].js")
 				};
 			},
-			generateBundle() {
+			async generateBundle() {
 				if (!is_build || server_leg_of(this)) return;
 				for (const file of compiler.location_maps((ref) => this.getFileName(ref))) this.emitFile({
 					type: "asset",
 					fileName: file.fileName,
 					source: file.source
 				});
+				content_css_refs.clear();
+				const modules = markup.flatMap((m) => m.modules ? [...m.modules] : []);
+				if (!modules.length) return;
+				const client = /* @__PURE__ */ new Set();
+				for (const id of this.getModuleIds()) client.add(path.normalize(id.split("?")[0]));
+				const tree_css = tree_css_walk(this);
+				const { compile } = await import("svelte/compiler");
+				for (const [abs, source] of modules) try {
+					let own = "";
+					if (svelteHasStyle(source)) {
+						const { css } = compile(source, {
+							filename: abs,
+							css: "external",
+							dev: false,
+							generate: "client",
+							experimental: { async: true }
+						});
+						own = css?.code ?? "";
+					}
+					const tree = await tree_css(abs, {
+						own: source,
+						skip: (p) => client.has(p)
+					});
+					const css = [own, tree].filter(Boolean).join("\n");
+					if (css) content_css_refs.set(content_css_key(abs), this.emitFile({
+						type: "asset",
+						name: "og-content.css",
+						source: css
+					}));
+				} catch {}
 			},
 			closeBundle: {
 				order: "pre",
@@ -737,7 +746,7 @@ function ogygia(options = {}) {
 					fs.mkdirSync(dir, { recursive: true });
 					const manifest = flags_manifest(program.flag_sites);
 					fs.writeFileSync(path.join(dir, "flags-manifest.json"), JSON.stringify(manifest, null, "	") + "\n");
-					console.log(`[ogygia] flags manifest: ${manifest.names.length} flag(s) → node_modules/.ogygia/flags-manifest.json`);
+					console.log(line("flags_manifest_written", { count: manifest.names.length }));
 				} catch {}
 				await follow_pending_page_calls(program, (s, importer) => this.resolve(s, importer));
 				const remote_hash = (id) => remote_hash_of(id, process.cwd());

package/dist/vite/kit-dirs.js

@@ -1,4 +1,5 @@
 import { DEFAULT_KIT_DIRS, set_kit_dirs, set_kit_inline_style_threshold } from "../compiler/kit.js";
+import { warn } from "../messages/build.js";
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
@@ -47,7 +48,12 @@ async function kit_options_from_file(root) {
 	try {
 		return (await import(pathToFileURL(file).href)).default?.kit ?? {};
 	} catch (e) {
-		console.warn(`[ogygia] could not read ${path.relative(root, file)} for kit.files.routes / kit.outDir — using the defaults (${DEFAULT_KIT_DIRS.routes}, ${DEFAULT_KIT_DIRS.out}). ${e instanceof Error ? e.message : String(e)}`);
+		warn("kit_config_unreadable", {
+			file: path.relative(root, file),
+			routes: DEFAULT_KIT_DIRS.routes,
+			out: DEFAULT_KIT_DIRS.out,
+			reason: e instanceof Error ? e.message : String(e)
+		});
 		return null;
 	}
 }

package/dist/vite/options.d.ts

@@ -178,7 +178,8 @@ export interface OgygiaOptions {
    */
   standalone?: boolean;
 }
-/** The rename map: a legacy key errors with its new spelling, never silently no-ops. */
+/** The rename map (`RETIRED_OPTIONS`, with the messages): a legacy key errors with its new
+ *  spelling, never silently no-ops. */
 export declare function assert_no_legacy_options(options: OgygiaOptions): void;
 /**
  * Config-time region-preset validation — the transform re-checks on USE (with file/line context), but

package/dist/vite/options.js

@@ -1,22 +1,9 @@
+import { OgygiaError, RETIRED_OPTIONS } from "../messages/build.js";
 // src/vite/options.ts
-/**
-* Retired option spellings. Detected at config load and answered with the exact new spelling — a
-* rename map, never silent aliasing (a legacy key that silently did nothing would un-tune real apps).
-*/
-const LEGACY_OPTION_RENAMES = {
-	regions: "`regions` is gone — its keys sit at the root now: write `visible`, `presets`, `ttl` and `maxPageAge` directly in `ogygia({ … })`.",
-	continuity: "`continuity` is gone — form continuity rides the router. Write `router: { forms: false }` to disable it.",
-	regionTtl: "`regionTtl` is `ttl` now — write `ogygia({ ttl: … })`.",
-	preload: "`preload` is gone — there is nothing to choose any more. The page carries each island’s chunk list as data, and the runtime preloads an island’s whole graph when it wakes (after the page has painted), so no island code moves before its wake and none waits on a waterfall after it. Remove the key.",
-	plugins: "`plugins` is gone — ogygia plugins are Vite plugins: list them beside `ogygia()` in vite.config, `plugins: [ogygia(), flags(), sveltekit()]`.",
-	freeze: "`freeze` is a plugin now, named postrender — install `@ogygia/postrender` and list `postrender({ ttl, default })` (from `@ogygia/postrender/vite`) beside `ogygia()` in vite.config `plugins`.",
-	content: "`content` is a plugin now — install `@ogygia/content` and list `content({ markdown, presets })` (from `@ogygia/content/vite`) beside `ogygia()` in vite.config `plugins`; the svelte config takes `preprocess()` / `extensions()` from there too.",
-	devtools: "`devtools` is a plugin now — install `@ogygia/devtools` and list `devtools()` (from `@ogygia/devtools/vite`) beside `ogygia()` in vite.config `plugins`; only where you want it, e.g. `...(mode !== 'production' ? [devtools()] : [])`.",
-	profiler: "`profiler` is part of the devtools plugin now — install `@ogygia/devtools` and list `devtools({ profiler: { … } })` (from `@ogygia/devtools/vite`) beside `ogygia()` in vite.config `plugins`."
-};
-/** The rename map: a legacy key errors with its new spelling, never silently no-ops. */
+/** The rename map (`RETIRED_OPTIONS`, with the messages): a legacy key errors with its new
+*  spelling, never silently no-ops. */
 function assert_no_legacy_options(options) {
-	for (const key of Object.keys(LEGACY_OPTION_RENAMES)) if (key in options) throw new Error(`[ogygia] ${LEGACY_OPTION_RENAMES[key]}`);
+	for (const key of Object.keys(RETIRED_OPTIONS)) if (key in options) throw new OgygiaError("option_retired", { option: key });
 }
 const REGION_PRESET_KEYS = /* @__PURE__ */ new Set([
 	"render",
@@ -36,8 +23,12 @@ const REGION_PRESET_KEYS = /* @__PURE__ */ new Set([
 */
 function validate_region_presets(presets) {
 	for (const [name, bag] of Object.entries(presets)) {
-		if (!bag || typeof bag !== "object" || Object.keys(bag).length === 0) throw new Error(`[ogygia] presets.${name} is empty — a preset with nothing is a mistake.`);
-		for (const k of Object.keys(bag)) if (!REGION_PRESET_KEYS.has(k)) throw new Error(`[ogygia] presets.${name}: unknown key \`${k}\`. A preset takes ${[...REGION_PRESET_KEYS].join(", ")}.`);
+		if (!bag || typeof bag !== "object" || Object.keys(bag).length === 0) throw new OgygiaError("preset_empty", { name });
+		for (const k of Object.keys(bag)) if (!REGION_PRESET_KEYS.has(k)) throw new OgygiaError("preset_key_unknown", {
+			name,
+			key: k,
+			allowed: [...REGION_PRESET_KEYS].join(", ")
+		});
 	}
 }
 /**
@@ -57,7 +48,7 @@ function resolve_options(options, defaultRegionTtl, defaultRenewWindow = 691200)
 	const session_cookie = typeof options.sessionCookie === "string" && options.sessionCookie.length > 0 ? options.sessionCookie : "";
 	const region_ttl = Math.min(86400, Math.max(60, Math.floor(options.ttl ?? defaultRegionTtl)));
 	const renew_raw = options.maxPageAge;
-	if (renew_raw !== void 0 && !(typeof renew_raw === "number" && Number.isFinite(renew_raw) && renew_raw >= 0)) throw new Error(`[ogygia] maxPageAge must be a number of seconds ≥ 0 (got ${String(renew_raw)}). Write e.g. \`30 * 24 * 3600\` for 30 days, or \`0\` to turn renewal off.`);
+	if (renew_raw !== void 0 && !(typeof renew_raw === "number" && Number.isFinite(renew_raw) && renew_raw >= 0)) throw new OgygiaError("max_page_age_invalid", { value: String(renew_raw) });
 	const renew_window = Math.min(31536e4, Math.floor(renew_raw ?? defaultRenewWindow));
 	const router_enabled = options.router !== false;
 	return {

package/dist/vite/package-files.js

@@ -1,4 +1,5 @@
 import { OWN_PACKAGE_NAMES } from "../own-package.js";
+import { OgygiaError, warn } from "../messages/build.js";
 import fs from "node:fs";
 import path from "node:path";
 import { globSync } from "tinyglobby";
@@ -37,7 +38,10 @@ function discover_package_files(app_root) {
 		const pkg_dir = path.join(app_root, "node_modules", ...name.split("/"));
 		const declared = (read_manifest(pkg_dir)?.ogygia)?.files;
 		if (declared == null) continue;
-		if (!Array.isArray(declared) || !declared.every((p) => typeof p === "string")) throw new Error(`[ogygia] ${name}: \`"ogygia": { "files": […] }\` must be an array of package-relative paths/globs (like npm's "files") — got ${JSON.stringify(declared)}.`);
+		if (!Array.isArray(declared) || !declared.every((p) => typeof p === "string")) throw new OgygiaError("package_files_not_array", {
+			package: name,
+			got: JSON.stringify(declared)
+		});
 		let root;
 		try {
 			root = fs.realpathSync(pkg_dir);
@@ -61,12 +65,18 @@ function discover_package_files(app_root) {
 				continue;
 			}
 			const abs = path.resolve(root, entry);
-			if (abs !== root && !abs.startsWith(root + path.sep)) throw new Error(`[ogygia] ${name}: ogygia.files entry '${entry}' escapes the package.`);
+			if (abs !== root && !abs.startsWith(root + path.sep)) throw new OgygiaError("package_files_escapes", {
+				package: name,
+				entry
+			});
 			let stat;
 			try {
 				stat = fs.statSync(abs);
 			} catch {
-				console.warn(`[ogygia] ${name}: ogygia.files entry '${entry}' does not exist — skipped.`);
+				warn("package_files_missing", {
+					package: name,
+					entry
+				});
 				continue;
 			}
 			if (stat.isDirectory()) dirs.push(posix(fs.realpathSync(abs)));

package/dist/vite/paths.d.ts

@@ -1,6 +1,8 @@
 /** This package's root (the plugin runs from `dist/vite/`, so `../..` is the package root). A NATIVE
  *  path (backslashes on Windows): for the file system, never to compare against a module id. */
 export declare const PKG_ROOT: string;
+/** This package's version, as installed (the runtime discloses it: runtime/disclose-version.ts). */
+export declare const OGYGIA_VERSION: string;
 /** A native path as Vite writes module ids: symlinks resolved (pnpm), forward slashes (Windows). */
 export declare function real_posix(p: string): string;
 /** A native directory as the PREFIX of the module ids inside it: `real_posix` + one trailing `/`, so a

package/dist/vite/paths.js

@@ -12,6 +12,8 @@ import { fileURLToPath } from "node:url";
 /** This package's root (the plugin runs from `dist/vite/`, so `../..` is the package root). A NATIVE
 *  path (backslashes on Windows): for the file system, never to compare against a module id. */
 const PKG_ROOT = fileURLToPath(new URL("../..", import.meta.url));
+/** This package's version, as installed (the runtime discloses it: runtime/disclose-version.ts). */
+const OGYGIA_VERSION = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, "package.json"), "utf8")).version;
 /** Windows separators → posix. */
 const WIN_SEP_RE = /\\/g;
 /** A native path as Vite writes module ids: symlinks resolved (pnpm), forward slashes (Windows). */
@@ -93,9 +95,7 @@ function runtime_content_hash() {
 		fileURLToPath(new URL("../keep-fallback-marker.js", import.meta.url)),
 		fileURLToPath(new URL("../shims/page-store.svelte.js", import.meta.url)),
 		fileURLToPath(new URL("../shims/kit-remote/client-stub.js", import.meta.url)),
-		fileURLToPath(new URL("../NestedProvider.svelte", import.meta.url)),
-		fileURLToPath(new URL("../LiveHost.svelte", import.meta.url)),
-		fileURLToPath(new URL("../KeepHost.svelte", import.meta.url))
+		fileURLToPath(new URL("../nested.js", import.meta.url))
 	];
 	try {
 		const rt_dir = fileURLToPath(new URL("../runtime", import.meta.url));
@@ -109,4 +109,4 @@ function runtime_content_hash() {
 }
 /** The runtime chunk's source-content hash (the immutable-filename base; feature hash rides on top). */
 const RUNTIME_HASH = runtime_content_hash();
-export { APP_SHIMS, CLIENT_BINDING_STUB_FILE, HMAC_MODULE, KIT_REMOTE_CLIENT, KIT_REMOTE_STATE, OGYGIA_INJECTED_FILES, OGYGIA_INJECTED_IMPORTS, OGYGIA_REGION_MODULES, PKG_ROOT, PKG_ROOT_ID, REGION_ENDPOINT_MODULE, RUNTIME_DIR, RUNTIME_HASH, STUB_CLIENT, STUB_PATHS, STUB_STATE, id_dir, real_posix, scan_entry_pattern };
+export { APP_SHIMS, CLIENT_BINDING_STUB_FILE, HMAC_MODULE, KIT_REMOTE_CLIENT, KIT_REMOTE_STATE, OGYGIA_INJECTED_FILES, OGYGIA_INJECTED_IMPORTS, OGYGIA_REGION_MODULES, OGYGIA_VERSION, PKG_ROOT, PKG_ROOT_ID, REGION_ENDPOINT_MODULE, RUNTIME_DIR, RUNTIME_HASH, STUB_CLIENT, STUB_PATHS, STUB_STATE, id_dir, real_posix, scan_entry_pattern };

package/dist/vite/plugin-api.d.ts

@@ -40,7 +40,7 @@ export interface MacroContext {
   readonly markupExts: readonly string[];
 }
 /** A source format that becomes Svelte only through a preprocessor (markdown → Svelte): how its
- *  islands and its modules' own scoped CSS reach the build. */
+ *  islands and its modules' CSS reach the build. */
 export interface MarkupSource {
   /** The format's file extensions (`['.svx', '.md']`). */
   extensions: readonly string[];
@@ -50,10 +50,11 @@ export interface MarkupSource {
     root: string;
     readFile(abs: string): string | null;
   }): void | Promise<void>;
-  /** Modules that carry their OWN scoped `<style>`, absolute path → their post-preprocess Svelte
-   *  source: the build compiles each one's CSS and ships it as a client asset (the module itself
-   *  only ever renders on the server). The plugin keeps filling this map; the build reads it late. */
-  styles?: ReadonlyMap<string, string>;
+  /** The format's modules, absolute path → their post-preprocess Svelte source. A module only ever
+   *  renders on the server, so no client chunk carries its CSS: the build ships, as one client asset
+   *  per module, the scoped CSS of its own `<style>` and of every component it imports (and plain
+   *  style imports). The plugin keeps filling this map; the build reads it late. */
+  modules?: ReadonlyMap<string, string>;
 }
 /** What the build hands back for a markup source: run the region transform on preprocessed Svelte. */
 export interface MarkupRegions {

package/dist/vite/plugin-api.js

@@ -1,3 +1,4 @@
+import { OgygiaError } from "../messages/build.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import path from "node:path";
@@ -34,7 +35,7 @@ function definePlugin(definition) {
 		name: definition.name,
 		[PLUGIN]: definition,
 		configResolved(config) {
-			if (!config.plugins.some((p) => p.name === OGYGIA_VITE_PLUGIN)) throw new Error(`[ogygia] \`${definition.name}\` is listed in vite.config but \`ogygia()\` is not — add \`ogygia()\` from \`ogygia/vite\` to \`plugins\`.`);
+			if (!config.plugins.some((p) => p.name === OGYGIA_VITE_PLUGIN)) throw new OgygiaError("plugin_without_ogygia", { plugin: definition.name });
 		}
 	};
 }
@@ -53,13 +54,13 @@ async function find_plugins(list) {
 			for (const item of value) await walk(item);
 			return;
 		}
-		if (typeof value === "function") throw new Error("[ogygia] a function is listed in vite.config `plugins` — call the factory: `flags()`, not `flags`.");
+		if (typeof value === "function") throw new OgygiaError("plugin_factory_not_called");
 		const plugin = value;
 		const name = typeof plugin?.name === "string" ? plugin.name : "";
 		const definition = plugin?.[PLUGIN];
 		if (name.startsWith(KIT_VITE_PLUGIN_PREFIX)) kit_seen = true;
 		const own = name === OGYGIA_VITE_PLUGIN;
-		if ((own || definition) && kit_seen) throw new Error(`[ogygia] \`${own ? "ogygia()" : String(definition?.name)}\` is listed after \`sveltekit()\` in vite.config — list \`ogygia()\` and its plugins first: \`plugins: [ogygia(), flags(), sveltekit()]\`.`);
+		if ((own || definition) && kit_seen) throw new OgygiaError("plugin_after_sveltekit", { plugin: own ? "ogygia()" : String(definition?.name) });
 		if (definition) found.push(definition);
 	};
 	await walk(list);
@@ -90,14 +91,17 @@ function check_plugins(plugins) {
 	const seen = /* @__PURE__ */ new Set();
 	for (const p of plugins) {
 		const plugin = p;
-		if (!plugin || typeof plugin !== "object" || typeof plugin.name !== "string" || plugin.name === "") throw new Error("[ogygia] a plugin definition needs a `name` (its package name).");
-		if (seen.has(plugin.name)) throw new Error(`[ogygia] plugin \`${plugin.name}\` is listed twice.`);
+		if (!plugin || typeof plugin !== "object" || typeof plugin.name !== "string" || plugin.name === "") throw new OgygiaError("plugin_name_missing");
+		if (seen.has(plugin.name)) throw new OgygiaError("plugin_listed_twice", { plugin: plugin.name });
 		seen.add(plugin.name);
-		for (const realm of ["server", "client"]) if (plugin[realm] !== void 0 && typeof plugin[realm] !== "string") throw new Error(`[ogygia] plugin \`${plugin.name}\`: \`${realm}\` is a module location — \`import.meta.resolve('./${realm}.ts')\`.`);
+		for (const realm of ["server", "client"]) if (plugin[realm] !== void 0 && typeof plugin[realm] !== "string") throw new OgygiaError("plugin_realm_not_location", {
+			plugin: plugin.name,
+			realm
+		});
 		if (plugin.options !== void 0) try {
 			JSON.stringify(plugin.options);
 		} catch {
-			throw new Error(`[ogygia] plugin \`${plugin.name}\`: \`options\` must be plain JSON (configure live objects in hooks.server.ts).`);
+			throw new OgygiaError("plugin_options_not_json", { plugin: plugin.name });
 		}
 	}
 	return plugins;
@@ -108,7 +112,11 @@ function realm_path(plugin, realm) {
 	const where = plugin[realm];
 	if (where === void 0) return null;
 	const abs = where.startsWith("file:") ? fileURLToPath(where) : where;
-	if (!path.isAbsolute(abs) || !fs.existsSync(abs)) throw new Error(`[ogygia] plugin \`${plugin.name}\`: its \`${realm}\` realm \`${where}\` is not a file — resolve it next to the factory: \`import.meta.resolve('./${realm}.ts')\`.`);
+	if (!path.isAbsolute(abs) || !fs.existsSync(abs)) throw new OgygiaError("plugin_realm_not_file", {
+		plugin: plugin.name,
+		realm,
+		location: where
+	});
 	return abs.split(path.sep).join("/");
 }
 function package_resolves(req, name) {
@@ -145,7 +153,10 @@ function resolve_plugins(plugins, root, dev, markup_transform = () => null) {
 	const config_owner = /* @__PURE__ */ new Map();
 	const macro_owner = /* @__PURE__ */ new Map();
 	for (const plugin of ordered) {
-		if (!package_resolves(req, plugin.name)) throw new Error(`[ogygia] plugin \`${plugin.name}\`: no package by that name resolves from ${root} — its name must be its package name.`);
+		if (!package_resolves(req, plugin.name)) throw new OgygiaError("plugin_package_unresolved", {
+			plugin: plugin.name,
+			root
+		});
 		const server = realm_path(plugin, "server");
 		if (server) out.servers.push({
 			name: plugin.name,
@@ -158,9 +169,16 @@ function resolve_plugins(plugins, root, dev, markup_transform = () => null) {
 			root,
 			dev,
 			routeConfig(key) {
-				if (!ROUTE_CONFIG_KEY_RE.test(key)) throw new Error(`[ogygia] plugin \`${plugin.name}\`: route config key \`${key}\` must be a camelCase identifier.`);
+				if (!ROUTE_CONFIG_KEY_RE.test(key)) throw new OgygiaError("route_config_key_invalid", {
+					plugin: plugin.name,
+					key
+				});
 				const owner = config_owner.get(key);
-				if (owner && owner !== plugin.name) throw new Error(`[ogygia] route config key \`${key}\` is claimed by both \`${owner}\` and \`${plugin.name}\`.`);
+				if (owner && owner !== plugin.name) throw new OgygiaError("route_config_key_claimed", {
+					key,
+					owner,
+					plugin: plugin.name
+				});
 				if (!owner) {
 					config_owner.set(key, plugin.name);
 					out.route_config.push(key);
@@ -170,9 +188,16 @@ function resolve_plugins(plugins, root, dev, markup_transform = () => null) {
 				out.foreign_hydrate = true;
 			},
 			macro(name, handler) {
-				if (!MACRO_NAME_RE.test(name) || CORE_MACROS.has(name)) throw new Error(`[ogygia] plugin \`${plugin.name}\`: macro \`import.meta.og.${name}\` must be a camelCase name core does not own.`);
+				if (!MACRO_NAME_RE.test(name) || CORE_MACROS.has(name)) throw new OgygiaError("plugin_macro_name_invalid", {
+					plugin: plugin.name,
+					name
+				});
 				const owner = macro_owner.get(name);
-				if (owner) throw new Error(`[ogygia] macro \`import.meta.og.${name}\` is claimed by both \`${owner}\` and \`${plugin.name}\`.`);
+				if (owner) throw new OgygiaError("plugin_macro_claimed", {
+					name,
+					owner,
+					plugin: plugin.name
+				});
 				macro_owner.set(name, plugin.name);
 				out.macros.push({
 					name,
@@ -201,7 +226,10 @@ function resolve_plugins(plugins, root, dev, markup_transform = () => null) {
 			pageModules(modules) {
 				for (const spec of modules.importers ?? []) if (!out.page_modules.importers.includes(spec)) out.page_modules.importers.push(spec);
 				for (const file of modules.files ?? []) {
-					if (!path.isAbsolute(file)) throw new Error(`[ogygia] plugin \`${plugin.name}\`: \`pageModules({ files })\` takes absolute paths (got \`${file}\`).`);
+					if (!path.isAbsolute(file)) throw new OgygiaError("page_modules_not_absolute", {
+						plugin: plugin.name,
+						file
+					});
 					if (!out.page_modules.files.includes(file)) out.page_modules.files.push(file);
 				}
 			}

package/dist/vite/style-preprocess.js

@@ -1,3 +1,4 @@
+import { warn } from "../messages/build.js";
 import { createRequire } from "node:module";
 import path from "node:path";
 // src/vite/style-preprocess.ts
@@ -52,7 +53,7 @@ async function preprocess_component_for_css(source, abs, root) {
 		if (!compiler) {
 			if (!sass_warned) {
 				sass_warned = true;
-				console.warn("[ogygia] a server-rendered component has `<style lang=\"scss\">` but neither `sass-embedded` nor `sass` is installed — its hole/router CSS ships unprocessed");
+				warn("sass_missing");
 			}
 		} else out = out.replace(STYLE_BLOCK_G, (whole, attrs, body) => {
 			const lang = STYLE_LANG_ATTR.exec(attrs)?.[1]?.toLowerCase();
@@ -70,7 +71,10 @@ async function preprocess_component_for_css(source, abs, root) {
 				});
 				return `<style${attrs.replace(STYLE_LANG_ATTR, "")}>${css}</style>`;
 			} catch (err) {
-				console.warn(`[ogygia] ${path.relative(root, abs)}: scss compile failed — ${err.message}`);
+				warn("scss_compile_failed", {
+					file: path.relative(root, abs),
+					reason: err.message
+				});
 				return whole;
 			}
 		});
@@ -86,7 +90,10 @@ async function preprocess_component_for_css(source, abs, root) {
 					const { code } = await ts(body, abs + ".ts");
 					out = out.replace(whole, `<script${attrs}>${code}<\/script>`);
 				} catch (err) {
-					console.warn(`[ogygia] ${path.relative(root, abs)}: TypeScript strip failed — ${err.message}`);
+					warn("ts_strip_failed", {
+						file: path.relative(root, abs),
+						reason: err.message
+					});
 				}
 			}
 		}