@stapel/workspaces-react 0.16.0 → 0.19.0

package/dist/default/index.d.ts

@@ -1,20 +1,41 @@
 /**
- * `@stapel/workspaces-react/default` — the pilot default skin for this
- * pair's settings surfaces (mirrors auth-react's `/default` split, §54): a
- * separate entry point so consumers who bring their own visuals never pull
- * `antd` into their bundle; importing this subpath is the opt-in.
+ * `@stapel/workspaces-react/default` — this pair's DEFAULT SKIN: the antd
+ * screens a host mounts to have a working workspace product, not a set of
+ * examples (§83, §54). A separate entry point so consumers who bring their
+ * own visuals never pull `antd` into their bundle; importing this subpath is
+ * the opt-in.
+ *
+ * Every screen self-themes through `<SkinTheme>` from
+ * `@stapel/tokens-antd/skin`, so it is correct inside a dark document with no
+ * host wiring, and every one of them needs this pair's `<WorkspacesProvider>`
+ * plus core's `<I18nProvider>` above it.
  *
  * ```tsx
- * import { WorkspaceSettings, MembersManager } from "@stapel/workspaces-react/default";
- * // under this pair's <WorkspacesProvider> + core <I18nProvider>:
- * <WorkspaceSettings workspaceId={id} />
+ * import {
+ *   WorkspacesPage, WorkspaceSettings, MembersManager,
+ *   InvitationsPane, AuditTrailPane, InviteAcceptPage,
+ * } from "@stapel/workspaces-react/default";
+ *
+ * <WorkspacesPage onOpen={(ws) => navigate(`/w/${ws.slug}`)} />
+ * <WorkspaceSettings workspaceId={id} onDeleted={() => navigate("/")} />
  * <MembersManager workspaceId={id} />
+ * <InvitationsPane workspaceId={id} />
+ * <AuditTrailPane workspaceId={id} />
+ * <InviteAcceptPage token={token} sessionEmail={email} />
  * ```
  */
+export { WorkspacesPage } from "./WorkspacesPage.js";
+export type { WorkspacesPageProps } from "./WorkspacesPage.js";
 export { WorkspaceSettings } from "./WorkspaceSettings.js";
 export type { WorkspaceSettingsProps } from "./WorkspaceSettings.js";
 export { MembersManager } from "./MembersManager.js";
 export type { MembersManagerProps } from "./MembersManager.js";
+export { InvitationsPane } from "./InvitationsPane.js";
+export type { InvitationsPaneProps } from "./InvitationsPane.js";
+export { AuditTrailPane } from "./AuditTrailPane.js";
+export type { AuditTrailPaneProps } from "./AuditTrailPane.js";
+export { RoleSelectField } from "./RoleSelectField.js";
+export type { RoleSelectFieldProps } from "./RoleSelectField.js";
 export { InviteAcceptPage } from "./InviteAcceptPage.js";
 export type { InviteAcceptPageProps } from "./InviteAcceptPage.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/default/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/default/index.js

@@ -1,17 +1,34 @@
 /**
- * `@stapel/workspaces-react/default` — the pilot default skin for this
- * pair's settings surfaces (mirrors auth-react's `/default` split, §54): a
- * separate entry point so consumers who bring their own visuals never pull
- * `antd` into their bundle; importing this subpath is the opt-in.
+ * `@stapel/workspaces-react/default` — this pair's DEFAULT SKIN: the antd
+ * screens a host mounts to have a working workspace product, not a set of
+ * examples (§83, §54). A separate entry point so consumers who bring their
+ * own visuals never pull `antd` into their bundle; importing this subpath is
+ * the opt-in.
+ *
+ * Every screen self-themes through `<SkinTheme>` from
+ * `@stapel/tokens-antd/skin`, so it is correct inside a dark document with no
+ * host wiring, and every one of them needs this pair's `<WorkspacesProvider>`
+ * plus core's `<I18nProvider>` above it.
  *
  * ```tsx
- * import { WorkspaceSettings, MembersManager } from "@stapel/workspaces-react/default";
- * // under this pair's <WorkspacesProvider> + core <I18nProvider>:
- * <WorkspaceSettings workspaceId={id} />
+ * import {
+ *   WorkspacesPage, WorkspaceSettings, MembersManager,
+ *   InvitationsPane, AuditTrailPane, InviteAcceptPage,
+ * } from "@stapel/workspaces-react/default";
+ *
+ * <WorkspacesPage onOpen={(ws) => navigate(`/w/${ws.slug}`)} />
+ * <WorkspaceSettings workspaceId={id} onDeleted={() => navigate("/")} />
  * <MembersManager workspaceId={id} />
+ * <InvitationsPane workspaceId={id} />
+ * <AuditTrailPane workspaceId={id} />
+ * <InviteAcceptPage token={token} sessionEmail={email} />
  * ```
  */
+export { WorkspacesPage } from "./WorkspacesPage.js";
 export { WorkspaceSettings } from "./WorkspaceSettings.js";
 export { MembersManager } from "./MembersManager.js";
+export { InvitationsPane } from "./InvitationsPane.js";
+export { AuditTrailPane } from "./AuditTrailPane.js";
+export { RoleSelectField } from "./RoleSelectField.js";
 export { InviteAcceptPage } from "./InviteAcceptPage.js";
 //# sourceMappingURL=index.js.map

package/dist/default/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/default/parts.d.ts

@@ -0,0 +1,104 @@
+import type { CSSProperties, ReactElement, ReactNode } from "react";
+import type { ActionAvailability } from "@stapel/core";
+/** The muted sentence that sits under a control or beside a value. */
+export declare function Muted(props: {
+    readonly children: ReactNode;
+    readonly testId?: string | undefined;
+}): ReactElement;
+/**
+ * A person, drawn the same way on every screen of this pair: monogram, the
+ * name they go by, the address underneath.
+ *
+ * The rule the visual pass forced: an id never reaches the glass. A member
+ * whose profile has no name shows the invited ADDRESS as the primary line and
+ * says so, rather than showing a truncated UUID or an em dash.
+ */
+export declare function PersonLine(props: {
+    readonly name: string | null | undefined;
+    readonly email: string | null | undefined;
+    /** Rendered under the address — "Joined 3 days ago", a suspension reason. */
+    readonly caption?: ReactNode;
+    /** Tags beside the name (suspended, provisioned, two-factor). */
+    readonly tags?: ReactNode;
+    readonly testId?: string | undefined;
+}): ReactElement;
+/** A neutral status pill. `tone` picks antd's semantic colour, so it survives
+ * the dark swap — a hex here would not. */
+export declare function StatusTag(props: {
+    readonly tone: "neutral" | "success" | "warning" | "danger" | "info";
+    readonly children: ReactNode;
+    readonly testId?: string | undefined;
+}): ReactElement;
+/**
+ * The anchor pager three screens share.
+ *
+ * Two buttons and a position, and nothing that pretends to be a page NUMBER
+ * the contract cannot supply: the wire addresses a page by the previous
+ * page's opaque cursor, so "jump to page 7" is not a question this API can be
+ * asked. The index shown is the count of steps THIS screen has taken, which
+ * is a true statement about the walk rather than about the roster.
+ */
+export declare function AnchorPager(props: {
+    readonly hasPrev: boolean;
+    readonly hasNext: boolean;
+    readonly onPrev: () => void;
+    readonly onNext: () => void;
+    readonly prevLabel: string;
+    readonly nextLabel: string;
+    readonly position: string;
+    readonly testId?: string | undefined;
+}): ReactElement | null;
+/** One control on a list row, with the verdict that decides whether it opens. */
+export interface RowActionSpec {
+    readonly key: string;
+    readonly gate: ActionAvailability;
+    readonly label: ReactNode;
+    readonly onClick: () => void;
+    readonly danger?: boolean;
+    readonly testId?: string | undefined;
+}
+/**
+ * A list row's controls, and the refusal behind them stated ONCE.
+ *
+ * `GatedButton` prints the reason under every control it switches off, which
+ * is right for a lone button and wrong for a row: three refused controls print
+ * the same sentence three times, and a list of such rows becomes a wall of
+ * repeated apology — six copies of "This invitation was already accepted,
+ * declined, revoked or expired" on one 390px screen. The reason is a fact
+ * about the ROW, not about each button, so it is rendered once, as a footnote
+ * spanning the row, with every disabled control's `aria-describedby` pointing
+ * at it.
+ *
+ * Two nodes come back, meant to be direct children of the row's flex
+ * container: the controls, and the full-width footnote. Keeping the footnote
+ * OUT of the action column is what stops a refused row from growing a second
+ * geometry while its neighbours stay on one line.
+ *
+ * `reason` overrides the collected sentences where the screen has a better
+ * single one — a terminal invitation refuses three controls for one reason
+ * that the row's own status tag already names.
+ */
+export declare function RowActions(props: {
+    readonly actions: readonly RowActionSpec[];
+    readonly reason?: string | undefined;
+    readonly testId?: string | undefined;
+}): ReactElement;
+/**
+ * A failed read, said once, in a shape a 390px screen can hold.
+ *
+ * The substrate's `ErrorAlert` puts its retry in antd's `action` slot, which
+ * is a column beside the message — at phone width the sentence is squeezed
+ * into ~110px and breaks a word per line. Until the substrate stacks it
+ * (VC-B6, filed), the retry goes UNDER the alert here, where it has the whole
+ * width at any viewport.
+ */
+export declare function LoadFailure(props: {
+    readonly error: unknown;
+    readonly onRetry?: (() => void) | undefined;
+    readonly testId?: string | undefined;
+}): ReactElement;
+/** The gap between the stacked blocks of a screen. One number, one place. */
+export declare const SCREEN_STACK: CSSProperties;
+/** The gap between the fields inside one block. */
+export declare const FIELD_STACK: CSSProperties;
+//# sourceMappingURL=parts.d.ts.map

package/dist/default/parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/default/parts.tsx"],"names":[],"mappings":"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"}

package/dist/default/parts.js

@@ -0,0 +1,140 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The small pieces every screen in this pair's default skin is built from.
+ *
+ * Not exported from `./index.ts`: these are the skin's own vocabulary, not
+ * product surfaces a host mounts. They live in one file because the visual
+ * pass found the same three things drawn differently on each screen — a
+ * person rendered as a bare email here and a truncated id there, a page walk
+ * with no way back, a muted caption at three different sizes.
+ *
+ * Every dimension is a `@stapel/tokens` step. Colour comes from antd's token
+ * layer through `SkinTheme`, never from a literal.
+ */
+import { useId } from "react";
+import { Avatar, Button, Flex, Tag, Typography } from "antd";
+import { STAPEL_UI_KEYS, useT } from "@stapel/core";
+import { ErrorAlert } from "@stapel/tokens-antd/skin";
+import { spacing, fontSize } from "@stapel/tokens";
+/** The muted sentence that sits under a control or beside a value. */
+export function Muted(props) {
+    return (_jsx(Typography.Text, { type: "secondary", style: { fontSize: fontSize.xs.fontSize }, ...(props.testId !== undefined ? { "data-testid": props.testId } : {}), children: props.children }));
+}
+/** One letter for a person with no picture. Never an id: the monogram of a
+ * name, or of the mailbox part of an address, and a neutral glyph when there
+ * is neither. */
+function monogram(name, email) {
+    const source = (name ?? email ?? "").trim();
+    const first = source.charAt(0);
+    return first === "" ? "·" : first.toUpperCase();
+}
+/**
+ * A person, drawn the same way on every screen of this pair: monogram, the
+ * name they go by, the address underneath.
+ *
+ * The rule the visual pass forced: an id never reaches the glass. A member
+ * whose profile has no name shows the invited ADDRESS as the primary line and
+ * says so, rather than showing a truncated UUID or an em dash.
+ */
+export function PersonLine(props) {
+    const name = props.name?.trim() ? props.name.trim() : null;
+    const email = props.email?.trim() ? props.email.trim() : null;
+    const primary = name ?? email;
+    return (_jsxs(Flex, { gap: spacing["3"], align: "flex-start", ...(props.testId !== undefined ? { "data-testid": props.testId } : {}), children: [_jsx(Avatar, { size: "small", "aria-hidden": true, children: monogram(name, email) }), _jsxs(Flex, { vertical: true, gap: spacing["0"], style: { minWidth: 0 }, children: [_jsxs(Flex, { gap: spacing["2"], align: "center", wrap: true, children: [_jsx(Typography.Text, { strong: true, children: primary }), props.tags] }), name !== null && email !== null && _jsx(Muted, { children: email }), props.caption !== undefined && _jsx(Muted, { children: props.caption })] })] }));
+}
+/** A neutral status pill. `tone` picks antd's semantic colour, so it survives
+ * the dark swap — a hex here would not. */
+export function StatusTag(props) {
+    const color = props.tone === "success"
+        ? "success"
+        : props.tone === "warning"
+            ? "warning"
+            : props.tone === "danger"
+                ? "error"
+                : props.tone === "info"
+                    ? "processing"
+                    : "default";
+    return (_jsx(Tag, { color: color, ...(props.testId !== undefined ? { "data-testid": props.testId } : {}), children: props.children }));
+}
+/**
+ * The anchor pager three screens share.
+ *
+ * Two buttons and a position, and nothing that pretends to be a page NUMBER
+ * the contract cannot supply: the wire addresses a page by the previous
+ * page's opaque cursor, so "jump to page 7" is not a question this API can be
+ * asked. The index shown is the count of steps THIS screen has taken, which
+ * is a true statement about the walk rather than about the roster.
+ */
+export function AnchorPager(props) {
+    if (!props.hasPrev && !props.hasNext)
+        return null;
+    return (_jsxs(Flex, { justify: "space-between", align: "center", gap: spacing["3"], style: { marginTop: spacing["4"] }, ...(props.testId !== undefined ? { "data-testid": props.testId } : {}), children: [_jsx(Button, { size: "small", onClick: props.onPrev, disabled: !props.hasPrev, "data-disabled-reason": "first page of the walk \u2014 there is nothing before it", "data-analytics": "none", "data-analytics-reason": "local-ui-page-walk", "data-testid": "workspaces-pager-prev", children: props.prevLabel }), _jsx(Muted, { children: props.position }), _jsx(Button, { size: "small", onClick: props.onNext, disabled: !props.hasNext, "data-disabled-reason": "the server says this page is the last one", "data-analytics": "none", "data-analytics-reason": "local-ui-page-walk", "data-testid": "workspaces-pager-next", children: props.nextLabel })] }));
+}
+/**
+ * A list row's controls, and the refusal behind them stated ONCE.
+ *
+ * `GatedButton` prints the reason under every control it switches off, which
+ * is right for a lone button and wrong for a row: three refused controls print
+ * the same sentence three times, and a list of such rows becomes a wall of
+ * repeated apology — six copies of "This invitation was already accepted,
+ * declined, revoked or expired" on one 390px screen. The reason is a fact
+ * about the ROW, not about each button, so it is rendered once, as a footnote
+ * spanning the row, with every disabled control's `aria-describedby` pointing
+ * at it.
+ *
+ * Two nodes come back, meant to be direct children of the row's flex
+ * container: the controls, and the full-width footnote. Keeping the footnote
+ * OUT of the action column is what stops a refused row from growing a second
+ * geometry while its neighbours stay on one line.
+ *
+ * `reason` overrides the collected sentences where the screen has a better
+ * single one — a terminal invitation refuses three controls for one reason
+ * that the row's own status tag already names.
+ */
+export function RowActions(props) {
+    const t = useT();
+    const reasonId = useId();
+    const collected = [];
+    if (props.reason !== undefined) {
+        collected.push(props.reason);
+    }
+    else {
+        const seen = new Set();
+        for (const action of props.actions) {
+            if (action.gate.available)
+                continue;
+            if (seen.has(action.gate.block.code))
+                continue;
+            seen.add(action.gate.block.code);
+            collected.push(t(action.gate.block.code, action.gate.block.params));
+        }
+    }
+    const anyBlocked = props.actions.some((action) => !action.gate.available);
+    return (_jsxs(_Fragment, { children: [_jsx(Flex, { gap: spacing["2"], align: "center", wrap: true, children: props.actions.map((action) => (_jsx(Button, { type: "link", size: "small", danger: action.danger === true, disabled: !action.gate.available, ...(anyBlocked && !action.gate.available
+                        ? { "aria-describedby": reasonId }
+                        : {}), onClick: action.onClick, "data-analytics": "none", "data-analytics-reason": "passthrough \u2014 the caller's onClick carries the tracked action", ...(action.testId !== undefined ? { "data-testid": action.testId } : {}), children: action.label }, action.key))) }), collected.length > 0 && (_jsx("div", { id: reasonId, "data-stapel-gated-reason": "", style: { flexBasis: "100%", minWidth: 0 }, ...(props.testId !== undefined ? { "data-testid": props.testId } : {}), children: collected.map((sentence) => (_jsx("div", { children: _jsx(Muted, { children: sentence }) }, sentence))) }))] }));
+}
+/**
+ * A failed read, said once, in a shape a 390px screen can hold.
+ *
+ * The substrate's `ErrorAlert` puts its retry in antd's `action` slot, which
+ * is a column beside the message — at phone width the sentence is squeezed
+ * into ~110px and breaks a word per line. Until the substrate stacks it
+ * (VC-B6, filed), the retry goes UNDER the alert here, where it has the whole
+ * width at any viewport.
+ */
+export function LoadFailure(props) {
+    const t = useT();
+    return (_jsxs(Flex, { vertical: true, gap: spacing["3"], align: "flex-start", children: [_jsx(ErrorAlert, { thrown: props.error, style: { width: "100%" }, ...(props.testId !== undefined ? { testId: props.testId } : {}) }), props.onRetry !== undefined && (_jsx(Button, { onClick: props.onRetry, "data-analytics": "none", "data-analytics-reason": "retry of a failed read; the read hook reports its own outcome", "data-testid": props.testId !== undefined ? `${props.testId}-retry` : undefined, children: t(STAPEL_UI_KEYS.retry) }))] }));
+}
+/** The gap between the stacked blocks of a screen. One number, one place. */
+export const SCREEN_STACK = {
+    display: "grid",
+    gap: spacing["4"],
+};
+/** The gap between the fields inside one block. */
+export const FIELD_STACK = {
+    display: "grid",
+    gap: spacing["3"],
+};
+//# sourceMappingURL=parts.js.map

package/dist/default/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","sourceRoot":"","sources":["../../src/default/parts.tsx"],"names":[],"mappings":"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"}

package/dist/headless/Members.d.ts

@@ -1,22 +1,56 @@
 import type { ReactNode } from "react";
 import type { LoadState, StapelApiError } from "@stapel/core";
-import type { Member, MemberInvite } from "../api/types.js";
-import type { MemberRoleChange } from "../model/mutations.js";
+import type { Member, MemberInvite, MembersParams } from "../api/types.js";
+import type { MemberRename, MemberRoleChange } from "../model/mutations.js";
+/**
+ * Where in the anchor walk the current page sits — the half of the roster a
+ * pager needs and a count of rows cannot supply.
+ *
+ * ANCHOR, not offset: a page is addressed by the opaque `next_anchor` of the
+ * page before it, so a member removed while an admin reads never skews the
+ * next page. There is no "page 3" to jump to, which is why the shape carries
+ * two cursors and no index.
+ */
+export interface MembersPageInfo {
+    readonly hasNext: boolean;
+    readonly hasPrev: boolean;
+    /** Pass as `params.anchor` with `direction: "next"` to walk forward. */
+    readonly nextAnchor: string | null;
+    /** Pass as `params.anchor` with `direction: "prev"` to walk back. */
+    readonly prevAnchor: string | null;
+    /** Rows on THIS page. Never a count of the roster — see `rosterComplete`. */
+    readonly count: number;
+}
 /** Render-prop bag for {@link Members}. */
 export interface MembersBag {
     /**
      * The roster read, as a state a skin cannot flatten — render it with core's
-     * `matchList`. This is one page (default 100); a full pager is out of scope
-     * for this renderless view (bring your own via `useMembers`' `params` for
-     * anchor pagination).
+     * `matchList`. This is ONE page: which one is decided by the `params` the
+     * caller passes (default: the newest page, limit 100), and {@link page}
+     * says whether there is another.
      *
      * Separate from {@link writeError} on purpose: "the roster could not be
      * loaded" and "your invite was rejected" are different sentences, and the
      * old merged `isError` could only produce one of them.
      */
     readonly state: LoadState<readonly Member[]>;
-    /** An invite, a role change, or a removal failed. Never the read — that is
-     * {@link state}. */
+    /**
+     * Whether {@link state} holds the WHOLE roster — the read succeeded and the
+     * page reports no `has_next`.
+     *
+     * A skin may only reason about the roster as a set — "is this the last
+     * owner?", "how many admins are there?" — while this is `true`. On one page
+     * of a longer roster those counts are counts of a page, and a control gated
+     * on one would refuse a removal the backend would have allowed, which is a
+     * worse defect than the ungated button it replaced. `false` while the read
+     * is loading or failed: an unknown roster is never a complete one.
+     */
+    readonly rosterComplete: boolean;
+    /** The walk position, or `null` while the page has not arrived. A pager
+     * with no page cannot claim there is a next one. */
+    readonly page: MembersPageInfo | null;
+    /** An invite, a role change, a rename or a removal failed. Never the read —
+     * that is {@link state}. */
     readonly writeError: StapelApiError | null;
     /** Invite one or more emails at a role. */
     invite(body: MemberInvite): void;
@@ -26,6 +60,11 @@ export interface MembersBag {
     updateRole(change: MemberRoleChange): void;
     /** A role-change call is in flight. */
     readonly isUpdatingRole: boolean;
+    /** Correct a member's display name — the CANONICAL one (stapel-profiles),
+     * not a workspace-local note. `displayName: null` clears it. */
+    rename(change: MemberRename): void;
+    /** A rename call is in flight. */
+    readonly isRenaming: boolean;
     /** Remove a member by `userId`. */
     remove(userId: string): void;
     /** A removal call is in flight. */
@@ -34,20 +73,26 @@ export interface MembersBag {
     refetch(): void;
 }
 /**
- * Headless member roster — a renderless view + invite / role-change / removal
- * controls over one workspace's members. Wires {@link useMembers},
- * {@link useInviteMembers}, {@link useUpdateMemberRole}, and
- * {@link useRemoveMember} and hands a {@link MembersBag} to `children`; bring your
- * own roster / invite form / role menu. Zero visual opinion (frontend-standard §2).
+ * Headless member roster — a renderless view + invite / role-change / rename /
+ * removal controls over one workspace's members. Wires {@link useMembers},
+ * {@link useInviteMembers}, {@link useUpdateMemberRole},
+ * {@link useRenameMember} and {@link useRemoveMember} and hands a
+ * {@link MembersBag} to `children`; bring your own roster / invite form / role
+ * menu. Zero visual opinion (frontend-standard §2).
+ *
+ * `params` is the anchor page to read — the caller owns the walk, because the
+ * cursor belongs to the screen's state, not to this component's. Omitted, it
+ * reads the newest page, exactly as before.
  *
  * ```tsx
- * <Members workspaceId={id}>
- *   {({ state, invite, updateRole, remove }) => ( ... )}
+ * <Members workspaceId={id} params={{ anchor, direction: "next", search }}>
+ *   {({ state, page, invite, updateRole, remove }) => ( ... )}
  * </Members>
  * ```
  */
 export declare function Members(props: {
     workspaceId: string;
+    params?: MembersParams;
     children: (bag: MembersBag) => ReactNode;
 }): ReactNode;
 //# sourceMappingURL=Members.d.ts.map

package/dist/headless/Members.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Members.d.ts","sourceRoot":"","sources":["../../src/headless/Members.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC7C;wBACoB;IACpB,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3C,2CAA2C;IAC3C,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,8BAA8B;IAC9B,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,uCAAuC;IACvC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,mCAAmC;IACnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,+CAA+C;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,SAAS,CAAC;CAC1C,GAAG,SAAS,CAyBZ"}
+{"version":3,"file":"Members.d.ts","sourceRoot":"","sources":["../../src/headless/Members.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQ3E,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC7C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;wDACoD;IACpD,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC;gCAC4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3C,2CAA2C;IAC3C,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,8BAA8B;IAC9B,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,uCAAuC;IACvC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;oEACgE;IAChE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,mCAAmC;IACnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,+CAA+C;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,SAAS,CAAC;CAC1C,GAAG,SAAS,CA8CZ"}

package/dist/headless/Members.js

@@ -1,27 +1,48 @@
 import { loadStateFromQuery, mapLoad } from "@stapel/core";
 import { useMembers } from "../model/queries.js";
-import { useInviteMembers, useRemoveMember, useUpdateMemberRole, } from "../model/mutations.js";
+import { useInviteMembers, useRemoveMember, useRenameMember, useUpdateMemberRole, } from "../model/mutations.js";
 /**
- * Headless member roster — a renderless view + invite / role-change / removal
- * controls over one workspace's members. Wires {@link useMembers},
- * {@link useInviteMembers}, {@link useUpdateMemberRole}, and
- * {@link useRemoveMember} and hands a {@link MembersBag} to `children`; bring your
- * own roster / invite form / role menu. Zero visual opinion (frontend-standard §2).
+ * Headless member roster — a renderless view + invite / role-change / rename /
+ * removal controls over one workspace's members. Wires {@link useMembers},
+ * {@link useInviteMembers}, {@link useUpdateMemberRole},
+ * {@link useRenameMember} and {@link useRemoveMember} and hands a
+ * {@link MembersBag} to `children`; bring your own roster / invite form / role
+ * menu. Zero visual opinion (frontend-standard §2).
+ *
+ * `params` is the anchor page to read — the caller owns the walk, because the
+ * cursor belongs to the screen's state, not to this component's. Omitted, it
+ * reads the newest page, exactly as before.
  *
  * ```tsx
- * <Members workspaceId={id}>
- *   {({ state, invite, updateRole, remove }) => ( ... )}
+ * <Members workspaceId={id} params={{ anchor, direction: "next", search }}>
+ *   {({ state, page, invite, updateRole, remove }) => ( ... )}
  * </Members>
  * ```
  */
 export function Members(props) {
-    const query = useMembers(props.workspaceId);
+    const query = useMembers(props.workspaceId, props.params);
     const inviteMutation = useInviteMembers(props.workspaceId);
     const roleMutation = useUpdateMemberRole(props.workspaceId);
+    const renameMutation = useRenameMember(props.workspaceId);
     const removeMutation = useRemoveMember(props.workspaceId);
+    const data = query.data;
     return props.children({
         state: mapLoad(loadStateFromQuery(query), (page) => page.items),
-        writeError: inviteMutation.error ?? roleMutation.error ?? removeMutation.error ?? null,
+        rosterComplete: data !== undefined && !data.has_next && !data.has_prev,
+        page: data === undefined
+            ? null
+            : {
+                hasNext: data.has_next,
+                hasPrev: data.has_prev,
+                nextAnchor: data.next_anchor ?? null,
+                prevAnchor: data.prev_anchor ?? null,
+                count: data.count,
+            },
+        writeError: inviteMutation.error ??
+            roleMutation.error ??
+            renameMutation.error ??
+            removeMutation.error ??
+            null,
         invite: (body) => {
             inviteMutation.mutate(body);
         },
@@ -30,6 +51,10 @@ export function Members(props) {
             roleMutation.mutate(change);
         },
         isUpdatingRole: roleMutation.isPending,
+        rename: (change) => {
+            renameMutation.mutate(change);
+        },
+        isRenaming: renameMutation.isPending,
         remove: (userId) => {
             removeMutation.mutate(userId);
         },

package/dist/headless/Members.js.map

@@ -1 +1 @@
-{"version":3,"file":"Members.js","sourceRoot":"","sources":["../../src/headless/Members.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAmC/B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAC,KAGvB;IACC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/D,UAAU,EACR,cAAc,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK,IAAI,IAAI;QAC5E,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,UAAU,EAAE,cAAc,CAAC,SAAS;QACpC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;YACrB,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,cAAc,EAAE,YAAY,CAAC,SAAS;QACtC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACjB,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,UAAU,EAAE,cAAc,CAAC,SAAS;QACpC,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"Members.js","sourceRoot":"","sources":["../../src/headless/Members.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AA2E/B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,OAAO,CAAC,KAIvB;IACC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/D,cAAc,EAAE,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ;QACtE,IAAI,EACF,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC;gBACE,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,UAAU,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;gBACpC,UAAU,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB;QACP,UAAU,EACR,cAAc,CAAC,KAAK;YACpB,YAAY,CAAC,KAAK;YAClB,cAAc,CAAC,KAAK;YACpB,cAAc,CAAC,KAAK;YACpB,IAAI;QACN,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,UAAU,EAAE,cAAc,CAAC,SAAS;QACpC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;YACrB,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,cAAc,EAAE,YAAY,CAAC,SAAS;QACtC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACjB,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,UAAU,EAAE,cAAc,CAAC,SAAS;QACpC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACjB,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,UAAU,EAAE,cAAc,CAAC,SAAS;QACpC,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/headless/RoleSelect.d.ts

@@ -12,9 +12,15 @@ export interface RoleSelectBag {
      * Display label for a role key: the i18n key `workspaces.role.<key>` when
      * the current locale's merged bundle carries it (the pair ships the builtin
      * four; a client bundle merges its own — e.g. `workspaces.role.secretary`),
-     * else the RAW role key. The raw-name fallback is deliberate: a
-     * deployment-defined role without a translation must still be pickable,
-     * never render as a dotted i18n key.
+     * else the role key TITLE-CASED (`secretary` → `Secretary`, `site_admin` →
+     * `Site admin`).
+     *
+     * Two things this fallback is not. It is never the dotted i18n key: a
+     * deployment-defined role without a translation must still be pickable. And
+     * since the 2026-08-24 visual pass it is no longer the raw token either —
+     * `secretary` rendered lowercase in a list of title-cased builtin roles,
+     * which reads as broken data rather than as a missing translation. The
+     * label is cosmetic; the VALUE stays the registry key everywhere it is sent.
      */
     labelFor(role: string): string;
 }

package/dist/headless/RoleSelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RoleSelect.d.ts","sourceRoot":"","sources":["../../src/headless/RoleSelect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B;;;gEAG4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAC/C;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,SAAS,CAAC;CAC7C,GAAG,SAAS,CAWZ"}
+{"version":3,"file":"RoleSelect.d.ts","sourceRoot":"","sources":["../../src/headless/RoleSelect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B;;;gEAG4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAC/C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,SAAS,CAAC;CAC7C,GAAG,SAAS,CAWZ"}

package/dist/headless/RoleSelect.js

@@ -1,4 +1,5 @@
 import { loadStateFromQuery, useI18n } from "@stapel/core";
+import { titleCaseKey } from "../model/format.js";
 import { useRoles } from "../model/queries.js";
 /**
  * Headless role picker over the effective role registry (org-program §A2) —
@@ -28,11 +29,11 @@ export function RoleSelect(props) {
     const i18n = useI18n();
     // Raw bundle lookup, NOT `t()`: `t` falls back to the key itself, which is
     // exactly the wrong fallback here (a deployment role without a translation
-    // must show its raw name, not `workspaces.role.secretary`).
+    // must show a word, not `workspaces.role.secretary`).
     const bundle = i18n.getBundle();
     return props.children({
         state: loadStateFromQuery(query),
-        labelFor: (role) => bundle[`workspaces.role.${role}`] ?? role,
+        labelFor: (role) => bundle[`workspaces.role.${role}`] ?? titleCaseKey(role),
     });
 }
 //# sourceMappingURL=RoleSelect.js.map

package/dist/headless/RoleSelect.js.map

@@ -1 +1 @@
-{"version":3,"file":"RoleSelect.js","sourceRoot":"","sources":["../../src/headless/RoleSelect.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAoB/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CAAC,KAE1B;IACC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,2EAA2E;IAC3E,2EAA2E;IAC3E,4DAA4D;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC;QAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,IAAI,IAAI;KAC9D,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"RoleSelect.js","sourceRoot":"","sources":["../../src/headless/RoleSelect.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AA0B/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CAAC,KAE1B;IACC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,2EAA2E;IAC3E,2EAA2E;IAC3E,sDAAsD;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC;QAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC;KAC5E,CAAC,CAAC;AACL,CAAC"}