@crisp-ui-kit/crisp 0.50.0 → 0.52.0

package/dist/types/product/recordpanel/recordpanel.d.ts

@@ -1,35 +1,99 @@
 import * as React from "react";
-import { type Column, type Row } from "../recordstable";
+import { type AvatarProps } from "../../components/avatar";
+import type { Row } from "../recordstable";
+type IconType = React.ComponentType<{
+    size?: number;
+    strokeWidth?: number;
+}>;
+/** One Highlights card — label, value and an optional icon, laid out the
+ * way Attio's peek panel lays its own out (measured live, #448): a 2-column
+ * grid, no card chrome (no border/background/shadow), a muted label row
+ * with a trailing icon, a filled-colour value below it. */
+export type RecordPanelHighlight = {
+    key: string;
+    label: string;
+    value: React.ReactNode;
+    icon?: IconType;
+};
 export type RecordPanelProps = Omit<React.ComponentPropsWithoutRef<"div">, "children" | "title"> & {
-    /** The record to show; render nothing when null. */
     /** Label for the close control. */
     closeLabel?: string;
+    /**
+     * A toolbar row above the panel's own identity header — measured live on
+     * app.attio.com's peek (hover a Companies row, click "Open preview"):
+     * Close, then Previous/Next record on the left, an "Open record" icon on
+     * the right, a hairline border beneath separating it from the identity
+     * block below. Close always renders (`onClose` is required); Previous/
+     * Next/Open record each render only when given a handler — a consumer
+     * with no adjacent-row concept, or nowhere to open the record's own full
+     * page, simply omits them, leaving just Close.
+     */
+    onOpenRecord?: () => void;
+    openRecordLabel?: string;
+    onPrevious?: () => void;
+    previousRecordLabel?: string;
+    onNext?: () => void;
+    nextRecordLabel?: string;
     /**
      * The panel's heading, and so its accessible name (via `aria-labelledby`,
      * not a stringified `aria-label` — it also drives the visible title, which
-     * can be any node). Defaults to the entity column's name, same as before
-     * this prop existed; pass it to title the panel by something else, e.g.
-     * "{Collection} record".
+     * can be any node). Defaults to `record.name`.
      */
     title?: React.ReactNode;
-    /** Heading above the field list. */
-    detailsLabel?: React.ReactNode;
-    /** Shown in place of a field that has no value. */
-    emptyLabel?: React.ReactNode;
-    /** Rendered below the field list, e.g. an Edit button. Omit for no footer. */
+    /** Avatar image URL beside the title. Omit for an initials tile built
+     *  from `record.name`'s first character. */
+    avatar?: string;
+    /** Tone for the initials tile when no `avatar` image is given (default
+     *  "brand", matching Attio's own peek). */
+    avatarTone?: NonNullable<AvatarProps["tone"]>;
+    /** The record to show; render nothing when null. Only `id`/`name` are
+     *  read directly here — everything else the panel shows comes from
+     *  `highlights`/`activity`, the consumer's own data. */
+    record: (Row & {
+        name?: string;
+    }) | null;
+    /** Heading above the highlight cards (default "Highlights"). Omit the
+     *  whole section by omitting `highlights`. */
+    highlightsLabel?: React.ReactNode;
+    /**
+     * Highlight cards — label, value, optional icon (#448). Attio's own peek
+     * shows these as a fixed set of business-pipeline stats (Connection
+     * strength, Estimated ARR, …); crisp has no such fixed set, so this is
+     * fully consumer-supplied, laid out in Attio's own measured 2-column
+     * grid. Omit for no Highlights section at all.
+     */
+    highlights?: RecordPanelHighlight[];
+    /** Heading above the activity feed (default "Activity"). */
+    activityLabel?: React.ReactNode;
+    /** Label for the trailing "View all" action beside the Activity heading.
+     *  Only rendered when `onViewAllActivity` is given. */
+    viewAllActivityLabel?: React.ReactNode;
+    onViewAllActivity?: () => void;
+    /**
+     * Activity feed content (#448) — a consumer-supplied slot. crisp has no
+     * activity-feed model of its own (no fixed shape for "who did what,
+     * when" — that's app data); this only wraps whatever's given with the
+     * measured "Activity" heading Attio's peek shows above its own feed. Omit
+     * for no Activity section at all.
+     */
+    activity?: React.ReactNode;
+    /** Rendered below the panel's content, e.g. an Edit button. Omit for no footer. */
     footer?: React.ReactNode;
-    record: Row | null;
-    columns: Column[];
     onClose: () => void;
     className?: string;
 };
 /**
- * Right-side record peek panel — shows one record's fields, opened from a
- * RecordsTable row (via `onOpenRecord`). Render it inside a `position:
- * relative` container (e.g. the app main area); it slides in from the right and
- * overlays the content.
+ * Right-side record peek panel — Attio's own peek shows a Highlights card
+ * area and an Activity feed (measured live: hover a Companies row, click its
+ * "Open preview" trigger), never an editable field list (#448 — a "Details"
+ * list was this component's own invention before, and #431's editable API
+ * had nothing real in this panel to attach to; that API stays on
+ * `RecordPage`'s own Details column, where Attio does let you edit in
+ * place). Render it inside a `position: relative` container (e.g. the app
+ * main area); it slides in from the right and overlays the content.
  */
-export declare function RecordPanel({ record, columns, onClose, className, closeLabel, title, detailsLabel, emptyLabel, footer, ...rest }: RecordPanelProps): React.JSX.Element | null;
+export declare function RecordPanel({ record, onClose, className, closeLabel, onOpenRecord, openRecordLabel, onPrevious, previousRecordLabel, onNext, nextRecordLabel, title, avatar, avatarTone, highlightsLabel, highlights, activityLabel, viewAllActivityLabel, onViewAllActivity, activity, footer, ...rest }: RecordPanelProps): React.JSX.Element | null;
 export declare namespace RecordPanel {
     var displayName: string;
 }
+export {};

package/dist/types/product/recordstable/editable-field.d.ts

@@ -0,0 +1,48 @@
+/** A `select`-editor field's choices — same shape DataTable's own
+ * `DataEditableOption` uses (#385/#430), kept as its own type (not
+ * `Column.options`/`StatusOption`, whose `color` is required for the
+ * `status` picker) so this stays purely additive. */
+export type EditableOption = {
+    value: string;
+    label: string;
+    color?: string;
+};
+/**
+ * The async-commit state machine behind `RecordPage`'s editable Details
+ * column (#431) — the same shape `DataTable`'s own `commitEdit` uses
+ * (#385/#430): a sync `onEdit` (returns `undefined`) commits and closes
+ * immediately; a Promise-returning `onEdit` keeps the field open and pending
+ * while it settles, then either closes it (resolve) or closes it AND
+ * reverts while showing the rejection's message (reject). The revert needs
+ * no extra code here either: `RecordPage` never mutates `record` itself, so
+ * once `editingKey` clears, the field simply renders `record[key]` again —
+ * whatever it still says.
+ *
+ * `RecordPanel` (the peek panel) used to share this hook too, before #448
+ * found that Attio's own peek has no editable field at all to attach it to
+ * — only `RecordPage`'s Details column does. Kept as its own module rather
+ * than folded back into `recordpage.tsx`: a second consumer turning up
+ * again is a smaller change than re-extracting it would be.
+ */
+export declare function useEditableField(onEdit?: (id: string, key: string, value: string) => Promise<void> | void): {
+    editingKey: string | null;
+    pendingKey: string | null;
+    error: {
+        key: string;
+        message: string;
+    } | null;
+    openEditing: (key: string) => void;
+    closeEditing: () => void;
+    commit: (id: string, key: string, value: string) => void;
+};
+/**
+ * Which plain editor a column gets when it's `editable` without an
+ * `editor: "select" | "switch"` — identical to `DataTable`'s own
+ * `editorFor` (#385): number/currency get a numeric field, date a native
+ * date field, everything else (text, entity, tags, url, status, reference)
+ * a plain text field. Kept as one function so the two never drift apart.
+ */
+export declare function editableInputType(colType: string | undefined): {
+    type: string;
+    inputMode?: "decimal" | "text";
+};

package/dist/types/product/recordstable/index.d.ts

@@ -1,2 +1,3 @@
+export { type EditableOption, editableInputType, useEditableField, } from "./editable-field";
 export { type Column, type ColumnType, defaultColumns, defaultRows, type EntityValue, RecordsTable, type RecordsTableProps, type Row, tagTone, } from "./recordstable";
 export { recordstableRecipe } from "./recordstable.recipe";

package/dist/types/product/recordstable/recordstable.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
+import type { EditableOption } from "./editable-field";
 type IconType = React.ComponentType<{
     size?: number;
     strokeWidth?: number;
@@ -29,6 +30,14 @@ export type Column = {
     options?: StatusOption[];
     /** Choices for a `reference` column (a searchable record picker). */
     refOptions?: ReferenceOption[];
+    /** Adds a trailing "Create {createLabel}" row to the picker (Attio's own
+     * always has one) — rendered only when this is provided. Picking it hands
+     * back the picker's current search text, e.g. to open a create flow
+     * pre-seeded with it. */
+    onCreateReference?: (query: string) => void;
+    /** The object noun in "Create {createLabel}" (Attio: "Create Person").
+     * Only used with `onCreateReference`; defaults to "record". */
+    createLabel?: string;
     /**
      * Full custom cell content — an escape hatch for a display crisp can't
      * express via `type` (sign-coloured currency, a maskable amount, a custom
@@ -65,6 +74,26 @@ export type Column = {
      * currency string still sums and sorts numerically.
      */
     format?: (value: unknown, row: Row) => string;
+    /**
+     * Opts this column into `RecordPanel`/`RecordPage`'s editable-field API
+     * (#431) — click-to-edit there (not this table's own type-driven
+     * mechanism, which those two components don't use). Ignored by
+     * `RecordsTable` itself. A plain `editable` column, with no `editor`,
+     * opens a text/number/date field (inferred from `type`, same inference
+     * `DataTable`'s own `editable` columns use — #385); `editor` below picks
+     * a `select`/`switch` picker instead. Both consumers require `onEdit` to
+     * actually be given for a field to open at all.
+     */
+    editable?: boolean;
+    /** `select`/`switch` render as the field's own live, always-interactive
+     * content instead of opening on click — see `DataTableColumn.editor`
+     * (#385) for the identical convention and reasoning. `select` reads
+     * `editOptions`. */
+    editor?: "select" | "switch";
+    /** Options for `editor: "select"` — same shape `DataTable`'s own
+     * `DataEditableOption` uses. Not `options` (`StatusOption` requires
+     * `color`, for this type's own `status` picker) so this stays additive. */
+    editOptions?: EditableOption[];
 };
 export type EntityValue = {
     name: string;

package/dist/types/product/recordstable/recordstable.tag.d.ts

@@ -3,8 +3,13 @@
  * `border-radius: ${c.radius.chip}`, 14px/20px at weight 500, and a 1px inset ring in the
  * tone's colour.
  *
- * Shared because RecordsTable and RecordPanel render the *same* chip. It used
- * to be pasted into both recipes, and the two copies had already started to
- * drift — adding the measured inset ring meant patching the same rules twice.
+ * Its own module (not pasted into `recordstable.recipe.ts`) because it used
+ * to be shared with `RecordPanel`'s own Details field list too, and the two
+ * copies had already started to drift before that sharing existed — adding
+ * the measured inset ring meant patching the same rules twice. `RecordPanel`
+ * no longer renders a Details list (#448, Attio's own peek doesn't have
+ * one), so `RecordsTable` is this module's only consumer now; kept as its
+ * own file rather than folded back in, since a second consumer showing up
+ * again is exactly how the drift happened the first time.
  */
 export declare const recordTagCss: string;

package/dist/types/product/richtext/index.d.ts

@@ -1,2 +1,2 @@
-export { RichTextEditor, type RichTextEditorProps, type RichTextValue, } from "./richtext";
+export { RICHTEXT_COLOR_TONES, type RichTextColorTone, RichTextEditor, type RichTextEditorHandle, type RichTextEditorProps, type RichTextMention, type RichTextMentionTriggerState, type RichTextValue, } from "./richtext";
 export { richtextRecipe } from "./richtext.recipe";

package/dist/types/product/richtext/richtext.d.ts

@@ -1,8 +1,49 @@
 import * as React from "react";
+import { type MentionAnchor } from "../../core";
 export type RichTextValue = {
     title: string;
     html: string;
 };
+/**
+ * A named text-color / highlight-color pair — the 12 tones Attio's own note
+ * editor offers as inline marks (measured live, read-only, 2026-09-24;
+ * re-verified against the same note before shipping — see HANDOFF). Exported
+ * so a consumer wanting the same palette elsewhere (a tag picker, a legend)
+ * doesn't have to re-type it.
+ */
+export type RichTextColorTone = {
+    id: string;
+    label: string;
+    /** Value passed to `execCommand("foreColor", …)`. */
+    text: string;
+    /** Value passed to `execCommand("hiliteColor", …)`. */
+    highlight: string;
+};
+export declare const RICHTEXT_COLOR_TONES: RichTextColorTone[];
+/** A reference to insert as an atomic mention chip (#428). */
+export type RichTextMention = {
+    id: string;
+    label: string;
+};
+/** State handed to `renderMentionPicker` each time it's asked to show. */
+export type RichTextMentionTriggerState = {
+    /** Text typed after the trigger character so far. */
+    query: string;
+    /** Where to anchor the picker, in viewport coordinates. */
+    anchor: MentionAnchor;
+    /** Insert `mention` as a chip in place of the "@query" text, and dismiss. */
+    select: (mention: RichTextMention) => void;
+    /** Dismiss without inserting anything — e.g. on Escape or an outside click. */
+    close: () => void;
+};
+export type RichTextEditorHandle = {
+    /** Insert `mention` as an atomic, non-editable chip — in place of the
+     * active "@query" trigger text when one is open, otherwise at the current
+     * caret (or the end of the body, with no caret in it at all). */
+    insertMention: (mention: RichTextMention) => void;
+    /** Focus the body editor. */
+    focus: () => void;
+};
 export type RichTextEditorProps = Omit<React.ComponentPropsWithoutRef<"div">, "children" | "onChange" | "placeholder"> & {
     /** Accessible name for the title field. */
     titleLabel?: string;
@@ -10,21 +51,141 @@ export type RichTextEditorProps = Omit<React.ComponentPropsWithoutRef<"div">, "c
     bodyLabel?: string;
     /** Message shown when asking for a link URL. */
     linkPromptLabel?: string;
+    /** Message shown when asking for an image URL. Attio uploads a file
+     * through its own storage; crisp is dependency-free, so this follows the
+     * same `window.prompt` pattern as `linkPromptLabel` rather than inventing
+     * an upload pipeline. */
+    imagePromptLabel?: string;
+    /** The text-color picker's trigger button — its visible label and
+     * accessible name (default "Text", matching Attio's own copy). */
+    textColorLabel?: string;
+    /** The highlight-color picker's trigger button (default "Highlight"). */
+    highlightColorLabel?: string;
+    /** aria-label for each picker's "clear" swatch. */
+    clearColorLabel?: string;
+    /** The block-type toolbar button — visible label and accessible name
+     * (default "Body", matching Attio's own copy for the current-block
+     * indicator, even though the seven choices behind it include far more
+     * than "Body"). */
+    blockMenuLabel?: string;
+    /** Placeholder for the block menu's search field, shown when it's opened
+     * from the toolbar (default "Search items…", matching Attio's own copy). */
+    blockMenuSearchPlaceholder?: string;
+    /** Shown when the search field matches nothing. */
+    blockMenuEmptyLabel?: string;
+    /** Character that opens the mention picker. Default `"@"`. */
+    mentionTrigger?: string;
+    /** Renders a consumer-supplied picker anchored at the caret when
+     * `mentionTrigger` is typed (#372, #428). crisp detects the trigger,
+     * measures where it sits, and inserts whatever is picked — the picker
+     * itself (avatars, grouping, a "create new" row) is the caller's, since
+     * that varies too much by app to have one measured shape. */
+    renderMentionPicker?: (state: RichTextMentionTriggerState) => React.ReactNode;
     defaultTitle?: string;
     /** Initial body HTML. */
     defaultHtml?: string;
     titlePlaceholder?: string;
     placeholder?: string;
     onChange?: (value: RichTextValue) => void;
+    /** Renders both fields as read-only — Attio's own note preview (the
+     * sidebar list, a record's Notes tab) is the SAME editor with
+     * `contentEditable` toggled off, not a separate stripped-text summary, so
+     * headings/lists/marks all survive into it. No toolbar renders in this
+     * mode. */
+    readOnly?: boolean;
     className?: string;
 };
 /**
- * A block rich-text editor — measured from a notes editor. A large title,
- * a prose body (headings, lists, quote, marks, links), and a floating toolbar
- * that appears over a text selection. Built on contentEditable, dependency-free.
+ * A block rich-text editor — measured from Attio's own notes editor. A large
+ * title, a prose body (h1/h2/h3, bulleted/numbered lists, an image block,
+ * marks), a floating selection toolbar, a searchable block-type menu, and a
+ * caret-anchored mention trigger. Built on contentEditable, dependency-free.
  * Uncontrolled: seed with `defaultTitle`/`defaultHtml`, read via `onChange`.
+ * Imperative actions (`insertMention`, `focus`) go through a ref handle
+ * rather than a new prop each — the rest of the surface stays uncontrolled.
+ *
+ * **No underline, no inline code, no blockquote** — all three confirmed
+ * absent from Attio's live toolbar (7 controls) and its exhaustive 7-item
+ * block-type menu; the generic baseline this component used to ship
+ * overshot Attio on all three. `.crisp-rte-body blockquote` still renders
+ * correctly for content pasted in from elsewhere — only the control for it
+ * is gone.
+ *
+ * **The block menu's own chrome (356px, radius 12px, `elevation.floating`,
+ * a "Search items…" input, 7 rows at 52px with a 16px icon) was measured
+ * through the in-editor "Insert" button, not the toolbar's "Body ▾".**
+ * Clicking "Body ▾" itself was tried repeatedly, with both synthetic and
+ * real CDP-dispatched trusted clicks, single- and multi-step sessions, and
+ * consistently closed the ENTIRE note a fraction of a second after opening
+ * something (confirmed via a 0/50/150/400ms readback: the toolbar portal was
+ * still there at +50ms, everything was gone by +150ms) — a nested-popover
+ * dismissable-layer interaction synthetic input in this environment could
+ * not reliably drive. The Insert button opens the identical shape ("The
+ * same-shaped popover... is also what opens from the 'Body' button" — the
+ * source measurement's own finding, and Insert's own DOM confirms the exact
+ * same `role="dialog"`/search-input/`role="option"` structure), so the
+ * chrome below is that measurement, reused for both entry points. What's
+ * NOT independently confirmed is "Body ▾"'s own anchor side — Insert opens
+ * `data-side="right"` (it sits at the end of a line, with no room below);
+ * the toolbar sits at the TOP of the selection, so this component opens the
+ * menu below it, a reasoned default rather than a reading. The `/`-in-body
+ * trigger, and the "@" mention trigger, both anchor at the caret and do not
+ * steal focus from the body — the toolbar's own "Body ▾" click DOES focus a
+ * real search input, since there's no in-document query to read a filter
+ * from until one exists.
+ *
+ * Not built: Attio's own separate "Insert" trigger button (a third way to
+ * reach the identical menu, sitting at the end of the body's last line) —
+ * only the two entry points #426 asked for.
  */
-export declare function RichTextEditor({ defaultTitle, defaultHtml, titlePlaceholder, placeholder, onChange, className, titleLabel, bodyLabel, linkPromptLabel, ...rest }: RichTextEditorProps): React.JSX.Element;
-export declare namespace RichTextEditor {
-    var displayName: string;
-}
+export declare const RichTextEditor: React.ForwardRefExoticComponent<Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "onChange" | "placeholder"> & {
+    /** Accessible name for the title field. */
+    titleLabel?: string;
+    /** Accessible name for the body editor. */
+    bodyLabel?: string;
+    /** Message shown when asking for a link URL. */
+    linkPromptLabel?: string;
+    /** Message shown when asking for an image URL. Attio uploads a file
+     * through its own storage; crisp is dependency-free, so this follows the
+     * same `window.prompt` pattern as `linkPromptLabel` rather than inventing
+     * an upload pipeline. */
+    imagePromptLabel?: string;
+    /** The text-color picker's trigger button — its visible label and
+     * accessible name (default "Text", matching Attio's own copy). */
+    textColorLabel?: string;
+    /** The highlight-color picker's trigger button (default "Highlight"). */
+    highlightColorLabel?: string;
+    /** aria-label for each picker's "clear" swatch. */
+    clearColorLabel?: string;
+    /** The block-type toolbar button — visible label and accessible name
+     * (default "Body", matching Attio's own copy for the current-block
+     * indicator, even though the seven choices behind it include far more
+     * than "Body"). */
+    blockMenuLabel?: string;
+    /** Placeholder for the block menu's search field, shown when it's opened
+     * from the toolbar (default "Search items…", matching Attio's own copy). */
+    blockMenuSearchPlaceholder?: string;
+    /** Shown when the search field matches nothing. */
+    blockMenuEmptyLabel?: string;
+    /** Character that opens the mention picker. Default `"@"`. */
+    mentionTrigger?: string;
+    /** Renders a consumer-supplied picker anchored at the caret when
+     * `mentionTrigger` is typed (#372, #428). crisp detects the trigger,
+     * measures where it sits, and inserts whatever is picked — the picker
+     * itself (avatars, grouping, a "create new" row) is the caller's, since
+     * that varies too much by app to have one measured shape. */
+    renderMentionPicker?: (state: RichTextMentionTriggerState) => React.ReactNode;
+    defaultTitle?: string;
+    /** Initial body HTML. */
+    defaultHtml?: string;
+    titlePlaceholder?: string;
+    placeholder?: string;
+    onChange?: (value: RichTextValue) => void;
+    /** Renders both fields as read-only — Attio's own note preview (the
+     * sidebar list, a record's Notes tab) is the SAME editor with
+     * `contentEditable` toggled off, not a separate stripped-text summary, so
+     * headings/lists/marks all survive into it. No toolbar renders in this
+     * mode. */
+    readOnly?: boolean;
+    className?: string;
+} & React.RefAttributes<RichTextEditorHandle>>;

package/dist/types/product/sidebar/sidebar.d.ts

@@ -11,6 +11,14 @@ export type SidebarNavItem = {
     icon: React.ComponentType<IconProps>;
     active?: boolean;
     trailing?: React.ReactNode;
+    /** Either this or `onSelect` — a plain link, or a handler for anything
+     * that isn't real navigation. Both may be set; neither is required to
+     * make the row *something* clickable (it still renders as a link,
+     * defaulting `href` to "#"). Same shape as a `groups` row's
+     * `SidebarNavGroupItem` (#384) — `items` is the only place that used to
+     * be missing this wiring. */
+    href?: string;
+    onSelect?: () => void;
 };
 /** A row in the Records section — rendered as a tinted 20px glyph avatar. */
 export type SidebarRecordItem = {
@@ -96,6 +104,20 @@ export type SidebarProps = React.ComponentPropsWithoutRef<"nav"> & {
     onToggleCollapse?: () => void;
     /** Workspace switcher content. Defaults to the measured workspace. */
     workspace?: SidebarWorkspace;
+    /**
+     * Menu content for the workspace switcher — `MenuItem`/`MenuSeparator`/
+     * `MenuLabel` children, the same as a consumer would give `Menu` directly.
+     * Omit to leave the switcher a plain (still real, focusable) button with
+     * no popup, as before. When given, the switcher becomes a real menu
+     * trigger (`aria-haspopup="menu"`, `aria-expanded`, keyboard-openable —
+     * rents `Menu`'s own machine, no new one) that opens it — router-agnostic
+     * and consistent with the nav API (#384): a `MenuItem`'s own `onSelect` is
+     * how a consumer reaches its own navigation, the same as a nav row's
+     * (#415: Attio's switcher opens "Account settings" / "Workspace settings",
+     * among others — crisp ships no fixed items of its own, since which
+     * settings exist is entirely the consumer's).
+     */
+    workspaceMenu?: React.ReactNode;
     /** Main nav rows (Home, Tasks, …). Defaults to the measured nav. */
     items?: SidebarNavItem[];
     /** The Records section (label + glyph-avatar rows). */
@@ -114,8 +136,18 @@ export type SidebarProps = React.ComponentPropsWithoutRef<"nav"> & {
      * renders exactly as before this prop existed.
      */
     groups?: SidebarNavGroup[];
-    /** Footer copy (onboarding pill, invite row, trial banner). */
-    footer?: SidebarFooter;
+    /**
+     * The footer slot. Defaults to Attio's own onboarding pill + invite row +
+     * trial banner (`ATTIO_SIDEBAR_FOOTER`). Pass a `SidebarFooter` object to
+     * override just the strings in that fixed shape (as before), any other
+     * `ReactNode` — an account/user menu, say — to replace the slot's content
+     * entirely (still pinned to the bottom of the nav), or `false` to render
+     * no footer at all so a consumer can compose their own element directly
+     * below `<Sidebar>` instead (#408: GRC has no onboarding checklist, no
+     * invite flow and no trial banner, so none of the fixed copy had anything
+     * real to say, and there was no way to put a real account menu here).
+     */
+    footer?: SidebarFooter | React.ReactNode;
     /**
      * Command-palette items, forwarded to the internal `Command`'s own
      * `items` prop. Omit for Command's built-in Attio set (#364: GRC's
@@ -162,6 +194,20 @@ export declare const Sidebar: React.ForwardRefExoticComponent<Omit<React.Detaile
     onToggleCollapse?: () => void;
     /** Workspace switcher content. Defaults to the measured workspace. */
     workspace?: SidebarWorkspace;
+    /**
+     * Menu content for the workspace switcher — `MenuItem`/`MenuSeparator`/
+     * `MenuLabel` children, the same as a consumer would give `Menu` directly.
+     * Omit to leave the switcher a plain (still real, focusable) button with
+     * no popup, as before. When given, the switcher becomes a real menu
+     * trigger (`aria-haspopup="menu"`, `aria-expanded`, keyboard-openable —
+     * rents `Menu`'s own machine, no new one) that opens it — router-agnostic
+     * and consistent with the nav API (#384): a `MenuItem`'s own `onSelect` is
+     * how a consumer reaches its own navigation, the same as a nav row's
+     * (#415: Attio's switcher opens "Account settings" / "Workspace settings",
+     * among others — crisp ships no fixed items of its own, since which
+     * settings exist is entirely the consumer's).
+     */
+    workspaceMenu?: React.ReactNode;
     /** Main nav rows (Home, Tasks, …). Defaults to the measured nav. */
     items?: SidebarNavItem[];
     /** The Records section (label + glyph-avatar rows). */
@@ -180,8 +226,18 @@ export declare const Sidebar: React.ForwardRefExoticComponent<Omit<React.Detaile
      * renders exactly as before this prop existed.
      */
     groups?: SidebarNavGroup[];
-    /** Footer copy (onboarding pill, invite row, trial banner). */
-    footer?: SidebarFooter;
+    /**
+     * The footer slot. Defaults to Attio's own onboarding pill + invite row +
+     * trial banner (`ATTIO_SIDEBAR_FOOTER`). Pass a `SidebarFooter` object to
+     * override just the strings in that fixed shape (as before), any other
+     * `ReactNode` — an account/user menu, say — to replace the slot's content
+     * entirely (still pinned to the bottom of the nav), or `false` to render
+     * no footer at all so a consumer can compose their own element directly
+     * below `<Sidebar>` instead (#408: GRC has no onboarding checklist, no
+     * invite flow and no trial banner, so none of the fixed copy had anything
+     * real to say, and there was no way to put a real account menu here).
+     */
+    footer?: SidebarFooter | React.ReactNode;
     /**
      * Command-palette items, forwarded to the internal `Command`'s own
      * `items` prop. Omit for Command's built-in Attio set (#364: GRC's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crisp-ui-kit/crisp",
-  "version": "0.50.0",
+  "version": "0.52.0",
   "description": "A lean React design system, measured pixel-for-pixel from Attio.",
   "license": "MIT",
   "type": "module",
@@ -98,6 +98,11 @@
       "import": "./dist/esm/components/columncalc/index.js",
       "require": "./dist/cjs/components/columncalc/index.js"
     },
+    "./composewindow": {
+      "types": "./dist/types/components/composewindow/index.d.ts",
+      "import": "./dist/esm/components/composewindow/index.js",
+      "require": "./dist/cjs/components/composewindow/index.js"
+    },
     "./contextmenu": {
       "types": "./dist/types/components/contextmenu/index.d.ts",
       "import": "./dist/esm/components/contextmenu/index.js",