@stratal/inertia 0.0.21 → 0.0.23

package/dist/react.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"react.mjs","names":[],"sources":["../src/react/use-i18n.ts","../src/react/use-route.ts"],"sourcesContent":["/**\n * React hook for using Stratal's i18n translations on the frontend.\n *\n * Reads `locale` and `translations` from Inertia shared props (injected by\n * the `i18n` option on {@link InertiaModuleOptions}) and provides a type-safe\n * `t()` function powered by `@intlify/core-base`.\n *\n * @module\n */\n\nimport type { PageProps } from '@inertiajs/core'\nimport { usePage } from '@inertiajs/react'\nimport { compile, createCoreContext, registerMessageCompiler, translate } from '@intlify/core-base'\nimport { useMemo } from 'react'\nimport type { MessageKeys, MessageParams } from 'stratal/i18n'\n\n// Register JIT message compiler from the SAME @intlify/core-base instance that provides\n// createCoreContext/translate. Importing setupI18nCompiler from stratal/i18n/utils can\n// resolve a different @intlify/core-base copy (duplicate modules in node_modules),\n// causing the compiler registration to be invisible to this module's createCoreContext.\nregisterMessageCompiler(compile)\n\ninterface I18nPageProps extends PageProps {\n  locale: string\n  translations: Record<string, string>\n}\n\n/**\n * Hook that provides i18n translation capabilities in React components.\n *\n * Consumes `locale` and `translations` from Inertia shared props and returns\n * a `t()` function that translates message keys with optional interpolation.\n *\n * Requires the `i18n` option to be set on `InertiaModule.forRoot()` to inject\n * the shared props.\n *\n * @returns An object with:\n * - `t` — Translation function accepting a message key and optional params\n * - `locale` — The current locale string\n *\n * @example\n * ```tsx\n * import { useI18n } from '@stratal/inertia/react'\n *\n * export default function Header() {\n *   const { t, locale } = useI18n()\n *\n *   return (\n *     <header>\n *       <h1>{t('common.title')}</h1>\n *       <p>{t('common.greeting', { name: 'World' })}</p>\n *       <span>Locale: {locale}</span>\n *     </header>\n *   )\n * }\n * ```\n */\nexport function useI18n() {\n  const { locale, translations } = usePage<I18nPageProps>().props\n\n  const context = useMemo(\n    () => createCoreContext({\n      locale,\n      messages: { [locale]: translations },\n      missingWarn: !import.meta.env.PROD,\n      fallbackWarn: !import.meta.env.PROD,\n    }),\n    [locale, translations],\n  )\n\n  const t = useMemo(\n    () => (key: MessageKeys, params?: MessageParams): string => {\n      const result = params !== undefined\n        ? translate(context, key, params)\n        : translate(context, key)\n      return typeof result === 'string' ? result : key\n    },\n    [context],\n  )\n\n  return { t, locale }\n}\n","/**\n * React hook for Ziggy-like client-side URL generation.\n *\n * Reads serialized routes and the current request's matched-route snapshot\n * (injected by the `routes` option on {@link InertiaModuleOptions}) and\n * provides a type-safe `route()` function that mirrors the server-side\n * `buildRouteUrl()`, plus `current()` and `params` for current-route\n * introspection.\n *\n * @module\n */\n\nimport type { PageProps } from '@inertiajs/core'\nimport { usePage } from '@inertiajs/react'\nimport { useMemo } from 'react'\nimport type { CurrentRoute, RouteMatcher, RouteName, RouteParams, SerializedRoute, SerializedRoutes, TrailingSlashMode } from 'stratal/router'\n\ninterface RoutesPageProps extends PageProps {\n  routes: SerializedRoutes\n  trailingSlash?: TrailingSlashMode\n  route: CurrentRoute\n}\n\n/**\n * Apply a trailing-slash mode to a URL or path.\n *\n * Pure reimplementation of `applyTrailingSlash()` from `stratal/router` —\n * mirrored here to keep the React bundle decoupled from server-only deps.\n *\n * - `'ignore'` — return as-is.\n * - `'always'` — append `/` unless path is root or last segment is file-like (`.json`, etc.).\n * - `'never'`  — strip a single trailing `/` from the pathname (skip root).\n *\n * Preserves query string and hash. Handles relative paths and absolute URLs.\n */\nexport function applyTrailingSlash(url: string, mode: TrailingSlashMode): string {\n  if (mode === 'ignore') return url\n\n  const isAbsolute = /^https?:\\/\\//i.test(url)\n  const parsed = isAbsolute ? new URL(url) : new URL(url, 'http://placeholder.local')\n  const path = parsed.pathname\n  if (path === '/') return url\n  const hasTrailing = path.endsWith('/')\n\n  if (mode === 'always' && !hasTrailing) {\n    const lastSegment = path.slice(path.lastIndexOf('/') + 1)\n    if (lastSegment.includes('.')) return url\n    parsed.pathname = `${path}/`\n  } else if (mode === 'never' && hasTrailing) {\n    parsed.pathname = path.slice(0, -1)\n  } else {\n    return url\n  }\n\n  return isAbsolute\n    ? parsed.toString()\n    : `${parsed.pathname}${parsed.search}${parsed.hash}`\n}\n\n/**\n * Encode a path-param value while preserving forward slashes so catch-all\n * params (`:slug{.+}`) round-trip cleanly. Mirrors the server-side\n * `encodePathParam()` in `stratal/router`.\n */\nfunction encodePathParam(value: string): string {\n  return value.split('/').map(encodeURIComponent).join('/')\n}\n\n/**\n * Build a URL from a serialized route definition.\n *\n * Mirrors `buildRouteUrl()` from `stratal/router` (pure reimplementation to\n * avoid pulling server-side dependencies into the browser bundle).\n */\nfunction buildUrl(route: SerializedRoute, name: string, params?: Record<string, string>): string {\n  const allParams = { ...params }\n  const consumedKeys = new Set<string>()\n  let url = route.path\n\n  if (allParams.locale && route.localePaths?.length) {\n    url = `/${allParams.locale}${url === '/' ? '' : url}`\n    consumedKeys.add('locale')\n  }\n\n  for (const paramName of route.paramNames) {\n    const value = allParams[paramName]\n    if (value === undefined) {\n      throw new Error(`Missing required parameter \"${paramName}\" for route \"${name}\" (path: ${route.path})`)\n    }\n    url = url.replace(\n      new RegExp(`:${paramName}(\\\\{[^}]*\\\\})?`),\n      encodePathParam(value),\n    )\n    consumedKeys.add(paramName)\n  }\n\n  let domain: string | undefined\n  if (route.domain) {\n    domain = route.domain\n    for (const domainParam of route.domainParamNames) {\n      const value = allParams[domainParam]\n      if (value === undefined) {\n        throw new Error(`Missing required parameter \"${domainParam}\" for route \"${name}\" (domain: ${route.domain})`)\n      }\n      domain = domain.replace(`{${domainParam}}`, encodeURIComponent(value))\n      consumedKeys.add(domainParam)\n    }\n  }\n\n  const queryEntries = Object.entries(allParams).filter(([key]) => !consumedKeys.has(key))\n  if (queryEntries.length > 0) {\n    const queryString = queryEntries\n      .filter(([, v]) => Boolean(v))\n      .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n      .join('&')\n    url = `${url}${queryString.length ? `?${queryString}` : ''}`\n  }\n\n  if (domain) {\n    url = `https://${domain}${url}`\n  }\n\n  return url\n}\n\n/**\n * Filter a param bag down to the keys the target route actually declares —\n * so a `companyId` carried over from the current URL never leaks into the\n * query string of an unrelated route.\n */\nfunction filterCarryover(carryover: Record<string, string>, route: SerializedRoute): Record<string, string> {\n  const allowed = new Set<string>([...route.paramNames, ...route.domainParamNames])\n  if (route.localePaths?.length) allowed.add('locale')\n  if (allowed.size === 0) return {}\n\n  const filtered: Record<string, string> = {}\n  for (const [key, value] of Object.entries(carryover)) {\n    if (allowed.has(key)) filtered[key] = value\n  }\n  return filtered\n}\n\n/**\n * Pure URL resolver. Mirrors what {@link useRoute}'s `route()` does, but\n * without React — exposed for testing and for non-hook callers.\n *\n * Merges params in order (last wins): sticky `defaults`, current-route\n * carryover (filtered to the target's declared params), explicit params.\n */\nexport function resolveUrl<N extends RouteName>(\n  name: N,\n  explicitParams: RouteParams<N> | undefined,\n  routes: SerializedRoutes,\n  currentRoute: CurrentRoute,\n  trailingSlash: TrailingSlashMode = 'ignore',\n): string {\n  const target = routes[name]\n  if (!target) {\n    throw new Error(`Route \"${name}\" not found.`)\n  }\n\n  const merged = {\n    ...currentRoute.defaults,\n    ...filterCarryover(currentRoute.params, target),\n    ...explicitParams,\n  } as Record<string, string>\n\n  return applyTrailingSlash(buildUrl(target, name, merged), trailingSlash)\n}\n\n/**\n * Pure overload signatures for {@link matchCurrent} / `useRoute().current()`.\n *\n * - No arg → matched route name (or `null`).\n * - With a name → `true`/`false`. Strict-typed: only real route names and\n *   dotted wildcard prefixes (`'users.*'`) are accepted.\n */\nexport function matchCurrent(currentRoute: CurrentRoute): RouteName | null\nexport function matchCurrent(currentRoute: CurrentRoute, name: RouteMatcher): boolean\nexport function matchCurrent(currentRoute: CurrentRoute, name?: RouteMatcher): RouteName | null | boolean {\n  if (name === undefined) return currentRoute.name\n  if (currentRoute.name === null) return false\n  if (typeof name === 'string' && name.endsWith('.*')) {\n    const prefix = name.slice(0, -1)\n    return currentRoute.name.startsWith(prefix)\n  }\n  return currentRoute.name === name\n}\n\n/**\n * Hook that provides Ziggy-like route URL generation in React components.\n *\n * Consumes `routes` and the current-request snapshot (`route`) from Inertia\n * shared props. Route names and params are strictly typed from\n * `StratalRouteMap` (generated by `quarry route:types`).\n *\n * Requires the `routes` option to be set on `InertiaModule.forRoot()`.\n *\n * Sticky params — anything in `defaults` (set server-side via `Uri.defaults()`)\n * and anything in the current route's extracted `params` (filtered to the\n * target route's declared params) — are merged into every `route()` call.\n * Explicit params always win.\n *\n * @returns\n * - `route(name, params?)` — URL builder\n * - `current()` / `current(name)` — matched route name (or wildcard match)\n * - `params` — extracted params for the current request URL\n *\n * @example\n * ```tsx\n * import { useRoute } from '@stratal/inertia/react'\n *\n * export default function UserProfile({ user }) {\n *   const { route, current, currentRoute } = useRoute()\n *\n *   return (\n *     <nav>\n *       <a href={route('users.index')}>All Users</a>\n *       <a href={route('users.show', { id: user.id })}>{user.name}</a>\n *       {current('users.*') && <span>On a users page</span>}\n *       {currentRoute.name === 'users.show' && <span>#{currentRoute.params.id}</span>}\n *     </nav>\n *   )\n * }\n * ```\n */\nexport function useRoute() {\n  const page = usePage<RoutesPageProps>()\n  const { routes, trailingSlash = 'ignore', route: currentRoute } = page.props\n\n  const route = useMemo(\n    () => <N extends RouteName>(name: N, params?: RouteParams<N>): string =>\n      resolveUrl(name, params, routes, currentRoute, trailingSlash),\n    [routes, trailingSlash, currentRoute],\n  )\n\n  const current = useMemo(\n    () => {\n      function impl(): RouteName | null\n      function impl(name: RouteMatcher): boolean\n      function impl(name?: RouteMatcher): RouteName | null | boolean {\n        return name === undefined ? matchCurrent(currentRoute) : matchCurrent(currentRoute, name)\n      }\n      return impl\n    },\n    [currentRoute],\n  )\n\n  return { route, current, currentRoute, params: currentRoute.params }\n}\n"],"mappings":"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"}
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react/seo.ts","../src/react/use-i18n.ts","../src/react/use-route.ts"],"sourcesContent":["import type { PageProps } from '@inertiajs/core'\nimport { usePage } from '@inertiajs/react'\nimport type { SeoData } from '../seo/types'\n\ninterface SeoPageProps extends PageProps {\n  seo?: SeoData\n}\n\n/**\n * Returns the resolved SEO data shared by the backend for the current page.\n *\n * The document head is kept in sync automatically (server injection on the\n * initial paint + the auto-injected client runtime on navigation); use this\n * hook only when you want to read the metadata inside a component.\n */\nexport function useSeo(): SeoData {\n  return usePage<SeoPageProps>().props.seo ?? {}\n}\n","import type { PageProps } from '@inertiajs/core'\nimport { usePage } from '@inertiajs/react'\nimport IntlMessageFormat from 'intl-messageformat'\nimport { useMemo } from 'react'\nimport type { MessageParams } from 'stratal/i18n'\nimport type { InertiaTranslationKeys } from '../types'\n\ninterface I18nPageProps extends PageProps {\n  locale: string\n  translations: Record<string, string>\n}\n\nexport function useI18n() {\n  const { locale, translations } = usePage<I18nPageProps>().props\n\n  const t = useMemo(() => {\n    const compiled = new Map<string, IntlMessageFormat>()\n\n    for (const [key, value] of Object.entries(translations)) {\n      compiled.set(key, new IntlMessageFormat(value, locale))\n    }\n\n    return (key: InertiaTranslationKeys, params?: MessageParams): string => {\n      const msg = compiled.get(key)\n      if (!msg) return key\n      return String(msg.format(params as Record<string, string | number | boolean>))\n    }\n  }, [locale, translations])\n\n  return { t, locale }\n}\n","/**\n * React hook for Ziggy-like client-side URL generation.\n *\n * Reads serialized routes and the current request's matched-route snapshot\n * (injected by the `routes` option on {@link InertiaModuleOptions}) and\n * provides a type-safe `route()` function that mirrors the server-side\n * `buildRouteUrl()`, plus `current()` and `params` for current-route\n * introspection.\n *\n * @module\n */\n\nimport type { PageProps } from '@inertiajs/core'\nimport { usePage } from '@inertiajs/react'\nimport { useMemo } from 'react'\nimport type { CurrentRoute, LocaleUrlConfig, RouteMatcher, RouteName, RouteParams, SerializedRoute, SerializedRoutes, TrailingSlashMode } from 'stratal/router'\n\ninterface RoutesPageProps extends PageProps {\n  routes: SerializedRoutes\n  trailingSlash?: TrailingSlashMode\n  route: CurrentRoute\n  localeConfig?: LocaleUrlConfig\n}\n\n/**\n * Apply a trailing-slash mode to a URL or path.\n *\n * Pure reimplementation of `applyTrailingSlash()` from `stratal/router` —\n * mirrored here to keep the React bundle decoupled from server-only deps.\n *\n * - `'ignore'` — return as-is.\n * - `'always'` — append `/` unless path is root or last segment is file-like (`.json`, etc.).\n * - `'never'`  — strip a single trailing `/` from the pathname (skip root).\n *\n * Preserves query string and hash. Handles relative paths and absolute URLs.\n */\nexport function applyTrailingSlash(url: string, mode: TrailingSlashMode): string {\n  if (mode === 'ignore') return url\n\n  const isAbsolute = /^https?:\\/\\//i.test(url)\n  const parsed = isAbsolute ? new URL(url) : new URL(url, 'http://placeholder.local')\n  const path = parsed.pathname\n  if (path === '/') return url\n  const hasTrailing = path.endsWith('/')\n\n  if (mode === 'always' && !hasTrailing) {\n    const lastSegment = path.slice(path.lastIndexOf('/') + 1)\n    if (lastSegment.includes('.')) return url\n    parsed.pathname = `${path}/`\n  } else if (mode === 'never' && hasTrailing) {\n    parsed.pathname = path.slice(0, -1)\n  } else {\n    return url\n  }\n\n  return isAbsolute\n    ? parsed.toString()\n    : `${parsed.pathname}${parsed.search}${parsed.hash}`\n}\n\n/**\n * Encode a path-param value while preserving forward slashes so catch-all\n * params (`:slug{.+}`) round-trip cleanly. Mirrors the server-side\n * `encodePathParam()` in `stratal/router`.\n */\nfunction encodePathParam(value: string): string {\n  return value.split('/').map(encodeURIComponent).join('/')\n}\n\n/**\n * Build a URL from a serialized route definition.\n *\n * Mirrors `buildRouteUrl()` from `stratal/router` (pure reimplementation to\n * avoid pulling server-side dependencies into the browser bundle).\n */\nfunction buildUrl(route: SerializedRoute, name: string, params?: Record<string, string>, localeConfig?: LocaleUrlConfig): string {\n  const allParams = { ...params }\n  const consumedKeys = new Set<string>()\n  let url = route.path\n\n  if (allParams.locale && route.localePaths?.length) {\n    const shouldPrefix = !localeConfig\n      || localeConfig.prefixDefaultLocale === true\n      || allParams.locale !== localeConfig.defaultLocale\n    if (shouldPrefix) {\n      url = `/${allParams.locale}${url === '/' ? '' : url}`\n    }\n    consumedKeys.add('locale')\n  }\n\n  for (const paramName of route.paramNames) {\n    const value = allParams[paramName]\n    if (value === undefined) {\n      throw new Error(`Missing required parameter \"${paramName}\" for route \"${name}\" (path: ${route.path})`)\n    }\n    url = url.replace(\n      new RegExp(`:${paramName}(\\\\{[^}]*\\\\})?`),\n      encodePathParam(value),\n    )\n    consumedKeys.add(paramName)\n  }\n\n  let domain: string | undefined\n  if (route.domain) {\n    domain = route.domain\n    for (const domainParam of route.domainParamNames) {\n      const value = allParams[domainParam]\n      if (value === undefined) {\n        throw new Error(`Missing required parameter \"${domainParam}\" for route \"${name}\" (domain: ${route.domain})`)\n      }\n      domain = domain.replace(`{${domainParam}}`, encodeURIComponent(value))\n      consumedKeys.add(domainParam)\n    }\n  }\n\n  const queryEntries = Object.entries(allParams).filter(([key]) => !consumedKeys.has(key))\n  if (queryEntries.length > 0) {\n    const queryString = queryEntries\n      .filter(([, v]) => Boolean(v))\n      .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n      .join('&')\n    url = `${url}${queryString.length ? `?${queryString}` : ''}`\n  }\n\n  if (domain) {\n    url = `https://${domain}${url}`\n  }\n\n  return url\n}\n\n/**\n * Filter a param bag down to the keys the target route actually declares —\n * so a `companyId` carried over from the current URL never leaks into the\n * query string of an unrelated route.\n */\nfunction filterCarryover(carryover: Record<string, string>, route: SerializedRoute): Record<string, string> {\n  const allowed = new Set<string>([...route.paramNames, ...route.domainParamNames])\n  if (route.localePaths?.length) allowed.add('locale')\n  if (allowed.size === 0) return {}\n\n  const filtered: Record<string, string> = {}\n  for (const [key, value] of Object.entries(carryover)) {\n    if (allowed.has(key)) filtered[key] = value\n  }\n  return filtered\n}\n\n/**\n * Pure URL resolver. Mirrors what {@link useRoute}'s `route()` does, but\n * without React — exposed for testing and for non-hook callers.\n *\n * Merges params in order (last wins): sticky `defaults`, current-route\n * carryover (filtered to the target's declared params), explicit params.\n */\nexport function resolveUrl<N extends RouteName>(\n  name: N,\n  explicitParams: RouteParams<N> | undefined,\n  routes: SerializedRoutes,\n  currentRoute: CurrentRoute,\n  trailingSlash: TrailingSlashMode = 'ignore',\n  localeConfig?: LocaleUrlConfig,\n): string {\n  const target = routes[name]\n  if (!target) {\n    throw new Error(`Route \"${name}\" not found.`)\n  }\n\n  const merged = {\n    ...currentRoute.defaults,\n    ...filterCarryover(currentRoute.params, target),\n    ...explicitParams,\n  } as Record<string, string>\n\n  return applyTrailingSlash(buildUrl(target, name, merged, localeConfig), trailingSlash)\n}\n\n/**\n * Pure overload signatures for {@link matchCurrent} / `useRoute().current()`.\n *\n * - No arg → matched route name (or `null`).\n * - With a name → `true`/`false`. Strict-typed: only real route names and\n *   dotted wildcard prefixes (`'users.*'`) are accepted.\n */\nexport function matchCurrent(currentRoute: CurrentRoute): RouteName | null\nexport function matchCurrent(currentRoute: CurrentRoute, name: RouteMatcher): boolean\nexport function matchCurrent(currentRoute: CurrentRoute, name?: RouteMatcher): RouteName | null | boolean {\n  if (name === undefined) return currentRoute.name\n  if (currentRoute.name === null) return false\n  if (typeof name === 'string' && name.endsWith('.*')) {\n    const prefix = name.slice(0, -1)\n    return currentRoute.name.startsWith(prefix)\n  }\n  return currentRoute.name === name\n}\n\n/**\n * Hook that provides Ziggy-like route URL generation in React components.\n *\n * Consumes `routes` and the current-request snapshot (`route`) from Inertia\n * shared props. Route names and params are strictly typed from\n * `StratalRouteMap` (generated by `quarry route:types`).\n *\n * Requires the `routes` option to be set on `InertiaModule.forRoot()`.\n *\n * Sticky params — anything in `defaults` (set server-side via `Uri.defaults()`)\n * and anything in the current route's extracted `params` (filtered to the\n * target route's declared params) — are merged into every `route()` call.\n * Explicit params always win.\n *\n * @returns\n * - `route(name, params?)` — URL builder\n * - `current()` / `current(name)` — matched route name (or wildcard match)\n * - `params` — extracted params for the current request URL\n *\n * @example\n * ```tsx\n * import { useRoute } from '@stratal/inertia/react'\n *\n * export default function UserProfile({ user }) {\n *   const { route, current, currentRoute } = useRoute()\n *\n *   return (\n *     <nav>\n *       <a href={route('users.index')}>All Users</a>\n *       <a href={route('users.show', { id: user.id })}>{user.name}</a>\n *       {current('users.*') && <span>On a users page</span>}\n *       {currentRoute.name === 'users.show' && <span>#{currentRoute.params.id}</span>}\n *     </nav>\n *   )\n * }\n * ```\n */\nexport function useRoute() {\n  const page = usePage<RoutesPageProps>()\n  const { routes, trailingSlash = 'ignore', route: currentRoute, localeConfig } = page.props\n\n  const route = useMemo(\n    () => <N extends RouteName>(name: N, params?: RouteParams<N>): string =>\n      resolveUrl(name, params, routes, currentRoute, trailingSlash, localeConfig),\n    [routes, trailingSlash, currentRoute, localeConfig],\n  )\n\n  const current = useMemo(\n    () => {\n      function impl(): RouteName | null\n      function impl(name: RouteMatcher): boolean\n      function impl(name?: RouteMatcher): RouteName | null | boolean {\n        return name === undefined ? matchCurrent(currentRoute) : matchCurrent(currentRoute, name)\n      }\n      return impl\n    },\n    [currentRoute],\n  )\n\n  return { route, current, currentRoute, params: currentRoute.params }\n}\n"],"mappings":"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"}

package/dist/seo-runtime.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/seo-runtime.mjs

@@ -0,0 +1,56 @@
+import { n as buildSeoTags, t as DATA_SEO_ATTR } from "./build-seo-tags-DBsHKxX9.mjs";
+import { router } from "@inertiajs/core";
+//#region src/seo/apply-seo-to-head.ts
+/**
+* Reconciles `document.head` with the resolved SEO data (client-side).
+*
+* Removes only the previously managed `[data-seo]` tags and re-creates them
+* from {@link buildSeoTags}; the title is applied via `doc.title` so the single
+* `<title>` element is updated in place rather than duplicated, and the
+* {@link DATA_SEO_ATTR} marker is re-stamped on it so the next reconcile finds
+* and replaces it instead of leaving a stale title behind.
+*
+* Pure and DOM-only (no React) so it can be unit-tested under jsdom.
+*/
+function applySeoToHead(seo, doc = document) {
+	const head = doc.head;
+	head.querySelectorAll(`[${DATA_SEO_ATTR}]`).forEach((el) => el.remove());
+	for (const descriptor of buildSeoTags(seo)) {
+		if (descriptor.tag === "title") {
+			doc.title = descriptor.content ?? "";
+			doc.head.querySelector("title")?.setAttribute(DATA_SEO_ATTR, "");
+			continue;
+		}
+		const el = doc.createElement(descriptor.tag);
+		for (const [key, value] of Object.entries(descriptor.attrs)) try {
+			el.setAttribute(key, value);
+		} catch {}
+		head.appendChild(el);
+	}
+}
+//#endregion
+//#region src/seo-runtime.ts
+/**
+* Client-side SEO head sync. Side-effect module: importing it registers a
+* single Inertia `navigate` listener that reconciles `document.head` from the
+* shared `seo` prop on every SPA visit.
+*
+* Consumers never import this directly — the `stratalInertia()` Vite plugin
+* injects it into the client entry, so backend `ctx.seo()` metadata stays in
+* sync across navigations with zero app wiring. The server still injects the
+* tags for the initial paint; this only runs on subsequent client visits.
+*/
+const INSTALLED_KEY = "__stratalInertiaSeoInstalled";
+const globalScope = globalThis;
+if (!globalScope[INSTALLED_KEY]) {
+	globalScope[INSTALLED_KEY] = true;
+	router.on("navigate", (event) => {
+		const props = event.detail.page.props;
+		if (!("seo" in props)) return;
+		applySeoToHead(props.seo ?? {});
+	});
+}
+//#endregion
+export {};
+
+//# sourceMappingURL=seo-runtime.mjs.map

package/dist/seo-runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-runtime.mjs","names":[],"sources":["../src/seo/apply-seo-to-head.ts","../src/seo-runtime.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\nimport { DATA_SEO_ATTR, buildSeoTags } from './build-seo-tags'\nimport type { SeoData } from './types'\n\n/**\n * Reconciles `document.head` with the resolved SEO data (client-side).\n *\n * Removes only the previously managed `[data-seo]` tags and re-creates them\n * from {@link buildSeoTags}; the title is applied via `doc.title` so the single\n * `<title>` element is updated in place rather than duplicated, and the\n * {@link DATA_SEO_ATTR} marker is re-stamped on it so the next reconcile finds\n * and replaces it instead of leaving a stale title behind.\n *\n * Pure and DOM-only (no React) so it can be unit-tested under jsdom.\n */\nexport function applySeoToHead(seo: SeoData, doc: Document = document): void {\n  const head = doc.head\n  // Remove only previously SEO-managed tags; unmanaged head content is untouched.\n  head.querySelectorAll(`[${DATA_SEO_ATTR}]`).forEach((el) => el.remove())\n\n  for (const descriptor of buildSeoTags(seo)) {\n    if (descriptor.tag === 'title') {\n      // `doc.title` updates the single <title> in place. Re-stamp the marker so\n      // the element is tracked as managed and replaced on the next navigation.\n      doc.title = descriptor.content ?? ''\n      doc.head.querySelector('title')?.setAttribute(DATA_SEO_ATTR, '')\n      continue\n    }\n    const el = doc.createElement(descriptor.tag)\n    for (const [key, value] of Object.entries(descriptor.attrs)) {\n      // A single malformed attribute name must not abort the reconcile and\n      // leave the head half-updated. `setAttribute` throws on invalid names,\n      // so isolate each one and skip the offending attribute only.\n      try {\n        el.setAttribute(key, value)\n      } catch {\n        // Invalid attribute name — drop this attribute, keep building the tag.\n      }\n    }\n    head.appendChild(el)\n  }\n}\n","/**\n * Client-side SEO head sync. Side-effect module: importing it registers a\n * single Inertia `navigate` listener that reconciles `document.head` from the\n * shared `seo` prop on every SPA visit.\n *\n * Consumers never import this directly — the `stratalInertia()` Vite plugin\n * injects it into the client entry, so backend `ctx.seo()` metadata stays in\n * sync across navigations with zero app wiring. The server still injects the\n * tags for the initial paint; this only runs on subsequent client visits.\n */\nimport { router } from '@inertiajs/core'\nimport { applySeoToHead } from './seo/apply-seo-to-head'\nimport type { SeoData } from './seo/types'\n\n// Guard against duplicate registration when the module is re-evaluated (e.g.\n// dev-server HMR, or the runtime injected into more than one client entry).\nconst INSTALLED_KEY = '__stratalInertiaSeoInstalled'\nconst globalScope = globalThis as Record<string, unknown>\n\nif (!globalScope[INSTALLED_KEY]) {\n  globalScope[INSTALLED_KEY] = true\n  router.on('navigate', (event) => {\n    const props = event.detail.page.props as { seo?: SeoData }\n    // The backend shares `seo` as an always-evaluated prop, so it is present on\n    // every response — including partial reloads. Only reconcile the head when\n    // the key is actually present; never act on a guessed-empty value, which\n    // would wipe managed tags a partial reload didn't intend to touch.\n    if (!('seo' in props)) return\n    applySeoToHead(props.seo ?? {})\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,eAAe,KAAc,MAAgB,UAAgB;CAC3E,MAAM,OAAO,IAAI;CAEjB,KAAK,iBAAiB,IAAI,cAAc,EAAE,EAAE,SAAS,OAAO,GAAG,OAAO,CAAC;CAEvE,KAAK,MAAM,cAAc,aAAa,GAAG,GAAG;EAC1C,IAAI,WAAW,QAAQ,SAAS;GAG9B,IAAI,QAAQ,WAAW,WAAW;GAClC,IAAI,KAAK,cAAc,OAAO,GAAG,aAAa,eAAe,EAAE;GAC/D;EACF;EACA,MAAM,KAAK,IAAI,cAAc,WAAW,GAAG;EAC3C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,WAAW,KAAK,GAIxD,IAAI;GACF,GAAG,aAAa,KAAK,KAAK;EAC5B,QAAQ,CAER;EAEF,KAAK,YAAY,EAAE;CACrB;AACF;;;;;;;;;;;;;ACzBA,MAAM,gBAAgB;AACtB,MAAM,cAAc;AAEpB,IAAI,CAAC,YAAY,gBAAgB;CAC/B,YAAY,iBAAiB;CAC7B,OAAO,GAAG,aAAa,UAAU;EAC/B,MAAM,QAAQ,MAAM,OAAO,KAAK;EAKhC,IAAI,EAAE,SAAS,QAAQ;EACvB,eAAe,MAAM,OAAO,CAAC,CAAC;CAChC,CAAC;AACH"}

package/dist/testing.d.mts

@@ -32,5 +32,5 @@ declare module '@stratal/testing' {
   }
 }
 //#endregion
-export { type InertiaPage };
+export type { InertiaPage };
 //# sourceMappingURL=testing.d.mts.map

package/dist/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","names":[],"sources":["../src/augment/test-response.ts","../src/testing.ts"],"sourcesContent":["import type { Page } from '@inertiajs/core'\nimport { getValueAtPath, hasValueAtPath, TestResponse } from '@stratal/testing'\nimport { expect } from 'vitest'\n\ndeclare module '@stratal/testing' {\n  interface TestResponse {\n    /** Assert the response is an Inertia response. Optionally run a callback with the page object for custom assertions. */\n    assertInertia(callback?: (page: Page) => void): Promise<this>\n    /** Assert the Inertia page component matches the expected name. */\n    assertInertiaComponent(component: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path equals the expected value. */\n    assertInertiaProp(path: string, expected: unknown): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path exists. */\n    assertInertiaPropExists(path: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path does not exist. */\n    assertInertiaPropMissing(path: string): Promise<this>\n    /** Assert the Inertia page URL matches the expected value. */\n    assertInertiaUrl(url: string): Promise<this>\n    /** Assert the Inertia page version matches the expected value. */\n    assertInertiaVersion(version: string | null): Promise<this>\n    /** Assert the Inertia page flash data contains the given key with the expected value. */\n    assertInertiaFlash(key: string, value: unknown): Promise<this>\n    /** Assert a prop is listed as deferred in the given group. */\n    assertInertiaDeferredProp(prop: string, group: string): Promise<this>\n    /** Assert a prop is listed as a merge prop. */\n    assertInertiaMergeProp(prop: string): Promise<this>\n    /** Assert a prop is listed as a shared prop. */\n    assertInertiaSharedProp(prop: string): Promise<this>\n    /** Assert the response is a successful precognition response (204 with precognition headers). */\n    assertSuccessfulPrecognition(): this\n    /** Assert the response is a precognition validation error (422 with precognition headers). Optionally assert specific errors. */\n    assertPrecognitionValidationErrors(errors?: Record<string, string>): Promise<this>\n  }\n}\n\nexport function augmentTestResponse(): void {\n  TestResponse.macro('assertInertia', async function (this: TestResponse, callback?: (page: Page) => void) {\n    this.assertHeader('x-inertia', 'true')\n    this.assertOk()\n\n    if (callback) {\n      const page = await this.json<Page>()\n      callback(page)\n    }\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaComponent', async function (this: TestResponse, component: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.component,\n      `Expected Inertia component \"${component}\", got \"${page.component}\"`,\n    ).toBe(component)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaProp', async function (this: TestResponse, path: string, expected: unknown) {\n    const page = await this.json<Page>()\n    const actual = getValueAtPath(page.props, path)\n\n    expect(\n      actual,\n      `Expected Inertia prop \"${path}\" to be ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(expected)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropExists', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to exist`,\n    ).toBe(true)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropMissing', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to not exist`,\n    ).toBe(false)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaUrl', async function (this: TestResponse, url: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.url,\n      `Expected Inertia URL \"${url}\", got \"${page.url}\"`,\n    ).toBe(url)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaVersion', async function (this: TestResponse, version: string | null) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.version,\n      `Expected Inertia version \"${version}\", got \"${page.version}\"`,\n    ).toBe(version)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaFlash', async function (this: TestResponse, key: string, value: unknown) {\n    const page = await this.json<Page>()\n    const actual = page.flash?.[key]\n\n    expect(\n      actual,\n      `Expected Inertia flash \"${key}\" to be ${JSON.stringify(value)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(value)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaDeferredProp', async function (this: TestResponse, prop: string, group: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.deferredProps?.[group],\n      `Expected Inertia deferred group \"${group}\" to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaMergeProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.mergeProps,\n      `Expected Inertia mergeProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaSharedProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.sharedProps,\n      `Expected Inertia sharedProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertSuccessfulPrecognition', function (this: TestResponse) {\n    this.assertNoContent()\n    this.assertHeader('Precognition', 'true')\n    this.assertHeader('Precognition-Success', 'true')\n\n    return this\n  })\n\n  TestResponse.macro('assertPrecognitionValidationErrors', async function (this: TestResponse, errors?: Record<string, string>) {\n    this.assertUnprocessable()\n    this.assertHeader('Precognition', 'true')\n\n    if (errors) {\n      const body = await this.json<{ errors: Record<string, string> }>()\n\n      expect(\n        body.errors,\n        `Expected precognition errors to match ${JSON.stringify(errors)}, got ${JSON.stringify(body.errors)}`,\n      ).toStrictEqual(errors)\n    }\n\n    return this\n  })\n}\n","import { augmentTestResponse } from './augment/test-response'\n\n// Augmentation (side-effect import: augments TestResponse types)\nimport './augment/test-response'\n\n// Patch TestResponse.prototype with Inertia assertion methods\naugmentTestResponse()\n\n// Re-export useful types for test authors\nexport type { Page as InertiaPage } from '@inertiajs/core'\n"],"mappings":"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"}
+{"version":3,"file":"testing.mjs","names":[],"sources":["../src/augment/test-response.ts","../src/testing.ts"],"sourcesContent":["import type { Page } from '@inertiajs/core'\nimport { getValueAtPath, hasValueAtPath, TestResponse } from '@stratal/testing'\nimport { expect } from 'vitest'\n\ndeclare module '@stratal/testing' {\n  interface TestResponse {\n    /** Assert the response is an Inertia response. Optionally run a callback with the page object for custom assertions. */\n    assertInertia(callback?: (page: Page) => void): Promise<this>\n    /** Assert the Inertia page component matches the expected name. */\n    assertInertiaComponent(component: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path equals the expected value. */\n    assertInertiaProp(path: string, expected: unknown): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path exists. */\n    assertInertiaPropExists(path: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path does not exist. */\n    assertInertiaPropMissing(path: string): Promise<this>\n    /** Assert the Inertia page URL matches the expected value. */\n    assertInertiaUrl(url: string): Promise<this>\n    /** Assert the Inertia page version matches the expected value. */\n    assertInertiaVersion(version: string | null): Promise<this>\n    /** Assert the Inertia page flash data contains the given key with the expected value. */\n    assertInertiaFlash(key: string, value: unknown): Promise<this>\n    /** Assert a prop is listed as deferred in the given group. */\n    assertInertiaDeferredProp(prop: string, group: string): Promise<this>\n    /** Assert a prop is listed as a merge prop. */\n    assertInertiaMergeProp(prop: string): Promise<this>\n    /** Assert a prop is listed as a shared prop. */\n    assertInertiaSharedProp(prop: string): Promise<this>\n    /** Assert the response is a successful precognition response (204 with precognition headers). */\n    assertSuccessfulPrecognition(): this\n    /** Assert the response is a precognition validation error (422 with precognition headers). Optionally assert specific errors. */\n    assertPrecognitionValidationErrors(errors?: Record<string, string>): Promise<this>\n  }\n}\n\nexport function augmentTestResponse(): void {\n  TestResponse.macro('assertInertia', async function (this: TestResponse, callback?: (page: Page) => void) {\n    this.assertHeader('x-inertia', 'true')\n    this.assertOk()\n\n    if (callback) {\n      const page = await this.json<Page>()\n      callback(page)\n    }\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaComponent', async function (this: TestResponse, component: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.component,\n      `Expected Inertia component \"${component}\", got \"${page.component}\"`,\n    ).toBe(component)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaProp', async function (this: TestResponse, path: string, expected: unknown) {\n    const page = await this.json<Page>()\n    const actual = getValueAtPath(page.props, path)\n\n    expect(\n      actual,\n      `Expected Inertia prop \"${path}\" to be ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(expected)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropExists', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to exist`,\n    ).toBe(true)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropMissing', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to not exist`,\n    ).toBe(false)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaUrl', async function (this: TestResponse, url: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.url,\n      `Expected Inertia URL \"${url}\", got \"${page.url}\"`,\n    ).toBe(url)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaVersion', async function (this: TestResponse, version: string | null) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.version,\n      `Expected Inertia version \"${version}\", got \"${page.version}\"`,\n    ).toBe(version)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaFlash', async function (this: TestResponse, key: string, value: unknown) {\n    const page = await this.json<Page>()\n    const actual = page.flash?.[key]\n\n    expect(\n      actual,\n      `Expected Inertia flash \"${key}\" to be ${JSON.stringify(value)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(value)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaDeferredProp', async function (this: TestResponse, prop: string, group: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.deferredProps?.[group],\n      `Expected Inertia deferred group \"${group}\" to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaMergeProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.mergeProps,\n      `Expected Inertia mergeProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaSharedProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.sharedProps,\n      `Expected Inertia sharedProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertSuccessfulPrecognition', function (this: TestResponse) {\n    this.assertNoContent()\n    this.assertHeader('Precognition', 'true')\n    this.assertHeader('Precognition-Success', 'true')\n\n    return this\n  })\n\n  TestResponse.macro('assertPrecognitionValidationErrors', async function (this: TestResponse, errors?: Record<string, string>) {\n    this.assertUnprocessable()\n    this.assertHeader('Precognition', 'true')\n\n    if (errors) {\n      const body = await this.json<{ errors: Record<string, string> }>()\n\n      expect(\n        body.errors,\n        `Expected precognition errors to match ${JSON.stringify(errors)}, got ${JSON.stringify(body.errors)}`,\n      ).toStrictEqual(errors)\n    }\n\n    return this\n  })\n}\n","import { augmentTestResponse } from './augment/test-response'\n\n// Augmentation (side-effect import: augments TestResponse types)\nimport './augment/test-response'\n\n// Patch TestResponse.prototype with Inertia assertion methods\naugmentTestResponse()\n\n// Re-export useful types for test authors\nexport type { Page as InertiaPage } from '@inertiajs/core'\n"],"mappings":"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"}

package/dist/{type-generator-o_PxETTs.mjs → type-generator-DFpha_Fp.mjs}

@@ -99,10 +99,8 @@ function unwrapWrapperType(type, tsObj, fallbackLocation) {
 	return widenLiteralType(type, tsObj, fallbackLocation);
 }
 function unwrapPromise(type, tsObj, fallbackLocation) {
-	if (type.getText(void 0, tsObj.TypeFormatFlags.NoTruncation).startsWith("Promise<")) {
-		const typeArgs = type.getTypeArguments();
-		if (typeArgs.length > 0) return stripReadonly(typeArgs[0], tsObj, fallbackLocation);
-	}
+	const awaited = type.getAwaitedType?.();
+	if (awaited && awaited !== type) return stripReadonly(awaited, tsObj, fallbackLocation);
 	return stripReadonly(type, tsObj, fallbackLocation);
 }
 function stripReadonly(type, tsObj, fallbackLocation) {
@@ -137,24 +135,217 @@ function extractShareCallTypes(project, SK, tsObj, srcDir) {
 	}
 	return shareTypes;
 }
-function detectI18nConfig(project, SK, moduleFilePath) {
-	const sourceFile = project.getSourceFile(moduleFilePath);
-	if (!sourceFile) return false;
-	const callExpressions = sourceFile.getDescendantsOfKind(SK.CallExpression);
-	for (const call of callExpressions) {
-		const expr = call.getExpression();
-		if (!expr.isKind(SK.PropertyAccessExpression)) continue;
-		const propName = expr.getName();
-		if (propName !== "forRoot" && propName !== "forRootAsync") continue;
-		const objExpr = expr.getExpression();
-		if (!objExpr.isKind(SK.Identifier) || objExpr.getText() !== "InertiaModule") continue;
-		const args = call.getArguments();
-		if (args.length === 0) continue;
-		const optionsArg = args[0];
-		if (!optionsArg.isKind(SK.ObjectLiteralExpression)) continue;
-		return !!optionsArg.getProperty("i18n");
+/**
+* Given the first argument of `Module.forRoot(...)` or `Module.forRootAsync(...)`,
+* return the object literal where downstream options actually live.
+*
+* - For `forRoot({...})` the literal IS the first arg.
+* - For `forRootAsync({ inject, useFactory: (...) => ({...}) })` we drill into
+*   the `useFactory`'s return value:
+*     `() => ({ … })`                  — ParenthesizedExpression → ObjectLiteral
+*     `() => ({ ... } as Foo)`         — AsExpression → ObjectLiteral
+*     `() => { return { … } }`         — Block → ReturnStatement → ObjectLiteral
+*
+* Returns `null` when nothing usable is found.
+*/
+function resolveModuleOptionsLiteral(optionsArg, SK) {
+	if (!optionsArg.isKind(SK.ObjectLiteralExpression)) return null;
+	const useFactoryProp = optionsArg.getProperty("useFactory");
+	if (useFactoryProp?.isKind(SK.PropertyAssignment)) {
+		const initializer = useFactoryProp.getInitializer();
+		if (initializer?.isKind(SK.ArrowFunction) || initializer?.isKind(SK.FunctionExpression)) {
+			const body = initializer.getBody();
+			if (body.isKind(SK.ParenthesizedExpression)) {
+				const inner = unwrapAs(body.getExpression(), SK);
+				if (inner?.isKind(SK.ObjectLiteralExpression)) return inner;
+			}
+			const unwrapped = unwrapAs(body, SK);
+			if (unwrapped?.isKind(SK.ObjectLiteralExpression)) return unwrapped;
+			if (body.isKind(SK.Block)) {
+				const returnStatements = body.getDescendantsOfKind(SK.ReturnStatement);
+				for (let i = returnStatements.length - 1; i >= 0; i--) {
+					const expr = returnStatements[i].getExpression();
+					if (!expr) continue;
+					if (expr.isKind(SK.ParenthesizedExpression)) {
+						const inner = unwrapAs(expr.getExpression(), SK);
+						if (inner?.isKind(SK.ObjectLiteralExpression)) return inner;
+						continue;
+					}
+					const direct = unwrapAs(expr, SK);
+					if (direct?.isKind(SK.ObjectLiteralExpression)) return direct;
+				}
+			}
+		}
 	}
-	return false;
+	return optionsArg;
+}
+/**
+* Strip a single `as Foo` cast if present, otherwise return the node as-is.
+* `useFactory: (env) => ({ ... } as Options)` is common in TypeScript.
+*/
+function unwrapAs(node, SK) {
+	if (!node) return void 0;
+	if (node.isKind(SK.AsExpression) || node.isKind(SK.TypeAssertionExpression)) return node.getExpression();
+	if (node.isKind(SK.SatisfiesExpression)) return node.getExpression();
+	return node;
+}
+function detectI18nConfig(project, SK, srcDir) {
+	const none = {
+		enabled: false,
+		only: []
+	};
+	const normalizedSrcDir = srcDir.replace(/\\/g, "/");
+	for (const sourceFile of project.getSourceFiles()) {
+		const filePath = sourceFile.getFilePath();
+		if (!filePath.startsWith(normalizedSrcDir)) continue;
+		if (filePath.includes("__tests__") || filePath.includes(".spec.") || filePath.includes(".test.")) continue;
+		const callExpressions = sourceFile.getDescendantsOfKind(SK.CallExpression);
+		for (const call of callExpressions) {
+			const expr = call.getExpression();
+			if (!expr.isKind(SK.PropertyAccessExpression)) continue;
+			const propName = expr.getName();
+			if (propName !== "forRoot" && propName !== "forRootAsync") continue;
+			const objExpr = expr.getExpression();
+			if (!objExpr.isKind(SK.Identifier) || objExpr.getText() !== "InertiaModule") continue;
+			const args = call.getArguments();
+			if (args.length === 0) continue;
+			const optionsLiteral = resolveModuleOptionsLiteral(args[0], SK);
+			if (optionsLiteral?.isKind(SK.ObjectLiteralExpression)) {
+				const i18nProp = optionsLiteral.getProperty("i18n");
+				if (!i18nProp) continue;
+				return {
+					enabled: true,
+					only: extractOnlyFromLiteral(i18nProp, SK)
+				};
+			}
+			const configLiteral = resolveConfigLiteralFromAsProvider(args[0], SK);
+			if (configLiteral?.isKind(SK.ObjectLiteralExpression)) {
+				const i18nProp = configLiteral.getProperty("i18n");
+				if (i18nProp) return {
+					enabled: true,
+					only: extractOnlyFromLiteral(i18nProp, SK)
+				};
+			}
+			const optionsType = resolveOptionsType(args[0], propName);
+			if (optionsType?.getProperty("i18n")) return {
+				enabled: true,
+				only: extractOnlyFromType(optionsType, args[0])
+			};
+		}
+	}
+	return none;
+}
+function resolveConfigLiteralFromAsProvider(arg, SK) {
+	if (!arg.isKind(SK.CallExpression)) return null;
+	const callExpr = arg.getExpression();
+	if (!callExpr.isKind(SK.PropertyAccessExpression)) return null;
+	if (callExpr.getName() !== "asProvider") return null;
+	const configIdentifier = callExpr.getExpression();
+	if (!configIdentifier.isKind(SK.Identifier)) return null;
+	const varDecl = resolveToVariableDeclaration(configIdentifier, SK);
+	if (!varDecl) return null;
+	return extractLiteralFromRegisterAs(varDecl, SK);
+}
+function resolveToVariableDeclaration(identifier, SK) {
+	const symbol = identifier.getSymbol();
+	if (!symbol) return null;
+	for (const decl of symbol.getDeclarations()) {
+		if (decl.isKind(SK.VariableDeclaration)) return decl;
+		if (decl.isKind(SK.ImportSpecifier)) {
+			const sourceFile = decl.getImportDeclaration().getModuleSpecifierSourceFile();
+			if (!sourceFile) continue;
+			const exportName = decl.getName();
+			const exported = sourceFile.getExportedDeclarations().get(exportName);
+			if (!exported) continue;
+			for (const exportDecl of exported) if (exportDecl.isKind(SK.VariableDeclaration)) return exportDecl;
+		}
+	}
+	return null;
+}
+function extractLiteralFromRegisterAs(varDecl, SK) {
+	if (!varDecl.isKind(SK.VariableDeclaration)) return null;
+	const init = varDecl.getInitializer();
+	if (!init?.isKind(SK.CallExpression)) return null;
+	const factoryArgs = init.getArguments();
+	if (factoryArgs.length < 2) return null;
+	const factory = factoryArgs[1];
+	if (!factory.isKind(SK.ArrowFunction) && !factory.isKind(SK.FunctionExpression)) return null;
+	const body = factory.getBody();
+	if (body.isKind(SK.ParenthesizedExpression)) {
+		const inner = unwrapAs(body.getExpression(), SK);
+		if (inner?.isKind(SK.ObjectLiteralExpression)) return inner;
+	}
+	const unwrapped = unwrapAs(body, SK);
+	if (unwrapped?.isKind(SK.ObjectLiteralExpression)) return unwrapped;
+	if (body.isKind(SK.Block)) {
+		const returnStatements = body.getDescendantsOfKind(SK.ReturnStatement);
+		for (let i = returnStatements.length - 1; i >= 0; i--) {
+			const retExpr = returnStatements[i].getExpression();
+			if (!retExpr) continue;
+			if (retExpr.isKind(SK.ParenthesizedExpression)) {
+				const inner = unwrapAs(retExpr.getExpression(), SK);
+				if (inner?.isKind(SK.ObjectLiteralExpression)) return inner;
+				continue;
+			}
+			const direct = unwrapAs(retExpr, SK);
+			if (direct?.isKind(SK.ObjectLiteralExpression)) return direct;
+		}
+	}
+	return null;
+}
+function extractOnlyFromLiteral(i18nProp, SK) {
+	const only = [];
+	if (!i18nProp.isKind(SK.PropertyAssignment)) return only;
+	const init = i18nProp.getInitializer();
+	if (!init?.isKind(SK.ObjectLiteralExpression)) return only;
+	const onlyProp = init.getProperty("only");
+	if (!onlyProp?.isKind(SK.PropertyAssignment)) return only;
+	const onlyInit = onlyProp.getInitializer();
+	if (!onlyInit?.isKind(SK.ArrayLiteralExpression)) return only;
+	for (const el of onlyInit.getElements()) if (el.isKind(SK.StringLiteral)) only.push(el.getLiteralValue());
+	return only;
+}
+function resolveOptionsType(arg, methodName) {
+	const argType = arg.getType();
+	if (methodName === "forRoot") return argType;
+	const useFactorySymbol = argType.getProperty("useFactory");
+	if (!useFactorySymbol) return null;
+	const signatures = useFactorySymbol.getTypeAtLocation(arg).getCallSignatures();
+	if (signatures.length === 0) return null;
+	const returnType = signatures[0].getReturnType();
+	if (returnType.isUnion()) {
+		for (const member of returnType.getUnionTypes()) if (member.getProperty("i18n")) return member;
+		return null;
+	}
+	return returnType;
+}
+function extractOnlyFromType(optionsType, locationNode) {
+	const i18nSymbol = optionsType.getProperty("i18n");
+	if (!i18nSymbol) return [];
+	const onlySymbol = i18nSymbol.getTypeAtLocation(locationNode).getProperty("only");
+	if (!onlySymbol) return [];
+	const elementType = onlySymbol.getTypeAtLocation(locationNode).getNumberIndexType();
+	if (!elementType) return [];
+	const result = [];
+	if (elementType.isUnion()) {
+		for (const member of elementType.getUnionTypes()) if (member.isStringLiteral()) result.push(member.getLiteralValue());
+	} else if (elementType.isStringLiteral()) result.push(elementType.getLiteralValue());
+	return result;
+}
+/**
+* Collect every string-literal value a flash-key argument can resolve to.
+*
+* A direct string literal yields a single key. A conditional expression
+* (`cond ? 'a' : 'b'`, including nested ternaries) contributes the literals
+* from each branch. Non-literal keys (variables, template strings) yield
+* nothing — they can't be statically known.
+*/
+function collectFlashKeyLiterals(node, SK) {
+	const stringLiteral = node.asKind(SK.StringLiteral);
+	if (stringLiteral) return [stringLiteral.getLiteralValue()];
+	const conditional = node.asKind(SK.ConditionalExpression);
+	if (conditional) return [...collectFlashKeyLiterals(conditional.getWhenTrue(), SK), ...collectFlashKeyLiterals(conditional.getWhenFalse(), SK)];
+	return [];
 }
 function extractFlashTypes(project, SK, tsObj, srcDir) {
 	const flashMembers = /* @__PURE__ */ new Map();
@@ -169,12 +360,13 @@ function extractFlashTypes(project, SK, tsObj, srcDir) {
 			if (expr.getName() !== "flash") continue;
 			const args = call.getArguments();
 			if (args.length < 2) continue;
-			const keyArg = args[0];
-			if (!keyArg.isKind(SK.StringLiteral)) continue;
-			const key = keyArg.getLiteralValue();
-			if (flashMembers.has(key)) continue;
+			const keys = collectFlashKeyLiterals(args[0], SK);
+			if (keys.length === 0) continue;
 			const valueType = widenLiteralType(args[1].getType(), tsObj);
-			flashMembers.set(key, valueType);
+			for (const key of keys) {
+				if (flashMembers.has(key)) continue;
+				flashMembers.set(key, valueType);
+			}
 		}
 	}
 	if (flashMembers.size === 0) return null;
@@ -194,9 +386,9 @@ function extractSharedDataType(project, SK, tsObj, moduleFilePath) {
 		if (!objExpr.isKind(SK.Identifier) || objExpr.getText() !== "InertiaModule") continue;
 		const args = call.getArguments();
 		if (args.length === 0) continue;
-		const optionsArg = args[0];
-		if (!optionsArg.isKind(SK.ObjectLiteralExpression)) continue;
-		const sharedDataProp = optionsArg.getProperty("sharedData");
+		const optionsLiteral = resolveModuleOptionsLiteral(args[0], SK);
+		if (!optionsLiteral || !optionsLiteral.isKind(SK.ObjectLiteralExpression)) continue;
+		const sharedDataProp = optionsLiteral.getProperty("sharedData");
 		if (!sharedDataProp) continue;
 		if (!sharedDataProp.isKind(SK.PropertyAssignment)) continue;
 		const initializer = sharedDataProp.getInitializer();
@@ -243,7 +435,7 @@ function resolvePagePropsTypeNames(pages) {
 	return result;
 }
 function generateInertiaTypes(input) {
-	const { pages, sharedData, shareCallTypes, hasI18n, flashTypes } = input;
+	const { pages, sharedData, shareCallTypes, i18n, flashTypes } = input;
 	const typeNames = resolvePagePropsTypeNames(pages);
 	const lines = ["// Auto-generated by @stratal/inertia. Do not edit."];
 	if (pages.length > 0) {
@@ -262,6 +454,12 @@ function generateInertiaTypes(input) {
 		lines.push(`    '${page.componentName}': ${typeName}`);
 	}
 	lines.push("  }");
+	if (i18n.enabled && i18n.only.length > 0) {
+		const prefixUnion = i18n.only.map((p) => `'${p}'`).join(" | ");
+		lines.push("  interface InertiaI18nConfig {");
+		lines.push(`    translationKeys: import('stratal/i18n').FilterByPrefix<import('stratal/i18n').MessageKeys, ${prefixUnion}>`);
+		lines.push("  }");
+	}
 	lines.push("}");
 	const configMembers = [];
 	if (flashTypes && flashTypes.members.length > 0) {
@@ -270,7 +468,7 @@ function generateInertiaTypes(input) {
 	}
 	const sharedMembers = [];
 	if (sharedData) for (const member of sharedData.members) sharedMembers.push(`      ${member.name}${member.optional ? "?" : ""}: ${member.type}`);
-	if (hasI18n) {
+	if (i18n.enabled) {
 		sharedMembers.push("      locale: string");
 		sharedMembers.push("      translations: Record<string, string>");
 	}
@@ -297,6 +495,7 @@ function widenLiteralType(type, tsObj, fallbackLocation) {
 	return typeToString(type, tsObj, fallbackLocation);
 }
 function typeToString(type, tsObj, fallbackLocation) {
+	if (type.isUnion() && type.getAliasSymbol?.()?.getName() === "MessageKeys") return "import('@stratal/inertia').InertiaTranslationKeys";
 	if (type.isObject() || type.isUnion() || type.isIntersection()) return expandTypeToInline(type, tsObj, fallbackLocation);
 	const text = type.getText(void 0, tsObj.TypeFormatFlags.NoTruncation | tsObj.TypeFormatFlags.UseFullyQualifiedType);
 	if (text.includes("import(")) return expandTypeToInline(type, tsObj, fallbackLocation);
@@ -341,7 +540,10 @@ function expandTypeToInline(type, tsObj, fallbackLocation, visiting = /* @__PURE
 				return type.isReadonlyArray() ? `ReadonlyArray<${inner}>` : `Array<${inner}>`;
 			}
 		}
-		if (type.isUnion()) return type.getUnionTypes().map((t) => expandTypeToInline(t, tsObj, fallbackLocation, visiting)).join(" | ");
+		if (type.isUnion()) {
+			if (type.getAliasSymbol?.()?.getName() === "MessageKeys") return "import('@stratal/inertia').InertiaTranslationKeys";
+			return type.getUnionTypes().map((t) => expandTypeToInline(t, tsObj, fallbackLocation, visiting)).join(" | ");
+		}
 		if (type.isIntersection()) return type.getIntersectionTypes().map((t) => expandTypeToInline(t, tsObj, fallbackLocation, visiting)).join(" & ");
 		const text = type.getText(void 0, tsObj.TypeFormatFlags.NoTruncation);
 		if (text.includes("import(")) return "unknown";
@@ -381,12 +583,12 @@ async function runTypeGeneration(cwd) {
 	const { project, SyntaxKind, ts } = await createProject(findTsConfigPath(cwd));
 	const pages = extractControllerPageTypes(project, SyntaxKind, ts, srcDir, pagesDir);
 	const sharedData = moduleFilePath ? extractSharedDataType(project, SyntaxKind, ts, moduleFilePath) : null;
-	const hasI18n = moduleFilePath ? detectI18nConfig(project, SyntaxKind, moduleFilePath) : false;
+	const i18n = detectI18nConfig(project, SyntaxKind, srcDir);
 	writeInertiaTypes(outputPath, generateInertiaTypes({
 		pages,
 		sharedData,
 		shareCallTypes: extractShareCallTypes(project, SyntaxKind, ts, srcDir),
-		hasI18n,
+		i18n,
 		flashTypes: extractFlashTypes(project, SyntaxKind, ts, srcDir)
 	}));
 	return {
@@ -397,4 +599,4 @@ async function runTypeGeneration(cwd) {
 //#endregion
 export { runTypeGeneration as n, findPagesDir as t };
 
-//# sourceMappingURL=type-generator-o_PxETTs.mjs.map
+//# sourceMappingURL=type-generator-DFpha_Fp.mjs.map