@eifi1/ui-kit 0.28.1 → 0.30.0

package/dist/admin/user-roster.d.ts

@@ -0,0 +1,91 @@
+import 'react';
+import 'lucide-react';
+import '../lib/format.js';
+import '../lib/person-name.js';
+import '../components/account-chips.js';
+import '../components/chip.js';
+import '../data-table-labels-DUELeXpa.js';
+import '../components/data-table-sort.js';
+export { bz as AdminUserStateFields, cJ as DEFAULT_USER_ROSTER_LABELS, et as RoleEditing, eB as RosterState, f8 as USER_ROSTER_SORT_KEYS, ff as UserIdentityCell, fg as UserIdentityCellProps, fh as UserRosterColumnsOptions, fi as UserRosterLabels, fj as UserRosterRow, fk as UserRosterSortKey, fl as UserRowAction, fm as UserRowActionList, fn as UserRowActions, fo as UserRowActionsProps, fp as adminUserStates, fO as useUserRosterColumns, fP as userRosterColumns, fQ as userRosterSort } from '../delete-account-setting-CGVMckMw.js';
+import '../components/swipeable-row.js';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../components/field-sync.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../components/user-avatar.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../shell/topbar-action-menu.js';
+import '../components/menu-item.js';
+import '../components/floating-panel.js';
+import '../hooks/use-authed-src.js';
+import '../components/account-settings-labels.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/error-boundary.js';
+import '../components/authed-image.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+import '../components/write-lock.js';
+import '../auth/sign-in-form.js';
+import '../shell/topbar-controls.js';
+import '../theme/palette-presets.js';
+import '../theme/chart-palette.js';
+import '../theme/theme-store.js';
+import 'zustand/middleware';
+import 'zustand';
+import '../auth/complete-name-dialog.js';
+import '../auth/forgot-password-form.js';
+import '../auth/status-parts.js';
+import '../auth/reset-password-form.js';
+import '../auth/verify-email.js';
+import '../auth/not-found-page.js';
+import '../auth/accept-invitation.js';
+import '../shell/company-switcher.js';
+import '../account/email-change-setting.js';
+import '../account/sessions-setting.js';
+import '../account/data-export-setting.js';
+import './admin-parts.js';
+import './admin-action-log.js';
+import '../components/reauth-dialog.js';
+import '../components/server-wake.js';
+import '../lib/server-wake.js';
+import '../components/translation-review-labels.js';
+import '../lib/translation-review.js';
+import '../components/country-select.js';
+import '../components/inline-edit-field.js';
+import '../lib/iban.js';
+import '../lib/phone.js';
+import '../components/sign-chip.js';
+import '../components/column-mapper.js';
+import '../lib/column-mapping.js';
+import '../lib/table-text.js';
+import '../components/field-parts.js';

package/dist/admin/user-roster.js

@@ -0,0 +1,285 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { MoreHorizontal } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { useKitLabels, useKitLocale } from "../i18n/kit-labels.js";
+import { AccountStateChip, RoleChip, dateColumn } from "../components/account-chips.js";
+import { encodeSorts } from "../components/data-table-sort.js";
+import { Popover } from "../components/popover.js";
+import { Button, IconButton } from "../components/ui.js";
+import { UserAvatar } from "../components/user-avatar.js";
+import { personLabel } from "./admin-parts.js";
+import { RoleSelect } from "./role-select.js";
+function adminUserStates(row) {
+  const out = [];
+  if (row.deletion_scheduled_at || row.deletion_requested_at) {
+    out.push({ state: "deletion", date: row.deletion_scheduled_at ?? null });
+  } else if (row.is_active !== void 0) {
+    out.push(row.is_active ? "active" : "inactive");
+  }
+  if (row.email_verified === false) out.push("unverified");
+  if (row.password_change_required_at) out.push("passwordChange");
+  return out;
+}
+const USER_ROSTER_SORT_KEYS = ["name", "email", "role", "created", "last_login"];
+function userRosterSort(sorts) {
+  const first = sorts.find((s) => USER_ROSTER_SORT_KEYS.includes(s.key));
+  return first ? encodeSorts([first]) ?? void 0 : void 0;
+}
+const DEFAULT_USER_ROSTER_LABELS = {
+  name: "Name",
+  email: "Email",
+  role: "Role",
+  state: "State",
+  created: "Created",
+  lastLogin: "Last login",
+  never: "Never",
+  actions: "Actions",
+  actionsFor: (name) => `Actions for ${name}`
+};
+function UserIdentityCell({
+  person,
+  name,
+  email,
+  avatar = true,
+  badge,
+  locale: localeProp,
+  className
+}) {
+  const locale = useKitLocale(localeProp);
+  const named = personLabel({ first: person?.first, last: person?.last, name }, locale);
+  const address = (email ?? "").trim();
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex min-w-0 items-center gap-2.5", className), children: [
+    avatar && /* @__PURE__ */ jsx(UserAvatar, { person, name, email, size: "sm" }),
+    /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-center gap-1.5", children: [
+        /* @__PURE__ */ jsx("span", { "data-private": true, className: "truncate font-medium text-[var(--text-primary)]", children: named || address }),
+        badge
+      ] }),
+      named && address && /* @__PURE__ */ jsx("div", { "data-private": true, className: "truncate text-xs text-[var(--text-muted)]", children: address })
+    ] })
+  ] });
+}
+function UserRowActions({ actions, name, labels: labelsProp }) {
+  const labels = useKitLabels("userRoster", DEFAULT_USER_ROSTER_LABELS, labelsProp);
+  const entries = actions.filter((a) => Boolean(a) && !a.hidden);
+  if (entries.length === 0) return null;
+  const title = labels.actionsFor(name);
+  return /* @__PURE__ */ jsx(
+    Popover,
+    {
+      width: 240,
+      "aria-label": title,
+      className: "p-1",
+      trigger: ({ open, toggle, ref }) => /* @__PURE__ */ jsx(
+        IconButton,
+        {
+          ref,
+          size: "xs",
+          label: title,
+          "aria-haspopup": "dialog",
+          "aria-expanded": open,
+          stopPropagation: true,
+          onClick: toggle,
+          children: /* @__PURE__ */ jsx(MoreHorizontal, {})
+        }
+      ),
+      children: (close) => /* @__PURE__ */ jsx("ul", { className: "space-y-0.5", children: entries.map((action) => {
+        const Icon = action.icon;
+        return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            variant: "ghost",
+            size: "sm",
+            stretch: true,
+            tone: action.tone === "danger" ? "danger" : void 0,
+            disabledReason: action.disabledReason,
+            className: "justify-start",
+            onClick: () => {
+              close();
+              action.onSelect();
+            },
+            children: [
+              Icon && /* @__PURE__ */ jsx(Icon, { className: "size-4 shrink-0", "aria-hidden": true }),
+              action.label
+            ]
+          }
+        ) }, action.key ?? action.label);
+      }) })
+    }
+  );
+}
+function rolesOf(row, roleOf) {
+  const raw = roleOf ? roleOf(row) : row.roles ?? row.role;
+  if (raw === null || raw === void 0 || raw === "") return [];
+  return typeof raw === "string" ? [raw] : [...raw];
+}
+function RowName({ row, children }) {
+  const locale = useKitLocale();
+  const name = personLabel(
+    { first: row.first_name, last: row.last_name, name: row.display_name, email: row.email },
+    locale
+  );
+  return /* @__PURE__ */ jsx(Fragment, { children: children(name) });
+}
+function StateChips({ states }) {
+  if (states.length === 0) return null;
+  return /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: states.map((entry) => {
+    const spec = typeof entry === "string" ? { state: entry } : entry;
+    return /* @__PURE__ */ jsx(AccountStateChip, { state: spec.state, date: spec.date, tone: spec.tone, size: "xs", children: spec.label }, spec.state);
+  }) });
+}
+function userRosterColumns({
+  roles,
+  stateOf = adminUserStates,
+  extra = [],
+  actions,
+  editableRole,
+  onRoleChange,
+  roleOf,
+  emailColumn = false,
+  labels: labelsProp
+}) {
+  const labels = { ...DEFAULT_USER_ROSTER_LABELS, ...labelsProp };
+  const roleWords = (row) => rolesOf(row, roleOf).map((role) => roles[role]?.label ?? role).join(", ");
+  const columns = [
+    {
+      key: "name",
+      header: labels.name,
+      cell: (row) => /* @__PURE__ */ jsx(
+        UserIdentityCell,
+        {
+          person: { first: row.first_name, last: row.last_name },
+          name: row.display_name,
+          email: row.email
+        }
+      ),
+      // By last name, then first (auth §3.2), as the server sorts `name`.
+      sortBy: (row) => `${row.last_name ?? ""} ${row.first_name ?? ""}`.trim().toLocaleLowerCase() || row.email,
+      // Either part, in either order, or the address (auth §10.6).
+      filterBy: (row) => [row.first_name, row.last_name, row.last_name, row.first_name, row.display_name, row.email].filter(Boolean).join(" "),
+      mobilePrimary: true
+    }
+  ];
+  if (emailColumn) {
+    columns.push({
+      key: "email",
+      header: labels.email,
+      className: "whitespace-nowrap",
+      cell: (row) => /* @__PURE__ */ jsx("span", { "data-private": true, className: "text-[var(--text-secondary)]", children: row.email }),
+      sortBy: (row) => row.email.toLowerCase(),
+      filterBy: (row) => row.email,
+      mobileHidden: true
+    });
+  }
+  columns.push(
+    {
+      key: "role",
+      header: labels.role,
+      cell: (row) => {
+        const held = rolesOf(row, roleOf);
+        const editing = held.length <= 1 ? editableRole?.(row) : false;
+        if (editing && onRoleChange) {
+          const rules = editing === true ? {} : editing;
+          return /* @__PURE__ */ jsx(RowName, { row, children: (name) => /* @__PURE__ */ jsx(
+            RoleSelect,
+            {
+              size: "sm",
+              name,
+              value: held[0] ?? null,
+              roles,
+              offered: rules.offered,
+              disabledReason: rules.disabledReason,
+              optionDisabledReason: rules.optionDisabledReason,
+              onChange: (role) => onRoleChange(row, role)
+            }
+          ) });
+        }
+        if (held.length === 0) return null;
+        return /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: held.map((role) => /* @__PURE__ */ jsx(RoleChip, { value: role, roles, size: "xs" }, role)) });
+      },
+      sortBy: roleWords,
+      filter: {
+        type: "select",
+        getValue: (row) => rolesOf(row, roleOf)[0] ?? "",
+        options: Object.keys(roles).map((value) => ({ value, label: roles[value].label }))
+      }
+    },
+    {
+      key: "state",
+      header: labels.state,
+      cell: (row) => /* @__PURE__ */ jsx(StateChips, { states: stateOf(row) })
+    },
+    dateColumn({
+      key: "created",
+      header: labels.created,
+      value: (row) => row.created_at ?? null,
+      column: { mobileHidden: true }
+    }),
+    // How long ago rather than a date — the question is "recently?" — with the exact
+    // time in a tooltip (keksdose's last-seen column, Kurvenschmiede's).
+    dateColumn({
+      key: "last_login",
+      header: labels.lastLogin,
+      value: (row) => row.last_login_at ?? null,
+      display: "relative",
+      empty: labels.never
+    }),
+    ...extra
+  );
+  if (actions) {
+    columns.push({
+      key: "actions",
+      header: /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.actions }),
+      headerText: labels.actions,
+      // The caller's own words only: the menu reads the provider's itself, and the
+      // English defaults merged in above must not shadow them.
+      cell: (row) => /* @__PURE__ */ jsx(RowName, { row, children: (name) => /* @__PURE__ */ jsx(UserRowActions, { actions: actions(row), name, labels: labelsProp }) }),
+      className: "w-px whitespace-nowrap text-end",
+      headClassName: "w-px",
+      // The menu button keeps its own click: a row link must not wrap it.
+      noRowLink: true
+    });
+  }
+  return columns;
+}
+function useUserRosterColumns({
+  roles,
+  stateOf,
+  extra,
+  actions,
+  editableRole,
+  onRoleChange,
+  roleOf,
+  emailColumn,
+  labels: labelsProp
+}) {
+  const labels = useKitLabels("userRoster", DEFAULT_USER_ROSTER_LABELS, labelsProp);
+  return useMemo(
+    () => userRosterColumns({
+      roles,
+      stateOf,
+      extra,
+      actions,
+      editableRole,
+      onRoleChange,
+      roleOf,
+      emailColumn,
+      labels
+    }),
+    [roles, stateOf, extra, actions, editableRole, onRoleChange, roleOf, emailColumn, labels]
+  );
+}
+export {
+  DEFAULT_USER_ROSTER_LABELS,
+  USER_ROSTER_SORT_KEYS,
+  UserIdentityCell,
+  UserRowActions,
+  adminUserStates,
+  useUserRosterColumns,
+  userRosterColumns,
+  userRosterSort
+};
+//# sourceMappingURL=user-roster.js.map

package/dist/admin/user-roster.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/user-roster.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { MoreHorizontal } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport type { DateInput } from \"../lib/format\";\nimport type { PersonName } from \"../lib/person-name\";\nimport { useKitLabels, useKitLocale } from \"../i18n/kit-labels\";\nimport { AccountStateChip, RoleChip, dateColumn } from \"../components/account-chips\";\nimport type { AccountState, RoleVocabulary } from \"../components/account-chips\";\nimport type { ChipTone } from \"../components/chip\";\nimport type { DataTableColumn } from \"../components/data-table\";\nimport { encodeSorts } from \"../components/data-table-sort\";\nimport type { SortState } from \"../components/data-table-sort\";\nimport { Popover } from \"../components/popover\";\nimport { Button, IconButton } from \"../components/ui\";\nimport { UserAvatar } from \"../components/user-avatar\";\nimport { personLabel } from \"./admin-parts\";\nimport { RoleSelect } from \"./role-select\";\nimport type { RoleLock } from \"./role-select\";\n\n/**\n * The admin's user list (docs/user-admin-harmonization.md §3): a column preset for the\n * kit's `DataTable`, not a table of its own.\n *\n * keksdose built its roster by hand (1150 lines, its own Badge), Kurvenschmiede on the\n * kit `DataTable` with the 0.18 chips, kastlan as a settings page. What the three share\n * is the row — name over address, a role, the account's states, created, last login, the\n * app's own columns, and a handful of actions — so that is what the kit draws, and the\n * table, its paging, its sort and its filters stay the app's `DataTable` wiring:\n *\n * ```tsx\n * const columns = useUserRosterColumns<AdminUserRow, Role>({ roles: ROLES, actions, extra });\n * <DataTable rows={page.users} columns={columns} rowKey={(r) => r.id}\n *   serverPagination={{ page, pageSize, total: page.total, onPageChange }}\n *   sorts={sorts} onSortsChange={setSorts} />\n * // GET /admin/users?sort=${userRosterSort(sorts)}&…\n * ```\n *\n * The column keys ARE the server's sort keys (§3.1): `name`, `email`, `role`, `created`,\n * `last_login` — so {@link userRosterSort} turns the table's sort state into the query\n * as it is. Phone cards come from the same columns: the identity is the card's headline,\n * the role, states, last login and the actions are its fields, created is left off.\n */\n\n/* ── Rows and states ────────────────────────────────────────────────────────── */\n\n/**\n * The fields of the contract's `AdminUserRow` the preset reads (§3.2, the auth\n * contract's `UserResponse` core). An app's row has more — its `extra` — and the\n * preset passes the whole row to every callback.\n */\nexport interface UserRosterRow extends AdminUserStateFields {\n  id: string | number;\n  email: string;\n  first_name?: string | null;\n  last_name?: string | null;\n  /** The derived whole name — only the fallback when both parts are blank. */\n  display_name?: string | null;\n  /** keksdose, Kurvenschmiede: one role. */\n  role?: string | null;\n  /** kastlan: the account's roles in the current company. Wins over `role`. */\n  roles?: readonly string[] | null;\n  created_at?: DateInput;\n  /** Account-wide; kastlan's comes from its session rows (§3.2). */\n  last_login_at?: DateInput;\n}\n\n/** The state fields of the contract's row that {@link adminUserStates} maps (§3.2). */\nexport interface AdminUserStateFields {\n  is_active?: boolean;\n  email_verified?: boolean;\n  password_change_required_at?: string | null;\n  /** `after_days` mode: the day the account is erased (§6.4). */\n  deletion_scheduled_at?: string | null;\n  /** When the user asked. The only deletion field in kastlan's `operator` mode, where\n   *  nothing is scheduled. */\n  deletion_requested_at?: string | null;\n}\n\n/** One state chip of a row: an {@link AccountState}, or one with its `date` (the\n *  `deletion` day), a `tone` or the app's own words. */\nexport type RosterState =\n  | AccountState\n  | { state: AccountState; date?: DateInput; tone?: ChipTone; label?: ReactNode };\n\n/**\n * The contract's row as state chips (§3.2: \"map 1:1 to the kit's AccountStateChip\"):\n *\n * - marked for deletion → `deletion` with the scheduled day (none in `operator` mode),\n *   IN PLACE of `inactive` — such an account is always deactivated (§2.1);\n * - else `active` / `inactive` from `is_active`;\n * - `unverified` when `email_verified` is `false` (not when it is missing);\n * - `passwordChange` while `password_change_required_at` is set.\n */\nexport function adminUserStates(row: AdminUserStateFields): RosterState[] {\n  const out: RosterState[] = [];\n  if (row.deletion_scheduled_at || row.deletion_requested_at) {\n    out.push({ state: \"deletion\", date: row.deletion_scheduled_at ?? null });\n  } else if (row.is_active !== undefined) {\n    out.push(row.is_active ? \"active\" : \"inactive\");\n  }\n  if (row.email_verified === false) out.push(\"unverified\");\n  if (row.password_change_required_at) out.push(\"passwordChange\");\n  return out;\n}\n\n/** The server's sort keys, which are the preset's column keys (§3.1). */\nexport const USER_ROSTER_SORT_KEYS = [\"name\", \"email\", \"role\", \"created\", \"last_login\"] as const;\nexport type UserRosterSortKey = (typeof USER_ROSTER_SORT_KEYS)[number];\n\n/**\n * The table's sort state as the `sort` query parameter of `GET /admin/users` (§3.1), in\n * the DataTable's own encoding ({@link encodeSorts}: `\"last_login.desc\"`), which\n * server-kit 0.4 reads beside the `-key` form. Only the first criterion on one of the\n * server's keys: an app's own column (`owned`) is the client's to sort, and the query\n * takes one key — a shift-clicked second criterion is not sent. `undefined` when nothing\n * the server knows is sorted, so its default order applies.\n */\nexport function userRosterSort(sorts: readonly SortState[]): string | undefined {\n  const first = sorts.find((s) => (USER_ROSTER_SORT_KEYS as readonly string[]).includes(s.key));\n  return first ? (encodeSorts([first]) ?? undefined) : undefined;\n}\n\n/* ── Labels ─────────────────────────────────────────────────────────────────── */\n\n/** The `userRoster` namespace: the preset's headers and the action menu's words. */\nexport interface UserRosterLabels {\n  /** The identity column — the name with the address under it. */\n  name: string;\n  /** The separate address column (`emailColumn`). */\n  email: string;\n  role: string;\n  state: string;\n  created: string;\n  lastLogin: string;\n  /** A last login that never happened. */\n  never: string;\n  /** The actions column's (hidden) header. */\n  actions: string;\n  /** The action menu's button and panel — \"Actions for Ada Example\". */\n  actionsFor: (name: string) => string;\n}\n\nexport const DEFAULT_USER_ROSTER_LABELS: UserRosterLabels = {\n  name: \"Name\",\n  email: \"Email\",\n  role: \"Role\",\n  state: \"State\",\n  created: \"Created\",\n  lastLogin: \"Last login\",\n  never: \"Never\",\n  actions: \"Actions\",\n  actionsFor: (name) => `Actions for ${name}`,\n};\n\n/* ── UserIdentityCell ───────────────────────────────────────────────────────── */\n\nexport interface UserIdentityCellProps {\n  /** First and last name (auth §3.2), shown in the READER's order. */\n  person?: PersonName | null;\n  /** A whole name, for an API that still sends `display_name` only. */\n  name?: string | null;\n  email?: string | null;\n  /** The initials avatar before the name. Default true. */\n  avatar?: boolean;\n  /** After the name, on its line — a \"You\" chip, a demo mark. */\n  badge?: ReactNode;\n  /** Over the provider's locale. */\n  locale?: string;\n  className?: string;\n}\n\n/**\n * Who an account is, in one cell (§3.3): the initials avatar, the name in the reader's\n * order ({@link formatPersonName} — \"Example Ada\" in Hungarian) and the address under it\n * — the cell both rosters drew by hand. An account with no name yet (a migrated row\n * before `CompleteNameDialog`, an invitee) shows its address once, as the name.\n *\n * Both lines carry `data-private`, so keksdose's demo blur reaches them.\n */\nexport function UserIdentityCell({\n  person,\n  name,\n  email,\n  avatar = true,\n  badge,\n  locale: localeProp,\n  className,\n}: UserIdentityCellProps) {\n  const locale = useKitLocale(localeProp);\n  const named = personLabel({ first: person?.first, last: person?.last, name }, locale);\n  const address = (email ?? \"\").trim();\n  return (\n    <div className={cn(\"flex min-w-0 items-center gap-2.5\", className)}>\n      {avatar && <UserAvatar person={person} name={name} email={email} size=\"sm\" />}\n      <div className=\"min-w-0\">\n        <div className=\"flex min-w-0 items-center gap-1.5\">\n          <span data-private className=\"truncate font-medium text-[var(--text-primary)]\">\n            {named || address}\n          </span>\n          {badge}\n        </div>\n        {named && address && (\n          <div data-private className=\"truncate text-xs text-[var(--text-muted)]\">\n            {address}\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n\n/* ── The row's actions ──────────────────────────────────────────────────────── */\n\n/** One entry of a row's action menu (§4). */\nexport interface UserRowAction {\n  /** React key. Default: the label. */\n  key?: string;\n  label: string;\n  /** Runs it — usually opens `AdminActionConfirm` with the level the server states. */\n  onSelect: () => void;\n  icon?: LucideIcon;\n  /** `danger` for deactivate, transfer, erase. */\n  tone?: \"default\" | \"danger\";\n  /** Why it is not available for this row (\"You can’t deactivate yourself\"). The entry\n   *  stays in the menu, focusable, and says so — an action that silently vanished\n   *  would leave the admin looking for it. */\n  disabledReason?: ReactNode;\n  /** Leave it out for this row. */\n  hidden?: boolean;\n}\n\n/** What `actions(row)` may return: entries, and `false` / `null` for the ones a\n *  condition left out (`row.is_active && {…}`). */\nexport type UserRowActionList = readonly (UserRowAction | false | null | undefined)[];\n\nexport interface UserRowActionsProps {\n  actions: UserRowActionList;\n  /** The account's name, for the menu's name — \"Actions for Ada Example\". */\n  name: string;\n  labels?: Partial<UserRosterLabels>;\n}\n\n/**\n * A row's actions as one \"…\" button and a menu of them: keksdose had a strip of icon\n * buttons in the expanded row, Kurvenschmiede five text buttons in a cell — neither fits\n * a phone card, and both grow with every action §2.4 adds. The menu is portalled, so a\n * table's scroller cannot clip it; Escape and an outside press close it, and focus goes\n * back to the button, which is where a confirmation dialog then returns it.\n */\nexport function UserRowActions({ actions, name, labels: labelsProp }: UserRowActionsProps) {\n  const labels = useKitLabels(\"userRoster\", DEFAULT_USER_ROSTER_LABELS, labelsProp);\n  const entries = actions.filter((a): a is UserRowAction => Boolean(a) && !(a as UserRowAction).hidden);\n  if (entries.length === 0) return null;\n  const title = labels.actionsFor(name);\n  return (\n    <Popover\n      width={240}\n      aria-label={title}\n      className=\"p-1\"\n      trigger={({ open, toggle, ref }) => (\n        <IconButton\n          ref={ref}\n          size=\"xs\"\n          label={title}\n          aria-haspopup=\"dialog\"\n          aria-expanded={open}\n          stopPropagation\n          onClick={toggle}\n        >\n          <MoreHorizontal />\n        </IconButton>\n      )}\n    >\n      {(close) => (\n        <ul className=\"space-y-0.5\">\n          {entries.map((action) => {\n            const Icon = action.icon;\n            return (\n              <li key={action.key ?? action.label}>\n                <Button\n                  type=\"button\"\n                  variant=\"ghost\"\n                  size=\"sm\"\n                  stretch\n                  tone={action.tone === \"danger\" ? \"danger\" : undefined}\n                  disabledReason={action.disabledReason}\n                  className=\"justify-start\"\n                  onClick={() => {\n                    close();\n                    action.onSelect();\n                  }}\n                >\n                  {Icon && <Icon className=\"size-4 shrink-0\" aria-hidden />}\n                  {action.label}\n                </Button>\n              </li>\n            );\n          })}\n        </ul>\n      )}\n    </Popover>\n  );\n}\n\n/* ── The preset ─────────────────────────────────────────────────────────────── */\n\n/** How a row's role may be changed inline: `true`, or with reasons. */\nexport interface RoleEditing<R extends string> {\n  /** Why the whole select is locked for this row — `\"self\"`, `\"last_admin\"`, or words. */\n  disabledReason?: RoleLock;\n  /** Why one role cannot be chosen for this row (a string: it goes inside an option). */\n  optionDisabledReason?: (role: R) => string | undefined;\n  /** The roles that may be chosen. Default: the whole vocabulary. */\n  offered?: readonly R[];\n}\n\nexport interface UserRosterColumnsOptions<T extends UserRosterRow, R extends string = string> {\n  /** The app's roles, as `RoleChip` reads them. */\n  roles: RoleVocabulary<R>;\n  /** The row's state chips. Default {@link adminUserStates}, which reads the contract's\n   *  fields (`is_active`, `email_verified`, `password_change_required_at`,\n   *  `deletion_scheduled_at`, `deletion_requested_at`). */\n  stateOf?: (row: T) => readonly RosterState[];\n  /** The app's own columns — keksdose's plan and key custody, Kurvenschmiede's owned\n   *  counts — after the dates, before the actions. */\n  extra?: readonly DataTableColumn<T>[];\n  /** The row's action menu (§4). Left out: no actions column. */\n  actions?: (row: T) => UserRowActionList;\n  /**\n   * Whether this row's role is a select rather than a chip, and with which reasons.\n   * Left out, or `false`: a chip. kastlan's several roles are never a select here — they\n   * are a \"Manage roles\" action that opens `RolesEditor`.\n   */\n  editableRole?: (row: T) => boolean | RoleEditing<R>;\n  /** A role was picked in a row's select. The app confirms (`acknowledge`) and sends it. */\n  onRoleChange?: (row: T, role: R) => void;\n  /** The row's role(s). Default `row.roles ?? row.role`. */\n  roleOf?: (row: T) => R | readonly R[] | null | undefined;\n  /** A separate, sortable \"Email\" column (the server's `email` sort key) beside the\n   *  identity. Default false: the address is under the name already. */\n  emailColumn?: boolean;\n  /** The words, already resolved. Default English; {@link useUserRosterColumns} reads\n   *  the provider's `userRoster` namespace. */\n  labels?: Partial<UserRosterLabels>;\n}\n\nfunction rolesOf<T extends UserRosterRow, R extends string>(\n  row: T,\n  roleOf: UserRosterColumnsOptions<T, R>[\"roleOf\"],\n): R[] {\n  const raw = roleOf ? roleOf(row) : ((row.roles ?? row.role) as R | readonly R[] | null | undefined);\n  if (raw === null || raw === undefined || raw === \"\") return [];\n  return typeof raw === \"string\" ? [raw as R] : [...(raw as readonly R[])];\n}\n\n/** The row's name in the reader's order — a component, because the order is the\n *  READER's and the locale comes from the provider. */\nfunction RowName<T extends UserRosterRow>({ row, children }: { row: T; children: (name: string) => ReactNode }) {\n  const locale = useKitLocale();\n  const name = personLabel(\n    { first: row.first_name, last: row.last_name, name: row.display_name, email: row.email },\n    locale,\n  );\n  return <>{children(name)}</>;\n}\n\nfunction StateChips({ states }: { states: readonly RosterState[] }) {\n  if (states.length === 0) return null;\n  return (\n    <div className=\"flex flex-wrap gap-1\">\n      {states.map((entry) => {\n        const spec = typeof entry === \"string\" ? { state: entry } : entry;\n        return (\n          <AccountStateChip key={spec.state} state={spec.state} date={spec.date} tone={spec.tone} size=\"xs\">\n            {spec.label}\n          </AccountStateChip>\n        );\n      })}\n    </div>\n  );\n}\n\n/**\n * The roster's columns, in the contract's order (§3.3):\n *\n * | key | cell | sort | phone |\n * |---|---|---|---|\n * | `name` | {@link UserIdentityCell} | last, first | the card's headline |\n * | `email` | the address (`emailColumn` only) | address | hidden |\n * | `role` | `RoleChip`(s), or {@link RoleSelect} where `editableRole` | role | field |\n * | `state` | `AccountStateChip`s from `stateOf` | — | field |\n * | `created` | `dateColumn` | instant | hidden |\n * | `last_login` | `dateColumn`, relative, \"Never\" | instant | field |\n * | …`extra` | the app's | the app's | the app's |\n * | `actions` | {@link UserRowActions} | — | field |\n *\n * Pure: hand it resolved words, or use {@link useUserRosterColumns}. The keys are stable,\n * so an app may drop or move a column (`columns.filter((c) => c.key !== \"created\")`).\n * Under `serverPagination` the `sortBy`s only make the headers clickable; the app sends\n * the sort ({@link userRosterSort}).\n */\nexport function userRosterColumns<T extends UserRosterRow, R extends string = string>({\n  roles,\n  stateOf = adminUserStates,\n  extra = [],\n  actions,\n  editableRole,\n  onRoleChange,\n  roleOf,\n  emailColumn = false,\n  labels: labelsProp,\n}: UserRosterColumnsOptions<T, R>): DataTableColumn<T>[] {\n  const labels: UserRosterLabels = { ...DEFAULT_USER_ROSTER_LABELS, ...labelsProp };\n  const roleWords = (row: T) =>\n    rolesOf(row, roleOf)\n      .map((role) => roles[role]?.label ?? role)\n      .join(\", \");\n  const columns: DataTableColumn<T>[] = [\n    {\n      key: \"name\",\n      header: labels.name,\n      cell: (row) => (\n        <UserIdentityCell\n          person={{ first: row.first_name, last: row.last_name }}\n          name={row.display_name}\n          email={row.email}\n        />\n      ),\n      // By last name, then first (auth §3.2), as the server sorts `name`.\n      sortBy: (row) => `${row.last_name ?? \"\"} ${row.first_name ?? \"\"}`.trim().toLocaleLowerCase() || row.email,\n      // Either part, in either order, or the address (auth §10.6).\n      filterBy: (row) =>\n        [row.first_name, row.last_name, row.last_name, row.first_name, row.display_name, row.email]\n          .filter(Boolean)\n          .join(\" \"),\n      mobilePrimary: true,\n    },\n  ];\n  if (emailColumn) {\n    columns.push({\n      key: \"email\",\n      header: labels.email,\n      className: \"whitespace-nowrap\",\n      cell: (row) => (\n        <span data-private className=\"text-[var(--text-secondary)]\">\n          {row.email}\n        </span>\n      ),\n      sortBy: (row) => row.email.toLowerCase(),\n      filterBy: (row) => row.email,\n      mobileHidden: true,\n    });\n  }\n  columns.push(\n    {\n      key: \"role\",\n      header: labels.role,\n      cell: (row) => {\n        const held = rolesOf(row, roleOf);\n        const editing = held.length <= 1 ? editableRole?.(row) : false;\n        if (editing && onRoleChange) {\n          const rules: RoleEditing<R> = editing === true ? {} : editing;\n          return (\n            <RowName row={row}>\n              {(name) => (\n                <RoleSelect<R>\n                  size=\"sm\"\n                  name={name}\n                  value={held[0] ?? null}\n                  roles={roles}\n                  offered={rules.offered}\n                  disabledReason={rules.disabledReason}\n                  optionDisabledReason={rules.optionDisabledReason}\n                  onChange={(role) => onRoleChange(row, role)}\n                />\n              )}\n            </RowName>\n          );\n        }\n        if (held.length === 0) return null;\n        return (\n          <div className=\"flex flex-wrap gap-1\">\n            {held.map((role) => (\n              <RoleChip<R> key={role} value={role} roles={roles} size=\"xs\" />\n            ))}\n          </div>\n        );\n      },\n      sortBy: roleWords,\n      filter: {\n        type: \"select\",\n        getValue: (row) => rolesOf(row, roleOf)[0] ?? \"\",\n        options: (Object.keys(roles) as R[]).map((value) => ({ value, label: roles[value].label })),\n      },\n    },\n    {\n      key: \"state\",\n      header: labels.state,\n      cell: (row) => <StateChips states={stateOf(row)} />,\n    },\n    dateColumn<T>({\n      key: \"created\",\n      header: labels.created,\n      value: (row) => row.created_at ?? null,\n      column: { mobileHidden: true },\n    }),\n    // How long ago rather than a date — the question is \"recently?\" — with the exact\n    // time in a tooltip (keksdose's last-seen column, Kurvenschmiede's).\n    dateColumn<T>({\n      key: \"last_login\",\n      header: labels.lastLogin,\n      value: (row) => row.last_login_at ?? null,\n      display: \"relative\",\n      empty: labels.never,\n    }),\n    ...extra,\n  );\n  if (actions) {\n    columns.push({\n      key: \"actions\",\n      header: <span className=\"sr-only\">{labels.actions}</span>,\n      headerText: labels.actions,\n      // The caller's own words only: the menu reads the provider's itself, and the\n      // English defaults merged in above must not shadow them.\n      cell: (row) => (\n        <RowName row={row}>\n          {(name) => <UserRowActions actions={actions(row)} name={name} labels={labelsProp} />}\n        </RowName>\n      ),\n      className: \"w-px whitespace-nowrap text-end\",\n      headClassName: \"w-px\",\n      // The menu button keeps its own click: a row link must not wrap it.\n      noRowLink: true,\n    });\n  }\n  return columns;\n}\n\n/**\n * {@link userRosterColumns} with the `userRoster` words from the provider, memoised on\n * the options — pass stable callbacks (`useCallback`) and a module-level vocabulary, or\n * the columns are rebuilt on every render.\n */\nexport function useUserRosterColumns<T extends UserRosterRow, R extends string = string>({\n  roles,\n  stateOf,\n  extra,\n  actions,\n  editableRole,\n  onRoleChange,\n  roleOf,\n  emailColumn,\n  labels: labelsProp,\n}: UserRosterColumnsOptions<T, R>): DataTableColumn<T>[] {\n  const labels = useKitLabels(\"userRoster\", DEFAULT_USER_ROSTER_LABELS, labelsProp);\n  return useMemo(\n    () =>\n      userRosterColumns<T, R>({\n        roles,\n        stateOf,\n        extra,\n        actions,\n        editableRole,\n        onRoleChange,\n        roleOf,\n        emailColumn,\n        labels,\n      }),\n    [roles, stateOf, extra, actions, editableRole, onRoleChange, roleOf, emailColumn, labels],\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/auth/accept-invitation.d.ts

@@ -0,0 +1,90 @@
+import * as react from 'react';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { AuthHeadingLevel } from './status-parts.js';
+
+/** Every string the page renders — the `acceptInvitation` namespace. keksdose's words
+ *  where its `/join` page has them (`budget_share.join*`). */
+interface AcceptInvitationLabels {
+    /** The heading. */
+    title: string;
+    /** While the invitation is accepted. */
+    accepting: string;
+    /** Accepted, when the app did not say into what. */
+    accepted: string;
+    /** Accepted, given what it attached the account to — a company, a team, a budget. */
+    joined: (name: string) => string;
+    /** Into the app, from every outcome but "sign in first". */
+    continue: string;
+    /** The token is unknown, spent, or for another address. */
+    invalid: string;
+    expired: string;
+    /** The page was opened without a `token`. */
+    noToken: string;
+    /** Under `invalid` and `expired`: an invitation is re-sent as a new one (§4.4). */
+    askAgain: string;
+    /** Nobody is signed in: an existing account accepts after sign-in (§4.4). */
+    signInFirst: string;
+    /** Under it. */
+    signInHint: string;
+    signIn: string;
+    /** Beside "Sign in", with `registerHref`. */
+    register: string;
+}
+declare const DEFAULT_ACCEPT_INVITATION_LABELS: AcceptInvitationLabels;
+/** What `onAccept` may resolve with. */
+interface AcceptInvitationResult {
+    /** What the invitation attached the account to, by name — "Example Property Ltd",
+     *  "Team North", a budget. Said in the confirmation. */
+    name?: string;
+}
+/** What became of an invitation that was not accepted. `signIn`: the server wants a
+ *  session first (a `401`), which `signedIn` did not know about. */
+type AcceptInvitationFailure = "invalid" | "expired" | "signIn";
+interface AcceptInvitationProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "title"> {
+    /** The invitation's token — the app's `?invite=` / `?token=`. Empty: the link was cut
+     *  short, and the page says so without asking anyone. */
+    token: string;
+    /** Someone is signed in on this device. Until then the page asks for a sign-in and
+     *  sends nothing: accepting attaches the invitation to the SIGNED-IN account. */
+    signedIn: boolean;
+    /**
+     * Accept it — `POST /auth/invitations/accept {token}`, once per token, as soon as
+     * someone is signed in. Resolve (with what it attached the account to, if the app
+     * knows); reject with the client's error.
+     */
+    onAccept: (token: string) => Promise<AcceptInvitationResult | void | undefined>;
+    /** Which dead end a rejection is. Default: `invitation_expired` is `expired`,
+     *  anything else `invalid` (§5.2's codes). Map a `401` to `signIn` here. */
+    classifyError?: (error: unknown) => AcceptInvitationFailure;
+    /** "Continue" — into the app. Default `/`. */
+    continueHref?: string;
+    /** "Sign in" — the app's `/login`, with a way back here (`?next=…`). Default
+     *  `/login`. */
+    signInHref?: string;
+    /** "Create account" beside "Sign in", for an invitation that may lead to a new
+     *  account — the app's `/register?invite=…`. Left out, none. */
+    registerHref?: string;
+    /** The heading. Default `labels.title`; `null` draws none, for a page that puts it in
+     *  `AuthLayout`'s `title` instead. */
+    title?: ReactNode;
+    /** The heading's level. Default `h2`, under the page's `h1`. */
+    headingAs?: AuthHeadingLevel;
+    labels?: Partial<AcceptInvitationLabels>;
+}
+/**
+ * Accept an invitation with an EXISTING account (docs/auth-harmonization.md §4.4): the
+ * link leads here, the person signs in if they are not, and the app attaches the
+ * invitation — a kastlan user joining a second company, a Kurvenschmiede member a team,
+ * a keksdose user a shared budget. A new address never needs this page: its link opens
+ * the sign-up form, which spends the invitation itself.
+ *
+ * keksdose's `JoinSharePage` (features/budgets/join-page.tsx) is the model: it accepts
+ * on load, once (the token is single-use, and StrictMode's double effect would send it
+ * twice), and shows the outcome where its spinner was. The outcomes: accepted, with the
+ * way into the app; not valid; expired (both say to ask for a new invitation, since
+ * "resend" mints a new token); or "sign in first", with nothing sent. "Continue" REPLACES
+ * this page in the history: the token is spent, so Back must not land here again.
+ */
+declare function AcceptInvitation({ token, signedIn, onAccept, classifyError, continueHref, signInHref, registerHref, title, headingAs: Heading, labels: labelsProp, className, ...rest }: AcceptInvitationProps): react.JSX.Element;
+
+export { AcceptInvitation, type AcceptInvitationFailure, type AcceptInvitationLabels, type AcceptInvitationProps, type AcceptInvitationResult, DEFAULT_ACCEPT_INVITATION_LABELS };

package/dist/auth/accept-invitation.js

@@ -0,0 +1,117 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { CheckCircle2, LogIn, TimerOff, XCircle } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { useAnnounce } from "../hooks/use-announce.js";
+import { LoadingState } from "../components/loading-state.js";
+import { Button, EmptyState } from "../components/ui.js";
+import { authErrorCode } from "./auth-errors.js";
+import { OUTCOME_CLASS, STATUS_HEADING_CLASS, useOncePerKey } from "./status-parts.js";
+const DEFAULT_ACCEPT_INVITATION_LABELS = {
+  title: "Accept invitation",
+  accepting: "Joining\u2026",
+  accepted: "Invitation accepted.",
+  joined: (name) => `You\u2019ve joined ${name}.`,
+  continue: "Continue",
+  invalid: "Could not join with this link",
+  expired: "This invitation has expired",
+  noToken: "This link is missing its invite token.",
+  askAgain: "Ask the person who invited you to send a new invitation.",
+  signInFirst: "Sign in to accept this invitation",
+  signInHint: "Use the account the invitation was sent to.",
+  signIn: "Sign in",
+  register: "Create account"
+};
+function AcceptInvitation({
+  token,
+  signedIn,
+  onAccept,
+  classifyError,
+  continueHref = "/",
+  signInHref = "/login",
+  registerHref,
+  title,
+  headingAs: Heading = "h2",
+  labels: labelsProp,
+  className,
+  ...rest
+}) {
+  const labels = useKitLabels("acceptInvitation", DEFAULT_ACCEPT_INVITATION_LABELS, labelsProp);
+  const [settled, setSettled] = useState(null);
+  const { announce, regionProps } = useAnnounce();
+  useOncePerKey(token !== "" && signedIn ? token : null, onAccept, (key, result) => {
+    if (result.ok) {
+      const name = result.value?.name?.trim() || void 0;
+      setSettled({ token: key, outcome: "accepted", name });
+      announce(name ? labels.joined(name) : labels.accepted);
+      return;
+    }
+    const failure = classifyError?.(result.error) ?? (authErrorCode(result.error) === "invitation_expired" ? "expired" : "invalid");
+    setSettled({ token: key, outcome: failure });
+    announce(failure === "signIn" ? labels.signInFirst : labels[failure]);
+  });
+  const outcome = token === "" ? "invalid" : settled?.token === token ? settled.outcome : signedIn ? "accepting" : "signIn";
+  const continueButton = (variant) => /* @__PURE__ */ jsx(Button, { href: continueHref, replace: true, variant, children: labels.continue });
+  let body;
+  if (outcome === "accepting") {
+    body = /* @__PURE__ */ jsx(LoadingState, { size: "sm", label: labels.accepting });
+  } else if (outcome === "accepted") {
+    body = /* @__PURE__ */ jsx(
+      EmptyState,
+      {
+        tone: "success",
+        icon: /* @__PURE__ */ jsx(CheckCircle2, {}),
+        title: settled?.name ? labels.joined(settled.name) : labels.accepted,
+        action: continueButton("brand"),
+        className: OUTCOME_CLASS
+      }
+    );
+  } else if (outcome === "signIn") {
+    body = /* @__PURE__ */ jsx(
+      EmptyState,
+      {
+        icon: /* @__PURE__ */ jsx(LogIn, {}),
+        title: labels.signInFirst,
+        hint: labels.signInHint,
+        action: /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(Button, { href: signInHref, variant: "brand", children: labels.signIn }),
+          registerHref !== void 0 && /* @__PURE__ */ jsx(Button, { href: registerHref, variant: "secondary", children: labels.register })
+        ] }),
+        className: OUTCOME_CLASS
+      }
+    );
+  } else {
+    body = /* @__PURE__ */ jsx(
+      EmptyState,
+      {
+        tone: "danger",
+        icon: outcome === "expired" ? /* @__PURE__ */ jsx(TimerOff, {}) : /* @__PURE__ */ jsx(XCircle, {}),
+        title: token === "" ? labels.noToken : labels[outcome],
+        hint: labels.askAgain,
+        action: signedIn ? continueButton("secondary") : void 0,
+        className: OUTCOME_CLASS
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ...rest,
+      "data-state": outcome,
+      "aria-busy": outcome === "accepting" || void 0,
+      className: cn("space-y-3", className),
+      children: [
+        title === null ? null : /* @__PURE__ */ jsx(Heading, { className: STATUS_HEADING_CLASS, children: title ?? labels.title }),
+        body,
+        /* @__PURE__ */ jsx("div", { ...regionProps })
+      ]
+    }
+  );
+}
+export {
+  AcceptInvitation,
+  DEFAULT_ACCEPT_INVITATION_LABELS
+};
+//# sourceMappingURL=accept-invitation.js.map