@eifi1/ui-kit 0.48.2 → 0.49.0

package/dist/i18n/kit-labels.d.ts

@@ -254,6 +254,9 @@ export interface TopBarLabels {
     theme: string;
     palette: string;
     language: string;
+    /** 0.49 KIT-10: the language menu's trigger, given the current language's name —
+     *  "Choose language, current: Deutsch". */
+    languageCurrent: (name: string) => string;
     switchRole: string;
     /** The role switcher's tooltip, given the active role's name. */
     role: (value: string) => string;
@@ -623,6 +626,25 @@ export interface UiKitProviderProps {
      * it names in every zone). Left out, timestamps follow the device, as before.
      */
     timeZone?: string;
+    /**
+     * 0.49 KIT-9: how `useDocumentTitle` and every `PageHeader`'s `h1` write the window's
+     * title, from `{page}`, `{section}` and `{app}`. Default
+     * `"{page} · {section} · {app}"` (`DEFAULT_DOCUMENT_TITLE_FORMAT`); a missing part
+     * drops with its separator.
+     */
+    documentTitleFormat?: string;
+    /** 0.49 KIT-9: the app's name, the `{app}` of the window's title ("Kastlan"). Left
+     *  out, titles end at the page or section. */
+    appName?: string;
+    /**
+     * 0.49 KIT-1b: while a person copies a selection in the page, a U+2212 minus standing
+     * before a number ("−CHF 1,250.50") goes to the clipboard as "-", in `text/plain` and
+     * `text/html` (what Excel pastes), so a spreadsheet reads a number; the page keeps "−".
+     * A copy out of an input, a textarea or an editable element is left alone. Installed
+     * once per document, by the first provider that has it on. Default `true`; `false` on
+     * the outermost provider leaves the clipboard to the browser.
+     */
+    copyAsciiMinus?: boolean;
     children: ReactNode;
 }
 /**
@@ -633,7 +655,7 @@ export interface UiKitProviderProps {
  * it names, so a page can re-label one table's `dataTable.table` without restating
  * the language.
  */
-export declare function UiKitProvider({ labels, locale, weekStartsOn, linkComponent, chartTooltipPlacement, formatDate, tableStorageKeyPrefix, timeZone, children, }: UiKitProviderProps): import("react").JSX.Element;
+export declare function UiKitProvider({ labels, locale, weekStartsOn, linkComponent, chartTooltipPlacement, formatDate, tableStorageKeyPrefix, timeZone, documentTitleFormat, appName, copyAsciiMinus, children, }: UiKitProviderProps): import("react").JSX.Element;
 /**
  * What the nearest provider says about one namespace — `undefined` outside one. Nested
  * providers' words come merged, at every depth; no English default is filled in.
@@ -677,6 +699,14 @@ export declare function useKitTableStorageKeyPrefix(): string | undefined;
 /** The nearest provider's `timeZone` (0.46), or `undefined` — the device's. A call's own
  *  `timeZone` wins over it. */
 export declare function useKitTimeZone(): string | undefined;
+/** The nearest provider's `documentTitleFormat` and `appName`, or `undefined` each —
+ *  what `useDocumentTitle` writes with (the format's default is
+ *  `DEFAULT_DOCUMENT_TITLE_FORMAT`, applied there: this module reaches nothing outside
+ *  i18n/). */
+export declare function useKitDocumentTitle(): {
+    format: string | undefined;
+    appName: string | undefined;
+};
 /** {@link DEFAULT_FILE_LABELS}, but formatting in the provider's locale. */
 export declare function useKitFileLabels(prop?: Partial<FileLabels>): FileLabels;
 /**

package/dist/i18n/kit-labels.js

@@ -25,6 +25,9 @@ function UiKitProvider({
   formatDate,
   tableStorageKeyPrefix,
   timeZone,
+  documentTitleFormat,
+  appName,
+  copyAsciiMinus = true,
   children
 }) {
   const outer = useContext(KitI18nContext);
@@ -37,11 +40,26 @@ function UiKitProvider({
       chartTooltipPlacement: chartTooltipPlacement ?? outer.chartTooltipPlacement,
       formatDate: formatDate ?? outer.formatDate,
       tableStorageKeyPrefix: tableStorageKeyPrefix ?? outer.tableStorageKeyPrefix,
-      timeZone: timeZone ?? outer.timeZone
+      timeZone: timeZone ?? outer.timeZone,
+      documentTitleFormat: documentTitleFormat ?? outer.documentTitleFormat,
+      appName: appName ?? outer.appName
     }),
-    [outer, labels, locale, weekStartsOn, linkComponent, chartTooltipPlacement, formatDate, tableStorageKeyPrefix, timeZone]
+    [
+      outer,
+      labels,
+      locale,
+      weekStartsOn,
+      linkComponent,
+      chartTooltipPlacement,
+      formatDate,
+      tableStorageKeyPrefix,
+      timeZone,
+      documentTitleFormat,
+      appName
+    ]
   );
   useTableViewsJoin(value.tableStorageKeyPrefix ?? DEFAULT_TABLE_STORAGE_KEY_PREFIX);
+  useClipboardMinus(copyAsciiMinus);
   return /* @__PURE__ */ jsx(KitI18nContext.Provider, { value, children });
 }
 const DEFAULT_TABLE_STORAGE_KEY_PREFIX = "hbui-table:";
@@ -63,6 +81,24 @@ function useTableViewsJoin(prefix) {
     };
   }, [prefix]);
 }
+function useClipboardMinus(on) {
+  useEffect(() => {
+    if (!on || typeof document === "undefined") return;
+    let uninstall;
+    let gone = false;
+    import("../lib/clipboard-minus.js").then(
+      ({ installClipboardMinus }) => {
+        if (!gone) uninstall = installClipboardMinus(document);
+      },
+      // Not loaded: copying works as the browser does it.
+      () => void 0
+    );
+    return () => {
+      gone = true;
+      uninstall?.();
+    };
+  }, [on]);
+}
 function isRecord(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -120,6 +156,10 @@ function useKitTableStorageKeyPrefix() {
 function useKitTimeZone() {
   return useContext(KitI18nContext).timeZone;
 }
+function useKitDocumentTitle() {
+  const { documentTitleFormat, appName } = useContext(KitI18nContext);
+  return { format: documentTitleFormat, appName };
+}
 function useKitFileLabels(prop) {
   const locale = useKitLocale();
   const defaults = useMemo(
@@ -167,6 +207,7 @@ export {
   missingKitLabels,
   useKitChartTooltipPlacement,
   useKitDateFormatter,
+  useKitDocumentTitle,
   useKitFileLabels,
   useKitLabelOverrides,
   useKitLabels,

package/dist/i18n/kit-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/i18n/kit-labels.tsx"],"sourcesContent":["import { createContext, useContext, useEffect, useMemo } from \"react\";\nimport {\n  DEFAULT_APP_SHELL_LABELS,\n  DEFAULT_CALCULATOR_LABELS,\n  DEFAULT_COMBOBOX_LABELS,\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  DEFAULT_DATE_PICKER_LABELS,\n  DEFAULT_FILE_LABELS,\n  DEFAULT_MULTI_SELECT_LABELS,\n  DEFAULT_PICKER_SHEET_LABELS,\n  DEFAULT_SWIPEABLE_ROW_LABELS,\n  DEFAULT_TOP_BAR_LABELS,\n  formatFileSize,\n} from \"./shared-labels\";\nimport type { AnchorHTMLAttributes, ReactElement, Ref } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { DataTableLabels } from \"../components/data-table-labels\";\nimport type { MiniCalendarLabels, WeekDay } from \"../components/mini-calendar\";\nimport type { CalendarHeatmapLabels } from \"../components/calendar-heatmap\";\nimport type { PopoverLabels } from \"../components/popover\";\nimport type { ChipInputLabels } from \"../components/chip\";\nimport type { FieldSyncLabels } from \"../components/field-sync\";\nimport type { CharacterCountLabels, PasswordRevealLabels } from \"../components/field-base\";\nimport type { TabsLabels } from \"../components/tabs\";\nimport type { WizardLabels } from \"../wizard/types\";\nimport type { TourLabels } from \"../tour/tour\";\nimport type { TourCatalogueLabels } from \"../tour/tour-catalogue-labels\";\nimport type { CommandPaletteLabels } from \"../search/command-palette\";\nimport type { GlobalSearchLabels } from \"../search/global-search\";\nimport type { MonthPickerLabels } from \"../components/month-picker\";\nimport type { PageContentsLabels } from \"../components/page-contents\";\nimport type { SeriesChartLabels } from \"../components/series-chart-labels\";\nimport type { PieChartLabels } from \"../components/pie-chart-labels\";\nimport type { SparklineLabels } from \"../components/sparkline\";\nimport type { StatTileLabels } from \"../components/stat-tile\";\nimport type { SignaturePadLabels } from \"../components/signature-pad\";\nimport type { PasswordStrengthLabels } from \"../components/password-strength\";\nimport type { DangerConfirmLabels } from \"../components/danger-confirm\";\nimport type { SwatchPickerLabels } from \"../components/swatch-picker\";\nimport type { IconPickerLabels } from \"../components/icon-picker\";\nimport type { DialogFrameLabels } from \"../components/dialog-frame\";\nimport type { FilePickerLabels } from \"../components/file-button\";\nimport type { MeasuredGridLabels } from \"../components/measured-grid\";\nimport type { FeedbackAttachmentFieldLabels } from \"../feedback/feedback-attachment\";\nimport type { FeedbackDialogTextLabels } from \"../feedback/feedback-dialog\";\nimport type { FeedbackComposerLabels, FeedbackThreadLabels } from \"../feedback/feedback-thread\";\nimport type {\n  FeedbackCategoryLabels,\n  FeedbackStatusLabels,\n  FeedbackToastLabels,\n} from \"../feedback/feedback-labels\";\nimport type { FeedbackMenuLabels } from \"../feedback/feedback-menu\";\nimport type { FeedbackPublicLabels } from \"../feedback/feedback-public-labels\";\nimport type { FeedbackNotificationTypesLabels } from \"../notifications/feedback-notification-types-labels\";\nimport type { FeedbackContextLabels } from \"../feedback/feedback-context\";\nimport type { FeedbackPageLabels } from \"../feedback/feedback-table\";\nimport type { FeedbackDetailLabels } from \"../feedback/feedback-row-detail\";\nimport type { FeedbackVoteLabels } from \"../feedback/feedback-vote-button\";\nimport type { FeedbackCommentsLabels } from \"../feedback/feedback-comment-thread\";\nimport type { FeedbackRepliesLabels } from \"../feedback/feedback-replies\";\nimport type { AccountSettingsLabels } from \"../account/account-settings-labels\";\nimport type { ConfirmDialogLabels } from \"../components/confirm-dialog\";\nimport type { FloatingPanelLabels } from \"../components/floating-panel\";\nimport type { CopyButtonLabels } from \"../components/copy-button\";\nimport type { BulkActionBarLabels } from \"../components/bulk-action-bar\";\nimport type { ListLabels } from \"../components/list\";\nimport type { BreadcrumbsLabels } from \"../components/breadcrumbs\";\nimport type { ToastLabels } from \"../components/toast\";\nimport type { FormActionsLabels } from \"../components/form-actions\";\nimport type { DescriptionListLabels } from \"../components/description-list\";\nimport type { LineItemsLabels } from \"../components/line-items\";\nimport type { ProgressBarLabels } from \"../components/progress-bar\";\nimport type { SignedAmountLabels } from \"../components/signed-amount\";\nimport type { ErrorBoundaryLabels } from \"../components/error-boundary\";\nimport type { AuthedImageLabels } from \"../components/authed-image\";\nimport type { ImageGridLabels } from \"../components/image-grid\";\nimport type { LightboxLabels } from \"../components/lightbox\";\nimport type { WriteLockLabels } from \"../components/write-lock\";\nimport type { LegalLabels } from \"../components/legal\";\nimport type { SignInLabels } from \"../auth/sign-in-form\";\nimport type { RegisterLabels } from \"../auth/register-form\";\nimport type { CompleteNameLabels } from \"../auth/complete-name-dialog\";\nimport type { ForgotPasswordLabels } from \"../auth/forgot-password-form\";\nimport type { ResetPasswordLabels } from \"../auth/reset-password-form\";\nimport type { VerifyEmailLabels } from \"../auth/verify-email\";\nimport type { NotFoundLabels } from \"../auth/not-found-page\";\nimport type { AcceptInvitationLabels } from \"../auth/accept-invitation\";\nimport type { CompanySwitcherLabels } from \"../shell/company-switcher\";\nimport type { EmailChangeLabels } from \"../account/email-change-setting\";\nimport type { SessionsLabels } from \"../account/sessions-setting\";\nimport type { DeleteAccountLabels } from \"../account/delete-account-setting\";\nimport type { DataExportLabels } from \"../account/data-export-setting\";\nimport type { UserRosterLabels } from \"../admin/user-roster\";\nimport type { RoleSelectLabels } from \"../admin/role-select\";\nimport type { ReviewerScopeLabels } from \"../admin/reviewer-scope-editor\";\nimport type { AdminActionLabels } from \"../admin/admin-action-confirm\";\nimport type { AdminActionLogLabels } from \"../admin/admin-action-log\";\nimport type { TransferOwnershipLabels } from \"../admin/transfer-ownership-dialog\";\nimport type { InvitationsLabels } from \"../admin/invitations-panel\";\nimport type { SettingsLabels } from \"../settings/settings-labels\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport type { DemoLabels } from \"../demo/demo-labels\";\nimport type { BillingLabels } from \"../billing/billing-labels\";\nimport type { PlanChangeLabels } from \"../admin/plan-change\";\nimport type { AppearanceLabels } from \"../components/appearance-labels\";\nimport type { DeviceResetLabels } from \"../settings/device-reset-setting\";\nimport type { RowActionsLabels } from \"../components/row-actions\";\nimport type { AppShellMoreLabels } from \"../shell/app-shell\";\nimport type { AccountStateLabels } from \"../components/account-chips\";\nimport type { ShareCardLabels } from \"../components/share-card\";\nimport type { ReauthDialogLabels } from \"../components/reauth-dialog\";\nimport type { ServerWakeLabels } from \"../components/server-wake\";\nimport type { TranslationReviewLabels } from \"../components/translation-review-labels\";\nimport type { CountrySelectLabels } from \"../components/country-select\";\nimport type { InlineEditLabels } from \"../components/inline-edit-field\";\nimport type { IbanInputLabels } from \"../components/iban-input\";\nimport type { PhoneInputLabels } from \"../components/phone-input\";\nimport type { SignChipLabels } from \"../components/sign-chip\";\nimport type { ColumnMapperLabels } from \"../components/column-mapper\";\nimport type { NotificationsLabels } from \"../notifications/notifications-labels\";\nimport type { AdminAreaLabels } from \"../admin/admin-area-labels\";\nimport type { MailTestCardLabels } from \"../admin/mail-test-card\";\nimport type { TopBarPartsLabels } from \"../shell/top-bar-parts-labels\";\nimport type { SignOutPendingDialogLabels } from \"../offline/sign-out-pending-dialog\";\nimport type { PwaUpdatePromptLabels } from \"../offline/pwa-update-prompt\";\nimport type { SharedComputerLabels } from \"../offline/shared-computer\";\n\n/**\n * EVERY string the kit renders, as one typed tree — and an optional provider that\n * hands it to every component at once.\n *\n * WHY THIS EXISTS. The kit renders only labels; it ships seven catalogues (since 0.7.0,\n * `@eifi1/ui-kit/i18n/<code>`); the app decides the language and hands the words in.\n * What was wrong was HOW it had to hand them in —\n * one `labels` prop per component instance, under a different prop name per\n * component (`labels`, `calendarLabels`, `passwordLabels`, `clearLabel`,\n * `searchPlaceholder`, `ariaLabel` …). A translated app therefore rendered English\n * wherever one call site forgot one prop, and nothing told it so: a German showcase\n * still said \"Rows per page\", \"Collapse sidebar\" and \"Popover\" in seven languages.\n *\n * Now there is one key per string, addressed by a dot path (`dataTable.pageSize`,\n * `datePicker.today`), and three sources in a fixed order of precedence:\n *\n *     the component's own prop   >   <UiKitProvider labels>   >   English default\n *\n * A consumer loads a shipped catalogue (`loadUiKitLabels(code)`) or writes its own\n * `UiKitLabels` (or a partial of one), mounts `<UiKitProvider labels={…} locale={…}>`\n * at the root, and every kit component\n * below speaks that language — including the ones nested inside other kit components\n * (the calendar inside the data table's date filter, the popover inside the date\n * picker), which no prop at the outer call site could reach before.\n *\n * Messages that carry a value are FUNCTIONS of that value, never a template to fill:\n * a number glued into an English sentence is untranslatable, because the grammar\n * around it moves with it in most languages.\n */\n\n/* ── Namespaces that had no labels type of their own ─────────────────────── */\n\n/** The words several components share. A component's own namespace wins over these\n *  where both exist; these are what a new component reaches for first. */\nexport interface CommonLabels {\n  close: string;\n  clear: string;\n  search: string;\n  done: string;\n  cancel: string;\n  save: string;\n  back: string;\n  next: string;\n  remove: string;\n  loading: string;\n  noResults: string;\n  /** \"Name: value\" — how a field's accessible name is composed with its value.\n   *  A colon-and-space is not universal punctuation (French puts a space before\n   *  the colon, Chinese uses a full-width one). */\n  fieldValue: (field: string, value: string) => string;\n  /** The × that puts away a banner or a notice (`AlertBanner onDismiss`). Not `close`:\n   *  nothing opened, and \"Close\" on a banner reads as closing the page it sits on. */\n  dismiss: string;\n  /** Read after a link that opens a new tab (`<Button href external>`, TextLink):\n   *  nothing else tells a screen reader the page is about to change tabs. */\n  opensInNewTab: string;\n  /** The name of a field's `help` \"?\" and its panel (round 0.36): \"About “<field>”\", the\n   *  field's label as the argument, quoted so a capitalised label reads as a name — \"About\n   *  “Jerk shape”\" (round 0.37; the other locales quoted it already). A `HelpPopover`\n   *  passed as `help` keeps its own name. */\n  aboutField: (field: string) => string;\n  /** …and of a `help` \"?\" on a field with no label and no `aria-label` to name it by. */\n  help: string;\n  /** 0.48: the toggle that shows the rest of a clamped text (`AlertBanner clampMobile`)… */\n  showMore: string;\n  /** …and folds it back to its one line. */\n  showLess: string;\n}\n\n/** `DatePicker` / `DateRangePicker` chrome. The calendar inside has its own\n *  namespace, `miniCalendar`. */\nexport interface DatePickerLabels {\n  /** Accessible name of the popover panel the calendar opens in. */\n  panel: string;\n  /** The same, for `DateRangePicker`'s panel. */\n  rangePanel: string;\n  clear: string;\n  previousDay: string;\n  nextDay: string;\n  today: string;\n  /** `DateRangePicker commit=\"apply\"`: the button that commits the drafted range. */\n  apply: string;\n  /** …and the one that discards it. */\n  cancel: string;\n  /** Accessible name of `DateRangePicker`'s preset column. */\n  presets: string;\n}\n\n/** The whole combobox family: `Combobox`, `EntityCombobox`,\n *  `MultiEntityCombobox`, `InlineEntityCombobox`, `Autocomplete`. */\nexport interface ComboboxLabels {\n  search: string;\n  noResults: string;\n  clear: string;\n  loading: string;\n  /** The \"add this\" row when free entry is allowed. */\n  create: (query: string) => string;\n  /** Trigger summary once more than one value is picked. */\n  selectedCount: (count: number) => string;\n  /** An async lookup (`loadOptions`) failed. */\n  loadError: string;\n  /** Announced (live region) when the list settles on `count` > 0 rows. */\n  resultCount: (count: number) => string;\n  /** The query is shorter than the `minChars` a lookup needs. */\n  minChars: (count: number) => string;\n}\n\nexport interface MultiSelectLabels {\n  search: string;\n  selectAll: string;\n  clear: string;\n  /** Trigger text when nothing is picked, which a multi-select reads as \"all\". */\n  all: string;\n  /** Trigger summary once some (but not all) values are picked. The English\n   *  default is the bare count, which is what the trigger has always shown. */\n  selectedCount: (count: number) => string;\n}\n\n/** `CalculatorButton` (desktop popover keypad) and `NumberPadSheet` (phone sheet). */\nexport interface CalculatorLabels {\n  /** The button that opens the calculator. */\n  open: string;\n  /** The popover / sheet itself. */\n  panel: string;\n  calculation: string;\n  backspace: string;\n  clear: string;\n  equals: string;\n  /** The primary key of the phone pad — visible text, not an aria-label. */\n  done: string;\n  /** Names of the operator keys and the decimal key. Their glyphs are not names a\n   *  screen reader agrees on — \"÷\" is read as \"division sign\", \"divided by\" or\n   *  nothing at all depending on the reader — so each says what it does. */\n  plus: string;\n  minus: string;\n  times: string;\n  divide: string;\n  decimal: string;\n}\n\n/** `CurrencySelect` and the currency half of `AmountInput`. */\nexport interface CurrencyLabels {\n  currency: string;\n  search: string;\n}\n\nexport interface AppShellLabels {\n  collapse: string;\n  expand: string;\n  /** Accessible name of an inline group's disclosure button (`subNav=\"inline\"`). */\n  toggleGroup: (groupLabel: string) => string;\n}\n\nexport interface TopBarLabels {\n  theme: string;\n  palette: string;\n  language: string;\n  switchRole: string;\n  /** The role switcher's tooltip, given the active role's name. */\n  role: (value: string) => string;\n}\n\nexport interface PickerSheetLabels {\n  close: string;\n  /** The sticky footer button that closes a multi-select sheet once the rows are ticked\n   *  (0.40) — the ticks are already applied, so it confirms rather than saves. */\n  done: string;\n}\n\nexport interface SwipeableRowLabels {\n  actions: string;\n}\n\nexport interface FileLabels {\n  /** A file size for display, given its size in BYTES. The default uses\n   *  `Intl.NumberFormat`'s unit formatting in the provider's locale. */\n  size: (bytes: number) => string;\n}\n\n/** The complete tree. `UiKitProvider` takes any partial of it. */\nexport interface UiKitLabels {\n  common: CommonLabels;\n  dataTable: DataTableLabels;\n  miniCalendar: MiniCalendarLabels;\n  calendarHeatmap: CalendarHeatmapLabels;\n  datePicker: DatePickerLabels;\n  monthPicker: MonthPickerLabels;\n  popover: PopoverLabels;\n  combobox: ComboboxLabels;\n  multiSelect: MultiSelectLabels;\n  calculator: CalculatorLabels;\n  currency: CurrencyLabels;\n  chipInput: ChipInputLabels;\n  fieldSync: FieldSyncLabels;\n  passwordReveal: PasswordRevealLabels;\n  tabs: TabsLabels;\n  appShell: AppShellLabels;\n  pageContents: PageContentsLabels;\n  topBar: TopBarLabels;\n  pickerSheet: PickerSheetLabels;\n  swipeableRow: SwipeableRowLabels;\n  file: FileLabels;\n  wizard: WizardLabels;\n  tour: TourLabels;\n  /** 0.43.0: the tours page — `TourCatalogue` and its card (docs/tours-harmonization.md §3). */\n  tourCatalogue: TourCatalogueLabels;\n  commandPalette: CommandPaletteLabels;\n  globalSearch: GlobalSearchLabels;\n  seriesChart: SeriesChartLabels;\n  pieChart: PieChartLabels;\n  sparkline: SparklineLabels;\n  statTile: StatTileLabels;\n  signaturePad: SignaturePadLabels;\n  passwordStrength: PasswordStrengthLabels;\n  dangerConfirm: DangerConfirmLabels;\n  swatchPicker: SwatchPickerLabels;\n  iconPicker: IconPickerLabels;\n  dialogFrame: DialogFrameLabels;\n  filePicker: FilePickerLabels;\n  measuredGrid: MeasuredGridLabels;\n  feedbackAttachment: FeedbackAttachmentFieldLabels;\n  /** 0.12.0: `FeedbackDialog`'s own strings; `FeedbackThread` / `FeedbackComposer`. */\n  feedbackDialog: FeedbackDialogTextLabels;\n  feedbackThread: FeedbackThreadLabels;\n  feedbackComposer: FeedbackComposerLabels;\n  /** 0.27.0: the feedback harmonisation (docs/feedback-harmonization.md §4) — a report's\n   *  status and category words, keyed by the enum value; the toasts a feedback page\n   *  shows; `FeedbackMenu`; `FeedbackContextBox`; the two pages' table; the row detail.\n   *  keksdose's wording is the canon, in every language. */\n  feedbackStatus: FeedbackStatusLabels;\n  feedbackCategory: FeedbackCategoryLabels;\n  feedbackToast: FeedbackToastLabels;\n  feedbackMenu: FeedbackMenuLabels;\n  /** 0.38.0: the public feedback pages — `FeedbackPublicList`, `FeedbackPublicDetail`,\n   *  `FeedbackPublicSwitch` (docs/feedback-harmonization.md §9.15). */\n  feedbackPublic: FeedbackPublicLabels;\n  /** 0.38.0: `useFeedbackNotificationTypes` — the two feedback types' setting words\n   *  (§9.11). */\n  feedbackNotificationTypes: FeedbackNotificationTypesLabels;\n  feedbackContext: FeedbackContextLabels;\n  feedbackPage: FeedbackPageLabels;\n  feedbackDetail: FeedbackDetailLabels;\n  /** 0.38.0: public feedback (docs/feedback-harmonization.md §9.15) — the vote button,\n   *  the comment thread, the replies' timeline and composer. */\n  feedbackVote: FeedbackVoteLabels;\n  feedbackComments: FeedbackCommentsLabels;\n  feedbackReplies: FeedbackRepliesLabels;\n  /** 0.12.0: `ProfileSetting`, `PasswordSetting`, `TwoFactorSetting`, `PasskeysSetting`\n   *  — one record per section. The provider takes a whole section record; the\n   *  components merge it key by key, as a prop. */\n  accountSettings: AccountSettingsLabels;\n  confirmDialog: ConfirmDialogLabels;\n  floatingPanel: FloatingPanelLabels;\n  copyButton: CopyButtonLabels;\n  bulkActionBar: BulkActionBarLabels;\n  list: ListLabels;\n  breadcrumbs: BreadcrumbsLabels;\n  toast: ToastLabels;\n  form: FormActionsLabels;\n  descriptionList: DescriptionListLabels;\n  lineItems: LineItemsLabels;\n  progressBar: ProgressBarLabels;\n  signedAmount: SignedAmountLabels;\n  errorBoundary: ErrorBoundaryLabels;\n  authedImage: AuthedImageLabels;\n  imageGrid: ImageGridLabels;\n  lightbox: LightboxLabels;\n  /** 0.18.0: `WriteLockProvider`'s fallback reason, `AccountStateChip`, `SharePanel` /\n   *  `ShareCard` / `ShareDialog`, `ReauthDialog`. */\n  writeLock: WriteLockLabels;\n  accountState: AccountStateLabels;\n  shareCard: ShareCardLabels;\n  reauthDialog: ReauthDialogLabels;\n  /** 0.18.0: `ServerWakeNotice` — keksdose's cold-start notice, for every app. */\n  serverWake: ServerWakeLabels;\n  /** 0.19.0: the translation-review parts (`TranslationReviewPanel`, its editor, chip,\n   *  progress, locale tabs and export) — keksdose's /translations, for every app. */\n  translationReview: TranslationReviewLabels;\n  /** 0.19.0: `LegalLinks`' navigation name. 0.28.0: every kit-owned word of the legal\n   *  pages — the link labels, titles, back link, terms checkbox and notices, and the\n   *  sections that are the same in every app, filled in with the app's operator\n   *  (docs/legal-harmonization.md §4.3/§4.4). */\n  legal: LegalLabels;\n  /** 0.29.0: sign-in form: credentials, passkey, 2FA, forced new password (docs/auth-harmonization.md §5). */\n  signIn: SignInLabels;\n  /** 0.29.0: the sign-up form, with the +app address tag (§4.1, §4.5). */\n  register: RegisterLabels;\n  /** 0.29.0: asking a migrated account for first and last name once (§3.3). */\n  completeName: CompleteNameLabels;\n  /** 0.29.0: requesting a reset link (always the same answer). */\n  forgotPassword: ForgotPasswordLabels;\n  /** 0.29.0: choosing a new password from a reset link; not a sign-in (§6.3). */\n  resetPassword: ResetPasswordLabels;\n  /** 0.29.0: the verify-email page and the unverified banner. */\n  verifyEmail: VerifyEmailLabels;\n  /** 0.29.0: the 404 page. */\n  notFound: NotFoundLabels;\n  /** 0.29.0: accepting an invitation with an account (§4.4). */\n  acceptInvitation: AcceptInvitationLabels;\n  /** 0.29.0: kastlan's switcher between a user's companies (§5.3). */\n  companySwitcher: CompanySwitcherLabels;\n  /** 0.30.0: changing the account's address with re-verification (docs/user-admin-harmonization.md §6.2). */\n  emailChange: EmailChangeLabels;\n  /** 0.30.0: sign out everywhere, and kastlan's device list (§6.3). */\n  sessions: SessionsLabels;\n  /** 0.30.0: deletion in two stages (§6.4). */\n  deleteAccount: DeleteAccountLabels;\n  /** 0.30.0: the self-service JSON export (§6.5). */\n  dataExport: DataExportLabels;\n  /** 0.30.0: the admin user list's columns (§3). */\n  userRoster: UserRosterLabels;\n  /** 0.30.0: picking one or several roles, with the reasons a choice is locked (§4.1). */\n  roleSelect: RoleSelectLabels;\n  /** 0.30.0: a translation reviewer's languages and areas. */\n  reviewerScope: ReviewerScopeLabels;\n  /** 0.30.0: an admin action's confirmation and refusals (§4.2). */\n  adminAction: AdminActionLabels;\n  /** 0.30.0: the admin_actions list (§4.3). */\n  adminActionLog: AdminActionLogLabels;\n  /** 0.30.0: handing an account's work to another (Kurvenschmiede). */\n  transferOwnership: TransferOwnershipLabels;\n  /** 0.30.0: the invitations panel (§5). */\n  invitations: InvitationsLabels;\n  /** 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §4.3). */\n  settings: SettingsLabels;\n  /** 0.31.0: the public landing page's kit words (docs/landing-demo-harmonization.md §4). */\n  landing: LandingLabels;\n  /** 0.31.0: the demo's start, banner and end (§5). */\n  demo: DemoLabels;\n  /** 0.32.0: plans, standing, banners and the limit notice (docs/billing-harmonization.md §7). */\n  billing: BillingLabels;\n  /** 0.33.0: the operator's plan parts — `planColumn`, `PlanChangeConfirm` and the\n   *  lines of `usePlanChangeResult` (docs/billing-harmonization.md §14.12). */\n  planChange: PlanChangeLabels;\n  /** 0.32.0: the text-size and contrast settings (docs/text-size-harmonization.md §6). */\n  appearance: AppearanceLabels;\n  /** 0.36.0: resetting this device's settings, the appearance group's last card\n   *  (docs/settings-harmonization.md §11.3). */\n  deviceReset: DeviceResetLabels;\n  /** 0.32.0: a row's actions folded into a \"⋯\" menu at Large (text size §10.8). */\n  rowActions: RowActionsLabels;\n  /** 0.32.0: the phone bar's \"More\" cell and sheet (text size §10.7). */\n  appShellMore: AppShellMoreLabels;\n  /** 0.22.0: the screen-reader words of `Input` / `Textarea`'s `showCount` counter. */\n  characterCount: CharacterCountLabels;\n  /** 0.22.0: `CountrySelect`. Its list's \"no results\" and counts are `combobox`'s. */\n  countrySelect: CountrySelectLabels;\n  /** 0.22.0: `InlineEditField` — keksdose K9. */\n  inlineEdit: InlineEditLabels;\n  /** 0.22.0: `IbanInput`'s messages, one per problem. */\n  ibanInput: IbanInputLabels;\n  /** 0.22.0: `PhoneInput`'s country-code select. */\n  phoneInput: PhoneInputLabels;\n  /** 0.22.0: `SignChip` — the outflow / inflow toggle beside an amount. */\n  signChip: SignChipLabels;\n  /** 0.23.0: `ColumnMapper` / `ColumnRoleTable` — a pasted or dropped table, a role per\n   *  column. */\n  columnMapper: ColumnMapperLabels;\n  /** 0.36.0: the notification cards — the types, quiet hours and the zone picker, this\n   *  device's push, the device list, and the unsubscribe page\n   *  (docs/notifications-harmonization.md §4.2). */\n  notifications: NotificationsLabels;\n  /** 0.42.0: the admin area's shared words — the account menu's \"Administration\" row, the\n   *  403 page, the shared sections, the overview's tiles and the Tools list\n   *  (docs/admin-harmonization.md §3.1). */\n  adminArea: AdminAreaLabels;\n  /** 0.42.0: the top bar's shared parts — `TourMenu`, `SyncStatusIndicator`, `DevSwitchers`\n   *  (docs/top-bar-harmonization.md §3.1). */\n  topBarParts: TopBarPartsLabels;\n  /** 0.45.0: \"Send a test mail to me\" (docs/admin-harmonization.md §9.2.4). */\n  mailTestCard: MailTestCardLabels;\n  /** 0.45.0: the sign-out question while changes wait to sync (`@eifi1/ui-kit/offline`,\n   *  docs/local-first-harmonization.md §1.6). */\n  signOutPending: SignOutPendingDialogLabels;\n  /** 0.45.0: the service-worker update toast (local-first §1.5 D8). */\n  pwaUpdate: PwaUpdatePromptLabels;\n  /** 0.45.0: \"This is a shared computer\" on the sign-in form (local-first §1.5 D6). */\n  sharedComputer: SharedComputerLabels;\n}\n\n/**\n * A label override, as deep as the labels go: an object of labels (a namespace, or a\n * record inside one such as `accountSettings.passkeys` or `dataTable.presets`) may be\n * partial at every level, because the provider merges it key by key at every level.\n * A leaf stays as it is: a string, a function-valued label (`(n) => …`), and anything\n * that is not purely an object (a `ReactNode` union) is given whole.\n */\nexport type LabelOverride<T> = [T] extends [(...args: never[]) => unknown]\n  ? T\n  : [T] extends [readonly unknown[]]\n    ? T\n    : [T] extends [object]\n      ? { [K in keyof T]?: LabelOverride<T[K]> }\n      : T;\n\n/** Any subset of the tree — each namespace may be partial, and so may any record\n *  inside one (`accountSettings.passkeys`, `dataTable.presets`): they are merged key\n *  by key, at every depth. */\nexport type UiKitLabelOverrides = { [K in keyof UiKitLabels]?: LabelOverride<UiKitLabels[K]> };\n\n/* ── English defaults for the namespaces defined here ────────────────────── */\n\n// They live in ./shared-labels, a module of words, as every component's defaults live in\n// its `*-labels.ts` (round 0.34). Imported and exported as this module's own, as each\n// component does with its defaults: the names, and where the README lists them, stay.\nexport {\n  DEFAULT_APP_SHELL_LABELS,\n  DEFAULT_CALCULATOR_LABELS,\n  DEFAULT_COMBOBOX_LABELS,\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  DEFAULT_DATE_PICKER_LABELS,\n  DEFAULT_FILE_LABELS,\n  DEFAULT_MULTI_SELECT_LABELS,\n  DEFAULT_PICKER_SHEET_LABELS,\n  DEFAULT_SWIPEABLE_ROW_LABELS,\n  DEFAULT_TOP_BAR_LABELS,\n  formatFileSize,\n};\n\n/* ── The provider ────────────────────────────────────────────────────────── */\n\ninterface KitI18n {\n  labels?: UiKitLabelOverrides;\n  locale?: string;\n  weekStartsOn?: WeekDay;\n  linkComponent?: KitLinkComponent;\n  chartTooltipPlacement?: ChartTooltipPlacement;\n  formatDate?: KitDateFormatter;\n  tableStorageKeyPrefix?: string;\n  timeZone?: string;\n}\n\n/** What a {@link KitDateFormatter} is told about the date it is formatting. */\nexport interface KitDateFormatContext {\n  /**\n   * How much of a date the string is: `\"day\"` — the `iso` is `\"YYYY-MM-DD\"`; `\"month\"` —\n   * `\"YYYY-MM\"` (a `MonthPicker`); `\"year\"` — `\"YYYY\"` (`MonthPicker mode=\"year\"`).\n   */\n  unit: \"day\" | \"month\" | \"year\";\n  /** Which kit surface asks: the trigger of a `DatePicker`, of a `DateRangePicker`\n   *  (called once per end), of a `MonthPicker`, or a `DateMark`. */\n  source: \"datePicker\" | \"dateRangePicker\" | \"monthPicker\" | \"dateMark\";\n  /** The locale the kit would have formatted in — the component's `locale` prop, else\n   *  the provider's — or `undefined` for the runtime's. */\n  locale: string | undefined;\n  /**\n   * The kit's suggestion: whether this date stands alone where the day of the week\n   * helps — `true` for a `DatePicker`'s trigger and a `DateMark`, `false` for the two\n   * ends of a range (twice the width, in a sentence-like \"from – to\") and for a month\n   * or a year. keksdose's rule, which this follows: *\"A date in a COLUMN carries the\n   * weekday. A date in a SENTENCE does not.\"* (date-cell.tsx, dev#546). A formatter\n   * is free to ignore it.\n   */\n  weekday: boolean;\n}\n\n/**\n * The app's ONE answer to \"what does a date look like here\" — keksdose K12. Returns the\n * text for an ISO date (see {@link KitDateFormatContext.unit} for the three shapes).\n * Return `\"\"` to fall back to the kit's own formatting for that date.\n */\nexport type KitDateFormatter = (iso: string, context: KitDateFormatContext) => string;\n\n/** Where a chart shows the values under the pointer — see `SeriesChartTooltip.placement`. */\nexport type ChartTooltipPlacement = \"cursor\" | \"above\" | \"below\" | \"auto\";\n\n/**\n * What every kit link receives: the anchor attributes the kit decided (href, class,\n * aria-current, handlers, children, ref). An app's router link maps them —\n * `({ href, ...p }) => <Link to={href} {...p} />` — ONCE, on the provider.\n *\n * `replace` is the one prop that is not an anchor attribute: see there. Map it\n * explicitly if your router link is not react-router's —\n * `({ href, replace, ...p }) => <Link to={href} replace={replace} {...p} />` — and never\n * spread it onto a DOM `<a>`, where React warns about an unknown attribute.\n */\nexport type KitLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {\n  href: string;\n  ref?: Ref<HTMLAnchorElement>;\n  /**\n   * Navigate by REPLACING the current history entry, so Back skips it — keksdose F1:\n   * a one-shot URL (a magic-link landing, `?checkout=done`, a wizard's \"finish\" hop)\n   * that must not come back when the user presses Back. Present ONLY when the kit link\n   * was given `replace` (`true`), so a provider link that spreads its props onto a\n   * plain `<a>` keeps working for every link that never asks for it. react-router's\n   * `<Link>` takes the same prop, so `({ href, ...p }) => <Link to={href} {...p} />`\n   * honours it with no change; any other router maps it to its own replace option.\n   * The kit never puts it on a DOM element itself.\n   */\n  replace?: boolean;\n};\nexport type KitLinkComponent = (props: KitLinkProps) => ReactElement;\n\nconst KitI18nContext = createContext<KitI18n>({});\n\nexport interface UiKitProviderProps {\n  /** Any part of {@link UiKitLabels}. Missing keys fall back to English. */\n  labels?: UiKitLabelOverrides;\n  /**\n   * BCP 47 tag used by every kit component that formats something — dates, numbers,\n   * month and weekday names, file sizes — when it is not handed a `locale` prop of\n   * its own. Without a provider, and without a prop, those use the runtime default.\n   */\n  locale?: string;\n  /**\n   * The first day of the week (0 = Sunday, 1 = Monday …) for every calendar below —\n   * `MiniCalendar` and the pickers built on it — that is not handed a `weekStartsOn`\n   * of its own. Without it the week start follows `locale`'s week info.\n   *\n   * Separate from `locale` because the two are separate decisions: a German-built\n   * app running in English (`locale=\"en\"`) would otherwise start its weeks on Sunday,\n   * and switching it to `en-GB` to get Monday changes every date and number format.\n   */\n  weekStartsOn?: WeekDay;\n  /**\n   * The app's router link, used by every kit component that renders an in-app link\n   * and was not handed its own `renderLink` — so `renderLink` stops being repeated on\n   * each ListItem, Breadcrumbs, StatTile, Chip… (kastlan). A component's own\n   * `renderLink` wins; external links and in-page `#anchor`s stay plain `<a>`, and a\n   * hash-router `#/path` is handed to it like `/path` (see `pickLinkRenderer`).\n   */\n  linkComponent?: KitLinkComponent;\n  /**\n   * Where every `SeriesChart` below shows its tooltip when it does not say so itself\n   * (`tooltip.placement`) — set once so an app's phone charts stop putting the box under\n   * the reader's finger (keksdose #359). Default: `\"cursor\"`, the box that follows the\n   * pointer, as before.\n   */\n  chartTooltipPlacement?: ChartTooltipPlacement;\n  /**\n   * How every kit date below is written, when the component is not told otherwise —\n   * keksdose K12. keksdose has a date-format preference (Settings ▸ date format, feedback\n   * #180) that is not the UI language, and a weekday in the UI language beside digits\n   * in the preference's order (live #246, dev#546): two locales in one string, which\n   * no `locale` + `Intl` options can say. Its `DateField` wraps every `DatePicker` to\n   * pass `formatValue`, and its report range field formats both ends by hand; with this\n   * set once on the provider, those wrappers thin to nothing.\n   *\n   * Used for the trigger text of `DatePicker`, `DateRangePicker` and `MonthPicker`\n   * (month and year mode), and for `DateMark display=\"date\"`. A component's own\n   * `formatValue` or `formatOptions` (`dateStyle` on a DateMark) wins: prop >\n   * provider > the kit's `Intl` default, the order every kit setting resolves in. Left\n   * out (or returning `\"\"`), everything formats exactly as before.\n   *\n   * Keep it stable (`useCallback`, or a module function): it is in the provider's\n   * context value, so a new function every render re-renders every consumer.\n   */\n  formatDate?: KitDateFormatter;\n  /**\n   * The `localStorage` prefix every kit table below keeps its view under (sort, filters,\n   * page size, widths, hidden columns), when the table is not handed a\n   * `storageKeyPrefix` of its own — round 0.34 C5, KS U4. Left out, it is the kit's\n   * `\"hbui-table:\"`, as before.\n   *\n   * Set once here rather than per table because not every table is the app's to pass a\n   * prop to: `TranslationReviewPanel` wraps a `DataTable`, and until this the panel's\n   * view landed under the kit's prefix whatever the app's was — so an app that lists\n   * what it stores (a privacy page) had to list the kit's prefix as a key of its own.\n   * Resolves like every kit setting: the table's own prop > this > the default. The\n   * key is the prefix plus the table's `storageKey`, verbatim, so an app that wrapped\n   * `DataTable` to pass its prefix (Keksdose's `keksdose-table:`) keeps every stored\n   * view when it moves the prefix here.\n   */\n  tableStorageKeyPrefix?: string;\n  /**\n   * 0.46 (docs/notifications-harmonization.md §10.3): the IANA zone (\"Europe/Zurich\") every\n   * TIMESTAMP below is shown in through `useKitFormat().formatDate` /\n   * `formatRelativeTime`, when the call names none — the account's picked zone, for an app\n   * that shows times in it. A bare \"YYYY-MM-DD\" is never shifted (a calendar day is the day\n   * it names in every zone). Left out, timestamps follow the device, as before.\n   */\n  timeZone?: string;\n  children: ReactNode;\n}\n\n/**\n * Hand every kit component below this point its strings and its locale.\n *\n * Optional: a component outside any provider behaves exactly as it did before the\n * provider existed. Nesting works as a merge — an inner provider overrides only what\n * it names, so a page can re-label one table's `dataTable.table` without restating\n * the language.\n */\nexport function UiKitProvider({\n  labels,\n  locale,\n  weekStartsOn,\n  linkComponent,\n  chartTooltipPlacement,\n  formatDate,\n  tableStorageKeyPrefix,\n  timeZone,\n  children,\n}: UiKitProviderProps) {\n  const outer = useContext(KitI18nContext);\n  const value = useMemo<KitI18n>(\n    () => ({\n      locale: locale ?? outer.locale,\n      weekStartsOn: weekStartsOn ?? outer.weekStartsOn,\n      labels: mergeOverrides(outer.labels, labels),\n      linkComponent: linkComponent ?? outer.linkComponent,\n      chartTooltipPlacement: chartTooltipPlacement ?? outer.chartTooltipPlacement,\n      formatDate: formatDate ?? outer.formatDate,\n      tableStorageKeyPrefix: tableStorageKeyPrefix ?? outer.tableStorageKeyPrefix,\n      timeZone: timeZone ?? outer.timeZone,\n    }),\n    [outer, labels, locale, weekStartsOn, linkComponent, chartTooltipPlacement, formatDate, tableStorageKeyPrefix, timeZone],\n  );\n  useTableViewsJoin(value.tableStorageKeyPrefix ?? DEFAULT_TABLE_STORAGE_KEY_PREFIX);\n  return <KitI18nContext.Provider value={value}>{children}</KitI18nContext.Provider>;\n}\n\n/** The kit's own table prefix: `DEFAULT_PERSIST_PREFIX` of components/use-table-state,\n *  restated because that module imports the router (a test pins the two equal). */\nconst DEFAULT_TABLE_STORAGE_KEY_PREFIX = \"hbui-table:\";\n\n/**\n * Reset this device's settings (docs/settings-harmonization.md §11.4): the tables below a\n * provider keep their views under its prefix, so the provider joins the registry with\n * that prefix — a view, no `reset`, since a table reads its view when it next mounts —\n * while it is mounted. Nested providers with one prefix hold one entry.\n *\n * Through a literal `import()`, not a static import: every catalogue reaches this module,\n * and a catalogue may reach nothing outside i18n/ (scripts/check-module-graph.mjs,\n * english-catalogue-graph.test.ts). The theme stores and the shell import the registry\n * statically, so it is loaded already and the join lands a microtask after the mount.\n */\nfunction useTableViewsJoin(prefix: string): void {\n  useEffect(() => {\n    let leave: (() => void) | undefined;\n    let gone = false;\n    import(\"../lib/device-settings\").then(\n      ({ registerDeviceSetting }) => {\n        if (!gone) leave = registerDeviceSetting({ key: prefix, prefix: true, kind: \"view\" });\n      },\n      // A module of the kit's own that fails to load has nothing to join; the provider\n      // and its tables work as before.\n      () => undefined,\n    );\n    return () => {\n      gone = true;\n      leave?.();\n    };\n  }, [prefix]);\n}\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n\n/** A record of labels to merge into — not a React element, which is an object too but\n *  is a label given whole. */\nfunction isLabelRecord(v: unknown): v is Record<string, unknown> {\n  return isRecord(v) && !(\"$$typeof\" in v);\n}\n\n/** Merged key by key at EVERY depth — a namespace, a record inside it\n *  (`accountSettings.passkeys`, `dataTable.presets`), and so on down — to match\n *  {@link LabelOverride}. An `undefined` is skipped at every depth, so it never blanks\n *  out what is under it. */\nfunction mergeNamespace<T extends object>(base: T, over: LabelOverride<T> | Partial<T> | undefined): T {\n  if (!over) return base;\n  const out = { ...base } as Record<string, unknown>;\n  for (const [k, v] of Object.entries(over)) {\n    if (v === undefined) continue;\n    const prev = out[k];\n    out[k] = isLabelRecord(prev) && isLabelRecord(v) ? mergeNamespace(prev, v) : v;\n  }\n  return out as T;\n}\n\nfunction mergeOverrides(\n  a: UiKitLabelOverrides | undefined,\n  b: UiKitLabelOverrides | undefined,\n): UiKitLabelOverrides | undefined {\n  if (!a) return b;\n  if (!b) return a;\n  const out: Record<string, unknown> = { ...a };\n  for (const [ns, v] of Object.entries(b)) {\n    out[ns] = mergeNamespace((out[ns] as object | undefined) ?? {}, v as object);\n  }\n  return out as UiKitLabelOverrides;\n}\n\n/**\n * What the nearest provider says about one namespace — `undefined` outside one. Nested\n * providers' words come merged, at every depth; no English default is filled in.\n *\n * A {@link LabelOverride}, partial at every depth, like the components' `labels` props\n * that take it: a provider that names one key of a section (`accountSettings.passkeys`)\n * or one preset (`dataTable.presets`) hands over just that (round 0.35 R3 — until then\n * it was typed partial at the top only, so a nested section read as complete).\n *\n * For a component whose own resolver does more than a merge (the data table derives\n * `columnsCount` from `columns`): merge the component's prop over it — a record key by\n * key — and feed the result to that resolver.\n */\nexport function useKitLabelOverrides<K extends keyof UiKitLabels>(\n  ns: K,\n): LabelOverride<UiKitLabels[K]> | undefined {\n  return useContext(KitI18nContext).labels?.[ns];\n}\n\n/**\n * One namespace, resolved: `defaults`, then the provider, then the component's own\n * `prop`. Record-valued keys are merged key by key at each step — so `prop` is a\n * {@link LabelOverride}, partial at every depth as the provider's labels are, and a\n * component's `labels` prop, typed the same, is handed over without a cast (refactor\n * audit 2026-10, API-9).\n */\nexport function useKitLabels<K extends keyof UiKitLabels>(\n  ns: K,\n  defaults: UiKitLabels[K],\n  prop?: LabelOverride<UiKitLabels[K]>,\n): UiKitLabels[K] {\n  const fromProvider = useKitLabelOverrides(ns);\n  return useMemo(\n    () => mergeNamespace(mergeNamespace(defaults, fromProvider), prop),\n    [defaults, fromProvider, prop],\n  );\n}\n\n/** The component's own `locale` prop, else the provider's, else `undefined` (which\n *  every `Intl` API reads as \"the runtime's default\"). */\nexport function useKitLocale(prop?: string): string | undefined {\n  const fromProvider = useContext(KitI18nContext).locale;\n  return prop ?? fromProvider;\n}\n\n/** The week start the nearest `<UiKitProvider weekStartsOn>` pins, else `undefined`\n *  (the caller then asks the locale). A component's own prop goes first:\n *  `prop ?? useKitWeekStart()`. */\n/** The provider's router link, or `undefined` — a component's own `renderLink` should\n *  win over it: `const Link = renderLink ?? useKitLink()`. */\nexport function useKitLink(): KitLinkComponent | undefined {\n  return useContext(KitI18nContext).linkComponent;\n}\n\nexport function useKitWeekStart(): WeekDay | undefined {\n  return useContext(KitI18nContext).weekStartsOn;\n}\n\n/** The provider's `chartTooltipPlacement`, or `undefined` — a chart's own prop wins. */\nexport function useKitChartTooltipPlacement(): ChartTooltipPlacement | undefined {\n  return useContext(KitI18nContext).chartTooltipPlacement;\n}\n\n/** The nearest provider's `formatDate`, or `undefined` — a component's own\n *  `formatValue` / `formatOptions` wins over it. See {@link KitDateFormatter}. */\nexport function useKitDateFormatter(): KitDateFormatter | undefined {\n  return useContext(KitI18nContext).formatDate;\n}\n\n/** The nearest provider's `tableStorageKeyPrefix`, or `undefined` — a table's own\n *  `storageKeyPrefix` wins over it, and the kit's `\"hbui-table:\"` comes after both. */\nexport function useKitTableStorageKeyPrefix(): string | undefined {\n  return useContext(KitI18nContext).tableStorageKeyPrefix;\n}\n\n/** The nearest provider's `timeZone` (0.46), or `undefined` — the device's. A call's own\n *  `timeZone` wins over it. */\nexport function useKitTimeZone(): string | undefined {\n  return useContext(KitI18nContext).timeZone;\n}\n\n/** {@link DEFAULT_FILE_LABELS}, but formatting in the provider's locale. */\nexport function useKitFileLabels(prop?: Partial<FileLabels>): FileLabels {\n  const locale = useKitLocale();\n  const defaults = useMemo<FileLabels>(\n    () => ({ size: (bytes) => formatFileSize(bytes, locale) }),\n    [locale],\n  );\n  return useKitLabels(\"file\", defaults, prop);\n}\n\n/**\n * The dot paths of every key `labels` does NOT supply — the ones a translated app is\n * still showing in English. Assert on it in the app's own test:\n *\n *     expect(missingKitLabels(labels, DEFAULT_UI_KIT_LABELS)).toEqual([]);\n *\n * `reference` is the complete tree to check against — pass\n * {@link DEFAULT_UI_KIT_LABELS} (src/i18n/defaults.ts). It is a parameter rather than an import\n * because the defaults live beside their components, and this module is imported BY\n * those components. Left out (a test file is not type-checked), it throws saying so\n * rather than \"Cannot convert undefined or null to object\" (keksdose, 0.18).\n */\nexport function missingKitLabels(\n  labels: UiKitLabelOverrides | undefined,\n  reference: UiKitLabels,\n): string[] {\n  if (!isRecord(reference)) {\n    throw new TypeError(\n      \"missingKitLabels(labels, reference): pass DEFAULT_UI_KIT_LABELS as the reference — \" +\n        \"it is the tree the labels are checked against.\",\n    );\n  }\n  const missing: string[] = [];\n  for (const [ns, keys] of Object.entries(reference)) {\n    const given = (labels as Record<string, Record<string, unknown> | undefined> | undefined)?.[ns];\n    for (const [key, value] of Object.entries(keys as Record<string, unknown>)) {\n      const got = given?.[key];\n      if (got === undefined) {\n        missing.push(`${ns}.${key}`);\n      } else if (isRecord(value) && isRecord(got)) {\n        for (const sub of Object.keys(value)) {\n          if (got[sub] === undefined) missing.push(`${ns}.${key}.${sub}`);\n        }\n      }\n    }\n  }\n  return missing;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/i18n/kit-labels.tsx"],"sourcesContent":["import { createContext, useContext, useEffect, useMemo } from \"react\";\nimport {\n  DEFAULT_APP_SHELL_LABELS,\n  DEFAULT_CALCULATOR_LABELS,\n  DEFAULT_COMBOBOX_LABELS,\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  DEFAULT_DATE_PICKER_LABELS,\n  DEFAULT_FILE_LABELS,\n  DEFAULT_MULTI_SELECT_LABELS,\n  DEFAULT_PICKER_SHEET_LABELS,\n  DEFAULT_SWIPEABLE_ROW_LABELS,\n  DEFAULT_TOP_BAR_LABELS,\n  formatFileSize,\n} from \"./shared-labels\";\nimport type { AnchorHTMLAttributes, ReactElement, Ref } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { DataTableLabels } from \"../components/data-table-labels\";\nimport type { MiniCalendarLabels, WeekDay } from \"../components/mini-calendar\";\nimport type { CalendarHeatmapLabels } from \"../components/calendar-heatmap\";\nimport type { PopoverLabels } from \"../components/popover\";\nimport type { ChipInputLabels } from \"../components/chip\";\nimport type { FieldSyncLabels } from \"../components/field-sync\";\nimport type { CharacterCountLabels, PasswordRevealLabels } from \"../components/field-base\";\nimport type { TabsLabels } from \"../components/tabs\";\nimport type { WizardLabels } from \"../wizard/types\";\nimport type { TourLabels } from \"../tour/tour\";\nimport type { TourCatalogueLabels } from \"../tour/tour-catalogue-labels\";\nimport type { CommandPaletteLabels } from \"../search/command-palette\";\nimport type { GlobalSearchLabels } from \"../search/global-search\";\nimport type { MonthPickerLabels } from \"../components/month-picker\";\nimport type { PageContentsLabels } from \"../components/page-contents\";\nimport type { SeriesChartLabels } from \"../components/series-chart-labels\";\nimport type { PieChartLabels } from \"../components/pie-chart-labels\";\nimport type { SparklineLabels } from \"../components/sparkline\";\nimport type { StatTileLabels } from \"../components/stat-tile\";\nimport type { SignaturePadLabels } from \"../components/signature-pad\";\nimport type { PasswordStrengthLabels } from \"../components/password-strength\";\nimport type { DangerConfirmLabels } from \"../components/danger-confirm\";\nimport type { SwatchPickerLabels } from \"../components/swatch-picker\";\nimport type { IconPickerLabels } from \"../components/icon-picker\";\nimport type { DialogFrameLabels } from \"../components/dialog-frame\";\nimport type { FilePickerLabels } from \"../components/file-button\";\nimport type { MeasuredGridLabels } from \"../components/measured-grid\";\nimport type { FeedbackAttachmentFieldLabels } from \"../feedback/feedback-attachment\";\nimport type { FeedbackDialogTextLabels } from \"../feedback/feedback-dialog\";\nimport type { FeedbackComposerLabels, FeedbackThreadLabels } from \"../feedback/feedback-thread\";\nimport type {\n  FeedbackCategoryLabels,\n  FeedbackStatusLabels,\n  FeedbackToastLabels,\n} from \"../feedback/feedback-labels\";\nimport type { FeedbackMenuLabels } from \"../feedback/feedback-menu\";\nimport type { FeedbackPublicLabels } from \"../feedback/feedback-public-labels\";\nimport type { FeedbackNotificationTypesLabels } from \"../notifications/feedback-notification-types-labels\";\nimport type { FeedbackContextLabels } from \"../feedback/feedback-context\";\nimport type { FeedbackPageLabels } from \"../feedback/feedback-table\";\nimport type { FeedbackDetailLabels } from \"../feedback/feedback-row-detail\";\nimport type { FeedbackVoteLabels } from \"../feedback/feedback-vote-button\";\nimport type { FeedbackCommentsLabels } from \"../feedback/feedback-comment-thread\";\nimport type { FeedbackRepliesLabels } from \"../feedback/feedback-replies\";\nimport type { AccountSettingsLabels } from \"../account/account-settings-labels\";\nimport type { ConfirmDialogLabels } from \"../components/confirm-dialog\";\nimport type { FloatingPanelLabels } from \"../components/floating-panel\";\nimport type { CopyButtonLabels } from \"../components/copy-button\";\nimport type { BulkActionBarLabels } from \"../components/bulk-action-bar\";\nimport type { ListLabels } from \"../components/list\";\nimport type { BreadcrumbsLabels } from \"../components/breadcrumbs\";\nimport type { ToastLabels } from \"../components/toast\";\nimport type { FormActionsLabels } from \"../components/form-actions\";\nimport type { DescriptionListLabels } from \"../components/description-list\";\nimport type { LineItemsLabels } from \"../components/line-items\";\nimport type { ProgressBarLabels } from \"../components/progress-bar\";\nimport type { SignedAmountLabels } from \"../components/signed-amount\";\nimport type { ErrorBoundaryLabels } from \"../components/error-boundary\";\nimport type { AuthedImageLabels } from \"../components/authed-image\";\nimport type { ImageGridLabels } from \"../components/image-grid\";\nimport type { LightboxLabels } from \"../components/lightbox\";\nimport type { WriteLockLabels } from \"../components/write-lock\";\nimport type { LegalLabels } from \"../components/legal\";\nimport type { SignInLabels } from \"../auth/sign-in-form\";\nimport type { RegisterLabels } from \"../auth/register-form\";\nimport type { CompleteNameLabels } from \"../auth/complete-name-dialog\";\nimport type { ForgotPasswordLabels } from \"../auth/forgot-password-form\";\nimport type { ResetPasswordLabels } from \"../auth/reset-password-form\";\nimport type { VerifyEmailLabels } from \"../auth/verify-email\";\nimport type { NotFoundLabels } from \"../auth/not-found-page\";\nimport type { AcceptInvitationLabels } from \"../auth/accept-invitation\";\nimport type { CompanySwitcherLabels } from \"../shell/company-switcher\";\nimport type { EmailChangeLabels } from \"../account/email-change-setting\";\nimport type { SessionsLabels } from \"../account/sessions-setting\";\nimport type { DeleteAccountLabels } from \"../account/delete-account-setting\";\nimport type { DataExportLabels } from \"../account/data-export-setting\";\nimport type { UserRosterLabels } from \"../admin/user-roster\";\nimport type { RoleSelectLabels } from \"../admin/role-select\";\nimport type { ReviewerScopeLabels } from \"../admin/reviewer-scope-editor\";\nimport type { AdminActionLabels } from \"../admin/admin-action-confirm\";\nimport type { AdminActionLogLabels } from \"../admin/admin-action-log\";\nimport type { TransferOwnershipLabels } from \"../admin/transfer-ownership-dialog\";\nimport type { InvitationsLabels } from \"../admin/invitations-panel\";\nimport type { SettingsLabels } from \"../settings/settings-labels\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport type { DemoLabels } from \"../demo/demo-labels\";\nimport type { BillingLabels } from \"../billing/billing-labels\";\nimport type { PlanChangeLabels } from \"../admin/plan-change\";\nimport type { AppearanceLabels } from \"../components/appearance-labels\";\nimport type { DeviceResetLabels } from \"../settings/device-reset-setting\";\nimport type { RowActionsLabels } from \"../components/row-actions\";\nimport type { AppShellMoreLabels } from \"../shell/app-shell\";\nimport type { AccountStateLabels } from \"../components/account-chips\";\nimport type { ShareCardLabels } from \"../components/share-card\";\nimport type { ReauthDialogLabels } from \"../components/reauth-dialog\";\nimport type { ServerWakeLabels } from \"../components/server-wake\";\nimport type { TranslationReviewLabels } from \"../components/translation-review-labels\";\nimport type { CountrySelectLabels } from \"../components/country-select\";\nimport type { InlineEditLabels } from \"../components/inline-edit-field\";\nimport type { IbanInputLabels } from \"../components/iban-input\";\nimport type { PhoneInputLabels } from \"../components/phone-input\";\nimport type { SignChipLabels } from \"../components/sign-chip\";\nimport type { ColumnMapperLabels } from \"../components/column-mapper\";\nimport type { NotificationsLabels } from \"../notifications/notifications-labels\";\nimport type { AdminAreaLabels } from \"../admin/admin-area-labels\";\nimport type { MailTestCardLabels } from \"../admin/mail-test-card\";\nimport type { TopBarPartsLabels } from \"../shell/top-bar-parts-labels\";\nimport type { SignOutPendingDialogLabels } from \"../offline/sign-out-pending-dialog\";\nimport type { PwaUpdatePromptLabels } from \"../offline/pwa-update-prompt\";\nimport type { SharedComputerLabels } from \"../offline/shared-computer\";\n\n/**\n * EVERY string the kit renders, as one typed tree — and an optional provider that\n * hands it to every component at once.\n *\n * WHY THIS EXISTS. The kit renders only labels; it ships seven catalogues (since 0.7.0,\n * `@eifi1/ui-kit/i18n/<code>`); the app decides the language and hands the words in.\n * What was wrong was HOW it had to hand them in —\n * one `labels` prop per component instance, under a different prop name per\n * component (`labels`, `calendarLabels`, `passwordLabels`, `clearLabel`,\n * `searchPlaceholder`, `ariaLabel` …). A translated app therefore rendered English\n * wherever one call site forgot one prop, and nothing told it so: a German showcase\n * still said \"Rows per page\", \"Collapse sidebar\" and \"Popover\" in seven languages.\n *\n * Now there is one key per string, addressed by a dot path (`dataTable.pageSize`,\n * `datePicker.today`), and three sources in a fixed order of precedence:\n *\n *     the component's own prop   >   <UiKitProvider labels>   >   English default\n *\n * A consumer loads a shipped catalogue (`loadUiKitLabels(code)`) or writes its own\n * `UiKitLabels` (or a partial of one), mounts `<UiKitProvider labels={…} locale={…}>`\n * at the root, and every kit component\n * below speaks that language — including the ones nested inside other kit components\n * (the calendar inside the data table's date filter, the popover inside the date\n * picker), which no prop at the outer call site could reach before.\n *\n * Messages that carry a value are FUNCTIONS of that value, never a template to fill:\n * a number glued into an English sentence is untranslatable, because the grammar\n * around it moves with it in most languages.\n */\n\n/* ── Namespaces that had no labels type of their own ─────────────────────── */\n\n/** The words several components share. A component's own namespace wins over these\n *  where both exist; these are what a new component reaches for first. */\nexport interface CommonLabels {\n  close: string;\n  clear: string;\n  search: string;\n  done: string;\n  cancel: string;\n  save: string;\n  back: string;\n  next: string;\n  remove: string;\n  loading: string;\n  noResults: string;\n  /** \"Name: value\" — how a field's accessible name is composed with its value.\n   *  A colon-and-space is not universal punctuation (French puts a space before\n   *  the colon, Chinese uses a full-width one). */\n  fieldValue: (field: string, value: string) => string;\n  /** The × that puts away a banner or a notice (`AlertBanner onDismiss`). Not `close`:\n   *  nothing opened, and \"Close\" on a banner reads as closing the page it sits on. */\n  dismiss: string;\n  /** Read after a link that opens a new tab (`<Button href external>`, TextLink):\n   *  nothing else tells a screen reader the page is about to change tabs. */\n  opensInNewTab: string;\n  /** The name of a field's `help` \"?\" and its panel (round 0.36): \"About “<field>”\", the\n   *  field's label as the argument, quoted so a capitalised label reads as a name — \"About\n   *  “Jerk shape”\" (round 0.37; the other locales quoted it already). A `HelpPopover`\n   *  passed as `help` keeps its own name. */\n  aboutField: (field: string) => string;\n  /** …and of a `help` \"?\" on a field with no label and no `aria-label` to name it by. */\n  help: string;\n  /** 0.48: the toggle that shows the rest of a clamped text (`AlertBanner clampMobile`)… */\n  showMore: string;\n  /** …and folds it back to its one line. */\n  showLess: string;\n}\n\n/** `DatePicker` / `DateRangePicker` chrome. The calendar inside has its own\n *  namespace, `miniCalendar`. */\nexport interface DatePickerLabels {\n  /** Accessible name of the popover panel the calendar opens in. */\n  panel: string;\n  /** The same, for `DateRangePicker`'s panel. */\n  rangePanel: string;\n  clear: string;\n  previousDay: string;\n  nextDay: string;\n  today: string;\n  /** `DateRangePicker commit=\"apply\"`: the button that commits the drafted range. */\n  apply: string;\n  /** …and the one that discards it. */\n  cancel: string;\n  /** Accessible name of `DateRangePicker`'s preset column. */\n  presets: string;\n}\n\n/** The whole combobox family: `Combobox`, `EntityCombobox`,\n *  `MultiEntityCombobox`, `InlineEntityCombobox`, `Autocomplete`. */\nexport interface ComboboxLabels {\n  search: string;\n  noResults: string;\n  clear: string;\n  loading: string;\n  /** The \"add this\" row when free entry is allowed. */\n  create: (query: string) => string;\n  /** Trigger summary once more than one value is picked. */\n  selectedCount: (count: number) => string;\n  /** An async lookup (`loadOptions`) failed. */\n  loadError: string;\n  /** Announced (live region) when the list settles on `count` > 0 rows. */\n  resultCount: (count: number) => string;\n  /** The query is shorter than the `minChars` a lookup needs. */\n  minChars: (count: number) => string;\n}\n\nexport interface MultiSelectLabels {\n  search: string;\n  selectAll: string;\n  clear: string;\n  /** Trigger text when nothing is picked, which a multi-select reads as \"all\". */\n  all: string;\n  /** Trigger summary once some (but not all) values are picked. The English\n   *  default is the bare count, which is what the trigger has always shown. */\n  selectedCount: (count: number) => string;\n}\n\n/** `CalculatorButton` (desktop popover keypad) and `NumberPadSheet` (phone sheet). */\nexport interface CalculatorLabels {\n  /** The button that opens the calculator. */\n  open: string;\n  /** The popover / sheet itself. */\n  panel: string;\n  calculation: string;\n  backspace: string;\n  clear: string;\n  equals: string;\n  /** The primary key of the phone pad — visible text, not an aria-label. */\n  done: string;\n  /** Names of the operator keys and the decimal key. Their glyphs are not names a\n   *  screen reader agrees on — \"÷\" is read as \"division sign\", \"divided by\" or\n   *  nothing at all depending on the reader — so each says what it does. */\n  plus: string;\n  minus: string;\n  times: string;\n  divide: string;\n  decimal: string;\n}\n\n/** `CurrencySelect` and the currency half of `AmountInput`. */\nexport interface CurrencyLabels {\n  currency: string;\n  search: string;\n}\n\nexport interface AppShellLabels {\n  collapse: string;\n  expand: string;\n  /** Accessible name of an inline group's disclosure button (`subNav=\"inline\"`). */\n  toggleGroup: (groupLabel: string) => string;\n}\n\nexport interface TopBarLabels {\n  theme: string;\n  palette: string;\n  language: string;\n  /** 0.49 KIT-10: the language menu's trigger, given the current language's name —\n   *  \"Choose language, current: Deutsch\". */\n  languageCurrent: (name: string) => string;\n  switchRole: string;\n  /** The role switcher's tooltip, given the active role's name. */\n  role: (value: string) => string;\n}\n\nexport interface PickerSheetLabels {\n  close: string;\n  /** The sticky footer button that closes a multi-select sheet once the rows are ticked\n   *  (0.40) — the ticks are already applied, so it confirms rather than saves. */\n  done: string;\n}\n\nexport interface SwipeableRowLabels {\n  actions: string;\n}\n\nexport interface FileLabels {\n  /** A file size for display, given its size in BYTES. The default uses\n   *  `Intl.NumberFormat`'s unit formatting in the provider's locale. */\n  size: (bytes: number) => string;\n}\n\n/** The complete tree. `UiKitProvider` takes any partial of it. */\nexport interface UiKitLabels {\n  common: CommonLabels;\n  dataTable: DataTableLabels;\n  miniCalendar: MiniCalendarLabels;\n  calendarHeatmap: CalendarHeatmapLabels;\n  datePicker: DatePickerLabels;\n  monthPicker: MonthPickerLabels;\n  popover: PopoverLabels;\n  combobox: ComboboxLabels;\n  multiSelect: MultiSelectLabels;\n  calculator: CalculatorLabels;\n  currency: CurrencyLabels;\n  chipInput: ChipInputLabels;\n  fieldSync: FieldSyncLabels;\n  passwordReveal: PasswordRevealLabels;\n  tabs: TabsLabels;\n  appShell: AppShellLabels;\n  pageContents: PageContentsLabels;\n  topBar: TopBarLabels;\n  pickerSheet: PickerSheetLabels;\n  swipeableRow: SwipeableRowLabels;\n  file: FileLabels;\n  wizard: WizardLabels;\n  tour: TourLabels;\n  /** 0.43.0: the tours page — `TourCatalogue` and its card (docs/tours-harmonization.md §3). */\n  tourCatalogue: TourCatalogueLabels;\n  commandPalette: CommandPaletteLabels;\n  globalSearch: GlobalSearchLabels;\n  seriesChart: SeriesChartLabels;\n  pieChart: PieChartLabels;\n  sparkline: SparklineLabels;\n  statTile: StatTileLabels;\n  signaturePad: SignaturePadLabels;\n  passwordStrength: PasswordStrengthLabels;\n  dangerConfirm: DangerConfirmLabels;\n  swatchPicker: SwatchPickerLabels;\n  iconPicker: IconPickerLabels;\n  dialogFrame: DialogFrameLabels;\n  filePicker: FilePickerLabels;\n  measuredGrid: MeasuredGridLabels;\n  feedbackAttachment: FeedbackAttachmentFieldLabels;\n  /** 0.12.0: `FeedbackDialog`'s own strings; `FeedbackThread` / `FeedbackComposer`. */\n  feedbackDialog: FeedbackDialogTextLabels;\n  feedbackThread: FeedbackThreadLabels;\n  feedbackComposer: FeedbackComposerLabels;\n  /** 0.27.0: the feedback harmonisation (docs/feedback-harmonization.md §4) — a report's\n   *  status and category words, keyed by the enum value; the toasts a feedback page\n   *  shows; `FeedbackMenu`; `FeedbackContextBox`; the two pages' table; the row detail.\n   *  keksdose's wording is the canon, in every language. */\n  feedbackStatus: FeedbackStatusLabels;\n  feedbackCategory: FeedbackCategoryLabels;\n  feedbackToast: FeedbackToastLabels;\n  feedbackMenu: FeedbackMenuLabels;\n  /** 0.38.0: the public feedback pages — `FeedbackPublicList`, `FeedbackPublicDetail`,\n   *  `FeedbackPublicSwitch` (docs/feedback-harmonization.md §9.15). */\n  feedbackPublic: FeedbackPublicLabels;\n  /** 0.38.0: `useFeedbackNotificationTypes` — the two feedback types' setting words\n   *  (§9.11). */\n  feedbackNotificationTypes: FeedbackNotificationTypesLabels;\n  feedbackContext: FeedbackContextLabels;\n  feedbackPage: FeedbackPageLabels;\n  feedbackDetail: FeedbackDetailLabels;\n  /** 0.38.0: public feedback (docs/feedback-harmonization.md §9.15) — the vote button,\n   *  the comment thread, the replies' timeline and composer. */\n  feedbackVote: FeedbackVoteLabels;\n  feedbackComments: FeedbackCommentsLabels;\n  feedbackReplies: FeedbackRepliesLabels;\n  /** 0.12.0: `ProfileSetting`, `PasswordSetting`, `TwoFactorSetting`, `PasskeysSetting`\n   *  — one record per section. The provider takes a whole section record; the\n   *  components merge it key by key, as a prop. */\n  accountSettings: AccountSettingsLabels;\n  confirmDialog: ConfirmDialogLabels;\n  floatingPanel: FloatingPanelLabels;\n  copyButton: CopyButtonLabels;\n  bulkActionBar: BulkActionBarLabels;\n  list: ListLabels;\n  breadcrumbs: BreadcrumbsLabels;\n  toast: ToastLabels;\n  form: FormActionsLabels;\n  descriptionList: DescriptionListLabels;\n  lineItems: LineItemsLabels;\n  progressBar: ProgressBarLabels;\n  signedAmount: SignedAmountLabels;\n  errorBoundary: ErrorBoundaryLabels;\n  authedImage: AuthedImageLabels;\n  imageGrid: ImageGridLabels;\n  lightbox: LightboxLabels;\n  /** 0.18.0: `WriteLockProvider`'s fallback reason, `AccountStateChip`, `SharePanel` /\n   *  `ShareCard` / `ShareDialog`, `ReauthDialog`. */\n  writeLock: WriteLockLabels;\n  accountState: AccountStateLabels;\n  shareCard: ShareCardLabels;\n  reauthDialog: ReauthDialogLabels;\n  /** 0.18.0: `ServerWakeNotice` — keksdose's cold-start notice, for every app. */\n  serverWake: ServerWakeLabels;\n  /** 0.19.0: the translation-review parts (`TranslationReviewPanel`, its editor, chip,\n   *  progress, locale tabs and export) — keksdose's /translations, for every app. */\n  translationReview: TranslationReviewLabels;\n  /** 0.19.0: `LegalLinks`' navigation name. 0.28.0: every kit-owned word of the legal\n   *  pages — the link labels, titles, back link, terms checkbox and notices, and the\n   *  sections that are the same in every app, filled in with the app's operator\n   *  (docs/legal-harmonization.md §4.3/§4.4). */\n  legal: LegalLabels;\n  /** 0.29.0: sign-in form: credentials, passkey, 2FA, forced new password (docs/auth-harmonization.md §5). */\n  signIn: SignInLabels;\n  /** 0.29.0: the sign-up form, with the +app address tag (§4.1, §4.5). */\n  register: RegisterLabels;\n  /** 0.29.0: asking a migrated account for first and last name once (§3.3). */\n  completeName: CompleteNameLabels;\n  /** 0.29.0: requesting a reset link (always the same answer). */\n  forgotPassword: ForgotPasswordLabels;\n  /** 0.29.0: choosing a new password from a reset link; not a sign-in (§6.3). */\n  resetPassword: ResetPasswordLabels;\n  /** 0.29.0: the verify-email page and the unverified banner. */\n  verifyEmail: VerifyEmailLabels;\n  /** 0.29.0: the 404 page. */\n  notFound: NotFoundLabels;\n  /** 0.29.0: accepting an invitation with an account (§4.4). */\n  acceptInvitation: AcceptInvitationLabels;\n  /** 0.29.0: kastlan's switcher between a user's companies (§5.3). */\n  companySwitcher: CompanySwitcherLabels;\n  /** 0.30.0: changing the account's address with re-verification (docs/user-admin-harmonization.md §6.2). */\n  emailChange: EmailChangeLabels;\n  /** 0.30.0: sign out everywhere, and kastlan's device list (§6.3). */\n  sessions: SessionsLabels;\n  /** 0.30.0: deletion in two stages (§6.4). */\n  deleteAccount: DeleteAccountLabels;\n  /** 0.30.0: the self-service JSON export (§6.5). */\n  dataExport: DataExportLabels;\n  /** 0.30.0: the admin user list's columns (§3). */\n  userRoster: UserRosterLabels;\n  /** 0.30.0: picking one or several roles, with the reasons a choice is locked (§4.1). */\n  roleSelect: RoleSelectLabels;\n  /** 0.30.0: a translation reviewer's languages and areas. */\n  reviewerScope: ReviewerScopeLabels;\n  /** 0.30.0: an admin action's confirmation and refusals (§4.2). */\n  adminAction: AdminActionLabels;\n  /** 0.30.0: the admin_actions list (§4.3). */\n  adminActionLog: AdminActionLogLabels;\n  /** 0.30.0: handing an account's work to another (Kurvenschmiede). */\n  transferOwnership: TransferOwnershipLabels;\n  /** 0.30.0: the invitations panel (§5). */\n  invitations: InvitationsLabels;\n  /** 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §4.3). */\n  settings: SettingsLabels;\n  /** 0.31.0: the public landing page's kit words (docs/landing-demo-harmonization.md §4). */\n  landing: LandingLabels;\n  /** 0.31.0: the demo's start, banner and end (§5). */\n  demo: DemoLabels;\n  /** 0.32.0: plans, standing, banners and the limit notice (docs/billing-harmonization.md §7). */\n  billing: BillingLabels;\n  /** 0.33.0: the operator's plan parts — `planColumn`, `PlanChangeConfirm` and the\n   *  lines of `usePlanChangeResult` (docs/billing-harmonization.md §14.12). */\n  planChange: PlanChangeLabels;\n  /** 0.32.0: the text-size and contrast settings (docs/text-size-harmonization.md §6). */\n  appearance: AppearanceLabels;\n  /** 0.36.0: resetting this device's settings, the appearance group's last card\n   *  (docs/settings-harmonization.md §11.3). */\n  deviceReset: DeviceResetLabels;\n  /** 0.32.0: a row's actions folded into a \"⋯\" menu at Large (text size §10.8). */\n  rowActions: RowActionsLabels;\n  /** 0.32.0: the phone bar's \"More\" cell and sheet (text size §10.7). */\n  appShellMore: AppShellMoreLabels;\n  /** 0.22.0: the screen-reader words of `Input` / `Textarea`'s `showCount` counter. */\n  characterCount: CharacterCountLabels;\n  /** 0.22.0: `CountrySelect`. Its list's \"no results\" and counts are `combobox`'s. */\n  countrySelect: CountrySelectLabels;\n  /** 0.22.0: `InlineEditField` — keksdose K9. */\n  inlineEdit: InlineEditLabels;\n  /** 0.22.0: `IbanInput`'s messages, one per problem. */\n  ibanInput: IbanInputLabels;\n  /** 0.22.0: `PhoneInput`'s country-code select. */\n  phoneInput: PhoneInputLabels;\n  /** 0.22.0: `SignChip` — the outflow / inflow toggle beside an amount. */\n  signChip: SignChipLabels;\n  /** 0.23.0: `ColumnMapper` / `ColumnRoleTable` — a pasted or dropped table, a role per\n   *  column. */\n  columnMapper: ColumnMapperLabels;\n  /** 0.36.0: the notification cards — the types, quiet hours and the zone picker, this\n   *  device's push, the device list, and the unsubscribe page\n   *  (docs/notifications-harmonization.md §4.2). */\n  notifications: NotificationsLabels;\n  /** 0.42.0: the admin area's shared words — the account menu's \"Administration\" row, the\n   *  403 page, the shared sections, the overview's tiles and the Tools list\n   *  (docs/admin-harmonization.md §3.1). */\n  adminArea: AdminAreaLabels;\n  /** 0.42.0: the top bar's shared parts — `TourMenu`, `SyncStatusIndicator`, `DevSwitchers`\n   *  (docs/top-bar-harmonization.md §3.1). */\n  topBarParts: TopBarPartsLabels;\n  /** 0.45.0: \"Send a test mail to me\" (docs/admin-harmonization.md §9.2.4). */\n  mailTestCard: MailTestCardLabels;\n  /** 0.45.0: the sign-out question while changes wait to sync (`@eifi1/ui-kit/offline`,\n   *  docs/local-first-harmonization.md §1.6). */\n  signOutPending: SignOutPendingDialogLabels;\n  /** 0.45.0: the service-worker update toast (local-first §1.5 D8). */\n  pwaUpdate: PwaUpdatePromptLabels;\n  /** 0.45.0: \"This is a shared computer\" on the sign-in form (local-first §1.5 D6). */\n  sharedComputer: SharedComputerLabels;\n}\n\n/**\n * A label override, as deep as the labels go: an object of labels (a namespace, or a\n * record inside one such as `accountSettings.passkeys` or `dataTable.presets`) may be\n * partial at every level, because the provider merges it key by key at every level.\n * A leaf stays as it is: a string, a function-valued label (`(n) => …`), and anything\n * that is not purely an object (a `ReactNode` union) is given whole.\n */\nexport type LabelOverride<T> = [T] extends [(...args: never[]) => unknown]\n  ? T\n  : [T] extends [readonly unknown[]]\n    ? T\n    : [T] extends [object]\n      ? { [K in keyof T]?: LabelOverride<T[K]> }\n      : T;\n\n/** Any subset of the tree — each namespace may be partial, and so may any record\n *  inside one (`accountSettings.passkeys`, `dataTable.presets`): they are merged key\n *  by key, at every depth. */\nexport type UiKitLabelOverrides = { [K in keyof UiKitLabels]?: LabelOverride<UiKitLabels[K]> };\n\n/* ── English defaults for the namespaces defined here ────────────────────── */\n\n// They live in ./shared-labels, a module of words, as every component's defaults live in\n// its `*-labels.ts` (round 0.34). Imported and exported as this module's own, as each\n// component does with its defaults: the names, and where the README lists them, stay.\nexport {\n  DEFAULT_APP_SHELL_LABELS,\n  DEFAULT_CALCULATOR_LABELS,\n  DEFAULT_COMBOBOX_LABELS,\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  DEFAULT_DATE_PICKER_LABELS,\n  DEFAULT_FILE_LABELS,\n  DEFAULT_MULTI_SELECT_LABELS,\n  DEFAULT_PICKER_SHEET_LABELS,\n  DEFAULT_SWIPEABLE_ROW_LABELS,\n  DEFAULT_TOP_BAR_LABELS,\n  formatFileSize,\n};\n\n/* ── The provider ────────────────────────────────────────────────────────── */\n\ninterface KitI18n {\n  labels?: UiKitLabelOverrides;\n  locale?: string;\n  weekStartsOn?: WeekDay;\n  linkComponent?: KitLinkComponent;\n  chartTooltipPlacement?: ChartTooltipPlacement;\n  formatDate?: KitDateFormatter;\n  tableStorageKeyPrefix?: string;\n  timeZone?: string;\n  documentTitleFormat?: string;\n  appName?: string;\n}\n\n/** What a {@link KitDateFormatter} is told about the date it is formatting. */\nexport interface KitDateFormatContext {\n  /**\n   * How much of a date the string is: `\"day\"` — the `iso` is `\"YYYY-MM-DD\"`; `\"month\"` —\n   * `\"YYYY-MM\"` (a `MonthPicker`); `\"year\"` — `\"YYYY\"` (`MonthPicker mode=\"year\"`).\n   */\n  unit: \"day\" | \"month\" | \"year\";\n  /** Which kit surface asks: the trigger of a `DatePicker`, of a `DateRangePicker`\n   *  (called once per end), of a `MonthPicker`, or a `DateMark`. */\n  source: \"datePicker\" | \"dateRangePicker\" | \"monthPicker\" | \"dateMark\";\n  /** The locale the kit would have formatted in — the component's `locale` prop, else\n   *  the provider's — or `undefined` for the runtime's. */\n  locale: string | undefined;\n  /**\n   * The kit's suggestion: whether this date stands alone where the day of the week\n   * helps — `true` for a `DatePicker`'s trigger and a `DateMark`, `false` for the two\n   * ends of a range (twice the width, in a sentence-like \"from – to\") and for a month\n   * or a year. keksdose's rule, which this follows: *\"A date in a COLUMN carries the\n   * weekday. A date in a SENTENCE does not.\"* (date-cell.tsx, dev#546). A formatter\n   * is free to ignore it.\n   */\n  weekday: boolean;\n}\n\n/**\n * The app's ONE answer to \"what does a date look like here\" — keksdose K12. Returns the\n * text for an ISO date (see {@link KitDateFormatContext.unit} for the three shapes).\n * Return `\"\"` to fall back to the kit's own formatting for that date.\n */\nexport type KitDateFormatter = (iso: string, context: KitDateFormatContext) => string;\n\n/** Where a chart shows the values under the pointer — see `SeriesChartTooltip.placement`. */\nexport type ChartTooltipPlacement = \"cursor\" | \"above\" | \"below\" | \"auto\";\n\n/**\n * What every kit link receives: the anchor attributes the kit decided (href, class,\n * aria-current, handlers, children, ref). An app's router link maps them —\n * `({ href, ...p }) => <Link to={href} {...p} />` — ONCE, on the provider.\n *\n * `replace` is the one prop that is not an anchor attribute: see there. Map it\n * explicitly if your router link is not react-router's —\n * `({ href, replace, ...p }) => <Link to={href} replace={replace} {...p} />` — and never\n * spread it onto a DOM `<a>`, where React warns about an unknown attribute.\n */\nexport type KitLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {\n  href: string;\n  ref?: Ref<HTMLAnchorElement>;\n  /**\n   * Navigate by REPLACING the current history entry, so Back skips it — keksdose F1:\n   * a one-shot URL (a magic-link landing, `?checkout=done`, a wizard's \"finish\" hop)\n   * that must not come back when the user presses Back. Present ONLY when the kit link\n   * was given `replace` (`true`), so a provider link that spreads its props onto a\n   * plain `<a>` keeps working for every link that never asks for it. react-router's\n   * `<Link>` takes the same prop, so `({ href, ...p }) => <Link to={href} {...p} />`\n   * honours it with no change; any other router maps it to its own replace option.\n   * The kit never puts it on a DOM element itself.\n   */\n  replace?: boolean;\n};\nexport type KitLinkComponent = (props: KitLinkProps) => ReactElement;\n\nconst KitI18nContext = createContext<KitI18n>({});\n\nexport interface UiKitProviderProps {\n  /** Any part of {@link UiKitLabels}. Missing keys fall back to English. */\n  labels?: UiKitLabelOverrides;\n  /**\n   * BCP 47 tag used by every kit component that formats something — dates, numbers,\n   * month and weekday names, file sizes — when it is not handed a `locale` prop of\n   * its own. Without a provider, and without a prop, those use the runtime default.\n   */\n  locale?: string;\n  /**\n   * The first day of the week (0 = Sunday, 1 = Monday …) for every calendar below —\n   * `MiniCalendar` and the pickers built on it — that is not handed a `weekStartsOn`\n   * of its own. Without it the week start follows `locale`'s week info.\n   *\n   * Separate from `locale` because the two are separate decisions: a German-built\n   * app running in English (`locale=\"en\"`) would otherwise start its weeks on Sunday,\n   * and switching it to `en-GB` to get Monday changes every date and number format.\n   */\n  weekStartsOn?: WeekDay;\n  /**\n   * The app's router link, used by every kit component that renders an in-app link\n   * and was not handed its own `renderLink` — so `renderLink` stops being repeated on\n   * each ListItem, Breadcrumbs, StatTile, Chip… (kastlan). A component's own\n   * `renderLink` wins; external links and in-page `#anchor`s stay plain `<a>`, and a\n   * hash-router `#/path` is handed to it like `/path` (see `pickLinkRenderer`).\n   */\n  linkComponent?: KitLinkComponent;\n  /**\n   * Where every `SeriesChart` below shows its tooltip when it does not say so itself\n   * (`tooltip.placement`) — set once so an app's phone charts stop putting the box under\n   * the reader's finger (keksdose #359). Default: `\"cursor\"`, the box that follows the\n   * pointer, as before.\n   */\n  chartTooltipPlacement?: ChartTooltipPlacement;\n  /**\n   * How every kit date below is written, when the component is not told otherwise —\n   * keksdose K12. keksdose has a date-format preference (Settings ▸ date format, feedback\n   * #180) that is not the UI language, and a weekday in the UI language beside digits\n   * in the preference's order (live #246, dev#546): two locales in one string, which\n   * no `locale` + `Intl` options can say. Its `DateField` wraps every `DatePicker` to\n   * pass `formatValue`, and its report range field formats both ends by hand; with this\n   * set once on the provider, those wrappers thin to nothing.\n   *\n   * Used for the trigger text of `DatePicker`, `DateRangePicker` and `MonthPicker`\n   * (month and year mode), and for `DateMark display=\"date\"`. A component's own\n   * `formatValue` or `formatOptions` (`dateStyle` on a DateMark) wins: prop >\n   * provider > the kit's `Intl` default, the order every kit setting resolves in. Left\n   * out (or returning `\"\"`), everything formats exactly as before.\n   *\n   * Keep it stable (`useCallback`, or a module function): it is in the provider's\n   * context value, so a new function every render re-renders every consumer.\n   */\n  formatDate?: KitDateFormatter;\n  /**\n   * The `localStorage` prefix every kit table below keeps its view under (sort, filters,\n   * page size, widths, hidden columns), when the table is not handed a\n   * `storageKeyPrefix` of its own — round 0.34 C5, KS U4. Left out, it is the kit's\n   * `\"hbui-table:\"`, as before.\n   *\n   * Set once here rather than per table because not every table is the app's to pass a\n   * prop to: `TranslationReviewPanel` wraps a `DataTable`, and until this the panel's\n   * view landed under the kit's prefix whatever the app's was — so an app that lists\n   * what it stores (a privacy page) had to list the kit's prefix as a key of its own.\n   * Resolves like every kit setting: the table's own prop > this > the default. The\n   * key is the prefix plus the table's `storageKey`, verbatim, so an app that wrapped\n   * `DataTable` to pass its prefix (Keksdose's `keksdose-table:`) keeps every stored\n   * view when it moves the prefix here.\n   */\n  tableStorageKeyPrefix?: string;\n  /**\n   * 0.46 (docs/notifications-harmonization.md §10.3): the IANA zone (\"Europe/Zurich\") every\n   * TIMESTAMP below is shown in through `useKitFormat().formatDate` /\n   * `formatRelativeTime`, when the call names none — the account's picked zone, for an app\n   * that shows times in it. A bare \"YYYY-MM-DD\" is never shifted (a calendar day is the day\n   * it names in every zone). Left out, timestamps follow the device, as before.\n   */\n  timeZone?: string;\n  /**\n   * 0.49 KIT-9: how `useDocumentTitle` and every `PageHeader`'s `h1` write the window's\n   * title, from `{page}`, `{section}` and `{app}`. Default\n   * `\"{page} · {section} · {app}\"` (`DEFAULT_DOCUMENT_TITLE_FORMAT`); a missing part\n   * drops with its separator.\n   */\n  documentTitleFormat?: string;\n  /** 0.49 KIT-9: the app's name, the `{app}` of the window's title (\"Kastlan\"). Left\n   *  out, titles end at the page or section. */\n  appName?: string;\n  /**\n   * 0.49 KIT-1b: while a person copies a selection in the page, a U+2212 minus standing\n   * before a number (\"−CHF 1,250.50\") goes to the clipboard as \"-\", in `text/plain` and\n   * `text/html` (what Excel pastes), so a spreadsheet reads a number; the page keeps \"−\".\n   * A copy out of an input, a textarea or an editable element is left alone. Installed\n   * once per document, by the first provider that has it on. Default `true`; `false` on\n   * the outermost provider leaves the clipboard to the browser.\n   */\n  copyAsciiMinus?: boolean;\n  children: ReactNode;\n}\n\n/**\n * Hand every kit component below this point its strings and its locale.\n *\n * Optional: a component outside any provider behaves exactly as it did before the\n * provider existed. Nesting works as a merge — an inner provider overrides only what\n * it names, so a page can re-label one table's `dataTable.table` without restating\n * the language.\n */\nexport function UiKitProvider({\n  labels,\n  locale,\n  weekStartsOn,\n  linkComponent,\n  chartTooltipPlacement,\n  formatDate,\n  tableStorageKeyPrefix,\n  timeZone,\n  documentTitleFormat,\n  appName,\n  copyAsciiMinus = true,\n  children,\n}: UiKitProviderProps) {\n  const outer = useContext(KitI18nContext);\n  const value = useMemo<KitI18n>(\n    () => ({\n      locale: locale ?? outer.locale,\n      weekStartsOn: weekStartsOn ?? outer.weekStartsOn,\n      labels: mergeOverrides(outer.labels, labels),\n      linkComponent: linkComponent ?? outer.linkComponent,\n      chartTooltipPlacement: chartTooltipPlacement ?? outer.chartTooltipPlacement,\n      formatDate: formatDate ?? outer.formatDate,\n      tableStorageKeyPrefix: tableStorageKeyPrefix ?? outer.tableStorageKeyPrefix,\n      timeZone: timeZone ?? outer.timeZone,\n      documentTitleFormat: documentTitleFormat ?? outer.documentTitleFormat,\n      appName: appName ?? outer.appName,\n    }),\n    [\n      outer,\n      labels,\n      locale,\n      weekStartsOn,\n      linkComponent,\n      chartTooltipPlacement,\n      formatDate,\n      tableStorageKeyPrefix,\n      timeZone,\n      documentTitleFormat,\n      appName,\n    ],\n  );\n  useTableViewsJoin(value.tableStorageKeyPrefix ?? DEFAULT_TABLE_STORAGE_KEY_PREFIX);\n  useClipboardMinus(copyAsciiMinus);\n  return <KitI18nContext.Provider value={value}>{children}</KitI18nContext.Provider>;\n}\n\n/** The kit's own table prefix: `DEFAULT_PERSIST_PREFIX` of components/use-table-state,\n *  restated because that module imports the router (a test pins the two equal). */\nconst DEFAULT_TABLE_STORAGE_KEY_PREFIX = \"hbui-table:\";\n\n/**\n * Reset this device's settings (docs/settings-harmonization.md §11.4): the tables below a\n * provider keep their views under its prefix, so the provider joins the registry with\n * that prefix — a view, no `reset`, since a table reads its view when it next mounts —\n * while it is mounted. Nested providers with one prefix hold one entry.\n *\n * Through a literal `import()`, not a static import: every catalogue reaches this module,\n * and a catalogue may reach nothing outside i18n/ (scripts/check-module-graph.mjs,\n * english-catalogue-graph.test.ts). The theme stores and the shell import the registry\n * statically, so it is loaded already and the join lands a microtask after the mount.\n */\nfunction useTableViewsJoin(prefix: string): void {\n  useEffect(() => {\n    let leave: (() => void) | undefined;\n    let gone = false;\n    import(\"../lib/device-settings\").then(\n      ({ registerDeviceSetting }) => {\n        if (!gone) leave = registerDeviceSetting({ key: prefix, prefix: true, kind: \"view\" });\n      },\n      // A module of the kit's own that fails to load has nothing to join; the provider\n      // and its tables work as before.\n      () => undefined,\n    );\n    return () => {\n      gone = true;\n      leave?.();\n    };\n  }, [prefix]);\n}\n\n/**\n * The copy handler (lib/clipboard-minus, 0.49 KIT-1b), through a literal `import()` for\n * the reason {@link useTableViewsJoin} gives: a catalogue may reach nothing outside i18n/.\n * It is in place a microtask after the mount — long before a person selects and copies.\n */\nfunction useClipboardMinus(on: boolean): void {\n  useEffect(() => {\n    if (!on || typeof document === \"undefined\") return;\n    let uninstall: (() => void) | undefined;\n    let gone = false;\n    import(\"../lib/clipboard-minus\").then(\n      ({ installClipboardMinus }) => {\n        if (!gone) uninstall = installClipboardMinus(document);\n      },\n      // Not loaded: copying works as the browser does it.\n      () => undefined,\n    );\n    return () => {\n      gone = true;\n      uninstall?.();\n    };\n  }, [on]);\n}\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n\n/** A record of labels to merge into — not a React element, which is an object too but\n *  is a label given whole. */\nfunction isLabelRecord(v: unknown): v is Record<string, unknown> {\n  return isRecord(v) && !(\"$$typeof\" in v);\n}\n\n/** Merged key by key at EVERY depth — a namespace, a record inside it\n *  (`accountSettings.passkeys`, `dataTable.presets`), and so on down — to match\n *  {@link LabelOverride}. An `undefined` is skipped at every depth, so it never blanks\n *  out what is under it. */\nfunction mergeNamespace<T extends object>(base: T, over: LabelOverride<T> | Partial<T> | undefined): T {\n  if (!over) return base;\n  const out = { ...base } as Record<string, unknown>;\n  for (const [k, v] of Object.entries(over)) {\n    if (v === undefined) continue;\n    const prev = out[k];\n    out[k] = isLabelRecord(prev) && isLabelRecord(v) ? mergeNamespace(prev, v) : v;\n  }\n  return out as T;\n}\n\nfunction mergeOverrides(\n  a: UiKitLabelOverrides | undefined,\n  b: UiKitLabelOverrides | undefined,\n): UiKitLabelOverrides | undefined {\n  if (!a) return b;\n  if (!b) return a;\n  const out: Record<string, unknown> = { ...a };\n  for (const [ns, v] of Object.entries(b)) {\n    out[ns] = mergeNamespace((out[ns] as object | undefined) ?? {}, v as object);\n  }\n  return out as UiKitLabelOverrides;\n}\n\n/**\n * What the nearest provider says about one namespace — `undefined` outside one. Nested\n * providers' words come merged, at every depth; no English default is filled in.\n *\n * A {@link LabelOverride}, partial at every depth, like the components' `labels` props\n * that take it: a provider that names one key of a section (`accountSettings.passkeys`)\n * or one preset (`dataTable.presets`) hands over just that (round 0.35 R3 — until then\n * it was typed partial at the top only, so a nested section read as complete).\n *\n * For a component whose own resolver does more than a merge (the data table derives\n * `columnsCount` from `columns`): merge the component's prop over it — a record key by\n * key — and feed the result to that resolver.\n */\nexport function useKitLabelOverrides<K extends keyof UiKitLabels>(\n  ns: K,\n): LabelOverride<UiKitLabels[K]> | undefined {\n  return useContext(KitI18nContext).labels?.[ns];\n}\n\n/**\n * One namespace, resolved: `defaults`, then the provider, then the component's own\n * `prop`. Record-valued keys are merged key by key at each step — so `prop` is a\n * {@link LabelOverride}, partial at every depth as the provider's labels are, and a\n * component's `labels` prop, typed the same, is handed over without a cast (refactor\n * audit 2026-10, API-9).\n */\nexport function useKitLabels<K extends keyof UiKitLabels>(\n  ns: K,\n  defaults: UiKitLabels[K],\n  prop?: LabelOverride<UiKitLabels[K]>,\n): UiKitLabels[K] {\n  const fromProvider = useKitLabelOverrides(ns);\n  return useMemo(\n    () => mergeNamespace(mergeNamespace(defaults, fromProvider), prop),\n    [defaults, fromProvider, prop],\n  );\n}\n\n/** The component's own `locale` prop, else the provider's, else `undefined` (which\n *  every `Intl` API reads as \"the runtime's default\"). */\nexport function useKitLocale(prop?: string): string | undefined {\n  const fromProvider = useContext(KitI18nContext).locale;\n  return prop ?? fromProvider;\n}\n\n/** The week start the nearest `<UiKitProvider weekStartsOn>` pins, else `undefined`\n *  (the caller then asks the locale). A component's own prop goes first:\n *  `prop ?? useKitWeekStart()`. */\n/** The provider's router link, or `undefined` — a component's own `renderLink` should\n *  win over it: `const Link = renderLink ?? useKitLink()`. */\nexport function useKitLink(): KitLinkComponent | undefined {\n  return useContext(KitI18nContext).linkComponent;\n}\n\nexport function useKitWeekStart(): WeekDay | undefined {\n  return useContext(KitI18nContext).weekStartsOn;\n}\n\n/** The provider's `chartTooltipPlacement`, or `undefined` — a chart's own prop wins. */\nexport function useKitChartTooltipPlacement(): ChartTooltipPlacement | undefined {\n  return useContext(KitI18nContext).chartTooltipPlacement;\n}\n\n/** The nearest provider's `formatDate`, or `undefined` — a component's own\n *  `formatValue` / `formatOptions` wins over it. See {@link KitDateFormatter}. */\nexport function useKitDateFormatter(): KitDateFormatter | undefined {\n  return useContext(KitI18nContext).formatDate;\n}\n\n/** The nearest provider's `tableStorageKeyPrefix`, or `undefined` — a table's own\n *  `storageKeyPrefix` wins over it, and the kit's `\"hbui-table:\"` comes after both. */\nexport function useKitTableStorageKeyPrefix(): string | undefined {\n  return useContext(KitI18nContext).tableStorageKeyPrefix;\n}\n\n/** The nearest provider's `timeZone` (0.46), or `undefined` — the device's. A call's own\n *  `timeZone` wins over it. */\nexport function useKitTimeZone(): string | undefined {\n  return useContext(KitI18nContext).timeZone;\n}\n\n/** The nearest provider's `documentTitleFormat` and `appName`, or `undefined` each —\n *  what `useDocumentTitle` writes with (the format's default is\n *  `DEFAULT_DOCUMENT_TITLE_FORMAT`, applied there: this module reaches nothing outside\n *  i18n/). */\nexport function useKitDocumentTitle(): { format: string | undefined; appName: string | undefined } {\n  const { documentTitleFormat, appName } = useContext(KitI18nContext);\n  return { format: documentTitleFormat, appName };\n}\n\n/** {@link DEFAULT_FILE_LABELS}, but formatting in the provider's locale. */\nexport function useKitFileLabels(prop?: Partial<FileLabels>): FileLabels {\n  const locale = useKitLocale();\n  const defaults = useMemo<FileLabels>(\n    () => ({ size: (bytes) => formatFileSize(bytes, locale) }),\n    [locale],\n  );\n  return useKitLabels(\"file\", defaults, prop);\n}\n\n/**\n * The dot paths of every key `labels` does NOT supply — the ones a translated app is\n * still showing in English. Assert on it in the app's own test:\n *\n *     expect(missingKitLabels(labels, DEFAULT_UI_KIT_LABELS)).toEqual([]);\n *\n * `reference` is the complete tree to check against — pass\n * {@link DEFAULT_UI_KIT_LABELS} (src/i18n/defaults.ts). It is a parameter rather than an import\n * because the defaults live beside their components, and this module is imported BY\n * those components. Left out (a test file is not type-checked), it throws saying so\n * rather than \"Cannot convert undefined or null to object\" (keksdose, 0.18).\n */\nexport function missingKitLabels(\n  labels: UiKitLabelOverrides | undefined,\n  reference: UiKitLabels,\n): string[] {\n  if (!isRecord(reference)) {\n    throw new TypeError(\n      \"missingKitLabels(labels, reference): pass DEFAULT_UI_KIT_LABELS as the reference — \" +\n        \"it is the tree the labels are checked against.\",\n    );\n  }\n  const missing: string[] = [];\n  for (const [ns, keys] of Object.entries(reference)) {\n    const given = (labels as Record<string, Record<string, unknown> | undefined> | undefined)?.[ns];\n    for (const [key, value] of Object.entries(keys as Record<string, unknown>)) {\n      const got = given?.[key];\n      if (got === undefined) {\n        missing.push(`${ns}.${key}`);\n      } else if (isRecord(value) && isRecord(got)) {\n        for (const sub of Object.keys(value)) {\n          if (got[sub] === undefined) missing.push(`${ns}.${key}.${sub}`);\n        }\n      }\n    }\n  }\n  return missing;\n}\n"],"mappings":"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","names":[]}

package/dist/i18n/locales/en.js

@@ -1564,13 +1564,16 @@ var DEFAULT_DEVICE_RESET_LABELS = {
 // src/components/row-actions-labels.ts
 var DEFAULT_ROW_ACTIONS_LABELS = {
   actions: "Actions",
-  actionsFor: (name) => `Actions for ${name}`
+  actionsFor: (name) => `Actions for ${name}`,
+  confirmTitle: (action, name) => name ? `${action} \u201C${name}\u201D?` : `${action}?`,
+  confirmBody: "This cannot be undone."
 };
 
 // src/shell/app-shell-labels.ts
 var DEFAULT_APP_SHELL_MORE_LABELS = {
   more: "More",
-  moreTitle: "More pages"
+  moreTitle: "More pages",
+  overview: "Overview"
 };
 
 // src/components/account-chips-labels.ts
@@ -2031,6 +2034,7 @@ var DEFAULT_TOP_BAR_LABELS = {
   theme: "Toggle theme",
   palette: "Appearance preset",
   language: "Language",
+  languageCurrent: (name) => `Choose language, current: ${name}`,
   switchRole: "Switch role",
   role: (value) => `Role: ${value}`
 };