@eifi1/ui-kit 0.54.0 → 0.55.0

package/src/admin/admin-overview.tsx

@@ -1,258 +0,0 @@
-import type { ReactNode } from "react";
-import { AlertBanner } from "../components/alert-banner";
-import { Button } from "../components/button";
-import { StatTile, StatTileGrid } from "../components/stat-tile";
-import type { StatTileProps } from "../components/stat-tile";
-import type { LabelOverride } from "../i18n/kit-labels";
-import { cn } from "../lib/cn";
-import { useAdminAreaLabels } from "./admin-area-labels";
-import type { AdminAreaLabels } from "./admin-area-labels";
-
-/**
- * The admin's start page (0.42.0, docs/admin-harmonization.md §2.4, §6.1–§6.5): a grid
- * of tiles, each a count of what is waiting and a link to where the work is, fed by one
- * server answer.
- */
-
-/**
- * `GET /admin/attention` (§2.4 decision 14, §6.4) — server-kit's `AdminAttention`
- * (`eifi1_server_kit.user_admin.attention`), as the API sends it.
- *
- * Each count is `null` where the app has no such thing or this viewer cannot act on it,
- * and every count is `null` in a demo session. Demo accounts never count. `extra` holds
- * the app's own counts, keyed as its overview names them (keksdose `support_waiting`,
- * Kurvenschmiede `released_for_work`).
- */
-export interface AdminAttention {
-  /** "To triage": OPEN reports, crash reports included (§6.1). */
-  feedback_waiting: number | null;
-  /** Accounts that asked to be deleted — only where this viewer acts on them (§6.2). */
-  deletion_requests: number | null;
-  invitations_pending: number | null;
-  users_total: number | null;
-  /** Accounts made in the last seven days. */
-  users_new_7d: number | null;
-  extra: Record<string, number | null>;
-}
-
-/** The shared counts that are a tile of their own (`users_new_7d` is the users tile's line). */
-export type AdminAttentionTile = "feedback_waiting" | "deletion_requests" | "invitations_pending" | "users_total";
-
-/** Where each shared tile links when the app names nothing else (§2.4 decision 13). */
-export const DEFAULT_ADMIN_ATTENTION_HREFS: Readonly<Record<AdminAttentionTile, string>> = Object.freeze({
-  feedback_waiting: "/feedback",
-  deletion_requests: "/admin/users?state=deletion_requested",
-  invitations_pending: "/admin/invitations",
-  users_total: "/admin/users",
-});
-
-/**
- * The account menu's badge (§2.4 decision 15, §6.3): the sum of the counts that are work
- * waiting on THIS admin — each app names its own (keksdose `["feedback_waiting",
- * "support_waiting", "awaiting_verdict"]`, kastlan `["feedback_waiting"]`, Kurvenschmiede
- * `["feedback_waiting", "deletion_requests"]`). A name is a shared count or an `extra`
- * key; a `null` or missing count adds nothing. Invitations and users never belong in it.
- * `null` while there is no answer yet, so the badge shows nothing rather than a 0.
- */
-export function adminWaitingCount(
-  attention: AdminAttention | null | undefined,
-  counts: readonly (AdminAttentionTile | (string & {}))[],
-): number | null {
-  if (!attention) return null;
-  let sum = 0;
-  for (const key of counts) {
-    const shared = (attention as unknown as Record<string, unknown>)[key];
-    const value = typeof shared === "number" ? shared : attention.extra?.[key];
-    if (typeof value === "number" && value > 0) sum += value;
-  }
-  return sum;
-}
-
-export interface AttentionTileProps extends Omit<StatTileProps, "href" | "onClick" | "value"> {
-  /** The count. `null` shows the tile's dash; {@link AdminOverview} leaves such a tile out. */
-  count: number | null | undefined;
-  /** Where the work is — the tile is a link to it. Since 0.43 it may be left out: a
-   *  quiet count, no link (Kurvenschmiede). */
-  href?: string;
-}
-
-/**
- * One tile of the overview: a {@link StatTile} that is a LINK to where the work is, its
- * count the headline. The whole tile is the link, named by its label; route it through
- * `renderLink` or the provider's link component, as any StatTile. Without `href` (0.43) it
- * is a quiet count, no link.
- */
-export function AttentionTile({ count, href, ...tile }: AttentionTileProps) {
-  return <StatTile data-slot="attention-tile" {...tile} value={count ?? null} href={href} />;
-}
-
-/**
- * 0.46 (Kurvenschmiede 1, admin §9.5): the `extra` keys server-kit's
- * `feedback_attention` fills, whose tiles have the kit's words
- * (`adminArea.tiles.awaitingVerdict`, `releasedForWork`, with a line each).
- */
-export type AdminFeedbackTileKey = "awaiting_verdict" | "released_for_work";
-
-/** One of the app's own tiles (§2.4 decision 13: keksdose's "Support waiting"). */
-export type AdminExtraTile = AdminOwnTile | AdminFeedbackTile;
-
-/** A tile of the app's own: it brings its words. */
-export interface AdminOwnTile {
-  /** Unique among the tiles; usually the `extra` key it shows. */
-  key: string;
-  label: ReactNode;
-  /** `null` or `undefined` leaves the tile out, as for a shared one. */
-  count: number | null | undefined;
-  /** Where the work is. Left out (0.43, Kurvenschmiede): a quiet count with no link —
-   *  a number worth seeing that has no page of its own. */
-  href?: string;
-  /** A line under the count. */
-  description?: ReactNode;
-}
-
-/** 0.46: a tile of server-kit's feedback counts — `label` and `description` default to
- *  the kit's words; an app's own still win. The kit's `description` fills in only when
- *  `label` is left out too: an app that names the tile gets no hint line it did not ask for. */
-export interface AdminFeedbackTile extends Omit<AdminOwnTile, "key" | "label"> {
-  key: AdminFeedbackTileKey;
-  label?: ReactNode;
-}
-
-export interface AdminOverviewProps {
-  /** The server's answer; `undefined` while it loads (the grid shows its skeletons). */
-  attention: AdminAttention | null | undefined;
-  /**
-   * Where the shared tiles link, over {@link DEFAULT_ADMIN_ATTENTION_HREFS} — the
-   * inbox's address filtered to OPEN (§6.1) is the app's own:
-   * `{ feedback_waiting: "/feedback?status=OPEN" }`.
-   */
-  hrefs?: Partial<Record<AdminAttentionTile, string>>;
-  /** The app's own tiles, after the shared ones, in this order. */
-  extraTiles?: readonly AdminExtraTile[];
-  /** Passed to every tile — `renderLink` for the router, `size`, `variant`. */
-  tileProps?: Pick<StatTileProps, "renderLink" | "size" | "variant" | "locale">;
-  /**
-   * 0.43 (keksdose): the answer failed — the query's `error`, or `true`. Anything truthy
-   * shows `adminArea.overviewError` in a danger box, with "Try again" when
-   * {@link onRetry} is given. A failed poll keeps the last good tiles: with `attention`
-   * still there (a query keeps its last data), the box shows ALONGSIDE them, above, not
-   * instead (build review 0.43, keksdose N7) — pass `attention.data` as it is. Without
-   * an answer yet, the box alone. Without `error`: `undefined` is the skeletons and
-   * `null` nothing, as before.
-   */
-  error?: unknown;
-  /** "Try again" in the error box — the query's `refetch`. */
-  onRetry?: () => void;
-  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */
-  labels?: LabelOverride<AdminAreaLabels>;
-  className?: string;
-}
-
-/**
- * The overview section (§2.4): the shared tiles in their order — To triage, Deletion
- * requests, Pending invitations, Users (with the new accounts of the last 7 days under
- * the total) — then the app's `extraTiles`. A tile whose count is `null` is left out,
- * so each app shows only what it has; a `0` is a quiet tile, "nothing waiting".
- *
- * The overview is the admin area's landing page, standalone: it is NOT wrapped in a
- * `SettingsSection` (`adminSections` gives it no entry; render it as the page's body, as
- * Kurvenschmiede's `OverviewPanel` does). keksdose links its metrics from here with at
- * most two tiles (§6.5).
- */
-export function AdminOverview({
-  attention,
-  hrefs,
-  extraTiles = [],
-  tileProps,
-  error,
-  onRetry,
-  labels: labelsProp,
-  className,
-}: AdminOverviewProps) {
-  const labels = useAdminAreaLabels(labelsProp);
-  /** The error box: on its own (`alone`) it is the overview's root. */
-  const errorBox = (alone: boolean) => (
-    <AlertBanner
-      data-slot={alone ? "admin-overview" : undefined}
-      data-state={alone ? "error" : undefined}
-      variant="box"
-      tone="danger"
-      className={alone ? className : undefined}
-      action={
-        onRetry ? (
-          <Button type="button" variant="secondary" size="sm" onClick={() => onRetry()}>
-            {labels.retry}
-          </Button>
-        ) : undefined
-      }
-    >
-      {labels.overviewError}
-    </AlertBanner>
-  );
-  // Nothing good to keep: the box alone.
-  if (error && !attention) return errorBox(true);
-  const href = { ...DEFAULT_ADMIN_ATTENTION_HREFS, ...hrefs };
-  const loading = attention === undefined;
-  const shared: { key: AdminAttentionTile; label: string; description?: ReactNode }[] = [
-    { key: "feedback_waiting", label: labels.tiles.feedbackWaiting },
-    { key: "deletion_requests", label: labels.tiles.deletionRequests },
-    { key: "invitations_pending", label: labels.tiles.invitationsPending },
-    {
-      key: "users_total",
-      label: labels.tiles.users,
-      description:
-        attention && typeof attention.users_new_7d === "number"
-          ? labels.tiles.usersNew(attention.users_new_7d)
-          : undefined,
-    },
-  ];
-  const feedbackWords: Record<AdminFeedbackTileKey, { label: string; description: string }> = {
-    awaiting_verdict: { label: labels.tiles.awaitingVerdict, description: labels.tiles.awaitingVerdictHint },
-    released_for_work: { label: labels.tiles.releasedForWork, description: labels.tiles.releasedForWorkHint },
-  };
-  const tiles = [
-    ...shared.map((t) => ({ ...t, count: attention ? attention[t.key] : undefined, href: href[t.key] })),
-    ...extraTiles.map((t) => {
-      const words = Object.prototype.hasOwnProperty.call(feedbackWords, t.key)
-        ? feedbackWords[t.key as AdminFeedbackTileKey]
-        : undefined;
-      // The kit's hint comes with the kit's label only: an app that names the tile
-      // itself gets no line it did not ask for (keksdose S5, round 0.46).
-      return words
-        ? {
-            ...t,
-            label: t.label ?? words.label,
-            description: t.description ?? (t.label === undefined ? words.description : undefined),
-          }
-        : t;
-    }),
-  ].filter((t) => loading || (t.count !== null && t.count !== undefined));
-  if (!loading && tiles.length === 0) return error ? errorBox(true) : null;
-  const grid = (
-    <StatTileGrid
-      data-slot={error ? undefined : "admin-overview"}
-      loading={loading}
-      className={error ? undefined : className}
-    >
-      {tiles.map((t) => (
-        <AttentionTile
-          key={t.key}
-          {...tileProps}
-          data-attention={t.key}
-          label={t.label}
-          count={t.count}
-          href={t.href}
-          description={t.description}
-        />
-      ))}
-    </StatTileGrid>
-  );
-  if (!error) return grid;
-  // A failed poll: the error above the last good tiles.
-  return (
-    <div data-slot="admin-overview" data-state="error" className={cn("space-y-4", className)}>
-      {errorBox(false)}
-      {grid}
-    </div>
-  );
-}

package/src/admin/admin-parts.ts

@@ -1,68 +0,0 @@
-import { useCallback } from "react";
-import { useKitLocale } from "../i18n/kit-labels";
-import { useDayFormatter } from "../lib/day-format";
-import { toDate } from "../lib/format";
-import type { DateInput } from "../lib/format";
-import { formatPersonName } from "../lib/person-name";
-
-/**
- * What the admin parts share and do not export (0.30.0). Internal to `src/admin`.
- *
- * @internal
- */
-
-/** A callback that may answer a promise: resolve = done, reject = stay and say why. */
-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. 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;
-}
-
-/**
- * The name to say for a person, in the READER's order (auth §3.2,
- * {@link formatPersonName}), else the whole `name`, else the address, else `""`.
- */
-export function personLabel(person: AdminPerson | null | undefined, locale: string | undefined): string {
-  if (!person) return "";
-  return (
-    formatPersonName({ first: person.first ?? person.first_name, last: person.last ?? person.last_name }, locale) ||
-    (person.name ?? "").trim() ||
-    (person.email ?? "").trim()
-  );
-}
-
-/** {@link personLabel} in the provider's locale. */
-export function usePersonLabel(localeProp?: string): (person: AdminPerson | null | undefined) => string {
-  const locale = useKitLocale(localeProp);
-  return useCallback((person) => personLabel(person, locale), [locale]);
-}
-
-/**
- * A day as words in a sentence ("6 Nov 2026"): the provider's `formatDate` when the app
- * set one (keksdose K12), asked for no weekday — a date in a sentence carries none — else
- * `Intl`'s medium date, in the provider's locale and `timeZone` (0.52: the kit's one day
- * ladder, `useDayFormatter` — refactor audit 2026-10-30, DUP-2). `""` for no date or one
- * that does not parse: the caller leaves the sentence out.
- */
-export function useDayText(localeProp?: string): (value: DateInput) => string {
-  const day = useDayFormatter(undefined, localeProp);
-  return useCallback((value) => (toDate(value) ? day(value) : ""), [day]);
-}
-
-/** Call a callback that may throw or answer a promise, as a promise — the kit's one
- *  (hooks/use-mounted), not a copy of it (0.52 code review, this file). */
-export { settle } from "../hooks/use-mounted";

package/src/admin/admin-sections.tsx

@@ -1,208 +0,0 @@
-import { createElement } from "react";
-import type { ReactNode } from "react";
-import { History, LayoutDashboard, Mail, Receipt, Users } from "lucide-react";
-import type { LucideIcon } from "lucide-react";
-import type { SettingsGroup } from "../settings/settings-catalogue";
-import { DEFAULT_ADMIN_AREA_LABELS } from "./admin-area-labels";
-import type { AdminAreaLabels, AdminSharedSection } from "./admin-area-labels";
-
-/**
- * The admin area's sections (0.42.0, docs/admin-harmonization.md §2.3, §6.8): the five
- * every app shares, in the template's order, and the helper that builds an app's
- * `SettingsLayout` catalogue groups from them and the app's own.
- */
-
-/** One shared section: its path segment and its icon. The words are `adminArea.sections`. */
-export interface AdminSectionDefinition {
-  id: AdminSharedSection;
-  icon: LucideIcon;
-}
-
-/**
- * The shared sections in the template's order (§2.3 decision 10, §6.13): Overview, Users,
- * Invitations, Billing, Activity. An app's own sections go between them
- * ({@link adminSections}).
- */
-export const ADMIN_SECTIONS: readonly AdminSectionDefinition[] = Object.freeze([
-  { id: "overview", icon: LayoutDashboard },
-  { id: "users", icon: Users },
-  { id: "invitations", icon: Mail },
-  { id: "billing", icon: Receipt },
-  { id: "activity", icon: History },
-]);
-
-/**
- * One of the app's own sections: a catalogue group with its words, plus where it goes.
- * `after` names the section it follows — a shared one or another of the app's own. Left
- * out, it goes where the template puts an app's sections, after Invitations and before
- * Billing, in the order given.
- */
-export interface AdminOwnSection<G extends string = string> extends SettingsGroup<G> {
-  after?: AdminSharedSection | G;
-}
-
-/** Where one section goes, without its words — what {@link adminSectionOrder} takes. An
- *  {@link AdminOwnSection} is one. */
-export interface AdminSectionPlace<G extends string = string> {
-  id: G;
-  after?: AdminSharedSection | G;
-}
-
-/** The order's options: the shared sections an app does not have. */
-export interface AdminSectionOrderOptions<L extends AdminSharedSection = AdminSharedSection> {
-  /**
-   * Shared sections this app does not have — keksdose and Kurvenschmiede have no billing
-   * view (`["billing"]`). Left out, every shared section is in the catalogue. Since 0.43
-   * the result's type leaves them out too, so no cast is needed to drop `"billing"` —
-   * when TypeScript infers the type arguments. With them written out, name the left-out
-   * ones as the second (`adminSections<Own, "billing">(…)`); `adminSections<Own>(…)`
-   * keeps every shared id in the type, as before.
-   */
-  leaveOut?: readonly L[];
-}
-
-export interface AdminSectionsOptions<
-  L extends AdminSharedSection = AdminSharedSection,
-> extends AdminSectionOrderOptions<L> {
-  /**
-   * A shared section that is in the catalogue but hidden for now, as
-   * {@link SettingsGroup.visible}: kastlan's `{ billing: billingEnabled }` (settings §5),
-   * whose path then acts as an unknown one.
-   */
-  visible?: Partial<Record<AdminSharedSection, boolean>>;
-  /**
-   * 0.48 (keksdose live #450): a shared section's {@link SettingsGroup.badge} — the
-   * waiting work the account menu's badge counts, on the row of the section that holds
-   * it: `{ overview: <AdminWaitingBadge count={waiting} /> }`. An app's own section
-   * carries its `badge` itself.
-   */
-  badges?: Partial<Record<AdminSharedSection, ReactNode>>;
-}
-
-/** The shared sections an app keeps when it leaves out `L`. A `leaveOut` typed as the
- *  whole union (a variable of `AdminSharedSection[]`) says nothing about which, so it
- *  narrows nothing. */
-export type AdminKeptSection<L extends AdminSharedSection = AdminSharedSection> = [AdminSharedSection] extends [L]
-  ? AdminSharedSection
-  : Exclude<AdminSharedSection, L>;
-
-/** The shared section after which the app's sections go when they name no place. */
-const OWN_DEFAULT_AFTER: AdminSharedSection = "invitations";
-
-/** The shared and own sections in their order — a shared one as its definition, an own
- *  one as given. Throws as {@link adminSections} documents. */
-function orderSections<S extends AdminSectionPlace<string>>(
-  own: readonly S[],
-  leaveOutIds: readonly AdminSharedSection[] | undefined,
-): ({ shared: AdminSectionDefinition } | { own: S })[] {
-  const leaveOut = new Set<string>(leaveOutIds ?? []);
-  const shared = new Set<string>(ADMIN_SECTIONS.map((s) => s.id));
-  const ownIds = new Set<string>();
-  for (const section of own) {
-    if (shared.has(section.id)) throw new Error(`adminSections: "${section.id}" is a shared section's id`);
-    if (ownIds.has(section.id)) throw new Error(`adminSections: "${section.id}" is given twice`);
-    ownIds.add(section.id);
-  }
-  for (const section of own) {
-    const after = section.after;
-    if (after !== undefined && !shared.has(after) && !ownIds.has(after)) {
-      throw new Error(`adminSections: "${section.id}" goes after "${after}", which is no section`);
-    }
-  }
-
-  // Each section's followers, in the order given: the shared ones, then the own ones
-  // under their `after`, recursively, so an own section may follow another own one.
-  const followers = new Map<string, S[]>();
-  for (const section of own) {
-    const after = section.after ?? OWN_DEFAULT_AFTER;
-    followers.set(after, [...(followers.get(after) ?? []), section]);
-  }
-
-  const out: ({ shared: AdminSectionDefinition } | { own: S })[] = [];
-  const placed = new Set<string>();
-  const placeAfter = (id: string) => {
-    for (const section of followers.get(id) ?? []) {
-      out.push({ own: section });
-      placed.add(section.id);
-      placeAfter(section.id);
-    }
-  };
-  for (const definition of ADMIN_SECTIONS) {
-    if (!leaveOut.has(definition.id)) out.push({ shared: definition });
-    // A left-out section's followers keep its place.
-    placeAfter(definition.id);
-  }
-  const stuck = own.filter((s) => !placed.has(s.id)).map((s) => s.id);
-  if (stuck.length) throw new Error(`adminSections: ${stuck.join(", ")} follow each other in a circle`);
-  return out;
-}
-
-/**
- * The admin area's section ids in the template's order (0.43, keksdose) — what
- * {@link adminSections} builds its groups in, without the words: for an app that needs the
- * ORDER only (a router's list of paths, a test), outside a component, with no labels.
- *
- *     adminSectionOrder([{ id: "metrics", after: "overview" }], { leaveOut: ["billing"] })
- *     // ["overview", "metrics", "users", "invitations", "activity"]
- *
- * Throws as {@link adminSections} does.
- */
-export function adminSectionOrder<G extends string = never, L extends AdminSharedSection = AdminSharedSection>(
-  own: readonly AdminSectionPlace<G>[] = [],
-  options: AdminSectionOrderOptions<L> = {},
-): (AdminKeptSection<L> | G)[] {
-  return orderSections(own, options.leaveOut).map((s) =>
-    "shared" in s ? (s.shared.id as AdminKeptSection<L>) : s.own.id,
-  );
-}
-
-/**
- * An app's admin catalogue groups, in the template's order (§2.3 decision 10, §6.8): the
- * shared sections with the kit's icons and words, and the app's own at the places they
- * name. The result is `SettingsLayout`'s `groups`; the entries stay the app's (a group
- * with no visible entry is hidden, as on any settings page — except, since 0.43, the
- * Overview, a page of tiles that needs no entry: it is `standalone`). Since 0.43 the
- * result's type leaves out the `leaveOut` sections, and {@link adminSectionOrder} gives
- * the same order as ids, without words.
- *
- *     const groups = adminSections(useAdminAreaLabels(), [
- *       { id: "metrics", icon: <BarChart3 />, title: t("…"), help: t("…"), after: "overview" },
- *       { id: "messaging", icon: <MessageSquare />, title: t("…"), help: t("…") },
- *       { id: "health", icon: <HeartPulse />, title: t("…"), help: t("…"), after: "billing" },
- *     ], { leaveOut: ["billing"] });
- *
- * gives keksdose's overview, metrics, users, invitations, messaging, health, activity.
- * An `after` that names a left-out section takes that section's place. Kurvenschmiede's
- * Teams needs no `after`: between Invitations and Activity is the default.
- *
- * `labels` is the `adminArea` namespace, resolved — {@link useAdminAreaLabels} inside a
- * component, or the app's catalogue for the language; `undefined` is English. Throws for
- * an own section whose id is a shared one, an id given twice, or an `after` that names no
- * section: the catalogue is built once, and a section quietly missing from it is worse.
- */
-export function adminSections<G extends string = never, L extends AdminSharedSection = AdminSharedSection>(
-  labels: AdminAreaLabels | undefined,
-  own: readonly AdminOwnSection<G>[] = [],
-  options: AdminSectionsOptions<L> = {},
-): SettingsGroup<AdminKeptSection<L> | G>[] {
-  const words = labels ?? DEFAULT_ADMIN_AREA_LABELS;
-  return orderSections(own, options.leaveOut).map((s): SettingsGroup<AdminKeptSection<L> | G> => {
-    if ("own" in s) {
-      const { after: _after, ...group } = s.own;
-      return group;
-    }
-    const { id, icon } = s.shared;
-    const visible = options.visible?.[id];
-    return {
-      id: id as AdminKeptSection<L>,
-      icon: createElement(icon, { "aria-hidden": true }) as ReactNode,
-      title: words.sections[id].title,
-      help: words.sections[id].help,
-      // 0.43 (kastlan): the overview is a page of tiles, not of setting cards — it shows
-      // with no entry of its own.
-      ...(id === "overview" ? { standalone: true } : null),
-      ...(visible === undefined ? null : { visible }),
-      ...(options.badges?.[id] == null ? null : { badge: options.badges[id] }),
-    };
-  });
-}

package/src/admin/admin-tool-links.tsx

@@ -1,90 +0,0 @@
-import { useId } from "react";
-import type { ReactElement, ReactNode } from "react";
-import { cn } from "../lib/cn";
-import { List, ListItem } from "../components/list";
-import type { ListItemLinkProps } from "../components/list";
-import type { LabelOverride } from "../i18n/kit-labels";
-import { useAdminAreaLabels } from "./admin-area-labels";
-import type { AdminAreaLabels } from "./admin-area-labels";
-
-/** One link of the Tools list. */
-export interface AdminToolLink {
-  /** Unique in the list. */
-  key: string;
-  label: string;
-  href: string;
-  /** A lucide element, sized by the row. */
-  icon?: ReactNode;
-  /** `false` leaves the link out — Translations for an admin who doesn't review
-   *  (§6.11, ka F7). Default: shown. */
-  visible?: boolean;
-}
-
-export interface AdminToolLinksProps {
-  links: readonly AdminToolLink[];
-  /**
-   * `sidebar` (default): a `<nav>` named and headed "Tools", for `SettingsLayout`'s
-   * `sidebarFooter` under the section list on a desktop. `list`: the bare rows, for
-   * `SettingsLayout`'s `phoneFooter`, which puts them in a list of their own.
-   */
-  variant?: "sidebar" | "list";
-  /** Your router's link. Default: the `<UiKitProvider linkComponent>`, then `<a>`. */
-  renderLink?: (props: ListItemLinkProps) => ReactElement;
-  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */
-  labels?: LabelOverride<AdminAreaLabels>;
-  className?: string;
-}
-
-/**
- * The admin area's links to the admin tools that are pages of their own (0.42.0,
- * docs/admin-harmonization.md §2.5 decision 16, §6.11): Translations, and the app's task
- * pages (kastlan's Data import). The feedback inbox is not one of them: the top bar's
- * feedback menu reaches it, and the overview's tiles link to it.
- *
- * Draw it twice from one list — at the foot of the section sidebar and in the phone
- * footer:
- *
- *     <SettingsLayout
- *       sidebarFooter={<AdminToolLinks links={TOOLS} />}
- *       phoneFooter={<AdminToolLinks links={TOOLS} variant="list" />}
- *       …
- *     />
- *
- * With no visible link it renders nothing.
- */
-export function AdminToolLinks({
-  links,
-  variant = "sidebar",
-  renderLink,
-  labels: labelsProp,
-  className,
-}: AdminToolLinksProps) {
-  const labels = useAdminAreaLabels(labelsProp);
-  const headingId = useId();
-  const shown = links.filter((l) => l.visible !== false);
-  if (shown.length === 0) return null;
-  const rows = shown.map((l) => (
-    <ListItem
-      key={l.key}
-      href={l.href}
-      renderLink={renderLink}
-      title={l.label}
-      leading={
-        l.icon === undefined ? undefined : (
-          <span aria-hidden className="flex shrink-0 text-muted [&_svg]:size-4">
-            {l.icon}
-          </span>
-        )
-      }
-    />
-  ));
-  if (variant === "list") return <>{rows}</>;
-  return (
-    <nav data-slot="admin-tool-links" aria-labelledby={headingId} className={cn("space-y-1", className)}>
-      <div id={headingId} className="px-3 text-caption font-semibold uppercase tracking-wide text-muted">
-        {labels.tools}
-      </div>
-      <List density="compact">{rows}</List>
-    </nav>
-  );
-}

package/src/admin/invitations-panel-labels.ts

@@ -1,31 +0,0 @@
-// The English words of ./invitations-panel, 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). ./invitations-panel re-exports them.
-
-import type { InvitationsLabels } from "./invitations-panel";
-
-export const DEFAULT_INVITATIONS_LABELS: InvitationsLabels = {
-  email: "Email address",
-  invalidEmail: "Enter a complete email address.",
-  role: "Role",
-  scope: "Scope",
-  scopeNone: "None",
-  language: "Language of the invitation",
-  note: "Note",
-  invite: "Invite",
-  listTitle: "Invitations",
-  empty: "Nobody has been invited yet.",
-  loading: "Loading…",
-  status: { open: "Open", accepted: "Accepted", expired: "Expired", revoked: "Revoked" },
-  sent: (date) => `Sent ${date}`,
-  expires: (date) => `Expires ${date}`,
-  invitedBy: (name) => `by ${name}`,
-  resend: (email) => `Send ${email} a new link`,
-  copyLink: "Copy invitation link",
-  revoke: (email) => `Revoke the invitation for ${email}`,
-  consoleHint:
-    "Mail isn’t sent on this server — it is written to the server log. Copy each invitation link from here and pass it on yourself: it is shown only once.",
-  linkReady: (email) => `The invitation link for ${email}, shown only this once:`,
-  notSent: (email) => `${email} is invited, but the mail couldn’t be sent. Resend it.`,
-  failed: "That didn’t work. Please try again.",
-};