@owlmeans/web-panel 0.1.18-rc.61 → 0.1.18-rc.62

package/README.md

@@ -11,7 +11,7 @@ but never started.
 ## Installation
 
 ```sh
-bun add @owlmeans/web-panel@^0.1.18-rc.61
+bun add @owlmeans/web-panel@^0.1.18-rc.62
 ```
 
 Peer requirements (the consuming app provides these): `react`, `react-dom`,

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/web-panel",
-  "version": "0.1.18-rc.61",
-  "generatedAt": "2026-09-24T14:00:35.085Z",
+  "version": "0.1.18-rc.62",
+  "generatedAt": "2026-09-25T15:32:39.588Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/web-panel/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/web-panel
 
 **Layer:** Web (React)
-**Install:** `"@owlmeans/web-panel": "^0.1.18-rc.61"` in `dependencies`
+**Install:** `"@owlmeans/web-panel": "^0.1.18-rc.62"` in `dependencies`
 
 ## Key Exports
 
@@ -499,6 +499,7 @@ menu has already mounted) and because React 18 StrictMode double-invokes mount/c
 | Job | Import from `@owlmeans/web-panel/consent` | Where it goes |
 |---|---|---|
 | The consent dialog (and its floating re-open button) | `PanelCookieConsent` | Beside the router — a `PanelApp` child — once |
+| Remember the language only while the visitor granted `functional` cookies | `installConsentLanguage()` | Once, in the bootstrap, BEFORE `prepareI18n` — wires `client-i18n`'s persistence guard, and applies a language that arrived with a link from another OwlMeans domain once the grant is saved |
 | The "Cookie settings" control in a footer or menu | `PanelConsentMenuWidget` (`label`, `className`, `onSelect?` — defaults to `openConsent('reopen')`) | Inside the host's own footer/menu |
 | Hiding the floating button while that control is reachable | `useConsentMenuPresence()` | Called by the always-mounted component that renders the control |
 | Registering the presence service | `appendConsentWidgetService(context)` | The app's `context.ts` |

package/build/consent/index.d.ts

@@ -1,9 +1,10 @@
 export * from './component.js';
 export * from './menu-widget.js';
 export * from './presence.js';
+export { installConsentLanguage } from './language.js';
 export { createConsentWidgetService, appendConsentWidgetService, CONSENT_WIDGET_STATE } from './service.js';
 export { CONSENT_WIDGET_SERVICE } from './consts.js';
 export type { ConsentWidgetPresenceRecord, ConsentWidgetService, ConsentWidgetServiceAppend } from './types.js';
-export { useConsent, useConsentCategory, consentStore, openConsent, isConsented, readConsent, writeConsent, clearConsent, DEFAULT_CONSENT_CATEGORIES, CONSENT_KEY, CONSENT_ESSENTIAL, CONSENT_ANALYTICS, CONSENT_MARKETING, consentBootstrapScript, } from '@owlmeans/web-consent';
+export { useConsent, useConsentCategory, consentStore, openConsent, isConsented, readConsent, writeConsent, clearConsent, DEFAULT_CONSENT_CATEGORIES, CONSENT_KEY, CONSENT_ESSENTIAL, CONSENT_FUNCTIONAL, CONSENT_ANALYTICS, CONSENT_MARKETING, CONSENT_EVENT, CONSENT_LANGUAGE_EVENT, functionalGranted, consentBootstrapScript, } from '@owlmeans/web-consent';
 export type { ConsentCategory, ConsentMenuWidgetProps, ConsentOptions, ConsentRecord, ConsentSignal, ConsentState, CookieConsentProps, CookiePolicyProps, } from '@owlmeans/web-consent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consent/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC3G,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,YAAY,EACV,2BAA2B,EAAE,oBAAoB,EAAE,0BAA0B,EAC9E,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EACtE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,0BAA0B,EACnE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EACpE,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,eAAe,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EACrF,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,GACpD,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consent/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC3G,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,YAAY,EACV,2BAA2B,EAAE,oBAAoB,EAAE,0BAA0B,EAC9E,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EACtE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,0BAA0B,EACnE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EACxF,aAAa,EAAE,sBAAsB,EAAE,iBAAiB,EACxD,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,eAAe,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EACrF,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,GACpD,MAAM,uBAAuB,CAAA"}

package/build/consent/index.js

@@ -1,7 +1,8 @@
 export * from './component.js';
 export * from './menu-widget.js';
 export * from './presence.js';
+export { installConsentLanguage } from './language.js';
 export { createConsentWidgetService, appendConsentWidgetService, CONSENT_WIDGET_STATE } from './service.js';
 export { CONSENT_WIDGET_SERVICE } from './consts.js';
-export { useConsent, useConsentCategory, consentStore, openConsent, isConsented, readConsent, writeConsent, clearConsent, DEFAULT_CONSENT_CATEGORIES, CONSENT_KEY, CONSENT_ESSENTIAL, CONSENT_ANALYTICS, CONSENT_MARKETING, consentBootstrapScript, } from '@owlmeans/web-consent';
+export { useConsent, useConsentCategory, consentStore, openConsent, isConsented, readConsent, writeConsent, clearConsent, DEFAULT_CONSENT_CATEGORIES, CONSENT_KEY, CONSENT_ESSENTIAL, CONSENT_FUNCTIONAL, CONSENT_ANALYTICS, CONSENT_MARKETING, CONSENT_EVENT, CONSENT_LANGUAGE_EVENT, functionalGranted, consentBootstrapScript, } from '@owlmeans/web-consent';
 //# sourceMappingURL=index.js.map

package/build/consent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consent/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC3G,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAIpD,OAAO,EACL,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EACtE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,0BAA0B,EACnE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EACpE,sBAAsB,GACvB,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consent/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC3G,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAIpD,OAAO,EACL,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EACtE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,0BAA0B,EACnE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EACxF,aAAa,EAAE,sBAAsB,EAAE,iBAAiB,EACxD,sBAAsB,GACvB,MAAM,uBAAuB,CAAA"}

package/build/consent/language.d.ts

@@ -0,0 +1,22 @@
+import type { ConsentOptions } from '@owlmeans/web-consent';
+/**
+ * Bind the application's language to the visitor's cookie choice: a language is remembered on their
+ * device only while they have granted `functional` storage.
+ *
+ * It does three things, and the order they take effect in is the point:
+ *
+ * 1. Installs the persistence guard in `@owlmeans/client-i18n` — so the language switcher (which
+ *    calls `setLanguage`) stops writing `owlmeans-lng` until functional is granted, and a stored
+ *    language counts as absent while it is not. **Call it BEFORE `prepareI18n`**: the initial
+ *    language is resolved from storage right there.
+ * 2. On every consent change (`CONSENT_EVENT`) writes the choice the visitor made while storage was
+ *    refused, if it is allowed now — a person who picked a language, then answered the dialog with
+ *    "accept all", keeps it.
+ * 3. On `CONSENT_LANGUAGE_EVENT` — a language that arrived with a link and was waiting for the grant —
+ *    switches to it now, unless the person has already picked one in this page's life: what they
+ *    chose outranks what a link carried, and that choice is re-written over the store's own write.
+ *
+ * Returns a function that undoes all three. Safe on the server (only the guard is installed).
+ */
+export declare const installConsentLanguage: (opts?: ConsentOptions) => (() => void);
+//# sourceMappingURL=language.d.ts.map

package/build/consent/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/consent/language.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sBAAsB,UAAW,cAAc,KAAG,CAAC,MAAM,IAAI,CA6BzE,CAAA"}

package/build/consent/language.js

@@ -0,0 +1,49 @@
+import { getExplicitLanguage, persistLanguage, setLanguage, setLanguagePersistence } from '@owlmeans/client-i18n';
+import { CONSENT_EVENT, CONSENT_LANGUAGE_EVENT, functionalGranted } from '@owlmeans/web-consent';
+/**
+ * Bind the application's language to the visitor's cookie choice: a language is remembered on their
+ * device only while they have granted `functional` storage.
+ *
+ * It does three things, and the order they take effect in is the point:
+ *
+ * 1. Installs the persistence guard in `@owlmeans/client-i18n` — so the language switcher (which
+ *    calls `setLanguage`) stops writing `owlmeans-lng` until functional is granted, and a stored
+ *    language counts as absent while it is not. **Call it BEFORE `prepareI18n`**: the initial
+ *    language is resolved from storage right there.
+ * 2. On every consent change (`CONSENT_EVENT`) writes the choice the visitor made while storage was
+ *    refused, if it is allowed now — a person who picked a language, then answered the dialog with
+ *    "accept all", keeps it.
+ * 3. On `CONSENT_LANGUAGE_EVENT` — a language that arrived with a link and was waiting for the grant —
+ *    switches to it now, unless the person has already picked one in this page's life: what they
+ *    chose outranks what a link carried, and that choice is re-written over the store's own write.
+ *
+ * Returns a function that undoes all three. Safe on the server (only the guard is installed).
+ */
+export const installConsentLanguage = (opts) => {
+    setLanguagePersistence(() => functionalGranted(opts));
+    if (typeof window === 'undefined') {
+        return () => setLanguagePersistence(null);
+    }
+    const onConsent = () => {
+        persistLanguage();
+    };
+    const onLanguage = (event) => {
+        const carried = event.detail?.language;
+        const chosen = getExplicitLanguage();
+        const language = chosen ?? carried;
+        if (typeof language !== 'string' || language === '') {
+            return;
+        }
+        setLanguage(language).catch((error) => {
+            console.error('[i18n] could not apply the language that was waiting for consent', error);
+        });
+    };
+    window.addEventListener(CONSENT_EVENT, onConsent);
+    window.addEventListener(CONSENT_LANGUAGE_EVENT, onLanguage);
+    return () => {
+        window.removeEventListener(CONSENT_EVENT, onConsent);
+        window.removeEventListener(CONSENT_LANGUAGE_EVENT, onLanguage);
+        setLanguagePersistence(null);
+    };
+};
+//# sourceMappingURL=language.js.map

package/build/consent/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../src/consent/language.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACjH,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGhG;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAqB,EAAgB,EAAE;IAC5E,sBAAsB,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAA;IAErD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,eAAe,EAAE,CAAA;IACnB,CAAC,CAAA;IACD,MAAM,UAAU,GAAG,CAAC,KAAY,EAAQ,EAAE;QACxC,MAAM,OAAO,GAAI,KAA4C,CAAC,MAAM,EAAE,QAAQ,CAAA;QAC9E,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAA;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAA;QAClC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;YACpD,OAAM;QACR,CAAC;QACD,WAAW,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC7C,OAAO,CAAC,KAAK,CAAC,kEAAkE,EAAE,KAAK,CAAC,CAAA;QAC1F,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IACD,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;IACjD,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAA;IAE3D,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,mBAAmB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;QACpD,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAA;QAC9D,sBAAsB,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/web-panel",
-  "version": "0.1.18-rc.61",
+  "version": "0.1.18-rc.62",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -55,16 +55,16 @@
     "@owlmeans/auth": "^0.1.18-rc.36",
     "@owlmeans/auth-common": "^0.1.18-rc.38",
     "@owlmeans/basic-envelope": "^0.1.18-rc.37",
-    "@owlmeans/client": "^0.1.18-rc.41",
-    "@owlmeans/client-auth": "^0.1.18-rc.48",
+    "@owlmeans/client": "^0.1.18-rc.42",
+    "@owlmeans/client-auth": "^0.1.18-rc.49",
     "@owlmeans/client-config": "^0.1.18-rc.38",
     "@owlmeans/client-context": "^0.1.18-rc.39",
     "@owlmeans/client-entrypoint": "^0.1.18-rc.38",
-    "@owlmeans/client-flow": "^0.1.18-rc.44",
-    "@owlmeans/client-i18n": "^0.1.18-rc.40",
-    "@owlmeans/client-panel": "^0.1.18-rc.48",
+    "@owlmeans/client-flow": "^0.1.18-rc.45",
+    "@owlmeans/client-i18n": "^0.1.18-rc.41",
+    "@owlmeans/client-panel": "^0.1.18-rc.49",
     "@owlmeans/client-route": "^0.1.18-rc.39",
-    "@owlmeans/client-socket": "^0.1.18-rc.39",
+    "@owlmeans/client-socket": "^0.1.18-rc.40",
     "@owlmeans/config": "^0.1.18-rc.38",
     "@owlmeans/context": "^0.1.18-rc.32",
     "@owlmeans/entrypoint": "^0.1.18-rc.37",
@@ -73,11 +73,11 @@
     "@owlmeans/i18n": "^0.1.18-rc.37",
     "@owlmeans/route": "^0.1.18-rc.33",
     "@owlmeans/state": "^0.1.18-rc.35",
-    "@owlmeans/web-client": "^0.1.18-rc.51",
-    "@owlmeans/web-consent": "^0.1.18-rc.32",
+    "@owlmeans/web-client": "^0.1.18-rc.52",
+    "@owlmeans/web-consent": "^0.1.18-rc.33",
     "@owlmeans/web-db": "^0.1.18-rc.39",
-    "@owlmeans/web-flow": "^0.1.18-rc.43",
-    "@owlmeans/web-router": "^0.1.18-rc.39",
+    "@owlmeans/web-flow": "^0.1.18-rc.44",
+    "@owlmeans/web-router": "^0.1.18-rc.40",
     "i18next-browser-languagedetector": "^8.0.0",
     "qrcode.react": "^4.2.0",
     "react-google-recaptcha": "^3.1.0",
@@ -103,7 +103,7 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-ui": "^0.1.18-rc.39",
+    "@owlmeans/test-ui": "^0.1.18-rc.40",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-label": "^2.1.0",

package/src/consent/index.ts

@@ -1,6 +1,7 @@
 export * from './component.js'
 export * from './menu-widget.js'
 export * from './presence.js'
+export { installConsentLanguage } from './language.js'
 export { createConsentWidgetService, appendConsentWidgetService, CONSENT_WIDGET_STATE } from './service.js'
 export { CONSENT_WIDGET_SERVICE } from './consts.js'
 export type {
@@ -9,7 +10,8 @@ export type {
 export {
   useConsent, useConsentCategory, consentStore, openConsent, isConsented,
   readConsent, writeConsent, clearConsent, DEFAULT_CONSENT_CATEGORIES,
-  CONSENT_KEY, CONSENT_ESSENTIAL, CONSENT_ANALYTICS, CONSENT_MARKETING,
+  CONSENT_KEY, CONSENT_ESSENTIAL, CONSENT_FUNCTIONAL, CONSENT_ANALYTICS, CONSENT_MARKETING,
+  CONSENT_EVENT, CONSENT_LANGUAGE_EVENT, functionalGranted,
   consentBootstrapScript,
 } from '@owlmeans/web-consent'
 export type {

package/src/consent/language.ts

@@ -0,0 +1,53 @@
+import { getExplicitLanguage, persistLanguage, setLanguage, setLanguagePersistence } from '@owlmeans/client-i18n'
+import { CONSENT_EVENT, CONSENT_LANGUAGE_EVENT, functionalGranted } from '@owlmeans/web-consent'
+import type { ConsentOptions } from '@owlmeans/web-consent'
+
+/**
+ * Bind the application's language to the visitor's cookie choice: a language is remembered on their
+ * device only while they have granted `functional` storage.
+ *
+ * It does three things, and the order they take effect in is the point:
+ *
+ * 1. Installs the persistence guard in `@owlmeans/client-i18n` — so the language switcher (which
+ *    calls `setLanguage`) stops writing `owlmeans-lng` until functional is granted, and a stored
+ *    language counts as absent while it is not. **Call it BEFORE `prepareI18n`**: the initial
+ *    language is resolved from storage right there.
+ * 2. On every consent change (`CONSENT_EVENT`) writes the choice the visitor made while storage was
+ *    refused, if it is allowed now — a person who picked a language, then answered the dialog with
+ *    "accept all", keeps it.
+ * 3. On `CONSENT_LANGUAGE_EVENT` — a language that arrived with a link and was waiting for the grant —
+ *    switches to it now, unless the person has already picked one in this page's life: what they
+ *    chose outranks what a link carried, and that choice is re-written over the store's own write.
+ *
+ * Returns a function that undoes all three. Safe on the server (only the guard is installed).
+ */
+export const installConsentLanguage = (opts?: ConsentOptions): (() => void) => {
+  setLanguagePersistence(() => functionalGranted(opts))
+
+  if (typeof window === 'undefined') {
+    return () => setLanguagePersistence(null)
+  }
+
+  const onConsent = (): void => {
+    persistLanguage()
+  }
+  const onLanguage = (event: Event): void => {
+    const carried = (event as CustomEvent<{ language?: string }>).detail?.language
+    const chosen = getExplicitLanguage()
+    const language = chosen ?? carried
+    if (typeof language !== 'string' || language === '') {
+      return
+    }
+    setLanguage(language).catch((error: unknown) => {
+      console.error('[i18n] could not apply the language that was waiting for consent', error)
+    })
+  }
+  window.addEventListener(CONSENT_EVENT, onConsent)
+  window.addEventListener(CONSENT_LANGUAGE_EVENT, onLanguage)
+
+  return () => {
+    window.removeEventListener(CONSENT_EVENT, onConsent)
+    window.removeEventListener(CONSENT_LANGUAGE_EVENT, onLanguage)
+    setLanguagePersistence(null)
+  }
+}

package/tests/consent-language.spec.ts

@@ -0,0 +1,82 @@
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
+import { persistLanguage, setLanguage, setLanguagePersistence } from '@owlmeans/client-i18n'
+import { CONSENT_EVENT, CONSENT_KEY, CONSENT_LANGUAGE_EVENT } from '@owlmeans/web-consent'
+import { installConsentLanguage } from '../src/consent/language.js'
+
+/** A window that is just an event bus, and a localStorage that is a map: enough for the binding. */
+const env = () => {
+  const store = new Map<string, string>()
+  const listeners = new Map<string, Set<(e: any) => void>>()
+  ;(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) },
+  }
+  ;(globalThis as any).window = {
+    addEventListener: (t: string, f: any) => { (listeners.get(t) ?? listeners.set(t, new Set()).get(t)!).add(f) },
+    removeEventListener: (t: string, f: any) => { listeners.get(t)?.delete(f) },
+    dispatchEvent: (e: any) => { listeners.get(e.type)?.forEach(f => f(e)) },
+  }
+  ;(globalThis as any).CustomEvent = class { constructor(public type: string, public init: any) {} get detail() { return this.init?.detail } }
+
+  return { store, listeners, emit: (type: string, detail?: unknown) => (globalThis as any).window.dispatchEvent(new (globalThis as any).CustomEvent(type, { detail })) }
+}
+
+describe('installConsentLanguage', () => {
+  let e: ReturnType<typeof env>
+  let off: () => void
+  const record = (functional: boolean) => e.store.set(CONSENT_KEY, JSON.stringify({ v: 2, essential: true, functional, analytics: false, marketing: false }))
+
+  beforeEach(() => { e = env(); off = installConsentLanguage() })
+  afterEach(() => { off(); setLanguagePersistence(null); delete (globalThis as any).window })
+
+  test('the switcher\'s choice is not remembered without a functional grant', async () => {
+    await setLanguage('pl')
+
+    expect(e.store.has('owlmeans-lng')).toBe(false)
+  })
+
+  test('…and is written when the visitor grants functional, on the consent event', async () => {
+    await setLanguage('pl')
+    record(true)
+    e.emit(CONSENT_EVENT, { record: {} })
+
+    expect(e.store.get('owlmeans-lng')).toBe('pl')
+  })
+
+  test('a refusal writes nothing on the consent event', async () => {
+    await setLanguage('pl')
+    record(false)
+    e.emit(CONSENT_EVENT, { record: {} })
+
+    expect(e.store.has('owlmeans-lng')).toBe(false)
+  })
+
+  test('a language that was waiting for the grant is applied and stored when it arrives', async () => {
+    record(true)
+    e.emit(CONSENT_LANGUAGE_EVENT, { language: 'de' })
+    await new Promise(resolve => setTimeout(resolve, 0))
+
+    expect(e.store.get('owlmeans-lng')).toBe('de')
+  })
+
+  test('what the person picked in this page life outranks the language the link carried', async () => {
+    await setLanguage('fr')
+    record(true)
+    e.emit(CONSENT_EVENT, { record: {} })
+    e.emit(CONSENT_LANGUAGE_EVENT, { language: 'de' })
+    await new Promise(resolve => setTimeout(resolve, 0))
+
+    expect(e.store.get('owlmeans-lng')).toBe('fr')
+  })
+
+  test('the returned function removes the listeners and the guard', async () => {
+    off()
+    expect(e.listeners.get(CONSENT_EVENT)?.size ?? 0).toBe(0)
+    expect(e.listeners.get(CONSENT_LANGUAGE_EVENT)?.size ?? 0).toBe(0)
+
+    await setLanguage('es')
+    expect(e.store.get('owlmeans-lng')).toBe('es')
+    expect(persistLanguage()).toBe(false)
+  })
+})