@eifi1/ui-kit 0.28.0 → 0.28.1

package/src/components/legal.tsx

@@ -1,5 +1,5 @@
 import { createContext, useContext } from "react";
-import type { ReactNode } from "react";
+import type { MouseEvent, ReactNode } from "react";
 
 import { useKitLabels } from "../i18n/kit-labels";
 import type { LabelOverride } from "../i18n/kit-labels";
@@ -66,6 +66,14 @@ export interface LegalOperator {
   country: string;
   /** The contact address the imprint and the privacy policy print. */
   email: string;
+  /**
+   * The language whose version of the legal texts is BINDING ("de-CH"), a BCP 47 code
+   * (0.28.1, Marcel 2026-10-05). The lawyer reviews that one; the others are translations
+   * for convenience. With it, {@link LegalPage} shows a note on every page read in
+   * another language, and the terms' `language` section says which version prevails.
+   * Only the language subtag counts: "de-CH" and "de" are the same language here.
+   */
+  bindingLanguage?: string;
 }
 
 /**
@@ -78,10 +86,42 @@ export interface LegalOperator {
  */
 export type LegalOperatorText = Readonly<Record<keyof LegalOperator, string>>;
 
+/** The language subtag of a BCP 47 code, lower-cased: "de-CH" → "de". */
+export function baseLanguage(code: string): string {
+  return code.split(/[-_]/)[0]!.toLowerCase();
+}
+
+const languageNamers = new Map<string, Intl.DisplayNames | null>();
+
+/** The name of a language in `locale` — "Deutsch", "German", "allemand", "德语" — from its
+ *  language subtag, so "de-CH" is plain "German", not "Swiss High German". The code itself
+ *  when the runtime cannot name it. */
+function languageName(code: string, locale: string): string {
+  let namer = languageNamers.get(locale);
+  if (namer === undefined) {
+    try {
+      namer = new Intl.DisplayNames([locale], { type: "language" });
+    } catch {
+      namer = null;
+    }
+    languageNamers.set(locale, namer);
+  }
+  const base = baseLanguage(code);
+  try {
+    return namer?.of(base) ?? base;
+  } catch {
+    return base;
+  }
+}
+
 /** @internal The operator as the texts read it: its country named in `locale` (English
  *  without one — `countryName`'s rule, so an app that set no locale reads English). */
 export function legalOperatorText(operator: LegalOperator, locale: string = "en"): LegalOperatorText {
-  return { ...operator, country: countryName(operator.country, locale) };
+  return {
+    ...operator,
+    country: countryName(operator.country, locale),
+    bindingLanguage: operator.bindingLanguage ? languageName(operator.bindingLanguage, locale) : "",
+  };
 }
 
 // ── Labels ────────────────────────────────────────────────────────────────────
@@ -142,6 +182,16 @@ export interface LegalLabels {
     beta: string;
     privacy: string;
   };
+  /**
+   * 0.28.1: on a page read in another language than the operator's `bindingLanguage` —
+   * `note` under the title, `show` on the button that switches to the binding version
+   * (when the app passes `onShowBindingLanguage`). `o.bindingLanguage` is the binding
+   * language's NAME in the reader's language ("German", "allemand").
+   */
+  translation: {
+    note: (o: LegalOperatorText) => string;
+    show: (o: LegalOperatorText) => string;
+  };
   /** The kit's sections (§4.3), by page and section key. */
   sections: {
     impressum: {
@@ -164,6 +214,8 @@ export interface LegalLabels {
       warranty: LegalTextSectionLabels;
       liability: LegalTextSectionLabels;
       changes: LegalTextSectionLabels;
+      /** 0.28.1: which language's version prevails — `o.bindingLanguage`, named. */
+      language: LegalOperatorSectionLabels;
       /** The place of jurisdiction is the operator's `{city} ({region}), {country}`. */
       law: LegalOperatorSectionLabels;
     };
@@ -189,6 +241,11 @@ export const DEFAULT_LEGAL_LABELS: LegalLabels = {
     privacy:
       "Closed beta. The legal wording below has not been reviewed by a lawyer yet and will be before a public launch. The technical descriptions — what is stored, where, and who can read it — describe what the software actually does today, and are meant to be checked against it.",
   },
+  translation: {
+    note: (o) =>
+      `This is a translation for your convenience. The ${o.bindingLanguage} version is binding.`,
+    show: (o) => `Show the ${o.bindingLanguage} version`,
+  },
   sections: {
     impressum: {
       operator: {
@@ -243,6 +300,11 @@ export const DEFAULT_LEGAL_LABELS: LegalLabels = {
         title: "Changes to these terms",
         body: "These terms may be updated as the service evolves. Material changes will be announced by email or in the app; continued use after a change means you accept it.",
       },
+      language: {
+        title: "Language",
+        body: (o) =>
+          `These terms are written in ${o.bindingLanguage}. Translations into other languages are provided for convenience only; where a translation differs, the ${o.bindingLanguage} version prevails.`,
+      },
       law: {
         title: "Governing law",
         body: (o) =>
@@ -375,6 +437,9 @@ export interface LegalLinksProps {
    *  links, so in a plain container — Kurvenschmiede's account-menu `<li>` — they ran
    *  together as "ImpressumDatenschutzerklärungNutz…" and overflowed). Default true. */
   nav?: boolean;
+  /** Called on a click on any of the links, before it navigates — an account menu closes
+   *  itself here (0.28.1, keksdose: it had to catch the click on a wrapping `<div>`). */
+  onLinkClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
   labels?: LabelOverride<LegalLabels>;
   className?: string;
 }
@@ -396,12 +461,19 @@ function defaultLinks(labels: LegalLabels): LegalLink[] {
  * already hears three links, and "middle dot" between them is noise. They are flex items
  * of the row like the links, so the row's gap spaces them evenly.
  */
-export function LegalLinks({ links, currentHref, nav = true, labels: labelsProp, className }: LegalLinksProps) {
+export function LegalLinks({
+  links,
+  currentHref,
+  nav = true,
+  onLinkClick,
+  labels: labelsProp,
+  className,
+}: LegalLinksProps) {
   const labels = useLegalLabels(labelsProp);
   const shown = links ?? defaultLinks(labels);
   const items = shown.flatMap((link, i) => [
     ...(i > 0 ? [<span key={`sep-${link.href}`} aria-hidden="true">·</span>] : []),
-    <TextLink key={link.href} href={link.href} tone="muted" current={link.href === currentHref}>
+    <TextLink key={link.href} href={link.href} tone="muted" current={link.href === currentHref} onClick={onLinkClick}>
       {link.label}
     </TextLink>,
   ]);
@@ -425,6 +497,14 @@ export interface LegalFooterProps {
   /** Marks that link `aria-current="page"`. {@link LegalPage}'s default footer passes
    *  its own page. */
   currentHref?: string;
+  /**
+   * Default true: the footer is a `<footer>`. `false` draws a `<div>` — for a host that is
+   * a footer already: `AuthLayout`'s `footer` slot is one, and HTML forbids a footer inside
+   * a footer (0.28.1, kastlan). On an `AuthLayout` page the usual choice is simpler still:
+   * `footer={<LegalLinks nav={false} />}` with `footerLabel` set to the kit's `navLabel`
+   * ({@link useLegalLabels}).
+   */
+  landmark?: boolean;
   className?: string;
   labels?: LabelOverride<LegalLabels>;
 }
@@ -440,9 +520,10 @@ export interface LegalFooterProps {
  * only. Its palette classes (`border-slate-200 bg-white dark:…`) became the surface and
  * border tokens, so it follows the theme like the rest of the kit.
  */
-export function LegalFooter({ children, links, currentHref, className, labels }: LegalFooterProps) {
+export function LegalFooter({ children, links, currentHref, landmark = true, className, labels }: LegalFooterProps) {
+  const Root = landmark ? "footer" : "div";
   return (
-    <footer className={cn("border-t border-[var(--border)] bg-[var(--bg-surface)]", className)}>
+    <Root className={cn("border-t border-[var(--border)] bg-[var(--bg-surface)]", className)}>
       <div className="mx-auto max-w-5xl px-4 py-8 text-sm text-[var(--text-muted)]">
         <LegalLinks
           links={links}
@@ -452,7 +533,7 @@ export function LegalFooter({ children, links, currentHref, className, labels }:
         />
         {children !== undefined && children !== null && <p className="mt-4 text-center">{children}</p>}
       </div>
-    </footer>
+    </Root>
   );
 }
 
@@ -526,6 +607,9 @@ export interface LegalLayoutProps {
    * than the others (its technical sections describe running code).
    */
   notice?: ReactNode;
+  /** 0.28.1: under the title, before the notice — {@link LegalPage}'s note that this
+   *  page is a translation and which language is binding. */
+  translationNote?: ReactNode;
   /** The sections — {@link LegalSection}s. */
   children: ReactNode;
   /** The three pages, linked at the end of the column with the current one marked.
@@ -543,6 +627,7 @@ export function LegalLayout({
   title,
   back,
   notice,
+  translationNote,
   children,
   links,
   currentHref,
@@ -554,6 +639,7 @@ export function LegalLayout({
     <article className={cn("mx-auto w-full max-w-3xl px-4 py-12", className)}>
       {back !== undefined && <div className="mb-4 text-sm">{back}</div>}
       <Heading className="text-3xl font-bold tracking-tight break-words text-[var(--text-primary)]">{title}</Heading>
+      {translationNote !== undefined && translationNote !== null && <div className="mt-3">{translationNote}</div>}
       {notice !== undefined && notice !== null && (
         <AlertBanner tone="warning" role="note" className="mt-4">
           {notice}

package/src/i18n/german.ts

@@ -779,6 +779,11 @@ export function germanLabels(numberLocale: string): UiKitLabels {
         privacy:
           "Geschlossene Beta. Die rechtlichen Formulierungen unten sind noch nicht anwaltlich geprüft; das geschieht vor einem öffentlichen Start. Die technischen Angaben — was gespeichert wird, wo, und wer es lesen kann — beschreiben, was die Software heute tatsächlich tut, und sind ausdrücklich dazu da, daran überprüft zu werden.",
       },
+      translation: {
+        note: (o) =>
+          `Dies ist eine Übersetzung zu Ihrer Information. Massgebend ist die Fassung auf ${o.bindingLanguage}.`,
+        show: (o) => `Fassung auf ${o.bindingLanguage} anzeigen`,
+      },
       sections: {
         impressum: {
           operator: {
@@ -833,6 +838,11 @@ export function germanLabels(numberLocale: string): UiKitLabels {
             title: "Änderungen dieser Bedingungen",
             body: "Diese Bedingungen können im Zuge der Weiterentwicklung des Dienstes angepasst werden. Wesentliche Änderungen werden per E-Mail oder in der App angekündigt; die weitere Nutzung nach einer Änderung gilt als Zustimmung.",
           },
+          language: {
+            title: "Sprache",
+            body: (o) =>
+              `Diese Bedingungen sind auf ${o.bindingLanguage} verfasst. Übersetzungen in andere Sprachen dienen nur der Information; weicht eine Übersetzung ab, ist die Fassung auf ${o.bindingLanguage} massgebend.`,
+          },
           law: {
             title: "Anwendbares Recht",
             body: (o) =>

package/src/i18n/locales/es.ts

@@ -757,7 +757,12 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       notice: {
         beta: "Beta cerrada. Estos textos aún no han sido revisados por un abogado y lo serán antes de un lanzamiento público.",
         privacy:
-          "Beta cerrada. La redacción jurídica que sigue aún no ha sido revisada por un abogado y lo será antes de un lanzamiento público. Las descripciones técnicas —qué se guarda, dónde y quién puede leerlo— describen lo que el software hace realmente hoy y están pensadas para que se contrasten con él.",
+          "Beta cerrada. La redacción jurídica que sigue aún no ha sido revisada por un abogado y lo será antes de un lanzamiento público. Las descripciones técnicas —qué se guarda, dónde y quién puede leerlo— describen lo que el software hace realmente hoy y deben poder contrastarse con él.",
+      },
+      translation: {
+        note: (o) =>
+          `Esta es una traducción ofrecida para su comodidad. La versión vinculante es la versión en ${o.bindingLanguage}.`,
+        show: (o) => `Ver la versión en ${o.bindingLanguage}`,
       },
       sections: {
         impressum: {
@@ -783,12 +788,12 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
           },
           legal_basis: {
             title: "Base jurídica",
-            body: "Como el responsable tiene su sede en Suiza, el tratamiento se rige por la Ley Federal suiza de Protección de Datos (LPD). Cuando le sea aplicable el Reglamento General de Protección de Datos de la UE (RGPD), nos basamos en la ejecución de un contrato para prestar el servicio (art. 6.1.b RGPD) y en nuestro interés legítimo en operarlo y protegerlo (art. 6.1.f RGPD).",
+            body: "Como el responsable reside en Suiza, el tratamiento se rige por la Ley Federal suiza de Protección de Datos (LPD). Cuando le sea aplicable el Reglamento General de Protección de Datos de la UE (RGPD), nos basamos en la ejecución de un contrato para prestar el servicio (art. 6.1.b RGPD) y en nuestro interés legítimo en operarlo y protegerlo (art. 6.1.f RGPD).",
           },
           browser: {
             title: "Qué guarda su navegador",
             lead: "Ninguna cookie. La aplicación guarda lo siguiente en el almacenamiento de su navegador:",
-            tail: "Nada de ello se usa para seguirle. Las entradas pendientes de envío se nos envían en cuanto es posible; todo lo demás permanece en su dispositivo. Todo ello desaparece cuando borra los datos del sitio, y al cerrar sesión se eliminan los tokens de inicio de sesión.",
+            tail: "Nada de ello se usa para rastrearle. Las entradas pendientes de envío se nos envían en cuanto sea posible; todo lo demás permanece en su dispositivo. Todo ello desaparece cuando borra los datos del sitio, y al cerrar sesión se eliminan los tokens de inicio de sesión.",
           },
           rights: {
             title: "Sus derechos",
@@ -813,6 +818,11 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
             title: "Cambios en estas condiciones",
             body: "Estas condiciones pueden actualizarse a medida que evolucione el servicio. Los cambios importantes se anunciarán por correo electrónico o en la aplicación; si sigue usando el servicio después de un cambio, lo acepta.",
           },
+          language: {
+            title: "Idioma",
+            body: (o) =>
+              `Estas condiciones están redactadas en ${o.bindingLanguage}. Las traducciones a otros idiomas se ofrecen solo por comodidad; en caso de discrepancia, prevalece la versión en ${o.bindingLanguage}.`,
+          },
           law: {
             title: "Legislación aplicable",
             body: (o) =>

package/src/i18n/locales/fr.ts

@@ -777,6 +777,11 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
         privacy:
           "Bêta fermée. Les formulations juridiques ci-dessous n’ont pas encore été relues par un avocat\u202f; cela sera fait avant un lancement public. Les descriptions techniques — ce qui est stocké, où, et qui peut le lire — décrivent ce que fait réellement le logiciel aujourd’hui et sont faites pour être vérifiées par rapport à lui.",
       },
+      translation: {
+        note: (o) =>
+          `Ceci est une traduction fournie pour votre commodité. Seule la version en ${o.bindingLanguage} fait foi.`,
+        show: (o) => `Afficher la version en ${o.bindingLanguage}`,
+      },
       sections: {
         impressum: {
           operator: {
@@ -831,6 +836,11 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
             title: "Modifications des présentes conditions",
             body: "Ces conditions peuvent être mises à jour au fil de l’évolution du service. Les modifications importantes seront annoncées par e-mail ou dans l’app\u202f; continuer à utiliser le service après une modification vaut acceptation.",
           },
+          language: {
+            title: "Langue",
+            body: (o) =>
+              `Les présentes conditions sont rédigées en ${o.bindingLanguage}. Les traductions dans d’autres langues sont fournies à titre indicatif uniquement\u202f; en cas de divergence, la version en ${o.bindingLanguage} prévaut.`,
+          },
           law: {
             title: "Droit applicable",
             body: (o) =>

package/src/i18n/locales/hu.ts

@@ -761,12 +761,17 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       // The accusative ending is glued to the link, as Italian glues its article: "a
       // Felhasználási feltételeket és az Adatvédelmi tájékoztatót". Nothing is added around
       // a placeholder, and the articles fit these two titles (a F…, az A…).
-      accept: "Elfogadom a {terms}et és az {privacy}t",
+      accept: "Elfogadom a következőket: {terms} és {privacy}",
       notice: {
         beta: "Zárt béta. Ezeket a szövegeket ügyvéd még nem ellenőrizte; erre a nyilvános indulás előtt sor kerül.",
         privacy:
           "Zárt béta. Az alábbi jogi szövegezést ügyvéd még nem ellenőrizte; erre a nyilvános indulás előtt sor kerül. A műszaki leírások – mit tárolunk, hol és ki olvashatja – azt írják le, amit a szoftver ma ténylegesen tesz, és arra valók, hogy a szoftverrel össze lehessen vetni őket.",
       },
+      translation: {
+        note: (o) =>
+          `Ez a szöveg tájékoztató jellegű fordítás; az irányadó változat nyelve: ${o.bindingLanguage}.`,
+        show: (o) => `Megjelenítés ezen a nyelven: ${o.bindingLanguage}`,
+      },
       sections: {
         impressum: {
           operator: {
@@ -791,11 +796,11 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
           },
           legal_basis: {
             title: "Jogalap",
-            body: "Mivel az üzemeltető székhelye Svájcban van, az adatkezelésre a svájci szövetségi adatvédelmi törvény (DSG/FADP) az irányadó. Ha Önre az EU általános adatvédelmi rendelete (GDPR) vonatkozik, a szolgáltatás nyújtására irányuló szerződés teljesítésére (GDPR 6. cikk (1) b) pont) és a szolgáltatás működtetéséhez és védelméhez fűződő jogos érdekünkre (GDPR 6. cikk (1) f) pont) támaszkodunk.",
+            body: "Mivel az üzemeltető lakóhelye Svájcban van, az adatkezelésre a svájci szövetségi adatvédelmi törvény (DSG/FADP) az irányadó. Ha Önre az EU általános adatvédelmi rendelete (GDPR) vonatkozik, a szolgáltatás nyújtására irányuló szerződés teljesítésére (GDPR 6. cikk (1) b) pont) és a szolgáltatás működtetéséhez és védelméhez fűződő jogos érdekünkre (GDPR 6. cikk (1) f) pont) támaszkodunk.",
           },
           browser: {
             title: "Mit tárol az Ön böngészője",
-            lead: "Nincsenek sütik. Az alkalmazás a következőket tárolja a böngészője tárhelyén:",
+            lead: "Nincsenek sütik. Az alkalmazás a következőket tárolja az Ön böngészőjének tárhelyén:",
             tail: "Egyiket sem használjuk az Ön követésére. A küldésre váró bejegyzéseket a böngésző elküldi nekünk, amint lehetséges; minden más az Ön eszközén marad. Mindez eltűnik, amikor törli a webhely adatait, kijelentkezéskor pedig a bejelentkezési tokenek törlődnek.",
           },
           rights: {
@@ -821,6 +826,11 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
             title: "A feltételek módosítása",
             body: "Ezek a feltételek a szolgáltatás fejlődésével módosulhatnak. A lényeges változásokat e-mailben vagy az alkalmazásban jelentjük be; aki a változás után tovább használja a szolgáltatást, elfogadja azt.",
           },
+          language: {
+            title: "Nyelv",
+            body: (o) =>
+              `Ezek a feltételek ${o.bindingLanguage} nyelven készültek. A más nyelvű fordítások csak tájékoztató jellegűek; eltérés esetén az eredeti, ${o.bindingLanguage} nyelvű változat az irányadó.`,
+          },
           law: {
             title: "Irányadó jog",
             body: (o) =>

package/src/i18n/locales/it.ts

@@ -764,6 +764,11 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
         privacy:
           "Beta chiusa. Le formulazioni legali qui sotto non sono ancora state verificate da un avvocato; lo saranno prima di un lancio pubblico. Le descrizioni tecniche — cosa viene memorizzato, dove e chi può leggerlo — descrivono ciò che il software fa davvero oggi e sono pensate per essere verificate rispetto a esso.",
       },
+      translation: {
+        note: (o) =>
+          `Questa è una traduzione fornita per Sua comodità. Fa fede la versione in ${o.bindingLanguage}.`,
+        show: (o) => `Mostra la versione in ${o.bindingLanguage}`,
+      },
       sections: {
         impressum: {
           operator: {
@@ -790,7 +795,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
           },
           legal_basis: {
             title: "Base giuridica",
-            body: "Poiché il gestore ha sede in Svizzera, il trattamento è disciplinato dalla Legge federale svizzera sulla protezione dei dati (LPD). Dove il Regolamento generale sulla protezione dei dati dell’UE (GDPR) si applica a Lei, ci basiamo sull’esecuzione di un contratto per fornire il servizio (art. 6, par. 1, lett. b GDPR) e sul nostro legittimo interesse a gestirlo e proteggerlo (art. 6, par. 1, lett. f GDPR).",
+            body: "Poiché il gestore risiede in Svizzera, il trattamento è disciplinato dalla Legge federale svizzera sulla protezione dei dati (LPD). Dove il Regolamento generale sulla protezione dei dati dell’UE (GDPR) si applica a Lei, ci basiamo sull’esecuzione di un contratto per fornire il servizio (art. 6, par. 1, lett. b GDPR) e sul nostro legittimo interesse a gestirlo e proteggerlo (art. 6, par. 1, lett. f GDPR).",
           },
           browser: {
             title: "Che cosa salva il Suo browser",
@@ -820,6 +825,11 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
             title: "Modifiche a queste condizioni",
             body: "Queste condizioni possono essere aggiornate con l’evoluzione del servizio. Le modifiche sostanziali saranno annunciate via email o nell’app; l’uso continuato dopo una modifica ne implica l’accettazione.",
           },
+          language: {
+            title: "Lingua",
+            body: (o) =>
+              `Le presenti condizioni sono redatte in ${o.bindingLanguage}. Le traduzioni in altre lingue sono fornite solo per comodità; in caso di divergenza prevale la versione in ${o.bindingLanguage}.`,
+          },
           law: {
             title: "Legge applicabile",
             body: (o) =>

package/src/i18n/locales/zh.ts

@@ -736,12 +736,17 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       },
       backHome: "返回首页",
       // Book-title marks around the two documents, outside the links.
-      accept: "我接受《{terms}》和《{privacy}》",
+      accept: "我已阅读并同意《{terms}》和《{privacy}》",
       notice: {
         beta: "封闭测试阶段。这些文本尚未经律师审阅，将在公开发布之前完成审阅。",
         privacy:
           "封闭测试阶段。以下法律措辞尚未经律师审阅，将在公开发布之前完成审阅。其中的技术说明——存储了什么、存储在哪里以及谁可以读取——描述的是软件目前的实际行为，旨在供人对照软件加以核实。",
       },
+      translation: {
+        note: (o) =>
+          `本页为方便阅读而提供的译文，以${o.bindingLanguage}版本为准。`,
+        show: (o) => `查看${o.bindingLanguage}版本`,
+      },
       sections: {
         impressum: {
           operator: {
@@ -796,6 +801,11 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
             title: "条款变更",
             body: "本条款可能会随着服务的发展而更新。重大变更将通过电子邮件或在应用程序中公布；变更后继续使用本服务即表示您接受变更。",
           },
+          language: {
+            title: "语言",
+            body: (o) =>
+              `本条款以${o.bindingLanguage}撰写。其他语言的译文仅供参考；如译文与原文不一致，以${o.bindingLanguage}版本为准。`,
+          },
           law: {
             title: "适用法律",
             body: (o) =>

package/src/i18n/review.ts

@@ -1,5 +1,5 @@
+import { legalOperatorText } from "../components/legal";
 import type { LegalOperator, LegalOperatorText } from "../components/legal";
-import { countryName } from "../lib/countries";
 import type { UiKitLabels } from "./kit-labels";
 
 /**
@@ -40,7 +40,7 @@ import type { UiKitLabels } from "./kit-labels";
  */
 export function kitLabelStrings(labels: UiKitLabels, options: KitLabelStringsOptions = {}): Record<string, string> {
   const out: Record<string, string> = {};
-  const operator = options.operator && operatorText(options.operator, options.locale);
+  const operator = options.operator && legalOperatorText(options.operator, options.locale);
   const walk = (node: unknown, path: string) => {
     if (typeof node === "string") {
       out[path] = node;
@@ -76,10 +76,6 @@ export interface KitLabelStringsOptions {
   locale?: string;
 }
 
-function operatorText(operator: LegalOperator, locale = "en"): LegalOperatorText {
-  return { ...operator, country: countryName(operator.country, locale) };
-}
-
 function render(label: (...args: unknown[]) => unknown, args: readonly unknown[]): string {
   try {
     return String(label(...args));
@@ -112,6 +108,7 @@ const LEGAL_OPERATOR_SAMPLE: LegalOperatorText = Object.freeze({
   region: "{{region}}",
   country: "{{country}}",
   email: "{{email}}",
+  bindingLanguage: "{{bindingLanguage}}",
 });
 const operatorSample = [[LEGAL_OPERATOR_SAMPLE]] as const;
 
@@ -293,4 +290,8 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "legal.sections.privacy.controller.body": operatorSample,
   "legal.sections.privacy.contact.body": operatorSample,
   "legal.sections.terms.law.body": operatorSample,
+  // 0.28.1: the binding language, named in the reader's language.
+  "legal.sections.terms.language.body": operatorSample,
+  "legal.translation.note": operatorSample,
+  "legal.translation.show": operatorSample,
 };

package/src/index.ts

@@ -462,7 +462,16 @@ export type {
 // The legal pages' shell (0.19, H10): Imprint, Privacy Policy, Terms in every app.
 // 0.28 (docs/legal-harmonization.md): the shared wording, the page frame, the kit's
 // sections, the public footer and the terms checkbox.
-export { LegalLayout, LegalSection, LegalLinks, LegalFooter, DEFAULT_LEGAL_LABELS } from "./components/legal";
+export {
+  LegalLayout,
+  LegalSection,
+  LegalLinks,
+  LegalFooter,
+  DEFAULT_LEGAL_LABELS,
+  LEGAL_HREFS,
+  legalOperatorText,
+  useLegalLabels,
+} from "./components/legal";
 export type {
   LegalLabels,
   LegalLink,