@owlmeans/consent 0.1.18-rc.8 → 0.1.18

package/src/i18n/be.json

@@ -2,9 +2,7 @@
   "title": "Налады файлаў cookie",
   "description": "Мы выкарыстоўваем файлы cookie, каб палепшыць ваш досвед прагляду, паказваць персаналізаваную рэкламу ці змесціва і аналізаваць наш трафік. Націскаючы «Прыняць усе», вы пагаджаецеся на выкарыстанне файлаў cookie.",
   "essential": "Неабходныя файлы cookie",
-  "essentialDesc": "Патрэбныя для працы сайта — уваход, бяспека і захаванне гэтых налад. Іх нельга адключыць.",
-  "functional": "Функцыянальныя файлы cookie",
-  "functionalDesc": "Запамінаюць вашы налады, напрыклад мову інтэрфейсу, каб вам не даводзілася задаваць іх зноў.",
+  "essentialDesc": "Патрэбныя для працы сайта — уваход, бяспека і захаванне вашага выбару адносна файлаў cookie і мовы інтэрфейсу. Іх нельга адключыць.",
   "analytics": "Аналітычныя файлы cookie",
   "analyticsDesc": "Дапамагаюць нам паляпшаць наш вэб-сайт, збіраючы і паведамляючы інфармацыю пра яго выкарыстанне.",
   "marketing": "Маркетынгавыя файлы cookie",
@@ -34,5 +32,12 @@
   "privacy": "Палітыка прыватнасці",
   "terms": "Умовы карыстання",
   "domains": "Гэты выбар распаўсюджваецца на {{domains}}.",
-  "policyDomains": "Гэты выбар распаўсюджваецца на наступныя дамены:"
+  "policyDomains": "Гэты выбар распаўсюджваецца на наступныя дамены:",
+  "barTitle": "Файлы cookie на гэтым сайце",
+  "barDescription": "Мы выкарыстоўваем неабходныя файлы cookie для працы сайта — для ўваходу, забеспячэння бяспекі і запамінання вашага выбару. З вашай згоды мы таксама выкарыстоўвалі б наступныя неабавязковыя файлы cookie: {{categories}}. Яны застаюцца выключанымі, пакуль вы іх не дазволіце, а свой выбар вы можаце ў любы момант змяніць або адклікаць у наладах файлаў cookie.",
+  "barDescriptionEssential": "Гэты сайт выкарыстоўвае толькі неабходныя файлы cookie — для ўваходу, забеспячэння бяспекі і запамінання вашага выбару. Яны не патрабуюць згоды і не могуць быць адключаны.",
+  "acceptMandatory": "Прыняць толькі неабходныя",
+  "locating": "Вызначаем ваш рэгіён…",
+  "autoReason": "Гэтыя налады ўжыты аўтаматычна, бо там, адкуль вы праглядаеце сайт, згода на файлы cookie не патрабуецца. Вы можаце змяніць іх у любы момант.",
+  "policyRegional": "Там, дзе закон месца знаходжання наведвальніка патрабуе папярэдняй згоды, — у ЕС і ЕЭЗ, Вялікабрытаніі, Швейцарыі і іншых краінах з падобнымі правіламі — неабавязковыя файлы cookie застаюцца выключанымі, пакуль наведвальнік іх не дазволіць. У астатніх краінах яны ўключаны па змаўчанні, акрамя выпадкаў, калі браўзер перадае сігнал Global Privacy Control, які ўлічваецца як адмова; іх можна адключыць у любы момант кнопкай ніжэй."
 }

package/src/i18n/de.json

@@ -2,9 +2,7 @@
   "title": "Cookie-Einstellungen",
   "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.",
+  "essentialDesc": "Erforderlich, damit die Website funktioniert — Anmeldung, Sicherheit und das Speichern Ihrer Cookie-Auswahl und der Oberflächensprache. Sie lassen sich nicht abschalten.",
   "analytics": "Analyse-Cookies",
   "analyticsDesc": "Helfen uns, unsere Website zu verbessern, indem sie Informationen zur Nutzung sammeln und melden.",
   "marketing": "Marketing-Cookies",
@@ -34,5 +32,12 @@
   "privacy": "Datenschutzerklärung",
   "terms": "Nutzungsbedingungen",
   "domains": "Diese Wahl gilt für {{domains}}.",
-  "policyDomains": "Diese Wahl gilt für die folgenden Domains:"
+  "policyDomains": "Diese Wahl gilt für die folgenden Domains:",
+  "barTitle": "Cookies auf dieser Website",
+  "barDescription": "Wir verwenden notwendige Cookies, damit diese Website funktioniert – für die Anmeldung, die Sicherheit und um Ihre Auswahl zu speichern. Mit Ihrer Einwilligung würden wir außerdem diese optionalen Cookies verwenden: {{categories}}. Sie bleiben deaktiviert, bis Sie sie erlauben, und Sie können Ihre Auswahl jederzeit in den Cookie-Einstellungen ändern oder widerrufen.",
+  "barDescriptionEssential": "Diese Website verwendet nur notwendige Cookies – für die Anmeldung, die Sicherheit und um Ihre Auswahl zu speichern. Sie erfordern keine Einwilligung und können nicht deaktiviert werden.",
+  "acceptMandatory": "Nur notwendige akzeptieren",
+  "locating": "Ihre Region wird ermittelt …",
+  "autoReason": "Diese Einstellungen wurden automatisch angewendet, weil dort, von wo aus Sie die Website aufrufen, keine Cookie-Einwilligung erforderlich ist. Sie können sie jederzeit ändern.",
+  "policyRegional": "Wo das Recht am Aufenthaltsort der Besucher eine vorherige Einwilligung verlangt – in der EU und im EWR, im Vereinigten Königreich, in der Schweiz und in weiteren Ländern mit ähnlichen Regeln –, bleiben optionale Cookies deaktiviert, bis sie erlaubt werden. Anderswo sind sie standardmäßig aktiviert, außer wenn der Browser ein Global-Privacy-Control-Signal sendet, das als Ablehnung beachtet wird; sie lassen sich jederzeit über die Schaltfläche unten deaktivieren."
 }

package/src/i18n/en.json

@@ -2,9 +2,7 @@
   "title": "Cookie Preferences",
   "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.",
+  "essentialDesc": "Required for the site to work — signing in, security, and remembering your cookie choices and interface language. They cannot be switched off.",
   "analytics": "Analytics Cookies",
   "analyticsDesc": "Help us improve our website by collecting and reporting information on its usage.",
   "marketing": "Marketing Cookies",
@@ -34,5 +32,12 @@
   "privacy": "Privacy Policy",
   "terms": "Terms & Conditions",
   "domains": "This choice applies to {{domains}}.",
-  "policyDomains": "This choice applies across these domains:"
+  "policyDomains": "This choice applies across these domains:",
+  "barTitle": "Cookies on this site",
+  "barDescription": "We use essential cookies to make this site work — for signing in, security and remembering your choices. With your consent we would also use these optional cookies: {{categories}}. They stay off until you allow them, and you can change or withdraw your choice at any time in the cookie preferences.",
+  "barDescriptionEssential": "This site uses only essential cookies — for signing in, security and remembering your choices. They need no consent and cannot be switched off.",
+  "acceptMandatory": "Accept only mandatory",
+  "locating": "Checking your region…",
+  "autoReason": "These settings were applied automatically, because cookie consent is not required where you are browsing from. You can change them at any time.",
+  "policyRegional": "Where the law of the visitor's location requires prior consent — the EU and EEA, the United Kingdom, Switzerland and other countries with similar rules — optional cookies stay off until the visitor allows them. Elsewhere they are switched on by default, except when the browser sends a Global Privacy Control signal, which is honoured as a refusal; they can be switched off at any time with the button below."
 }

package/src/i18n/es.json

@@ -2,9 +2,7 @@
   "title": "Preferencias de cookies",
   "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.",
+  "essentialDesc": "Necesarias para que el sitio funcione: inicio de sesión, seguridad y recordar tus decisiones sobre cookies y el idioma de la interfaz. No se pueden desactivar.",
   "analytics": "Cookies analíticas",
   "analyticsDesc": "Nos ayudan a mejorar nuestro sitio web recopilando e informando sobre su uso.",
   "marketing": "Cookies de marketing",
@@ -34,5 +32,12 @@
   "privacy": "Política de privacidad",
   "terms": "Términos y condiciones",
   "domains": "Esta elección se aplica a {{domains}}.",
-  "policyDomains": "Esta elección se aplica a los siguientes dominios:"
+  "policyDomains": "Esta elección se aplica a los siguientes dominios:",
+  "barTitle": "Cookies en este sitio",
+  "barDescription": "Usamos cookies esenciales para que este sitio funcione: para iniciar sesión, por seguridad y para recordar tus elecciones. Con tu consentimiento también usaríamos estas cookies opcionales: {{categories}}. Permanecen desactivadas hasta que las permitas, y puedes cambiar o retirar tu elección en cualquier momento en las preferencias de cookies.",
+  "barDescriptionEssential": "Este sitio solo usa cookies esenciales: para iniciar sesión, por seguridad y para recordar tus elecciones. No requieren consentimiento y no se pueden desactivar.",
+  "acceptMandatory": "Aceptar solo las esenciales",
+  "locating": "Comprobando tu región…",
+  "autoReason": "Esta configuración se aplicó automáticamente porque, desde donde navegas, no se requiere consentimiento para las cookies. Puedes cambiarla en cualquier momento.",
+  "policyRegional": "Donde la ley del lugar en que se encuentra el visitante exige consentimiento previo —la UE y el EEE, el Reino Unido, Suiza y otros países con normas similares—, las cookies opcionales permanecen desactivadas hasta que el visitante las permita. En el resto están activadas por defecto, salvo cuando el navegador envía una señal Global Privacy Control, que se respeta como rechazo; pueden desactivarse en cualquier momento con el botón de abajo."
 }

package/src/i18n/fr.json

@@ -2,9 +2,7 @@
   "title": "Préférences de cookies",
   "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.",
+  "essentialDesc": "Nécessaires au fonctionnement du site : connexion, sécurité et mémorisation de vos choix en matière de cookies et de la langue de l'interface. Ils ne peuvent pas être désactivés.",
   "analytics": "Cookies analytiques",
   "analyticsDesc": "Nous aident à améliorer notre site en recueillant et en analysant des informations sur son utilisation.",
   "marketing": "Cookies marketing",
@@ -34,5 +32,12 @@
   "privacy": "Politique de confidentialité",
   "terms": "Conditions générales",
   "domains": "Ce choix s'applique à {{domains}}.",
-  "policyDomains": "Ce choix s'applique aux domaines suivants :"
+  "policyDomains": "Ce choix s'applique aux domaines suivants :",
+  "barTitle": "Cookies sur ce site",
+  "barDescription": "Nous utilisons des cookies essentiels au fonctionnement de ce site : pour la connexion, la sécurité et la mémorisation de vos choix. Avec votre consentement, nous utiliserions également ces cookies facultatifs : {{categories}}. Ils restent désactivés tant que vous ne les autorisez pas, et vous pouvez modifier ou retirer votre choix à tout moment dans les préférences de cookies.",
+  "barDescriptionEssential": "Ce site n'utilise que des cookies essentiels : pour la connexion, la sécurité et la mémorisation de vos choix. Ils ne nécessitent pas de consentement et ne peuvent pas être désactivés.",
+  "acceptMandatory": "Accepter uniquement les essentiels",
+  "locating": "Vérification de votre région…",
+  "autoReason": "Ces paramètres ont été appliqués automatiquement, car le consentement aux cookies n'est pas requis là où vous naviguez. Vous pouvez les modifier à tout moment.",
+  "policyRegional": "Là où la loi du lieu où se trouve le visiteur exige un consentement préalable — l'UE et l'EEE, le Royaume-Uni, la Suisse et d'autres pays aux règles similaires —, les cookies facultatifs restent désactivés tant que le visiteur ne les autorise pas. Ailleurs, ils sont activés par défaut, sauf lorsque le navigateur envoie un signal Global Privacy Control, respecté comme un refus ; ils peuvent être désactivés à tout moment avec le bouton ci-dessous."
 }

package/src/i18n/pl.json

@@ -2,9 +2,7 @@
   "title": "Preferencje dotyczące plików cookie",
   "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.",
+  "essentialDesc": "Wymagane do działania witryny — logowanie, bezpieczeństwo oraz zapamiętanie Twoich wyborów dotyczących plików cookie i języka interfejsu. Nie można ich wyłączyć.",
   "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",
@@ -34,5 +32,12 @@
   "privacy": "Polityka prywatności",
   "terms": "Regulamin",
   "domains": "Ten wybór dotyczy: {{domains}}.",
-  "policyDomains": "Ten wybór dotyczy następujących domen:"
+  "policyDomains": "Ten wybór dotyczy następujących domen:",
+  "barTitle": "Pliki cookie w tym serwisie",
+  "barDescription": "Używamy niezbędnych plików cookie, aby serwis działał — do logowania, zapewnienia bezpieczeństwa i zapamiętania Twoich wyborów. Za Twoją zgodą użylibyśmy również tych opcjonalnych plików cookie: {{categories}}. Pozostają wyłączone, dopóki na nie nie zezwolisz, a swój wybór możesz w każdej chwili zmienić lub wycofać w preferencjach plików cookie.",
+  "barDescriptionEssential": "Ten serwis używa wyłącznie niezbędnych plików cookie — do logowania, zapewnienia bezpieczeństwa i zapamiętania Twoich wyborów. Nie wymagają one zgody i nie można ich wyłączyć.",
+  "acceptMandatory": "Akceptuj tylko niezbędne",
+  "locating": "Sprawdzamy Twój region…",
+  "autoReason": "Te ustawienia zastosowano automatycznie, ponieważ tam, skąd przeglądasz serwis, zgoda na pliki cookie nie jest wymagana. Możesz je zmienić w każdej chwili.",
+  "policyRegional": "Tam, gdzie prawo miejsca pobytu odwiedzającego wymaga uprzedniej zgody — w UE i EOG, w Wielkiej Brytanii, Szwajcarii i innych krajach o podobnych przepisach — opcjonalne pliki cookie pozostają wyłączone, dopóki odwiedzający na nie nie zezwoli. W pozostałych krajach są domyślnie włączone, chyba że przeglądarka wysyła sygnał Global Privacy Control, który traktujemy jako odmowę; w każdej chwili można je wyłączyć przyciskiem poniżej."
 }

package/src/i18n/ru.json

@@ -2,9 +2,7 @@
   "title": "Настройки файлов cookie",
   "description": "Мы используем файлы cookie, чтобы улучшить ваш опыт просмотра, показывать персонализированную рекламу или контент и анализировать наш трафик. Нажимая «Принять все», вы соглашаетесь на использование файлов cookie.",
   "essential": "Необходимые файлы cookie",
-  "essentialDesc": "Нужны для работы сайта — вход, безопасность и сохранение этих настроек. Их нельзя отключить.",
-  "functional": "Функциональные файлы cookie",
-  "functionalDesc": "Запоминают ваши настройки, например язык интерфейса, чтобы не приходилось задавать их заново.",
+  "essentialDesc": "Нужны для работы сайта — вход, безопасность и сохранение вашего выбора по файлам cookie и языка интерфейса. Их нельзя отключить.",
   "analytics": "Аналитические файлы cookie",
   "analyticsDesc": "Помогают нам улучшать наш сайт, собирая и предоставляя информацию о его использовании.",
   "marketing": "Маркетинговые файлы cookie",
@@ -34,5 +32,12 @@
   "privacy": "Политика конфиденциальности",
   "terms": "Условия использования",
   "domains": "Этот выбор применяется к {{domains}}.",
-  "policyDomains": "Этот выбор применяется к следующим доменам:"
+  "policyDomains": "Этот выбор применяется к следующим доменам:",
+  "barTitle": "Файлы cookie на этом сайте",
+  "barDescription": "Мы используем необходимые файлы cookie для работы сайта — для входа, обеспечения безопасности и запоминания вашего выбора. С вашего согласия мы также использовали бы следующие необязательные файлы cookie: {{categories}}. Они остаются выключенными, пока вы их не разрешите, а свой выбор вы можете в любой момент изменить или отозвать в настройках файлов cookie.",
+  "barDescriptionEssential": "Этот сайт использует только необходимые файлы cookie — для входа, обеспечения безопасности и запоминания вашего выбора. Они не требуют согласия и не могут быть отключены.",
+  "acceptMandatory": "Принять только необходимые",
+  "locating": "Определяем ваш регион…",
+  "autoReason": "Эти настройки применены автоматически, поскольку там, откуда вы просматриваете сайт, согласие на файлы cookie не требуется. Вы можете изменить их в любой момент.",
+  "policyRegional": "Там, где закон места пребывания посетителя требует предварительного согласия, — в ЕС и ЕЭЗ, Великобритании, Швейцарии и других странах с аналогичными правилами — необязательные файлы cookie остаются выключенными, пока посетитель их не разрешит. В остальных странах они включены по умолчанию, кроме случаев, когда браузер передаёт сигнал Global Privacy Control, который учитывается как отказ; их можно отключить в любой момент кнопкой ниже."
 }

package/src/i18n/types.ts

@@ -0,0 +1,11 @@
+import type { ConsentLocale } from '../types.js'
+
+/** The dialog's built-in copy: the locale it is read in, the house translate shape, placeholders. */
+export interface ConsentI18nHelper {
+  /** A locale reduced to one the built-in copy carries — its base tag, else `en`. */
+  normalizeLocale: (locale?: string) => ConsentLocale
+  /** `(key, defaultValue) => string`, the house shape, backed by the built-in bundle. */
+  defaultConsentTranslate: (locale?: string) => (key: string, defaultValue: string) => string
+  /** Substitute `{{name}}` placeholders. Enough for the two the policy page needs. */
+  interpolate: (text: string, values: Record<string, string | number>) => string
+}

package/src/i18n/uk.json

@@ -2,9 +2,7 @@
   "title": "Налаштування файлів cookie",
   "description": "Ми використовуємо файли cookie, щоб покращити ваш досвід перегляду, показувати персоналізовану рекламу чи вміст і аналізувати наш трафік. Натискаючи «Прийняти всі», ви погоджуєтеся на використання файлів cookie.",
   "essential": "Необхідні файли cookie",
-  "essentialDesc": "Потрібні для роботи сайту — вхід, безпека та збереження цих налаштувань. Їх не можна вимкнути.",
-  "functional": "Функціональні файли cookie",
-  "functionalDesc": "Запам’ятовують ваші налаштування, наприклад мову інтерфейсу, щоб вам не доводилося вибирати їх знову.",
+  "essentialDesc": "Потрібні для роботи сайту — вхід, безпека та збереження вашого вибору щодо файлів cookie і мови інтерфейсу. Їх не можна вимкнути.",
   "analytics": "Аналітичні файли cookie",
   "analyticsDesc": "Допомагають нам покращувати наш вебсайт, збираючи та надаючи інформацію про його використання.",
   "marketing": "Маркетингові файли cookie",
@@ -34,5 +32,12 @@
   "privacy": "Політика конфіденційності",
   "terms": "Умови користування",
   "domains": "Цей вибір застосовується до {{domains}}.",
-  "policyDomains": "Цей вибір застосовується до таких доменів:"
+  "policyDomains": "Цей вибір застосовується до таких доменів:",
+  "barTitle": "Файли cookie на цьому сайті",
+  "barDescription": "Ми використовуємо необхідні файли cookie для роботи сайту — для входу, забезпечення безпеки та запам'ятовування вашого вибору. За вашою згодою ми також використовували б такі необов'язкові файли cookie: {{categories}}. Вони залишаються вимкненими, доки ви їх не дозволите, а свій вибір ви можете будь-коли змінити або відкликати в налаштуваннях файлів cookie.",
+  "barDescriptionEssential": "Цей сайт використовує лише необхідні файли cookie — для входу, забезпечення безпеки та запам'ятовування вашого вибору. Вони не потребують згоди й не можуть бути вимкнені.",
+  "acceptMandatory": "Прийняти лише необхідні",
+  "locating": "Визначаємо ваш регіон…",
+  "autoReason": "Ці налаштування застосовано автоматично, оскільки там, звідки ви переглядаєте сайт, згода на файли cookie не потрібна. Ви можете змінити їх будь-коли.",
+  "policyRegional": "Там, де закон місця перебування відвідувача вимагає попередньої згоди, — у ЄС і ЄЕЗ, Великій Британії, Швейцарії та інших країнах із подібними правилами — необов'язкові файли cookie залишаються вимкненими, доки відвідувач їх не дозволить. В інших країнах вони ввімкнені за замовчуванням, крім випадків, коли браузер надсилає сигнал Global Privacy Control, який враховується як відмова; їх можна будь-коли вимкнути кнопкою нижче."
 }

package/src/i18n.ts

@@ -1,39 +1,27 @@
-import { CONSENT_LOCALES } from './consts.js'
-import type { ConsentLocale } from './consts.js'
+import { CONSENT_LOCALES, DEFAULT_CONSENT_MESSAGES } from './consts.js'
+import type { ConsentLocale } from './types.js'
+import type { ConsentI18nHelper } from './i18n/types.js'
 
-import en from './i18n/en.json' with { type: 'json' }
-import pl from './i18n/pl.json' with { type: 'json' }
-import ru from './i18n/ru.json' with { type: 'json' }
-import be from './i18n/be.json' with { type: 'json' }
-import uk from './i18n/uk.json' with { type: 'json' }
-import es from './i18n/es.json' with { type: 'json' }
-import de from './i18n/de.json' with { type: 'json' }
-import fr from './i18n/fr.json' with { type: 'json' }
+export const createConsentI18nHelper = (): ConsentI18nHelper => {
+  const normalizeLocale = (locale?: string): ConsentLocale => {
+    const base = (locale ?? 'en').toLowerCase().split('-')[0]
 
-/**
- * The dialog's copy, in the box.
- *
- * Carried here rather than registered into an i18n framework because one of the three consumers is
- * an Astro site with React islands and no OwlMeans i18n at all — and a consent dialog that renders
- * raw keys is worse than no dialog. An application that HAS translations passes `translate` and
- * overrides every one of these.
- */
-export const DEFAULT_CONSENT_MESSAGES: Record<ConsentLocale, Record<string, string>> = {
-  en, pl, ru, be, uk, es, de, fr,
-}
+    return CONSENT_LOCALES.includes(base as ConsentLocale) ? base as ConsentLocale : 'en'
+  }
+
+  const defaultConsentTranslate = (locale?: string) =>
+    (key: string, defaultValue: string): string =>
+      DEFAULT_CONSENT_MESSAGES[normalizeLocale(locale)]?.[key] ?? defaultValue
 
-export const normalizeLocale = (locale?: string): ConsentLocale => {
-  const base = (locale ?? 'en').toLowerCase().split('-')[0]
+  const interpolate = (text: string, values: Record<string, string | number>): string =>
+    text.replace(/\{\{([a-z]+)\}\}/gi, (whole, name: string) =>
+      values[name] != null ? String(values[name]) : whole)
 
-  return CONSENT_LOCALES.includes(base as ConsentLocale) ? base as ConsentLocale : 'en'
+  return { normalizeLocale, defaultConsentTranslate, interpolate }
 }
 
-/** `(key, defaultValue) => string`, the house shape, backed by the built-in bundle. */
-export const defaultConsentTranslate = (locale?: string) =>
-  (key: string, defaultValue: string): string =>
-    DEFAULT_CONSENT_MESSAGES[normalizeLocale(locale)]?.[key] ?? defaultValue
+export const consentI18nHelper = createConsentI18nHelper()
 
-/** Substitute `{{name}}` placeholders. Enough for the two the policy page needs. */
-export const interpolate = (text: string, values: Record<string, string | number>): string =>
-  text.replace(/\{\{([a-z]+)\}\}/gi, (whole, name: string) =>
-    values[name] != null ? String(values[name]) : whole)
+/** @deprecated compat:factory-refactor — use `consentI18nHelper.defaultConsentTranslate(…)` */
+export const defaultConsentTranslate = (locale?: string): (key: string, defaultValue: string) => string =>
+  consentI18nHelper.defaultConsentTranslate(locale)

package/src/index.ts

@@ -1,18 +1,18 @@
 export type * from './types.js'
+export type * from './gtobserver/types.js'
+export type * from './i18n/types.js'
+export type * from './linker/types.js'
+export type * from './plugins/types.js'
+export type * from './storage/types.js'
+export type * from './geo/types.js'
 export * from './consts.js'
 export * from './storage.js'
-export * from './gtm.js'
+export * from './gtobserver.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, adoptConsentLanguage,
-} from './plugins.js'
-export type { ConsentLinkPayload } from './linker.js'
-export {
-  consentLinker, encodeConsentLink, decodeConsentLink, stripConsentLinkParam, consentLinkerScript,
-  writeConsentLanguage,
-  CONSENT_LINK_PARAM, CONSENT_LINK_MAX_AGE, CONSENT_LINK_SKEW,
-} from './linker.js'
+export * from './geo.js'
+export type { ConsentPlugin } from './types.js'
+export { createConsentPluginHelper, consentPluginHelper, decorateConsentUrl } from './plugins.js'
+export type { ConsentLinkPayload } from './types.js'
+export { createConsentLinkHelper, consentLinkHelper, encodeConsentLink, consentLinkerScript } from './linker.js'
+export { CONSENT_LINK_PARAM, CONSENT_LINK_MAX_AGE, CONSENT_LINK_SKEW } from './consts.js'

package/src/linker/types.ts

@@ -0,0 +1,59 @@
+import type { ConsentLinkPayload, ConsentOptions, ConsentPlugin, ConsentRecord } from '../types.js'
+
+/** Cross-domain consent: the decorated-link parameter, the linker plugin and its inline twin. */
+export interface ConsentLinkHelper {
+  /**
+   * 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 for an
+   * automatic decision, which is not the visitor's to carry) and, when
+   * `opts.linker.language` is set, the page's language as `l`.
+   */
+  encodeConsentLink: (record: ConsentRecord | null, opts?: ConsentOptions) => string
+  /** Parse-only — no trust decision here, that is `consentLinker(opts).adopt`'s job. Never throws. */
+  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. Unconditional: the interface language is
+   * strictly necessary storage (the visitor picked it, and the site cannot speak to them without it),
+   * so no cookie decision — none yet, a refusal, an old record — stands between it and the device.
+   *
+   * 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.
+   */
+  writeConsentLanguage: (language: string, opts?: ConsentOptions) => boolean
+  /**
+   * Cross-domain consent: share this decision, and adopt one, between the domains named in
+   * `opts.linker.domains`.
+   *
+   * `start` decorates outgoing first-party links; `adopt` reads and validates an incoming one;
+   * `domains` discloses the list a dialog or policy page names. `decorate` is generic (a bare `URL`,
+   * no DOM) so the same trust rule serves a real anchor click and a programmatic navigation
+   * (`decorateConsentUrl`) alike — the `rel="noreferrer"` exemption is a DOM-only concept and is
+   * therefore checked by `start`'s click handler, never here.
+   */
+  consentLinker: () => ConsentPlugin
+  /**
+   * Remove the link parameter from the visible URL, keeping every other parameter and the hash — the
+   * real-TS equivalent of what {@link consentLinkerScript}'s embedded fragment already did inline.
+   * Idempotent: a page with no head script calls this from `consentStore.init` and it strips once; a
+   * page that ALSO carried the head script finds the parameter already gone and does nothing.
+   */
+  stripConsentLinkParam: (opts: ConsentOptions) => void
+  /**
+   * The inline `<head>` fragment that adopts a decorated link's decision and strips the parameter —
+   * standalone, so a page can stamp it even where nothing else here runs (a legal page with no tag
+   * script). `@owlmeans/web-gtm`'s `consentBootstrapScript` embeds this SAME fragment right after
+   * pushing Consent Mode's defaults, so a page that has both never runs it twice with different
+   * effect — the second attempt finds the parameter already gone and does nothing.
+   *
+   * Mirrors `consentLinker().adopt` exactly (v2, referrer + freshness/skew + full optional coverage +
+   * no existing record — or only an automatic one, which the visitor's own choice replaces), but as hand-rolled JS text rather than a call into this module — the same
+   * discipline `consentBootstrapScript`/`consentGateScript` already follow, because this has to run
+   * before any bundle (this module included) has loaded. The parameter is ALWAYS stripped via
+   * `history.replaceState`, whether or not the trust rule accepts it: a stale or foreign `owlcc` is
+   * exactly as much noise as an adopted one, and neither belongs in the visible URL or in what a page
+   * reload, a shared link or a browser history entry carries forward.
+   */
+  consentLinkerScript: (opts: ConsentOptions) => string
+}