@eifi1/ui-kit 0.52.0 → 0.53.0

package/src/index.ts

@@ -122,13 +122,11 @@ export type {
   TranslationReviewSwipeAction,
   TranslationReviewSwipeBinding,
 } from "./lib/translation-review";
-// 0.22.0, the inputs round: the country list and the IBAN, ISIN and phone helpers that
+// 0.22.0, the inputs round: the country list and the IBAN and phone helpers that
 // CountrySelect, IbanInput and PhoneInput are built on.
 export { COUNTRY_CODES, countryName } from "./lib/countries";
 export { IBAN_LENGTHS, compactIban, formatIban, ibanCheckDigits, ibanProblem, isValidIban, isQrIban } from "./lib/iban";
 export type { IbanKind, IbanProblem } from "./lib/iban";
-// 0.52: deprecated, removed in 0.53 (MOD-5; tagged in lib/isin).
-export { formatIsin, isinCheckDigit, isValidIsin } from "./lib/isin";
 export { PHONE_DIAL_CODES, PHONE_COUNTRIES, parsePhone, formatNationalPhone, formatPhone, isE164 } from "./lib/phone";
 export type { PhoneCountryCode, PhoneCountry, ParsedPhone } from "./lib/phone";
 // 0.23.0: ColumnMapper's pure half (Kurvenschmiede's columns input, keksdose's import map).
@@ -177,14 +175,9 @@ export type { LongPressOptions, LongPressResult } from "./hooks/use-long-press";
 export { useNoIndex } from "./hooks/use-noindex";
 // 0.49 KIT-9: the window's title from page, section and app, in the provider's format.
 export { useDocumentTitle } from "./hooks/use-document-title";
-// 0.49 KIT-1b: U+2212 before a number as "-", the copy handler's rule, for an app's text.
-// 0.52: deprecated with the other 54 names no app, test or showcase page reads (refactor
-// audit 2026-10-30, API-4, decision 4). Each is tagged on its specifier here, not on its
-// declaration: the module keeps it for the kit's own use, only the barrel lets it go.
-export {
-  /** @deprecated 0.52 — a formatter's `minus: "ascii"`, where the figure is made (API-4); removed in 0.53 */
-  asciiMinusInNumbers,
-} from "./lib/clipboard-minus";
+// 0.53: the 55 names no app reads left the entry points (deprecated in 0.52, refactor audit
+// 2026-10-30, API-4, decision 4) — here 0.49 KIT-1b's `asciiMinusInNumbers`, the copy
+// handler's rule, among them. Their modules keep the ones the kit itself uses.
 export { DEFAULT_DOCUMENT_TITLE_FORMAT, formatDocumentTitle } from "./lib/document-title";
 export type { DocumentTitleParts } from "./lib/document-title";
 export type { SwipeStage, RowSwipeOptions, RowSwipeReturn } from "./hooks/use-row-swipe";
@@ -344,11 +337,6 @@ export * from "./components/multi-select";
 export * from "./components/tooltip";
 export * from "./components/user-avatar";
 export * from "./components/settings-fields";
-// Sync state for a database-backed field: the engine (`useFieldSync`) and the
-// affordance (`FieldSyncIndicator`), kept separate because the state is useful
-// without the dot — a form can gate its submit on any field being `pending`.
-// 0.52: deprecated as a whole, removed in 0.53 (MOD-5; tagged in the module).
-export * from "./components/field-sync";
 export * from "./components/month-picker";
 export * from "./components/checkbox";
 export * from "./components/switch";
@@ -422,9 +410,6 @@ export * from "./components/alert-banner";
 export * from "./components/toggle-group";
 // A wrapping set of links/buttons marked `aria-current` — Tabs-like looks, not tabs.
 export * from "./components/nav-pills";
-// 0.49.0 (KIT-6): a section's pages on the phone, one scrolling row of pills. 0.52:
-// deprecated, removed in 0.53 (MOD-5; tagged in the module).
-export * from "./components/section-nav";
 // A pill carrying one VALUE — inert, a link, or a toggle, depending on which prop it is
 // given — and the list field built from it. Distinct from Button on purpose: a row of
 // buttons reads as "choose an action", a row of chips as "here are the things".
@@ -441,10 +426,15 @@ export * from "./components/full-bleed-dialog";
 export * from "./components/grouped-picker";
 export * from "./components/file-dropzone";
 export * from "./components/mini-calendar";
-export * from "./components/calendar-heatmap";
+// Named, not `*`: `heatmapLevel` is CalendarHeatmap's own since 0.53 (API-4).
 export {
-  /** @deprecated 0.52 — `CalendarHeatmap`, which steps its cells with it (API-4); removed in 0.53 */
-  heatmapLevel,
+  CalendarHeatmap,
+  DEFAULT_CALENDAR_HEATMAP_LABELS,
+  heatmapWindowEnd,
+  type CalendarHeatmapLabels,
+  type CalendarHeatmapDatum,
+  type CalendarHeatmapDay,
+  type CalendarHeatmapProps,
 } from "./components/calendar-heatmap";
 export * from "./components/date-picker";
 export * from "./components/tree-view";
@@ -465,13 +455,9 @@ export {
   COMMIT_EXCEPT_BILLING,
   DEFAULT_WRITE_LOCK_LABELS,
 } from "./components/write-lock";
-// 0.46 (kastlan K4): the offline lock kind, its scope and its source.
-export {
-  /** @deprecated 0.52 — the kind itself, `"offline"`, which `useOfflineWriteLock` holds (API-4); removed in 0.53 */
-  OFFLINE_LOCK,
-  COMMIT_EXCEPT_OFFLINE,
-  useOfflineWriteLock,
-} from "./components/write-lock";
+// 0.46 (kastlan K4): the offline lock's scope and its source (the kind, `OFFLINE_LOCK`, left
+// the surface in 0.53: it is the string "offline").
+export { COMMIT_EXCEPT_OFFLINE, useOfflineWriteLock } from "./components/write-lock";
 export type {
   WriteLock,
   WriteLockLabels,
@@ -535,10 +521,12 @@ export * from "./components/error-boundary";
 export * from "./components/copy-button";
 export { AuthedImage, DEFAULT_AUTHED_IMAGE_LABELS } from "./components/authed-image";
 export type { AuthedImageProps, AuthedImageLabels } from "./components/authed-image";
-export * from "./components/image-grid";
+// Named, not `*`: `splitFileName` is ImageGrid's own since 0.53 (API-4).
 export {
-  /** @deprecated 0.52 — `ImageGrid`, which shortens its file names with it (API-4); removed in 0.53 */
-  splitFileName,
+  ImageGrid,
+  DEFAULT_IMAGE_GRID_LABELS,
+  type ImageGridLabels,
+  type ImageGridProps,
 } from "./components/image-grid";
 export * from "./components/lightbox";
 export * from "./components/button-group";
@@ -567,17 +555,7 @@ export type {
 // The toast layer over sonner (an OPTIONAL peer, loaded lazily): `toast` mirrors sonner's
 // API so apps migrate by swapping the import; `<Toaster>` carries the placement, theme,
 // tones and z-index both apps had wired by hand.
-export {
-  toast,
-  Toaster,
-  DEFAULT_TOAST_LABELS,
-  /** @deprecated 0.52 — `toast()`, which times a toast with an action by it (API-4); removed in 0.53 */
-  TOAST_ACTION_DURATION,
-  /** @deprecated 0.52 — `<Toaster>`, whose default `offset` it is (API-4); removed in 0.53 */
-  TOASTER_OFFSET_TOP,
-  /** @deprecated 0.52 — `<Toaster>`, whose default `offset` it is (API-4); removed in 0.53 */
-  TOASTER_OFFSET_BOTTOM,
-} from "./components/toast";
+export { toast, Toaster, DEFAULT_TOAST_LABELS } from "./components/toast";
 export type {
   ToastId,
   ToastAction,
@@ -682,8 +660,6 @@ export {
   // 0.47.0 (keksdose N17): a hand-built table's actions heading and cell.
   RowActionsHead,
   ROW_ACTIONS_CELL_CLASS,
-  /** @deprecated 0.52 — `RowActionsHead`, which draws it (API-4); removed in 0.53 */
-  ROW_ACTIONS_HEAD_CLASS,
 } from "./components/row-actions";
 export type {
   RowAction,
@@ -704,8 +680,6 @@ export * from "./components/one-time-code-input";
 export * from "./components/language-select";
 export * from "./components/tile-radio";
 export * from "./components/inline-edit-field";
-// 0.52: deprecated, removed in 0.53 (MOD-5; tagged in the module).
-export * from "./components/sign-chip";
 export * from "./components/country-select";
 export * from "./components/iban-input";
 export * from "./components/phone-input";
@@ -859,13 +833,9 @@ export type { DataExportSettingProps, DataExportLabels, DataExportFile } from ".
 // 0.30.0 (docs/user-admin-harmonization.md): the admin user list and its actions, and the
 // invitations panel. Callbacks only; the confirmation level is the server's.
 export {
-  /** @deprecated 0.52 — `useUserRosterColumns`, the same columns in the provider's words (API-4); removed in 0.53 */
-  userRosterColumns,
   useUserRosterColumns,
   UserIdentityCell,
   UserRowActions,
-  /** @deprecated 0.52 — `useUserRosterColumns`, whose state cell reads it (API-4); removed in 0.53 */
-  adminUserStates,
   userRosterSort,
   USER_ROSTER_SORT_KEYS,
   DEFAULT_USER_ROSTER_LABELS,
@@ -945,13 +915,7 @@ export { adminSectionOrder } from "./admin/admin-sections";
 export type { AdminSectionPlace, AdminSectionOrderOptions, AdminKeptSection } from "./admin/admin-sections";
 export { AdminForbidden } from "./admin/admin-forbidden";
 export type { AdminForbiddenProps } from "./admin/admin-forbidden";
-export {
-  AdminOverview,
-  AttentionTile,
-  adminWaitingCount,
-  /** @deprecated 0.52 — `AdminOverview`, which links its tiles there unless told otherwise (API-4); removed in 0.53 */
-  DEFAULT_ADMIN_ATTENTION_HREFS,
-} from "./admin/admin-overview";
+export { AdminOverview, AttentionTile, adminWaitingCount } from "./admin/admin-overview";
 export type {
   AdminAttention,
   AdminAttentionTile,
@@ -966,23 +930,10 @@ export type {
 export { AdminToolLinks } from "./admin/admin-tool-links";
 export type { AdminToolLink, AdminToolLinksProps } from "./admin/admin-tool-links";
 // 0.45.0 (docs/admin-harmonization.md §9.2.4): "Send a test mail to me".
-export {
-  MailTestCard,
-  DEFAULT_MAIL_TEST_CARD_LABELS,
-  MAIL_TEST_ANCHOR,
-  /** @deprecated 0.52 — `MailTestCard`, which masks the address itself (API-4); removed in 0.53 */
-  maskMailAddress,
-} from "./admin/mail-test-card";
+export { MailTestCard, DEFAULT_MAIL_TEST_CARD_LABELS, MAIL_TEST_ANCHOR } from "./admin/mail-test-card";
 export type { MailTestCardProps, MailTestCardLabels, MailTestAnswer } from "./admin/mail-test-card";
 // 0.33.0: the operator's plan parts (docs/billing-harmonization.md §14.12).
-export {
-  /** @deprecated 0.52 — `usePlanColumn`, the same column in the provider's words (API-4); removed in 0.53 */
-  planColumn,
-  usePlanColumn,
-  PlanChangeConfirm,
-  usePlanChangeResult,
-  DEFAULT_PLAN_CHANGE_LABELS,
-} from "./admin/plan-change";
+export { usePlanColumn, PlanChangeConfirm, usePlanChangeResult, DEFAULT_PLAN_CHANGE_LABELS } from "./admin/plan-change";
 export type {
   PlanChangeLabels,
   PlanColumnOptions,
@@ -1007,13 +958,7 @@ export type {
   PlanPrices,
   PlanPriceAnswer,
 } from "./billing/plan-price";
-export {
-  PlanCard,
-  PlanPicker,
-  GrantWarningConfirm,
-  /** @deprecated 0.52 — `PlanPicker`, which marks each card's relation itself (API-4); removed in 0.53 */
-  planRelation,
-} from "./billing/plan-card";
+export { PlanCard, PlanPicker, GrantWarningConfirm } from "./billing/plan-card";
 export type {
   BillingPlan,
   PlanRelation,
@@ -1047,21 +992,10 @@ export {
   withoutCheckoutReturn,
   checkoutReturnUrl,
 } from "./billing/checkout-return";
-export {
-  checkoutFingerprint,
-  /** @deprecated 0.52 — `useCheckoutProcessing`, which asks it (API-4); removed in 0.53 */
-  checkoutLanded,
-  noteCheckoutStarted,
-  useCheckoutProcessing,
-} from "./billing/checkout-processing";
+export { checkoutFingerprint, noteCheckoutStarted, useCheckoutProcessing } from "./billing/checkout-processing";
 export type { CheckoutOverview, CheckoutProcessingOptions } from "./billing/checkout-processing";
 // The link to the pay page and Paddle's locale (§14.4); the page itself ships as dist/pay/.
-export {
-  /** @deprecated 0.52 — `payPageUrl`, which writes it (API-4); removed in 0.53 */
-  PAY_PAGE_LANG_PARAM,
-  paddleLocale,
-  payPageUrl,
-} from "./billing/pay-page";
+export { paddleLocale, payPageUrl } from "./billing/pay-page";
 export type { PaddleEnvironment } from "./billing/pay-page";
 // 0.39 (§15.2.6): the apps every pay page serves, by their `billing_app` tag.
 export { PAY_PAGE_APPS } from "./billing/pay-page";
@@ -1111,11 +1045,7 @@ export type {
   ResolveAccountLanguageInput,
   ResolvedAccountLanguage,
 } from "./settings/use-account-language";
-export {
-  useAccountAppearance,
-  /** @deprecated 0.52 — `useAccountAppearance`, which resolves the same three values (API-4); removed in 0.53 */
-  resolveAccountAppearance,
-} from "./settings/use-account-appearance";
+export { useAccountAppearance } from "./settings/use-account-appearance";
 export type {
   AppearanceSource,
   AccountAppearanceFields,
@@ -1192,11 +1122,7 @@ export type {
 } from "./notifications/push-worker";
 export { PushDeviceSetting } from "./notifications/push-device-setting";
 export type { PushDeviceSettingProps, PushDeviceAction } from "./notifications/push-device-setting";
-export {
-  PushDevicesSetting,
-  /** @deprecated 0.52 — `PushDevicesSetting`, which names each device with it (API-4); removed in 0.53 */
-  describeUserAgent,
-} from "./notifications/push-devices-setting";
+export { PushDevicesSetting } from "./notifications/push-devices-setting";
 export type { PushDevicesSettingProps } from "./notifications/push-devices-setting";
 export { UnsubscribePanel, unsubscribeTokenType } from "./notifications/unsubscribe-panel";
 export type { UnsubscribePanelProps } from "./notifications/unsubscribe-panel";
@@ -1243,15 +1169,7 @@ export { DEFAULT_DEMO_LABELS, useDemoLabels } from "./demo/demo-labels";
 export type { DemoLabels } from "./demo/demo-labels";
 export { isDemoSession } from "./demo/demo-session";
 export type { DemoModel, DemoSessionUser } from "./demo/demo-session";
-export {
-  useDemoCountdown,
-  /** @deprecated 0.52 — `useDemoCountdown`, the same countdown; its `now` option for a test (API-4); removed in 0.53 */
-  demoCountdown,
-  /** @deprecated 0.52 — `useDemoCountdown`, whose `warning` turns on then (API-4); removed in 0.53 */
-  DEMO_WARNING_MINUTES,
-  /** @deprecated 0.52 — `useDemoCountdown`, whose `lastHour` turns on then (API-4); removed in 0.53 */
-  DEMO_MINUTES_ONLY,
-} from "./demo/demo-countdown";
+export { useDemoCountdown } from "./demo/demo-countdown";
 export type { DemoCountdown, DemoCountdownOptions, DemoExpiry } from "./demo/demo-countdown";
 export { DemoStart } from "./demo/demo-start";
 export type { DemoStartProps } from "./demo/demo-start";

package/src/rhf/fields.tsx

@@ -899,8 +899,8 @@ export type RhfDateRangePickerProps<
  *
  * Without `apply` (the picker's default) the first calendar click is reported on its
  * own, so the form holds `(from, emptyValue)` until the second; with `apply` nothing
- * reaches the form until Apply. `apply` was `commit="apply"` until 0.52 (deprecated, gone
- * in 0.53): `commit` is now the write lock's, as on every other binding — with
+ * reaches the form until Apply. `apply` was `commit="apply"` until 0.52 (gone in 0.53):
+ * `commit` is now the write lock's, as on every other binding — with
  * `disabledReason`, the picker's own (refactor audit 2026-10-30, API-3).
  *
  * The common props (`label`, `hint`, `required`, `disabled`, `excludeWhenDisabled`,

package/src/search/search-index.ts

@@ -281,18 +281,3 @@ function capByGroup<E extends SearchEntry>(hits: SearchHit<E>[], groupLimit: num
   }
   return out;
 }
-
-/**
- * One-shot form of {@link createSearchIndex}: the matching entries, best first. For a
- * list that changes on every call (a server response, a store selector); build an index
- * once when the entries are stable.
- */
-export function matchEntries<E extends SearchEntry>(
-  entries: readonly E[],
-  query: string,
-  options?: SearchIndexOptions,
-): E[] {
-  return createSearchIndex(entries, options)
-    .search(query)
-    .map((hit) => hit.entry);
-}

package/src/search.ts

@@ -1,14 +1,14 @@
 // `@eifi1/ui-kit/search` — the command palette / global search.
 // A re-slicing of the main barrel, not a new API.
 export * from "./search/command-palette";
-export * from "./search/search-index";
-// 0.52: the slice's share of the 55 names no app reads (refactor audit 2026-10-30, API-4).
+// Named, not `*`: 0.53 took `SEARCH_TIER_POINTS` and `normalizeSearchText` off the surface
+// (deprecated in 0.52, refactor audit 2026-10-30, API-4); the index keeps them.
 export {
-  /** @deprecated 0.52 — `createSearchIndex`, whose ranking tiers it spaces (API-4); removed in 0.53 */
-  SEARCH_TIER_POINTS,
-  /** @deprecated 0.52 — `createSearchIndex(entries).search(query)`, the same match (API-4); removed in 0.53 */
-  matchEntries,
-  /** @deprecated 0.52 — `foldForSearch`, the list fold it builds on (API-4); removed in 0.53 */
-  normalizeSearchText,
+  createSearchIndex,
+  type SearchEntry,
+  type SearchMatchField,
+  type SearchHit,
+  type SearchIndexOptions,
+  type SearchIndex,
 } from "./search/search-index";
 export * from "./search/global-search";

package/src/shell/account-menu-language.tsx

@@ -39,11 +39,15 @@ function flagOf(lang: AccountMenuLanguageOption): ReactNode {
   );
 }
 
-/** {@link AccountMenuLanguageProps} but the handler. */
-interface AccountMenuLanguageBaseProps {
+export interface AccountMenuLanguageProps {
   languages: readonly AccountMenuLanguageOption[];
   /** The active language's code. */
   value: string | undefined;
+  /** A pick: the app sets the device's language and, signed in, the account's
+   *  (settings §6.2). `value` + `onChange`, as every kit control pairs them
+   *  (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). Required: 0.53 removed the
+   *  deprecated `onPick`. */
+  onChange: (code: string) => void;
   /** The account menu's `close` (from `TopBarActionMenu`'s `children`): a pick shuts it. */
   close?: () => void;
   /** The row's name. Default: `topBar.language` ("Language"). */
@@ -52,28 +56,6 @@ interface AccountMenuLanguageBaseProps {
   defaultOpen?: boolean;
 }
 
-/**
- * `onChange`, or the deprecated `onPick`, is required: with both optional, a row an app
- * moved off `onPick` without adding `onChange` — or with it misspelt — compiled, and a
- * pick only closed the menu (0.52 code review, account-menu-language.tsx).
- */
-export type AccountMenuLanguageProps = AccountMenuLanguageBaseProps &
-  (
-    | {
-        /** A pick: the app sets the device's language and, signed in, the account's
-         *  (settings §6.2). `value` + `onChange`, as every kit control pairs them
-         *  (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). */
-        onChange: (code: string) => void;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick?: (code: string) => void;
-      }
-    | {
-        onChange?: undefined;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick: (code: string) => void;
-      }
-  );
-
 /**
  * The language choice INSIDE the account menu (docs/top-bar-harmonization.md §2.3),
  * keksdose's sub-list: a `Disclosure variant="menu"` row — the globe, "Language", the
@@ -89,12 +71,10 @@ export function AccountMenuLanguage({
   languages,
   value,
   onChange,
-  onPick,
   close,
   label,
   defaultOpen = false,
 }: AccountMenuLanguageProps) {
-  const change = onChange ?? onPick;
   const words = useKitLabels("topBar", DEFAULT_TOP_BAR_LABELS);
   const [open, setOpen] = useState(defaultOpen);
   const active = languages.find((l) => l.code === value);
@@ -131,7 +111,7 @@ export function AccountMenuLanguage({
               <MenuItem
                 checked={lang.code === value}
                 onClick={() => {
-                  change?.(lang.code);
+                  onChange(lang.code);
                   setOpen(false);
                   close?.();
                 }}

package/src/shell/account-menu-text-size.tsx

@@ -4,44 +4,26 @@ import { useAppearanceLabels, type AppearanceLabels } from "../components/appear
 import type { LabelOverride } from "../i18n/kit-labels";
 import { TEXT_SIZES, useTextSize, type TextSize } from "../theme/text-size";
 
-/** {@link AccountMenuTextSizeProps} but the handler. */
-interface AccountMenuTextSizeBaseProps {
+export interface AccountMenuTextSizeProps {
   /** The size in force. Default: the one on `<html>` ({@link useTextSize}), which is the
    *  size whoever applied it put there. */
   value?: TextSize;
+  /**
+   * A step: the next size down or up. The app applies it and keeps it as its
+   * Settings ▸ Appearance does — `useAccountAppearance`'s `pickTextSize` (this
+   * device, and the account when signed in), with `appearance.saveFailed` as the
+   * toast when the account refused. The kit does not apply it itself, so the two
+   * places can never disagree. `value` + `onChange`, as every kit control pairs them
+   * (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). Required: 0.53 removed the
+   * deprecated `onPick`.
+   */
+  onChange: (size: TextSize) => void;
   /** The row's name. Default: `appearance.textSize` ("Text size"). */
   label?: string;
   /** The `appearance` words (`textSize`, `textSizes`, `textSmaller`, `textLarger`). */
   labels?: LabelOverride<AppearanceLabels>;
 }
 
-/**
- * `onChange`, or the deprecated `onPick`, is required: with both optional, a row an app
- * moved off `onPick` without adding `onChange` — or with it misspelt — compiled, and A− /
- * A+ stayed enabled and changed nothing (0.52 code review, account-menu-language.tsx).
- */
-export type AccountMenuTextSizeProps = AccountMenuTextSizeBaseProps &
-  (
-    | {
-        /**
-         * A step: the next size down or up. The app applies it and keeps it as its
-         * Settings ▸ Appearance does — `useAccountAppearance`'s `pickTextSize` (this
-         * device, and the account when signed in), with `appearance.saveFailed` as the
-         * toast when the account refused. The kit does not apply it itself, so the two
-         * places can never disagree. `value` + `onChange`, as every kit control pairs them
-         * (CONTRIBUTING §4; refactor audit 2026-10-30, API-5).
-         */
-        onChange: (size: TextSize) => void;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick?: (size: TextSize) => void;
-      }
-    | {
-        onChange?: undefined;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick: (size: TextSize) => void;
-      }
-  );
-
 /**
  * The text size one tap away, INSIDE the account menu (0.46, keksdose live #426, its
  * `TextSizeRow`): the row's icon and name, the size in force, and A− / A+, which step
@@ -55,15 +37,14 @@ export type AccountMenuTextSizeProps = AccountMenuTextSizeBaseProps &
  * behind it and can step again. The size's name is a polite live region, so a step is
  * announced.
  */
-export function AccountMenuTextSize({ value, onChange, onPick, label, labels: labelsProp }: AccountMenuTextSizeProps) {
-  const change = onChange ?? onPick;
+export function AccountMenuTextSize({ value, onChange, label, labels: labelsProp }: AccountMenuTextSizeProps) {
   const labels = useAppearanceLabels(labelsProp);
   const onHtml = useTextSize().size;
   const size = value ?? onHtml;
   const index = TEXT_SIZES.indexOf(size);
   const step = (by: -1 | 1) => {
     const next = TEXT_SIZES[index + by];
-    if (next) change?.(next);
+    if (next) onChange(next);
   };
   return (
     <li data-account-menu-text-size="" className="flex items-center gap-2 px-3 py-1.5 text-sm">

package/src/shell/app-shell.tsx

@@ -201,19 +201,6 @@ export function pickMobileBar<T>(
   };
 }
 
-/**
- * Split the bar's entries into the cells shown and the ones under "More", in the app's
- * order (§10.7: the app puts its four most used first, or orders by role). One hidden
- * entry is no saving — the More cell would take its place — so the bar then shows them
- * all: the cell count is the same either way, and a real entry beats a detour.
- */
-export function splitMobileBar<T>(entries: readonly T[], max: number): { shown: T[]; hidden: T[] } {
-  // Entries before More, as 0.32 counted them; {@link pickMobileBar} counts cells.
-  const limit = Math.max(1, Math.floor(max));
-  if (entries.length <= limit + 1) return { shown: [...entries], hidden: [] };
-  return { shown: entries.slice(0, limit), hidden: entries.slice(limit) };
-}
-
 /** The bar's cell count at `size`: `mobileMaxItems`, else the default. */
 function mobileCells(maxItems: AppShellProps["mobileMaxItems"], size: TextSize): number {
   if (maxItems === undefined) return DEFAULT_MOBILE_MAX_ITEMS[size];

package/src/shell/company-switcher.tsx

@@ -56,7 +56,7 @@ export interface CompanySwitcherProps<Id extends string | number> {
  * The company switcher in the top bar (docs/auth-harmonization.md §5.3, §8): a kastlan
  * user may belong to several companies, and the access token carries the current one,
  * so switching is a request for new tokens — `onSwitch`, the app's. Built on
- * {@link OptionSwitcherMenu}, like `RoleSwitcher`: the icon trigger, the current company
+ * {@link OptionSwitcherMenu}: the icon trigger, the current company
  * in its tooltip, the list with a check on the current one.
  *
  * **Only for more than one company** — a user in one company has nothing to switch, and

package/src/shell/dev-menu.tsx

@@ -95,7 +95,7 @@ const isRow = (entry: TopBarMenuEntry) => entry.kind !== "heading" && entry.kind
 
 /**
  * The top bar's local-dev menu (docs/top-bar-harmonization.md §2.7, §2.7.1, §6.2, §6.3):
- * ONE amber flask, `RoleSwitcher`'s, over the kit's Account section and the app's own.
+ * ONE amber flask over the kit's Account section and the app's own.
  *
  * 0.42's `DevSwitchers` drew a flask per switcher and had no place for anything else,
  * and an app has more dev controls than a role and a plan — keksdose's budget role, a

package/src/shell/top-bar-parts-labels.ts

@@ -6,7 +6,7 @@ import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
  * `DevSwitchers`, whose words these still are, §2.7.1). A module
  * of words with no component code, like every `*-labels.ts` (0.34, KS U8). The language
  * sub-list (`AccountMenuLanguage`) names itself with `topBar.language`, and the role in the
- * dev flask's name is `topBar.role`, as `RoleSwitcher`'s tooltip.
+ * dev flask's name is `topBar.role`.
  */
 
 /** `TourMenu`'s words (§2.4). */

package/src/shell.ts

@@ -4,17 +4,20 @@
 // `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.
 export * from "./shell/topbar-controls";
 export * from "./shell/top-bar";
-export * from "./shell/app-shell";
-// 0.52: the slice's share of the 55 names no app reads (refactor audit 2026-10-30, API-4,
-// decision 4), tagged on their specifiers as the barrel's are — the modules keep them.
+// Named, not `*`: 0.53 took `pickMobileBar` off the surface (deprecated in 0.52, refactor
+// audit 2026-10-30, API-4) — AppShell's own — and removed `splitMobileBar`, which nothing
+// called any more.
 export {
-  /** @deprecated 0.52 — `AppShell`, which picks its phone bar with it (API-4); removed in 0.53 */
-  pickMobileBar,
-  /** @deprecated 0.52 — `AppShell`, which splits its phone bar with it (API-4); removed in 0.53 */
-  splitMobileBar,
+  DEFAULT_APP_SHELL_MORE_LABELS,
+  DEFAULT_MOBILE_MAX_ITEMS,
+  AppShell,
+  type AppShellSubItem,
+  type AppShellNavItem,
+  type AppShellSidebarFooterItem,
+  type AppShellMoreLabels,
+  type AppShellProps,
 } from "./shell/app-shell";
 export * from "./shell/option-switcher-menu";
-export * from "./shell/role-switcher";
 export * from "./shell/topbar-action-menu";
 export * from "./shell/top-bar-brand";
 export * from "./shell/auth-layout";
@@ -33,20 +36,9 @@ export type { UseAdminMenuEntryOptions } from "./shell/admin-menu";
 export { AdminWaitingBadge } from "./shell/admin-menu";
 export type { AdminWaitingBadgeProps } from "./shell/admin-menu";
 // 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).
-export {
-  SettingsLayout,
-  /** @deprecated 0.52 — `SettingsLayout`, which shows its search past that many entries (API-4); removed in 0.53 */
-  SETTINGS_SEARCH_THRESHOLD,
-} from "./settings/settings-layout";
+export { SettingsLayout } from "./settings/settings-layout";
 export type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from "./settings/settings-layout";
-export {
-  useSettingsRoute,
-  /** @deprecated 0.52 — `useSettingsRoute`, which resolves the location with it (API-4); removed in 0.53 */
-  resolveSettingsLocation,
-  settingsFromListState,
-  /** @deprecated 0.52 — `settingsFromListState` and `useSettingsRoute`, which write and read it (API-4); removed in 0.53 */
-  SETTINGS_FROM_LIST_STATE,
-} from "./settings/use-settings-route";
+export { useSettingsRoute, settingsFromListState } from "./settings/use-settings-route";
 export type {
   UseSettingsRouteOptions,
   SettingsRoute,
@@ -55,14 +47,7 @@ export type {
   SettingsLocationRules,
   SettingsLocationResult,
 } from "./settings/use-settings-route";
-export {
-  useSettingsFocus,
-  useFocusParam,
-  /** @deprecated 0.52 — `useSettingsFocus` / `useFocusParam`, which ring the card with it (API-4); removed in 0.53 */
-  SETTINGS_FOCUS_RING,
-  /** @deprecated 0.52 — `useSettingsFocus` / `useFocusParam`, which hold the ring that long (API-4); removed in 0.53 */
-  SETTINGS_FOCUS_MS,
-} from "./settings/use-settings-focus";
+export { useSettingsFocus, useFocusParam } from "./settings/use-settings-focus";
 export { SettingsSection } from "./settings/settings-section";
 export type { SettingsSectionProps } from "./settings/settings-section";
 export { useSettingsLayout } from "./settings/settings-context";
@@ -99,11 +84,7 @@ export type { PublicHeaderProps, PublicHeaderBrand } from "./landing/public-head
 // 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in
 // §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the
 // local-dev menu, and their words.
-export {
-  TopBarActions,
-  /** @deprecated 0.52 — `TopBarActions`, which puts its slots in that order (API-4); removed in 0.53 */
-  TOP_BAR_ACTION_ORDER,
-} from "./shell/top-bar-actions";
+export { TopBarActions } from "./shell/top-bar-actions";
 export type { TopBarActionsProps } from "./shell/top-bar-actions";
 export { AccountMenuLanguage } from "./shell/account-menu-language";
 export type { AccountMenuLanguageProps, AccountMenuLanguageOption } from "./shell/account-menu-language";
@@ -112,19 +93,11 @@ export { AccountMenuTextSize } from "./shell/account-menu-text-size";
 export type { AccountMenuTextSizeProps } from "./shell/account-menu-text-size";
 export { TourMenu } from "./shell/tour-menu";
 export type { TourMenuProps, TourMenuTour } from "./shell/tour-menu";
-export {
-  SyncStatusIndicator,
-  /** @deprecated 0.52 — `SyncStatusIndicator`, which derives its state with it (API-4); removed in 0.53 */
-  syncState,
-} from "./shell/sync-status-indicator";
+export { SyncStatusIndicator } from "./shell/sync-status-indicator";
 export type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from "./shell/sync-status-indicator";
 // 0.51 (§2.7.1, keksdose): one flask, the kit's Account section and the app's own dev
 // sections. 0.42's `DevSwitchers`, a DevMenu with no sections since 0.51, went in 0.52.
-export {
-  DevMenu,
-  /** @deprecated 0.52 — `DevMenu`, which keeps the role there unless `storageKey` names another key (API-4); removed in 0.53 */
-  DEV_ORIGINAL_ROLE_KEY,
-} from "./shell/dev-menu";
+export { DevMenu } from "./shell/dev-menu";
 export type { DevMenuProps, DevMenuSection } from "./shell/dev-menu";
 export { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from "./shell/top-bar-parts-labels";
 export type {