@owlmeans/consent 0.1.18-rc.7 → 0.1.18-rc.8

package/build/consts.d.ts

@@ -28,16 +28,39 @@ export declare const CONSENT_SETUP_FLAG = "cookieConsentSetup";
  */
 export declare const CONSENT_EVENT = "owlmeans:consent";
 export declare const CONSENT_ESSENTIAL = "essential";
+export declare const CONSENT_FUNCTIONAL = "functional";
 export declare const CONSENT_ANALYTICS = "analytics";
 export declare const CONSENT_MARKETING = "marketing";
+/**
+ * The DOM event the store dispatches on `window` when a language that arrived with a link (or an
+ * explicit choice made before the visitor answered the dialog) has just become storable — the
+ * visitor granted functional storage — so the application can switch to it now instead of at the
+ * next load. `detail: { language }`. An application that resolves its language from storage at
+ * start-up (`@owlmeans/client-i18n`) listens for it.
+ */
+export declare const CONSENT_LANGUAGE_EVENT = "owlmeans:language";
+/**
+ * The `window` property the inline `<head>` fragment leaves a carried language on when it may not
+ * store it yet (no decision, or functional not granted): memory only, never storage. The store
+ * picks it up at `init` and writes it if — and only if — the visitor later grants functional storage
+ * in this page's life. Fixed for the same reason `CONSENT_SETUP_FLAG` is: two bundles, one page.
+ */
+export declare const CONSENT_PENDING_LANGUAGE = "cookieConsentPendingLanguage";
+/**
+ * Where an application persists an explicit interface-language choice — `@owlmeans/client-i18n`'s
+ * `owlmeans-lng`. Repeated here rather than imported: this package has no runtime dependencies, and
+ * the linker's language part has to run in an inline `<head>` script, before any bundle exists.
+ */
+export declare const CONSENT_LANGUAGE_KEY = "owlmeans-lng";
 export declare const CONSENT_LOCALES: readonly ['en', 'pl', 'ru', 'be', 'uk', 'es', 'de', 'fr'];
 export type ConsentLocale = (typeof CONSENT_LOCALES)[number];
 /**
  * The categories every OwlMeans surface starts with.
  *
- * Three, matching what owlmeans.com already asks — plus the essential row, which the original
- * widget left implicit. Making it explicit is what lets a flow require an acknowledgement before
- * it sets a session cookie, and what tells a visitor what is being stored regardless.
+ * What owlmeans.com already asked (analytics, marketing) plus the essential row, which the original
+ * widget left implicit — making it explicit is what lets a flow require an acknowledgement before
+ * it sets a session cookie, and what tells a visitor what is being stored regardless — plus
+ * functional, the visitor's own remembered preferences.
  */
 export declare const DEFAULT_CONSENT_CATEGORIES: ConsentCategory[];
 /**

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,wBAAwB,CAAA;AAEhD,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,qBAAqB,CAAA;AAE/C,eAAO,MAAM,iBAAiB,cAAc,CAAA;AAC5C,eAAO,MAAM,iBAAiB,cAAc,CAAA;AAC5C,eAAO,MAAM,iBAAiB,cAAc,CAAA;AAE5C,eAAO,MAAM,eAAe,YAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAExF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,eAAe,EAmBvD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAQxE,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,wBAAwB,CAAA;AAEhD,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,qBAAqB,CAAA;AAE/C,eAAO,MAAM,iBAAiB,cAAc,CAAA;AAC5C,eAAO,MAAM,kBAAkB,eAAe,CAAA;AAC9C,eAAO,MAAM,iBAAiB,cAAc,CAAA;AAC5C,eAAO,MAAM,iBAAiB,cAAc,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,sBAAsB,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,iCAAiC,CAAA;AAEtE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iBAAiB,CAAA;AAElD,eAAO,MAAM,eAAe,YAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAExF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,eAAe,EA4BvD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAQxE,CAAA"}

package/build/consts.js

@@ -27,15 +27,38 @@ export const CONSENT_SETUP_FLAG = 'cookieConsentSetup';
  */
 export const CONSENT_EVENT = 'owlmeans:consent';
 export const CONSENT_ESSENTIAL = 'essential';
+export const CONSENT_FUNCTIONAL = 'functional';
 export const CONSENT_ANALYTICS = 'analytics';
 export const CONSENT_MARKETING = 'marketing';
+/**
+ * The DOM event the store dispatches on `window` when a language that arrived with a link (or an
+ * explicit choice made before the visitor answered the dialog) has just become storable — the
+ * visitor granted functional storage — so the application can switch to it now instead of at the
+ * next load. `detail: { language }`. An application that resolves its language from storage at
+ * start-up (`@owlmeans/client-i18n`) listens for it.
+ */
+export const CONSENT_LANGUAGE_EVENT = 'owlmeans:language';
+/**
+ * The `window` property the inline `<head>` fragment leaves a carried language on when it may not
+ * store it yet (no decision, or functional not granted): memory only, never storage. The store
+ * picks it up at `init` and writes it if — and only if — the visitor later grants functional storage
+ * in this page's life. Fixed for the same reason `CONSENT_SETUP_FLAG` is: two bundles, one page.
+ */
+export const CONSENT_PENDING_LANGUAGE = 'cookieConsentPendingLanguage';
+/**
+ * Where an application persists an explicit interface-language choice — `@owlmeans/client-i18n`'s
+ * `owlmeans-lng`. Repeated here rather than imported: this package has no runtime dependencies, and
+ * the linker's language part has to run in an inline `<head>` script, before any bundle exists.
+ */
+export const CONSENT_LANGUAGE_KEY = 'owlmeans-lng';
 export const CONSENT_LOCALES = ['en', 'pl', 'ru', 'be', 'uk', 'es', 'de', 'fr'];
 /**
  * The categories every OwlMeans surface starts with.
  *
- * Three, matching what owlmeans.com already asks — plus the essential row, which the original
- * widget left implicit. Making it explicit is what lets a flow require an acknowledgement before
- * it sets a session cookie, and what tells a visitor what is being stored regardless.
+ * What owlmeans.com already asked (analytics, marketing) plus the essential row, which the original
+ * widget left implicit — making it explicit is what lets a flow require an acknowledgement before
+ * it sets a session cookie, and what tells a visitor what is being stored regardless — plus
+ * functional, the visitor's own remembered preferences.
  */
 export const DEFAULT_CONSENT_CATEGORIES = [
     {
@@ -44,6 +67,15 @@ export const DEFAULT_CONSENT_CATEGORIES = [
         globalVar: 'owlConsentEssential',
         signals: ['security_storage', 'functionality_storage'],
     },
+    // A preference the visitor set — today the interface language — remembered on their device. Not
+    // essential (nothing breaks without it) and not tracking, so it drives NO Consent Mode signal:
+    // a signal would make `trackingGranted` count it, and a visitor who only allowed their language
+    // to be remembered would load the tag container.
+    {
+        key: CONSENT_FUNCTIONAL,
+        labelKey: 'functional', descriptionKey: 'functionalDesc',
+        globalVar: 'owlConsentFunctional',
+    },
     {
         key: CONSENT_ANALYTICS,
         labelKey: 'analytics', descriptionKey: 'analyticsDesc',

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,qBAAqB,CAAA;AAEhD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAEvC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAA;AAEtD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAA;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAIxF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D;QACE,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI;QACtC,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe;QACtD,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;KACvD;IACD;QACE,GAAG,EAAE,iBAAiB;QACtB,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe;QACtD,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,mBAAmB,CAAC;KAC/B;IACD;QACE,GAAG,EAAE,iBAAiB;QACtB,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe;QACtD,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,oBAAoB,CAAC;KAC9D;CACF,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAyC;IAC3E,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE,QAAQ;IACtB,kBAAkB,EAAE,QAAQ;IAC5B,iBAAiB,EAAE,QAAQ;IAC3B,qBAAqB,EAAE,QAAQ;IAC/B,uBAAuB,EAAE,QAAQ;IACjC,gBAAgB,EAAE,SAAS;CAC5B,CAAA"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,qBAAqB,CAAA;AAEhD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAEvC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAA;AAEtD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAA;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAA;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAA;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAIxF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D;QACE,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI;QACtC,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe;QACtD,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;KACvD;IACD,gGAAgG;IAChG,+FAA+F;IAC/F,gGAAgG;IAChG,iDAAiD;IACjD;QACE,GAAG,EAAE,kBAAkB;QACvB,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB;QACxD,SAAS,EAAE,sBAAsB;KAClC;IACD;QACE,GAAG,EAAE,iBAAiB;QACtB,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe;QACtD,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,mBAAmB,CAAC;KAC/B;IACD;QACE,GAAG,EAAE,iBAAiB;QACtB,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe;QACtD,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,oBAAoB,CAAC;KAC9D;CACF,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAyC;IAC3E,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE,QAAQ;IACtB,kBAAkB,EAAE,QAAQ;IAC5B,iBAAiB,EAAE,QAAQ;IAC3B,qBAAqB,EAAE,QAAQ;IAC/B,uBAAuB,EAAE,QAAQ;IACjC,gBAAgB,EAAE,SAAS;CAC5B,CAAA"}

package/build/functional.d.ts

@@ -0,0 +1,35 @@
+import type { ConsentOptions } from './types.js';
+/**
+ * Whether this document's visitor has granted functional storage — a preference they set, such as
+ * the interface language, may be remembered on their device.
+ *
+ * Read from the stored record every time rather than from the store's state, so it is correct
+ * before `consentStore.init` has run: the language resolves at start-up, ahead of any component.
+ * A record with no `functional` key (one saved before the category existed) is NOT a grant — the
+ * visitor was never asked, and a preference is not remembered on a device nobody asked about.
+ */
+export declare const functionalGranted: (opts?: ConsentOptions) => boolean;
+/** Every `localStorage` key that may hold a functional preference for these options. */
+export declare const functionalKeysOf: (opts?: ConsentOptions) => string[];
+/**
+ * Remove every functional preference this application keeps. Called whenever functional is not
+ * granted — a refusal, a withdrawal, or a record that never answered — because a preference that
+ * outlives the consent to remember it is exactly the storage the visitor did not agree to.
+ */
+export declare const purgeFunctionalStorage: (opts?: ConsentOptions) => void;
+/**
+ * Remember a functional preference — but only while `functional` is granted. Returns whether it was
+ * written. The gate lives here so a caller cannot forget it; an application that is asked to store
+ * something functional calls this instead of `localStorage.setItem`.
+ */
+export declare const writeFunctionalPreference: (key: string, value: string, opts?: ConsentOptions) => boolean;
+/**
+ * An inline `<head>` fragment that defines `window.owlConsentAllows(category)` — whether the stored
+ * decision grants that category — for the scripts of a page that has no bundle yet: a site that
+ * remembers the visitor's language choice from a plain inline script (owlmeans.com's language
+ * switcher) asks it before it writes anything. Reads the same localStorage-then-cookie pair
+ * `readConsent` does, and answers `false` for anything it cannot read or parse — no answer is not a
+ * grant. Stamp it before the scripts that call it.
+ */
+export declare const consentAllowsScript: (opts?: ConsentOptions) => string;
+//# sourceMappingURL=functional.d.ts.map

package/build/functional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functional.d.ts","sourceRoot":"","sources":["../src/functional.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,UAAW,cAAc,KAAG,OACR,CAAA;AAElD,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,UAAW,cAAc,KAAG,MAAM,EAK9D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,UAAW,cAAc,KAAG,IAM9D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAS,MAAM,SAAS,MAAM,SAAS,cAAc,KAAG,OAW7F,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,UAAW,cAAc,KAAG,MAS3D,CAAA"}

package/build/functional.js

@@ -0,0 +1,67 @@
+import { CONSENT_FUNCTIONAL, CONSENT_KEY, CONSENT_LANGUAGE_KEY } from './consts.js';
+import { readConsent } from './storage.js';
+/**
+ * Whether this document's visitor has granted functional storage — a preference they set, such as
+ * the interface language, may be remembered on their device.
+ *
+ * Read from the stored record every time rather than from the store's state, so it is correct
+ * before `consentStore.init` has run: the language resolves at start-up, ahead of any component.
+ * A record with no `functional` key (one saved before the category existed) is NOT a grant — the
+ * visitor was never asked, and a preference is not remembered on a device nobody asked about.
+ */
+export const functionalGranted = (opts) => readConsent(opts)?.[CONSENT_FUNCTIONAL] === true;
+/** Every `localStorage` key that may hold a functional preference for these options. */
+export const functionalKeysOf = (opts) => [
+    ...new Set([
+        ...(opts?.functionalKeys ?? [CONSENT_LANGUAGE_KEY]),
+        ...(opts?.linker?.language?.storageKey != null ? [opts.linker.language.storageKey] : []),
+    ]),
+];
+/**
+ * Remove every functional preference this application keeps. Called whenever functional is not
+ * granted — a refusal, a withdrawal, or a record that never answered — because a preference that
+ * outlives the consent to remember it is exactly the storage the visitor did not agree to.
+ */
+export const purgeFunctionalStorage = (opts) => {
+    for (const key of functionalKeysOf(opts)) {
+        try {
+            localStorage.removeItem(key);
+        }
+        catch { /* storage blocked: nothing was written there to remove */ }
+    }
+};
+/**
+ * Remember a functional preference — but only while `functional` is granted. Returns whether it was
+ * written. The gate lives here so a caller cannot forget it; an application that is asked to store
+ * something functional calls this instead of `localStorage.setItem`.
+ */
+export const writeFunctionalPreference = (key, value, opts) => {
+    if (!functionalGranted(opts)) {
+        return false;
+    }
+    try {
+        localStorage.setItem(key, value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * An inline `<head>` fragment that defines `window.owlConsentAllows(category)` — whether the stored
+ * decision grants that category — for the scripts of a page that has no bundle yet: a site that
+ * remembers the visitor's language choice from a plain inline script (owlmeans.com's language
+ * switcher) asks it before it writes anything. Reads the same localStorage-then-cookie pair
+ * `readConsent` does, and answers `false` for anything it cannot read or parse — no answer is not a
+ * grant. Stamp it before the scripts that call it.
+ */
+export const consentAllowsScript = (opts) => {
+    const key = JSON.stringify(opts?.storageKey ?? CONSENT_KEY).replace(/</g, '\\u003c');
+    return `(function(w,d){w.owlConsentAllows=function(k){` +
+        `var raw=null;try{raw=w.localStorage.getItem(${key})}catch(e){}` +
+        `if(!raw){var p=('; '+d.cookie).split('; '+${key}+'=');if(p.length===2)raw=p.pop().split(';').shift()}` +
+        `if(!raw)return false;` +
+        `try{var r=JSON.parse(raw);return !!r&&typeof r==='object'&&r[k]===true}catch(e){return false}}` +
+        `})(window,document)`;
+};
+//# sourceMappingURL=functional.js.map

package/build/functional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functional.js","sourceRoot":"","sources":["../src/functional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG1C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAqB,EAAW,EAAE,CAClE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAA;AAElD,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAqB,EAAY,EAAE,CAAC;IACnE,GAAG,IAAI,GAAG,CAAC;QACT,GAAG,CAAC,IAAI,EAAE,cAAc,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACnD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACzF,CAAC;CACH,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAqB,EAAQ,EAAE;IACpE,KAAK,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;QAAC,MAAM,CAAC,CAAC,0DAA0D,CAAC,CAAC;IACxE,CAAC;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,IAAqB,EAAW,EAAE;IACtG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAEhC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAqB,EAAU,EAAE;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,IAAI,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAEpF,OAAO,gDAAgD;QACrD,+CAA+C,GAAG,cAAc;QAChE,6CAA6C,GAAG,uDAAuD;QACvG,uBAAuB;QACvB,gGAAgG;QAClG,qBAAqB,CAAA;AACvB,CAAC,CAAA"}

package/build/i18n/be.json

@@ -3,6 +3,8 @@
     "description": "Мы выкарыстоўваем файлы cookie, каб палепшыць ваш досвед прагляду, паказваць персаналізаваную рэкламу ці змесціва і аналізаваць наш трафік. Націскаючы «Прыняць усе», вы пагаджаецеся на выкарыстанне файлаў cookie.",
     "essential": "Неабходныя файлы cookie",
     "essentialDesc": "Патрэбныя для працы сайта — уваход, бяспека і захаванне гэтых налад. Іх нельга адключыць.",
+    "functional": "Функцыянальныя файлы cookie",
+    "functionalDesc": "Запамінаюць вашы налады, напрыклад мову інтэрфейсу, каб вам не даводзілася задаваць іх зноў.",
     "analytics": "Аналітычныя файлы cookie",
     "analyticsDesc": "Дапамагаюць нам паляпшаць наш вэб-сайт, збіраючы і паведамляючы інфармацыю пра яго выкарыстанне.",
     "marketing": "Маркетынгавыя файлы cookie",

package/build/i18n/de.json

@@ -3,6 +3,8 @@
     "description": "Wir verwenden Cookies, um Ihr Surferlebnis zu verbessern, personalisierte Anzeigen oder Inhalte bereitzustellen und unseren Datenverkehr zu analysieren. Indem Sie auf „Alle akzeptieren\" klicken, stimmen Sie der Verwendung von Cookies zu.",
     "essential": "Notwendige Cookies",
     "essentialDesc": "Erforderlich, damit die Website funktioniert — Anmeldung, Sicherheit und das Speichern dieser Einstellungen. Sie lassen sich nicht abschalten.",
+    "functional": "Funktionale Cookies",
+    "functionalDesc": "Merken sich Ihre Auswahl, etwa die Oberflächensprache, damit Sie nicht erneut wählen müssen.",
     "analytics": "Analyse-Cookies",
     "analyticsDesc": "Helfen uns, unsere Website zu verbessern, indem sie Informationen zur Nutzung sammeln und melden.",
     "marketing": "Marketing-Cookies",

package/build/i18n/en.json

@@ -3,6 +3,8 @@
     "description": "We use cookies to enhance your browsing experience, serve personalized ads or content, and analyze our traffic. By clicking \"Accept All\", you consent to our use of cookies.",
     "essential": "Essential Cookies",
     "essentialDesc": "Required for the site to work — signing in, security and remembering these preferences. They cannot be switched off.",
+    "functional": "Functional Cookies",
+    "functionalDesc": "Remember your choices, such as the interface language, so you do not have to make them again.",
     "analytics": "Analytics Cookies",
     "analyticsDesc": "Help us improve our website by collecting and reporting information on its usage.",
     "marketing": "Marketing Cookies",

package/build/i18n/es.json

@@ -3,6 +3,8 @@
     "description": "Utilizamos cookies para mejorar tu experiencia de navegación, ofrecer anuncios o contenido personalizados y analizar nuestro tráfico. Al hacer clic en «Aceptar todo», aceptas nuestro uso de cookies.",
     "essential": "Cookies esenciales",
     "essentialDesc": "Necesarias para que el sitio funcione: inicio de sesión, seguridad y recordar estas preferencias. No se pueden desactivar.",
+    "functional": "Cookies funcionales",
+    "functionalDesc": "Recuerdan tus preferencias, como el idioma de la interfaz, para que no tengas que elegirlas de nuevo.",
     "analytics": "Cookies analíticas",
     "analyticsDesc": "Nos ayudan a mejorar nuestro sitio web recopilando e informando sobre su uso.",
     "marketing": "Cookies de marketing",

package/build/i18n/fr.json

@@ -3,6 +3,8 @@
     "description": "Nous utilisons des cookies pour améliorer votre navigation, proposer des publicités ou contenus personnalisés et analyser notre trafic. En cliquant sur « Tout accepter », vous consentez à leur utilisation.",
     "essential": "Cookies essentiels",
     "essentialDesc": "Nécessaires au fonctionnement du site : connexion, sécurité et mémorisation de ces préférences. Ils ne peuvent pas être désactivés.",
+    "functional": "Cookies fonctionnels",
+    "functionalDesc": "Mémorisent vos choix, comme la langue de l'interface, afin que vous n'ayez pas à les refaire.",
     "analytics": "Cookies analytiques",
     "analyticsDesc": "Nous aident à améliorer notre site en recueillant et en analysant des informations sur son utilisation.",
     "marketing": "Cookies marketing",

package/build/i18n/pl.json

@@ -3,6 +3,8 @@
     "description": "Używamy plików cookie w celu ulepszenia Twojego doświadczenia podczas przeglądania, wyświetlania spersonalizowanych reklam lub treści oraz analizowania naszego ruchu. Klikając „Akceptuj wszystkie\", wyrażasz zgodę na używanie przez nas plików cookie.",
     "essential": "Niezbędne pliki cookie",
     "essentialDesc": "Wymagane do działania witryny — logowanie, bezpieczeństwo i zapamiętanie tych ustawień. Nie można ich wyłączyć.",
+    "functional": "Funkcjonalne pliki cookie",
+    "functionalDesc": "Zapamiętują Twoje wybory, np. język interfejsu, aby nie trzeba było wybierać od nowa.",
     "analytics": "Analityczne pliki cookie",
     "analyticsDesc": "Pomagają nam ulepszać naszą witrynę internetową, zbierając i raportując informacje o jej użytkowaniu.",
     "marketing": "Marketingowe pliki cookie",

package/build/i18n/ru.json

@@ -3,6 +3,8 @@
     "description": "Мы используем файлы cookie, чтобы улучшить ваш опыт просмотра, показывать персонализированную рекламу или контент и анализировать наш трафик. Нажимая «Принять все», вы соглашаетесь на использование файлов cookie.",
     "essential": "Необходимые файлы cookie",
     "essentialDesc": "Нужны для работы сайта — вход, безопасность и сохранение этих настроек. Их нельзя отключить.",
+    "functional": "Функциональные файлы cookie",
+    "functionalDesc": "Запоминают ваши настройки, например язык интерфейса, чтобы не приходилось задавать их заново.",
     "analytics": "Аналитические файлы cookie",
     "analyticsDesc": "Помогают нам улучшать наш сайт, собирая и предоставляя информацию о его использовании.",
     "marketing": "Маркетинговые файлы cookie",

package/build/i18n/uk.json

@@ -3,6 +3,8 @@
     "description": "Ми використовуємо файли cookie, щоб покращити ваш досвід перегляду, показувати персоналізовану рекламу чи вміст і аналізувати наш трафік. Натискаючи «Прийняти всі», ви погоджуєтеся на використання файлів cookie.",
     "essential": "Необхідні файли cookie",
     "essentialDesc": "Потрібні для роботи сайту — вхід, безпека та збереження цих налаштувань. Їх не можна вимкнути.",
+    "functional": "Функціональні файли cookie",
+    "functionalDesc": "Запам’ятовують ваші налаштування, наприклад мову інтерфейсу, щоб вам не доводилося вибирати їх знову.",
     "analytics": "Аналітичні файли cookie",
     "analyticsDesc": "Допомагають нам покращувати наш вебсайт, збираючи та надаючи інформацію про його використання.",
     "marketing": "Маркетингові файли cookie",

package/build/index.d.ts

@@ -3,9 +3,10 @@ export * from './consts.js';
 export * from './storage.js';
 export * from './gtm.js';
 export * from './store.js';
+export * from './functional.js';
 export * from './i18n.js';
 export type { ConsentPlugin } from './plugins.js';
-export { registerConsentPlugin, consentPlugins, decorateConsentUrl, consentDomains, adoptConsent, startConsentPlugins, } from './plugins.js';
+export { registerConsentPlugin, consentPlugins, decorateConsentUrl, consentDomains, adoptConsent, startConsentPlugins, adoptConsentLanguage, } from './plugins.js';
 export type { ConsentLinkPayload } from './linker.js';
-export { consentLinker, encodeConsentLink, decodeConsentLink, stripConsentLinkParam, consentLinkerScript, CONSENT_LINK_PARAM, CONSENT_LINK_MAX_AGE, CONSENT_LINK_SKEW, } from './linker.js';
+export { consentLinker, encodeConsentLink, decodeConsentLink, stripConsentLinkParam, consentLinkerScript, writeConsentLanguage, CONSENT_LINK_PARAM, CONSENT_LINK_MAX_AGE, CONSENT_LINK_SKEW, } from './linker.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":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EACL,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EACvF,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAC/F,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,GAC5D,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EACL,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EACvF,mBAAmB,EAAE,oBAAoB,GAC1C,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAC/F,oBAAoB,EACpB,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,GAC5D,MAAM,aAAa,CAAA"}

package/build/index.js

@@ -2,7 +2,8 @@ export * from './consts.js';
 export * from './storage.js';
 export * from './gtm.js';
 export * from './store.js';
+export * from './functional.js';
 export * from './i18n.js';
-export { registerConsentPlugin, consentPlugins, decorateConsentUrl, consentDomains, adoptConsent, startConsentPlugins, } from './plugins.js';
-export { consentLinker, encodeConsentLink, decodeConsentLink, stripConsentLinkParam, consentLinkerScript, CONSENT_LINK_PARAM, CONSENT_LINK_MAX_AGE, CONSENT_LINK_SKEW, } from './linker.js';
+export { registerConsentPlugin, consentPlugins, decorateConsentUrl, consentDomains, adoptConsent, startConsentPlugins, adoptConsentLanguage, } from './plugins.js';
+export { consentLinker, encodeConsentLink, decodeConsentLink, stripConsentLinkParam, consentLinkerScript, writeConsentLanguage, CONSENT_LINK_PARAM, CONSENT_LINK_MAX_AGE, CONSENT_LINK_SKEW, } from './linker.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,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AAEzB,OAAO,EACL,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EACvF,mBAAmB,GACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAC/F,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,GAC5D,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AAEzB,OAAO,EACL,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EACvF,mBAAmB,EAAE,oBAAoB,GAC1C,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAC/F,oBAAoB,EACpB,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,GAC5D,MAAM,aAAa,CAAA"}

package/build/linker.d.ts

@@ -14,11 +14,34 @@ export interface ConsentLinkPayload {
     c: Record<string, 0 | 1>;
     /** Unix seconds the link was decorated at. */
     t: number;
+    /**
+     * The interface language of the page the link was on (a BCP 47 tag, lower-cased) — present only
+     * when the sender has `linker.language` set and its `<html lang>` names one. Optional on the
+     * wire, so a receiver that predates it reads the same `v: 2` payload and ignores the field.
+     */
+    l?: string;
 }
-/** The current document's decision, as the link parameter's `c`: one `0`/`1` per optional category. */
-export declare const encodeConsentLink: (record: ConsentRecord, opts?: ConsentOptions) => string;
+/**
+ * The link parameter's value: the current document's decision as `c` (one `0`/`1` per optional
+ * category — empty while `record` is `null`, i.e. before the visitor has decided) and, when
+ * `opts.linker.language` is set, the page's language as `l`.
+ */
+export declare const encodeConsentLink: (record: ConsentRecord | null, opts?: ConsentOptions) => string;
 /** Parse-only — no trust decision here, that is `consentLinker(opts).adopt`'s job. Never throws. */
 export declare const decodeConsentLink: (value: string) => ConsentLinkPayload | null;
+/**
+ * Persist an adopted language where the application's i18n layer reads its explicit choice from —
+ * `linker.language.storageKey`, `owlmeans-lng` by default — and only while the visitor has GRANTED
+ * `functional` on this document (a stored record, or the one adopted from the very link that
+ * carried the language). Without that grant nothing is written and `false` comes back: remembering
+ * a preference on a visitor's device is storage like any other, and a refusal ("reject all") is an
+ * answer, not a gap to fill. The gate lives here, not in the callers, so no caller can forget it.
+ *
+ * It overwrites what is there on purpose: the carried language is the one the visitor was reading a
+ * moment ago, which outranks a choice they made on this domain some other day. Storage that refuses
+ * the write is not an error. Returns whether the language was written.
+ */
+export declare const writeConsentLanguage: (language: string, opts?: ConsentOptions) => boolean;
 /**
  * Cross-domain consent: share this decision, and adopt one, between the domains named in
  * `opts.linker.domains`.

package/build/linker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linker.d.ts","sourceRoot":"","sources":["../src/linker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,OAAO,KAAK,EAAmB,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEhF,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,UAAU,CAAA;AACzC,wGAAwG;AACxG,eAAO,MAAM,oBAAoB,MAAM,CAAA;AACvC,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,QAAA,MAAM,oBAAoB,IAAI,CAAA;AAE9B,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,OAAO,oBAAoB,CAAA;IAC9B,iFAAiF;IACjF,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IACxB,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAA;CACV;AAwBD,uGAAuG;AACvG,eAAO,MAAM,iBAAiB,WAAY,aAAa,SAAS,cAAc,KAAG,MAQhF,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,UAAW,MAAM,KAAG,kBAAkB,GAAG,IAmBtE,CAAA;AAmBD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,QAAO,aAgGhC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,SAAU,cAAc,KAAG,IAgB5D,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,SAAU,cAAc,KAAG,MA6C1D,CAAA"}
+{"version":3,"file":"linker.d.ts","sourceRoot":"","sources":["../src/linker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,OAAO,KAAK,EAAmB,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEhF,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,UAAU,CAAA;AACzC,wGAAwG;AACxG,eAAO,MAAM,oBAAoB,MAAM,CAAA;AACvC,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,QAAA,MAAM,oBAAoB,IAAI,CAAA;AAE9B,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,OAAO,oBAAoB,CAAA;IAC9B,iFAAiF;IACjF,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IACxB,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAA;IACT;;;;OAIG;IACH,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAqCD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,WAAY,aAAa,GAAG,IAAI,SAAS,cAAc,KAAG,MAavF,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,UAAW,MAAM,KAAG,kBAAkB,GAAG,IAuBtE,CAAA;AAyDD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,aAAc,MAAM,SAAS,cAAc,KAAG,OAY9E,CAAA;AAQD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,QAAO,aA2FhC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,SAAU,cAAc,KAAG,IAgB5D,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,SAAU,cAAc,KAAG,MAoE1D,CAAA"}