@ogygia/core 0.12.3 → 0.13.0

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.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
+					});
 				}
 			}
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogygia/core",
-  "version": "0.12.3",
+  "version": "0.13.0",
   "description": "The core of ogygia (SSR islands for SvelteKit): apps install `ogygia`, plugins build on this",
   "homepage": "https://ogygiajs.dev",
   "bugs": {
@@ -58,6 +58,11 @@
       "svelte": "./dist/internal-instruments.js",
       "default": "./dist/internal-instruments.js"
     },
+    "./internal/messages": {
+      "types": "./dist/messages/index.d.ts",
+      "svelte": "./dist/messages/index.js",
+      "default": "./dist/messages/index.js"
+    },
     "./internal/register": {
       "types": "./dist/internal-register.d.ts",
       "svelte": "./dist/internal-register.js",
@@ -134,6 +139,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@ogygia/machine": "^0.13.0",
     "devalue": "^5.9.3",
     "esm-env": "^1.2.2",
     "estree-walker": "^3.0.3",
@@ -141,6 +147,7 @@
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
+    "@ogygia/config": "0.0.0",
     "@ogygia/tsdown-plugin-svelte": "1.1.1",
     "@sveltejs/kit": "^2.70.2",
     "@sveltejs/vite-plugin-svelte": "^7.2.0",

package/dist/KeepHost.svelte

@@ -1,19 +0,0 @@
-<script>// Keep-alive host for a KEPT island (`keep:`): LiveHost's props-pushable host — the "inside an
-// island" context, `$state` props, `setProps` so the next page's props reach the relocated island —
-// in the SSR shape of a placed island (Region.svelte's `{#if Component}<Component {...props} />{/if}`,
-// as NestedProvider mirrors it). LiveHost has no `{#if}`: it hydrates a live region's render()
-// output, and a kept island hydrated through it met the server's `[0` branch marker where it
-// expected the component's own, discarding the server DOM on every load. NOT part of the public API.
-import { setNested } from "./nested.js";
-let { component: Component, initialProps } = $props();
-// Seed once from the incoming prop; later pages replace it via setProps(). Intentional initial read.
-// svelte-ignore state_referenced_locally
-let current = $state(initialProps);
-/** Called by the runtime when the island crosses to the next page — reactive prop push. */
-export function setProps(next) {
-	current = next;
-}
-setNested();
-</script>
-
-{#if Component}<Component {...current} />{/if}

package/dist/KeepHost.svelte.d.ts

@@ -1,10 +0,0 @@
-import { SvelteComponent } from "svelte";
-type $$ComponentProps = {
-    component: SvelteComponent<Record<string, unknown>>;
-    initialProps: Record<string, unknown>;
-};
-declare const KeepHost: import("svelte").Component<$$ComponentProps, {
-    setProps: (next: Record<string, unknown>) => void;
-}, "">;
-type KeepHost = ReturnType<typeof KeepHost>;
-export default KeepHost;

package/dist/LiveHost.svelte

@@ -1,19 +0,0 @@
-<script>// Keep-alive host for an INTERACTIVE live region (`query.live` yielding `region(C, props)`
-// with a wake schedule). Like NestedProvider, it sets the "inside an island" context and renders
-// the component with no DOM of its own (so it hydrates the server render() output cleanly). Unlike
-// NestedProvider, its props are `$state` and it exposes `setProps` — so a live tick updates the
-// MOUNTED component reactively instead of tearing it down and re-hydrating. Focus and local island
-// state survive; Svelte reconciles the view. NOT part of the public API.
-import { setNested } from "./nested.js";
-let { component: Component, initialProps } = $props();
-// Seed once from the incoming prop; later ticks replace it via setProps(). Intentional initial read.
-// svelte-ignore state_referenced_locally
-let current = $state(initialProps);
-/** Called by the runtime on each live tick with the same component — reactive prop push. */
-export function setProps(next) {
-	current = next;
-}
-setNested();
-</script>
-
-<Component {...current} />

package/dist/LiveHost.svelte.d.ts

@@ -1,10 +0,0 @@
-import { SvelteComponent } from "svelte";
-type $$ComponentProps = {
-    component: SvelteComponent<Record<string, unknown>>;
-    initialProps: Record<string, unknown>;
-};
-declare const LiveHost: import("svelte").Component<$$ComponentProps, {
-    setProps: (next: Record<string, unknown>) => void;
-}, "">;
-type LiveHost = ReturnType<typeof LiveHost>;
-export default LiveHost;

package/dist/NestedProvider.svelte

@@ -1,13 +0,0 @@
-<script>// Passthrough the runtime hydrates a top-level island into, so descendants see the
-// "inside an island" context. Mirrors Region.svelte's island SSR shape EXACTLY
-// (`{#if Component}<Component {...props} />{/if}`) so Svelte adopts the SSR nodes in place instead
-// of discarding and re-creating the island root (a re-created root is class-less for a tick → a
-// `class:`-driven `position: fixed` drops to `static` for a frame). SELF-CLOSING on purpose: any
-// slot content here would pass an implicit `children` snippet that OVERRIDES the decoded
-// `props.children` (the revived slot/region snippet) and desyncs hydration with an extra anchor.
-import { setNested } from "./nested.js";
-let { component: Component, props } = $props();
-setNested();
-</script>
-
-{#if Component}<Component {...props} />{/if}

package/dist/NestedProvider.svelte.d.ts

@@ -1,8 +0,0 @@
-import { SvelteComponent } from "svelte";
-type $$ComponentProps = {
-    component: SvelteComponent<Record<string, unknown>>;
-    props: Record<string, unknown>;
-};
-declare const NestedProvider: import("svelte").Component<$$ComponentProps, {}, "">;
-type NestedProvider = ReturnType<typeof NestedProvider>;
-export default NestedProvider;

package/dist/runtime/page-cache.d.ts

@@ -1,23 +0,0 @@
-/**
- * Bounded SPA HTML cache: TTL + max entries + approximate byte budget.
- * Expired entries are dropped on read/insert; overflow drops oldest by timestamp.
- */
-export type PageCacheEntry = {
-  html: string;
-  t: number;
-  bytes: number;
-};
-export declare class PageCache {
-  #private;
-  constructor(opts?: {
-    ttlMs?: number;
-    maxEntries?: number;
-    maxBytes?: number;
-  });
-  get(href: string): string | null;
-  set(href: string, html: string): void;
-  delete(href: string): void;
-  clear(): void;
-  get size(): number;
-  get bytes(): number;
-}

package/dist/runtime/page-cache.js

@@ -1,74 +0,0 @@
-// src/runtime/page-cache.ts
-var PageCache = class {
-	#map = /* @__PURE__ */ new Map();
-	#total_bytes = 0;
-	#ttlMs;
-	#maxEntries;
-	#maxBytes;
-	constructor(opts) {
-		this.#ttlMs = opts?.ttlMs ?? 8e3;
-		this.#maxEntries = opts?.maxEntries ?? 32;
-		this.#maxBytes = opts?.maxBytes ?? 4e6;
-	}
-	#drop(href) {
-		const e = this.#map.get(href);
-		if (!e) return;
-		this.#map.delete(href);
-		this.#total_bytes -= e.bytes;
-	}
-	#evict_expired(now) {
-		for (const [href, e] of this.#map) if (now - e.t >= this.#ttlMs) this.#drop(href);
-	}
-	#evict_overflow() {
-		while (this.#map.size > this.#maxEntries || this.#total_bytes > this.#maxBytes) {
-			let oldest_href = null;
-			let oldest_t = Infinity;
-			for (const [href, e] of this.#map) if (e.t < oldest_t) {
-				oldest_t = e.t;
-				oldest_href = href;
-			}
-			if (!oldest_href) break;
-			this.#drop(oldest_href);
-		}
-	}
-	get(href) {
-		const now = Date.now();
-		const e = this.#map.get(href);
-		if (!e) return null;
-		if (now - e.t >= this.#ttlMs) {
-			this.#drop(href);
-			return null;
-		}
-		this.#map.delete(href);
-		e.t = now;
-		this.#map.set(href, e);
-		return e.html;
-	}
-	set(href, html) {
-		const now = Date.now();
-		this.#evict_expired(now);
-		this.#drop(href);
-		const bytes = html.length * 2;
-		this.#map.set(href, {
-			html,
-			t: now,
-			bytes
-		});
-		this.#total_bytes += bytes;
-		this.#evict_overflow();
-	}
-	delete(href) {
-		this.#drop(href);
-	}
-	clear() {
-		this.#map.clear();
-		this.#total_bytes = 0;
-	}
-	get size() {
-		return this.#map.size;
-	}
-	get bytes() {
-		return this.#total_bytes;
-	}
-};
-export { PageCache };