@eifi1/ui-kit 0.54.0 → 0.55.0

package/src/settings/use-settings-route.ts

@@ -1,258 +0,0 @@
-import { useCallback, useEffect, useMemo } from "react";
-import { useLocation, useNavigate } from "react-router";
-import { usePhoneLayout } from "../hooks/use-breakpoint";
-import { normalizeSettingsBase, visibleSettingsGroups } from "./settings-catalogue";
-import type { SettingsEntry, SettingsGroup } from "./settings-catalogue";
-
-/**
- * Which layout the settings page is in. `"auto"` follows the screen (`usePhoneLayout()`,
- * as `Tabs` does); `"desktop"` / `"phone"` pin one — for a preview of both side by side,
- * where the window is one width.
- */
-export type SettingsLayoutMode = "auto" | "desktop" | "phone";
-
-export interface UseSettingsRouteOptions<G extends string> {
-  groups: readonly SettingsGroup<G>[];
-  /** The catalogue's entries. Given, a group with no visible entry is hidden (§4.1), and
-   *  `/settings?focus=<anchor>` finds the anchor's group. */
-  entries?: readonly SettingsEntry<G>[];
-  /** `/settings` or `/admin`. */
-  basePath: string;
-  /** The group `/settings` opens on a desktop. Default: the first visible group (§4.1). */
-  defaultGroup?: G;
-  /** Retired group ids and their successors — `{ overview: "metrics" }` — applied with a
-   *  replace (§3.1, keksdose's admin). */
-  aliases?: Readonly<Partial<Record<string, G>>>;
-  /** See {@link SettingsLayoutMode}. Default `"auto"`. */
-  layout?: SettingsLayoutMode;
-}
-
-export interface SettingsRoute<G extends string> {
-  /** The group on screen. `null` on a phone's list (and while there is no visible group). */
-  group: G | null;
-  /** The segment after the group, owned by a card; `null` without one. */
-  sub: string | null;
-  /** `?focus=<anchor>`, or `null`. */
-  focus: string | null;
-  /** Open a group: a PUSH on a phone, so the system back gesture returns to the list; a
-   *  REPLACE on a desktop, so back leaves settings instead of walking every group looked
-   *  at (§3.1, keksdose's rule). */
-  select: (group: G) => void;
-  /** See {@link SettingsLayoutContextValue.selectSub}. */
-  selectSub: (sub: string | null) => void;
-  /** To the list: `navigate(-1)` when the list is the previous entry, else a replace to
-   *  the base path — so a deep link from a mail never sends "back" out of the app. */
-  back: () => void;
-  /** The visible groups, in order. */
-  groups: SettingsGroup<G>[];
-  /** Whether the phone layout is in force. */
-  phone: boolean;
-  /** Whether this location is about to be replaced (a legacy hash, an alias, an unknown
-   *  group): what renders meanwhile is already the destination's, but nothing should
-   *  act on the URL until it is. */
-  redirecting: boolean;
-  /** Whether the list is the entry before this one (the marker {@link select} and the
-   *  list's links leave in `location.state`). */
-  fromList: boolean;
-}
-
-/**
- * The `location.state` key that says "the list is the entry before this one". Written by
- * the phone list's links and {@link SettingsRoute.select}; carried over by every replace
- * the page makes, since a replace does not change what came before.
- */
-export const SETTINGS_FROM_LIST_STATE = "eifi1.settings.fromList";
-
-/** `location.state` with the marker set — for an app's own link to a group page that is
- *  opened FROM the list it renders. */
-export function settingsFromListState(): Record<string, true> {
-  return { [SETTINGS_FROM_LIST_STATE]: true };
-}
-
-function isFromList(state: unknown): boolean {
-  return (
-    typeof state === "object" && state !== null && (state as Record<string, unknown>)[SETTINGS_FROM_LIST_STATE] === true
-  );
-}
-
-export interface SettingsLocation {
-  pathname: string;
-  search: string;
-  hash: string;
-}
-
-export interface SettingsLocationRules<G extends string> {
-  basePath: string;
-  /** The visible group ids. */
-  groups: readonly G[];
-  /** The resolved default group, `null` with no visible group. */
-  defaultGroup: G | null;
-  aliases?: Readonly<Partial<Record<string, G>>>;
-  /** Anchor → group, for `/settings?focus=<anchor>` with no group named. */
-  anchorGroup?: ReadonlyMap<string, G>;
-  phone: boolean;
-}
-
-export interface SettingsLocationResult<G extends string> {
-  group: G | null;
-  sub: string | null;
-  /** The path (with query) to replace the location with, or `null` when it is already
-   *  canonical. */
-  redirect: string | null;
-}
-
-/**
- * Where a location lands on the settings page — pure, so the rules of §3.1 are testable
- * without a router:
- *
- *  - `/settings` → the default group on a desktop (a replace), the list on a phone;
- *  - `/settings/<group>[/<sub>]` → that group, the rest of the path as `sub`;
- *  - an alias → its successor, with a replace, `sub`, query and hash kept;
- *  - an unknown or hidden group → the default group (desktop) or the list (phone), with
- *    a replace and the query kept — never a 404, so an old bookmark still lands;
- *  - keksdose's legacy `/settings?<query>#<group>[/<sub>]` →
- *    `/settings/<group>[/<sub>]?<query>`, the WHOLE query carried (a tour's
- *    `tour`/`tourStep` as well as `focus`), then resolved by the rules above;
- *  - `/settings?focus=<anchor>` with no group → the anchor's group, where it can ring.
- */
-export function resolveSettingsLocation<G extends string>(
-  location: SettingsLocation,
-  rules: SettingsLocationRules<G>,
-): SettingsLocationResult<G> {
-  const base = normalizeSettingsBase(rules.basePath);
-  const { pathname, search, hash } = location;
-  const known = new Set<string>(rules.groups);
-  const atBase = pathname === base || pathname === `${base}/` || (base === "" && pathname === "/");
-
-  if (atBase) {
-    const legacy = hash.replace(/^#/, "").replace(/^\/+/, "");
-    if (legacy) {
-      // The hash becomes the path; whatever the path then says (an alias, an unknown
-      // group) is resolved in the same step, so the history sees one replace.
-      const converted = `${base}/${legacy}`;
-      const next = resolveSettingsLocation({ pathname: converted, search, hash: "" }, rules);
-      return { ...next, redirect: next.redirect ?? `${converted}${search}` };
-    }
-    const anchor = new URLSearchParams(search).get("focus");
-    const anchorGroup = anchor ? rules.anchorGroup?.get(anchor) : undefined;
-    if (anchorGroup && known.has(anchorGroup)) {
-      return { group: anchorGroup, sub: null, redirect: `${base}/${anchorGroup}${search}` };
-    }
-    if (rules.phone || rules.defaultGroup === null) return { group: null, sub: null, redirect: null };
-    return { group: rules.defaultGroup, sub: null, redirect: `${base}/${rules.defaultGroup}${search}` };
-  }
-
-  if (!pathname.startsWith(`${base}/`)) {
-    // Mounted somewhere `basePath` does not name: a misconfiguration, not a link to
-    // correct. Show what the base path would, and leave the address alone.
-    return { group: rules.phone ? null : rules.defaultGroup, sub: null, redirect: null };
-  }
-  const rest = pathname.slice(base.length + 1);
-  const [segment = "", ...subParts] = rest.split("/");
-  const sub = subParts.filter(Boolean).join("/") || null;
-  if (known.has(segment)) return { group: segment as G, sub, redirect: null };
-
-  const successor = rules.aliases?.[segment];
-  if (successor !== undefined && known.has(successor)) {
-    return {
-      group: successor,
-      sub,
-      redirect: `${base}/${successor}${sub ? `/${sub}` : ""}${search}${hash}`,
-    };
-  }
-
-  // Unknown or hidden. The hash is dropped: on the list it would read as a legacy group
-  // and send the page round again.
-  if (rules.phone || rules.defaultGroup === null) {
-    return { group: null, sub: null, redirect: `${base || "/"}${search}` };
-  }
-  return { group: rules.defaultGroup, sub: null, redirect: `${base}/${rules.defaultGroup}${search}` };
-}
-
-/**
- * The settings page's route (docs/settings-harmonization.md §3.1): which group the URL
- * names, and the history rules for moving between groups.
- *
- * The URL IS the selection, as it was in keksdose (where it was the hash): there is no
- * state to keep in step with it, so a deep link, a reload, back and forward all land
- * where the address says. Everything that is not canonical — `/settings` on a desktop, a
- * legacy hash, an alias, an unknown or hidden group — is replaced by its canonical path.
- *
- * **The replace runs on every navigation**, keyed on `location.key`, not once on mount:
- * the router keeps the page mounted across links followed inside the app — keksdose's
- * inbox renders admin-typed URLs, and a push click routes an open window without a
- * reload — so a legacy `/settings#security` arriving while the page is open converts too
- * (§10.1).
- */
-export function useSettingsRoute<G extends string>(options: UseSettingsRouteOptions<G>): SettingsRoute<G> {
-  const { groups, entries, basePath, defaultGroup, aliases, layout = "auto" } = options;
-  const location = useLocation();
-  const navigate = useNavigate();
-  const narrow = usePhoneLayout();
-  const phone = layout === "phone" || (layout === "auto" && narrow);
-  const base = normalizeSettingsBase(basePath);
-
-  const visible = useMemo(() => visibleSettingsGroups(groups, entries), [groups, entries]);
-  const anchorGroup = useMemo(() => {
-    const map = new Map<string, G>();
-    for (const e of entries ?? []) if (e.visible !== false && !map.has(e.anchor)) map.set(e.anchor, e.group);
-    return map;
-  }, [entries]);
-  const ids = visible.map((g) => g.id);
-  const fallback = defaultGroup !== undefined && ids.includes(defaultGroup) ? defaultGroup : (ids[0] ?? null);
-
-  const { group, sub, redirect } = resolveSettingsLocation(location, {
-    basePath: base,
-    groups: ids,
-    defaultGroup: fallback,
-    aliases,
-    anchorGroup,
-    phone,
-  });
-
-  const { key, state, search } = location;
-  useEffect(() => {
-    // `state` rides along: the marker describes the entry BEFORE this one, which a
-    // replace does not change.
-    if (redirect) navigate(redirect, { replace: true, state });
-  }, [key, redirect, state, navigate]);
-
-  const select = useCallback(
-    (next: G) => {
-      const to = `${base}/${next}`;
-      // From the list, the push marks it, so the group page's back is a real back.
-      if (phone) navigate(to, group === null ? { state: settingsFromListState() } : undefined);
-      // A new group is a new page: the old one's query (a focus, a roster filter) stays
-      // behind, as keksdose's `selectGroup` left it.
-      else navigate(to, { replace: true, state });
-    },
-    [base, phone, group, state, navigate],
-  );
-
-  const selectSub = useCallback(
-    (next: string | null) => {
-      if (group === null) return;
-      navigate(`${base}/${group}${next ? `/${next}` : ""}${search}`, { replace: true, state });
-    },
-    [base, group, search, state, navigate],
-  );
-
-  const fromList = isFromList(state);
-  const back = useCallback(() => {
-    if (fromList) navigate(-1);
-    else navigate(base || "/", { replace: true });
-  }, [fromList, base, navigate]);
-
-  return {
-    group,
-    sub,
-    focus: new URLSearchParams(search).get("focus"),
-    select,
-    selectSub,
-    back,
-    groups: visible,
-    phone,
-    redirecting: redirect !== null,
-    fromList,
-  };
-}

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

@@ -1,130 +0,0 @@
-import { useState } from "react";
-import type { ReactNode } from "react";
-import { Globe } from "lucide-react";
-import { Disclosure } from "../components/disclosure";
-import { MenuItem } from "../components/menu-item";
-import { DEFAULT_TOP_BAR_LABELS, useKitLabels } from "../i18n/kit-labels";
-import { languageCodeLabel } from "./language-code";
-
-/** One offered language in the account menu's sub-list. */
-export interface AccountMenuLanguageOption {
-  code: string;
-  /** Its name, in its own language ("Deutsch", "Français"). */
-  label: ReactNode;
-  /**
-   * A flag before the name, as the app draws it — keksdose's flag-icons span
-   * (`<span aria-hidden className="fi fi-ch …" />`). A node rather than a country code, so
-   * the kit ships no flag set; decorative, so give it `aria-hidden`.
-   */
-  flag?: ReactNode;
-  /**
-   * Or the ISO 3166-1 alpha-2 country (lowercase) whose flag-icons flag to draw, as
-   * `LanguageMenu`'s `LanguageOption` takes it — so one language list feeds both
-   * (Kurvenschmiede's `LANGUAGES`). Needs the app's flag-icons CSS, as `LanguageMenu`
-   * does. `flag` wins when both are given.
-   */
-  country?: string;
-}
-
-/** The option's flag: its own node, else the flag-icons flag of its country. */
-function flagOf(lang: AccountMenuLanguageOption): ReactNode {
-  if (lang.flag !== undefined) return lang.flag;
-  if (!lang.country) return undefined;
-  return (
-    <span
-      aria-hidden
-      data-country={lang.country}
-      className={`fi fi-${lang.country} inline-block h-[0.9375rem] w-5 shrink-0 rounded-sm shadow-[0_0_0_1px_rgba(0,0,0,0.08)]`}
-    />
-  );
-}
-
-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"). */
-  label?: string;
-  /** Open the sub-list at first. Default `false`. */
-  defaultOpen?: boolean;
-}
-
-/**
- * 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
- * active language's flag and code ("DE") and the chevron — that opens in place onto one checked
- * `MenuItem` per language. Inline rather than a nested popover: a popover inside a
- * popover fights the outside click and has nowhere to go on a phone (keksdose #140).
- *
- * It renders its own `<li>`: drop it into `TopBarActionMenu`'s `children` first after the
- * app's context rows (§6.5). Signed out there is no account menu; `LanguageMenu` stays
- * the bar's button (§2.3).
- */
-export function AccountMenuLanguage({
-  languages,
-  value,
-  onChange,
-  close,
-  label,
-  defaultOpen = false,
-}: AccountMenuLanguageProps) {
-  const words = useKitLabels("topBar", DEFAULT_TOP_BAR_LABELS);
-  const [open, setOpen] = useState(defaultOpen);
-  const active = languages.find((l) => l.code === value);
-  return (
-    <li>
-      <Disclosure
-        variant="menu"
-        open={open}
-        onOpenChange={setOpen}
-        title={
-          <span className="flex items-center justify-between gap-3">
-            <span className="flex items-center gap-2">
-              <Globe aria-hidden className="size-4" />
-              {label ?? words.language}
-            </span>
-            {active && (
-              // The flag alone could not tell de-CH, fr-CH and it-CH apart (one Swiss
-              // flag each), so the code sits beside it (0.49 KIT-10); the row's name
-              // carries the language's own name.
-              <span className="flex items-center gap-1.5">
-                {flagOf(active)}
-                <span aria-hidden className="text-xs font-semibold tabular-nums tracking-wide text-secondary">
-                  {languageCodeLabel(active.code)}
-                </span>
-                <span className="sr-only">{active.label}</span>
-              </span>
-            )}
-          </span>
-        }
-      >
-        <ul>
-          {languages.map((lang) => (
-            <li key={lang.code}>
-              <MenuItem
-                checked={lang.code === value}
-                onClick={() => {
-                  onChange(lang.code);
-                  setOpen(false);
-                  close?.();
-                }}
-                leading={flagOf(lang)}
-                // Under the row's own text, past the globe.
-                className="ps-9"
-              >
-                {lang.label}
-              </MenuItem>
-            </li>
-          ))}
-        </ul>
-      </Disclosure>
-    </li>
-  );
-}

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

@@ -1,80 +0,0 @@
-import { AArrowDown, AArrowUp, ALargeSmall } from "lucide-react";
-import { IconButton } from "../components/icon-button";
-import { useAppearanceLabels, type AppearanceLabels } from "../components/appearance-labels";
-import type { LabelOverride } from "../i18n/kit-labels";
-import { TEXT_SIZES, useTextSize, type TextSize } from "../theme/text-size";
-
-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>;
-}
-
-/**
- * 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
- * through {@link TEXT_SIZES} (Normal → Large → Extra large). A− is disabled at the
- * smallest, A+ at the largest. The browser's pinch zoom stays as it is — this is the
- * quick path to the setting, not a replacement for zoom.
- *
- * It renders its own `<li>`: drop it into `TopBarActionMenu`'s `children` beside
- * `AccountMenuLanguage`. The menu promotes the two buttons to `menuitem`s, so ↑/↓ reach
- * them like every other row, and it stays open on a step: the person sees the page grow
- * 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, 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) onChange(next);
-  };
-  return (
-    <li data-account-menu-text-size="" className="flex items-center gap-2 px-3 py-1.5 text-sm">
-      <ALargeSmall aria-hidden className="size-4 shrink-0 text-muted" />
-      <span className="min-w-0 flex-1 truncate">
-        {label ?? labels.textSize}
-        <span className="ms-2 text-xs text-muted" aria-live="polite">
-          {labels.textSizes[size]}
-        </span>
-      </span>
-      <IconButton
-        size="sm"
-        label={labels.textSmaller}
-        labelVisible={false}
-        tooltip={false}
-        disabled={index <= 0}
-        onClick={() => step(-1)}
-      >
-        <AArrowDown />
-      </IconButton>
-      <IconButton
-        size="sm"
-        label={labels.textLarger}
-        labelVisible={false}
-        tooltip={false}
-        disabled={index >= TEXT_SIZES.length - 1}
-        onClick={() => step(1)}
-      >
-        <AArrowUp />
-      </IconButton>
-    </li>
-  );
-}

package/src/shell/admin-menu.tsx

@@ -1,183 +0,0 @@
-import { Link } from "react-router";
-import { ShieldCheck } from "lucide-react";
-import { Chip } from "../components/chip";
-import { MenuItem } from "../components/menu-item";
-import type { LabelOverride } from "../i18n/kit-labels";
-import { DEFAULT_ADMIN_AREA_LABELS, useAdminAreaLabels } from "../admin/admin-area-labels";
-import type { AdminAreaLabels } from "../admin/admin-area-labels";
-import type { TopBarMenuEntry } from "./topbar-action-menu";
-
-/**
- * The account menu's "Administration" row (0.42.0, docs/admin-harmonization.md §2.1, §6.6,
- * §7): the way into the admin area everyone finds, in every app, for an admin only. Two
- * forms of one row — {@link adminMenuEntry} for `TopBarActionMenu`'s `entries`, and
- * {@link AdminMenuRow} for a menu built from `HoverMenu` children (Kurvenschmiede's).
- */
-
-/** The badge's text: nothing for none or 0, "99+" past 99. */
-function badgeText(badge: number | null | undefined): string | null {
-  if (typeof badge !== "number" || !(badge > 0)) return null;
-  return badge > 99 ? "99+" : String(Math.floor(badge));
-}
-
-/**
- * The waiting count at the row's end: the `solid` count pill of {@link Chip}, in the
- * pending count's tone, with the number for the eye and `adminArea.waiting` for a reader
- * ("Administration, 3 waiting"). `null` for no count.
- */
-function WaitingBadge({
-  badge,
-  labels,
-  className,
-}: {
-  badge: number | null | undefined;
-  labels: AdminAreaLabels;
-  className?: string;
-}) {
-  const text = badgeText(badge);
-  if (text === null) return null;
-  return (
-    <Chip size="sm" variant="solid" tone="warning" data-slot="admin-badge" className={className}>
-      <span aria-hidden>{text}</span>
-      {/* The comma parts it from the row's label in the name: "Administration, 3 waiting". */}
-      <span className="sr-only-fixed">, {labels.waiting(badge as number)}</span>
-    </Chip>
-  );
-}
-
-export interface AdminWaitingBadgeProps {
-  /** The waiting count: only work that waits on this admin. `0`, `null` or none draws
-   *  nothing; past 99 it reads "99+". */
-  count: number | null | undefined;
-  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */
-  labels?: LabelOverride<AdminAreaLabels>;
-  className?: string;
-}
-
-/**
- * The waiting pill of {@link AdminMenuRow} on its own (0.45, docs/admin-harmonization.md
- * §9.3.4): the `solid` warning count, "99+" past 99, nothing for 0. Fit for `IconButton`'s
- * `badge` — kastlan's top-bar platform button. There the badge is DECORATIVE (`aria-hidden`
- * by IconButton), so the button's name carries the count: `adminArea.waitingLabel`.
- *
- *     const area = useAdminAreaLabels();
- *     <IconButton
- *       label={waiting > 0 ? area.waitingLabel("Platform", waiting) : "Platform"}
- *       badge={<AdminWaitingBadge count={waiting} />}
- *       …
- *     />
- *
- * Read on its own (outside an IconButton), the pill still says ", 3 waiting" to a reader.
- */
-export function AdminWaitingBadge({ count, labels: labelsProp, className }: AdminWaitingBadgeProps) {
-  const labels = useAdminAreaLabels(labelsProp);
-  return <WaitingBadge badge={count} labels={labels} className={className} />;
-}
-
-export interface AdminMenuEntryOptions {
-  /** The admin area. Default `/admin`. */
-  href?: string;
-  /**
-   * The waiting count (§2.4 decision 15, §6.3): only work that waits on this admin —
-   * `adminWaitingCount(attention, […])`. `0`, `null` or none shows no badge.
-   */
-  badge?: number | null;
-  /**
-   * The resolved `adminArea` words — pass `useAdminAreaLabels()`, or the row is ENGLISH
-   * in every language: a plain function reads no provider (kastlan, 0.42 adoption). Builds
-   * no hook, so the entry can be made in the list of entries. {@link useAdminMenuEntry}
-   * (0.43) is the same entry with the provider's words read for you.
-   */
-  labels?: AdminAreaLabels;
-  /** The entry's `key`. Default `"administration"`. */
-  key?: string;
-  /** The page already open: `aria-current` and a check mark. */
-  current?: boolean;
-}
-
-/**
- * The "Administration" {@link TopBarMenuEntry}: a link row with the `ShieldCheck` icon,
- * the kit's word and the waiting count as its badge. Put it in the entries for an admin
- * only — the menu closes on the way, as any link row:
- *
- *     const labels = useAdminAreaLabels();
- *     entries={[…, ...(isAdmin ? [adminMenuEntry({ badge: waiting, labels })] : []), …]}
- *
- * A function, not a hook: it reads NO provider, so pass `labels` (`useAdminAreaLabels()`)
- * or the row says "Administration" in every language — or call {@link useAdminMenuEntry}
- * at the component's top.
- */
-export function adminMenuEntry({
-  href = "/admin",
-  badge,
-  labels = DEFAULT_ADMIN_AREA_LABELS,
-  key = "administration",
-  current,
-}: AdminMenuEntryOptions = {}): TopBarMenuEntry {
-  return {
-    kind: "link",
-    key,
-    to: href,
-    icon: <ShieldCheck className="size-4" aria-hidden />,
-    label: labels.title,
-    trailing: badgeText(badge) === null ? undefined : <WaitingBadge badge={badge} labels={labels} />,
-    current,
-  };
-}
-
-export interface UseAdminMenuEntryOptions extends Omit<AdminMenuEntryOptions, "labels"> {
-  /** Over the provider's `adminArea` words: prop > `<UiKitProvider labels={{ adminArea }}>`
-   *  > English. */
-  labels?: LabelOverride<AdminAreaLabels>;
-}
-
-/**
- * {@link adminMenuEntry} with the provider's words (0.43, kastlan): the hook reads
- * `useAdminAreaLabels()` itself, so the row is in the app's language without a `labels`
- * to remember. Call it at the component's top, then put it in the entries:
- *
- *     const admin = useAdminMenuEntry({ badge: waiting });
- *     entries={[…, ...(isAdmin ? [admin] : []), …]}
- */
-export function useAdminMenuEntry({ labels: labelsProp, ...options }: UseAdminMenuEntryOptions = {}): TopBarMenuEntry {
-  const labels = useAdminAreaLabels(labelsProp);
-  return adminMenuEntry({ ...options, labels });
-}
-
-export interface AdminMenuRowProps {
-  /** The admin area. Default `/admin`. */
-  href?: string;
-  /** As {@link AdminMenuEntryOptions.badge}. */
-  badge?: number | null;
-  /** Runs on the way — `HoverMenu`'s `close`. */
-  onNavigate?: () => void;
-  current?: boolean;
-  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */
-  labels?: LabelOverride<AdminAreaLabels>;
-}
-
-/**
- * The same row as {@link adminMenuEntry} for a menu drawn from `HoverMenu` children: the
- * `<li>` holding the router-link {@link MenuItem} `TopBarActionMenu` draws for a link
- * entry, so the two menus look alike.
- *
- *     {(close) => <ul>… {isAdmin && <AdminMenuRow badge={waiting} onNavigate={close} />} …</ul>}
- */
-export function AdminMenuRow({ href = "/admin", badge, onNavigate, current, labels: labelsProp }: AdminMenuRowProps) {
-  // The provider's words, as every kit part (0.43: through the namespace's own hook).
-  const labels = useAdminAreaLabels(labelsProp);
-  return (
-    <li>
-      <MenuItem
-        href={href}
-        renderLink={({ href: to, ...p }) => <Link to={to} {...p} />}
-        onClick={onNavigate ? () => onNavigate() : undefined}
-        leading={<ShieldCheck className="size-4" aria-hidden />}
-        trailing={badgeText(badge) === null ? undefined : <AdminWaitingBadge count={badge} labels={labels} />}
-        current={current}
-      >
-        {labels.title}
-      </MenuItem>
-    </li>
-  );
-}

package/src/shell/app-shell-labels.ts

@@ -1,11 +0,0 @@
-// The English words of ./app-shell, in a module with no component code: the English
-// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
-// chunk like the other languages (0.34, KS U8). ./app-shell re-exports them.
-
-import type { AppShellMoreLabels } from "./app-shell";
-
-export const DEFAULT_APP_SHELL_MORE_LABELS: AppShellMoreLabels = {
-  more: "More",
-  moreTitle: "More pages",
-  overview: "Overview",
-};