@owlmeans/client-i18n 0.1.18-rc.41 → 0.1.18-rc.43

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.41
+bun add @owlmeans/client-i18n@^0.1.18-rc.43
 ```
 
 ## Usage
@@ -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.39
+npx @owlmeans/agent-skills@^0.1.18-rc.41
 ```
 
 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.41",
-  "generatedAt": "2026-09-25T15:32:39.584Z",
+  "version": "0.1.18-rc.43",
+  "generatedAt": "2026-09-28T02:06:37.882Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/client-i18n
 
 **Layer:** Client (React)
-**Install:** `"@owlmeans/client-i18n": "^0.1.18-rc.41"` in `dependencies`
+**Install:** `"@owlmeans/client-i18n": "^0.1.18-rc.43"` in `dependencies`
 
 ## Purpose
 
@@ -37,16 +37,13 @@ The instance itself, for a host that has to configure i18next before the tree re
 |---|---|
 | `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 (if the persistence guard allows) and switch — what `useLanguage`'s setter calls |
-| `setLanguagePersistence(guard \| null)` | Install the guard that decides whether an explicit choice may be written to storage; `null` removes it. Call BEFORE `prepareI18n` |
-| `persistLanguage()` | Write the explicit choice storage refused earlier, now that the guard allows; `false` when nothing waits or storage is still refused |
-| `getExplicitLanguage()` | The language a person chose explicitly since this page loaded (stored or not), else `null` — what a host asks before applying a language that arrived some other way |
+| `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` |
 
 All of these live in `src/utils/instance.ts`; the package root re-exports `prepareI18n`,
-`resolveInitialLanguage`, `setLanguage` and the three persistence functions above.
+`resolveInitialLanguage` and `setLanguage`.
 
 **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
@@ -104,17 +101,17 @@ the browser's language, then `fallbackLng`, instead of resolving nothing. Every
 `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 the persistence guard.
-
-**Persistence is guarded, not assumed.** With no guard installed every explicit choice is written, as
-always. An application that asks its visitors before remembering anything installs one
-(`setLanguagePersistence(() => allowed)`; `@owlmeans/web-panel/consent`'s `installConsentLanguage()` is
-the ready-made one for the cookie dialog's `functional` category — see the `consent` skill). While it
-says no: `setLanguage` still switches the UI but writes nothing and remembers the refused choice
-(`persistLanguage()` writes it when storage becomes allowed), and a value already in storage counts
-as ABSENT at start-up (`resolveInitialLanguage`), so a language nobody was allowed to remember is not
-used. Installing a guard also resets what this page has chosen so far — install it before anything
-calls `setLanguage`.
+`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

package/build/index.d.ts

@@ -1,4 +1,4 @@
 export * from './types.js';
 export { I18nContext, composePrefix, useI18n, useI18nLib, useI18nApp, useLanguage } from './context.js';
-export { prepareI18n, resolveInitialLanguage, setLanguage, setLanguagePersistence, persistLanguage, getExplicitLanguage, } from './utils/instance.js';
+export { prepareI18n, resolveInitialLanguage, 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,EACL,WAAW,EAAE,sBAAsB,EAAE,WAAW,EAAE,sBAAsB,EAAE,eAAe,EAAE,mBAAmB,GAC/G,MAAM,qBAAqB,CAAA"}
+{"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"}

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, setLanguagePersistence, persistLanguage, getExplicitLanguage, } from './utils/instance.js';
+export { prepareI18n, resolveInitialLanguage, 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,EACL,WAAW,EAAE,sBAAsB,EAAE,WAAW,EAAE,sBAAsB,EAAE,eAAe,EAAE,mBAAmB,GAC/G,MAAM,qBAAqB,CAAA"}
+{"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"}

package/build/utils/instance.d.ts

@@ -1,29 +1,15 @@
 import type { i18n } from 'i18next';
 import type { ClientConfig } from '@owlmeans/client-context';
-/**
- * The language a person chose explicitly since this page loaded (`setLanguage`), or `null`. What a
- * host asks before it applies a language that arrived some other way — a link — which must never
- * override what the person just picked.
- */
-export declare const getExplicitLanguage: () => string | null;
-/**
- * Install (or, with `null`, remove) the guard that decides whether a language choice may be
- * remembered. Call it BEFORE `prepareI18n`: the initial language is resolved from storage, and a
- * guard that says no makes a stored value count as absent.
- */
-export declare const setLanguagePersistence: (guard: (() => boolean) | null) => void;
-/**
- * Write the explicit choice storage refused earlier, now that it may be — call it when the guard's
- * answer turns to yes (the visitor granted functional storage). `false` when there was nothing
- * waiting, storage is still refused, or the write failed.
- */
-export declare const persistLanguage: () => boolean;
 export declare const useI18nInstance: (config: ClientConfig) => i18n;
 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`.
  */
 export declare const setLanguage: (lng: string) => Promise<void>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/utils/instance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AA4B5D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAO,MAAM,GAAG,IAAsB,CAAA;AAItE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,UAAW,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,KAAG,IAKtE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,OAYlC,CAAA;AAED,eAAO,MAAM,eAAe,WAAY,YAAY,KAAG,IAItD,CAAA;AAED,eAAO,MAAM,eAAe,WAAY,YAAY,KAAG,IAC3B,CAAA;AAE5B;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAA8B,CAAA;AA+BpF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,WAAkB,YAAY,KAAG,OAAO,CAAC,MAAM,CAatE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,WAAY,YAAY,KAAG,MAO7D,CAAA;AAgBD;;;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":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAa5D,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"}

package/build/utils/instance.js

@@ -8,54 +8,6 @@ let i18nInstance = null;
 let preparedLng;
 /** The language of the latest `setLanguage` call — an earlier call that finishes later yields to it. */
 let requestedLng;
-/**
- * Whether an explicit language choice may be written to storage right now. Unset, storage is always
- * allowed — an application with no notion of consent behaves exactly as before. A host that asks its
- * visitors (`@owlmeans/web-panel/consent`'s `installConsentLanguage`) installs one that answers
- * "has the visitor allowed functional storage?", so a language is not remembered on a device nobody
- * asked about.
- */
-let persistenceGuard = null;
-/** The latest explicit choice that storage refused; written the moment storage is allowed. */
-let refusedChoice = null;
-/** The latest language a person chose explicitly in this page's life, stored or not. */
-let explicitChoice = null;
-/**
- * The language a person chose explicitly since this page loaded (`setLanguage`), or `null`. What a
- * host asks before it applies a language that arrived some other way — a link — which must never
- * override what the person just picked.
- */
-export const getExplicitLanguage = () => explicitChoice;
-const persistenceAllowed = () => persistenceGuard == null || persistenceGuard();
-/**
- * Install (or, with `null`, remove) the guard that decides whether a language choice may be
- * remembered. Call it BEFORE `prepareI18n`: the initial language is resolved from storage, and a
- * guard that says no makes a stored value count as absent.
- */
-export const setLanguagePersistence = (guard) => {
-    persistenceGuard = guard;
-    // A new guard starts a new account of what this page's visitor has chosen and what storage refused.
-    refusedChoice = null;
-    explicitChoice = null;
-};
-/**
- * Write the explicit choice storage refused earlier, now that it may be — call it when the guard's
- * answer turns to yes (the visitor granted functional storage). `false` when there was nothing
- * waiting, storage is still refused, or the write failed.
- */
-export const persistLanguage = () => {
-    if (refusedChoice == null || !persistenceAllowed()) {
-        return false;
-    }
-    try {
-        localStorage.setItem(LNG_STORAGE_KEY, refusedChoice);
-        refusedChoice = null;
-        return true;
-    }
-    catch (_) {
-        return false;
-    }
-};
 export const useI18nInstance = (config) => {
     const instance = useMemo(() => createI18nInstance(config), []);
     return instance;
@@ -65,6 +17,10 @@ export const getI18nInstance = (config) => createI18nInstance(config);
  * 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`.
  */
 export const setLanguage = (lng) => switchLanguage(lng, true);
 /**
@@ -78,18 +34,10 @@ const switchLanguage = async (lng, persist) => {
         return;
     }
     if (persist) {
-        explicitChoice = lng;
-        if (persistenceAllowed()) {
-            refusedChoice = null;
-            try {
-                localStorage.setItem(LNG_STORAGE_KEY, lng);
-            }
-            catch (_) { /* noop in non-browser environments */ }
-        }
-        else {
-            // Not remembered — but not forgotten either: the visitor may allow it a moment later.
-            refusedChoice = lng;
+        try {
+            localStorage.setItem(LNG_STORAGE_KEY, lng);
         }
+        catch (_) { /* noop in non-browser environments */ }
     }
     if (i18nInstance == null) {
         preparedLng = lng;
@@ -135,9 +83,6 @@ export const resolveInitialLanguage = (config) => {
 };
 const resolveFallbackLanguage = (config) => config.i18n?.fallbackLng ?? config.i18n?.defaultLng ?? DEFAULT_LNG;
 const getPersistedLanguage = () => {
-    if (!persistenceAllowed()) {
-        return null;
-    }
     try {
         return localStorage.getItem(LNG_STORAGE_KEY);
     }

package/build/utils/instance.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-i18n",
-  "version": "0.1.18-rc.41",
+  "version": "0.1.18-rc.43",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -37,8 +37,8 @@
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/client": "^0.1.18-rc.42",
-    "@owlmeans/client-context": "^0.1.18-rc.39",
+    "@owlmeans/client": "^0.1.18-rc.44",
+    "@owlmeans/client-context": "^0.1.18-rc.41",
     "@owlmeans/i18n": "^0.1.18-rc.37",
     "i18next": "^26.2.0",
     "react-i18next": "^17.0.11"

package/src/index.ts

@@ -1,6 +1,4 @@
 
 export * from './types.js'
 export { I18nContext, composePrefix, useI18n, useI18nLib, useI18nApp, useLanguage } from './context.js'
-export {
-  prepareI18n, resolveInitialLanguage, setLanguage, setLanguagePersistence, persistLanguage, getExplicitLanguage,
-} from './utils/instance.js'
+export { prepareI18n, resolveInitialLanguage, setLanguage } from './utils/instance.js'

package/src/utils/instance.ts

@@ -16,61 +16,6 @@ let preparedLng: string | undefined
 /** The language of the latest `setLanguage` call — an earlier call that finishes later yields to it. */
 let requestedLng: string | undefined
 
-/**
- * Whether an explicit language choice may be written to storage right now. Unset, storage is always
- * allowed — an application with no notion of consent behaves exactly as before. A host that asks its
- * visitors (`@owlmeans/web-panel/consent`'s `installConsentLanguage`) installs one that answers
- * "has the visitor allowed functional storage?", so a language is not remembered on a device nobody
- * asked about.
- */
-let persistenceGuard: (() => boolean) | null = null
-
-/** The latest explicit choice that storage refused; written the moment storage is allowed. */
-let refusedChoice: string | null = null
-
-/** The latest language a person chose explicitly in this page's life, stored or not. */
-let explicitChoice: string | null = null
-
-/**
- * The language a person chose explicitly since this page loaded (`setLanguage`), or `null`. What a
- * host asks before it applies a language that arrived some other way — a link — which must never
- * override what the person just picked.
- */
-export const getExplicitLanguage = (): string | null => explicitChoice
-
-const persistenceAllowed = (): boolean => persistenceGuard == null || persistenceGuard()
-
-/**
- * Install (or, with `null`, remove) the guard that decides whether a language choice may be
- * remembered. Call it BEFORE `prepareI18n`: the initial language is resolved from storage, and a
- * guard that says no makes a stored value count as absent.
- */
-export const setLanguagePersistence = (guard: (() => boolean) | null): void => {
-  persistenceGuard = guard
-  // A new guard starts a new account of what this page's visitor has chosen and what storage refused.
-  refusedChoice = null
-  explicitChoice = null
-}
-
-/**
- * Write the explicit choice storage refused earlier, now that it may be — call it when the guard's
- * answer turns to yes (the visitor granted functional storage). `false` when there was nothing
- * waiting, storage is still refused, or the write failed.
- */
-export const persistLanguage = (): boolean => {
-  if (refusedChoice == null || !persistenceAllowed()) {
-    return false
-  }
-  try {
-    localStorage.setItem(LNG_STORAGE_KEY, refusedChoice)
-    refusedChoice = null
-
-    return true
-  } catch (_) {
-    return false
-  }
-}
-
 export const useI18nInstance = (config: ClientConfig): i18n => {
   const instance = useMemo(() => createI18nInstance(config), [])
 
@@ -84,6 +29,10 @@ export 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`.
  */
 export const setLanguage = (lng: string): Promise<void> => switchLanguage(lng, true)
 
@@ -98,16 +47,9 @@ const switchLanguage = async (lng: string, persist: boolean): Promise<void> => {
     return
   }
   if (persist) {
-    explicitChoice = lng
-    if (persistenceAllowed()) {
-      refusedChoice = null
-      try {
-        localStorage.setItem(LNG_STORAGE_KEY, lng)
-      } catch (_) { /* noop in non-browser environments */ }
-    } else {
-      // Not remembered — but not forgotten either: the visitor may allow it a moment later.
-      refusedChoice = lng
-    }
+    try {
+      localStorage.setItem(LNG_STORAGE_KEY, lng)
+    } catch (_) { /* noop in non-browser environments */ }
   }
   if (i18nInstance == null) {
     preparedLng = lng
@@ -159,9 +101,6 @@ const resolveFallbackLanguage = (config: ClientConfig): string =>
   config.i18n?.fallbackLng ?? config.i18n?.defaultLng ?? DEFAULT_LNG
 
 const getPersistedLanguage = (): string | null => {
-  if (!persistenceAllowed()) {
-    return null
-  }
   try {
     return localStorage.getItem(LNG_STORAGE_KEY)
   } catch (_) {

package/tests/instance.spec.ts

@@ -1,8 +1,6 @@
 import { describe, expect, test } from 'bun:test'
-import { afterEach, beforeEach } from 'bun:test'
-import {
-  persistLanguage, preferredLanguageOf, resolveInitialLanguage, setLanguage, setLanguagePersistence,
-} from '../src/utils/instance.js'
+import { beforeEach } from 'bun:test'
+import { preferredLanguageOf, resolveInitialLanguage, setLanguage } from '../src/utils/instance.js'
 
 const SUPPORTED = ['en', 'pl', 'ru', 'be', 'uk', 'es', 'de', 'fr']
 
@@ -29,70 +27,49 @@ describe('preferredLanguageOf — the first-visit language', () => {
   })
 })
 
-describe('language persistence guard — a choice is remembered only while storage is allowed', () => {
+describe('the interface language is strictly necessary — always stored, always read', () => {
   const store = new Map<string, string>()
   const config = { i18n: { supportedLngs: SUPPORTED, fallbackLng: 'en' } } as never
-  let allowed = false
 
   beforeEach(() => {
     store.clear()
-    allowed = false
     ;(globalThis as any).localStorage = {
       getItem: (k: string) => store.get(k) ?? null,
       setItem: (k: string, v: string) => { store.set(k, v) },
       removeItem: (k: string) => { store.delete(k) },
     }
-    setLanguagePersistence(() => allowed)
   })
-  afterEach(() => { setLanguagePersistence(null) })
 
-  test('with the guard saying no, an explicit choice is not written', async () => {
+  test('an explicit choice is written at once, whatever cookie decision the visitor made', async () => {
     await setLanguage('pl')
 
-    expect(store.has('owlmeans-lng')).toBe(false)
-  })
-
-  test('the refused choice is written the moment storage is allowed', async () => {
-    await setLanguage('pl')
-    expect(persistLanguage()).toBe(false)
-
-    allowed = true
-
-    expect(persistLanguage()).toBe(true)
     expect(store.get('owlmeans-lng')).toBe('pl')
-    expect(persistLanguage()).toBe(false)
   })
 
-  test('the latest refused choice is the one that is written', async () => {
+  test('the latest choice is the one that is stored', async () => {
     await setLanguage('pl')
     await setLanguage('de')
-    allowed = true
-    persistLanguage()
 
     expect(store.get('owlmeans-lng')).toBe('de')
   })
 
-  test('with the guard saying yes, a choice is written at once, as before', async () => {
-    allowed = true
-    await setLanguage('fr')
+  test('a stored language is what the next visit starts in', async () => {
+    await setLanguage('es')
 
-    expect(store.get('owlmeans-lng')).toBe('fr')
+    expect(resolveInitialLanguage(config)).toBe('es')
   })
 
-  test('a stored language counts as absent while the guard says no, and is used once it says yes', () => {
-    store.set('owlmeans-lng', 'de')
-
-    expect(resolveInitialLanguage(config)).not.toBe('de')
+  test('a stored language the application no longer supports is ignored', () => {
+    store.set('owlmeans-lng', 'ja')
 
-    allowed = true
-    expect(resolveInitialLanguage(config)).toBe('de')
+    expect(resolveInitialLanguage(config)).not.toBe('ja')
   })
 
-  test('with no guard installed nothing changes: choices are written and read', async () => {
-    setLanguagePersistence(null)
-    await setLanguage('es')
+  test('storage that refuses the write is not an error', async () => {
+    ;(globalThis as any).localStorage.setItem = () => { throw new Error('blocked') }
 
-    expect(store.get('owlmeans-lng')).toBe('es')
-    expect(resolveInitialLanguage(config)).toBe('es')
+    await setLanguage('fr')
+
+    expect(store.has('owlmeans-lng')).toBe(false)
   })
 })

package/tests/instance.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=instance.spec.d.ts.map

package/tests/instance.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"instance.spec.d.ts","sourceRoot":"","sources":["instance.spec.ts"],"names":[],"mappings":""}

package/tests/instance.spec.js

@@ -1,23 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-import { preferredLanguageOf } from '../src/utils/instance.js';
-const SUPPORTED = ['en', 'pl', 'ru', 'be', 'uk', 'es', 'de', 'fr'];
-describe('preferredLanguageOf — the first-visit language', () => {
-    test('a regional tag resolves to its supported base language', () => {
-        expect(preferredLanguageOf(SUPPORTED, ['de-DE'])).toBe('de');
-        expect(preferredLanguageOf(SUPPORTED, ['fr-FR', 'en'])).toBe('fr');
-        expect(preferredLanguageOf(SUPPORTED, ['pl_PL'])).toBe('pl');
-    });
-    test('the browser order decides, and an unsupported language is skipped', () => {
-        expect(preferredLanguageOf(SUPPORTED, ['it-IT', 'de-CH', 'en-US'])).toBe('de');
-        expect(preferredLanguageOf(SUPPORTED, ['EN-us'])).toBe('en');
-    });
-    test('an exact supported tag wins over its base', () => {
-        expect(preferredLanguageOf(['pt', 'pt-BR'], ['pt-BR'])).toBe('pt-BR');
-    });
-    test('nothing supported, or nothing known — null (the caller falls back)', () => {
-        expect(preferredLanguageOf(SUPPORTED, ['it-IT', 'ja'])).toBeNull();
-        expect(preferredLanguageOf(SUPPORTED, [])).toBeNull();
-        expect(preferredLanguageOf(SUPPORTED, [null, undefined, ''])).toBeNull();
-    });
-});
-//# sourceMappingURL=instance.spec.js.map

package/tests/instance.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"instance.spec.js","sourceRoot":"","sources":["instance.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAElE,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC9D,IAAI,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5D,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9E,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC9E,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;QAClE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;QACrD,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC1E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}