@eifi1/ui-kit 0.31.0 → 0.31.1

package/dist/rhf.d.ts

@@ -4,7 +4,7 @@ export { RhfCheckbox, RhfCheckboxProps, RhfCombobox, RhfComboboxProps, RhfCountr
 export { RhfLineItemCellContext, RhfLineItems, RhfLineItemsColumn, RhfLineItemsProps } from './rhf/line-items.js';
 import 'react';
 import 'react-hook-form';
-import './delete-account-setting-DCFS5Vof.js';
+import './delete-account-setting-CpIhzxxZ.js';
 import './components/tooltip.js';
 import './hooks/use-anchored-rect.js';
 import './lib/clipping.js';

package/dist/settings/settings-labels.d.ts

@@ -37,5 +37,12 @@ interface SettingsLabels {
     groups: Record<SettingsCoreGroup, SettingsGroupLabels>;
 }
 declare const DEFAULT_SETTINGS_LABELS: SettingsLabels;
+/**
+ * 0.31.1: the `settings` namespace, resolved — English, then the provider, then `labels`.
+ * What an app reads for its catalogue's core group titles and help lines, and for the
+ * page title "<group> · Settings · <app>" (settings contract §3.1), without restating
+ * the namespace and its defaults (Kurvenschmiede's 0.31 adoption).
+ */
+declare function useSettingsLabels(labels?: Partial<SettingsLabels>): SettingsLabels;
 
-export { DEFAULT_SETTINGS_LABELS, type SettingsCoreGroup, type SettingsGroupLabels, type SettingsLabels };
+export { DEFAULT_SETTINGS_LABELS, type SettingsCoreGroup, type SettingsGroupLabels, type SettingsLabels, useSettingsLabels };

package/dist/settings/settings-labels.js

@@ -1,4 +1,5 @@
 "use client";
+import { useKitLabels } from "../i18n/kit-labels.js";
 const DEFAULT_SETTINGS_LABELS = {
   title: "Settings",
   search: "Search settings",
@@ -20,7 +21,7 @@ const DEFAULT_SETTINGS_LABELS = {
     },
     security: {
       title: "Security",
-      help: "How you sign in: password, two-factor codes, passkeys and sessions."
+      help: "How you sign in, and where you are signed in."
     },
     notifications: {
       title: "Notifications",
@@ -32,7 +33,11 @@ const DEFAULT_SETTINGS_LABELS = {
     }
   }
 };
+function useSettingsLabels(labels) {
+  return useKitLabels("settings", DEFAULT_SETTINGS_LABELS, labels);
+}
 export {
-  DEFAULT_SETTINGS_LABELS
+  DEFAULT_SETTINGS_LABELS,
+  useSettingsLabels
 };
 //# sourceMappingURL=settings-labels.js.map

package/dist/settings/settings-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/settings/settings-labels.ts"],"sourcesContent":["/**\n * The `settings` namespace (docs/settings-harmonization.md §4.3): the settings page's\n * own words, and the names and help lines of the five core groups every app shares —\n * appearance, account, security, notifications, data (§2.6). An app's own groups bring\n * their own words; any core label may be overridden like any kit label (prop >\n * `<UiKitProvider labels={{ settings }}>` > English).\n */\n\n/** A core group's two strings, as {@link SettingsGroup} takes them. */\nexport interface SettingsGroupLabels {\n  /** The group's name. */\n  title: string;\n  /** One line: under the heading, and in the phone list. */\n  help: string;\n}\n\n/** The five groups whose words the kit ships (§2.6, §4.2). */\nexport type SettingsCoreGroup = \"appearance\" | \"account\" | \"security\" | \"notifications\" | \"data\";\n\nexport interface SettingsLabels {\n  /** The page's heading, and the back link's visible text on a phone's group page. */\n  title: string;\n  /** The search field's accessible name. */\n  search: string;\n  /** The search field's placeholder. */\n  searchPlaceholder: string;\n  /** The hit list's accessible name. */\n  results: string;\n  /** No hits for the trimmed query (§3.4). */\n  noMatches: (query: string) => string;\n  /** The button beside it that empties the field. */\n  clearSearch: string;\n  /** The phone's back link's accessible name: \"‹ Settings\" says where, this says what. */\n  back: string;\n  /** The sidebar's accessible name (the vertical tablist). */\n  sections: string;\n  /** A sidebar row's hit badge, read in place of the bare number while searching. */\n  matchCount: (count: number) => string;\n  /** The core groups' names and help lines. */\n  groups: Record<SettingsCoreGroup, SettingsGroupLabels>;\n}\n\nexport const DEFAULT_SETTINGS_LABELS: SettingsLabels = {\n  title: \"Settings\",\n  search: \"Search settings\",\n  searchPlaceholder: \"Search settings…\",\n  results: \"Matching settings\",\n  noMatches: (query) => `No settings match “${query}”.`,\n  clearSearch: \"Clear search\",\n  back: \"Back to settings\",\n  sections: \"Settings sections\",\n  matchCount: (count) => (count === 1 ? \"1 match\" : `${count} matches`),\n  groups: {\n    appearance: {\n      title: \"Appearance\",\n      help: \"Language, theme and how the app looks on this device.\",\n    },\n    account: {\n      title: \"Account\",\n      help: \"Your profile and your email address.\",\n    },\n    security: {\n      title: \"Security\",\n      help: \"How you sign in: password, two-factor codes, passkeys and sessions.\",\n    },\n    notifications: {\n      title: \"Notifications\",\n      help: \"What you are told about, when, and on which devices.\",\n    },\n    data: {\n      title: \"Data\",\n      help: \"Export what is yours, or delete it together with your account.\",\n    },\n  },\n};\n"],"mappings":";AA0CO,MAAM,0BAA0C;AAAA,EACrD,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,mBAAmB;AAAA,EACnB,SAAS;AAAA,EACT,WAAW,CAAC,UAAU,2BAAsB,KAAK;AAAA,EACjD,aAAa;AAAA,EACb,MAAM;AAAA,EACN,UAAU;AAAA,EACV,YAAY,CAAC,UAAW,UAAU,IAAI,YAAY,GAAG,KAAK;AAAA,EAC1D,QAAQ;AAAA,IACN,YAAY;AAAA,MACV,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,eAAe;AAAA,MACb,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,MAAM;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/settings/settings-labels.ts"],"sourcesContent":["import { useKitLabels } from \"../i18n/kit-labels\";\n\n/**\n * The `settings` namespace (docs/settings-harmonization.md §4.3): the settings page's\n * own words, and the names and help lines of the five core groups every app shares —\n * appearance, account, security, notifications, data (§2.6). An app's own groups bring\n * their own words; any core label may be overridden like any kit label (prop >\n * `<UiKitProvider labels={{ settings }}>` > English).\n */\n\n/** A core group's two strings, as {@link SettingsGroup} takes them. */\nexport interface SettingsGroupLabels {\n  /** The group's name. */\n  title: string;\n  /** One line: under the heading, and in the phone list. */\n  help: string;\n}\n\n/** The five groups whose words the kit ships (§2.6, §4.2). */\nexport type SettingsCoreGroup = \"appearance\" | \"account\" | \"security\" | \"notifications\" | \"data\";\n\nexport interface SettingsLabels {\n  /** The page's heading, and the back link's visible text on a phone's group page. */\n  title: string;\n  /** The search field's accessible name. */\n  search: string;\n  /** The search field's placeholder. */\n  searchPlaceholder: string;\n  /** The hit list's accessible name. */\n  results: string;\n  /** No hits for the trimmed query (§3.4). */\n  noMatches: (query: string) => string;\n  /** The button beside it that empties the field. */\n  clearSearch: string;\n  /** The phone's back link's accessible name: \"‹ Settings\" says where, this says what. */\n  back: string;\n  /** The sidebar's accessible name (the vertical tablist). */\n  sections: string;\n  /** A sidebar row's hit badge, read in place of the bare number while searching. */\n  matchCount: (count: number) => string;\n  /** The core groups' names and help lines. */\n  groups: Record<SettingsCoreGroup, SettingsGroupLabels>;\n}\n\nexport const DEFAULT_SETTINGS_LABELS: SettingsLabels = {\n  title: \"Settings\",\n  search: \"Search settings\",\n  searchPlaceholder: \"Search settings…\",\n  results: \"Matching settings\",\n  noMatches: (query) => `No settings match “${query}”.`,\n  clearSearch: \"Clear search\",\n  back: \"Back to settings\",\n  sections: \"Settings sections\",\n  matchCount: (count) => (count === 1 ? \"1 match\" : `${count} matches`),\n  groups: {\n    appearance: {\n      title: \"Appearance\",\n      help: \"Language, theme and how the app looks on this device.\",\n    },\n    account: {\n      title: \"Account\",\n      help: \"Your profile and your email address.\",\n    },\n    security: {\n      title: \"Security\",\n      help: \"How you sign in, and where you are signed in.\",\n    },\n    notifications: {\n      title: \"Notifications\",\n      help: \"What you are told about, when, and on which devices.\",\n    },\n    data: {\n      title: \"Data\",\n      help: \"Export what is yours, or delete it together with your account.\",\n    },\n  },\n};\n\n/**\n * 0.31.1: the `settings` namespace, resolved — English, then the provider, then `labels`.\n * What an app reads for its catalogue's core group titles and help lines, and for the\n * page title \"<group> · Settings · <app>\" (settings contract §3.1), without restating\n * the namespace and its defaults (Kurvenschmiede's 0.31 adoption).\n */\nexport function useSettingsLabels(labels?: Partial<SettingsLabels>): SettingsLabels {\n  return useKitLabels(\"settings\", DEFAULT_SETTINGS_LABELS, labels);\n}\n"],"mappings":";AAAA,SAAS,oBAAoB;AA4CtB,MAAM,0BAA0C;AAAA,EACrD,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,mBAAmB;AAAA,EACnB,SAAS;AAAA,EACT,WAAW,CAAC,UAAU,2BAAsB,KAAK;AAAA,EACjD,aAAa;AAAA,EACb,MAAM;AAAA,EACN,UAAU;AAAA,EACV,YAAY,CAAC,UAAW,UAAU,IAAI,YAAY,GAAG,KAAK;AAAA,EAC1D,QAAQ;AAAA,IACN,YAAY;AAAA,MACV,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,eAAe;AAAA,MACb,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,MAAM;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AACF;AAQO,SAAS,kBAAkB,QAAkD;AAClF,SAAO,aAAa,YAAY,yBAAyB,MAAM;AACjE;","names":[]}

package/dist/settings/settings-section.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
-import { bZ as CardTone } from '../delete-account-setting-DCFS5Vof.js';
+import { bZ as CardTone } from '../delete-account-setting-CpIhzxxZ.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
 import '../lib/clipping.js';

package/dist/shell/app-shell.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { LucideIcon } from 'lucide-react';
-import { dR as KitLinkComponent } from '../delete-account-setting-DCFS5Vof.js';
+import { dR as KitLinkComponent } from '../delete-account-setting-CpIhzxxZ.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
 import '../lib/clipping.js';

package/dist/shell/top-bar-brand.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { dS as KitLinkProps, dR as KitLinkComponent } from '../delete-account-setting-DCFS5Vof.js';
+import { dS as KitLinkProps, dR as KitLinkComponent } from '../delete-account-setting-CpIhzxxZ.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
 import '../lib/clipping.js';

package/dist/shell.d.ts

@@ -13,7 +13,7 @@ export { SettingsSection, SettingsSectionProps } from './settings/settings-secti
 export { SettingsLayoutContextValue, useSettingsLayout } from './settings/settings-context.js';
 export { SettingsHeadingLevel, SettingsHeadingLevelProps, SettingsHeadingTag, useSettingsHeadingLevel } from './settings/settings-heading.js';
 export { SettingsEntry, SettingsGroup, SettingsSearchEntriesOptions, settingsHref, settingsSearchEntries, visibleSettingsEntries, visibleSettingsGroups } from './settings/settings-catalogue.js';
-export { DEFAULT_LAST_VISITED_EXCLUDES, LastVisitedPageOptions, NEXT_PARAM, PathPattern, RedirectIfAuthed, RedirectIfAuthedProps, RootEntry, RootEntryProps, clearLastVisitedPage, readLastVisitedPage, safeNextPath, useLastVisitedPage } from './landing/routing.js';
+export { DEFAULT_LAST_VISITED_EXCLUDES, LastVisitedPageOptions, NEXT_PARAM, PathPattern, RedirectIfAuthed, RedirectIfAuthedProps, RootEntry, RootEntryProps, RoutingSession, clearLastVisitedPage, readLastVisitedPage, safeNextPath, useLastVisitedPage } from './landing/routing.js';
 export { PublicHeader, PublicHeaderBrand, PublicHeaderProps } from './landing/public-header.js';
 import 'react';
 import './theme/palette-presets.js';
@@ -22,7 +22,7 @@ import './theme/theme-store.js';
 import 'zustand/middleware';
 import 'zustand';
 import 'lucide-react';
-import './delete-account-setting-DCFS5Vof.js';
+import './delete-account-setting-CpIhzxxZ.js';
 import './components/tooltip.js';
 import './hooks/use-anchored-rect.js';
 import './lib/clipping.js';

package/dist/shell.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type { RootEntryProps, RedirectIfAuthedProps, LastVisitedPageOptions, PathPattern } from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,oBAAoB;","names":[]}
+{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type {\n  RootEntryProps,\n  RedirectIfAuthedProps,\n  RoutingSession,\n  LastVisitedPageOptions,\n  PathPattern,\n} from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oBAAoB;","names":[]}

package/dist/wizard/stepper-nav.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
-import { bH as ButtonVariant } from '../delete-account-setting-DCFS5Vof.js';
+import { bH as ButtonVariant } from '../delete-account-setting-CpIhzxxZ.js';
 import { UseWizardReturn, WizardLabels } from './types.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';

package/dist/wizard.d.ts

@@ -6,7 +6,7 @@ export { WizardStep, WizardStepProps } from './wizard/wizard-step.js';
 export { WizardSummary } from './wizard/wizard-summary.js';
 export { StepperNav } from './wizard/stepper-nav.js';
 import 'react';
-import './delete-account-setting-DCFS5Vof.js';
+import './delete-account-setting-CpIhzxxZ.js';
 import './components/tooltip.js';
 import './hooks/use-anchored-rect.js';
 import './lib/clipping.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eifi1/ui-kit",
-  "version": "0.31.0",
+  "version": "0.31.1",
   "type": "module",
   "description": "App-agnostic shared design system: domain-free React components, theme and tokens.",
   "_sideEffects": "The barrel (src/index.ts) re-exports EVERY component, including components/chart, which statically imports recharts. Without this field a bundler must assume each of those modules has side effects, so it cannot drop the unused ones: importing a Button from '@eifi1/ui-kit' dragged all 433KB of recharts into the consumer's ENTRY chunk, and Keksdose was preloading it on every page load, login included. Nothing in src/ imports for side effects (no bare imports, no CSS imports from JS, no module-level global writes) — the token stylesheet is its own './tokens.css' export — so this is safe. CSS is still listed so any future stylesheet survives. Re-checked when `flag-icons` left `dependencies` and tsup started emitting a `\"use client\"` banner: neither touches this. The flag stylesheet was never imported from JS in the first place (that was the finding), and a directive prologue is a string literal every bundler lifts out before it decides whether a module is inert.",

package/src/admin/admin-parts.ts

@@ -16,11 +16,18 @@ import { formatPersonName } from "../lib/person-name";
 export type MaybePromise<T = unknown> = void | Promise<T>;
 
 /** A person as the admin parts show one: the two name parts of the auth contract
- *  (§3.2), an older whole `name` as the fallback, and the address. */
+ *  (§3.2), an older whole `name` as the fallback, and the address. The name parts are
+ *  read in either spelling — the kit's `first` / `last`, or server-kit's `PersonRef`
+ *  as it serialises (`first_name` / `last_name`), so an app hands the server's object
+ *  over as it came (keksdose's and kastlan's 0.30 adoptions mapped one to the other). */
 export interface AdminPerson {
   id?: string | number | null;
   first?: string | null;
   last?: string | null;
+  /** server-kit `PersonRef.first_name`; `first` wins when both are given. */
+  first_name?: string | null;
+  /** server-kit `PersonRef.last_name`; `last` wins when both are given. */
+  last_name?: string | null;
   /** A whole name, for an API that still sends `display_name` only. */
   name?: string | null;
   email?: string | null;
@@ -39,7 +46,7 @@ export function hasMessage(node: ReactNode): boolean {
 export function personLabel(person: AdminPerson | null | undefined, locale: string | undefined): string {
   if (!person) return "";
   return (
-    formatPersonName({ first: person.first, last: person.last }, locale) ||
+    formatPersonName({ first: person.first ?? person.first_name, last: person.last ?? person.last_name }, locale) ||
     (person.name ?? "").trim() ||
     (person.email ?? "").trim()
   );

package/src/auth/reset-password-form.tsx

@@ -144,7 +144,7 @@ export interface ResetPasswordFormProps
   forgotHref?: string;
   /** The app's words for a failed save (the device offline), or `undefined` for the
    *  kit's: `rateLimited` for a bare `429` (0.30.0), else `failed`. Not asked for
-   *  `token_invalid`, which is a state. */
+   *  `token_invalid` or `token_expired`, which are a state. */
   describeError?: (error: unknown) => ReactNode | undefined;
   /** The heading. Default `labels.title`; `null` draws none, for a page that puts it
    *  in `AuthLayout`'s `title` instead. */
@@ -299,7 +299,11 @@ export function ResetPasswordForm({
         },
         (error: unknown) => {
           setPending(false);
-          if (authErrorCode(error) === "token_invalid") {
+          // A link that died between the check and the save — used, or run out — is the
+          // dead-link state, under either code (0.31.1: keksdose mapped `token_expired`
+          // to it itself, `asDeadLink`).
+          const code = authErrorCode(error);
+          if (code === "token_invalid" || code === "token_expired") {
             setPassword("");
             setConfirm("");
             setPhase({ token, phase: { kind: "invalid" } });

package/src/auth/verify-email.tsx

@@ -8,7 +8,7 @@ import { AlertBanner } from "../components/alert-banner";
 import { LoadingState } from "../components/loading-state";
 import { Button, EmptyState } from "../components/ui";
 import { OUTCOME_CLASS, STATUS_HEADING_CLASS, isThenable, useOncePerKey } from "./status-parts";
-import { authErrorCode } from "./auth-errors";
+import { authErrorCode, englishRateLimited, isRateLimited, retryAfterSeconds } from "./auth-errors";
 import type { AuthHeadingLevel } from "./status-parts";
 
 /* ── Labels ──────────────────────────────────────────────────────────────── */
@@ -41,6 +41,10 @@ export interface VerifyEmailLabels {
   resent: string;
   /** Said (and shown) after a resend failed. */
   resendError: string;
+  /** 0.31.1: a resend refused as throttled — HTTP 429 (`isRateLimited`) — given the
+   *  `Retry-After` seconds, when the app's `describeError` has no words of its own
+   *  (keksdose borrowed the sign-in namespace's). */
+  rateLimited?: (seconds?: number) => string;
   /** The banner's message. */
   banner: string;
   /** The banner's ×: it defers, it does not close anything. */
@@ -62,6 +66,7 @@ export const DEFAULT_VERIFY_EMAIL_LABELS: VerifyEmailLabels = {
   resendIn: (seconds) => `Send again in ${seconds} s`,
   resent: "Confirmation email sent",
   resendError: "Could not send the confirmation email",
+  rateLimited: englishRateLimited,
   banner: "Please confirm your email address.",
   dismiss: "Not now",
 };
@@ -160,7 +165,14 @@ function ResendStatus({
   labels: VerifyEmailLabels;
   className?: string;
 }) {
-  const failed = phase === "failed" ? (describeError?.(error) ?? labels.resendError) : "";
+  // The app's words first, then the throttle's, then the kit's catch-all.
+  const failed =
+    phase === "failed"
+      ? (describeError?.(error) ??
+        (isRateLimited(error)
+          ? (labels.rateLimited ?? englishRateLimited)(retryAfterSeconds(error))
+          : labels.resendError))
+      : "";
   return (
     <span
       role="status"

package/src/components/confirm-dialog.tsx

@@ -6,6 +6,7 @@ import { TypedConfirmField, typedMatches } from "./danger-confirm";
 import type { TypedMatch } from "./danger-confirm";
 import { DialogFrame } from "./dialog-frame";
 import { Button } from "./ui";
+import { useWriteLock } from "./write-lock";
 
 /**
  * The `confirmDialog` namespace of `<UiKitProvider labels>`: the two buttons' fallback
@@ -76,6 +77,14 @@ export interface ConfirmOptions {
    * keeps spaces too — for a phrase like "DELETE" whose contract is "exactly this".
    */
   typedMatch?: TypedMatch;
+  /**
+   * 0.31.1: the confirm button COMMITS, as `Button`'s `commit` does. Under a locked
+   * `WriteLockProvider` — read where `useConfirm` was called, not where the one dialog
+   * host sits — it is `aria-disabled` with the lock's reason, so a read-only page (a
+   * demo, a viewer's budget) can't confirm a delete through a dialog. One prop for the
+   * many confirm sites an app has (kastlan's 0.31 adoption counted ~23).
+   */
+  commit?: boolean;
 }
 
 export type ConfirmFn = (options: ConfirmOptions) => Promise<boolean>;
@@ -97,12 +106,21 @@ export function useConfirm(): ConfirmFn {
   if (!confirm) {
     throw new Error("useConfirm() must be called below a <ConfirmProvider>.");
   }
-  return confirm;
+  // The lock of the CALLER's place: the dialog host usually sits above the app's
+  // `WriteLockProvider`, so it could not read the lock itself.
+  const lock = useWriteLock();
+  return useCallback(
+    (options: ConfirmOptions) =>
+      confirm(options.commit && lock.locked ? ({ ...options, lockReason: lock.reason } as ConfirmOptions) : options),
+    [confirm, lock.locked, lock.reason],
+  );
 }
 
 interface Request extends ConfirmOptions {
   id: number;
   resolve: (answer: boolean) => void;
+  /** Set by {@link useConfirm} for a `commit` confirm under a locked provider. */
+  lockReason?: ReactNode;
 }
 
 export interface ConfirmProviderProps {
@@ -279,6 +297,7 @@ function ConfirmDialogView({
             type="button"
             variant={tone === "danger" ? "danger" : "primary"}
             disabled={!matches}
+            disabledReason={request.lockReason}
             onClick={() => {
               accepted.current = true;
               close();

package/src/i18n/german.ts

@@ -994,6 +994,7 @@ export function germanLabels(numberLocale: string): UiKitLabels {
       resendIn: (seconds) => `In ${n(seconds)} s erneut senden`,
       resent: "Bestätigungs-E-Mail gesendet",
       resendError: "Bestätigungs-E-Mail konnte nicht gesendet werden",
+      rateLimited,
       banner: "Bitte bestätigen Sie Ihre E-Mail-Adresse.",
       dismiss: "Später",
     },
@@ -1398,7 +1399,7 @@ export function germanLabels(numberLocale: string): UiKitLabels {
         },
         security: {
           title: "Sicherheit",
-          help: "Wie Sie sich anmelden: Passwort, Zwei-Faktor-Codes, Passkeys und Sitzungen.",
+          help: "Wie Sie sich anmelden und wo Sie angemeldet sind.",
         },
         notifications: {
           title: "Benachrichtigungen",

package/src/i18n/locales/es.ts

@@ -975,6 +975,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       resendIn: (seconds) => `Enviar de nuevo en ${n(seconds)} s`,
       resent: "Correo de confirmación enviado",
       resendError: "No se pudo enviar el correo de confirmación",
+      rateLimited,
       banner: "Confirme su dirección de correo electrónico.",
       dismiss: "Ahora no",
     },
@@ -1363,7 +1364,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
         },
         security: {
           title: "Seguridad",
-          help: "Cómo inicia sesión: contraseña, verificación en dos pasos, llaves de acceso y sesiones.",
+          help: "Cómo inicia sesión, y en qué dispositivos tiene la sesión abierta.",
         },
         notifications: {
           title: "Notificaciones",

package/src/i18n/locales/fr.ts

@@ -997,6 +997,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       resendIn: (seconds) => `Envoyer à nouveau dans ${n(seconds)}\u00a0s`,
       resent: "E-mail de confirmation envoyé",
       resendError: "Impossible d’envoyer l’e-mail de confirmation",
+      rateLimited,
       banner: "Veuillez confirmer votre adresse e-mail.",
       dismiss: "Pas maintenant",
     },
@@ -1390,7 +1391,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
         },
         security: {
           title: "Sécurité",
-          help: "Comment vous vous connectez\u00a0: mot de passe, codes 2FA, clés d’accès et sessions.",
+          help: "Votre connexion, et les appareils où elle est ouverte.",
         },
         notifications: {
           title: "Notifications",

package/src/i18n/locales/hu.ts

@@ -986,6 +986,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       resendIn: (seconds) => `Újraküldés ${n(seconds)} mp múlva`,
       resent: "Megerősítő e-mail elküldve",
       resendError: "Nem sikerült elküldeni a megerősítő e-mailt",
+      rateLimited,
       banner: "Kérjük, erősítse meg az e-mail-címét.",
       dismiss: "Most nem",
     },
@@ -1365,7 +1366,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
         },
         security: {
           title: "Biztonság",
-          help: "Hogyan jelentkezik be: jelszó, ellenőrző kódok, hozzáférési kulcsok és munkamenetek.",
+          help: "Hogyan jelentkezik be, és hol van bejelentkezve.",
         },
         notifications: {
           title: "Értesítések",

package/src/i18n/locales/it.ts

@@ -982,6 +982,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       resendIn: (seconds) => `Invia di nuovo tra ${n(seconds)} s`,
       resent: "Email di conferma inviata",
       resendError: "Impossibile inviare l’email di conferma",
+      rateLimited,
       banner: "Confermi il Suo indirizzo email.",
       dismiss: "Non ora",
     },
@@ -1374,7 +1375,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
         },
         security: {
           title: "Sicurezza",
-          help: "Come accede: password, codici 2FA, passkey e sessioni.",
+          help: "Come accede, e su quali dispositivi la sessione è aperta.",
         },
         notifications: {
           title: "Notifiche",

package/src/i18n/locales/zh.ts

@@ -949,6 +949,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       resendIn: (seconds) => `${n(seconds)} 秒后可重新发送`,
       resent: "确认邮件已发送",
       resendError: "无法发送确认邮件",
+      rateLimited,
       banner: "请确认您的电子邮箱地址。",
       dismiss: "暂不",
     },
@@ -1308,7 +1309,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
         },
         security: {
           title: "安全",
-          help: "您的登录方式：密码、双重验证码、通行密钥和会话。",
+          help: "您的登录方式，以及已在哪些设备上登录。",
         },
         notifications: {
           title: "通知",

package/src/i18n/review.ts

@@ -309,6 +309,7 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "register.rateLimited": [[], [30], [300]],
   "forgotPassword.rateLimited": [[], [30], [300]],
   "resetPassword.rateLimited": [[], [30], [300]],
+  "verifyEmail.rateLimited": [[], [30], [300]],
   "emailChange.emailTagUse": [["{{address}}"]],
   "emailChange.pending": [["{{newEmail}}"]],
   "emailChange.pendingHint": [["{{currentEmail}}"]],

package/src/index.ts

@@ -667,7 +667,7 @@ export {
   settingsHref,
 } from "./settings/settings-catalogue";
 export type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from "./settings/settings-catalogue";
-export { DEFAULT_SETTINGS_LABELS } from "./settings/settings-labels";
+export { DEFAULT_SETTINGS_LABELS, useSettingsLabels } from "./settings/settings-labels";
 export type { SettingsLabels, SettingsGroupLabels, SettingsCoreGroup } from "./settings/settings-labels";
 // Only the language follows the account (§6.2).
 export { useAccountLanguage, resolveAccountLanguage, matchOfferedLanguage } from "./settings/use-account-language";
@@ -709,7 +709,13 @@ export {
   NEXT_PARAM,
   DEFAULT_LAST_VISITED_EXCLUDES,
 } from "./landing/routing";
-export type { RootEntryProps, RedirectIfAuthedProps, LastVisitedPageOptions, PathPattern } from "./landing/routing";
+export type {
+  RootEntryProps,
+  RedirectIfAuthedProps,
+  RoutingSession,
+  LastVisitedPageOptions,
+  PathPattern,
+} from "./landing/routing";
 export { PublicHeader } from "./landing/public-header";
 export type { PublicHeaderProps, PublicHeaderBrand } from "./landing/public-header";
 export { DEFAULT_DEMO_LABELS, useDemoLabels } from "./demo/demo-labels";

package/src/landing/landing-actions.tsx

@@ -23,8 +23,10 @@ export interface LandingActionsProps extends Omit<ComponentPropsWithoutRef<"div"
   session: LandingSession;
   access: AccessChoice;
   /** "Try the demo" without a session, "Continue the demo" with a demo one. Default
-   *  `/demo`, which starts a demo — or, for a live one, continues it (§3.1). */
-  demoHref?: string;
+   *  `/demo`, which starts a demo — or, for a live one, continues it (§3.1). `null`
+   *  (0.31.1): the app has no demo yet, and the action is left out — "Request access"
+   *  stands alone (Kurvenschmiede's 0.31 adoption). */
+  demoHref?: string | null;
   /** "Open app" for a real session: the resume target. Default `/`, which resumes
    *  through `RootEntry`. */
   openAppHref?: string;
@@ -82,9 +84,11 @@ export function LandingActions({
           <Button href={accessLink.href} variant="brand" size={buttonSize} className={extra}>
             {accessLink.label}
           </Button>
-          <Button href={demoHref} variant="secondary" size={buttonSize} className={extra}>
-            {session === "demo" ? labels.continueDemo : labels.tryDemo}
-          </Button>
+          {demoHref !== null && (
+            <Button href={demoHref} variant="secondary" size={buttonSize} className={extra}>
+              {session === "demo" ? labels.continueDemo : labels.tryDemo}
+            </Button>
+          )}
         </>
       )}
     </div>

package/src/landing/routing.tsx

@@ -4,6 +4,15 @@ import { Navigate, Outlet, useLocation } from "react-router";
 
 import { readStored, writeStored } from "../lib/safe-storage";
 import type { LandingSession } from "./landing-actions";
+import { LoadingState } from "../components/loading-state";
+
+/**
+ * 0.31.1: a session that is still being restored — an app whose access token lives in
+ * memory reads it back from its refresh token first (kastlan's 0.31 adoption). Until
+ * then `/` neither shows the landing nor resumes, and a public page neither shows nor
+ * redirects: both render `loading` instead.
+ */
+export type RoutingSession = LandingSession | "loading";
 
 /**
  * The public routes' logic (docs/landing-demo-harmonization.md §3): what `/` shows,
@@ -144,8 +153,11 @@ export function clearLastVisitedPage(key: string): void {
 /* ── RootEntry ───────────────────────────────────────────────────────────── */
 
 export interface RootEntryProps {
-  /** Without a session `/` is the landing; with one (real or demo) it resumes. */
-  session: LandingSession;
+  /** Without a session `/` is the landing; with one (real or demo) it resumes;
+   *  `"loading"` while the app restores one. */
+  session: RoutingSession;
+  /** What shows while `session` is `"loading"`. Default: the kit's `LoadingState`. */
+  loading?: ReactNode;
   /** The remembered page — `readLastVisitedPage(key)`. */
   resumePath?: string | null;
   /** The landing page element. */
@@ -164,7 +176,8 @@ export interface RootEntryProps {
  * home instead, because a session at `/` came to use the app. The landing stays one tap
  * away at `/welcome`, where the signed-in brand link points.
  */
-export function RootEntry({ session, resumePath, landing, home }: RootEntryProps) {
+export function RootEntry({ session, resumePath, landing, home, loading }: RootEntryProps) {
+  if (session === "loading") return <>{loading ?? <LoadingState />}</>;
   if (session === "none") return <>{landing}</>;
   const resume = safeNextPath(resumePath);
   return <Navigate to={resume && resume !== "/" ? resume : home} replace />;
@@ -173,7 +186,10 @@ export function RootEntry({ session, resumePath, landing, home }: RootEntryProps
 /* ── RedirectIfAuthed ────────────────────────────────────────────────────── */
 
 export interface RedirectIfAuthedProps {
-  session: LandingSession;
+  /** `"loading"` while the app restores a session: neither the page nor a redirect. */
+  session: RoutingSession;
+  /** What shows while `session` is `"loading"`. Default: the kit's `LoadingState`. */
+  loading?: ReactNode;
   /**
    * Let a DEMO session through (§5.6): on `/login`, `/register` and the app's invitation
    * pages, so a demo visitor can sign in or accept an invitation — a successful one
@@ -199,8 +215,9 @@ export interface RedirectIfAuthedProps {
  * `allowDemo` around `/login`, `/register` and the invitation pages, and one without
  * around `/demo` (and `/forgot-password`).
  */
-export function RedirectIfAuthed({ session, allowDemo = false, fallback, children }: RedirectIfAuthedProps) {
+export function RedirectIfAuthed({ session, allowDemo = false, fallback, children, loading }: RedirectIfAuthedProps) {
   const { search } = useLocation();
+  if (session === "loading") return <>{loading ?? <LoadingState />}</>;
   if (session === "none" || (session === "demo" && allowDemo)) {
     return children === undefined ? <Outlet /> : <>{children}</>;
   }

package/src/settings/settings-labels.ts

@@ -1,3 +1,5 @@
+import { useKitLabels } from "../i18n/kit-labels";
+
 /**
  * The `settings` namespace (docs/settings-harmonization.md §4.3): the settings page's
  * own words, and the names and help lines of the five core groups every app shares —
@@ -61,7 +63,7 @@ export const DEFAULT_SETTINGS_LABELS: SettingsLabels = {
     },
     security: {
       title: "Security",
-      help: "How you sign in: password, two-factor codes, passkeys and sessions.",
+      help: "How you sign in, and where you are signed in.",
     },
     notifications: {
       title: "Notifications",
@@ -73,3 +75,13 @@ export const DEFAULT_SETTINGS_LABELS: SettingsLabels = {
     },
   },
 };
+
+/**
+ * 0.31.1: the `settings` namespace, resolved — English, then the provider, then `labels`.
+ * What an app reads for its catalogue's core group titles and help lines, and for the
+ * page title "<group> · Settings · <app>" (settings contract §3.1), without restating
+ * the namespace and its defaults (Kurvenschmiede's 0.31 adoption).
+ */
+export function useSettingsLabels(labels?: Partial<SettingsLabels>): SettingsLabels {
+  return useKitLabels("settings", DEFAULT_SETTINGS_LABELS, labels);
+}

package/src/shell.ts

@@ -52,6 +52,12 @@ export {
   NEXT_PARAM,
   DEFAULT_LAST_VISITED_EXCLUDES,
 } from "./landing/routing";
-export type { RootEntryProps, RedirectIfAuthedProps, LastVisitedPageOptions, PathPattern } from "./landing/routing";
+export type {
+  RootEntryProps,
+  RedirectIfAuthedProps,
+  RoutingSession,
+  LastVisitedPageOptions,
+  PathPattern,
+} from "./landing/routing";
 export { PublicHeader } from "./landing/public-header";
 export type { PublicHeaderProps, PublicHeaderBrand } from "./landing/public-header";