@owlmeans/client-i18n 0.1.18-rc.49 → 0.1.18-rc.50

package/README.md

@@ -12,7 +12,7 @@ React i18next adapter that loads translations registered via `@owlmeans/i18n` in
 ## Installation
 
 ```bash
-bun add @owlmeans/client-i18n@^0.1.18-rc.49
+bun add @owlmeans/client-i18n@^0.1.18-rc.50
 ```
 
 ## Usage
@@ -58,7 +58,7 @@ Returns a `t()` function for shared/common translations.
 
 ## Related Packages
 
-- [`@owlmeans/i18n`](../i18n) — `addI18nApp`, `addI18n` to register translations before render
+- [`@owlmeans/i18n`](../i18n) — `i18nHelper.addI18nApp` / `i18nHelper.addI18nLib` to register translations before render
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -68,7 +68,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.48
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/client-i18n",
-  "version": "0.1.18-rc.49",
-  "generatedAt": "2026-10-05T08:32:19.120Z",
+  "version": "0.1.18-rc.50",
+  "generatedAt": "2026-10-05T21:03:06.397Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/client-i18n/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: client-i18n
-description: How to use @owlmeans/client-i18n — React i18n context built on i18next. Auto-invoked when setting up translation in a React app, using translation hooks, working with language switching, or awaiting deferred language packs with prepareI18n.
+description: How to use @owlmeans/client-i18n — React i18n context built on i18next. Auto-invoked when setting up translation in a React app, using translation hooks, working with language switching, or awaiting deferred language packs with i18nInstanceHelper.prepareI18n.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,11 +8,11 @@ user-invocable: false
 # @owlmeans/client-i18n
 
 **Layer:** Client (React)
-**Install:** `"@owlmeans/client-i18n": "^0.1.18-rc.49"` in `dependencies`
+**Install:** `"@owlmeans/client-i18n": "^0.1.18-rc.50"` in `dependencies`
 
 ## Purpose
 
-Wraps i18next + react-i18next, lazily loads registered bundles from `@owlmeans/i18n` storage into the i18next instance, awaits deferred language packs (`prepareI18n`, `setLanguage`), and provides hooks for translating strings.
+Wraps i18next + react-i18next, lazily loads registered bundles from `@owlmeans/i18n` storage into the i18next instance, awaits deferred language packs (`i18nInstanceHelper.prepareI18n`, `setLanguage`), and provides hooks for translating strings.
 
 ## Key Exports
 
@@ -23,7 +23,7 @@ Wraps i18next + react-i18next, lazily loads registered bundles from `@owlmeans/i
 | `useI18nApp(resource?, prefix?)` | Hook for app strings (ns=resource name; defaults to `context.cfg.service`) |
 | `useI18n(resource, ns?, prefix?)` | Low-level hook with explicit ns — use when ns ≠ resource |
 | `useLanguage()` | `[currentLng, setLng]` — the i18next instance's language, and an async switch — see Language persistence |
-| `prepareI18n`, `resolveInitialLanguage`, `setLanguage` | Re-exported from `./utils` — see below |
+| `i18nInstanceHelper` / `createI18nInstanceHelper()` | Re-exported from `./utils` — see below |
 | `composePrefix(parent?, child?)` | Canonical dot-join for prefix chaining; never call manually in panel code — used internally |
 | `I18nBaseProps` | `{ resource?, ns?, prefix?, suppress? }` |
 | `I18nProps` | `{ i18n?: I18nBaseProps }` |
@@ -36,27 +36,28 @@ The instance itself, for a host that has to configure i18next before the tree re
 | Export | Description |
 |---|---|
 | `useI18nInstance(config)` | The i18next instance for this application, memoised for the mount |
-| `getI18nInstance(config)` | The same instance outside React |
-| `setLanguage(lng)` | Async: load `lng`'s pack (`loadI18nLanguage`), then persist and switch — what `useLanguage`'s setter calls |
-| `prepareI18n(config)` | Await the fallback language's loaders, then the initial language's; resolves to the language the instance will start in. Call once, before the first render |
-| `resolveInitialLanguage(config)` | The persisted `owlmeans-lng` when it is in `supportedLngs`, else the browser's language (`preferredLanguageOf`), else `fallbackLng ?? defaultLng ?? DEFAULT_LNG` |
-| `preferredLanguageOf(supportedLngs, preferred)` | Pure: the first preferred tag the config supports, exact or by base (`de-DE` → `de`), else `null` |
+| `i18nInstanceHelper.getI18nInstance(config)` | The same instance outside React |
+| `i18nInstanceHelper.setLanguage(lng)` | Async: load `lng`'s pack (`i18nHelper.loadI18nLanguage`), then persist and switch — what `useLanguage`'s setter calls |
+| `i18nInstanceHelper.prepareI18n(config)` | Await the fallback language's loaders, then the initial language's; resolves to the language the instance will start in. Call once, before the first render |
+| `i18nInstanceHelper.resolveInitialLanguage(config)` | The persisted `owlmeans-lng` when it is in `supportedLngs`, else the browser's language (`preferredLanguageOf`), else `fallbackLng ?? defaultLng ?? DEFAULT_LNG` |
+| `i18nInstanceHelper.preferredLanguageOf(supportedLngs, preferred)` | Pure: the first preferred tag the config supports, exact or by base (`de-DE` → `de`), else `null` |
 
-All of these live in `src/utils/instance.ts`; the package root re-exports `prepareI18n`,
-`resolveInitialLanguage` and `setLanguage`.
+The helper lives in `src/utils/instance.ts`, its interface in `src/utils/instance/types.ts`; the
+package root re-exports `i18nInstanceHelper` and `createI18nInstanceHelper`.
 
 **There is exactly one instance per document**, created on first request and reused by every later
 call whatever config is passed. So configuration is read once, at the first creation, and a plugin
 is installed on the instance rather than passed to a second factory.
 
 **The instance is initialized at creation with an explicit `lng`**, which is why the language is
-resolved there and not by a plugin — by `resolveInitialLanguage` (or `prepareI18n`, which runs it):
-the persisted choice (`owlmeans-lng`, when supported), else the browser's own language
-(`navigator.languages` through `preferredLanguageOf` — a first visit from a German browser opens in
-German), else `fallbackLng`. A language detector installed afterwards (`instance.use(detector)`,
-which `@owlmeans/web-panel`'s `render` still does) is never consulted — harmless, but not what
-detects. A detected language is not persisted, not even by the start-up switch that follows a
-deferred pack's load; only an explicit choice (`setLanguage`) is.
+resolved there and not by a plugin — by `i18nInstanceHelper.resolveInitialLanguage` (or
+`prepareI18n`, which runs it): the persisted choice (`owlmeans-lng`, when supported), else the
+browser's own language (`navigator.languages` through `preferredLanguageOf` — a first visit from a
+German browser opens in German), else `fallbackLng`. A language detector installed afterwards
+(`instance.use(detector)`, which `@owlmeans/web-panel`'s `render` still does) is never consulted —
+harmless, but not what detects. A detected language is not persisted, not even by the start-up
+switch that follows a deferred pack's load; only an explicit choice
+(`i18nInstanceHelper.setLanguage`) is.
 
 ## Setup (app root)
 
@@ -74,24 +75,24 @@ function App() {
 
 `clientConfig.i18n` is optional; it defaults to `SUPPORTED_LNGS` and `'en'` fallback.
 
-**An app that defers language packs** (`addI18nLoader`, the `i18n` skill) calls
-`await prepareI18n(config)` BEFORE its first render — never after:
+**An app that defers language packs** (`i18nHelper.addI18nLoader`, the `i18n` skill) calls
+`await i18nInstanceHelper.prepareI18n(config)` BEFORE its first render — never after:
 
 ```ts
-import { prepareI18n } from '@owlmeans/client-i18n'
+import { i18nInstanceHelper } from '@owlmeans/client-i18n'
 
-await prepareI18n(context.cfg)   // fallback pack first, then the persisted / browser / fallback one
+await i18nInstanceHelper.prepareI18n(context.cfg)   // fallback pack first, then the persisted / browser / fallback one
 render(context)
 ```
 
 This composes with an async boot because `@owlmeans/web-client`'s `render` (and so `renderApp` and
 `@owlmeans/web-panel`'s `render`) checks `document.readyState` instead of waiting for a
-`DOMContentLoaded` that already fired. `prepareI18n` rejects only when the FALLBACK pack fails; when
-the initial language's pack fails it logs, resolves to the fallback and leaves the persisted choice
-alone, so the next visit retries it rather than stranding the user. Without `prepareI18n`, the
-instance starts in the fallback whenever the wanted language is not loaded yet and switches once its
-loaders finish (a brief fallback flash) — but nothing awaits a deferred FALLBACK pack, whose slots
-are then drained empty for the session.
+`DOMContentLoaded` that already fired. `i18nInstanceHelper.prepareI18n` rejects only when the
+FALLBACK pack fails; when the initial language's pack fails it logs, resolves to the fallback and
+leaves the persisted choice alone, so the next visit retries it rather than stranding the user.
+Without `prepareI18n`, the instance starts in the fallback whenever the wanted language is not
+loaded yet and switches once its loaders finish (a brief fallback flash) — but nothing awaits a
+deferred FALLBACK pack, whose slots are then drained empty for the session.
 
 ## Language persistence
 
@@ -100,23 +101,24 @@ only when it is in `supportedLngs`, so a stored value that a later release dropp
 the browser's language, then `fallbackLng`, instead of resolving nothing. Every storage and
 `navigator` access is guarded, so a browser that refuses site data (or no browser) still renders.
 
-`tests/instance.spec.ts` pins `preferredLanguageOf` (base matching, browser order, exact tag first,
-`null` when nothing matches) and that an explicit choice is always stored and read back.
+`tests/instance.spec.ts` pins `i18nInstanceHelper.preferredLanguageOf` (base matching, browser
+order, exact tag first, `null` when nothing matches) and that an explicit choice is always stored
+and read back.
 
 **Persistence is unconditional.** The interface language is strictly necessary storage — the visitor
-asked for it by choosing it — so `setLanguage` writes `owlmeans-lng` on every explicit switch and
-`resolveInitialLanguage` reads it at every start, whatever cookie decision was made (the `consent`
-skill has the reasoning, and how a language carried by a link from another OwlMeans domain lands in
-the same key before the app renders). There is no guard to install and no consent hook: the
-earlier `setLanguagePersistence` / `persistLanguage` / `getExplicitLanguage` are gone, and
-`@owlmeans/web-panel/consent`'s `installConsentLanguage()` is a deprecated no-op kept for
-applications that still call it. A start-up switch to a language nobody chose (the browser's) is never
-written — only an explicit choice is.
-
-`setLanguage(lng)` is async: it awaits `loadI18nLanguage(lng)`, then persists and calls i18next's
-`changeLanguage` — before the instance exists it records the language the instance will start in
-instead. The LAST call wins: an earlier call whose load finishes later does nothing. A failed load
-rejects, and nothing is persisted or switched.
+asked for it by choosing it — so `i18nInstanceHelper.setLanguage` writes `owlmeans-lng` on every
+explicit switch and `resolveInitialLanguage` reads it at every start, whatever cookie decision was
+made (the `consent` skill has the reasoning, and how a language carried by a link from another
+OwlMeans domain lands in the same key before the app renders). There is no guard to install and no
+consent hook: the earlier `setLanguagePersistence` / `persistLanguage` / `getExplicitLanguage` are
+gone, and `@owlmeans/web-panel/consent`'s `installConsentLanguage()` is a deprecated no-op kept for
+applications that still call it. A start-up switch to a language nobody chose (the browser's) is
+never written — only an explicit choice is.
+
+`i18nInstanceHelper.setLanguage(lng)` is async: it awaits `i18nHelper.loadI18nLanguage(lng)`, then
+persists and calls i18next's `changeLanguage` — before the instance exists it records the language
+the instance will start in instead. The LAST call wins: an earlier call whose load finishes later
+does nothing. A failed load rejects, and nothing is persisted or switched.
 
 `useLanguage()` returns `i18n.language` from `useTranslation()`, not local state, so every caller
 re-renders on i18next's `languageChanged` and shows the same language whoever switched it. Its
@@ -185,16 +187,17 @@ Import the library's i18n registration **and** register your own version at App
 library's namespace**:
 ```typescript
 import '@owlmeans/error'               // the library bundle, registered by side effect
-import { addI18nApp, LIB_NAMESPACE } from '@owlmeans/i18n'
+import { i18nHelper, LIB_NAMESPACE } from '@owlmeans/i18n'
 import myErrors from './i18n/en.json' with { type: 'json' }
 
 // App tier merges last within (ns, resource, lng) — these override the library's 'errors' strings
-addI18nApp('en', 'errors', myErrors, { ns: LIB_NAMESPACE })
+i18nHelper.addI18nApp('en', 'errors', myErrors, { ns: LIB_NAMESPACE })
 ```
 
-`{ ns: LIB_NAMESPACE }` is what makes it an override. `addI18nApp` defaults the namespace to the
-**resource** name, so without it the bundle lands in namespace `errors` while `useI18nLib('errors')`
-reads namespace `lib` — nothing errors, nothing merges, and the library strings keep rendering.
+`{ ns: LIB_NAMESPACE }` is what makes it an override. `i18nHelper.addI18nApp` defaults the namespace
+to the **resource** name, so without it the bundle lands in namespace `errors` while
+`useI18nLib('errors')` reads namespace `lib` — nothing errors, nothing merges, and the library
+strings keep rendering.
 
 A package registers its strings from its own root: `src/i18n.ts` is re-exported by `src/index.ts`,
 so importing the package is what loads them. No package publishes an `./i18n` subpath.

package/build/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAMxC,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAI3C,CAAA;AAEF,kGAAkG;AAClG,eAAO,MAAM,aAAa,YAAa,MAAM,UAAU,MAAM,KAAG,MAK/D,CAAA;AAyCD;4FAC4F;AAC5F,eAAO,MAAM,OAAO,aAAc,MAAM,OAAO,MAAM,WAAW,MAAM,KAAG,SAExE,CAAA;AAED,eAAO,MAAM,UAAU,YAAa,MAAM,WAAW,MAAM,KAAG,SAE7D,CAAA;AAED,eAAO,MAAM,UAAU,aAAc,MAAM,WAAW,MAAM,KAAG,SAK9D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAYrE,CAAA"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAOxC,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAI3C,CAAA;AAEF,kGAAkG;AAClG,eAAO,MAAM,aAAa,YAAa,MAAM,UAAU,MAAM,KAAG,MAK/D,CAAA;AAyCD;4FAC4F;AAC5F,eAAO,MAAM,OAAO,aAAc,MAAM,OAAO,MAAM,WAAW,MAAM,KAAG,SAExE,CAAA;AAED,eAAO,MAAM,UAAU,YAAa,MAAM,WAAW,MAAM,KAAG,SAE7D,CAAA;AAED,eAAO,MAAM,UAAU,aAAc,MAAM,WAAW,MAAM,KAAG,SAK9D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAYrE,CAAA"}

package/build/context.js

@@ -1,8 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { memo, useCallback } from 'react';
 import { I18nextProvider, useTranslation } from 'react-i18next';
-import { setLanguage, useI18nInstance } from './utils/instance.js';
-import { DEFAULT_LNG, DEFAULT_NAMESPACE, initI18nResource, LIB_NAMESPACE } from '@owlmeans/i18n';
+import { i18nInstanceHelper } from './utils/instance.js';
+import { useI18nInstance } from './utils/hook.js';
+import { DEFAULT_LNG, DEFAULT_NAMESPACE, i18nHelper, LIB_NAMESPACE } from '@owlmeans/i18n';
 import { useContext } from '@owlmeans/client';
 import { logger } from '@owlmeans/log';
 export const I18nContext = memo(({ config, children }) => {
@@ -25,7 +26,7 @@ const useI18nResource = (resourceName, ns, prefix) => {
     const key = `${i18n.language}:${resourceName}:${resolvedNs}`;
     if (!i18nLoadingCache.has(key)) {
         i18nLoadingCache.add(key);
-        const resources = initI18nResource(i18n.language, resourceName, resolvedNs);
+        const resources = i18nHelper.initI18nResource(i18n.language, resourceName, resolvedNs);
         if (resources != null) {
             resources.forEach(resource => i18n.addResourceBundle(i18n.language, resolvedNs, { [resourceName]: resource.data }, true, true));
         }
@@ -35,7 +36,7 @@ const useI18nResource = (resourceName, ns, prefix) => {
             const fallbackKey = `${defLng}:${resourceName}:${resolvedNs}`;
             if (!i18nLoadingCache.has(fallbackKey)) {
                 i18nLoadingCache.add(fallbackKey);
-                const defResources = initI18nResource(defLng, resourceName, resolvedNs);
+                const defResources = i18nHelper.initI18nResource(defLng, resourceName, resolvedNs);
                 defResources?.forEach(resource => i18n.addResourceBundle(defLng, resolvedNs, { [resourceName]: resource.data }, true, true));
             }
         }
@@ -68,7 +69,7 @@ export const useLanguage = () => {
     const { i18n } = useTranslation();
     const changeLng = useCallback(async (next) => {
         try {
-            await setLanguage(next);
+            await i18nInstanceHelper.setLanguage(next);
         }
         catch (error) {
             logger('i18n').error('language switch failed', error);

package/build/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types.js';
+export type * from './utils/instance/types.js';
 export { I18nContext, composePrefix, useI18n, useI18nLib, useI18nApp, useLanguage } from './context.js';
-export { prepareI18n, resolveInitialLanguage, setLanguage } from './utils/instance.js';
+export { i18nInstanceHelper, createI18nInstanceHelper, prepareI18n, setLanguage } from './utils/instance.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACvG,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,mBAAmB,2BAA2B,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACvG,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA"}

package/build/index.js

@@ -1,4 +1,4 @@
 export * from './types.js';
 export { I18nContext, composePrefix, useI18n, useI18nLib, useI18nApp, useLanguage } from './context.js';
-export { prepareI18n, resolveInitialLanguage, setLanguage } from './utils/instance.js';
+export { i18nInstanceHelper, createI18nInstanceHelper, prepareI18n, setLanguage } from './utils/instance.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACvG,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAE1B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACvG,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA"}

package/build/utils/hook.d.ts

@@ -0,0 +1,5 @@
+import type { i18n } from 'i18next';
+import type { ClientConfig } from '@owlmeans/client-context';
+/** The process's i18next instance, created on the first render that asks. */
+export declare const useI18nInstance: (config: ClientConfig) => i18n;
+//# sourceMappingURL=hook.d.ts.map

package/build/utils/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/utils/hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,6EAA6E;AAC7E,eAAO,MAAM,eAAe,WAAY,YAAY,KAAG,IAItD,CAAA"}

package/build/utils/hook.js

@@ -0,0 +1,8 @@
+import { useMemo } from 'react';
+import { i18nInstanceHelper } from './instance.js';
+/** The process's i18next instance, created on the first render that asks. */
+export const useI18nInstance = (config) => {
+    const instance = useMemo(() => i18nInstanceHelper.getI18nInstance(config), []);
+    return instance;
+};
+//# sourceMappingURL=hook.js.map

package/build/utils/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/utils/hook.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAoB,EAAQ,EAAE;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;IAE9E,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA"}

package/build/utils/index.d.ts

@@ -1,2 +1,4 @@
+export type * from './instance/types.js';
 export * from './instance.js';
+export * from './hook.js';
 //# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,mBAAmB,qBAAqB,CAAA;AACxC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA"}

package/build/utils/index.js

@@ -1,2 +1,3 @@
 export * from './instance.js';
+export * from './hook.js';
 //# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA"}

package/build/utils/instance/types.d.ts

@@ -0,0 +1,40 @@
+import type { i18n } from 'i18next';
+import type { ClientConfig } from '@owlmeans/client-context';
+/** The process's one i18next instance and the language it runs in. */
+export interface I18nInstanceHelper {
+    /** The process's i18next instance, created on first use from `config`. */
+    getI18nInstance: (config: ClientConfig) => i18n;
+    /**
+     * Load `lng`'s registered loaders, then persist it and switch the instance to it. Race-safe:
+     * when several calls overlap, the latest one wins whatever order their loads finish in.
+     * Rejects when the language's pack fails to load; nothing is persisted or switched then.
+     *
+     * The choice is stored unconditionally: the interface language is strictly necessary storage — the
+     * visitor asked for it by choosing it — so no cookie decision stands between a switch and
+     * `owlmeans-lng`.
+     */
+    setLanguage: (lng: string) => Promise<void>;
+    /**
+     * Await the app's fallback language and its initial one (`resolveInitialLanguage`) before the app
+     * renders, so the first paint is already in the right language instead of flashing the
+     * fallback and then switching. Call it BEFORE `render(...)`. Resolves to the language the
+     * instance will start in: the fallback when the initial language's pack fails to load — the
+     * persisted choice is kept then, so the next visit retries it. Rejects only when the fallback
+     * language's own pack fails.
+     */
+    prepareI18n: (config: ClientConfig) => Promise<string>;
+    /**
+     * The language the app starts in: the one persisted under `owlmeans-lng` when it is still in
+     * `supportedLngs` (a person's explicit choice); else, on a first visit, the browser's own language
+     * (`navigator.languages` through `preferredLanguageOf` — a German browser opens in German); else
+     * `fallbackLng ?? defaultLng ?? DEFAULT_LNG`. The instance is initialized with this explicit `lng`,
+     * so a detector plugin installed afterwards (`instance.use(detector)`) is never consulted.
+     */
+    resolveInitialLanguage: (config: ClientConfig) => string;
+    /**
+     * The first of the browser's preferred languages the application supports — exact (`pt-BR`) or by
+     * its base (`de-DE` → `de`) — or `null` when none is. Pure, so a host (or a test) can pass the list.
+     */
+    preferredLanguageOf: (supportedLngs: readonly string[], preferred: readonly (string | null | undefined)[]) => string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/instance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/instance/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,eAAe,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IAC/C;;;;;;;;OAQG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C;;;;;;;OAOG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACtD;;;;;;OAMG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAA;IACxD;;;OAGG;IACH,mBAAmB,EAAE,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,KAAK,MAAM,GAAG,IAAI,CAAA;CAC5H"}

package/build/utils/instance/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/instance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/instance/types.ts"],"names":[],"mappings":""}

package/build/utils/instance.d.ts

@@ -1,37 +1,14 @@
 import { type i18n } from 'i18next';
 import type { ClientConfig } from '@owlmeans/client-context';
-export declare const useI18nInstance: (config: ClientConfig) => i18n;
+import type { I18nInstanceHelper } from './instance/types.js';
+export declare const createI18nInstanceHelper: () => I18nInstanceHelper;
+export declare const i18nInstanceHelper: I18nInstanceHelper;
+/** @deprecated compat:factory-refactor — use `i18nInstanceHelper.getI18nInstance(…)` */
 export declare const getI18nInstance: (config: ClientConfig) => i18n;
-/**
- * Load `lng`'s registered loaders, then persist it and switch the instance to it. Race-safe:
- * when several calls overlap, the latest one wins whatever order their loads finish in.
- * Rejects when the language's pack fails to load; nothing is persisted or switched then.
- *
- * The choice is stored unconditionally: the interface language is strictly necessary storage — the
- * visitor asked for it by choosing it — so no cookie decision stands between a switch and
- * `owlmeans-lng`.
- */
+/** @deprecated compat:factory-refactor — use `i18nInstanceHelper.setLanguage(…)` */
 export declare const setLanguage: (lng: string) => Promise<void>;
-/**
- * Await the app's fallback language and its initial one (`resolveInitialLanguage`) before the app
- * renders, so the first paint is already in the right language instead of flashing the
- * fallback and then switching. Call it BEFORE `render(...)`. Resolves to the language the
- * instance will start in: the fallback when the initial language's pack fails to load — the
- * persisted choice is kept then, so the next visit retries it. Rejects only when the fallback
- * language's own pack fails.
- */
+/** @deprecated compat:factory-refactor — use `i18nInstanceHelper.prepareI18n(…)` */
 export declare const prepareI18n: (config: ClientConfig) => Promise<string>;
-/**
- * The language the app starts in: the one persisted under `owlmeans-lng` when it is still in
- * `supportedLngs` (a person's explicit choice); else, on a first visit, the browser's own language
- * (`navigator.languages` through `preferredLanguageOf` — a German browser opens in German); else
- * `fallbackLng ?? defaultLng ?? DEFAULT_LNG`. The instance is initialized with this explicit `lng`,
- * so a detector plugin installed afterwards (`instance.use(detector)`) is never consulted.
- */
-export declare const resolveInitialLanguage: (config: ClientConfig) => string;
-/**
- * The first of the browser's preferred languages the application supports — exact (`pt-BR`) or by
- * its base (`de-DE` → `de`) — or `null` when none is. Pure, so a host (or a test) can pass the list.
- */
+/** @deprecated compat:factory-refactor — use `i18nInstanceHelper.preferredLanguageOf(…)` */
 export declare const preferredLanguageOf: (supportedLngs: readonly string[], preferred: readonly (string | null | undefined)[]) => string | null;
 //# sourceMappingURL=instance.d.ts.map

package/build/utils/instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/utils/instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,SAAS,CAAA;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAuB5D,eAAO,MAAM,eAAe,WAAY,YAAY,KAAG,IAItD,CAAA;AAED,eAAO,MAAM,eAAe,WAAY,YAAY,KAAG,IAC3B,CAAA;AAE5B;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAA8B,CAAA;AAwBpF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,WAAkB,YAAY,KAAG,OAAO,CAAC,MAAM,CAatE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,WAAY,YAAY,KAAG,MAO7D,CAAA;AAaD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kBACf,SAAS,MAAM,EAAE,aAAa,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,KAClF,MAAM,GAAG,IAUX,CAAA"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/utils/instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAI5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAW7D,eAAO,MAAM,wBAAwB,QAAO,kBA8I3C,CAAA;AAED,eAAO,MAAM,kBAAkB,oBAA6B,CAAA;AAE5D,wFAAwF;AACxF,eAAO,MAAM,eAAe,WAAY,YAAY,KAAG,IAAkD,CAAA;AAEzG,oFAAoF;AACpF,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAAwC,CAAA;AAE9F,oFAAoF;AACpF,eAAO,MAAM,WAAW,WAAY,YAAY,KAAG,OAAO,CAAC,MAAM,CAA2C,CAAA;AAE5G,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,kBACf,SAAS,MAAM,EAAE,aAAa,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,KAClF,MAAM,GAAG,IAAwE,CAAA"}