@eifi1/ui-kit 0.41.0 → 0.43.0

package/README.md

@@ -556,19 +556,19 @@ columns, strings and permissions (see the note at the top of `src/feedback/feedb
 
 <!-- BEGIN GENERATED: exports — node scripts/gen-export-inventory.mjs -->
 
-**1982 names from 322 modules** — 916 values and 1066 types. _Italic_ is a type-only export.
+**2079 names from 341 modules** — 958 values and 1121 types. _Italic_ is a type-only export.
 
 Generated from `dist/index.d.ts` by `node scripts/gen-export-inventory.mjs`; the count
 is pinned by `src/__tests__/public-surface.test.ts`. Do not edit between the markers.
 
 | Entry point | Names |
 |---|---|
-| `@eifi1/ui-kit` | 1982 |
+| `@eifi1/ui-kit` | 2079 |
 | `@eifi1/ui-kit/chart` | 92 |
-| `@eifi1/ui-kit/shell` | 80 |
+| `@eifi1/ui-kit/shell` | 110 |
 | `@eifi1/ui-kit/data-table` | 51 |
 | `@eifi1/ui-kit/wizard` | 24 |
-| `@eifi1/ui-kit/tour` | 7 |
+| `@eifi1/ui-kit/tour` | 31 |
 | `@eifi1/ui-kit/feedback` | 205 |
 | `@eifi1/ui-kit/search` | 23 |
 | `@eifi1/ui-kit/dates` | 22 |
@@ -746,7 +746,7 @@ re-slicing of it, never a second API.
 | `components/description-list` | `DEFAULT_DESCRIPTION_LIST_LABELS`, `DescriptionItem`, `DescriptionList`, _`DescriptionItemProps`_, _`DescriptionListColumns`_, _`DescriptionListDensity`_, _`DescriptionListLabels`_, _`DescriptionListLayout`_, _`DescriptionListProps`_ |
 | `components/form-actions` | `DEFAULT_FORM_ACTIONS_LABELS`, `FormActions`, _`FormActionsAlign`_, _`FormActionsDestructive`_, _`FormActionsLabels`_, _`FormActionsPlacement`_, _`FormActionsProps`_, _`FormActionsStack`_, _`FormActionsStickyWithin`_, _`FormActionsSubmitProps`_, _`FormActionsSubmitShortcut`_, _`ResponsiveFormActionsPlacement`_ |
 | `components/write-lock` | `COMMIT_EXCEPT_BILLING`, `DEFAULT_WRITE_LOCK_LABELS`, `useWriteLock`, `writeLockFor`, `WriteLockProvider`, _`CommitScope`_, _`WriteLock`_, _`WriteLockHold`_, _`WriteLockKind`_, _`WriteLockLabels`_, _`WriteLockProviderProps`_ |
-| `components/account-chips` | `ACCOUNT_STATE_TONES`, `AccountStateChip`, `dateColumn`, `DateMark`, `DEFAULT_ACCOUNT_STATE_LABELS`, `RoleChip`, _`AccountState`_, _`AccountStateChipProps`_, _`AccountStateLabels`_, _`DateColumnOptions`_, _`DateMarkProps`_, _`RoleChipProps`_, _`RoleDefinition`_, _`RoleVocabulary`_ |
+| `components/account-chips` | `ACCOUNT_STATE_TONES`, `AccountRoleChip`, `AccountStateChip`, `dateColumn`, `DateMark`, `DEFAULT_ACCOUNT_STATE_LABELS`, `RoleChip`, _`AccountRoleChipProps`_, _`AccountState`_, _`AccountStateChipProps`_, _`AccountStateLabels`_, _`DateColumnOptions`_, _`DateMarkProps`_, _`RoleChipProps`_, _`RoleDefinition`_, _`RoleVocabulary`_ |
 | `components/server-wake` | `DEFAULT_SERVER_WAKE_LABELS`, `ServerWakeNotice`, `useServerWakeStage`, _`ServerWakeLabels`_, _`ServerWakeNoticeProps`_ |
 | `components/share-card` | `DEFAULT_SHARE_CARD_LABELS`, `ShareCard`, `ShareDialog`, `SharePanel`, _`ShareAddRequest`_, _`ShareCandidate`_, _`ShareCardLabels`_, _`ShareCardProps`_, _`ShareDialogProps`_, _`ShareGrantee`_, _`SharePanelProps`_, _`SharePendingGrant`_, _`ShareRole`_ |
 | `components/line-items` | `DEFAULT_LINE_ITEMS_LABELS`, `LineItems`, _`LineItemCellContext`_, _`LineItemsColumn`_, _`LineItemsFieldLabels`_, _`LineItemsLabels`_, _`LineItemsProps`_, _`LineItemsRemoveAlign`_, _`LineItemsRemovePlacement`_, _`LineItemsRowProps`_, _`LineItemsSummary`_, _`LineItemsSummaryTone`_ |
@@ -819,6 +819,13 @@ re-slicing of it, never a second API.
 | `shell/top-bar-brand` | `TopBarBrand`, _`TopBarBrandProps`_ |
 | `shell/auth-layout` | `AuthLayout`, _`AuthLayoutProps`_ |
 | `shell/fill-height` | `FILL_HEIGHT_CLASS`, `FillHeight`, _`FillHeightProps`_ |
+| `shell/admin-menu` | `adminMenuEntry`, `AdminMenuRow`, `useAdminMenuEntry`, _`AdminMenuEntryOptions`_, _`AdminMenuRowProps`_, _`UseAdminMenuEntryOptions`_ |
+| `shell/top-bar-actions` | `TOP_BAR_ACTION_ORDER`, `TopBarActions`, _`TopBarActionsProps`_ |
+| `shell/account-menu-language` | `AccountMenuLanguage`, _`AccountMenuLanguageOption`_, _`AccountMenuLanguageProps`_ |
+| `shell/tour-menu` | `TourMenu`, _`TourMenuProps`_, _`TourMenuTour`_ |
+| `shell/sync-status-indicator` | `syncState`, `SyncStatusIndicator`, _`SyncState`_, _`SyncStatus`_, _`SyncStatusIndicatorProps`_, _`SyncStatusScope`_ |
+| `shell/dev-switchers` | `DEV_ORIGINAL_ROLE_KEY`, `DevSwitchers`, _`DevSwitchersProps`_ |
+| `shell/top-bar-parts-labels` | `DEFAULT_TOP_BAR_PARTS_LABELS`, `useTopBarPartsLabels`, _`DevSwitchersLabels`_, _`SyncStatusLabels`_, _`TopBarPartsLabels`_, _`TourMenuLabels`_ |
 | `shell/company-switcher` | `CompanySwitcher`, `DEFAULT_COMPANY_SWITCHER_LABELS`, _`CompanySwitcherCompany`_, _`CompanySwitcherLabels`_, _`CompanySwitcherProps`_ |
 
 ### settings
@@ -893,6 +900,10 @@ re-slicing of it, never a second API.
 | Module | Exports |
 |---|---|
 | `tour/tour` | `DEFAULT_TOUR_LABELS`, `TourProvider`, `useTour`, `useTourOptional`, _`TourLabels`_, _`TourPlacement`_, _`TourStep`_ |
+| `tour/tour-catalogue` | `DEFAULT_TOUR_CATALOGUE_LABELS`, `TourCatalogue`, `TourCatalogueCard`, _`TourCatalogueCardProps`_, _`TourCatalogueLabels`_, _`TourCatalogueProps`_ |
+| `tour/tour-info` | `doneCount`, `earnedPoints`, `isTourDone`, `isTourNew`, `isTourReset`, _`TourCompletions`_, _`TourGroup`_, _`TourInfo`_, _`TourUpdate`_ |
+| `tour/use-tour-progress` | `resetTourProgress`, `useTourProgress`, _`TourProgress`_, _`UseTourProgressOptions`_ |
+| `tour/use-tour-url-sync` | `useTourCatalogueUrlState`, `useTourUrlSync`, _`TourCatalogueFilter`_, _`TourStateFilter`_, _`UseTourUrlSyncOptions`_ |
 
 ### search
 
@@ -943,6 +954,11 @@ re-slicing of it, never a second API.
 | `admin/transfer-ownership-dialog` | `DEFAULT_TRANSFER_OWNERSHIP_LABELS`, `TransferOwnershipDialog`, _`TransferCandidate`_, _`TransferOwnershipDialogProps`_, _`TransferOwnershipLabels`_, _`TransferUnavailable`_, _`TransferValues`_ |
 | `admin/invitations-panel` | `DEFAULT_INVITATIONS_LABELS`, `InvitationsPanel`, _`InvitationDraft`_, _`InvitationRow`_, _`InvitationScope`_, _`InvitationSentAnswer`_, _`InvitationsLabels`_, _`InvitationsPanelProps`_, _`InvitationStatus`_ |
 | `admin/admin-parts` | _`AdminPerson`_ |
+| `admin/admin-area-labels` | `DEFAULT_ADMIN_AREA_LABELS`, `useAdminAreaLabels`, _`AdminAreaLabels`_, _`AdminSharedSection`_, _`AdminTileLabels`_ |
+| `admin/admin-sections` | `ADMIN_SECTIONS`, `adminSectionOrder`, `adminSections`, _`AdminKeptSection`_, _`AdminOwnSection`_, _`AdminSectionDefinition`_, _`AdminSectionOrderOptions`_, _`AdminSectionPlace`_, _`AdminSectionsOptions`_ |
+| `admin/admin-forbidden` | `AdminForbidden`, _`AdminForbiddenProps`_ |
+| `admin/admin-overview` | `AdminOverview`, `adminWaitingCount`, `AttentionTile`, `DEFAULT_ADMIN_ATTENTION_HREFS`, _`AdminAttention`_, _`AdminAttentionTile`_, _`AdminExtraTile`_, _`AdminOverviewProps`_, _`AttentionTileProps`_ |
+| `admin/admin-tool-links` | `AdminToolLinks`, _`AdminToolLink`_, _`AdminToolLinksProps`_ |
 | `admin/plan-change` | `DEFAULT_PLAN_CHANGE_LABELS`, `PlanChangeConfirm`, `planColumn`, `usePlanChangeResult`, `usePlanColumn`, _`PlanChange`_, _`PlanChangeConfirmProps`_, _`PlanChangeLabels`_, _`PlanChangeLine`_, _`PlanChangeOutcome`_, _`PlanChangeResultOptions`_, _`PlanChangeTone`_, _`PlanColumnOptions`_, _`PlanColumnUsage`_ |
 
 ### billing
@@ -951,7 +967,7 @@ re-slicing of it, never a second API.
 |---|---|
 | `billing/billing-labels` | `DEFAULT_BILLING_LABELS`, `SUBSCRIPTION_STATUSES`, `useBillingLabels`, _`BillingLabels`_, _`SubscriptionStatus`_ |
 | `billing/plan-price` | `BILLING_INTERVALS`, `billingCurrencyFor`, `formatPlanPrice`, `minorToMajor`, `planPrice`, _`BillingCurrency`_, _`BillingInterval`_, _`PlanIntervalPrices`_, _`PlanPriceAnswer`_, _`PlanPrices`_ |
-| `billing/plan-card` | `PlanCard`, `PlanPicker`, `planRelation`, _`BillingPlan`_, _`PlanCardProps`_, _`PlanChoice`_, _`PlanPickerProps`_, _`PlanRelation`_ |
+| `billing/plan-card` | `GrantWarningConfirm`, `PlanCard`, `PlanPicker`, `planRelation`, _`BillingPlan`_, _`GrantWarningConfirmProps`_, _`PlanCardProps`_, _`PlanChoice`_, _`PlanPickerProps`_, _`PlanRelation`_ |
 | `billing/subscription-status-chip` | `SUBSCRIPTION_STATUS_TONES`, `SubscriptionStatusChip`, _`SubscriptionStatusChipProps`_ |
 | `billing/billing-banner` | `BillingBanner`, _`BillingBannerKind`_, _`BillingBannerProps`_ |
 | `billing/plan-limit-notice` | `planLimitMailto`, `PlanLimitNotice`, _`PlanLimitNoticeProps`_ |
@@ -962,9 +978,12 @@ re-slicing of it, never a second API.
 | `billing/checkout-return` | `CHECKOUT_RETURN_PARAM`, `CHECKOUT_RETURN_VALUE`, `checkoutReturnUrl`, `isCheckoutReturn`, `withoutCheckoutReturn` |
 | `billing/checkout-processing` | `checkoutFingerprint`, `checkoutLanded`, `noteCheckoutStarted`, `useCheckoutProcessing`, _`CheckoutOverview`_, _`CheckoutProcessingOptions`_ |
 | `billing/pay-page` | `paddleLocale`, `PAY_PAGE_APPS`, `PAY_PAGE_LANG_PARAM`, `payPageUrl`, _`PaddleEnvironment`_, _`PayPageApp`_ |
-| `billing/billing-overview` | _`BillingOverview`_, _`PaidPrice`_, _`PlanSwitchPreview`_, _`PlanSwitchRequest`_, _`PortalRequest`_, _`PortalTarget`_, _`SubscriptionSource`_ |
+| `billing/billing-overview` | `isPermanentGrant`, _`BillingOverview`_, _`BillingPortalAccess`_, _`PaidPrice`_, _`PlanSwitchPreview`_, _`PlanSwitchRequest`_, _`PortalRequest`_, _`PortalTarget`_, _`SubscriptionSource`_ |
 | `billing/plan-limit-toast` | `usePlanLimitToast`, _`PlanLimitToastOptions`_ |
 | `billing/plan-switch` | `PlanSwitchConfirm`, _`PlanSwitchConfirmProps`_, _`PlanSwitchSide`_ |
+| `billing/cancel-subscription` | `CancelSubscriptionConfirm`, _`CancelSubscriptionConfirmProps`_ |
+| `billing/provider-page` | `openProviderPage`, _`OpenProviderPageOptions`_, _`ProviderPageWay`_ |
+| `billing/cancel-request` | `useCancelRequest`, _`CancelRequest`_, _`CancelRequested`_, _`CancelRequestView`_ |
 
 ### notifications
 

package/dist/admin/admin-area-labels.d.ts

@@ -0,0 +1,59 @@
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import type { SettingsGroupLabels } from "../settings/settings-labels.js";
+/**
+ * The `adminArea` namespace (0.42, docs/admin-harmonization.md §3.1): the kit's words of
+ * the admin area every app shares — the account menu's "Administration" row, the 403
+ * page, the shared sections' names and help lines, the overview's tiles and the Tools
+ * list. A module of words with no component code, like every `*-labels.ts` (0.34, KS U8).
+ * An app's own sections and tiles bring their own words.
+ */
+/** The sections every app's admin area shares, in the template's order (§2.3). */
+export type AdminSharedSection = "overview" | "users" | "invitations" | "billing" | "activity";
+/** The overview's shared tiles (§2.4, §6.1). */
+export interface AdminTileLabels {
+    /** `feedback_waiting`: OPEN reports, crash reports included (§6.1). */
+    feedbackWaiting: string;
+    /** `deletion_requests`. */
+    deletionRequests: string;
+    /** `invitations_pending`. */
+    invitationsPending: string;
+    /** `users_total`. */
+    users: string;
+    /** `users_new_7d`, the line under the users tile. */
+    usersNew: (count: number) => string;
+}
+export interface AdminAreaLabels {
+    /** "Administration": the account menu's row, and the admin page's heading. */
+    title: string;
+    /** The row's waiting count, for a reader ("Administration, 3 waiting"); the eye sees
+     *  the number in the badge. */
+    waiting: (count: number) => string;
+    /** The 403 page's heading (§2.2 decision 8). */
+    forbiddenTitle: string;
+    /**
+     * Under it. Says only that THIS area is closed to the account — never that the person
+     * administers nothing anywhere (§6.7: a kastlan superuser who isn't ADMIN in the acting
+     * company gets this page).
+     */
+    forbiddenBody: (appName: string) => string;
+    /** The button back to the app's start, unless the app names its own (`homeLabel`). */
+    forbiddenHome: string;
+    /** A reviewer's second way out, to the translations review. */
+    forbiddenReviewer: string;
+    /** The shared sections' names and help lines (§2.3 decision 11). */
+    sections: Record<AdminSharedSection, SettingsGroupLabels>;
+    /** The overview's tiles. */
+    tiles: AdminTileLabels;
+    /** 0.43: `AdminOverview`'s `error` — the counts could not be loaded. */
+    overviewError: string;
+    /** 0.43: its button, which calls `onRetry`. */
+    retry: string;
+    /** The Tools list's heading and name (§2.5 decision 16). */
+    tools: string;
+}
+export declare const DEFAULT_ADMIN_AREA_LABELS: AdminAreaLabels;
+/**
+ * The `adminArea` namespace, resolved — English, then the provider, then `labels`. What
+ * an app reads to hand {@link adminSections} its words from inside a component.
+ */
+export declare function useAdminAreaLabels(labels?: LabelOverride<AdminAreaLabels>): AdminAreaLabels;

package/dist/admin/admin-area-labels.js

@@ -0,0 +1,35 @@
+"use client";
+import { useKitLabels } from "../i18n/kit-labels.js";
+const DEFAULT_ADMIN_AREA_LABELS = {
+  title: "Administration",
+  waiting: (count) => `${count} waiting`,
+  forbiddenTitle: "Only for administrators",
+  forbiddenBody: (appName) => `This is where administrators run ${appName}. Your account cannot open this page.`,
+  forbiddenHome: "Go to the start page",
+  forbiddenReviewer: "Review translations",
+  sections: {
+    overview: { title: "Overview", help: "What is waiting, at a glance." },
+    users: { title: "Users", help: "Who has an account, and what each may do." },
+    invitations: { title: "Invitations", help: "Invite people by e-mail in their language; resend or revoke what\u2019s still open." },
+    billing: { title: "Billing", help: "The plan, the payment and the invoices." },
+    activity: { title: "Activity", help: "What the admins did, newest first." }
+  },
+  tiles: {
+    feedbackWaiting: "To triage",
+    deletionRequests: "Deletion requests",
+    invitationsPending: "Pending invitations",
+    users: "Users",
+    usersNew: (count) => `${count} new in 7 days`
+  },
+  overviewError: "The overview couldn\u2019t be loaded.",
+  retry: "Try again",
+  tools: "Tools"
+};
+function useAdminAreaLabels(labels) {
+  return useKitLabels("adminArea", DEFAULT_ADMIN_AREA_LABELS, labels);
+}
+export {
+  DEFAULT_ADMIN_AREA_LABELS,
+  useAdminAreaLabels
+};
+//# sourceMappingURL=admin-area-labels.js.map

package/dist/admin/admin-area-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/admin-area-labels.ts"],"sourcesContent":["import { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport type { SettingsGroupLabels } from \"../settings/settings-labels\";\n\n/**\n * The `adminArea` namespace (0.42, docs/admin-harmonization.md §3.1): the kit's words of\n * the admin area every app shares — the account menu's \"Administration\" row, the 403\n * page, the shared sections' names and help lines, the overview's tiles and the Tools\n * list. A module of words with no component code, like every `*-labels.ts` (0.34, KS U8).\n * An app's own sections and tiles bring their own words.\n */\n\n/** The sections every app's admin area shares, in the template's order (§2.3). */\nexport type AdminSharedSection = \"overview\" | \"users\" | \"invitations\" | \"billing\" | \"activity\";\n\n/** The overview's shared tiles (§2.4, §6.1). */\nexport interface AdminTileLabels {\n  /** `feedback_waiting`: OPEN reports, crash reports included (§6.1). */\n  feedbackWaiting: string;\n  /** `deletion_requests`. */\n  deletionRequests: string;\n  /** `invitations_pending`. */\n  invitationsPending: string;\n  /** `users_total`. */\n  users: string;\n  /** `users_new_7d`, the line under the users tile. */\n  usersNew: (count: number) => string;\n}\n\nexport interface AdminAreaLabels {\n  /** \"Administration\": the account menu's row, and the admin page's heading. */\n  title: string;\n  /** The row's waiting count, for a reader (\"Administration, 3 waiting\"); the eye sees\n   *  the number in the badge. */\n  waiting: (count: number) => string;\n  /** The 403 page's heading (§2.2 decision 8). */\n  forbiddenTitle: string;\n  /**\n   * Under it. Says only that THIS area is closed to the account — never that the person\n   * administers nothing anywhere (§6.7: a kastlan superuser who isn't ADMIN in the acting\n   * company gets this page).\n   */\n  forbiddenBody: (appName: string) => string;\n  /** The button back to the app's start, unless the app names its own (`homeLabel`). */\n  forbiddenHome: string;\n  /** A reviewer's second way out, to the translations review. */\n  forbiddenReviewer: string;\n  /** The shared sections' names and help lines (§2.3 decision 11). */\n  sections: Record<AdminSharedSection, SettingsGroupLabels>;\n  /** The overview's tiles. */\n  tiles: AdminTileLabels;\n  /** 0.43: `AdminOverview`'s `error` — the counts could not be loaded. */\n  overviewError: string;\n  /** 0.43: its button, which calls `onRetry`. */\n  retry: string;\n  /** The Tools list's heading and name (§2.5 decision 16). */\n  tools: string;\n}\n\nexport const DEFAULT_ADMIN_AREA_LABELS: AdminAreaLabels = {\n  title: \"Administration\",\n  waiting: (count) => `${count} waiting`,\n  forbiddenTitle: \"Only for administrators\",\n  forbiddenBody: (appName) => `This is where administrators run ${appName}. Your account cannot open this page.`,\n  forbiddenHome: \"Go to the start page\",\n  forbiddenReviewer: \"Review translations\",\n  sections: {\n    overview: { title: \"Overview\", help: \"What is waiting, at a glance.\" },\n    users: { title: \"Users\", help: \"Who has an account, and what each may do.\" },\n    invitations: { title: \"Invitations\", help: \"Invite people by e-mail in their language; resend or revoke what’s still open.\" },\n    billing: { title: \"Billing\", help: \"The plan, the payment and the invoices.\" },\n    activity: { title: \"Activity\", help: \"What the admins did, newest first.\" },\n  },\n  tiles: {\n    feedbackWaiting: \"To triage\",\n    deletionRequests: \"Deletion requests\",\n    invitationsPending: \"Pending invitations\",\n    users: \"Users\",\n    usersNew: (count) => `${count} new in 7 days`,\n  },\n  overviewError: \"The overview couldn’t be loaded.\",\n  retry: \"Try again\",\n  tools: \"Tools\",\n};\n\n/**\n * The `adminArea` namespace, resolved — English, then the provider, then `labels`. What\n * an app reads to hand {@link adminSections} its words from inside a component.\n */\nexport function useAdminAreaLabels(labels?: LabelOverride<AdminAreaLabels>): AdminAreaLabels {\n  return useKitLabels(\"adminArea\", DEFAULT_ADMIN_AREA_LABELS, labels);\n}\n"],"mappings":";AAAA,SAAS,oBAAwC;AA0D1C,MAAM,4BAA6C;AAAA,EACxD,OAAO;AAAA,EACP,SAAS,CAAC,UAAU,GAAG,KAAK;AAAA,EAC5B,gBAAgB;AAAA,EAChB,eAAe,CAAC,YAAY,oCAAoC,OAAO;AAAA,EACvE,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,UAAU;AAAA,IACR,UAAU,EAAE,OAAO,YAAY,MAAM,gCAAgC;AAAA,IACrE,OAAO,EAAE,OAAO,SAAS,MAAM,4CAA4C;AAAA,IAC3E,aAAa,EAAE,OAAO,eAAe,MAAM,sFAAiF;AAAA,IAC5H,SAAS,EAAE,OAAO,WAAW,MAAM,0CAA0C;AAAA,IAC7E,UAAU,EAAE,OAAO,YAAY,MAAM,qCAAqC;AAAA,EAC5E;AAAA,EACA,OAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,kBAAkB;AAAA,IAClB,oBAAoB;AAAA,IACpB,OAAO;AAAA,IACP,UAAU,CAAC,UAAU,GAAG,KAAK;AAAA,EAC/B;AAAA,EACA,eAAe;AAAA,EACf,OAAO;AAAA,EACP,OAAO;AACT;AAMO,SAAS,mBAAmB,QAA0D;AAC3F,SAAO,aAAa,aAAa,2BAA2B,MAAM;AACpE;","names":[]}

package/dist/admin/admin-forbidden.d.ts

@@ -0,0 +1,35 @@
+import type { ComponentPropsWithRef } from "react";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { AdminAreaLabels } from "./admin-area-labels.js";
+export interface AdminForbiddenProps extends Omit<ComponentPropsWithRef<"div">, "children" | "title"> {
+    /** The app's name, in the sentence: "This is where administrators run Kastlan." */
+    appName: string;
+    /** The button's target: the app's start page (keksdose `/budget`, kastlan `/dashboard`). */
+    homeHref: string;
+    /** The button's words, where the app names its start ("Back to the budget"). Default
+     *  `adminArea.forbiddenHome`, "Go to the start page". */
+    homeLabel?: string;
+    /** Pass it to a translation reviewer: a second button, "Review translations", to the
+     *  tool their role does have (§2.2 decision 8). */
+    reviewerHref?: string;
+    /** The heading's level. Default `h1`: the page stands alone inside the app shell. */
+    headingAs?: "h1" | "h2" | "h3";
+    /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */
+    labels?: LabelOverride<AdminAreaLabels>;
+}
+/**
+ * The admin area's 403 page (0.42.0, docs/admin-harmonization.md §2.2 decision 8, §6.7),
+ * keksdose's `AdminForbidden`: "Only for administrators" / "This is where administrators
+ * run {app}. Your account cannot open this page.", and a button back to the app's start.
+ *
+ * It RENDERS, it does not redirect: the app's client gate shows it in place of the admin
+ * page, on the same admin check the account menu uses, inside the lazy route — so a
+ * bookmark keeps its address, and signing in as an admin opens the page that was asked
+ * for. The server's gate stays the rule. kastlan shows it on its admin tools (`/admin`,
+ * `/import`, `/feedback`); its work pages keep their generic 403.
+ *
+ * The words say only that this area is closed to this account, never that the person
+ * administers nothing anywhere: a kastlan superuser who isn't ADMIN in the acting company
+ * gets this page too.
+ */
+export declare function AdminForbidden({ appName, homeHref, homeLabel, reviewerHref, headingAs, labels: labelsProp, className, ...rest }: AdminForbiddenProps): import("react").JSX.Element;

package/dist/admin/admin-forbidden.js

@@ -0,0 +1,36 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { ShieldAlert } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { Button } from "../components/button.js";
+import { EmptyState } from "../components/empty-state.js";
+import { useAdminAreaLabels } from "./admin-area-labels.js";
+function AdminForbidden({
+  appName,
+  homeHref,
+  homeLabel,
+  reviewerHref,
+  headingAs = "h1",
+  labels: labelsProp,
+  className,
+  ...rest
+}) {
+  const labels = useAdminAreaLabels(labelsProp);
+  return /* @__PURE__ */ jsx("div", { ...rest, "data-slot": "admin-forbidden", className: cn("mx-auto w-full max-w-xl p-4 md:p-6", className), children: /* @__PURE__ */ jsx(
+    EmptyState,
+    {
+      icon: /* @__PURE__ */ jsx(ShieldAlert, {}),
+      headingAs,
+      title: labels.forbiddenTitle,
+      hint: labels.forbiddenBody(appName),
+      action: /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(Button, { href: homeHref, variant: "secondary", children: homeLabel ?? labels.forbiddenHome }),
+        reviewerHref !== void 0 && /* @__PURE__ */ jsx(Button, { href: reviewerHref, variant: "secondary", children: labels.forbiddenReviewer })
+      ] })
+    }
+  ) });
+}
+export {
+  AdminForbidden
+};
+//# sourceMappingURL=admin-forbidden.js.map

package/dist/admin/admin-forbidden.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/admin-forbidden.tsx"],"sourcesContent":["import type { ComponentPropsWithRef } from \"react\";\nimport { ShieldAlert } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { Button } from \"../components/button\";\nimport { EmptyState } from \"../components/empty-state\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { useAdminAreaLabels } from \"./admin-area-labels\";\nimport type { AdminAreaLabels } from \"./admin-area-labels\";\n\nexport interface AdminForbiddenProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"title\"> {\n  /** The app's name, in the sentence: \"This is where administrators run Kastlan.\" */\n  appName: string;\n  /** The button's target: the app's start page (keksdose `/budget`, kastlan `/dashboard`). */\n  homeHref: string;\n  /** The button's words, where the app names its start (\"Back to the budget\"). Default\n   *  `adminArea.forbiddenHome`, \"Go to the start page\". */\n  homeLabel?: string;\n  /** Pass it to a translation reviewer: a second button, \"Review translations\", to the\n   *  tool their role does have (§2.2 decision 8). */\n  reviewerHref?: string;\n  /** The heading's level. Default `h1`: the page stands alone inside the app shell. */\n  headingAs?: \"h1\" | \"h2\" | \"h3\";\n  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n}\n\n/**\n * The admin area's 403 page (0.42.0, docs/admin-harmonization.md §2.2 decision 8, §6.7),\n * keksdose's `AdminForbidden`: \"Only for administrators\" / \"This is where administrators\n * run {app}. Your account cannot open this page.\", and a button back to the app's start.\n *\n * It RENDERS, it does not redirect: the app's client gate shows it in place of the admin\n * page, on the same admin check the account menu uses, inside the lazy route — so a\n * bookmark keeps its address, and signing in as an admin opens the page that was asked\n * for. The server's gate stays the rule. kastlan shows it on its admin tools (`/admin`,\n * `/import`, `/feedback`); its work pages keep their generic 403.\n *\n * The words say only that this area is closed to this account, never that the person\n * administers nothing anywhere: a kastlan superuser who isn't ADMIN in the acting company\n * gets this page too.\n */\nexport function AdminForbidden({\n  appName,\n  homeHref,\n  homeLabel,\n  reviewerHref,\n  headingAs = \"h1\",\n  labels: labelsProp,\n  className,\n  ...rest\n}: AdminForbiddenProps) {\n  const labels = useAdminAreaLabels(labelsProp);\n  return (\n    <div {...rest} data-slot=\"admin-forbidden\" className={cn(\"mx-auto w-full max-w-xl p-4 md:p-6\", className)}>\n      <EmptyState\n        icon={<ShieldAlert />}\n        headingAs={headingAs}\n        title={labels.forbiddenTitle}\n        hint={labels.forbiddenBody(appName)}\n        action={\n          <>\n            <Button href={homeHref} variant=\"secondary\">\n              {homeLabel ?? labels.forbiddenHome}\n            </Button>\n            {reviewerHref !== undefined && (\n              <Button href={reviewerHref} variant=\"secondary\">\n                {labels.forbiddenReviewer}\n              </Button>\n            )}\n          </>\n        }\n      />\n    </div>\n  );\n}\n"],"mappings":";AAuDc,SAKJ,UALI,KAKJ,YALI;AAtDd,SAAS,mBAAmB;AAC5B,SAAS,UAAU;AACnB,SAAS,cAAc;AACvB,SAAS,kBAAkB;AAE3B,SAAS,0BAA0B;AAmC5B,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR;AAAA,EACA,GAAG;AACL,GAAwB;AACtB,QAAM,SAAS,mBAAmB,UAAU;AAC5C,SACE,oBAAC,SAAK,GAAG,MAAM,aAAU,mBAAkB,WAAW,GAAG,sCAAsC,SAAS,GACtG;AAAA,IAAC;AAAA;AAAA,MACC,MAAM,oBAAC,eAAY;AAAA,MACnB;AAAA,MACA,OAAO,OAAO;AAAA,MACd,MAAM,OAAO,cAAc,OAAO;AAAA,MAClC,QACE,iCACE;AAAA,4BAAC,UAAO,MAAM,UAAU,SAAQ,aAC7B,uBAAa,OAAO,eACvB;AAAA,QACC,iBAAiB,UAChB,oBAAC,UAAO,MAAM,cAAc,SAAQ,aACjC,iBAAO,mBACV;AAAA,SAEJ;AAAA;AAAA,EAEJ,GACF;AAEJ;","names":[]}

package/dist/admin/admin-overview.d.ts

@@ -0,0 +1,110 @@
+import type { ReactNode } from "react";
+import type { StatTileProps } from "../components/stat-tile.js";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { AdminAreaLabels } from "./admin-area-labels.js";
+/**
+ * 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 declare const DEFAULT_ADMIN_ATTENTION_HREFS: Readonly<Record<AdminAttentionTile, string>>;
+/**
+ * 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 declare function adminWaitingCount(attention: AdminAttention | null | undefined, counts: readonly (AdminAttentionTile | (string & {}))[]): number | null;
+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 declare function AttentionTile({ count, href, ...tile }: AttentionTileProps): import("react").JSX.Element;
+/** One of the app's own tiles (§2.4 decision 13: keksdose's "Support waiting"). */
+export interface AdminExtraTile {
+    /** 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;
+}
+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 declare function AdminOverview({ attention, hrefs, extraTiles, tileProps, error, onRetry, labels: labelsProp, className, }: AdminOverviewProps): import("react").JSX.Element | null;

package/dist/admin/admin-overview.js

@@ -0,0 +1,92 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { AlertBanner } from "../components/alert-banner.js";
+import { Button } from "../components/button.js";
+import { StatTile, StatTileGrid } from "../components/stat-tile.js";
+import { cn } from "../lib/cn.js";
+import { useAdminAreaLabels } from "./admin-area-labels.js";
+const DEFAULT_ADMIN_ATTENTION_HREFS = Object.freeze({
+  feedback_waiting: "/feedback",
+  deletion_requests: "/admin/users?state=deletion_requested",
+  invitations_pending: "/admin/invitations",
+  users_total: "/admin/users"
+});
+function adminWaitingCount(attention, counts) {
+  if (!attention) return null;
+  let sum = 0;
+  for (const key of counts) {
+    const shared = attention[key];
+    const value = typeof shared === "number" ? shared : attention.extra?.[key];
+    if (typeof value === "number" && value > 0) sum += value;
+  }
+  return sum;
+}
+function AttentionTile({ count, href, ...tile }) {
+  return /* @__PURE__ */ jsx(StatTile, { "data-slot": "attention-tile", ...tile, value: count ?? null, href });
+}
+function AdminOverview({
+  attention,
+  hrefs,
+  extraTiles = [],
+  tileProps,
+  error,
+  onRetry,
+  labels: labelsProp,
+  className
+}) {
+  const labels = useAdminAreaLabels(labelsProp);
+  const errorBox = (alone) => /* @__PURE__ */ jsx(
+    AlertBanner,
+    {
+      "data-slot": alone ? "admin-overview" : void 0,
+      "data-state": alone ? "error" : void 0,
+      variant: "box",
+      tone: "danger",
+      className: alone ? className : void 0,
+      action: onRetry ? /* @__PURE__ */ jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => onRetry(), children: labels.retry }) : void 0,
+      children: labels.overviewError
+    }
+  );
+  if (error && !attention) return errorBox(true);
+  const href = { ...DEFAULT_ADMIN_ATTENTION_HREFS, ...hrefs };
+  const loading = attention === void 0;
+  const shared = [
+    { 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) : void 0
+    }
+  ];
+  const tiles = [
+    ...shared.map((t) => ({ ...t, count: attention ? attention[t.key] : void 0, href: href[t.key] })),
+    ...extraTiles
+  ].filter((t) => loading || t.count !== null && t.count !== void 0);
+  if (!loading && tiles.length === 0) return error ? errorBox(true) : null;
+  const grid = /* @__PURE__ */ jsx(StatTileGrid, { "data-slot": error ? void 0 : "admin-overview", loading, className: error ? void 0 : className, children: tiles.map((t) => /* @__PURE__ */ jsx(
+    AttentionTile,
+    {
+      ...tileProps,
+      "data-attention": t.key,
+      label: t.label,
+      count: t.count,
+      href: t.href,
+      description: t.description
+    },
+    t.key
+  )) });
+  if (!error) return grid;
+  return /* @__PURE__ */ jsxs("div", { "data-slot": "admin-overview", "data-state": "error", className: cn("space-y-4", className), children: [
+    errorBox(false),
+    grid
+  ] });
+}
+export {
+  AdminOverview,
+  AttentionTile,
+  DEFAULT_ADMIN_ATTENTION_HREFS,
+  adminWaitingCount
+};
+//# sourceMappingURL=admin-overview.js.map

package/dist/admin/admin-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/admin-overview.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { StatTile, StatTileGrid } from \"../components/stat-tile\";\nimport type { StatTileProps } from \"../components/stat-tile\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { useAdminAreaLabels } from \"./admin-area-labels\";\nimport type { AdminAreaLabels } from \"./admin-area-labels\";\n\n/**\n * The admin's start page (0.42.0, docs/admin-harmonization.md §2.4, §6.1–§6.5): a grid\n * of tiles, each a count of what is waiting and a link to where the work is, fed by one\n * server answer.\n */\n\n/**\n * `GET /admin/attention` (§2.4 decision 14, §6.4) — server-kit's `AdminAttention`\n * (`eifi1_server_kit.user_admin.attention`), as the API sends it.\n *\n * Each count is `null` where the app has no such thing or this viewer cannot act on it,\n * and every count is `null` in a demo session. Demo accounts never count. `extra` holds\n * the app's own counts, keyed as its overview names them (keksdose `support_waiting`,\n * Kurvenschmiede `released_for_work`).\n */\nexport interface AdminAttention {\n  /** \"To triage\": OPEN reports, crash reports included (§6.1). */\n  feedback_waiting: number | null;\n  /** Accounts that asked to be deleted — only where this viewer acts on them (§6.2). */\n  deletion_requests: number | null;\n  invitations_pending: number | null;\n  users_total: number | null;\n  /** Accounts made in the last seven days. */\n  users_new_7d: number | null;\n  extra: Record<string, number | null>;\n}\n\n/** The shared counts that are a tile of their own (`users_new_7d` is the users tile's line). */\nexport type AdminAttentionTile = \"feedback_waiting\" | \"deletion_requests\" | \"invitations_pending\" | \"users_total\";\n\n/** Where each shared tile links when the app names nothing else (§2.4 decision 13). */\nexport const DEFAULT_ADMIN_ATTENTION_HREFS: Readonly<Record<AdminAttentionTile, string>> = Object.freeze({\n  feedback_waiting: \"/feedback\",\n  deletion_requests: \"/admin/users?state=deletion_requested\",\n  invitations_pending: \"/admin/invitations\",\n  users_total: \"/admin/users\",\n});\n\n/**\n * The account menu's badge (§2.4 decision 15, §6.3): the sum of the counts that are work\n * waiting on THIS admin — each app names its own (keksdose `[\"feedback_waiting\",\n * \"support_waiting\", \"awaiting_verdict\"]`, kastlan `[\"feedback_waiting\"]`, Kurvenschmiede\n * `[\"feedback_waiting\", \"deletion_requests\"]`). A name is a shared count or an `extra`\n * key; a `null` or missing count adds nothing. Invitations and users never belong in it.\n * `null` while there is no answer yet, so the badge shows nothing rather than a 0.\n */\nexport function adminWaitingCount(\n  attention: AdminAttention | null | undefined,\n  counts: readonly (AdminAttentionTile | (string & {}))[],\n): number | null {\n  if (!attention) return null;\n  let sum = 0;\n  for (const key of counts) {\n    const shared = (attention as unknown as Record<string, unknown>)[key];\n    const value = typeof shared === \"number\" ? shared : attention.extra?.[key];\n    if (typeof value === \"number\" && value > 0) sum += value;\n  }\n  return sum;\n}\n\nexport interface AttentionTileProps extends Omit<StatTileProps, \"href\" | \"onClick\" | \"value\"> {\n  /** The count. `null` shows the tile's dash; {@link AdminOverview} leaves such a tile out. */\n  count: number | null | undefined;\n  /** Where the work is — the tile is a link to it. Since 0.43 it may be left out: a\n   *  quiet count, no link (Kurvenschmiede). */\n  href?: string;\n}\n\n/**\n * One tile of the overview: a {@link StatTile} that is a LINK to where the work is, its\n * count the headline. The whole tile is the link, named by its label; route it through\n * `renderLink` or the provider's link component, as any StatTile. Without `href` (0.43) it\n * is a quiet count, no link.\n */\nexport function AttentionTile({ count, href, ...tile }: AttentionTileProps) {\n  return <StatTile data-slot=\"attention-tile\" {...tile} value={count ?? null} href={href} />;\n}\n\n/** One of the app's own tiles (§2.4 decision 13: keksdose's \"Support waiting\"). */\nexport interface AdminExtraTile {\n  /** Unique among the tiles; usually the `extra` key it shows. */\n  key: string;\n  label: ReactNode;\n  /** `null` or `undefined` leaves the tile out, as for a shared one. */\n  count: number | null | undefined;\n  /** Where the work is. Left out (0.43, Kurvenschmiede): a quiet count with no link —\n   *  a number worth seeing that has no page of its own. */\n  href?: string;\n  /** A line under the count. */\n  description?: ReactNode;\n}\n\nexport interface AdminOverviewProps {\n  /** The server's answer; `undefined` while it loads (the grid shows its skeletons). */\n  attention: AdminAttention | null | undefined;\n  /**\n   * Where the shared tiles link, over {@link DEFAULT_ADMIN_ATTENTION_HREFS} — the\n   * inbox's address filtered to OPEN (§6.1) is the app's own:\n   * `{ feedback_waiting: \"/feedback?status=OPEN\" }`.\n   */\n  hrefs?: Partial<Record<AdminAttentionTile, string>>;\n  /** The app's own tiles, after the shared ones, in this order. */\n  extraTiles?: readonly AdminExtraTile[];\n  /** Passed to every tile — `renderLink` for the router, `size`, `variant`. */\n  tileProps?: Pick<StatTileProps, \"renderLink\" | \"size\" | \"variant\" | \"locale\">;\n  /**\n   * 0.43 (keksdose): the answer failed — the query's `error`, or `true`. Anything truthy\n   * shows `adminArea.overviewError` in a danger box, with \"Try again\" when\n   * {@link onRetry} is given. A failed poll keeps the last good tiles: with `attention`\n   * still there (a query keeps its last data), the box shows ALONGSIDE them, above, not\n   * instead (build review 0.43, keksdose N7) — pass `attention.data` as it is. Without\n   * an answer yet, the box alone. Without `error`: `undefined` is the skeletons and\n   * `null` nothing, as before.\n   */\n  error?: unknown;\n  /** \"Try again\" in the error box — the query's `refetch`. */\n  onRetry?: () => void;\n  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n  className?: string;\n}\n\n/**\n * The overview section (§2.4): the shared tiles in their order — To triage, Deletion\n * requests, Pending invitations, Users (with the new accounts of the last 7 days under\n * the total) — then the app's `extraTiles`. A tile whose count is `null` is left out,\n * so each app shows only what it has; a `0` is a quiet tile, \"nothing waiting\".\n *\n * The overview is the admin area's landing page, standalone: it is NOT wrapped in a\n * `SettingsSection` (`adminSections` gives it no entry; render it as the page's body, as\n * Kurvenschmiede's `OverviewPanel` does). keksdose links its metrics from here with at\n * most two tiles (§6.5).\n */\nexport function AdminOverview({\n  attention,\n  hrefs,\n  extraTiles = [],\n  tileProps,\n  error,\n  onRetry,\n  labels: labelsProp,\n  className,\n}: AdminOverviewProps) {\n  const labels = useAdminAreaLabels(labelsProp);\n  /** The error box: on its own (`alone`) it is the overview's root. */\n  const errorBox = (alone: boolean) => (\n    <AlertBanner\n      data-slot={alone ? \"admin-overview\" : undefined}\n      data-state={alone ? \"error\" : undefined}\n      variant=\"box\"\n      tone=\"danger\"\n      className={alone ? className : undefined}\n      action={\n        onRetry ? (\n          <Button type=\"button\" variant=\"secondary\" size=\"sm\" onClick={() => onRetry()}>\n            {labels.retry}\n          </Button>\n        ) : undefined\n      }\n    >\n      {labels.overviewError}\n    </AlertBanner>\n  );\n  // Nothing good to keep: the box alone.\n  if (error && !attention) return errorBox(true);\n  const href = { ...DEFAULT_ADMIN_ATTENTION_HREFS, ...hrefs };\n  const loading = attention === undefined;\n  const shared: { key: AdminAttentionTile; label: string; description?: ReactNode }[] = [\n    { key: \"feedback_waiting\", label: labels.tiles.feedbackWaiting },\n    { key: \"deletion_requests\", label: labels.tiles.deletionRequests },\n    { key: \"invitations_pending\", label: labels.tiles.invitationsPending },\n    {\n      key: \"users_total\",\n      label: labels.tiles.users,\n      description:\n        attention && typeof attention.users_new_7d === \"number\" ? labels.tiles.usersNew(attention.users_new_7d) : undefined,\n    },\n  ];\n  const tiles = [\n    ...shared.map((t) => ({ ...t, count: attention ? attention[t.key] : undefined, href: href[t.key] })),\n    ...extraTiles,\n  ].filter((t) => loading || (t.count !== null && t.count !== undefined));\n  if (!loading && tiles.length === 0) return error ? errorBox(true) : null;\n  const grid = (\n    <StatTileGrid data-slot={error ? undefined : \"admin-overview\"} loading={loading} className={error ? undefined : className}>\n      {tiles.map((t) => (\n        <AttentionTile\n          key={t.key}\n          {...tileProps}\n          data-attention={t.key}\n          label={t.label}\n          count={t.count}\n          href={t.href}\n          description={t.description}\n        />\n      ))}\n    </StatTileGrid>\n  );\n  if (!error) return grid;\n  // A failed poll: the error above the last good tiles.\n  return (\n    <div data-slot=\"admin-overview\" data-state=\"error\" className={cn(\"space-y-4\", className)}>\n      {errorBox(false)}\n      {grid}\n    </div>\n  );\n}\n"],"mappings":";AAqFS,cA8HL,YA9HK;AApFT,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,UAAU,oBAAoB;AAGvC,SAAS,UAAU;AACnB,SAAS,0BAA0B;AAkC5B,MAAM,gCAA8E,OAAO,OAAO;AAAA,EACvG,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,qBAAqB;AAAA,EACrB,aAAa;AACf,CAAC;AAUM,SAAS,kBACd,WACA,QACe;AACf,MAAI,CAAC,UAAW,QAAO;AACvB,MAAI,MAAM;AACV,aAAW,OAAO,QAAQ;AACxB,UAAM,SAAU,UAAiD,GAAG;AACpE,UAAM,QAAQ,OAAO,WAAW,WAAW,SAAS,UAAU,QAAQ,GAAG;AACzE,QAAI,OAAO,UAAU,YAAY,QAAQ,EAAG,QAAO;AAAA,EACrD;AACA,SAAO;AACT;AAgBO,SAAS,cAAc,EAAE,OAAO,MAAM,GAAG,KAAK,GAAuB;AAC1E,SAAO,oBAAC,YAAS,aAAU,kBAAkB,GAAG,MAAM,OAAO,SAAS,MAAM,MAAY;AAC1F;AAyDO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,aAAa,CAAC;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAAuB;AACrB,QAAM,SAAS,mBAAmB,UAAU;AAE5C,QAAM,WAAW,CAAC,UAChB;AAAA,IAAC;AAAA;AAAA,MACC,aAAW,QAAQ,mBAAmB;AAAA,MACtC,cAAY,QAAQ,UAAU;AAAA,MAC9B,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,WAAW,QAAQ,YAAY;AAAA,MAC/B,QACE,UACE,oBAAC,UAAO,MAAK,UAAS,SAAQ,aAAY,MAAK,MAAK,SAAS,MAAM,QAAQ,GACxE,iBAAO,OACV,IACE;AAAA,MAGL,iBAAO;AAAA;AAAA,EACV;AAGF,MAAI,SAAS,CAAC,UAAW,QAAO,SAAS,IAAI;AAC7C,QAAM,OAAO,EAAE,GAAG,+BAA+B,GAAG,MAAM;AAC1D,QAAM,UAAU,cAAc;AAC9B,QAAM,SAAgF;AAAA,IACpF,EAAE,KAAK,oBAAoB,OAAO,OAAO,MAAM,gBAAgB;AAAA,IAC/D,EAAE,KAAK,qBAAqB,OAAO,OAAO,MAAM,iBAAiB;AAAA,IACjE,EAAE,KAAK,uBAAuB,OAAO,OAAO,MAAM,mBAAmB;AAAA,IACrE;AAAA,MACE,KAAK;AAAA,MACL,OAAO,OAAO,MAAM;AAAA,MACpB,aACE,aAAa,OAAO,UAAU,iBAAiB,WAAW,OAAO,MAAM,SAAS,UAAU,YAAY,IAAI;AAAA,IAC9G;AAAA,EACF;AACA,QAAM,QAAQ;AAAA,IACZ,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,YAAY,UAAU,EAAE,GAAG,IAAI,QAAW,MAAM,KAAK,EAAE,GAAG,EAAE,EAAE;AAAA,IACnG,GAAG;AAAA,EACL,EAAE,OAAO,CAAC,MAAM,WAAY,EAAE,UAAU,QAAQ,EAAE,UAAU,MAAU;AACtE,MAAI,CAAC,WAAW,MAAM,WAAW,EAAG,QAAO,QAAQ,SAAS,IAAI,IAAI;AACpE,QAAM,OACJ,oBAAC,gBAAa,aAAW,QAAQ,SAAY,kBAAkB,SAAkB,WAAW,QAAQ,SAAY,WAC7G,gBAAM,IAAI,CAAC,MACV;AAAA,IAAC;AAAA;AAAA,MAEE,GAAG;AAAA,MACJ,kBAAgB,EAAE;AAAA,MAClB,OAAO,EAAE;AAAA,MACT,OAAO,EAAE;AAAA,MACT,MAAM,EAAE;AAAA,MACR,aAAa,EAAE;AAAA;AAAA,IANV,EAAE;AAAA,EAOT,CACD,GACH;AAEF,MAAI,CAAC,MAAO,QAAO;AAEnB,SACE,qBAAC,SAAI,aAAU,kBAAiB,cAAW,SAAQ,WAAW,GAAG,aAAa,SAAS,GACpF;AAAA,aAAS,KAAK;AAAA,IACd;AAAA,KACH;AAEJ;","names":[]}

package/dist/admin/admin-sections.d.ts

@@ -0,0 +1,94 @@
+import type { LucideIcon } from "lucide-react";
+import type { SettingsGroup } from "../settings/settings-catalogue.js";
+import type { AdminAreaLabels, AdminSharedSection } from "./admin-area-labels.js";
+/**
+ * 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 declare const ADMIN_SECTIONS: readonly AdminSectionDefinition[];
+/**
+ * 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>>;
+}
+/** 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 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 declare function adminSectionOrder<G extends string = never, L extends AdminSharedSection = AdminSharedSection>(own?: readonly AdminSectionPlace<G>[], options?: AdminSectionOrderOptions<L>): (AdminKeptSection<L> | G)[];
+/**
+ * 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 declare function adminSections<G extends string = never, L extends AdminSharedSection = AdminSharedSection>(labels: AdminAreaLabels | undefined, own?: readonly AdminOwnSection<G>[], options?: AdminSectionsOptions<L>): SettingsGroup<AdminKeptSection<L> | G>[];