@xndrjs/i18n-react 0.8.0-alpha.0 → 0.8.1

package/dist/index.d.ts

@@ -71,8 +71,13 @@ interface LoadCoordinator<Scope> {
     readonly revision: number;
     /** @deprecated Prefer {@link ensure}. */
     request(input: LoadCoordinatorRequest<Scope>): void;
-    /** Idempotent: start load if missing. Safe from getSnapshot. */
+    /** Idempotent: start load if missing. Safe from client getSnapshot. */
     ensure(input: LoadCoordinatorRequest<Scope>): void;
+    /**
+     * Idempotent: resolve from {@link LoadCoordinatorRequest.tryResolveSync} only.
+     * Never starts `load()` — use from SSR `getServerSnapshot`.
+     */
+    ensureSync(input: LoadCoordinatorRequest<Scope>): void;
     getEntry(key: LoadCoordinatorKey): LoadCoordinatorEntry<Scope>;
     getDisplayEntry(key: LoadCoordinatorKey, options: GetDisplayEntryOptions): LoadDisplayEntry<Scope>;
     /** Evict entry so the next ensure() re-fetches. */
@@ -108,6 +113,14 @@ interface I18nHandleLike {
         dictionary: unknown;
         resources: readonly (readonly [string, string])[];
     };
+    getLoadState: () => {
+        resources: readonly {
+            namespace: string;
+            partition: string;
+            status: "pending" | "loaded" | "error";
+            error?: unknown;
+        }[];
+    };
 }
 /** Single React context value for the lazy i18n tree. */
 interface I18nRootContextValue {
@@ -141,7 +154,7 @@ declare function createLoadCoordinator<Scope = ScopedScopeLike>(): LoadCoordinat
 
 /**
  * Manual (non-Suspense) i18n load gate: ensure + subscribe via the load
- * coordinator, then render fallback / keep-previous / error UI.
+ * coordinator, then render fallback / keep-previous / error UI / throw.
  */
 
 /** Inputs for {@link useNamespaceLoad}. */
@@ -157,7 +170,8 @@ interface UseNamespaceLoadInput<Scope> {
 }
 /**
  * Starts (or reuses) a coordinator load and re-renders when that entry settles.
- * Kick-off is idempotent inside the snapshot getter (safe with useSyncExternalStore).
+ * Client getSnapshot may kick `load()`; SSR getServerSnapshot only peeks sync
+ * (hydrated `state`) and never starts a client fetch during prerender.
  */
 declare function useNamespaceLoad<Scope>(input: UseNamespaceLoadInput<Scope>): LoadDisplayEntry<Scope>;
 /** Scoped `{ t, locale }` injected into gate children / HOC when ready (or kept). */
@@ -189,8 +203,12 @@ interface CreateI18nLoadGateOptions {
 }
 interface I18nGateProps {
     namespaces: readonly string[];
+    /** Shown only while the load is pending (not on error). */
     fallback?: ReactNode;
-    /** When set, called for error with no keep-previous display. */
+    /**
+     * When set, called for error with no keep-previous display.
+     * Otherwise the load error is thrown for a React error boundary.
+     */
     renderError?: (args: {
         error: unknown;
         retry: () => void;

package/dist/index.js

@@ -69,6 +69,34 @@ function createLoadCoordinator() {
     }
     notify();
   }
+  function markResolvedSync(key, syncScope) {
+    const entrySnapshot = {
+      status: "resolved",
+      scope: syncScope
+    };
+    entries.set(key, {
+      status: "resolved",
+      promise: Promise.resolve(syncScope),
+      resolvedScope: syncScope,
+      error: null,
+      requestId: ++nextRequestId,
+      entrySnapshot
+    });
+  }
+  function ensureSync(input) {
+    const key = cacheKey(input.engineRef, input.partition, input.namespaces);
+    lastKey = key;
+    if (entries.has(key)) {
+      return;
+    }
+    if (input.tryResolveSync === void 0) {
+      return;
+    }
+    const syncScope = input.tryResolveSync();
+    if (syncScope !== null) {
+      markResolvedSync(key, syncScope);
+    }
+  }
   function ensure(input) {
     const key = cacheKey(input.engineRef, input.partition, input.namespaces);
     lastKey = key;
@@ -79,18 +107,7 @@ function createLoadCoordinator() {
     if (input.tryResolveSync !== void 0) {
       const syncScope = input.tryResolveSync();
       if (syncScope !== null) {
-        const entrySnapshot = {
-          status: "resolved",
-          scope: syncScope
-        };
-        entries.set(key, {
-          status: "resolved",
-          promise: Promise.resolve(syncScope),
-          resolvedScope: syncScope,
-          error: null,
-          requestId: ++nextRequestId,
-          entrySnapshot
-        });
+        markResolvedSync(key, syncScope);
         return;
       }
     }
@@ -120,7 +137,9 @@ function createLoadCoordinator() {
         throw error;
       }
     );
-    void promise.catch(() => void 0);
+    void promise.catch((error) => {
+      console.error("[i18n-react] namespace load failed:", error);
+    });
     entries.set(key, {
       status: "pending",
       promise,
@@ -245,6 +264,7 @@ function createLoadCoordinator() {
     },
     request: ensure,
     ensure,
+    ensureSync,
     getEntry,
     getDisplayEntry,
     retry: retryKey,
@@ -271,29 +291,20 @@ function useNamespaceLoad(input) {
     load,
     ...tryResolveSync !== void 0 ? { tryResolveSync } : {}
   };
+  const displayOptions = {
+    locale,
+    namespaces,
+    ...keepPrevious !== void 0 ? { keepPrevious } : {}
+  };
   return useSyncExternalStore(
     coordinator.subscribe,
     () => {
       coordinator.ensure(request);
-      return coordinator.getDisplayEntry(
-        { engineRef, partition, namespaces },
-        {
-          locale,
-          namespaces,
-          ...keepPrevious !== void 0 ? { keepPrevious } : {}
-        }
-      );
+      return coordinator.getDisplayEntry({ engineRef, partition, namespaces }, displayOptions);
     },
     () => {
-      coordinator.ensure(request);
-      return coordinator.getDisplayEntry(
-        { engineRef, partition, namespaces },
-        {
-          locale,
-          namespaces,
-          ...keepPrevious !== void 0 ? { keepPrevious } : {}
-        }
-      );
+      coordinator.ensureSync(request);
+      return coordinator.getDisplayEntry({ engineRef, partition, namespaces }, displayOptions);
     }
   );
 }
@@ -303,6 +314,15 @@ function resolveNamespaces(namespaces) {
   }
   return namespaces;
 }
+function toThrownError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  if (typeof error === "string") {
+    return new Error(error);
+  }
+  return new Error("i18n namespace load failed");
+}
 function renderDisplayEntry(entry, options) {
   if (entry.status === "ready") {
     return options.children({ t: entry.t, locale: entry.locale });
@@ -311,7 +331,7 @@ function renderDisplayEntry(entry, options) {
     if (options.renderError) {
       return options.renderError({ error: entry.error, retry: entry.retry });
     }
-    return options.fallback ?? null;
+    throw toThrownError(entry.error);
   }
   if (entry.t !== null && entry.display) {
     const value = {
@@ -358,7 +378,7 @@ function createI18nLoadGate(options) {
     const { fallback, renderError } = hocOptions;
     const Outer = forwardRef(function I18nHocOuter(props, ref) {
       const entry = useGateEntry(hocOptions.namespaces);
-      const needsFallback = entry.status !== "ready" && entry.t === null;
+      const needsFallback = entry.status === "pending" && entry.t === null;
       const resolvedFallback = !needsFallback || fallback === void 0 ? void 0 : typeof fallback === "function" ? fallback(props) : fallback;
       return renderDisplayEntry(entry, {
         ...resolvedFallback !== void 0 ? { fallback: resolvedFallback } : {},

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/create-scoped-t.ts","../src/create-load-coordinator.ts","../src/namespace-load-gate.tsx","../src/root-context.tsx","../src/root-provider.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Builds the scoped `t` function used by providers and load gates.\n *\n * Takes a loaded `@xndrjs/i18n` scope and returns a capability-safe translator:\n * namespaces outside the provider list throw at runtime. Locale is always bound.\n */\nimport type { CreateScopedTOptions, ScopedScopeLike, ScopedTranslateFn } from \"./types.js\";\n\nfunction assertNamespace(namespace: string, namespaces: readonly string[]): void {\n  if (!namespaces.includes(namespace)) {\n    throw new Error(\n      `Namespace \"${namespace}\" is not loaded by this provider. Allowed: [${namespaces.join(\", \")}]`\n    );\n  }\n}\n\nfunction resolveActiveScope(scope: ScopedScopeLike, locale: string): ScopedScopeLike {\n  if (typeof scope.forLocale === \"function\" && scope.locale !== locale) {\n    return scope.forLocale(locale);\n  }\n  return scope;\n}\n\n/**\n * Wraps a loaded scope `t` with namespace guards and locale binding.\n */\nexport function createScopedT(\n  scope: ScopedScopeLike,\n  options: CreateScopedTOptions\n): ScopedTranslateFn {\n  const activeScope = resolveActiveScope(scope, options.locale);\n  const { namespaces } = options;\n\n  return ((namespace: string, key: string, ...rest: unknown[]) => {\n    assertNamespace(namespace, namespaces);\n    return activeScope.t(namespace, key, ...rest);\n  }) as ScopedTranslateFn;\n}\n\n/**\n * Curries a multi-namespace context `t(ns, key, …)` into a namespace-bound `t(key, …)`.\n * Used when composing gate values without introducing a separate hooks API.\n */\nexport function bindNamespaceTranslate(\n  t: ScopedTranslateFn,\n  namespace: string\n): (key: string, params?: Record<string, unknown>) => string {\n  return (key: string, params?: Record<string, unknown>) =>\n    params === undefined ? t(namespace, key) : t(namespace, key, params);\n}\n","/**\n * Load deduplication for lazy i18n namespace gates / HOCs.\n *\n * Supports multiple concurrent keys so parallel per-namespace gates can share\n * one coordinator. Each `(engine, partition, namespaces)` entry keeps its own\n * promise and status. Display state (keep-previous / pendingLocale / stable `t`)\n * lives here so gate components stay pure observers of `useSyncExternalStore`.\n */\nimport { createScopedT } from \"./create-scoped-t.js\";\nimport type {\n  GetDisplayEntryOptions,\n  LoadCoordinator,\n  LoadCoordinatorEntry,\n  LoadCoordinatorKey,\n  LoadCoordinatorRequest,\n  LoadDisplayEntry,\n  ScopedScopeLike,\n  ScopedTranslateFn,\n} from \"./types.js\";\n\nconst engineIds = new WeakMap<object, number>();\nlet nextEngineId = 1;\n\nfunction engineId(ref: unknown): number {\n  if (ref === null || (typeof ref !== \"object\" && typeof ref !== \"function\")) {\n    return 0;\n  }\n  const obj = ref as object;\n  let id = engineIds.get(obj);\n  if (id === undefined) {\n    id = nextEngineId++;\n    engineIds.set(obj, id);\n  }\n  return id;\n}\n\nfunction cacheKey(\n  engineRef: unknown,\n  partition: string | undefined,\n  namespaces: readonly string[]\n): string {\n  return `${engineId(engineRef)}\\0${partition ?? \"\"}\\0${namespaces.join(\"\\0\")}`;\n}\n\n/** Gate identity for keep-previous (namespaces only — partition/locale can change). */\nfunction gateId(engineRef: unknown, namespaces: readonly string[]): string {\n  return `${engineId(engineRef)}\\0${namespaces.join(\"\\0\")}`;\n}\n\ninterface CacheEntry<Scope> {\n  status: \"pending\" | \"resolved\" | \"error\";\n  promise: Promise<Scope>;\n  resolvedScope: Scope | null;\n  error: unknown;\n  requestId: number;\n  /** Stable LoadCoordinatorEntry snapshot for getEntry(). */\n  entrySnapshot: LoadCoordinatorEntry<Scope>;\n}\n\ninterface DisplayCache {\n  lastReady: { scope: ScopedScopeLike; locale: string } | null;\n  /** Stable display entry object until inputs change. */\n  displaySnapshot: LoadDisplayEntry<ScopedScopeLike> | null;\n  /** Identity key for the last displaySnapshot. */\n  displayKey: string | null;\n  boundT: ScopedTranslateFn | null;\n  boundTKey: string | null;\n}\n\n/**\n * Dedupes in-flight loads by `(engineRef, partition, namespaces)` and exposes\n * display snapshots + retry for manual pending/resolved/error rendering.\n */\nexport function createLoadCoordinator<Scope = ScopedScopeLike>(): LoadCoordinator<Scope> {\n  let revision = 0;\n  let nextRequestId = 0;\n  const entries = new Map<string, CacheEntry<Scope>>();\n  const displayByGate = new Map<string, DisplayCache>();\n  const listeners = new Set<() => void>();\n  let lastKey: string | null = null;\n\n  function notify(): void {\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  function bumpAndNotify(): void {\n    revision += 1;\n    // Invalidate display snapshots that depend on entry status.\n    for (const display of displayByGate.values()) {\n      display.displaySnapshot = null;\n      display.displayKey = null;\n    }\n    notify();\n  }\n\n  function ensure(input: LoadCoordinatorRequest<Scope>): void {\n    const key = cacheKey(input.engineRef, input.partition, input.namespaces);\n    lastKey = key;\n\n    const existing = entries.get(key);\n    if (existing !== undefined) {\n      return;\n    }\n\n    if (input.tryResolveSync !== undefined) {\n      const syncScope = input.tryResolveSync();\n      if (syncScope !== null) {\n        const entrySnapshot: LoadCoordinatorEntry<Scope> = {\n          status: \"resolved\",\n          scope: syncScope,\n        };\n        entries.set(key, {\n          status: \"resolved\",\n          promise: Promise.resolve(syncScope),\n          resolvedScope: syncScope,\n          error: null,\n          requestId: ++nextRequestId,\n          entrySnapshot,\n        });\n        return;\n      }\n    }\n\n    const requestId = ++nextRequestId;\n    const promise = input.load().then(\n      (scope) => {\n        const entry = entries.get(key);\n        if (entry === undefined || entry.requestId !== requestId) {\n          return scope;\n        }\n        entry.status = \"resolved\";\n        entry.resolvedScope = scope;\n        entry.error = null;\n        entry.entrySnapshot = { status: \"resolved\", scope };\n        bumpAndNotify();\n        return scope;\n      },\n      (error: unknown) => {\n        const entry = entries.get(key);\n        if (entry !== undefined && entry.requestId === requestId) {\n          entry.status = \"error\";\n          entry.error = error;\n          entry.resolvedScope = null;\n          entry.entrySnapshot = { status: \"error\", error };\n          bumpAndNotify();\n        }\n        throw error;\n      }\n    );\n    // Mark rejection handled when only getEntry consumers attach (no getPromise).\n    void promise.catch(() => void null);\n\n    entries.set(key, {\n      status: \"pending\",\n      promise,\n      resolvedScope: null,\n      error: null,\n      requestId,\n      entrySnapshot: { status: \"pending\" },\n    });\n  }\n\n  function getEntry(keyInput: LoadCoordinatorKey): LoadCoordinatorEntry<Scope> {\n    const key = cacheKey(keyInput.engineRef, keyInput.partition, keyInput.namespaces);\n    const entry = entries.get(key);\n    if (entry === undefined) {\n      return { status: \"pending\" };\n    }\n    return entry.entrySnapshot;\n  }\n\n  function getOrCreateDisplay(engineRef: unknown, namespaces: readonly string[]): DisplayCache {\n    const id = gateId(engineRef, namespaces);\n    let display = displayByGate.get(id);\n    if (display === undefined) {\n      display = {\n        lastReady: null,\n        displaySnapshot: null,\n        displayKey: null,\n        boundT: null,\n        boundTKey: null,\n      };\n      displayByGate.set(id, display);\n    }\n    return display;\n  }\n\n  function bindT(\n    display: DisplayCache,\n    scope: ScopedScopeLike,\n    locale: string,\n    namespaces: readonly string[],\n    scopeToken: string\n  ): ScopedTranslateFn {\n    const tKey = `${scopeToken}\\0${locale}\\0${namespaces.join(\"\\0\")}`;\n    if (display.boundT !== null && display.boundTKey === tKey) {\n      return display.boundT;\n    }\n    const t = createScopedT(scope, { namespaces, locale });\n    display.boundT = t;\n    display.boundTKey = tKey;\n    return t;\n  }\n\n  function getDisplayEntry(\n    keyInput: LoadCoordinatorKey,\n    options: GetDisplayEntryOptions\n  ): LoadDisplayEntry<Scope> {\n    const key = cacheKey(keyInput.engineRef, keyInput.partition, keyInput.namespaces);\n    const entry = entries.get(key);\n    const display = getOrCreateDisplay(keyInput.engineRef, options.namespaces);\n    const keepPrevious = options.keepPrevious !== false;\n\n    const retry = () => {\n      retryKey(keyInput);\n    };\n\n    let result: LoadDisplayEntry<Scope>;\n\n    if (entry === undefined || entry.status === \"pending\") {\n      const kept = keepPrevious ? display.lastReady : null;\n      result = {\n        status: \"pending\",\n        display: kept as { scope: Scope & ScopedScopeLike; locale: string } | null,\n        pendingLocale: kept ? options.locale : undefined,\n        t: kept\n          ? bindT(display, kept.scope, kept.locale, options.namespaces, `kept:${kept.locale}`)\n          : null,\n      } as LoadDisplayEntry<Scope>;\n    } else if (entry.status === \"resolved\") {\n      const scope = entry.resolvedScope as Scope & ScopedScopeLike;\n      display.lastReady = { scope, locale: options.locale };\n      result = {\n        status: \"ready\",\n        scope,\n        locale: options.locale,\n        t: bindT(display, scope, options.locale, options.namespaces, `ready:${key}`),\n      } as LoadDisplayEntry<Scope>;\n    } else {\n      const kept = keepPrevious ? display.lastReady : null;\n      result = {\n        status: \"error\",\n        error: entry.error,\n        display: kept as { scope: Scope & ScopedScopeLike; locale: string } | null,\n        pendingLocale: kept ? options.locale : undefined,\n        t: kept\n          ? bindT(display, kept.scope, kept.locale, options.namespaces, `kept:${kept.locale}`)\n          : null,\n        retry,\n      } as LoadDisplayEntry<Scope>;\n    }\n\n    const displayKey = `${key}\\0${result.status}\\0${options.locale}\\0${String(!!result.t)}`;\n    if (display.displaySnapshot !== null && display.displayKey === displayKey) {\n      return display.displaySnapshot as LoadDisplayEntry<Scope>;\n    }\n    display.displaySnapshot = result as LoadDisplayEntry<ScopedScopeLike>;\n    display.displayKey = displayKey;\n    return result;\n  }\n\n  function retryKey(keyInput: LoadCoordinatorKey): void {\n    const key = cacheKey(keyInput.engineRef, keyInput.partition, keyInput.namespaces);\n    if (!entries.has(key)) {\n      return;\n    }\n    entries.delete(key);\n    bumpAndNotify();\n  }\n\n  function subscribe(listener: () => void): () => void {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  }\n\n  function getPromise(): Promise<Scope> {\n    if (lastKey === null) {\n      throw new Error(\"createLoadCoordinator: call ensure()/request() before getPromise()\");\n    }\n    const entry = entries.get(lastKey);\n    if (entry === undefined) {\n      throw new Error(\"createLoadCoordinator: call ensure()/request() before getPromise()\");\n    }\n    return entry.promise;\n  }\n\n  function getResolvedScope(): Scope | null {\n    if (lastKey === null) {\n      return null;\n    }\n    const entry = entries.get(lastKey);\n    return entry?.status === \"resolved\" ? entry.resolvedScope : null;\n  }\n\n  return {\n    get revision() {\n      return revision;\n    },\n    request: ensure,\n    ensure,\n    getEntry,\n    getDisplayEntry,\n    retry: retryKey,\n    subscribe,\n    getPromise,\n    getResolvedScope,\n  };\n}\n","/**\n * Manual (non-Suspense) i18n load gate: ensure + subscribe via the load\n * coordinator, then render fallback / keep-previous / error UI.\n */\nimport {\n  forwardRef,\n  useSyncExternalStore,\n  type ForwardedRef,\n  type ForwardRefExoticComponent,\n  type ReactNode,\n  type RefAttributes,\n} from \"react\";\nimport type {\n  LoadCoordinator,\n  LoadCoordinatorRequest,\n  LoadDisplayEntry,\n  LoadPartition,\n  ScopedScopeLike,\n  ScopedTranslateFn,\n} from \"./types.js\";\n\n/** Inputs for {@link useNamespaceLoad}. */\nexport interface UseNamespaceLoadInput<Scope> {\n  coordinator: LoadCoordinator<Scope>;\n  engineRef: unknown;\n  partition: LoadPartition;\n  namespaces: readonly string[];\n  locale: string;\n  load: () => Promise<Scope>;\n  tryResolveSync?: () => Scope | null;\n  keepPrevious?: boolean;\n}\n\n/**\n * Starts (or reuses) a coordinator load and re-renders when that entry settles.\n * Kick-off is idempotent inside the snapshot getter (safe with useSyncExternalStore).\n */\nexport function useNamespaceLoad<Scope>(\n  input: UseNamespaceLoadInput<Scope>\n): LoadDisplayEntry<Scope> {\n  const {\n    coordinator,\n    engineRef,\n    partition,\n    namespaces,\n    locale,\n    load,\n    tryResolveSync,\n    keepPrevious,\n  } = input;\n\n  const request: LoadCoordinatorRequest<Scope> = {\n    engineRef,\n    partition,\n    namespaces,\n    load,\n    ...(tryResolveSync !== undefined ? { tryResolveSync } : {}),\n  };\n\n  return useSyncExternalStore(\n    coordinator.subscribe,\n    () => {\n      coordinator.ensure(request);\n      return coordinator.getDisplayEntry(\n        { engineRef, partition, namespaces },\n        {\n          locale,\n          namespaces,\n          ...(keepPrevious !== undefined ? { keepPrevious } : {}),\n        }\n      );\n    },\n    () => {\n      coordinator.ensure(request);\n      return coordinator.getDisplayEntry(\n        { engineRef, partition, namespaces },\n        {\n          locale,\n          namespaces,\n          ...(keepPrevious !== undefined ? { keepPrevious } : {}),\n        }\n      );\n    }\n  );\n}\n\n/** Scoped `{ t, locale }` injected into gate children / HOC when ready (or kept). */\nexport interface I18nLoadGateValue {\n  t: ScopedTranslateFn;\n  locale: string;\n  /** Set during keep-then-switch while a new partition is loading. */\n  pendingLocale?: string;\n  error?: unknown;\n  retry?: () => void;\n}\n\n/** Load wiring from React context (coordinator, engine, partition, load). */\nexport interface I18nLoadArgs {\n  coordinator: LoadCoordinator<ScopedScopeLike>;\n  engineRef: unknown;\n  partition: LoadPartition;\n  locale: string;\n  load: (namespaces: readonly string[]) => Promise<ScopedScopeLike>;\n  tryResolveSync?: (namespaces: readonly string[]) => ScopedScopeLike | null;\n}\n\nexport interface CreateI18nLoadGateOptions {\n  /**\n   * When true (default), keep last resolved `{ t, locale }` while a new\n   * partition is pending instead of showing fallback.\n   */\n  keepPreviousOnPartitionChange?: boolean;\n  /** Hook that resolves coordinator + load inputs from React context. */\n  useLoadArgs: () => I18nLoadArgs;\n}\n\nexport interface I18nGateProps {\n  namespaces: readonly string[];\n  fallback?: ReactNode;\n  /** When set, called for error with no keep-previous display. */\n  renderError?: (args: { error: unknown; retry: () => void }) => ReactNode;\n  children: (value: I18nLoadGateValue) => ReactNode;\n}\n\n/** Pending UI for `withI18n` — static node or derived from own props. */\nexport type WithI18nFallback<P extends object> = ReactNode | ((props: P) => ReactNode);\n\nexport interface I18nHocOptions<P extends object = object> {\n  namespaces: readonly string[];\n  fallback?: WithI18nFallback<P>;\n  renderError?: (args: { error: unknown; retry: () => void; props: P }) => ReactNode;\n}\n\n/** Render fn for `withI18n`: own props, i18n bag, optional forwarded ref. */\nexport type WithI18nRender<P extends object, R = never> = (\n  props: P,\n  i18n: I18nLoadGateValue,\n  ref?: ForwardedRef<R>\n) => ReactNode;\n\nfunction resolveNamespaces(namespaces: readonly string[] | undefined): readonly string[] {\n  if (namespaces === undefined || namespaces.length === 0) {\n    throw new Error(\"withI18n / I18n: requires a non-empty namespaces list\");\n  }\n  return namespaces;\n}\n\nfunction renderDisplayEntry(\n  entry: LoadDisplayEntry<ScopedScopeLike>,\n  options: {\n    fallback?: ReactNode;\n    renderError?: (args: { error: unknown; retry: () => void }) => ReactNode;\n    children: (value: I18nLoadGateValue) => ReactNode;\n  }\n): ReactNode {\n  if (entry.status === \"ready\") {\n    return options.children({ t: entry.t, locale: entry.locale });\n  }\n\n  if (entry.status === \"error\" && entry.t === null) {\n    if (options.renderError) {\n      return options.renderError({ error: entry.error, retry: entry.retry });\n    }\n    return options.fallback ?? null;\n  }\n\n  if (entry.t !== null && entry.display) {\n    const value: I18nLoadGateValue = {\n      t: entry.t,\n      locale: entry.display.locale,\n    };\n    if (entry.pendingLocale !== undefined) {\n      value.pendingLocale = entry.pendingLocale;\n    }\n    if (entry.status === \"error\") {\n      value.error = entry.error;\n      value.retry = entry.retry;\n    }\n    return options.children(value);\n  }\n\n  return options.fallback ?? null;\n}\n\n/**\n * Factory for generic `I18n` gate + `withI18n` HOC over the same Outer.\n * Codegen emits typed wrappers; tests use this directly.\n */\nexport function createI18nLoadGate(options: CreateI18nLoadGateOptions): {\n  I18n: (props: I18nGateProps) => ReactNode;\n  withI18n: <P extends object = object, R = never>(\n    hocOptions: I18nHocOptions<P>,\n    render: WithI18nRender<P, R>\n  ) => ForwardRefExoticComponent<P & RefAttributes<R>>;\n} {\n  const { useLoadArgs } = options;\n  const keepPrevious = options.keepPreviousOnPartitionChange !== false;\n\n  function useGateEntry(namespaces: readonly string[]): LoadDisplayEntry<ScopedScopeLike> {\n    const resolved = resolveNamespaces(namespaces);\n    const args = useLoadArgs();\n    return useNamespaceLoad({\n      coordinator: args.coordinator,\n      engineRef: args.engineRef,\n      partition: args.partition,\n      namespaces: resolved,\n      locale: args.locale,\n      load: () => args.load(resolved),\n      ...(args.tryResolveSync !== undefined\n        ? { tryResolveSync: () => args.tryResolveSync!(resolved) }\n        : {}),\n      keepPrevious,\n    });\n  }\n\n  function I18n({ namespaces, fallback, renderError, children }: I18nGateProps): ReactNode {\n    const entry = useGateEntry(namespaces);\n    return renderDisplayEntry(entry, {\n      ...(fallback !== undefined ? { fallback } : {}),\n      ...(renderError !== undefined ? { renderError } : {}),\n      children,\n    });\n  }\n\n  function withI18n<P extends object = object, R = never>(\n    hocOptions: I18nHocOptions<P>,\n    render: WithI18nRender<P, R>\n  ): ForwardRefExoticComponent<P & RefAttributes<R>> {\n    const { fallback, renderError } = hocOptions;\n    const Outer = forwardRef<R, P>(function I18nHocOuter(props, ref) {\n      const entry = useGateEntry(hocOptions.namespaces);\n\n      const needsFallback = entry.status !== \"ready\" && entry.t === null;\n      const resolvedFallback =\n        !needsFallback || fallback === undefined\n          ? undefined\n          : typeof fallback === \"function\"\n            ? fallback(props as P)\n            : fallback;\n\n      return renderDisplayEntry(entry, {\n        ...(resolvedFallback !== undefined ? { fallback: resolvedFallback } : {}),\n        ...(renderError !== undefined\n          ? {\n              renderError: ({ error, retry }) => renderError({ error, retry, props: props as P }),\n            }\n          : {}),\n        children: (value) => render(props as P, value, ref),\n      });\n    });\n\n    const displayName = render.name || \"Component\";\n    Outer.displayName = `withI18n(${displayName})`;\n    return Outer as ForwardRefExoticComponent<P & RefAttributes<R>>;\n  }\n\n  return { I18n, withI18n };\n}\n","/**\n * Holds the shared i18n root: handle + coordinator + active locale.\n *\n * Generated {@link useI18nRoot} casts the handle to the project's typed factory return.\n */\nimport { createContext, useContext } from \"react\";\nimport type { I18nRootContextValue } from \"./types.js\";\n\nconst I18nRootContext = createContext<I18nRootContextValue | null>(null);\n\n/** Resolves the shared root from an ancestor {@link I18nRootProvider}. */\nexport function useI18nRootContext(): I18nRootContextValue {\n  const value = useContext(I18nRootContext);\n  if (value === null) {\n    throw new Error(\"useI18nRoot must be used within I18nRoot / I18nRootProvider\");\n  }\n  return value;\n}\n\n/** Internal — provider wiring. */\nexport { I18nRootContext };\n","/**\n * Single provider that shares handle + coordinator + locale across a lazy subtree.\n */\nimport { useRef, type ReactNode } from \"react\";\nimport type { FetchArtifact, I18nCreateInput, OnMissingTranslation } from \"@xndrjs/i18n\";\nimport { createLoadCoordinator } from \"./create-load-coordinator.js\";\nimport { I18nRootContext } from \"./root-context.js\";\nimport type {\n  CreateI18nFactory,\n  I18nHandleLike,\n  I18nRootContextValue,\n  ScopedScopeLike,\n} from \"./types.js\";\n\nexport interface I18nRootProviderProps {\n  createI18n: CreateI18nFactory;\n  locale: string;\n  /**\n   * Cold-start / eager dictionary seed (defaults to `{}` when neither prop is set).\n   * Mutually exclusive with {@link state}.\n   */\n  dictionary?: Record<string, unknown>;\n  /** Full create/hydrate input from `handle.serialize()` — mutually exclusive with {@link dictionary}. */\n  state?: I18nCreateInput | undefined;\n  onMissing?: OnMissingTranslation;\n  /** Custom JSON loader for `loaderStrategy: \"fetch\"` projects (ignored by import loaders). */\n  fetchImpl?: FetchArtifact;\n  children: ReactNode;\n}\n\n/** Creates and shares one handle + load coordinator for descendant gates. */\nexport function I18nRootProvider({\n  createI18n,\n  locale,\n  dictionary,\n  state,\n  onMissing,\n  fetchImpl,\n  children,\n}: I18nRootProviderProps): ReactNode {\n  if (state !== undefined && dictionary !== undefined) {\n    throw new Error(\"I18nRootProvider: pass either `state` or `dictionary`, not both.\");\n  }\n\n  const valueRef = useRef<I18nRootContextValue | null>(null);\n\n  if (valueRef.current === null) {\n    const seed: I18nCreateInput =\n      state ?? ({ dictionary: dictionary ?? {} } satisfies I18nCreateInput);\n    const handle = createI18n({\n      state: seed,\n      ...(onMissing !== undefined ? { onMissing } : {}),\n      ...(fetchImpl !== undefined ? { fetchImpl } : {}),\n    });\n    valueRef.current = {\n      handle: handle as I18nHandleLike,\n      coordinator: createLoadCoordinator<ScopedScopeLike>(),\n      locale,\n    };\n  } else {\n    valueRef.current.locale = locale;\n  }\n\n  return <I18nRootContext.Provider value={valueRef.current}>{children}</I18nRootContext.Provider>;\n}\n"]}
+{"version":3,"sources":["../src/create-scoped-t.ts","../src/create-load-coordinator.ts","../src/namespace-load-gate.tsx","../src/root-context.tsx","../src/root-provider.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Builds the scoped `t` function used by providers and load gates.\n *\n * Takes a loaded `@xndrjs/i18n` scope and returns a capability-safe translator:\n * namespaces outside the provider list throw at runtime. Locale is always bound.\n */\nimport type { CreateScopedTOptions, ScopedScopeLike, ScopedTranslateFn } from \"./types.js\";\n\nfunction assertNamespace(namespace: string, namespaces: readonly string[]): void {\n  if (!namespaces.includes(namespace)) {\n    throw new Error(\n      `Namespace \"${namespace}\" is not loaded by this provider. Allowed: [${namespaces.join(\", \")}]`\n    );\n  }\n}\n\nfunction resolveActiveScope(scope: ScopedScopeLike, locale: string): ScopedScopeLike {\n  if (typeof scope.forLocale === \"function\" && scope.locale !== locale) {\n    return scope.forLocale(locale);\n  }\n  return scope;\n}\n\n/**\n * Wraps a loaded scope `t` with namespace guards and locale binding.\n */\nexport function createScopedT(\n  scope: ScopedScopeLike,\n  options: CreateScopedTOptions\n): ScopedTranslateFn {\n  const activeScope = resolveActiveScope(scope, options.locale);\n  const { namespaces } = options;\n\n  return ((namespace: string, key: string, ...rest: unknown[]) => {\n    assertNamespace(namespace, namespaces);\n    return activeScope.t(namespace, key, ...rest);\n  }) as ScopedTranslateFn;\n}\n\n/**\n * Curries a multi-namespace context `t(ns, key, …)` into a namespace-bound `t(key, …)`.\n * Used when composing gate values without introducing a separate hooks API.\n */\nexport function bindNamespaceTranslate(\n  t: ScopedTranslateFn,\n  namespace: string\n): (key: string, params?: Record<string, unknown>) => string {\n  return (key: string, params?: Record<string, unknown>) =>\n    params === undefined ? t(namespace, key) : t(namespace, key, params);\n}\n","/**\n * Load deduplication for lazy i18n namespace gates / HOCs.\n *\n * Supports multiple concurrent keys so parallel per-namespace gates can share\n * one coordinator. Each `(engine, partition, namespaces)` entry keeps its own\n * promise and status. Display state (keep-previous / pendingLocale / stable `t`)\n * lives here so gate components stay pure observers of `useSyncExternalStore`.\n */\nimport { createScopedT } from \"./create-scoped-t.js\";\nimport type {\n  GetDisplayEntryOptions,\n  LoadCoordinator,\n  LoadCoordinatorEntry,\n  LoadCoordinatorKey,\n  LoadCoordinatorRequest,\n  LoadDisplayEntry,\n  ScopedScopeLike,\n  ScopedTranslateFn,\n} from \"./types.js\";\n\nconst engineIds = new WeakMap<object, number>();\nlet nextEngineId = 1;\n\nfunction engineId(ref: unknown): number {\n  if (ref === null || (typeof ref !== \"object\" && typeof ref !== \"function\")) {\n    return 0;\n  }\n  const obj = ref as object;\n  let id = engineIds.get(obj);\n  if (id === undefined) {\n    id = nextEngineId++;\n    engineIds.set(obj, id);\n  }\n  return id;\n}\n\nfunction cacheKey(\n  engineRef: unknown,\n  partition: string | undefined,\n  namespaces: readonly string[]\n): string {\n  return `${engineId(engineRef)}\\0${partition ?? \"\"}\\0${namespaces.join(\"\\0\")}`;\n}\n\n/** Gate identity for keep-previous (namespaces only — partition/locale can change). */\nfunction gateId(engineRef: unknown, namespaces: readonly string[]): string {\n  return `${engineId(engineRef)}\\0${namespaces.join(\"\\0\")}`;\n}\n\ninterface CacheEntry<Scope> {\n  status: \"pending\" | \"resolved\" | \"error\";\n  promise: Promise<Scope>;\n  resolvedScope: Scope | null;\n  error: unknown;\n  requestId: number;\n  /** Stable LoadCoordinatorEntry snapshot for getEntry(). */\n  entrySnapshot: LoadCoordinatorEntry<Scope>;\n}\n\ninterface DisplayCache {\n  lastReady: { scope: ScopedScopeLike; locale: string } | null;\n  /** Stable display entry object until inputs change. */\n  displaySnapshot: LoadDisplayEntry<ScopedScopeLike> | null;\n  /** Identity key for the last displaySnapshot. */\n  displayKey: string | null;\n  boundT: ScopedTranslateFn | null;\n  boundTKey: string | null;\n}\n\n/**\n * Dedupes in-flight loads by `(engineRef, partition, namespaces)` and exposes\n * display snapshots + retry for manual pending/resolved/error rendering.\n */\nexport function createLoadCoordinator<Scope = ScopedScopeLike>(): LoadCoordinator<Scope> {\n  let revision = 0;\n  let nextRequestId = 0;\n  const entries = new Map<string, CacheEntry<Scope>>();\n  const displayByGate = new Map<string, DisplayCache>();\n  const listeners = new Set<() => void>();\n  let lastKey: string | null = null;\n\n  function notify(): void {\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  function bumpAndNotify(): void {\n    revision += 1;\n    // Invalidate display snapshots that depend on entry status.\n    for (const display of displayByGate.values()) {\n      display.displaySnapshot = null;\n      display.displayKey = null;\n    }\n    notify();\n  }\n\n  function markResolvedSync(key: string, syncScope: Scope): void {\n    const entrySnapshot: LoadCoordinatorEntry<Scope> = {\n      status: \"resolved\",\n      scope: syncScope,\n    };\n    entries.set(key, {\n      status: \"resolved\",\n      promise: Promise.resolve(syncScope),\n      resolvedScope: syncScope,\n      error: null,\n      requestId: ++nextRequestId,\n      entrySnapshot,\n    });\n  }\n\n  /**\n   * SSR / getServerSnapshot: hydrate from peek/state only — never kick `load()`.\n   */\n  function ensureSync(input: LoadCoordinatorRequest<Scope>): void {\n    const key = cacheKey(input.engineRef, input.partition, input.namespaces);\n    lastKey = key;\n\n    if (entries.has(key)) {\n      return;\n    }\n\n    if (input.tryResolveSync === undefined) {\n      return;\n    }\n\n    const syncScope = input.tryResolveSync();\n    if (syncScope !== null) {\n      markResolvedSync(key, syncScope);\n    }\n  }\n\n  function ensure(input: LoadCoordinatorRequest<Scope>): void {\n    const key = cacheKey(input.engineRef, input.partition, input.namespaces);\n    lastKey = key;\n\n    const existing = entries.get(key);\n    if (existing !== undefined) {\n      return;\n    }\n\n    if (input.tryResolveSync !== undefined) {\n      const syncScope = input.tryResolveSync();\n      if (syncScope !== null) {\n        markResolvedSync(key, syncScope);\n        return;\n      }\n    }\n\n    const requestId = ++nextRequestId;\n    const promise = input.load().then(\n      (scope) => {\n        const entry = entries.get(key);\n        if (entry === undefined || entry.requestId !== requestId) {\n          return scope;\n        }\n        entry.status = \"resolved\";\n        entry.resolvedScope = scope;\n        entry.error = null;\n        entry.entrySnapshot = { status: \"resolved\", scope };\n        bumpAndNotify();\n        return scope;\n      },\n      (error: unknown) => {\n        const entry = entries.get(key);\n        if (entry !== undefined && entry.requestId === requestId) {\n          entry.status = \"error\";\n          entry.error = error;\n          entry.resolvedScope = null;\n          entry.entrySnapshot = { status: \"error\", error };\n          bumpAndNotify();\n        }\n        throw error;\n      }\n    );\n    // Avoid unhandled rejection when only gate subscribers attach (no getPromise).\n    void promise.catch((error: unknown) => {\n      console.error(\"[i18n-react] namespace load failed:\", error);\n    });\n\n    entries.set(key, {\n      status: \"pending\",\n      promise,\n      resolvedScope: null,\n      error: null,\n      requestId,\n      entrySnapshot: { status: \"pending\" },\n    });\n  }\n\n  function getEntry(keyInput: LoadCoordinatorKey): LoadCoordinatorEntry<Scope> {\n    const key = cacheKey(keyInput.engineRef, keyInput.partition, keyInput.namespaces);\n    const entry = entries.get(key);\n    if (entry === undefined) {\n      return { status: \"pending\" };\n    }\n    return entry.entrySnapshot;\n  }\n\n  function getOrCreateDisplay(engineRef: unknown, namespaces: readonly string[]): DisplayCache {\n    const id = gateId(engineRef, namespaces);\n    let display = displayByGate.get(id);\n    if (display === undefined) {\n      display = {\n        lastReady: null,\n        displaySnapshot: null,\n        displayKey: null,\n        boundT: null,\n        boundTKey: null,\n      };\n      displayByGate.set(id, display);\n    }\n    return display;\n  }\n\n  function bindT(\n    display: DisplayCache,\n    scope: ScopedScopeLike,\n    locale: string,\n    namespaces: readonly string[],\n    scopeToken: string\n  ): ScopedTranslateFn {\n    const tKey = `${scopeToken}\\0${locale}\\0${namespaces.join(\"\\0\")}`;\n    if (display.boundT !== null && display.boundTKey === tKey) {\n      return display.boundT;\n    }\n    const t = createScopedT(scope, { namespaces, locale });\n    display.boundT = t;\n    display.boundTKey = tKey;\n    return t;\n  }\n\n  function getDisplayEntry(\n    keyInput: LoadCoordinatorKey,\n    options: GetDisplayEntryOptions\n  ): LoadDisplayEntry<Scope> {\n    const key = cacheKey(keyInput.engineRef, keyInput.partition, keyInput.namespaces);\n    const entry = entries.get(key);\n    const display = getOrCreateDisplay(keyInput.engineRef, options.namespaces);\n    const keepPrevious = options.keepPrevious !== false;\n\n    const retry = () => {\n      retryKey(keyInput);\n    };\n\n    let result: LoadDisplayEntry<Scope>;\n\n    if (entry === undefined || entry.status === \"pending\") {\n      const kept = keepPrevious ? display.lastReady : null;\n      result = {\n        status: \"pending\",\n        display: kept as { scope: Scope & ScopedScopeLike; locale: string } | null,\n        pendingLocale: kept ? options.locale : undefined,\n        t: kept\n          ? bindT(display, kept.scope, kept.locale, options.namespaces, `kept:${kept.locale}`)\n          : null,\n      } as LoadDisplayEntry<Scope>;\n    } else if (entry.status === \"resolved\") {\n      const scope = entry.resolvedScope as Scope & ScopedScopeLike;\n      display.lastReady = { scope, locale: options.locale };\n      result = {\n        status: \"ready\",\n        scope,\n        locale: options.locale,\n        t: bindT(display, scope, options.locale, options.namespaces, `ready:${key}`),\n      } as LoadDisplayEntry<Scope>;\n    } else {\n      const kept = keepPrevious ? display.lastReady : null;\n      result = {\n        status: \"error\",\n        error: entry.error,\n        display: kept as { scope: Scope & ScopedScopeLike; locale: string } | null,\n        pendingLocale: kept ? options.locale : undefined,\n        t: kept\n          ? bindT(display, kept.scope, kept.locale, options.namespaces, `kept:${kept.locale}`)\n          : null,\n        retry,\n      } as LoadDisplayEntry<Scope>;\n    }\n\n    const displayKey = `${key}\\0${result.status}\\0${options.locale}\\0${String(!!result.t)}`;\n    if (display.displaySnapshot !== null && display.displayKey === displayKey) {\n      return display.displaySnapshot as LoadDisplayEntry<Scope>;\n    }\n    display.displaySnapshot = result as LoadDisplayEntry<ScopedScopeLike>;\n    display.displayKey = displayKey;\n    return result;\n  }\n\n  function retryKey(keyInput: LoadCoordinatorKey): void {\n    const key = cacheKey(keyInput.engineRef, keyInput.partition, keyInput.namespaces);\n    if (!entries.has(key)) {\n      return;\n    }\n    entries.delete(key);\n    bumpAndNotify();\n  }\n\n  function subscribe(listener: () => void): () => void {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  }\n\n  function getPromise(): Promise<Scope> {\n    if (lastKey === null) {\n      throw new Error(\"createLoadCoordinator: call ensure()/request() before getPromise()\");\n    }\n    const entry = entries.get(lastKey);\n    if (entry === undefined) {\n      throw new Error(\"createLoadCoordinator: call ensure()/request() before getPromise()\");\n    }\n    return entry.promise;\n  }\n\n  function getResolvedScope(): Scope | null {\n    if (lastKey === null) {\n      return null;\n    }\n    const entry = entries.get(lastKey);\n    return entry?.status === \"resolved\" ? entry.resolvedScope : null;\n  }\n\n  return {\n    get revision() {\n      return revision;\n    },\n    request: ensure,\n    ensure,\n    ensureSync,\n    getEntry,\n    getDisplayEntry,\n    retry: retryKey,\n    subscribe,\n    getPromise,\n    getResolvedScope,\n  };\n}\n","/**\n * Manual (non-Suspense) i18n load gate: ensure + subscribe via the load\n * coordinator, then render fallback / keep-previous / error UI / throw.\n */\nimport {\n  forwardRef,\n  useSyncExternalStore,\n  type ForwardedRef,\n  type ForwardRefExoticComponent,\n  type ReactNode,\n  type RefAttributes,\n} from \"react\";\nimport type {\n  LoadCoordinator,\n  LoadCoordinatorRequest,\n  LoadDisplayEntry,\n  LoadPartition,\n  ScopedScopeLike,\n  ScopedTranslateFn,\n} from \"./types.js\";\n\n/** Inputs for {@link useNamespaceLoad}. */\nexport interface UseNamespaceLoadInput<Scope> {\n  coordinator: LoadCoordinator<Scope>;\n  engineRef: unknown;\n  partition: LoadPartition;\n  namespaces: readonly string[];\n  locale: string;\n  load: () => Promise<Scope>;\n  tryResolveSync?: () => Scope | null;\n  keepPrevious?: boolean;\n}\n\n/**\n * Starts (or reuses) a coordinator load and re-renders when that entry settles.\n * Client getSnapshot may kick `load()`; SSR getServerSnapshot only peeks sync\n * (hydrated `state`) and never starts a client fetch during prerender.\n */\nexport function useNamespaceLoad<Scope>(\n  input: UseNamespaceLoadInput<Scope>\n): LoadDisplayEntry<Scope> {\n  const {\n    coordinator,\n    engineRef,\n    partition,\n    namespaces,\n    locale,\n    load,\n    tryResolveSync,\n    keepPrevious,\n  } = input;\n\n  const request: LoadCoordinatorRequest<Scope> = {\n    engineRef,\n    partition,\n    namespaces,\n    load,\n    ...(tryResolveSync !== undefined ? { tryResolveSync } : {}),\n  };\n\n  const displayOptions = {\n    locale,\n    namespaces,\n    ...(keepPrevious !== undefined ? { keepPrevious } : {}),\n  };\n\n  return useSyncExternalStore(\n    coordinator.subscribe,\n    () => {\n      coordinator.ensure(request);\n      return coordinator.getDisplayEntry({ engineRef, partition, namespaces }, displayOptions);\n    },\n    () => {\n      coordinator.ensureSync(request);\n      return coordinator.getDisplayEntry({ engineRef, partition, namespaces }, displayOptions);\n    }\n  );\n}\n\n/** Scoped `{ t, locale }` injected into gate children / HOC when ready (or kept). */\nexport interface I18nLoadGateValue {\n  t: ScopedTranslateFn;\n  locale: string;\n  /** Set during keep-then-switch while a new partition is loading. */\n  pendingLocale?: string;\n  error?: unknown;\n  retry?: () => void;\n}\n\n/** Load wiring from React context (coordinator, engine, partition, load). */\nexport interface I18nLoadArgs {\n  coordinator: LoadCoordinator<ScopedScopeLike>;\n  engineRef: unknown;\n  partition: LoadPartition;\n  locale: string;\n  load: (namespaces: readonly string[]) => Promise<ScopedScopeLike>;\n  tryResolveSync?: (namespaces: readonly string[]) => ScopedScopeLike | null;\n}\n\nexport interface CreateI18nLoadGateOptions {\n  /**\n   * When true (default), keep last resolved `{ t, locale }` while a new\n   * partition is pending instead of showing fallback.\n   */\n  keepPreviousOnPartitionChange?: boolean;\n  /** Hook that resolves coordinator + load inputs from React context. */\n  useLoadArgs: () => I18nLoadArgs;\n}\n\nexport interface I18nGateProps {\n  namespaces: readonly string[];\n  /** Shown only while the load is pending (not on error). */\n  fallback?: ReactNode;\n  /**\n   * When set, called for error with no keep-previous display.\n   * Otherwise the load error is thrown for a React error boundary.\n   */\n  renderError?: (args: { error: unknown; retry: () => void }) => ReactNode;\n  children: (value: I18nLoadGateValue) => ReactNode;\n}\n\n/** Pending UI for `withI18n` — static node or derived from own props. */\nexport type WithI18nFallback<P extends object> = ReactNode | ((props: P) => ReactNode);\n\nexport interface I18nHocOptions<P extends object = object> {\n  namespaces: readonly string[];\n  fallback?: WithI18nFallback<P>;\n  renderError?: (args: { error: unknown; retry: () => void; props: P }) => ReactNode;\n}\n\n/** Render fn for `withI18n`: own props, i18n bag, optional forwarded ref. */\nexport type WithI18nRender<P extends object, R = never> = (\n  props: P,\n  i18n: I18nLoadGateValue,\n  ref?: ForwardedRef<R>\n) => ReactNode;\n\nfunction resolveNamespaces(namespaces: readonly string[] | undefined): readonly string[] {\n  if (namespaces === undefined || namespaces.length === 0) {\n    throw new Error(\"withI18n / I18n: requires a non-empty namespaces list\");\n  }\n  return namespaces;\n}\n\nfunction toThrownError(error: unknown): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n  if (typeof error === \"string\") {\n    return new Error(error);\n  }\n  return new Error(\"i18n namespace load failed\");\n}\n\nfunction renderDisplayEntry(\n  entry: LoadDisplayEntry<ScopedScopeLike>,\n  options: {\n    fallback?: ReactNode;\n    renderError?: (args: { error: unknown; retry: () => void }) => ReactNode;\n    children: (value: I18nLoadGateValue) => ReactNode;\n  }\n): ReactNode {\n  if (entry.status === \"ready\") {\n    return options.children({ t: entry.t, locale: entry.locale });\n  }\n\n  if (entry.status === \"error\" && entry.t === null) {\n    if (options.renderError) {\n      return options.renderError({ error: entry.error, retry: entry.retry! });\n    }\n    throw toThrownError(entry.error);\n  }\n\n  if (entry.t !== null && entry.display) {\n    const value: I18nLoadGateValue = {\n      t: entry.t,\n      locale: entry.display.locale,\n    };\n    if (entry.pendingLocale !== undefined) {\n      value.pendingLocale = entry.pendingLocale;\n    }\n    if (entry.status === \"error\") {\n      value.error = entry.error;\n      value.retry = entry.retry;\n    }\n    return options.children(value);\n  }\n\n  return options.fallback ?? null;\n}\n\n/**\n * Factory for generic `I18n` gate + `withI18n` HOC over the same Outer.\n * Codegen emits typed wrappers; tests use this directly.\n */\nexport function createI18nLoadGate(options: CreateI18nLoadGateOptions): {\n  I18n: (props: I18nGateProps) => ReactNode;\n  withI18n: <P extends object = object, R = never>(\n    hocOptions: I18nHocOptions<P>,\n    render: WithI18nRender<P, R>\n  ) => ForwardRefExoticComponent<P & RefAttributes<R>>;\n} {\n  const { useLoadArgs } = options;\n  const keepPrevious = options.keepPreviousOnPartitionChange !== false;\n\n  function useGateEntry(namespaces: readonly string[]): LoadDisplayEntry<ScopedScopeLike> {\n    const resolved = resolveNamespaces(namespaces);\n    const args = useLoadArgs();\n    return useNamespaceLoad({\n      coordinator: args.coordinator,\n      engineRef: args.engineRef,\n      partition: args.partition,\n      namespaces: resolved,\n      locale: args.locale,\n      load: () => args.load(resolved),\n      ...(args.tryResolveSync !== undefined\n        ? { tryResolveSync: () => args.tryResolveSync!(resolved) }\n        : {}),\n      keepPrevious,\n    });\n  }\n\n  function I18n({ namespaces, fallback, renderError, children }: I18nGateProps): ReactNode {\n    const entry = useGateEntry(namespaces);\n    return renderDisplayEntry(entry, {\n      ...(fallback !== undefined ? { fallback } : {}),\n      ...(renderError !== undefined ? { renderError } : {}),\n      children,\n    });\n  }\n\n  function withI18n<P extends object = object, R = never>(\n    hocOptions: I18nHocOptions<P>,\n    render: WithI18nRender<P, R>\n  ): ForwardRefExoticComponent<P & RefAttributes<R>> {\n    const { fallback, renderError } = hocOptions;\n    const Outer = forwardRef<R, P>(function I18nHocOuter(props, ref) {\n      const entry = useGateEntry(hocOptions.namespaces);\n\n      const needsFallback = entry.status === \"pending\" && entry.t === null;\n      const resolvedFallback =\n        !needsFallback || fallback === undefined\n          ? undefined\n          : typeof fallback === \"function\"\n            ? fallback(props as P)\n            : fallback;\n\n      return renderDisplayEntry(entry, {\n        ...(resolvedFallback !== undefined ? { fallback: resolvedFallback } : {}),\n        ...(renderError !== undefined\n          ? {\n              renderError: ({ error, retry }) => renderError({ error, retry, props: props as P }),\n            }\n          : {}),\n        children: (value) => render(props as P, value, ref),\n      });\n    });\n\n    const displayName = render.name || \"Component\";\n    Outer.displayName = `withI18n(${displayName})`;\n    return Outer as ForwardRefExoticComponent<P & RefAttributes<R>>;\n  }\n\n  return { I18n, withI18n };\n}\n","/**\n * Holds the shared i18n root: handle + coordinator + active locale.\n *\n * Generated {@link useI18nRoot} casts the handle to the project's typed factory return.\n */\nimport { createContext, useContext } from \"react\";\nimport type { I18nRootContextValue } from \"./types.js\";\n\nconst I18nRootContext = createContext<I18nRootContextValue | null>(null);\n\n/** Resolves the shared root from an ancestor {@link I18nRootProvider}. */\nexport function useI18nRootContext(): I18nRootContextValue {\n  const value = useContext(I18nRootContext);\n  if (value === null) {\n    throw new Error(\"useI18nRoot must be used within I18nRoot / I18nRootProvider\");\n  }\n  return value;\n}\n\n/** Internal — provider wiring. */\nexport { I18nRootContext };\n","/**\n * Single provider that shares handle + coordinator + locale across a lazy subtree.\n */\nimport { useRef, type ReactNode } from \"react\";\nimport type { FetchArtifact, I18nCreateInput, OnMissingTranslation } from \"@xndrjs/i18n\";\nimport { createLoadCoordinator } from \"./create-load-coordinator.js\";\nimport { I18nRootContext } from \"./root-context.js\";\nimport type {\n  CreateI18nFactory,\n  I18nHandleLike,\n  I18nRootContextValue,\n  ScopedScopeLike,\n} from \"./types.js\";\n\nexport interface I18nRootProviderProps {\n  createI18n: CreateI18nFactory;\n  locale: string;\n  /**\n   * Cold-start / eager dictionary seed (defaults to `{}` when neither prop is set).\n   * Mutually exclusive with {@link state}.\n   */\n  dictionary?: Record<string, unknown>;\n  /** Full create/hydrate input from `handle.serialize()` — mutually exclusive with {@link dictionary}. */\n  state?: I18nCreateInput | undefined;\n  onMissing?: OnMissingTranslation;\n  /** Custom JSON loader for `loaderStrategy: \"fetch\"` projects (ignored by import loaders). */\n  fetchImpl?: FetchArtifact;\n  children: ReactNode;\n}\n\n/** Creates and shares one handle + load coordinator for descendant gates. */\nexport function I18nRootProvider({\n  createI18n,\n  locale,\n  dictionary,\n  state,\n  onMissing,\n  fetchImpl,\n  children,\n}: I18nRootProviderProps): ReactNode {\n  if (state !== undefined && dictionary !== undefined) {\n    throw new Error(\"I18nRootProvider: pass either `state` or `dictionary`, not both.\");\n  }\n\n  const valueRef = useRef<I18nRootContextValue | null>(null);\n\n  if (valueRef.current === null) {\n    const seed: I18nCreateInput =\n      state ?? ({ dictionary: dictionary ?? {} } satisfies I18nCreateInput);\n    const handle = createI18n({\n      state: seed,\n      ...(onMissing !== undefined ? { onMissing } : {}),\n      ...(fetchImpl !== undefined ? { fetchImpl } : {}),\n    });\n    valueRef.current = {\n      handle: handle as I18nHandleLike,\n      coordinator: createLoadCoordinator<ScopedScopeLike>(),\n      locale,\n    };\n  } else {\n    valueRef.current.locale = locale;\n  }\n\n  return <I18nRootContext.Provider value={valueRef.current}>{children}</I18nRootContext.Provider>;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xndrjs/i18n-react",
-  "version": "0.8.0-alpha.0",
+  "version": "0.8.1",
   "description": "React runtime primitives and codegen for @xndrjs/i18n client bindings.",
   "private": false,
   "license": "MIT",
@@ -30,7 +30,7 @@
     "node": ">=18"
   },
   "peerDependencies": {
-    "@xndrjs/i18n": "^0.8.0-alpha.0",
+    "@xndrjs/i18n": "^0.8.1",
     "react": ">=19",
     "tsx": ">=4",
     "zod": "^4.0.0"
@@ -46,7 +46,7 @@
     "tsx": "^4.22.4",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@xndrjs/i18n": "^0.7.0"
+    "@xndrjs/i18n": "^0.8.1"
   },
   "scripts": {
     "build": "tsup",

package/src/create-load-coordinator.test.ts

@@ -78,6 +78,44 @@ describe("createLoadCoordinator", () => {
     expect(coordinator.getEntry(key)).toEqual({ status: "resolved", scope: 42 });
   });
 
+  it("ensureSync resolves from tryResolveSync without calling load", () => {
+    const coordinator = createLoadCoordinator<string>();
+    const load = vi.fn(() => Promise.resolve("async"));
+    const tryResolveSync = vi.fn(() => "sync");
+    const engine = {};
+    const key = { engineRef: engine, partition: "en", namespaces: ["default"] as const };
+
+    coordinator.ensureSync({ ...key, load, tryResolveSync });
+
+    expect(tryResolveSync).toHaveBeenCalledTimes(1);
+    expect(load).not.toHaveBeenCalled();
+    expect(coordinator.getEntry(key)).toEqual({ status: "resolved", scope: "sync" });
+  });
+
+  it("ensureSync does nothing when tryResolveSync misses (no async kick)", () => {
+    const coordinator = createLoadCoordinator<string>();
+    const load = vi.fn(() => Promise.resolve("async"));
+    const engine = {};
+    const key = { engineRef: engine, partition: "en", namespaces: ["default"] as const };
+
+    coordinator.ensureSync({ ...key, load, tryResolveSync: () => null });
+
+    expect(load).not.toHaveBeenCalled();
+    expect(coordinator.getEntry(key)).toEqual({ status: "pending" });
+  });
+
+  it("ensureSync without tryResolveSync leaves entry absent", () => {
+    const coordinator = createLoadCoordinator<string>();
+    const load = vi.fn(() => Promise.resolve("async"));
+    const engine = {};
+    const key = { engineRef: engine, partition: "en", namespaces: ["default"] as const };
+
+    coordinator.ensureSync({ ...key, load });
+
+    expect(load).not.toHaveBeenCalled();
+    expect(coordinator.getEntry(key)).toEqual({ status: "pending" });
+  });
+
   it("resolves synchronously when tryResolveSync returns a scope", () => {
     const coordinator = createLoadCoordinator<string>();
     const load = vi.fn(() => Promise.resolve("async"));
@@ -224,6 +262,32 @@ describe("createLoadCoordinator", () => {
     expect(listener).toHaveBeenCalledTimes(1);
   });
 
+  it("logs rejected loads when getPromise is not awaited", async () => {
+    const coordinator = createLoadCoordinator<string>();
+    const pending = deferred<string>();
+    const engine = {};
+    const key = {
+      engineRef: engine,
+      partition: "en",
+      namespaces: ["default"] as const,
+    };
+    const consoleError = vi.spyOn(console, "error").mockImplementation(() => void 0);
+
+    coordinator.ensure({ ...key, load: () => pending.promise });
+
+    pending.reject(new Error("load failed"));
+    await vi.waitFor(() => {
+      expect(coordinator.getEntry(key)).toEqual({ status: "error", error: expect.any(Error) });
+    });
+
+    expect(consoleError).toHaveBeenCalledWith(
+      "[i18n-react] namespace load failed:",
+      expect.any(Error)
+    );
+
+    consoleError.mockRestore();
+  });
+
   it("keeps an error entry and notifies subscribers on reject", async () => {
     const coordinator = createLoadCoordinator<string>();
     const pending = deferred<string>();

package/src/create-load-coordinator.ts

@@ -95,6 +95,42 @@ export function createLoadCoordinator<Scope = ScopedScopeLike>(): LoadCoordinato
     notify();
   }
 
+  function markResolvedSync(key: string, syncScope: Scope): void {
+    const entrySnapshot: LoadCoordinatorEntry<Scope> = {
+      status: "resolved",
+      scope: syncScope,
+    };
+    entries.set(key, {
+      status: "resolved",
+      promise: Promise.resolve(syncScope),
+      resolvedScope: syncScope,
+      error: null,
+      requestId: ++nextRequestId,
+      entrySnapshot,
+    });
+  }
+
+  /**
+   * SSR / getServerSnapshot: hydrate from peek/state only — never kick `load()`.
+   */
+  function ensureSync(input: LoadCoordinatorRequest<Scope>): void {
+    const key = cacheKey(input.engineRef, input.partition, input.namespaces);
+    lastKey = key;
+
+    if (entries.has(key)) {
+      return;
+    }
+
+    if (input.tryResolveSync === undefined) {
+      return;
+    }
+
+    const syncScope = input.tryResolveSync();
+    if (syncScope !== null) {
+      markResolvedSync(key, syncScope);
+    }
+  }
+
   function ensure(input: LoadCoordinatorRequest<Scope>): void {
     const key = cacheKey(input.engineRef, input.partition, input.namespaces);
     lastKey = key;
@@ -107,18 +143,7 @@ export function createLoadCoordinator<Scope = ScopedScopeLike>(): LoadCoordinato
     if (input.tryResolveSync !== undefined) {
       const syncScope = input.tryResolveSync();
       if (syncScope !== null) {
-        const entrySnapshot: LoadCoordinatorEntry<Scope> = {
-          status: "resolved",
-          scope: syncScope,
-        };
-        entries.set(key, {
-          status: "resolved",
-          promise: Promise.resolve(syncScope),
-          resolvedScope: syncScope,
-          error: null,
-          requestId: ++nextRequestId,
-          entrySnapshot,
-        });
+        markResolvedSync(key, syncScope);
         return;
       }
     }
@@ -149,8 +174,10 @@ export function createLoadCoordinator<Scope = ScopedScopeLike>(): LoadCoordinato
         throw error;
       }
     );
-    // Mark rejection handled when only getEntry consumers attach (no getPromise).
-    void promise.catch(() => void null);
+    // Avoid unhandled rejection when only gate subscribers attach (no getPromise).
+    void promise.catch((error: unknown) => {
+      console.error("[i18n-react] namespace load failed:", error);
+    });
 
     entries.set(key, {
       status: "pending",
@@ -302,6 +329,7 @@ export function createLoadCoordinator<Scope = ScopedScopeLike>(): LoadCoordinato
     },
     request: ensure,
     ensure,
+    ensureSync,
     getEntry,
     getDisplayEntry,
     retry: retryKey,

package/src/namespace-load-gate.test.tsx

@@ -1,7 +1,8 @@
-import { act, useState } from "react";
+import { act, Component, type ReactNode, useState } from "react";
+import { renderToString } from "react-dom/server";
 import { createI18nHandle, IcuTranslationProviderMulti } from "@xndrjs/i18n";
 import { render, screen } from "@testing-library/react";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
 import { createLoadCoordinator } from "./create-load-coordinator.js";
 import { createI18nLoadGate, useNamespaceLoad, type I18nLoadArgs } from "./namespace-load-gate.js";
 import type { ScopedScopeLike } from "./types.js";
@@ -14,6 +15,11 @@ type MultiParams = {
   default: { greeting: never };
   billing: { invoice: never };
 };
+type TestLocale = "en" | "it";
+
+function asScopedScope(scope: unknown): ScopedScopeLike {
+  return scope as ScopedScopeLike;
+}
 
 function deferred<T>() {
   let resolve!: (value: T) => void;
@@ -25,6 +31,24 @@ function deferred<T>() {
   return { promise, resolve, reject };
 }
 
+class TestErrorBoundary extends Component<
+  { children: ReactNode; fallback: ReactNode },
+  { error: Error | null }
+> {
+  override state = { error: null as Error | null };
+
+  static getDerivedStateFromError(error: Error) {
+    return { error };
+  }
+
+  override render() {
+    if (this.state.error !== null) {
+      return this.props.fallback;
+    }
+    return this.props.children;
+  }
+}
+
 function createTestHandle() {
   const engine = new IcuTranslationProviderMulti<MultiSchema, MultiParams>({});
   return createI18nHandle(engine, {
@@ -41,7 +65,7 @@ function createTestHandle() {
 
 function createGateFixture(options?: {
   load?: (namespaces: readonly string[]) => Promise<ScopedScopeLike>;
-  locale?: string;
+  locale?: TestLocale;
   keepPreviousOnPartitionChange?: boolean;
 }) {
   const handle = createTestHandle();
@@ -50,7 +74,7 @@ function createGateFixture(options?: {
   const load =
     options?.load ??
     ((namespaces: readonly string[]) =>
-      handle.load({ namespaces: [...namespaces] as ["default"], locale: locale }));
+      handle.load({ namespaces: [...namespaces] as ["default"], locale }).then(asScopedScope));
 
   const { I18n, withI18n } = createI18nLoadGate({
     ...(options?.keepPreviousOnPartitionChange !== undefined
@@ -91,12 +115,58 @@ describe("useNamespaceLoad", () => {
 
     const scope = await handle.load({ namespaces: ["default"], locale: "it" });
     await act(async () => {
-      pending.resolve(scope);
+      pending.resolve(asScopedScope(scope));
       await pending.promise;
     });
 
     expect(screen.getByTestId("status").textContent).toBe("ready");
   });
+
+  it("SSR getServerSnapshot does not call load without sync seed", () => {
+    const load = vi.fn(() => Promise.resolve(asScopedScope({ t: () => "" })));
+    const handle = createTestHandle();
+    const coordinator = createLoadCoordinator<ScopedScopeLike>();
+
+    function Probe() {
+      const entry = useNamespaceLoad({
+        coordinator,
+        engineRef: handle,
+        partition: "it",
+        namespaces: ["default"],
+        locale: "it",
+        load,
+      });
+      return <span>{entry.status}</span>;
+    }
+
+    const html = renderToString(<Probe />);
+    expect(html).toContain("pending");
+    expect(load).not.toHaveBeenCalled();
+  });
+
+  it("SSR getServerSnapshot uses tryResolveSync without calling load", async () => {
+    const handle = createTestHandle();
+    await handle.load({ namespaces: ["default"], locale: "it" });
+    const load = vi.fn(() => Promise.reject(new Error("should not load")));
+    const coordinator = createLoadCoordinator<ScopedScopeLike>();
+
+    function Probe() {
+      const entry = useNamespaceLoad({
+        coordinator,
+        engineRef: handle,
+        partition: "it",
+        namespaces: ["default"],
+        locale: "it",
+        load,
+        tryResolveSync: () => asScopedScope(handle.peek({ namespaces: ["default"], locale: "it" })),
+      });
+      return <span>{entry.status}</span>;
+    }
+
+    const html = renderToString(<Probe />);
+    expect(html).toContain("ready");
+    expect(load).not.toHaveBeenCalled();
+  });
 });
 
 describe("createI18nLoadGate", () => {
@@ -132,7 +202,7 @@ describe("createI18nLoadGate", () => {
     const handle = createTestHandle();
     const scope = await handle.load({ namespaces: ["default"], locale: "it" });
     await act(async () => {
-      pending.resolve(scope);
+      pending.resolve(asScopedScope(scope));
       await pending.promise;
     });
 
@@ -159,7 +229,7 @@ describe("createI18nLoadGate", () => {
     const handle = createTestHandle();
     const scope = await handle.load({ namespaces: ["default", "billing"], locale: "it" });
     await act(async () => {
-      pending.resolve(scope);
+      pending.resolve(asScopedScope(scope));
       await pending.promise;
     });
 
@@ -181,24 +251,30 @@ describe("createI18nLoadGate", () => {
     expect(container.textContent).toBe("");
   });
 
-  it("renders fallback on load error (no remount storm)", async () => {
+  it("throws to an error boundary when load fails without renderError", async () => {
     const pending = deferred<ScopedScopeLike>();
     const { I18n, coordinator, handle, locale } = createGateFixture({
       load: () => pending.promise,
     });
+    const consoleError = vi.spyOn(console, "error").mockImplementation(() => undefined);
 
     render(
-      <I18n namespaces={["default"]} fallback={<span data-testid="fallback">err-or-pending</span>}>
-        {({ t }) => <span data-testid="greeting">{t("default", "greeting")}</span>}
-      </I18n>
+      <TestErrorBoundary fallback={<span data-testid="caught">caught</span>}>
+        <I18n namespaces={["default"]} fallback={<span data-testid="fallback">loading</span>}>
+          {({ t }) => <span data-testid="greeting">{t("default", "greeting")}</span>}
+        </I18n>
+      </TestErrorBoundary>
     );
 
+    expect(screen.getByTestId("fallback").textContent).toBe("loading");
+
     await act(async () => {
       pending.reject(new Error("load failed"));
       await pending.promise.catch(() => undefined);
     });
 
-    expect(screen.getByTestId("fallback").textContent).toBe("err-or-pending");
+    expect(screen.getByTestId("caught").textContent).toBe("caught");
+    expect(screen.queryByTestId("fallback")).toBeNull();
     expect(screen.queryByTestId("greeting")).toBeNull();
     expect(
       coordinator.getEntry({
@@ -207,6 +283,8 @@ describe("createI18nLoadGate", () => {
         namespaces: ["default"],
       })
     ).toEqual({ status: "error", error: expect.any(Error) });
+
+    consoleError.mockRestore();
   });
 
   it("renderError exposes retry for failed loads", async () => {
@@ -258,7 +336,7 @@ describe("createI18nLoadGate", () => {
 
     const scope = await handle.load({ namespaces: ["default"], locale: "it" });
     await act(async () => {
-      currentPromise.resolve(scope);
+      currentPromise.resolve(asScopedScope(scope));
       await currentPromise.promise;
     });
 
@@ -308,7 +386,7 @@ describe("createI18nLoadGate", () => {
     const handle = createTestHandle();
     const scope = await handle.load({ namespaces: ["default"], locale: "it" });
     await act(async () => {
-      pending.resolve(scope);
+      pending.resolve(asScopedScope(scope));
       await pending.promise;
     });
 
@@ -364,7 +442,7 @@ describe("createI18nLoadGate", () => {
     const handle = createTestHandle();
     const scope = await handle.load({ namespaces: ["default"], locale: "it" });
     await act(async () => {
-      pending.resolve(scope);
+      pending.resolve(asScopedScope(scope));
       await pending.promise;
     });
 
@@ -411,7 +489,7 @@ describe("createI18nLoadGate", () => {
 
     const scope = await handle.load({ namespaces: ["default"], locale: "en" });
     await act(async () => {
-      pending.resolve(scope);
+      pending.resolve(asScopedScope(scope));
       await pending.promise;
     });
 
@@ -424,8 +502,8 @@ describe("createI18nLoadGate ready path", () => {
   it("renders immediately when the coordinator entry is already resolved", async () => {
     const handle = createTestHandle();
     const coordinator = createLoadCoordinator<ScopedScopeLike>();
-    const locale = "it";
-    const scope = await handle.load({ namespaces: ["default"], locale: locale });
+    const locale: TestLocale = "it";
+    const scope = asScopedScope(await handle.load({ namespaces: ["default"], locale }));
 
     coordinator.request({
       engineRef: handle,
@@ -461,7 +539,7 @@ describe("createI18nLoadGate keep-then-switch", () => {
   it("keeps previous t across locale change until new partition resolves", async () => {
     const handle = createTestHandle();
     const coordinator = createLoadCoordinator<ScopedScopeLike>();
-    let activeLocale = "en";
+    let activeLocale: TestLocale = "en";
     const pendingIt = deferred<ScopedScopeLike>();
 
     const { I18n } = createI18nLoadGate({
@@ -475,12 +553,14 @@ describe("createI18nLoadGate keep-then-switch", () => {
           if (activeLocale === "it") {
             return pendingIt.promise;
           }
-          return handle.load({ namespaces: [...namespaces] as ["default"], locale: activeLocale });
+          return handle
+            .load({ namespaces: [...namespaces] as ["default"], locale: activeLocale })
+            .then(asScopedScope);
         },
       }),
     });
 
-    function App({ locale }: { locale: string }) {
+    function App({ locale }: { locale: TestLocale }) {
       activeLocale = locale;
       return (
         <I18n namespaces={["default"]} fallback={<span data-testid="fallback">loading</span>}>
@@ -500,7 +580,7 @@ describe("createI18nLoadGate keep-then-switch", () => {
     expect(screen.queryByTestId("fallback")).toBeNull();
     expect(screen.getByTestId("row").textContent).toBe("en:Hello:it");
 
-    const itScope = await handle.load({ namespaces: ["default"], locale: "it" });
+    const itScope = asScopedScope(await handle.load({ namespaces: ["default"], locale: "it" }));
     await act(async () => {
       pendingIt.resolve(itScope);
       await pendingIt.promise;

package/src/namespace-load-gate.tsx

@@ -1,6 +1,6 @@
 /**
  * Manual (non-Suspense) i18n load gate: ensure + subscribe via the load
- * coordinator, then render fallback / keep-previous / error UI.
+ * coordinator, then render fallback / keep-previous / error UI / throw.
  */
 import {
   forwardRef,
@@ -33,7 +33,8 @@ export interface UseNamespaceLoadInput<Scope> {
 
 /**
  * Starts (or reuses) a coordinator load and re-renders when that entry settles.
- * Kick-off is idempotent inside the snapshot getter (safe with useSyncExternalStore).
+ * Client getSnapshot may kick `load()`; SSR getServerSnapshot only peeks sync
+ * (hydrated `state`) and never starts a client fetch during prerender.
  */
 export function useNamespaceLoad<Scope>(
   input: UseNamespaceLoadInput<Scope>
@@ -57,29 +58,21 @@ export function useNamespaceLoad<Scope>(
     ...(tryResolveSync !== undefined ? { tryResolveSync } : {}),
   };
 
+  const displayOptions = {
+    locale,
+    namespaces,
+    ...(keepPrevious !== undefined ? { keepPrevious } : {}),
+  };
+
   return useSyncExternalStore(
     coordinator.subscribe,
     () => {
       coordinator.ensure(request);
-      return coordinator.getDisplayEntry(
-        { engineRef, partition, namespaces },
-        {
-          locale,
-          namespaces,
-          ...(keepPrevious !== undefined ? { keepPrevious } : {}),
-        }
-      );
+      return coordinator.getDisplayEntry({ engineRef, partition, namespaces }, displayOptions);
     },
     () => {
-      coordinator.ensure(request);
-      return coordinator.getDisplayEntry(
-        { engineRef, partition, namespaces },
-        {
-          locale,
-          namespaces,
-          ...(keepPrevious !== undefined ? { keepPrevious } : {}),
-        }
-      );
+      coordinator.ensureSync(request);
+      return coordinator.getDisplayEntry({ engineRef, partition, namespaces }, displayOptions);
     }
   );
 }
@@ -116,8 +109,12 @@ export interface CreateI18nLoadGateOptions {
 
 export interface I18nGateProps {
   namespaces: readonly string[];
+  /** Shown only while the load is pending (not on error). */
   fallback?: ReactNode;
-  /** When set, called for error with no keep-previous display. */
+  /**
+   * When set, called for error with no keep-previous display.
+   * Otherwise the load error is thrown for a React error boundary.
+   */
   renderError?: (args: { error: unknown; retry: () => void }) => ReactNode;
   children: (value: I18nLoadGateValue) => ReactNode;
 }
@@ -145,6 +142,16 @@ function resolveNamespaces(namespaces: readonly string[] | undefined): readonly
   return namespaces;
 }
 
+function toThrownError(error: unknown): Error {
+  if (error instanceof Error) {
+    return error;
+  }
+  if (typeof error === "string") {
+    return new Error(error);
+  }
+  return new Error("i18n namespace load failed");
+}
+
 function renderDisplayEntry(
   entry: LoadDisplayEntry<ScopedScopeLike>,
   options: {
@@ -159,9 +166,9 @@ function renderDisplayEntry(
 
   if (entry.status === "error" && entry.t === null) {
     if (options.renderError) {
-      return options.renderError({ error: entry.error, retry: entry.retry });
+      return options.renderError({ error: entry.error, retry: entry.retry! });
     }
-    return options.fallback ?? null;
+    throw toThrownError(entry.error);
   }
 
   if (entry.t !== null && entry.display) {
@@ -230,7 +237,7 @@ export function createI18nLoadGate(options: CreateI18nLoadGateOptions): {
     const Outer = forwardRef<R, P>(function I18nHocOuter(props, ref) {
       const entry = useGateEntry(hocOptions.namespaces);
 
-      const needsFallback = entry.status !== "ready" && entry.t === null;
+      const needsFallback = entry.status === "pending" && entry.t === null;
       const resolvedFallback =
         !needsFallback || fallback === undefined
           ? undefined

package/src/types.ts

@@ -72,8 +72,13 @@ export interface LoadCoordinator<Scope> {
   readonly revision: number;
   /** @deprecated Prefer {@link ensure}. */
   request(input: LoadCoordinatorRequest<Scope>): void;
-  /** Idempotent: start load if missing. Safe from getSnapshot. */
+  /** Idempotent: start load if missing. Safe from client getSnapshot. */
   ensure(input: LoadCoordinatorRequest<Scope>): void;
+  /**
+   * Idempotent: resolve from {@link LoadCoordinatorRequest.tryResolveSync} only.
+   * Never starts `load()` — use from SSR `getServerSnapshot`.
+   */
+  ensureSync(input: LoadCoordinatorRequest<Scope>): void;
   getEntry(key: LoadCoordinatorKey): LoadCoordinatorEntry<Scope>;
   getDisplayEntry(
     key: LoadCoordinatorKey,
@@ -115,6 +120,14 @@ export interface I18nHandleLike {
     dictionary: unknown;
     resources: readonly (readonly [string, string])[];
   };
+  getLoadState: () => {
+    resources: readonly {
+      namespace: string;
+      partition: string;
+      status: "pending" | "loaded" | "error";
+      error?: unknown;
+    }[];
+  };
 }
 
 /** Single React context value for the lazy i18n tree. */