@moku-labs/web 1.13.2 → 1.15.0

package/dist/browser.mjs

@@ -49,166 +49,9 @@ const createPlugin$1 = coreConfig.createPlugin;
 */
 const createCore = coreConfig.createCore;
 //#endregion
-//#region src/plugins/i18n/api.ts
-/** Error prefix for all i18n lifecycle failures. */
-const ERROR_PREFIX$8 = "[web]";
-/**
-* Validates the resolved i18n config (fail-fast at `createApp`). Throws when
-* `locales` is empty or when `defaultLocale` is not a member of `locales`.
-* Errors use the `[web]` prefix with an actionable remediation line.
-*
-* @param ctx - Plugin context carrying the resolved {@link Config}.
-* @param ctx.config - The resolved i18n {@link Config}.
-* @throws {Error} If `locales` is empty or `defaultLocale` is not in `locales`.
-* @example
-* ```ts
-* validateI18nConfig({ config: { locales: ["en"], defaultLocale: "en" } });
-* ```
-*/
-function validateI18nConfig(ctx) {
-	const { locales, defaultLocale } = ctx.config;
-	if (locales.length === 0) throw new Error(`${ERROR_PREFIX$8} i18n.locales must contain at least one locale.\n  Set pluginConfigs.i18n.locales to a non-empty array, e.g. ["en"].`);
-	if (!locales.includes(defaultLocale)) throw new Error(`${ERROR_PREFIX$8} i18n.defaultLocale "${defaultLocale}" is not in i18n.locales [${locales.join(", ")}].\n  Set pluginConfigs.i18n.defaultLocale to one of the configured locales, or add "${defaultLocale}" to i18n.locales.`);
-}
-/**
-* Creates the i18n plugin API surface — locale registry accessors plus the
-* `t()` translator with default-locale fallback. Every method is a pure read
-* of `ctx.config`; none mutate, and `t()` always returns a string.
-*
-* @param ctx - Plugin context carrying the resolved {@link Config}.
-* @param ctx.config - The resolved i18n {@link Config}.
-* @returns The {@link Api} accessor surface mounted at `app.i18n`.
-* @example
-* ```ts
-* const api = createI18nApi({ config: { locales: ["en"], defaultLocale: "en" } });
-* api.t("en", "nav.home");
-* ```
-*/
-function createI18nApi(ctx) {
-	const { config } = ctx;
-	return {
-		/**
-		* Returns the configured supported locales in declared order.
-		*
-		* @returns The configured `locales` list (priority/display order).
-		* @example
-		* ```ts
-		* api.locales(); // ["en", "uk"]
-		* ```
-		*/
-		locales() {
-			return config.locales;
-		},
-		/**
-		* Returns the fallback locale used when a requested locale is absent.
-		*
-		* @returns The configured `defaultLocale`.
-		* @example
-		* ```ts
-		* api.defaultLocale(); // "en"
-		* ```
-		*/
-		defaultLocale() {
-			return config.defaultLocale;
-		},
-		/**
-		* Membership guard: whether `x` is one of the supported locales
-		* (case-sensitive).
-		*
-		* @param x - Candidate locale code.
-		* @returns `true` if `x ∈ locales`, else `false`.
-		* @example
-		* ```ts
-		* api.isLocale("uk"); // true
-		* ```
-		*/
-		isLocale(x) {
-			return config.locales.includes(x);
-		},
-		/**
-		* Human-readable display name for a locale.
-		*
-		* @param locale - Locale code to look up.
-		* @returns The display name, or `undefined` if unmapped.
-		* @example
-		* ```ts
-		* api.localeName("uk"); // "Українська"
-		* ```
-		*/
-		localeName(locale) {
-			return config.localeNames?.[locale];
-		},
-		/**
-		* Open Graph `og:locale` value for a locale.
-		*
-		* @param locale - Locale code to look up.
-		* @returns The `og:locale` value (e.g. `"en_US"`), or `undefined` if unmapped.
-		* @example
-		* ```ts
-		* api.ogLocale("en"); // "en_US"
-		* ```
-		*/
-		ogLocale(locale) {
-			return config.ogLocaleMap?.[locale];
-		},
-		/**
-		* Translate `key` for `locale` with a deterministic fallback chain
-		* (requested locale → default locale → the key itself). The default-locale
-		* lookup is skipped when `locale === defaultLocale`.
-		*
-		* @param locale - Requested locale code.
-		* @param key - Translation key (e.g. `"nav.home"`).
-		* @returns The translated value, the default-locale value, or `key`.
-		* @example
-		* ```ts
-		* api.t("uk", "nav.home"); // "Головна"
-		* ```
-		*/
-		t(locale, key) {
-			const exact = config.translations?.[locale]?.[key];
-			if (exact !== void 0) return exact;
-			if (locale !== config.defaultLocale) {
-				const fallback = config.translations?.[config.defaultLocale]?.[key];
-				if (fallback !== void 0) return fallback;
-			}
-			return key;
-		}
-	};
-}
-/**
-* Internationalization plugin — locale registry plus a flat translation helper
-* with default-locale fallback. Pure config-as-data (no state or events);
-* consumed read-only by content, router, head, and build.
-*
-* @example Register locales and translations
-* ```ts
-* const app = createApp({
-*   pluginConfigs: {
-*     i18n: {
-*       locales: ["en", "uk"],
-*       defaultLocale: "en",
-*       localeNames: { en: "English", uk: "Українська" },
-*       translations: { uk: { "nav.home": "Головна" } }
-*     }
-*   }
-* });
-* ```
-*/
-const i18nPlugin = createPlugin$1("i18n", {
-	config: {
-		locales: ["en"],
-		defaultLocale: "en",
-		localeNames: {},
-		ogLocaleMap: {},
-		translations: {}
-	},
-	onInit: validateI18nConfig,
-	api: createI18nApi
-});
-//#endregion
 //#region src/plugins/site/api.ts
 /** Error prefix for all site lifecycle/validation failures. */
-const ERROR_PREFIX$7 = "[web]";
+const ERROR_PREFIX$8 = "[web]";
 /** URL protocols that qualify a parsed URL as an absolute http/https URL. */
 const HTTP_PROTOCOLS = new Set(["http:", "https:"]);
 /**
@@ -307,8 +150,8 @@ function isAbsoluteUrl(value) {
 * ```
 */
 function validateSiteConfig(ctx) {
-	if (!isNonEmpty(ctx.config.name)) throw new Error(`${ERROR_PREFIX$7} site.name is required.\n  Provide a non-empty site name in pluginConfigs.site.name.`);
-	if (!isAbsoluteUrl(ctx.config.url)) throw new Error(`${ERROR_PREFIX$7} site.url must be a valid absolute URL (http/https), received ${JSON.stringify(ctx.config.url)}.\n  Provide an absolute URL in pluginConfigs.site.url, e.g. "https://blog.dev".`);
+	if (!isNonEmpty(ctx.config.name)) throw new Error(`${ERROR_PREFIX$8} site.name is required.\n  Provide a non-empty site name in pluginConfigs.site.name.`);
+	if (!isAbsoluteUrl(ctx.config.url)) throw new Error(`${ERROR_PREFIX$8} site.url must be a valid absolute URL (http/https), received ${JSON.stringify(ctx.config.url)}.\n  Provide an absolute URL in pluginConfigs.site.url, e.g. "https://blog.dev".`);
 }
 /**
 * Creates the site plugin API surface — read-only accessors over frozen config
@@ -421,6 +264,202 @@ const sitePlugin = createPlugin$1("site", {
 	api: createSiteApi
 });
 //#endregion
+//#region src/plugins/i18n/api.ts
+/** Error prefix for all i18n lifecycle failures. */
+const ERROR_PREFIX$7 = "[web]";
+/**
+* The framework's default i18n config — a single `"en"` locale with empty lookup
+* maps. Used both as the i18n plugin's `config` default and as the source for
+* {@link fallbackI18n}, so "no i18n config" and "no i18n plugin" resolve identically.
+*
+* @example
+* ```ts
+* createI18nApi({ config: DEFAULT_I18N_CONFIG }).defaultLocale(); // "en"
+* ```
+*/
+const DEFAULT_I18N_CONFIG = {
+	locales: ["en"],
+	defaultLocale: "en",
+	localeNames: {},
+	ogLocaleMap: {},
+	translations: {}
+};
+/**
+* Validates the resolved i18n config (fail-fast at `createApp`). Throws when
+* `locales` is empty or when `defaultLocale` is not a member of `locales`.
+* Errors use the `[web]` prefix with an actionable remediation line.
+*
+* @param ctx - Plugin context carrying the resolved {@link Config}.
+* @param ctx.config - The resolved i18n {@link Config}.
+* @throws {Error} If `locales` is empty or `defaultLocale` is not in `locales`.
+* @example
+* ```ts
+* validateI18nConfig({ config: { locales: ["en"], defaultLocale: "en" } });
+* ```
+*/
+function validateI18nConfig(ctx) {
+	const { locales, defaultLocale } = ctx.config;
+	if (locales.length === 0) throw new Error(`${ERROR_PREFIX$7} i18n.locales must contain at least one locale.\n  Set pluginConfigs.i18n.locales to a non-empty array, e.g. ["en"].`);
+	if (!locales.includes(defaultLocale)) throw new Error(`${ERROR_PREFIX$7} i18n.defaultLocale "${defaultLocale}" is not in i18n.locales [${locales.join(", ")}].\n  Set pluginConfigs.i18n.defaultLocale to one of the configured locales, or add "${defaultLocale}" to i18n.locales.`);
+}
+/**
+* Creates the i18n plugin API surface — locale registry accessors plus the
+* `t()` translator with default-locale fallback. Every method is a pure read
+* of `ctx.config`; none mutate, and `t()` always returns a string.
+*
+* @param ctx - Plugin context carrying the resolved {@link Config}.
+* @param ctx.config - The resolved i18n {@link Config}.
+* @returns The {@link Api} accessor surface mounted at `app.i18n`.
+* @example
+* ```ts
+* const api = createI18nApi({ config: { locales: ["en"], defaultLocale: "en" } });
+* api.t("en", "nav.home");
+* ```
+*/
+function createI18nApi(ctx) {
+	const { config } = ctx;
+	return {
+		/**
+		* Returns the configured supported locales in declared order.
+		*
+		* @returns The configured `locales` list (priority/display order).
+		* @example
+		* ```ts
+		* api.locales(); // ["en", "uk"]
+		* ```
+		*/
+		locales() {
+			return config.locales;
+		},
+		/**
+		* Returns the fallback locale used when a requested locale is absent.
+		*
+		* @returns The configured `defaultLocale`.
+		* @example
+		* ```ts
+		* api.defaultLocale(); // "en"
+		* ```
+		*/
+		defaultLocale() {
+			return config.defaultLocale;
+		},
+		/**
+		* Membership guard: whether `x` is one of the supported locales
+		* (case-sensitive).
+		*
+		* @param x - Candidate locale code.
+		* @returns `true` if `x ∈ locales`, else `false`.
+		* @example
+		* ```ts
+		* api.isLocale("uk"); // true
+		* ```
+		*/
+		isLocale(x) {
+			return config.locales.includes(x);
+		},
+		/**
+		* Human-readable display name for a locale.
+		*
+		* @param locale - Locale code to look up.
+		* @returns The display name, or `undefined` if unmapped.
+		* @example
+		* ```ts
+		* api.localeName("uk"); // "Українська"
+		* ```
+		*/
+		localeName(locale) {
+			return config.localeNames?.[locale];
+		},
+		/**
+		* Open Graph `og:locale` value for a locale.
+		*
+		* @param locale - Locale code to look up.
+		* @returns The `og:locale` value (e.g. `"en_US"`), or `undefined` if unmapped.
+		* @example
+		* ```ts
+		* api.ogLocale("en"); // "en_US"
+		* ```
+		*/
+		ogLocale(locale) {
+			return config.ogLocaleMap?.[locale];
+		},
+		/**
+		* Translate `key` for `locale` with a deterministic fallback chain
+		* (requested locale → default locale → the key itself). The default-locale
+		* lookup is skipped when `locale === defaultLocale`.
+		*
+		* @param locale - Requested locale code.
+		* @param key - Translation key (e.g. `"nav.home"`).
+		* @returns The translated value, the default-locale value, or `key`.
+		* @example
+		* ```ts
+		* api.t("uk", "nav.home"); // "Головна"
+		* ```
+		*/
+		t(locale, key) {
+			const exact = config.translations?.[locale]?.[key];
+			if (exact !== void 0) return exact;
+			if (locale !== config.defaultLocale) {
+				const fallback = config.translations?.[config.defaultLocale]?.[key];
+				if (fallback !== void 0) return fallback;
+			}
+			return key;
+		}
+	};
+}
+/**
+* The i18n API a consumer sees when the i18n plugin is NOT composed: a single
+* default locale (`"en"`) with empty maps. `locales()` is `["en"]`,
+* `defaultLocale()` is `"en"`, and every map lookup misses (`undefined`, or the
+* key for `t()`). Identical to composing the i18n plugin with its defaults — which
+* is what makes i18n optional: `router`/`head`/`content`/`build` fall back to this
+* when `ctx.has("i18n")` is false, leaving every downstream call unchanged.
+*
+* @example
+* ```ts
+* const i18n = ctx.has("i18n") ? ctx.require(i18nPlugin) : fallbackI18n;
+* i18n.locales(); // ["en"]
+* ```
+*/
+const fallbackI18n = createI18nApi({ config: DEFAULT_I18N_CONFIG });
+//#endregion
+//#region src/plugins/i18n/index.ts
+/**
+* i18n — Micro tier. Multi-file layout (index wiring + api.ts + types.ts) so
+* index.ts stays within the ≤30-line wiring-only hook; logic lives in api.ts.
+*
+* Locale registry + flat translation helper with default-locale fallback.
+* Pure config-as-data: no state, no events, no lifecycle resources.
+* Consumed read-only by content/router/head/build via `ctx.require(i18nPlugin)`.
+*
+* @file i18n plugin wiring harness.
+* @see README.md
+*/
+/**
+* Internationalization plugin — locale registry plus a flat translation helper
+* with default-locale fallback. Pure config-as-data (no state or events);
+* consumed read-only by content, router, head, and build.
+*
+* @example Register locales and translations
+* ```ts
+* const app = createApp({
+*   pluginConfigs: {
+*     i18n: {
+*       locales: ["en", "uk"],
+*       defaultLocale: "en",
+*       localeNames: { en: "English", uk: "Українська" },
+*       translations: { uk: { "nav.home": "Головна" } }
+*     }
+*   }
+* });
+* ```
+*/
+const i18nPlugin = createPlugin$1("i18n", {
+	config: DEFAULT_I18N_CONFIG,
+	onInit: validateI18nConfig,
+	api: createI18nApi
+});
+//#endregion
 //#region src/plugins/router/iso-match.ts
 /**
 * Parse a single path segment into its `{…}` placeholder, or `false` for a static
@@ -1004,8 +1043,9 @@ function compileRoutes(input) {
 const ERROR_PREFIX$5 = "[web] router";
 /**
 * Validate a route map and compile it into the matcher table on `ctx.state`,
-* resolving the global render `mode` + site base URL + i18n locales at call time.
-* Called by the router's `onInit` to compile `config.routes`. Re-calling replaces the table.
+* resolving the global render `mode` + site base URL + i18n locales (or the single
+* default-locale fallback when i18n is not composed) at call time. Called by the
+* router's `onInit` to compile `config.routes`. Re-calling replaces the table.
 *
 * @param ctx - The router register context (state + global mode + require).
 * @param routes - The route map to compile (an `import * as routes` namespace works).
@@ -1017,7 +1057,7 @@ const ERROR_PREFIX$5 = "[web] router";
 */
 function registerRoutes(ctx, routes) {
 	validateRoutes(routes);
-	const i18n = ctx.require(i18nPlugin);
+	const i18n = ctx.has("i18n") ? ctx.require(i18nPlugin) : fallbackI18n;
 	ctx.state.table = compileRoutes({
 		routes,
 		mode: ctx.global.mode,
@@ -1442,8 +1482,8 @@ function createState$2(_ctx) {
 /**
 * Router plugin — typed, named route definitions with locale-aware URL generation
 * and matching. Author routes with {@link route}, then register them the normal config
-* way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL)
-* and i18n (locales).
+* way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL);
+* i18n (locales) is OPTIONAL — falls back to a single default locale ("en") when absent.
 *
 * @example Register routes via config, then start/build
 * ```ts
@@ -1456,7 +1496,7 @@ function createState$2(_ctx) {
 * ```
 */
 const routerPlugin = createPlugin$1("router", {
-	depends: [sitePlugin, i18nPlugin],
+	depends: [sitePlugin],
 	helpers: {
 		route,
 		defineRoutes,
@@ -1898,7 +1938,8 @@ function serializeHead(elements) {
 *
 * The `render` method pulls `site`/`i18n`/`router` via `ctx.require` at call time,
 * composes the head element set via the shared `compose.ts` module, and serializes
-* it to a string. It holds no resource and caches no subscription.
+* it to a string. It holds no resource and caches no subscription. `i18n` is
+* OPTIONAL — a single default-locale fallback is used when it is not composed.
 */
 /** Error prefix for head API invariant failures. */
 const ERROR_PREFIX$4 = "[web] head";
@@ -1950,7 +1991,7 @@ function createApi$1(ctx) {
 				data,
 				defaults: readDefaults(ctx.state),
 				site: ctx.require(sitePlugin),
-				i18n: ctx.require(i18nPlugin),
+				i18n: ctx.has("i18n") ? ctx.require(i18nPlugin) : fallbackI18n,
 				router: ctx.require(routerPlugin)
 			}));
 		},
@@ -1970,7 +2011,8 @@ function createApi$1(ctx) {
 		*/
 		siteHead(input) {
 			const site = ctx.require(sitePlugin);
-			const ogLocale = input.locale === void 0 ? void 0 : ctx.require(i18nPlugin).ogLocale(input.locale);
+			const i18n = ctx.has("i18n") ? ctx.require(i18nPlugin) : fallbackI18n;
+			const ogLocale = input.locale === void 0 ? void 0 : i18n.ogLocale(input.locale);
 			return serializeHead(composeSiteHead({
 				site,
 				defaults: readDefaults(ctx.state),
@@ -2107,7 +2149,7 @@ function createState$1(_ctx) {
 * Head plugin — composes per-route `<head>` metadata (title template, Open Graph,
 * Twitter cards, canonical, hreflang). Use the re-exported SEO primitives
 * ({@link meta}, {@link og}, {@link twitter}, …) inside a route's `.head()`.
-* Depends on site, i18n, and router.
+* Depends on site and router; i18n is OPTIONAL (single default-locale fallback when absent).
 *
 * @example Set global head defaults
 * ```ts
@@ -2123,11 +2165,7 @@ function createState$1(_ctx) {
 * ```
 */
 const headPlugin = createPlugin$1("head", {
-	depends: [
-		sitePlugin,
-		i18nPlugin,
-		routerPlugin
-	],
+	depends: [sitePlugin, routerPlugin],
 	helpers: headHelpers,
 	config: defaultConfig,
 	createState: createState$1,
@@ -2473,6 +2511,23 @@ const ERROR_PREFIX$2 = "[web]";
 /** The set of legal hook names, frozen for O(1) membership checks. */
 const HOOK_NAME_SET = new Set(COMPONENT_HOOK_NAMES);
 /**
+* No-op link builder for the {@link EMPTY_ROUTE} slice (used when no route matched).
+*
+* @returns An empty string.
+* @example
+* const href = noUrl();
+*/
+function noUrl() {
+	return "";
+}
+/** Empty route slice — used for mounts with no matched route (headless, tests, public `scan()`). */
+const EMPTY_ROUTE = {
+	params: {},
+	meta: {},
+	locale: "",
+	url: noUrl
+};
+/**
 * Validate a single hook entry: its key must be a known hook name and its value
 * must be a function. Throws fail-fast on the first violation.
 *
@@ -2560,18 +2615,25 @@ function runHook(instance, hook, ctx) {
 	instance.def.hooks[hook]?.(ctx);
 }
 /**
-* Builds the component context handed to a hook (the bound element + page data).
+* Builds the component context handed to a hook: the bound element + page data, merged
+* with the matched route's slice (params/meta/locale/url). Defaults to {@link EMPTY_ROUTE}
+* when no route is supplied (headless, tests, public `scan()`).
 *
 * @param element - The element the instance is bound to.
 * @param data - The current page data payload.
+* @param route - The matched-route slice for the current URL.
 * @returns The hook context.
 * @example
-* const ctx = makeContext(element, data);
+* const ctx = makeContext(element, data, route);
 */
-function makeContext(element, data) {
+function makeContext(element, data, route = EMPTY_ROUTE) {
 	return {
 		el: element,
-		data
+		data,
+		params: route.params,
+		meta: route.meta,
+		locale: route.locale,
+		url: route.url
 	};
 }
 /**
@@ -2585,17 +2647,18 @@ function makeContext(element, data) {
 * @param swapArea - The swap-region element, or null when none was found.
 * @param data - The current page data payload.
 * @param element - The candidate element carrying a `data-component` attribute.
+* @param route - The matched-route slice for the current URL (params/meta/locale/url).
 * @example
-* mountElement(state, emit, swapArea, data, element);
+* mountElement(state, emit, swapArea, data, element, route);
 */
-function mountElement(state, emit, swapArea, data, element) {
+function mountElement(state, emit, swapArea, data, element, route = EMPTY_ROUTE) {
 	if (state.instances.has(element)) return;
 	const name = element.dataset.component;
 	if (!name) return;
 	const definition = state.registeredComponents.get(name);
 	if (!definition) return;
 	const instance = createInstance(definition, element, swapArea ? !swapArea.contains(element) : true);
-	const ctx = makeContext(element, data);
+	const ctx = makeContext(element, data, route);
 	runHook(instance, "onCreate", ctx);
 	runHook(instance, "onMount", ctx);
 	state.instances.set(element, instance);
@@ -2613,14 +2676,15 @@ function mountElement(state, emit, swapArea, data, element) {
 * @param state - The plugin state (registeredComponents + instances).
 * @param emit - The event emitter for spa:component-mount.
 * @param swapSelector - CSS selector bounding page-specific components.
+* @param route - The matched-route slice for the current URL (params/meta/locale/url).
 * @example
-* scanAndMount(state, emit, "main > section");
+* scanAndMount(state, emit, "main > section", route);
 */
-function scanAndMount(state, emit, swapSelector) {
+function scanAndMount(state, emit, swapSelector, route = EMPTY_ROUTE) {
 	if (typeof document === "undefined") return;
 	const swapArea = document.querySelector(swapSelector);
 	const data = extractPageData(document);
-	for (const element of document.querySelectorAll("[data-component]")) mountElement(state, emit, swapArea, data, element);
+	for (const element of document.querySelectorAll("[data-component]")) mountElement(state, emit, swapArea, data, element, route);
 }
 /**
 * Unmounts page-specific instances inside the swap region (runs `onUnMount`
@@ -2686,12 +2750,13 @@ function notifyNavStart(state) {
 * instances were already destroyed and re-created by the swap).
 *
 * @param state - The plugin state holding live instances.
+* @param route - The matched-route slice for the destination URL (params/meta/locale/url).
 * @example
-* notifyNavEnd(state);
+* notifyNavEnd(state, route);
 */
-function notifyNavEnd(state) {
+function notifyNavEnd(state, route = EMPTY_ROUTE) {
 	const data = typeof document === "undefined" ? {} : extractPageData(document);
-	for (const [element, instance] of state.instances) if (instance.persistent) runHook(instance, "onNavEnd", makeContext(element, data));
+	for (const [element, instance] of state.instances) if (instance.persistent) runHook(instance, "onNavEnd", makeContext(element, data, route));
 }
 //#endregion
 //#region src/plugins/spa/head.ts
@@ -3334,6 +3399,26 @@ function createSpaKernel(state, config, emit, deps) {
 		});
 	};
 	/**
+	* Build the matched-route slice (params/meta/locale/url) for the component context at `path`,
+	* so islands read their route's params/meta directly. An unmatched path yields an empty slice.
+	*
+	* @param path - The URL (pathname + search) to match.
+	* @returns The route slice for the matched route.
+	* @example
+	* scanAndMount(state, emit, resolved.swapSelector, componentRouteContext(pathname));
+	*/
+	const componentRouteContext = (path) => {
+		const matchPath = path.split("?")[0] ?? path;
+		const hit = deps.router.match(matchPath);
+		const locale = hit?.params.lang ?? (typeof document === "undefined" ? "" : document.documentElement.lang) ?? "";
+		return {
+			params: hit?.params ?? {},
+			meta: hit?.route._meta ?? {},
+			locale,
+			url: (name, params = {}) => deps.router.toUrl(name, params)
+		};
+	};
+	/**
 	* Process one navigation: head-sync, unmount, swap, re-mount, emit navigated.
 	* When the region cannot be swapped (either document lacks the swap selector)
 	* the SPA nav cannot complete — the head is already synced and the islands torn
@@ -3351,8 +3436,9 @@ function createSpaKernel(state, config, emit, deps) {
 		syncHead(deps.head, doc);
 		unmountPageSpecific(state, emit);
 		if (!swapRegion(doc, resolved.swapSelector, resolved.viewTransitions, () => {
-			scanAndMount(state, emit, resolved.swapSelector);
-			notifyNavEnd(state);
+			const routeSlice = componentRouteContext(pathname);
+			scanAndMount(state, emit, resolved.swapSelector, routeSlice);
+			notifyNavEnd(state, routeSlice);
 		}, applyPendingScroll)) {
 			handleError();
 			location.href = pathname;
@@ -3421,6 +3507,7 @@ function createSpaKernel(state, config, emit, deps) {
 			params: hit.params,
 			data,
 			locale,
+			meta: hit.route._meta,
 			url: (routeName, routeParams = {}) => deps.router.toUrl(routeName, routeParams)
 		};
 		const vnode = hit.route._handlers.render(routeContext);
@@ -3452,6 +3539,7 @@ function createSpaKernel(state, config, emit, deps) {
 		if (signal?.aborted) return;
 		syncDataHead(deps.head, route, routeContext);
 		unmountPageSpecific(state, emit);
+		const routeSlice = componentRouteContext(pathname);
 		/**
 		* Render the VNode into the region and re-mount its islands in one paint — the
 		* swap body handed to `runSwap` (optionally wrapped in a View Transition).
@@ -3463,8 +3551,8 @@ function createSpaKernel(state, config, emit, deps) {
 		*/
 		const renderAndMount = () => {
 			renderVNode(vnode, region);
-			scanAndMount(state, emit, resolved.swapSelector);
-			notifyNavEnd(state);
+			scanAndMount(state, emit, resolved.swapSelector, routeSlice);
+			notifyNavEnd(state, routeSlice);
 		};
 		runSwap(renderAndMount, resolved.viewTransitions, applyPendingScroll);
 		state.currentUrl = pathname;
@@ -3509,15 +3597,16 @@ function createSpaKernel(state, config, emit, deps) {
 	* await bootRender("/b/abc123");
 	*/
 	const bootRender = async (pathname) => {
+		const routeSlice = componentRouteContext(pathname);
 		const resolvedRender = await resolveDataRender(pathname);
 		if (resolvedRender === false) {
-			scanAndMount(state, emit, resolved.swapSelector);
+			scanAndMount(state, emit, resolved.swapSelector, routeSlice);
 			return;
 		}
 		const { vnode, region } = resolvedRender;
 		const { renderVNode } = await import("./render-BNe0s7fr.mjs");
 		renderVNode(vnode, region);
-		scanAndMount(state, emit, resolved.swapSelector);
+		scanAndMount(state, emit, resolved.swapSelector, routeSlice);
 	};
 	/**
 	* Unified navigation: try the client DATA path first (only when the `data`
@@ -3567,7 +3656,7 @@ function createSpaKernel(state, config, emit, deps) {
 			const matchPath = state.currentUrl.split("?")[0] ?? state.currentUrl;
 			const hit = deps.router.match(matchPath);
 			if (hit?.route._handlers.render && isClientOnlyRoute(deps.router.mode(), hit.route)) bootRender(state.currentUrl);
-			else scanAndMount(state, emit, resolved.swapSelector);
+			else scanAndMount(state, emit, resolved.swapSelector, componentRouteContext(state.currentUrl));
 			state.started = true;
 		},
 		/**
@@ -3598,7 +3687,7 @@ function createSpaKernel(state, config, emit, deps) {
 		* kernel.scan();
 		*/
 		scan() {
-			scanAndMount(state, emit, resolved.swapSelector);
+			scanAndMount(state, emit, resolved.swapSelector, componentRouteContext(state.currentUrl));
 		},
 		/**
 		* Tear down router listeners, dispose all instances, reset boot state.
@@ -3908,7 +3997,8 @@ function articleNotFound(slug, locale) {
 	return /* @__PURE__ */ new Error(`[web] content article "${slug}" not found for locale "${locale}".\n  Looked for ${slug}/${locale}.md and the default-locale fallback.`);
 }
 /**
-* Plugin `api` factory: resolves i18n via `ctx.require`, merges `config.providers` into
+* Plugin `api` factory: resolves i18n via `ctx.require` (or the single default-locale
+* fallback when i18n is not composed), merges `config.providers` into
 * one source, assembles the kernel-free {@link ContentApiContext}, and delegates to
 * {@link createContentApi}. Referenced directly as the plugin's `api` so index.ts stays
 * wiring-only. Imports no node code (the provider owns it).
@@ -3921,7 +4011,7 @@ function articleNotFound(slug, locale) {
 * ```
 */
 function contentApi(ctx) {
-	const i18nApi = ctx.require(i18nPlugin);
+	const i18nApi = ctx.has("i18n") ? ctx.require(i18nPlugin) : fallbackI18n;
 	/**
 	* Active locale codes from i18n.
 	*
@@ -4326,8 +4416,8 @@ function validateContentConfig(config) {
 * @file content — Complex Plugin skeleton (wiring-only).
 *
 * Markdown pipeline: discover, parse frontmatter, render to sanitized HTML, and
-* expose a locale-keyed Article model. Depends on i18n. Emits `content:ready`
-* and `content:invalidated`.
+* expose a locale-keyed Article model. i18n is OPTIONAL (single default-locale
+* fallback when absent). Emits `content:ready` and `content:invalidated`.
 * @see README.md
 */
 /**
@@ -4335,7 +4425,8 @@ function validateContentConfig(config) {
 * (locale fallback, draft filtering, sort, caching, events) lives here; source I/O +
 * the Markdown pipeline live in a {@link ContentProvider} you compose (like `env`
 * providers). The shell imports zero node code, so `contentPlugin` is browser-safe.
-* Depends on i18n; emits `content:ready` and `content:invalidated`.
+* i18n is OPTIONAL (single default-locale fallback when absent); emits `content:ready`
+* and `content:invalidated`.
 *
 * @example Compose the node filesystem provider with a content dir + Shiki theme
 * ```ts
@@ -4351,7 +4442,6 @@ function validateContentConfig(config) {
 * ```
 */
 const contentPlugin = createPlugin$1("content", {
-	depends: [i18nPlugin],
 	events: contentEvents,
 	config: defaultContentConfig,
 	createState: createContentState,