@eifi1/ui-kit 0.40.1 → 0.42.0

package/README.md

@@ -556,16 +556,16 @@ 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.
+**2042 names from 335 modules** — 942 values and 1100 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` | 2042 |
 | `@eifi1/ui-kit/chart` | 92 |
-| `@eifi1/ui-kit/shell` | 80 |
+| `@eifi1/ui-kit/shell` | 108 |
 | `@eifi1/ui-kit/data-table` | 51 |
 | `@eifi1/ui-kit/wizard` | 24 |
 | `@eifi1/ui-kit/tour` | 7 |
@@ -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`, _`AdminMenuEntryOptions`_, _`AdminMenuRowProps`_ |
+| `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
@@ -943,6 +950,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`, `adminSections`, _`AdminOwnSection`_, _`AdminSectionDefinition`_, _`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 +963,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 +974,10 @@ 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`_ |
 
 ### notifications
 

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

@@ -0,0 +1,55 @@
+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;
+    /** 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,33 @@
+"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: "The links that let a new person in." },
+    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`
+  },
+  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  /** 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: \"The links that let a new person in.\" },\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  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;AAsD1C,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,sCAAsC;AAAA,IACjF,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,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,93 @@
+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. */
+    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.
+ */
+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;
+    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">;
+    /** 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".
+ *
+ * Put it in the `overview` section's `SettingsSection` (titled by the sidebar, so
+ * `titleVisible={false}`). keksdose links its metrics from here with at most two tiles
+ * (§6.5).
+ */
+export declare function AdminOverview({ attention, hrefs, extraTiles, tileProps, labels: labelsProp, className, }: AdminOverviewProps): import("react").JSX.Element | null;

package/dist/admin/admin-overview.js

@@ -0,0 +1,69 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { StatTile, StatTileGrid } from "../components/stat-tile.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,
+  labels: labelsProp,
+  className
+}) {
+  const labels = useAdminAreaLabels(labelsProp);
+  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 null;
+  return /* @__PURE__ */ jsx(StatTileGrid, { "data-slot": "admin-overview", loading, 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
+  )) });
+}
+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 { StatTile, StatTileGrid } from \"../components/stat-tile\";\nimport type { StatTileProps } from \"../components/stat-tile\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\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. */\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.\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  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  /** 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 * Put it in the `overview` section's `SettingsSection` (titled by the sidebar, so\n * `titleVisible={false}`). keksdose links its metrics from here with at most two tiles\n * (§6.5).\n */\nexport function AdminOverview({\n  attention,\n  hrefs,\n  extraTiles = [],\n  tileProps,\n  labels: labelsProp,\n  className,\n}: AdminOverviewProps) {\n  const labels = useAdminAreaLabels(labelsProp);\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 null;\n  return (\n    <StatTileGrid data-slot=\"admin-overview\" loading={loading} className={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}\n"],"mappings":";AAgFS;AA/ET,SAAS,UAAU,oBAAoB;AAGvC,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;AAcO,SAAS,cAAc,EAAE,OAAO,MAAM,GAAG,KAAK,GAAuB;AAC1E,SAAO,oBAAC,YAAS,aAAU,kBAAkB,GAAG,MAAM,OAAO,SAAS,MAAM,MAAY;AAC1F;AA0CO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,aAAa,CAAC;AAAA,EACd;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAAuB;AACrB,QAAM,SAAS,mBAAmB,UAAU;AAC5C,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;AAC3C,SACE,oBAAC,gBAAa,aAAU,kBAAiB,SAAkB,WACxD,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;AAEJ;","names":[]}

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

@@ -0,0 +1,63 @@
+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;
+}
+export interface AdminSectionsOptions {
+    /**
+     * Shared sections this app does not have — keksdose and Kurvenschmiede have no billing
+     * view (`["billing"]`). Left out, every shared section is in the catalogue.
+     */
+    leaveOut?: readonly AdminSharedSection[];
+    /**
+     * 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>>;
+}
+/**
+ * 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).
+ *
+ *     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>(labels: AdminAreaLabels | undefined, own?: readonly AdminOwnSection<G>[], options?: AdminSectionsOptions): SettingsGroup<AdminSharedSection | G>[];

package/dist/admin/admin-sections.js

@@ -0,0 +1,64 @@
+"use client";
+import { createElement } from "react";
+import { History, LayoutDashboard, Mail, Receipt, Users } from "lucide-react";
+import { DEFAULT_ADMIN_AREA_LABELS } from "./admin-area-labels.js";
+const ADMIN_SECTIONS = Object.freeze([
+  { id: "overview", icon: LayoutDashboard },
+  { id: "users", icon: Users },
+  { id: "invitations", icon: Mail },
+  { id: "billing", icon: Receipt },
+  { id: "activity", icon: History }
+]);
+const OWN_DEFAULT_AFTER = "invitations";
+function adminSections(labels, own = [], options = {}) {
+  const words = labels ?? DEFAULT_ADMIN_AREA_LABELS;
+  const leaveOut = new Set(options.leaveOut ?? []);
+  const shared = new Set(ADMIN_SECTIONS.map((s) => s.id));
+  const ownIds = /* @__PURE__ */ new Set();
+  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 !== void 0 && !shared.has(after) && !ownIds.has(after)) {
+      throw new Error(`adminSections: "${section.id}" goes after "${after}", which is no section`);
+    }
+  }
+  const followers = /* @__PURE__ */ new Map();
+  for (const section of own) {
+    const after = section.after ?? OWN_DEFAULT_AFTER;
+    followers.set(after, [...followers.get(after) ?? [], section]);
+  }
+  const out = [];
+  const placeAfter = (id) => {
+    for (const section of followers.get(id) ?? []) {
+      const { after: _after, ...group } = section;
+      out.push(group);
+      placeAfter(section.id);
+    }
+  };
+  for (const { id, icon } of ADMIN_SECTIONS) {
+    if (!leaveOut.has(id)) {
+      const visible = options.visible?.[id];
+      out.push({
+        id,
+        icon: createElement(icon, { "aria-hidden": true }),
+        title: words.sections[id].title,
+        help: words.sections[id].help,
+        ...visible === void 0 ? null : { visible }
+      });
+    }
+    placeAfter(id);
+  }
+  const placed = new Set(out.map((g) => g.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;
+}
+export {
+  ADMIN_SECTIONS,
+  adminSections
+};
+//# sourceMappingURL=admin-sections.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/admin-sections.tsx"],"sourcesContent":["import { createElement } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { History, LayoutDashboard, Mail, Receipt, Users } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\nimport type { SettingsGroup } from \"../settings/settings-catalogue\";\nimport { DEFAULT_ADMIN_AREA_LABELS } from \"./admin-area-labels\";\nimport type { AdminAreaLabels, AdminSharedSection } from \"./admin-area-labels\";\n\n/**\n * The admin area's sections (0.42.0, docs/admin-harmonization.md §2.3, §6.8): the five\n * every app shares, in the template's order, and the helper that builds an app's\n * `SettingsLayout` catalogue groups from them and the app's own.\n */\n\n/** One shared section: its path segment and its icon. The words are `adminArea.sections`. */\nexport interface AdminSectionDefinition {\n  id: AdminSharedSection;\n  icon: LucideIcon;\n}\n\n/**\n * The shared sections in the template's order (§2.3 decision 10, §6.13): Overview, Users,\n * Invitations, Billing, Activity. An app's own sections go between them\n * ({@link adminSections}).\n */\nexport const ADMIN_SECTIONS: readonly AdminSectionDefinition[] = Object.freeze([\n  { id: \"overview\", icon: LayoutDashboard },\n  { id: \"users\", icon: Users },\n  { id: \"invitations\", icon: Mail },\n  { id: \"billing\", icon: Receipt },\n  { id: \"activity\", icon: History },\n]);\n\n/**\n * One of the app's own sections: a catalogue group with its words, plus where it goes.\n * `after` names the section it follows — a shared one or another of the app's own. Left\n * out, it goes where the template puts an app's sections, after Invitations and before\n * Billing, in the order given.\n */\nexport interface AdminOwnSection<G extends string = string> extends SettingsGroup<G> {\n  after?: AdminSharedSection | G;\n}\n\nexport interface AdminSectionsOptions {\n  /**\n   * Shared sections this app does not have — keksdose and Kurvenschmiede have no billing\n   * view (`[\"billing\"]`). Left out, every shared section is in the catalogue.\n   */\n  leaveOut?: readonly AdminSharedSection[];\n  /**\n   * A shared section that is in the catalogue but hidden for now, as\n   * {@link SettingsGroup.visible}: kastlan's `{ billing: billingEnabled }` (settings §5),\n   * whose path then acts as an unknown one.\n   */\n  visible?: Partial<Record<AdminSharedSection, boolean>>;\n}\n\n/** The shared section after which the app's sections go when they name no place. */\nconst OWN_DEFAULT_AFTER: AdminSharedSection = \"invitations\";\n\n/**\n * An app's admin catalogue groups, in the template's order (§2.3 decision 10, §6.8): the\n * shared sections with the kit's icons and words, and the app's own at the places they\n * name. The result is `SettingsLayout`'s `groups`; the entries stay the app's (a group\n * with no visible entry is hidden, as on any settings page).\n *\n *     const groups = adminSections(useAdminAreaLabels(), [\n *       { id: \"metrics\", icon: <BarChart3 />, title: t(\"…\"), help: t(\"…\"), after: \"overview\" },\n *       { id: \"messaging\", icon: <MessageSquare />, title: t(\"…\"), help: t(\"…\") },\n *       { id: \"health\", icon: <HeartPulse />, title: t(\"…\"), help: t(\"…\"), after: \"billing\" },\n *     ], { leaveOut: [\"billing\"] });\n *\n * gives keksdose's overview, metrics, users, invitations, messaging, health, activity.\n * An `after` that names a left-out section takes that section's place. Kurvenschmiede's\n * Teams needs no `after`: between Invitations and Activity is the default.\n *\n * `labels` is the `adminArea` namespace, resolved — {@link useAdminAreaLabels} inside a\n * component, or the app's catalogue for the language; `undefined` is English. Throws for\n * an own section whose id is a shared one, an id given twice, or an `after` that names no\n * section: the catalogue is built once, and a section quietly missing from it is worse.\n */\nexport function adminSections<G extends string = never>(\n  labels: AdminAreaLabels | undefined,\n  own: readonly AdminOwnSection<G>[] = [],\n  options: AdminSectionsOptions = {},\n): SettingsGroup<AdminSharedSection | G>[] {\n  const words = labels ?? DEFAULT_ADMIN_AREA_LABELS;\n  const leaveOut = new Set<string>(options.leaveOut ?? []);\n  const shared = new Set<string>(ADMIN_SECTIONS.map((s) => s.id));\n  const ownIds = new Set<string>();\n  for (const section of own) {\n    if (shared.has(section.id)) throw new Error(`adminSections: \"${section.id}\" is a shared section's id`);\n    if (ownIds.has(section.id)) throw new Error(`adminSections: \"${section.id}\" is given twice`);\n    ownIds.add(section.id);\n  }\n  for (const section of own) {\n    const after = section.after;\n    if (after !== undefined && !shared.has(after) && !ownIds.has(after)) {\n      throw new Error(`adminSections: \"${section.id}\" goes after \"${after}\", which is no section`);\n    }\n  }\n\n  // Each section's followers, in the order given: the shared ones, then the own ones\n  // under their `after`, recursively, so an own section may follow another own one.\n  const followers = new Map<string, AdminOwnSection<G>[]>();\n  for (const section of own) {\n    const after = section.after ?? OWN_DEFAULT_AFTER;\n    followers.set(after, [...(followers.get(after) ?? []), section]);\n  }\n\n  const out: SettingsGroup<AdminSharedSection | G>[] = [];\n  const placeAfter = (id: string) => {\n    for (const section of followers.get(id) ?? []) {\n      const { after: _after, ...group } = section;\n      out.push(group);\n      placeAfter(section.id);\n    }\n  };\n  for (const { id, icon } of ADMIN_SECTIONS) {\n    if (!leaveOut.has(id)) {\n      const visible = options.visible?.[id];\n      out.push({\n        id,\n        icon: createElement(icon, { \"aria-hidden\": true }) as ReactNode,\n        title: words.sections[id].title,\n        help: words.sections[id].help,\n        ...(visible === undefined ? null : { visible }),\n      });\n    }\n    // A left-out section's followers keep its place.\n    placeAfter(id);\n  }\n  const placed = new Set<string>(out.map((g) => g.id));\n  const stuck = own.filter((s) => !placed.has(s.id)).map((s) => s.id);\n  if (stuck.length) throw new Error(`adminSections: ${stuck.join(\", \")} follow each other in a circle`);\n  return out;\n}\n"],"mappings":";AAAA,SAAS,qBAAqB;AAE9B,SAAS,SAAS,iBAAiB,MAAM,SAAS,aAAa;AAG/D,SAAS,iCAAiC;AAoBnC,MAAM,iBAAoD,OAAO,OAAO;AAAA,EAC7E,EAAE,IAAI,YAAY,MAAM,gBAAgB;AAAA,EACxC,EAAE,IAAI,SAAS,MAAM,MAAM;AAAA,EAC3B,EAAE,IAAI,eAAe,MAAM,KAAK;AAAA,EAChC,EAAE,IAAI,WAAW,MAAM,QAAQ;AAAA,EAC/B,EAAE,IAAI,YAAY,MAAM,QAAQ;AAClC,CAAC;AA2BD,MAAM,oBAAwC;AAuBvC,SAAS,cACd,QACA,MAAqC,CAAC,GACtC,UAAgC,CAAC,GACQ;AACzC,QAAM,QAAQ,UAAU;AACxB,QAAM,WAAW,IAAI,IAAY,QAAQ,YAAY,CAAC,CAAC;AACvD,QAAM,SAAS,IAAI,IAAY,eAAe,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;AAC9D,QAAM,SAAS,oBAAI,IAAY;AAC/B,aAAW,WAAW,KAAK;AACzB,QAAI,OAAO,IAAI,QAAQ,EAAE,EAAG,OAAM,IAAI,MAAM,mBAAmB,QAAQ,EAAE,4BAA4B;AACrG,QAAI,OAAO,IAAI,QAAQ,EAAE,EAAG,OAAM,IAAI,MAAM,mBAAmB,QAAQ,EAAE,kBAAkB;AAC3F,WAAO,IAAI,QAAQ,EAAE;AAAA,EACvB;AACA,aAAW,WAAW,KAAK;AACzB,UAAM,QAAQ,QAAQ;AACtB,QAAI,UAAU,UAAa,CAAC,OAAO,IAAI,KAAK,KAAK,CAAC,OAAO,IAAI,KAAK,GAAG;AACnE,YAAM,IAAI,MAAM,mBAAmB,QAAQ,EAAE,iBAAiB,KAAK,wBAAwB;AAAA,IAC7F;AAAA,EACF;AAIA,QAAM,YAAY,oBAAI,IAAkC;AACxD,aAAW,WAAW,KAAK;AACzB,UAAM,QAAQ,QAAQ,SAAS;AAC/B,cAAU,IAAI,OAAO,CAAC,GAAI,UAAU,IAAI,KAAK,KAAK,CAAC,GAAI,OAAO,CAAC;AAAA,EACjE;AAEA,QAAM,MAA+C,CAAC;AACtD,QAAM,aAAa,CAAC,OAAe;AACjC,eAAW,WAAW,UAAU,IAAI,EAAE,KAAK,CAAC,GAAG;AAC7C,YAAM,EAAE,OAAO,QAAQ,GAAG,MAAM,IAAI;AACpC,UAAI,KAAK,KAAK;AACd,iBAAW,QAAQ,EAAE;AAAA,IACvB;AAAA,EACF;AACA,aAAW,EAAE,IAAI,KAAK,KAAK,gBAAgB;AACzC,QAAI,CAAC,SAAS,IAAI,EAAE,GAAG;AACrB,YAAM,UAAU,QAAQ,UAAU,EAAE;AACpC,UAAI,KAAK;AAAA,QACP;AAAA,QACA,MAAM,cAAc,MAAM,EAAE,eAAe,KAAK,CAAC;AAAA,QACjD,OAAO,MAAM,SAAS,EAAE,EAAE;AAAA,QAC1B,MAAM,MAAM,SAAS,EAAE,EAAE;AAAA,QACzB,GAAI,YAAY,SAAY,OAAO,EAAE,QAAQ;AAAA,MAC/C,CAAC;AAAA,IACH;AAEA,eAAW,EAAE;AAAA,EACf;AACA,QAAM,SAAS,IAAI,IAAY,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;AACnD,QAAM,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE;AAClE,MAAI,MAAM,OAAQ,OAAM,IAAI,MAAM,kBAAkB,MAAM,KAAK,IAAI,CAAC,gCAAgC;AACpG,SAAO;AACT;","names":[]}