@xndrjs/i18n-react 0.8.2-alpha.0 → 0.8.2-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.js +37 -21
  2. package/dist/index.js.map +1 -1
  3. package/package.json +3 -3
package/dist/index.js CHANGED
@@ -323,15 +323,10 @@ function toThrownError(error) {
323
323
  }
324
324
  return new Error("i18n namespace load failed");
325
325
  }
326
- function renderDisplayEntry(entry, options) {
326
+ var noopT = () => "";
327
+ function gateValueFromEntry(entry) {
327
328
  if (entry.status === "ready") {
328
- return options.children({ t: entry.t, locale: entry.locale });
329
- }
330
- if (entry.status === "error" && entry.t === null) {
331
- if (options.renderError) {
332
- return options.renderError({ error: entry.error, retry: entry.retry });
333
- }
334
- throw toThrownError(entry.error);
329
+ return { t: entry.t, locale: entry.locale };
335
330
  }
336
331
  if (entry.t !== null && entry.display) {
337
332
  const value = {
@@ -345,6 +340,19 @@ function renderDisplayEntry(entry, options) {
345
340
  value.error = entry.error;
346
341
  value.retry = entry.retry;
347
342
  }
343
+ return value;
344
+ }
345
+ return null;
346
+ }
347
+ function renderDisplayEntry(entry, options) {
348
+ if (entry.status === "error" && entry.t === null) {
349
+ if (options.renderError) {
350
+ return options.renderError({ error: entry.error, retry: entry.retry });
351
+ }
352
+ throw toThrownError(entry.error);
353
+ }
354
+ const value = gateValueFromEntry(entry);
355
+ if (value !== null) {
348
356
  return options.children(value);
349
357
  }
350
358
  return options.fallback ?? null;
@@ -352,10 +360,10 @@ function renderDisplayEntry(entry, options) {
352
360
  function createI18nLoadGate(options) {
353
361
  const { useLoadArgs } = options;
354
362
  const keepPrevious = options.keepPreviousOnPartitionChange !== false;
355
- function useGateEntry(namespaces) {
363
+ function useGateLoad(namespaces) {
356
364
  const resolved = resolveNamespaces(namespaces);
357
365
  const args = useLoadArgs();
358
- return useNamespaceLoad({
366
+ const entry = useNamespaceLoad({
359
367
  coordinator: args.coordinator,
360
368
  engineRef: args.engineRef,
361
369
  partition: args.partition,
@@ -365,9 +373,10 @@ function createI18nLoadGate(options) {
365
373
  ...args.tryResolveSync !== void 0 ? { tryResolveSync: () => args.tryResolveSync(resolved) } : {},
366
374
  keepPrevious
367
375
  });
376
+ return { entry, locale: args.locale };
368
377
  }
369
378
  function I18n({ namespaces, fallback, renderError, children }) {
370
- const entry = useGateEntry(namespaces);
379
+ const { entry } = useGateLoad(namespaces);
371
380
  return renderDisplayEntry(entry, {
372
381
  ...fallback !== void 0 ? { fallback } : {},
373
382
  ...renderError !== void 0 ? { renderError } : {},
@@ -377,16 +386,23 @@ function createI18nLoadGate(options) {
377
386
  function withI18n(hocOptions, render) {
378
387
  const { fallback, renderError } = hocOptions;
379
388
  const Outer = forwardRef(function I18nHocOuter(props, ref) {
380
- const entry = useGateEntry(hocOptions.namespaces);
381
- const needsFallback = entry.status === "pending" && entry.t === null;
382
- const resolvedFallback = !needsFallback || fallback === void 0 ? void 0 : typeof fallback === "function" ? fallback(props) : fallback;
383
- return renderDisplayEntry(entry, {
384
- ...resolvedFallback !== void 0 ? { fallback: resolvedFallback } : {},
385
- ...renderError !== void 0 ? {
386
- renderError: ({ error, retry }) => renderError({ error, retry, props })
387
- } : {},
388
- children: (value) => render(props, value, ref)
389
- });
389
+ const { entry, locale } = useGateLoad(hocOptions.namespaces);
390
+ const displayValue = gateValueFromEntry(entry);
391
+ const value = displayValue ?? { t: noopT, locale };
392
+ const rendered = render(props, value, ref);
393
+ if (entry.status === "error" && entry.t === null) {
394
+ if (renderError) {
395
+ return renderError({ error: entry.error, retry: entry.retry, props });
396
+ }
397
+ throw toThrownError(entry.error);
398
+ }
399
+ if (displayValue !== null) {
400
+ return rendered;
401
+ }
402
+ if (fallback === void 0) {
403
+ return null;
404
+ }
405
+ return typeof fallback === "function" ? fallback(props) : fallback;
390
406
  });
391
407
  const displayName = render.name || "Component";
392
408
  Outer.displayName = `withI18n(${displayName})`;
package/dist/index.js.map CHANGED
@@ -1 +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 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"]}
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 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\nconst noopT: ScopedTranslateFn = () => \"\";\n\n/** Gate value for display, or `null` when only fallback / error UI should show. */\nfunction gateValueFromEntry(entry: LoadDisplayEntry<ScopedScopeLike>): I18nLoadGateValue | null {\n if (entry.status === \"ready\") {\n return { t: entry.t, locale: entry.locale };\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 value;\n }\n\n return null;\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 === \"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 const value = gateValueFromEntry(entry);\n if (value !== null) {\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 useGateLoad(namespaces: readonly string[]): {\n entry: LoadDisplayEntry<ScopedScopeLike>;\n locale: string;\n } {\n const resolved = resolveNamespaces(namespaces);\n const args = useLoadArgs();\n const entry = 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 return { entry, locale: args.locale };\n }\n\n function I18n({ namespaces, fallback, renderError, children }: I18nGateProps): ReactNode {\n const { entry } = useGateLoad(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, locale } = useGateLoad(hocOptions.namespaces);\n\n // Always invoke `render` so hooks inside it are Outer hooks and stay\n // unconditional across pending → ready (e.g. I18nRoot without hydrated state).\n const displayValue = gateValueFromEntry(entry);\n const value = displayValue ?? ({ t: noopT, locale } satisfies I18nLoadGateValue);\n const rendered = render(props as P, value, ref);\n\n if (entry.status === \"error\" && entry.t === null) {\n if (renderError) {\n return renderError({ error: entry.error, retry: entry.retry!, props: props as P });\n }\n throw toThrownError(entry.error);\n }\n\n if (displayValue !== null) {\n return rendered;\n }\n\n if (fallback === undefined) {\n return null;\n }\n return typeof fallback === \"function\" ? fallback(props as P) : fallback;\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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xndrjs/i18n-react",
3
- "version": "0.8.2-alpha.0",
3
+ "version": "0.8.2-alpha.1",
4
4
  "description": "React runtime primitives and codegen for @xndrjs/i18n client bindings.",
5
5
  "private": false,
6
6
  "license": "MIT",
@@ -28,7 +28,7 @@
28
28
  "node": ">=18"
29
29
  },
30
30
  "peerDependencies": {
31
- "@xndrjs/i18n": "^0.8.2-alpha.0",
31
+ "@xndrjs/i18n": "^0.8.2-alpha.1",
32
32
  "react": ">=19",
33
33
  "zod": "^4.0.0"
34
34
  },
@@ -43,7 +43,7 @@
43
43
  "tsx": "^4.22.4",
44
44
  "vitest": "^4.1.0",
45
45
  "zod": "^4.3.6",
46
- "@xndrjs/i18n": "^0.8.2-alpha.0"
46
+ "@xndrjs/i18n": "^0.8.2-alpha.1"
47
47
  },
48
48
  "scripts": {
49
49
  "build": "tsup",