@stcn52/pro 0.0.0-stage → 0.2.1

package/docs/api.md

@@ -0,0 +1,3669 @@
+# API reference
+
+<!-- Generated by `pnpm gen:docs` from the source. Do not edit by hand. -->
+
+Every runtime export of `@stcn52/pro`, with the props table of its props type.
+Descriptions are the JSDoc the component carries in `src/` — the same text a
+caller sees in their editor, which is why this file is generated rather than
+written: it cannot drift from the code it documents.
+
+## Components
+
+<sub>`src/components/ActionButton.tsx`</sub>
+
+### `ActionButton`
+
+The bare icon button PingCode uses throughout chrome, toolbars and rows.
+
+Also accepts: `ButtonHTMLAttributes<HTMLButtonElement>`.
+
+| Prop        | Type                    | Notes                               |
+| ----------- | ----------------------- | ----------------------------------- |
+| `active?`   | `boolean`               |                                     |
+| `children?` | `ReactNode`             |                                     |
+| `icon`      | `IconName \| string`    |                                     |
+| `label`     | `string`                | Required: the control is icon-only. |
+| `loading?`  | `boolean`               |                                     |
+| `size?`     | `'sm' \| 'md' \| 'lg'`  |                                     |
+| `tone?`     | `'default' \| 'accent'` |                                     |
+
+<sub>`src/components/Affix.tsx`</sub>
+
+### `Affix`
+
+Preserve layout while fixing the same child DOM to a scrolling viewport edge.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>`.
+
+| Prop            | Type                                  | Notes |
+| --------------- | ------------------------------------- | ----- |
+| `children`      | `ReactNode`                           |       |
+| `offsetBottom?` | `number`                              |       |
+| `offsetTop?`    | `number`                              |       |
+| `onChange?`     | `(affixed: boolean) => void`          |       |
+| `target?`       | `() => Window \| HTMLElement \| null` |       |
+
+<sub>`src/components/AiPanel.tsx`</sub>
+
+### `AiMessage`
+
+One line of the transcript.
+
+_Type._
+
+### `AiPanel`
+
+Ping — the AI assistant side panel captured from PingCode's workbench.
+
+| Prop                | Type             | Notes                                                                                                                                                                      |
+| ------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `'aria-label'?`     | `string`         |                                                                                                                                                                            |
+| `className?`        | `string`         |                                                                                                                                                                            |
+| `disabled?`         | `boolean`        |                                                                                                                                                                            |
+| `error?`            | `ReactNode`      |                                                                                                                                                                            |
+| `greeting?`         | `ReactNode`      | Card at the top of the scroll body. Defaults to a short welcome line.                                                                                                      |
+| `inputPlaceholder?` | `string`         |                                                                                                                                                                            |
+| `messages?`         | `AiMessage[]`    |                                                                                                                                                                            |
+| `open`              | `boolean`        |                                                                                                                                                                            |
+| `pending?`          | `boolean`        | Host-driven "thinking" state. The panel never invents a reply: it only echoes the transcript the host hands it and, while `pending` is true, shows a labelled waiting row. |
+| `quickChips?`       | `AiQuickChip[]`  |                                                                                                                                                                            |
+| `suggestions?`      | `AiSuggestion[]` |                                                                                                                                                                            |
+| `title?`            | `string`         | Header title beside the product mark.                                                                                                                                      |
+
+### `AiQuickChip`
+
+_Type._
+
+### `AiSuggestion`
+
+One starter prompt under "Try asking me".
+
+_Type._
+
+### `PingMark`
+
+PingCode's Ping mark: the coral + accent pair of rounded blades that the live product renders in the panel header, the floating trigger and the 16px product glyphs.
+
+| Prop         | Type     | Notes |
+| ------------ | -------- | ----- |
+| `className?` | `string` |       |
+| `size?`      | `number` |       |
+
+<sub>`src/components/Alert.tsx`</sub>
+
+### `Alert`
+
+Persistent inline feedback; errors interrupt, other messages announce politely.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'title'>`.
+
+| Prop            | Type                                                                                                                                    | Notes                                                                           |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| `action?`       | `ReactNode`                                                                                                                             |                                                                                 |
+| `afterClose?`   | `() => void`                                                                                                                            | Runs after removal, including a controlled close; no exit animation is applied. |
+| `banner?`       | `boolean`                                                                                                                               |                                                                                 |
+| `closable?`     | `\| boolean \| { closeIcon?: ReactNode; disabled?: boolean; onClose?: MouseEventHandler<HTMLButtonElement>; afterClose?: () => void; }` |                                                                                 |
+| `closeLabel?`   | `string`                                                                                                                                |                                                                                 |
+| `defaultOpen?`  | `boolean`                                                                                                                               |                                                                                 |
+| `description?`  | `ReactNode`                                                                                                                             |                                                                                 |
+| `icon?`         | `ReactNode`                                                                                                                             |                                                                                 |
+| `message?`      | `ReactNode`                                                                                                                             |                                                                                 |
+| `onClose?`      | `() => void`                                                                                                                            |                                                                                 |
+| `onOpenChange?` | `(open: boolean) => void`                                                                                                               |                                                                                 |
+| `open?`         | `boolean`                                                                                                                               |                                                                                 |
+| `showIcon?`     | `boolean`                                                                                                                               |                                                                                 |
+| `title?`        | `ReactNode`                                                                                                                             |                                                                                 |
+| `type?`         | `'info' \| 'success' \| 'warning' \| 'error'`                                                                                           |                                                                                 |
+| `variant?`      | `'outlined' \| 'filled'`                                                                                                                |                                                                                 |
+
+<sub>`src/components/Anchor.tsx`</sub>
+
+### `Anchor`
+
+Same-page navigation with native links, scroll observation and safe ID lookup.
+
+Also accepts: `Omit<HTMLAttributes<HTMLElement>, 'onChange' | 'onClick' | 'children'>`.
+
+| Prop                | Type                                                               | Notes |
+| ------------------- | ------------------------------------------------------------------ | ----- |
+| `affix?`            | `boolean`                                                          |       |
+| `bounds?`           | `number`                                                           |       |
+| `direction?`        | `'vertical' \| 'horizontal'`                                       |       |
+| `disabled?`         | `boolean`                                                          |       |
+| `getContainer?`     | `() => Window \| HTMLElement \| null`                              |       |
+| `getCurrentAnchor?` | `(active: string) => string`                                       |       |
+| `items?`            | `AnchorItem[]`                                                     |       |
+| `offsetTop?`        | `number`                                                           |       |
+| `onChange?`         | `(href: string) => void`                                           |       |
+| `onClick?`          | `(event: MouseEvent<HTMLAnchorElement>, item: AnchorItem) => void` |       |
+| `replace?`          | `boolean`                                                          |       |
+| `targetOffset?`     | `number`                                                           |       |
+
+<sub>`src/components/App.tsx`</sub>
+
+### `App`
+
+| Prop            | Type                                           | Notes |
+| --------------- | ---------------------------------------------- | ----- |
+| `children`      | `ReactNode`                                    |       |
+| `message?`      | `{ placement?: ToastPlacement; max?: number }` |       |
+| `notification?` | `{ placement?: ToastPlacement; max?: number }` |       |
+
+<sub>`src/components/AutoComplete.tsx`</sub>
+
+### `AutoComplete`
+
+Editable suggestions; input focus is retained while navigating the listbox.
+
+Also accepts: `Omit<InputProps, 'value' | 'defaultValue' | 'onChange'>`.
+
+| Prop            | Type                                                                  | Notes |
+| --------------- | --------------------------------------------------------------------- | ----- |
+| `defaultOpen?`  | `boolean`                                                             |       |
+| `defaultValue?` | `string`                                                              |       |
+| `filterOption?` | `boolean \| ((input: string, option: AutoCompleteOption) => boolean)` |       |
+| `onChange?`     | `(value: string) => void`                                             |       |
+| `onOpenChange?` | `(open: boolean) => void`                                             |       |
+| `onSearch?`     | `(value: string) => void`                                             |       |
+| `onSelect?`     | `(value: string, option: AutoCompleteOption) => void`                 |       |
+| `open?`         | `boolean`                                                             |       |
+| `options?`      | `AutoCompleteOption[]`                                                |       |
+| `value?`        | `string`                                                              |       |
+
+### `AutoCompleteOption`
+
+_Type._
+
+<sub>`src/components/Avatar.tsx`</sub>
+
+### `Avatar`
+
+Also accepts: `Omit<HTMLAttributes<HTMLSpanElement>, 'onError'>`.
+
+| Prop           | Type                                                 | Notes |
+| -------------- | ---------------------------------------------------- | ----- |
+| `alt?`         | `string`                                             |       |
+| `className?`   | `string`                                             |       |
+| `crossOrigin?` | `ImgHTMLAttributes<HTMLImageElement>['crossOrigin']` |       |
+| `gap?`         | `number`                                             |       |
+| `icon?`        | `ReactNode`                                          |       |
+| `loading?`     | `ImgHTMLAttributes<HTMLImageElement>['loading']`     |       |
+| `name?`        | `string`                                             |       |
+| `onError?`     | `() => boolean \| void`                              |       |
+| `shape?`       | `'circle' \| 'square'`                               |       |
+| `size?`        | `'xs' \| 'sm' \| 'md' \| 'lg' \| number`             |       |
+| `src?`         | `string`                                             |       |
+| `srcSet?`      | `string`                                             |       |
+| `title?`       | `string`                                             |       |
+
+### `avatarColor`
+
+_No props type — see the source._
+
+### `AvatarPlaceholder`
+
+The dashed add-assignee circle, with native button attributes and global disabled state.
+
+Also accepts: `ButtonHTMLAttributes<HTMLButtonElement>`.
+
+| Prop    | Type     | Notes |
+| ------- | -------- | ----- |
+| `label` | `string` |       |
+
+### `AvatarStack`
+
+| Prop            | Type                                    | Notes |
+| --------------- | --------------------------------------- | ----- |
+| `'aria-label'?` | `string`                                |       |
+| `className?`    | `string`                                |       |
+| `max?`          | `number`                                |       |
+| `people`        | `Array<{ name: string; src?: string }>` |       |
+| `shape?`        | `AvatarProps['shape']`                  |       |
+| `size?`         | `AvatarProps['size']`                   |       |
+
+### `IconAvatar`
+
+The avatar shell carrying a glyph instead of initials — the grid's leading mark for a row whose title belongs to a kind of record (the live Customer grid opens each name with a filled circle holding its department mark).
+
+Also accepts: `HTMLAttributes<HTMLSpanElement>`.
+
+| Prop     | Type                  | Notes                                                                     |
+| -------- | --------------------- | ------------------------------------------------------------------------- |
+| `icon`   | `IconName \| string`  |                                                                           |
+| `label?` | `string`              | Exposed to assistive tech only when the glyph carries meaning of its own. |
+| `size?`  | `AvatarProps['size']` |                                                                           |
+| `tone?`  | `'accent' \| 'muted'` |                                                                           |
+
+### `initials`
+
+_No props type — see the source._
+
+<sub>`src/components/Badge.tsx`</sub>
+
+### `Badge`
+
+Also accepts: `Omit<HTMLAttributes<HTMLSpanElement>, 'title'>`.
+
+| Prop             | Type                                                             | Notes                                                                    |
+| ---------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| `color?`         | `string`                                                         |                                                                          |
+| `count?`         | `ReactNode`                                                      |                                                                          |
+| `dot?`           | `boolean`                                                        |                                                                          |
+| `label?`         | `string`                                                         | Accessible description; count badges default to the full count.          |
+| `offset?`        | `[number, number]`                                               | Horizontal and vertical pixel offsets; horizontal is logical inline-end. |
+| `overflowCount?` | `number`                                                         |                                                                          |
+| `showZero?`      | `boolean`                                                        |                                                                          |
+| `size?`          | `'sm' \| 'md'`                                                   |                                                                          |
+| `status?`        | `'success' \| 'processing' \| 'default' \| 'error' \| 'warning'` |                                                                          |
+| `text?`          | `ReactNode`                                                      |                                                                          |
+| `title?`         | `string \| null \| false`                                        |                                                                          |
+
+<sub>`src/components/BorderBeam.tsx`</sub>
+
+### `BorderBeam`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'color'>`.
+
+| Prop         | Type              | Notes |
+| ------------ | ----------------- | ----- |
+| `color?`     | `BorderBeamColor` |       |
+| `count?`     | `number`          |       |
+| `duration?`  | `number`          |       |
+| `lineWidth?` | `number`          |       |
+| `outset?`    | `number`          |       |
+| `size?`      | `number`          |       |
+
+### `BorderBeamColor`
+
+_Type._
+
+<sub>`src/components/Breadcrumb.tsx`</sub>
+
+### `Breadcrumb`
+
+Semantic navigation trail; links remain native and the last item marks the current page.
+
+Also accepts: `Omit<HTMLAttributes<HTMLElement>, 'children'>`.
+
+| Prop          | Type                                                                          | Notes |
+| ------------- | ----------------------------------------------------------------------------- | ----- |
+| `itemRender?` | `(item: BreadcrumbItem, index: number, items: BreadcrumbItem[]) => ReactNode` |       |
+| `items`       | `BreadcrumbItem[]`                                                            |       |
+| `separator?`  | `ReactNode`                                                                   |       |
+
+### `BreadcrumbItem`
+
+_Type._
+
+<sub>`src/components/Button.tsx`</sub>
+
+### `Button`
+
+Also accepts: `ButtonHTMLAttributes<HTMLButtonElement>`.
+
+| Prop         | Type                               | Notes                                                                    |
+| ------------ | ---------------------------------- | ------------------------------------------------------------------------ |
+| `block?`     | `boolean`                          |                                                                          |
+| `children?`  | `ReactNode`                        |                                                                          |
+| `danger?`    | `boolean`                          |                                                                          |
+| `ghost?`     | `boolean`                          |                                                                          |
+| `icon?`      | `IconName \| string`               |                                                                          |
+| `iconAfter?` | `IconName \| string`               |                                                                          |
+| `loading?`   | `boolean`                          | Toggles a spinner and blocks interaction without losing the label width. |
+| `shape?`     | `'default' \| 'round' \| 'circle'` |                                                                          |
+| `size?`      | `ButtonSize`                       |                                                                          |
+| `variant?`   | `ButtonVariant`                    |                                                                          |
+
+### `ButtonSize`
+
+_Type._
+
+### `ButtonVariant`
+
+_Type._
+
+### `SplitButton`
+
+PingCode fuses the primary action and its "more" caret into one control.
+
+| Prop            | Type                 | Notes                                                                     |
+| --------------- | -------------------- | ------------------------------------------------------------------------- |
+| `className?`    | `string`             |                                                                           |
+| `disabled?`     | `boolean`            |                                                                           |
+| `icon?`         | `IconName \| string` |                                                                           |
+| `label`         | `ReactNode`          |                                                                           |
+| `menuItems?`    | `MenuItemSpec[]`     | Items for the caret menu. Without them the caret only calls onToggleMenu. |
+| `menuLabel`     | `string`             |                                                                           |
+| `menuOpen?`     | `boolean`            |                                                                           |
+| `onPrimary`     | `() => void`         |                                                                           |
+| `onToggleMenu?` | `() => void`         |                                                                           |
+| `size?`         | `ButtonSize`         |                                                                           |
+| `variant?`      | `ButtonVariant`      |                                                                           |
+
+<sub>`src/components/Calendar.tsx`</sub>
+
+### `Calendar`
+
+Standalone event calendar, using the same date contract as DatePicker.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onSelect'>`.
+
+| Prop              | Type                                                                                                                                                  | Notes                                                         |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| `cellRender?`     | `(date: string, info: { type: 'date' \| 'month' }) => ReactNode`                                                                                      |                                                               |
+| `defaultMode?`    | `'month' \| 'year'`                                                                                                                                   |                                                               |
+| `defaultValue?`   | `string`                                                                                                                                              |                                                               |
+| `disabled?`       | `boolean`                                                                                                                                             |                                                               |
+| `disabledDate?`   | `(date: string) => boolean`                                                                                                                           |                                                               |
+| `fullCellRender?` | `(date: string, info: { type: 'date' \| 'month' }) => ReactNode`                                                                                      |                                                               |
+| `fullscreen?`     | `boolean`                                                                                                                                             |                                                               |
+| `headerRender?`   | `(info: { value: string; type: 'month' \| 'year'; onChange: (date: string) => void; onTypeChange: (mode: 'month' \| 'year') => void; }) => ReactNode` |                                                               |
+| `mode?`           | `'month' \| 'year'`                                                                                                                                   |                                                               |
+| `onChange?`       | `(date: string) => void`                                                                                                                              |                                                               |
+| `onPanelChange?`  | `(date: string, mode: 'month' \| 'year') => void`                                                                                                     |                                                               |
+| `onSelect?`       | `(date: string, info: { source: 'date' \| 'month' \| 'year' \| 'customize' }) => void`                                                                |                                                               |
+| `validRange?`     | `[string, string]`                                                                                                                                    |                                                               |
+| `value?`          | `string`                                                                                                                                              | ISO date, shared with DatePicker; no date-library dependency. |
+
+<sub>`src/components/Card.tsx`</sub>
+
+### `Card`
+
+Tabs can be composed in extra/body; Grid and Meta share the card shell's geometry.
+
+Also accepts: `Omit<HTMLAttributes<HTMLElement>, 'title'>`.
+
+| Prop         | Type                         | Notes |
+| ------------ | ---------------------------- | ----- |
+| `actions?`   | `ReactNode[]`                |       |
+| `bordered?`  | `boolean`                    |       |
+| `cover?`     | `ReactNode`                  |       |
+| `extra?`     | `ReactNode`                  |       |
+| `flush?`     | `boolean`                    |       |
+| `hoverable?` | `boolean`                    |       |
+| `loading?`   | `boolean`                    |       |
+| `size?`      | `'medium' \| 'small'`        |       |
+| `title?`     | `ReactNode`                  |       |
+| `type?`      | `'inner'`                    |       |
+| `variant?`   | `'outlined' \| 'borderless'` |       |
+
+### `CardGrid`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop         | Type      | Notes |
+| ------------ | --------- | ----- |
+| `hoverable?` | `boolean` |       |
+
+### `CardMeta`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'title'>`.
+
+| Prop           | Type        | Notes |
+| -------------- | ----------- | ----- |
+| `avatar?`      | `ReactNode` |       |
+| `description?` | `ReactNode` |       |
+| `title?`       | `ReactNode` |       |
+
+### `KeyValue`
+
+Definition list used by the detail panels and the report summaries.
+
+| Prop         | Type             | Notes |
+| ------------ | ---------------- | ----- |
+| `className?` | `string`         |       |
+| `items`      | `KeyValueItem[]` |       |
+
+### `KeyValueItem`
+
+_Type._
+
+### `Metric`
+
+Headline number plus its comparison line — used across the report tab.
+
+| Prop     | Type                 | Notes |
+| -------- | -------------------- | ----- |
+| `delta?` | `ReactNode`          |       |
+| `icon?`  | `IconName \| string` |       |
+| `label`  | `ReactNode`          |       |
+| `trend?` | `StatTrend`          |       |
+| `value`  | `ReactNode`          |       |
+
+### `Progress`
+
+| Prop                 | Type                                                     | Notes                                                                    |
+| -------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------ |
+| `'aria-label'?`      | `string`                                                 |                                                                          |
+| `'aria-labelledby'?` | `string`                                                 |                                                                          |
+| `className?`         | `string`                                                 |                                                                          |
+| `format?`            | `(percent: number, successPercent: number) => ReactNode` |                                                                          |
+| `gapDegree?`         | `number`                                                 |                                                                          |
+| `gapPlacement?`      | `'top' \| 'bottom' \| 'start' \| 'end'`                  |                                                                          |
+| `label?`             | `ReactNode`                                              |                                                                          |
+| `percent?`           | `number`                                                 |                                                                          |
+| `railColor?`         | `string`                                                 |                                                                          |
+| `showInfo?`          | `boolean`                                                |                                                                          |
+| `showValue?`         | `boolean`                                                |                                                                          |
+| `size?`              | `number`                                                 |                                                                          |
+| `status?`            | `'normal' \| 'active' \| 'success' \| 'exception'`       |                                                                          |
+| `steps?`             | `number`                                                 |                                                                          |
+| `strokeColor?`       | `string`                                                 |                                                                          |
+| `strokeLinecap?`     | `'round' \| 'butt' \| 'square'`                          |                                                                          |
+| `strokeWidth?`       | `number`                                                 |                                                                          |
+| `style?`             | `CSSProperties`                                          |                                                                          |
+| `success?`           | `{ percent?: number; strokeColor?: string }`             |                                                                          |
+| `tone?`              | `'accent' \| 'success' \| 'warning' \| 'danger'`         |                                                                          |
+| `type?`              | `'line' \| 'circle' \| 'dashboard'`                      |                                                                          |
+| `value?`             | `number`                                                 | Existing Klun 0–1 contract; takes precedence over percent when supplied. |
+
+### `StatTrend`
+
+_Type._
+
+<sub>`src/components/Carousel.tsx`</sub>
+
+### `Carousel`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children'>`.
+
+| Prop             | Type                                    | Notes |
+| ---------------- | --------------------------------------- | ----- |
+| `afterChange?`   | `(slide: number) => void`               |       |
+| `arrows?`        | `boolean`                               |       |
+| `autoplay?`      | `boolean`                               |       |
+| `autoplaySpeed?` | `number`                                |       |
+| `beforeChange?`  | `(from: number, to: number) => void`    |       |
+| `children`       | `ReactNode`                             |       |
+| `current?`       | `number`                                |       |
+| `disabled?`      | `boolean`                               |       |
+| `dotPlacement?`  | `'top' \| 'bottom' \| 'start' \| 'end'` |       |
+| `dots?`          | `boolean`                               |       |
+| `draggable?`     | `boolean`                               |       |
+| `effect?`        | `'scrollx' \| 'fade'`                   |       |
+| `infinite?`      | `boolean`                               |       |
+| `initialSlide?`  | `number`                                |       |
+| `onChange?`      | `(slide: number) => void`               |       |
+| `speed?`         | `number`                                |       |
+| `vertical?`      | `boolean`                               |       |
+
+### `CarouselRef`
+
+_Type._
+
+<sub>`src/components/Cascader.tsx`</sub>
+
+### `Cascader`
+
+Existing menu selection plus Tree-backed multiple/intermediate/lazy hierarchy.
+
+Also accepts: `Omit< ButtonHTMLAttributes<HTMLButtonElement>, 'value' | 'defaultValue' | 'onChange' | 'children' >`, `( | { multiple?: false; value?: string[]; defaultValue?: string[]; onChange?: (path: string[]) => void } | { multiple: true; value?: string[][]; defaultValue?: string[][]; onChange?: (paths: string[][]) => void } )`.
+
+| Prop                   | Type                                                                                                    | Notes |
+| ---------------------- | ------------------------------------------------------------------------------------------------------- | ----- |
+| `'aria-label'`         | `string`                                                                                                |       |
+| `allowClear?`          | `boolean`                                                                                               |       |
+| `changeOnSelect?`      | `boolean`                                                                                               |       |
+| `defaultOpen?`         | `boolean`                                                                                               |       |
+| `displayRender?`       | `(labels: ReactNode[], selectedOptions: CascaderOption[]) => ReactNode`                                 |       |
+| `fieldNames?`          | `{ value?: string; label?: string; children?: string }`                                                 |       |
+| `filterOption?`        | `(query: string, path: CascaderOption[]) => boolean`                                                    |       |
+| `invalid?`             | `boolean`                                                                                               |       |
+| `loadData?`            | `(selectedOptions: CascaderOption[]) => Promise<CascaderOption[] \| Record<string, unknown>[] \| void>` |       |
+| `loading?`             | `boolean`                                                                                               |       |
+| `notFoundContent?`     | `ReactNode`                                                                                             |       |
+| `onLoadError?`         | `(error: unknown, selectedOptions: CascaderOption[]) => void`                                           |       |
+| `onOpenChange?`        | `(open: boolean) => void`                                                                               |       |
+| `onSearch?`            | `(query: string) => void`                                                                               |       |
+| `open?`                | `boolean`                                                                                               |       |
+| `optionRender?`        | `(option: CascaderOption) => ReactNode`                                                                 |       |
+| `options`              | `CascaderOption[] \| Record<string, unknown>[]`                                                         |       |
+| `placeholder?`         | `string`                                                                                                |       |
+| `searchable?`          | `boolean`                                                                                               |       |
+| `searchValue?`         | `string`                                                                                                |       |
+| `showCheckedStrategy?` | `'SHOW_PARENT' \| 'SHOW_CHILD'`                                                                         |       |
+
+### `CascaderOption`
+
+_Type._
+
+<sub>`src/components/Charts.tsx`</sub>
+
+### `BarChart`
+
+Horizontal-free column chart: values are relative to the largest bucket.
+
+| Prop            | Type           | Notes |
+| --------------- | -------------- | ----- |
+| `'aria-label'?` | `string`       |       |
+| `className?`    | `string`       |       |
+| `data`          | `ChartDatum[]` |       |
+| `height?`       | `number`       |       |
+
+### `ChartDatum`
+
+_Type._
+
+### `CrumbItem`
+
+_Type._
+
+### `Crumbs`
+
+Breadcrumb used above detail pages ("Ship / Example Product / SLC-1").
+
+| Prop         | Type          | Notes |
+| ------------ | ------------- | ----- |
+| `className?` | `string`      |       |
+| `items`      | `CrumbItem[]` |       |
+
+### `Donut`
+
+Donut built from a conic-gradient rather than an SVG path: the segment sizes are data-driven and it stays crisp at any size without a chart dependency.
+
+| Prop            | Type           | Notes |
+| --------------- | -------------- | ----- |
+| `'aria-label'?` | `string`       |       |
+| `centerLabel?`  | `ReactNode`    |       |
+| `centerValue?`  | `ReactNode`    |       |
+| `className?`    | `string`       |       |
+| `data`          | `ChartDatum[]` |       |
+| `size?`         | `number`       |       |
+| `thickness?`    | `number`       |       |
+
+### `ScatterPlot`
+
+Score against effort, drawn as positioned points inside a grid — the Plan matrix.
+
+| Prop            | Type                   | Notes                                                                               |
+| --------------- | ---------------------- | ----------------------------------------------------------------------------------- |
+| `'aria-label'?` | `string`               |                                                                                     |
+| `className?`    | `string`               |                                                                                     |
+| `disabled?`     | `boolean`              |                                                                                     |
+| `emptyState?`   | `ReactNode`            | Shown instead of the plot when there is nothing to place.                           |
+| `extra?`        | `ReactNode`            | Card's right-hand slot: the formula, a legend, a count.                             |
+| `height?`       | `number`               |                                                                                     |
+| `onSelect?`     | `(id: string) => void` | Called with the point id when one is activated. Points are buttons only when given. |
+| `points`        | `ScatterPoint[]`       |                                                                                     |
+| `title?`        | `ReactNode`            |                                                                                     |
+| `xLabel`        | `string`               | Horizontal axis title.                                                              |
+| `yLabel`        | `string`               | Vertical axis title (rotated).                                                      |
+
+### `ScatterPoint`
+
+_Type._
+
+### `Sparkline`
+
+Single-line sparkline for the "trend" widgets in the report tab.
+
+| Prop            | Type       | Notes |
+| --------------- | ---------- | ----- |
+| `'aria-label'?` | `string`   |       |
+| `className?`    | `string`   |       |
+| `data`          | `number[]` |       |
+| `height?`       | `number`   |       |
+| `width?`        | `number`   |       |
+
+<sub>`src/components/Checkbox.tsx`</sub>
+
+### `Checkbox`
+
+Also accepts: `Omit<InputHTMLAttributes<HTMLInputElement>, 'type'>`.
+
+| Prop             | Type        | Notes                                                                     |
+| ---------------- | ----------- | ------------------------------------------------------------------------- |
+| `compact?`       | `boolean`   | Wraps the label in the shared 16px hit-extension used inside table cells. |
+| `indeterminate?` | `boolean`   |                                                                           |
+| `label?`         | `ReactNode` |                                                                           |
+
+<sub>`src/components/CheckboxGroup.tsx`</sub>
+
+### `CheckboxGroup`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>`.
+
+| Prop            | Type                                                                                                                                                                                                           | Notes |
+| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| `'aria-label'`  | `string`                                                                                                                                                                                                       |       |
+| `className?`    | `string`                                                                                                                                                                                                       |       |
+| `defaultValue?` | `string[]`                                                                                                                                                                                                     |       |
+| `disabled?`     | `boolean`                                                                                                                                                                                                      |       |
+| `name?`         | `string`                                                                                                                                                                                                       |       |
+| `onChange?`     | `(value: string[]) => void`                                                                                                                                                                                    |       |
+| `options`       | `Array<{ value: string; label: ReactNode; disabled?: boolean; id?: string; title?: string; required?: boolean; className?: string; style?: CSSProperties; onChange?: ChangeEventHandler<HTMLInputElement>; }>` |       |
+| `orientation?`  | `'horizontal' \| 'vertical'`                                                                                                                                                                                   |       |
+| `value?`        | `string[]`                                                                                                                                                                                                     |       |
+
+<sub>`src/components/Collapse.tsx`</sub>
+
+### `Collapse`
+
+| Prop                 | Type                                                                                                                           | Notes |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----- |
+| `accordion?`         | `boolean`                                                                                                                      |       |
+| `activeKeys?`        | `string[]`                                                                                                                     |       |
+| `bordered?`          | `boolean`                                                                                                                      |       |
+| `className?`         | `string`                                                                                                                       |       |
+| `defaultActiveKeys?` | `string[]`                                                                                                                     |       |
+| `disabled?`          | `boolean`                                                                                                                      |       |
+| `ghost?`             | `boolean`                                                                                                                      |       |
+| `items`              | `Array<{ key: string; label: ReactNode; children: ReactNode; disabled?: boolean; extra?: ReactNode; forceRender?: boolean; }>` |       |
+| `keepMounted?`       | `boolean`                                                                                                                      |       |
+| `onChange?`          | `(keys: string[]) => void`                                                                                                     |       |
+
+<sub>`src/components/ColorPicker.tsx`</sub>
+
+### `ColorGradientStop`
+
+_Type._
+
+### `ColorPicker`
+
+Also accepts: `Omit<ButtonProps, 'value' | 'defaultValue' | 'onChange' | 'children'>`.
+
+| Prop                | Type                                                              | Notes |
+| ------------------- | ----------------------------------------------------------------- | ----- |
+| `allowClear?`       | `boolean`                                                         |       |
+| `children?`         | `ReactNode`                                                       |       |
+| `defaultFormat?`    | `ColorFormat`                                                     |       |
+| `defaultOpen?`      | `boolean`                                                         |       |
+| `defaultValue?`     | `ColorPickerValue`                                                |       |
+| `disabledAlpha?`    | `boolean`                                                         |       |
+| `disabledFormat?`   | `boolean`                                                         |       |
+| `format?`           | `ColorFormat`                                                     |       |
+| `mode?`             | `'single' \| 'gradient' \| ('single' \| 'gradient')[]`            |       |
+| `onChange?`         | `(value: ColorPickerValue) => void`                               |       |
+| `onChangeComplete?` | `(value: ColorPickerValue) => void`                               |       |
+| `onClear?`          | `() => void`                                                      |       |
+| `onFormatChange?`   | `(format: ColorFormat) => void`                                   |       |
+| `onOpenChange?`     | `(open: boolean) => void`                                         |       |
+| `open?`             | `boolean`                                                         |       |
+| `panelRender?`      | `(panel: ReactNode) => ReactNode`                                 |       |
+| `presets?`          | `{ label: ReactNode; colors: string[]; defaultOpen?: boolean }[]` |       |
+| `showText?`         | `boolean \| ((value: ColorPickerValue) => ReactNode)`             |       |
+| `value?`            | `ColorPickerValue`                                                |       |
+
+### `ColorPickerValue`
+
+_Type._
+
+<sub>`src/components/ConfigProvider.tsx`</sub>
+
+### `ConfigProvider`
+
+Nested providers inherit omitted options; explicit control props take precedence.
+
+Also accepts: `Partial<ProConfig>`.
+
+| Prop         | Type        | Notes |
+| ------------ | ----------- | ----- |
+| `children`   | `ReactNode` |       |
+| `className?` | `string`    |       |
+
+### `ProConfig`
+
+_Type._
+
+### `ProTokens`
+
+_Type._
+
+### `useComponentDisabled`
+
+_No props type — see the source._
+
+### `useProConfig`
+
+_No props type — see the source._
+
+<sub>`src/components/ContextMenu.tsx`</sub>
+
+### `ContextMenu`
+
+A right-click menu for any surface.
+
+| Prop            | Type                                                                        | Notes                                                                       |
+| --------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `'aria-label'?` | `string`                                                                    |                                                                             |
+| `children`      | `(props: { onContextMenu: (event: ReactMouseEvent) => void }) => ReactNode` | Render prop; the returned element gets `onContextMenu` wired automatically. |
+| `disabled?`     | `boolean`                                                                   |                                                                             |
+| `items`         | `ContextMenuItem[]`                                                         |                                                                             |
+| `onOpen?`       | `(event: ReactMouseEvent) => void`                                          | Called with the trigger point before opening (use it to set the selection). |
+
+### `ContextMenuItem`
+
+_Type._
+
+### `ContextMenuList`
+
+The menu body, shared by the pointer-anchored context menu and by any click-opened panel (the grid row's ⋯) that wants the same commands.
+
+| Prop            | Type                | Notes                                                                                                                                                                                             |
+| --------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `'aria-label'?` | `string`            |                                                                                                                                                                                                   |
+| `className?`    | `string`            |                                                                                                                                                                                                   |
+| `context?`      | `unknown`           | Handed to every `onSelect`, as the pointer menu does with its own.                                                                                                                                |
+| `disabled?`     | `boolean`           |                                                                                                                                                                                                   |
+| `items`         | `ContextMenuItem[]` |                                                                                                                                                                                                   |
+| `onBack?`       | `() => void`        | Nested lists get this so ← hands focus back to the item that opened them.                                                                                                                         |
+| `onDismiss?`    | `() => void`        | Runs after a leaf command, so the caller can close its own layer.                                                                                                                                 |
+| `variant?`      | `'menu' \| 'quick'` | `menu` is `Menu`'s own markup (36px rows, 15px icons). `quick` draws the Ship grid's quick panel: a 16px icon strip on top and 40px command rows. Passing a strip item selects `quick` by itself. |
+
+### `useContextMenu`
+
+Imperative twin for "right-click a row": `openAt` from the row's handler.
+
+_No props type — see the source._
+
+<sub>`src/components/DatePicker.tsx`</sub>
+
+### `DatePicker`
+
+ISO value picker with native entry, themed period panels and optional local time.
+
+Also accepts: `(SingleDatePickerProps | MultipleDatePickerProps)`.
+
+| Prop            | Type                                                                       | Notes |
+| --------------- | -------------------------------------------------------------------------- | ----- |
+| `'aria-label'`  | `string`                                                                   |       |
+| `className?`    | `string`                                                                   |       |
+| `defaultOpen?`  | `boolean`                                                                  |       |
+| `disabled?`     | `boolean`                                                                  |       |
+| `disabledDate?` | `(date: string, info: { type: DatePickerMode; from?: string }) => boolean` |       |
+| `disabledTime?` | `(value: string) => boolean`                                               |       |
+| `format?`       | `DateValueFormat`                                                          |       |
+| `id?`           | `string`                                                                   |       |
+| `invalid?`      | `boolean`                                                                  |       |
+| `locale?`       | `string`                                                                   |       |
+| `max?`          | `string`                                                                   |       |
+| `min?`          | `string`                                                                   |       |
+| `name?`         | `string`                                                                   |       |
+| `needConfirm?`  | `boolean`                                                                  |       |
+| `onOk?`         | `(value: string \| string[]) => void`                                      |       |
+| `onOpenChange?` | `(open: boolean) => void`                                                  |       |
+| `open?`         | `boolean`                                                                  |       |
+| `picker?`       | `DatePickerMode`                                                           |       |
+| `presets?`      | `DatePreset[]`                                                             |       |
+| `readOnly?`     | `boolean`                                                                  |       |
+| `required?`     | `boolean`                                                                  |       |
+
+### `DatePickerShared`
+
+_Type._
+
+### `DatePreset`
+
+_Type._
+
+### `DateRangePicker`
+
+Partial ISO ranges with shared period, date/time constraints and optional presets.
+
+Also accepts: `Omit< SingleDatePickerProps, | 'value' | 'defaultValue' | 'onChange' | 'name' | 'id' | 'required' | 'multiple' | 'presets' | 'disabledDate' | 'disabledTime' | 'open' | 'defaultOpen' | 'onOpenChange' | 'onOk' >`.
+
+| Prop            | Type                                                                                                | Notes |
+| --------------- | --------------------------------------------------------------------------------------------------- | ----- |
+| `defaultValue?` | `[string, string]`                                                                                  |       |
+| `disabledDate?` | `(date: string, info: { type: DatePickerMode; from?: string; range: 'start' \| 'end' }) => boolean` |       |
+| `disabledTime?` | `(value: string, info: { from?: string; range: 'start' \| 'end' }) => boolean`                      |       |
+| `names?`        | `[string, string]`                                                                                  |       |
+| `onChange?`     | `(value: [string, string]) => void`                                                                 |       |
+| `onOpenChange?` | `(open: 'start' \| 'end' \| null) => void`                                                          |       |
+| `open?`         | `'start' \| 'end' \| null`                                                                          |       |
+| `presets?`      | `DateRangePreset[]`                                                                                 |       |
+| `value?`        | `[string, string]`                                                                                  |       |
+
+### `DateRangePreset`
+
+_Type._
+
+<sub>`src/components/Descriptions.tsx`</sub>
+
+### `Descriptions`
+
+Responsive definition list with per-item spans and native label/value semantics.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'children'>`.
+
+| Prop        | Type                                            | Notes |
+| ----------- | ----------------------------------------------- | ----- |
+| `bordered?` | `boolean`                                       |       |
+| `colon?`    | `boolean`                                       |       |
+| `column?`   | `number \| Partial<Record<Breakpoint, number>>` |       |
+| `extra?`    | `ReactNode`                                     |       |
+| `items`     | `DescriptionsItem[]`                            |       |
+| `layout?`   | `'horizontal' \| 'vertical'`                    |       |
+| `size?`     | `'sm' \| 'md' \| 'lg'`                          |       |
+| `title?`    | `ReactNode`                                     |       |
+
+### `DescriptionsItem`
+
+_Type._
+
+<sub>`src/components/Dialog.tsx`</sub>
+
+### `Dialog`
+
+Ship's "New …" dialogs are a wide, near-full-height sheet, not a centred card — `size="xl"` reproduces that.
+
+| Prop             | Type                                     | Notes                                                    |
+| ---------------- | ---------------------------------------- | -------------------------------------------------------- |
+| `bodyClassName?` | `string`                                 |                                                          |
+| `children`       | `ReactNode`                              |                                                          |
+| `className?`     | `string`                                 |                                                          |
+| `closable?`      | `boolean`                                |                                                          |
+| `closeLabel?`    | `string`                                 |                                                          |
+| `dismissable?`   | `boolean`                                | Prevents the scrim / Esc from discarding a dirty form.   |
+| `footer?`        | `ReactNode`                              |                                                          |
+| `keyboard?`      | `boolean`                                |                                                          |
+| `maskClosable?`  | `boolean`                                |                                                          |
+| `maskContent?`   | `ReactNode`                              |                                                          |
+| `maskStyle?`     | `CSSProperties`                          |                                                          |
+| `onClose`        | `() => void`                             |                                                          |
+| `open`           | `boolean`                                |                                                          |
+| `placement?`     | `'top' \| 'right' \| 'bottom' \| 'left'` |                                                          |
+| `size?`          | `'sm' \| 'md' \| 'lg' \| 'xl'`           |                                                          |
+| `style?`         | `CSSProperties`                          |                                                          |
+| `title`          | `ReactNode`                              |                                                          |
+| `tools?`         | `ReactNode`                              | Extra header controls rendered left of the close button. |
+
+<sub>`src/components/Divider.tsx`</sub>
+
+### `Divider`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop              | Type                              | Notes |
+| ----------------- | --------------------------------- | ----- |
+| `className?`      | `string`                          |       |
+| `dashed?`         | `boolean`                         |       |
+| `orientation?`    | `'horizontal' \| 'vertical'`      |       |
+| `plain?`          | `boolean`                         |       |
+| `titlePlacement?` | `'start' \| 'center' \| 'end'`    |       |
+| `variant?`        | `'solid' \| 'dashed' \| 'dotted'` |       |
+
+<sub>`src/components/Drawer.tsx`</sub>
+
+### `Drawer`
+
+Shares modal focus, stacking and scroll-lock behavior with Dialog.
+
+Also accepts: `Omit<DialogProps, 'size' | 'placement'>`.
+
+| Prop         | Type                                     | Notes |
+| ------------ | ---------------------------------------- | ----- |
+| `height?`    | `number \| string`                       |       |
+| `placement?` | `'top' \| 'right' \| 'bottom' \| 'left'` |       |
+| `width?`     | `number \| string`                       |       |
+
+<sub>`src/components/Dropdown.tsx`</sub>
+
+### `Dropdown`
+
+A native button trigger using the existing Menu keyboard and submenu behavior.
+
+Also accepts: `Omit<ButtonProps, 'onSelect'>`.
+
+| Prop            | Type                      | Notes |
+| --------------- | ------------------------- | ----- |
+| `defaultOpen?`  | `boolean`                 |       |
+| `menu`          | `MenuProps`               |       |
+| `onOpenChange?` | `(open: boolean) => void` |       |
+| `open?`         | `boolean`                 |       |
+| `placement?`    | `Placement`               |       |
+
+<sub>`src/components/Flex.tsx`</sub>
+
+### `Flex`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop        | Type                                   | Notes |
+| ----------- | -------------------------------------- | ----- |
+| `align?`    | `CSSProperties['alignItems']`          |       |
+| `flex?`     | `CSSProperties['flex']`                |       |
+| `gap?`      | `number \| string`                     |       |
+| `justify?`  | `CSSProperties['justifyContent']`      |       |
+| `vertical?` | `boolean`                              |       |
+| `wrap?`     | `boolean \| CSSProperties['flexWrap']` |       |
+
+### `Space`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop         | Type                                                                                                 | Notes |
+| ------------ | ---------------------------------------------------------------------------------------------------- | ----- |
+| `align?`     | `'start' \| 'end' \| 'center' \| 'baseline'`                                                         |       |
+| `direction?` | `'horizontal' \| 'vertical'`                                                                         |       |
+| `separator?` | `ReactNode`                                                                                          |       |
+| `size?`      | `number \| 'sm' \| 'md' \| 'lg' \| [number \| 'sm' \| 'md' \| 'lg', number \| 'sm' \| 'md' \| 'lg']` |       |
+| `wrap?`      | `boolean`                                                                                            |       |
+
+<sub>`src/components/FloatButton.tsx`</sub>
+
+### `BackTop`
+
+Compatibility BackTop entry also exposed as FloatButton.BackTop.
+
+Also accepts: `Omit<ButtonProps, 'icon' | 'iconAfter' | 'shape' | 'content'>`.
+
+| Prop                | Type                                                                             | Notes |
+| ------------------- | -------------------------------------------------------------------------------- | ----- |
+| `badge?`            | `Pick<BadgeProps, 'count' \| 'dot' \| 'overflowCount' \| 'showZero' \| 'label'>` |       |
+| `behavior?`         | `ScrollBehavior`                                                                 |       |
+| `content?`          | `ReactNode`                                                                      |       |
+| `description?`      | `ReactNode`                                                                      |       |
+| `icon?`             | `ReactNode`                                                                      |       |
+| `shape?`            | `'circle' \| 'square'`                                                           |       |
+| `showProgress?`     | `boolean`                                                                        |       |
+| `target?`           | `() => ScrollTarget \| null`                                                     |       |
+| `tooltip?`          | `ReactNode`                                                                      |       |
+| `visibilityHeight?` | `number`                                                                         |       |
+
+### `FloatButton`
+
+Also accepts: `Omit<ButtonProps, 'icon' | 'iconAfter' | 'shape' | 'content'>`.
+
+| Prop           | Type                                                                             | Notes |
+| -------------- | -------------------------------------------------------------------------------- | ----- |
+| `badge?`       | `Pick<BadgeProps, 'count' \| 'dot' \| 'overflowCount' \| 'showZero' \| 'label'>` |       |
+| `content?`     | `ReactNode`                                                                      |       |
+| `description?` | `ReactNode`                                                                      |       |
+| `icon?`        | `ReactNode`                                                                      |       |
+| `shape?`       | `'circle' \| 'square'`                                                           |       |
+| `tooltip?`     | `ReactNode`                                                                      |       |
+
+### `FloatButtonGroup`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop            | Type                      | Notes |
+| --------------- | ------------------------- | ----- |
+| `'aria-label'`  | `string`                  |       |
+| `closeIcon?`    | `ReactNode`               |       |
+| `defaultOpen?`  | `boolean`                 |       |
+| `disabled?`     | `boolean`                 |       |
+| `icon?`         | `ReactNode`               |       |
+| `onOpenChange?` | `(open: boolean) => void` |       |
+| `open?`         | `boolean`                 |       |
+| `trigger?`      | `'click' \| 'hover'`      |       |
+
+<sub>`src/components/Form.tsx`</sub>
+
+### `Form`
+
+Standalone exports and Ant-style compound names share the same implementation.
+
+Also accepts: `Omit<FormHTMLAttributes<HTMLFormElement>, 'onSubmit' | 'onChange'>`.
+
+| Prop                  | Type                                                                                       | Notes |
+| --------------------- | ------------------------------------------------------------------------------------------ | ----- |
+| `disabled?`           | `boolean`                                                                                  |       |
+| `form?`               | `FormInstance`                                                                             |       |
+| `initialValues?`      | `FormValues`                                                                               |       |
+| `onFinish?`           | `(values: FormValues) => void \| Promise<void>`                                            |       |
+| `onFinishFailed?`     | `(error: FormValidationError) => void`                                                     |       |
+| `onSubmitError?`      | `(error: unknown) => void`                                                                 |       |
+| `onValuesChange?`     | `(changed: FormValues, values: FormValues) => void`                                        |       |
+| `preserve?`           | `boolean`                                                                                  |       |
+| `scrollToFirstError?` | `boolean \| { focus?: boolean; block?: ScrollLogicalPosition; behavior?: ScrollBehavior }` |       |
+| `validateTrigger?`    | `ValidationTrigger`                                                                        |       |
+
+### `FormError`
+
+_Type._
+
+### `FormInstance`
+
+_Type._
+
+### `FormItem`
+
+| Prop                 | Type                                                               | Notes                                                                   |
+| -------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------- |
+| `children`           | `ReactElement \| ((form: FormInstance) => ReactNode)`              |                                                                         |
+| `className?`         | `string`                                                           |                                                                         |
+| `dependencies?`      | `NamePath[]`                                                       | Absolute form paths, including the complete Form.List prefix and index. |
+| `emptyValue?`        | `unknown`                                                          |                                                                         |
+| `getValueFromEvent?` | `(...args: unknown[]) => unknown`                                  |                                                                         |
+| `hint?`              | `ReactNode`                                                        |                                                                         |
+| `label?`             | `ReactNode`                                                        |                                                                         |
+| `name?`              | `NamePath`                                                         |                                                                         |
+| `noStyle?`           | `boolean`                                                          |                                                                         |
+| `preserve?`          | `boolean`                                                          |                                                                         |
+| `required?`          | `boolean`                                                          |                                                                         |
+| `rules?`             | `FormRule[]`                                                       |                                                                         |
+| `shouldUpdate?`      | `boolean \| ((previous: FormValues, next: FormValues) => boolean)` |                                                                         |
+| `validateTrigger?`   | `ValidationTrigger`                                                |                                                                         |
+| `valuePropName?`     | `string`                                                           |                                                                         |
+
+### `FormList`
+
+Dynamic array fields.
+
+| Prop         | Type                                                                                                 | Notes |
+| ------------ | ---------------------------------------------------------------------------------------------------- | ----- |
+| `children`   | `(fields: FormListField[], operations: FormListOperations, meta: { errors: string[] }) => ReactNode` |       |
+| `className?` | `string`                                                                                             |       |
+| `name`       | `NamePath`                                                                                           |       |
+| `rules?`     | `FormRule[]`                                                                                         |       |
+
+### `FormListField`
+
+_Type._
+
+### `FormListOperations`
+
+_Type._
+
+### `FormRule`
+
+_Type._
+
+### `FormValidationError`
+
+_Type._
+
+### `FormValues`
+
+Strings are literal keys; array name paths describe nested object/array values.
+
+_Type._
+
+### `useForm`
+
+_No props type — see the source._
+
+### `useFormInstance`
+
+_No props type — see the source._
+
+### `useWatch`
+
+_No props type — see the source._
+
+<sub>`src/components/Grid.tsx`</sub>
+
+### `Col`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`, `Partial<Record<Breakpoint, number | ColSize>>`.
+
+| Prop      | Type               | Notes |
+| --------- | ------------------ | ----- |
+| `flex?`   | `number \| string` |       |
+| `offset?` | `number`           |       |
+| `order?`  | `number`           |       |
+| `pull?`   | `number`           |       |
+| `push?`   | `number`           |       |
+| `span?`   | `number`           |       |
+
+### `ColSize`
+
+_Type._
+
+### `Grid`
+
+_No props type — see the source._
+
+### `Row`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop       | Type                                                                                              | Notes |
+| ---------- | ------------------------------------------------------------------------------------------------- | ----- |
+| `align?`   | `Responsive<'top' \| 'middle' \| 'bottom' \| 'stretch'>`                                          |       |
+| `gutter?`  | `Gutter \| [Gutter, Gutter]`                                                                      |       |
+| `justify?` | `Responsive<'start' \| 'end' \| 'center' \| 'space-around' \| 'space-between' \| 'space-evenly'>` |       |
+| `wrap?`    | `boolean`                                                                                         |       |
+
+<sub>`src/components/Icon.tsx`</sub>
+
+### `Icon`
+
+Renders PingCode's icon geometry inline.
+
+Also accepts: `Omit<HTMLAttributes<HTMLSpanElement>, 'children'>`.
+
+| Prop         | Type                  | Notes                                                                |
+| ------------ | --------------------- | -------------------------------------------------------------------- |
+| `className?` | `string`              |                                                                      |
+| `label?`     | `string`              | Decorative by default; pass a label to expose it to assistive tech.  |
+| `name`       | `IconName \| string`  | Sprite name, e.g. `house-fill`. Unknown names preserve an empty box. |
+| `size?`      | `number \| string`    | Font-size in px; the glyph is a 1em square.                          |
+| `style?`     | `React.CSSProperties` |                                                                      |
+
+<sub>`src/components/Image.tsx`</sub>
+
+### `Image`
+
+Also accepts: `Omit<ImgHTMLAttributes<HTMLImageElement>, 'placeholder'>`.
+
+| Prop           | Type                            | Notes |
+| -------------- | ------------------------------- | ----- |
+| `alt`          | `string`                        |       |
+| `disabled?`    | `boolean`                       |       |
+| `fallback?`    | `string`                        |       |
+| `placeholder?` | `ReactNode`                     |       |
+| `preview?`     | `boolean \| ImagePreviewConfig` |       |
+
+<sub>`src/components/Input.tsx`</sub>
+
+### `Field`
+
+| Prop         | Type        | Notes |
+| ------------ | ----------- | ----- |
+| `children`   | `ReactNode` |       |
+| `className?` | `string`    |       |
+| `error?`     | `ReactNode` |       |
+| `hint?`      | `ReactNode` |       |
+| `htmlFor?`   | `string`    |       |
+| `label?`     | `ReactNode` |       |
+| `required?`  | `boolean`   |       |
+
+### `Input`
+
+Also accepts: `Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix'>`.
+
+| Prop            | Type                                                                                                  | Notes |
+| --------------- | ----------------------------------------------------------------------------------------------------- | ----- |
+| `allowClear?`   | `boolean`                                                                                             |       |
+| `clearLabel?`   | `string`                                                                                              |       |
+| `invalid?`      | `boolean`                                                                                             |       |
+| `onClear?`      | `() => void`                                                                                          |       |
+| `onPressEnter?` | `KeyboardEventHandler<HTMLInputElement>`                                                              |       |
+| `prefix?`       | `ReactNode`                                                                                           |       |
+| `showCount?`    | `boolean \| { formatter: (info: { value: string; count: number; maxLength?: number }) => ReactNode }` |       |
+| `size?`         | `'sm' \| 'md' \| 'lg'`                                                                                |       |
+| `status?`       | `'warning' \| 'error'`                                                                                |       |
+| `suffix?`       | `ReactNode`                                                                                           |       |
+| `variant?`      | `'outlined' \| 'borderless' \| 'filled' \| 'underlined'`                                              |       |
+
+### `SearchInput`
+
+Also accepts: `Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>`.
+
+| Prop      | Type                  | Notes                                                                                                                                                    |
+| --------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `shape?`  | `'header' \| 'field'` | `header` = the 16px top-bar pill-less box; `field` = the 4.8px borderless page/toolbar field that only rings on focus (both measured from the live DOM). |
+| `size?`   | `'sm' \| 'md'`        |                                                                                                                                                          |
+| `suffix?` | `ReactNode`           | Rendered after the field, e.g. a shortcut hint or a filter caret.                                                                                        |
+| `width?`  | `number \| string`    |                                                                                                                                                          |
+
+### `Textarea`
+
+Also accepts: `TextareaHTMLAttributes<HTMLTextAreaElement>`.
+
+| Prop       | Type      | Notes |
+| ---------- | --------- | ----- |
+| `invalid?` | `boolean` |       |
+
+<sub>`src/components/InputNumber.tsx`</sub>
+
+### `InputNumber`
+
+Numeric entry with editing drafts, bounded stepping and a native input ref.
+
+Also accepts: `Omit< InputProps, 'type' | 'value' | 'defaultValue' | 'onChange' | 'min' | 'max' | 'step' | 'allowClear' >`.
+
+| Prop            | Type                                                                              | Notes |
+| --------------- | --------------------------------------------------------------------------------- | ----- |
+| `controls?`     | `boolean`                                                                         |       |
+| `defaultValue?` | `number \| null`                                                                  |       |
+| `formatter?`    | `(value: number \| null, info: { userTyping: boolean; input: string }) => string` |       |
+| `keyboard?`     | `boolean`                                                                         |       |
+| `max?`          | `number`                                                                          |       |
+| `min?`          | `number`                                                                          |       |
+| `onChange?`     | `(value: number \| null) => void`                                                 |       |
+| `onStep?`       | `(value: number, info: { offset: number; type: 'up' \| 'down' }) => void`         |       |
+| `parser?`       | `(input: string) => number \| null`                                               |       |
+| `precision?`    | `number`                                                                          |       |
+| `step?`         | `number`                                                                          |       |
+| `value?`        | `number \| null`                                                                  |       |
+
+<sub>`src/components/Layout.tsx`</sub>
+
+### `Layout`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop        | Type      | Notes |
+| ----------- | --------- | ----- |
+| `hasSider?` | `boolean` |       |
+
+<sub>`src/components/List.tsx`</sub>
+
+### `List`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'children'>`.
+
+| Prop          | Type                                                                         | Notes |
+| ------------- | ---------------------------------------------------------------------------- | ----- |
+| `bordered?`   | `boolean`                                                                    |       |
+| `children?`   | `ReactNode`                                                                  |       |
+| `dataSource?` | `T[]`                                                                        |       |
+| `emptyText?`  | `ReactNode`                                                                  |       |
+| `footer?`     | `ReactNode`                                                                  |       |
+| `grid?`       | `{ column?: number; gutter?: number } & Partial<Record<Breakpoint, number>>` |       |
+| `header?`     | `ReactNode`                                                                  |       |
+| `itemLayout?` | `'horizontal' \| 'vertical'`                                                 |       |
+| `loading?`    | `boolean`                                                                    |       |
+| `loadMore?`   | `ReactNode`                                                                  |       |
+| `pagination?` | `false \| Omit<PaginationProps, 'total' \| 'left' \| 'children'>`            |       |
+| `renderItem?` | `(item: T, index: number) => ReactNode`                                      |       |
+| `rowKey?`     | `keyof T \| ((item: T) => Key)`                                              |       |
+| `size?`       | `'small' \| 'default' \| 'large'`                                            |       |
+| `split?`      | `boolean`                                                                    |       |
+
+### `ListItem`
+
+Also accepts: `HTMLAttributes<HTMLLIElement>`.
+
+| Prop       | Type          | Notes |
+| ---------- | ------------- | ----- |
+| `actions?` | `ReactNode[]` |       |
+| `extra?`   | `ReactNode`   |       |
+
+### `ListItemMeta`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'title'>`.
+
+| Prop           | Type        | Notes |
+| -------------- | ----------- | ----- |
+| `avatar?`      | `ReactNode` |       |
+| `description?` | `ReactNode` |       |
+| `title?`       | `ReactNode` |       |
+
+<sub>`src/components/Listy.tsx`</sub>
+
+### `Listy`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'children'>`.
+
+| Prop          | Type                                                                    | Notes                                                          |
+| ------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `group?`      | `{ key: (item: T) => Key; title: (key: Key, items: T[]) => ReactNode }` |                                                                |
+| `height?`     | `number`                                                                |                                                                |
+| `itemHeight?` | `number`                                                                | Virtual lists use fixed-height rows (including group headers). |
+| `itemRender`  | `(item: T, index: number) => ReactNode`                                 |                                                                |
+| `items?`      | `T[]`                                                                   |                                                                |
+| `rowKey`      | `keyof T \| ((item: T) => Key)`                                         |                                                                |
+| `sticky?`     | `boolean`                                                               |                                                                |
+| `virtual?`    | `boolean`                                                               |                                                                |
+
+<sub>`src/components/Masonry.tsx`</sub>
+
+### `Masonry`
+
+Measured shortest-column layout; DOM and reading order stay in source order.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'children'>`.
+
+| Prop              | Type                                                                      | Notes |
+| ----------------- | ------------------------------------------------------------------------- | ----- |
+| `columns?`        | `number \| Partial<Record<Breakpoint, number>>`                           |       |
+| `gutter?`         | `number \| [number, number]`                                              |       |
+| `itemRender?`     | `(item: MasonryItem<T> & { index: number; column: number }) => ReactNode` |       |
+| `items?`          | `MasonryItem<T>[]`                                                        |       |
+| `onLayoutChange?` | `(layout: { key: Key; column: number }[]) => void`                        |       |
+
+<sub>`src/components/Mentions.tsx`</sub>
+
+### `MentionOption`
+
+_Type._
+
+### `Mentions`
+
+Also accepts: `Omit< TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'defaultValue' | 'onChange' | 'onSelect' | 'prefix' | 'children' >`.
+
+| Prop               | Type                                                           | Notes |
+| ------------------ | -------------------------------------------------------------- | ----- |
+| `defaultValue?`    | `string`                                                       |       |
+| `filterOption?`    | `false \| ((query: string, option: MentionOption) => boolean)` |       |
+| `invalid?`         | `boolean`                                                      |       |
+| `loading?`         | `boolean`                                                      |       |
+| `notFoundContent?` | `ReactNode`                                                    |       |
+| `onChange?`        | `(value: string) => void`                                      |       |
+| `onSearch?`        | `(query: string, prefix: string) => void`                      |       |
+| `onSelect?`        | `(option: MentionOption, prefix: string) => void`              |       |
+| `options`          | `MentionOption[]`                                              |       |
+| `placement?`       | `'top' \| 'bottom'`                                            |       |
+| `prefix?`          | `string \| string[]`                                           |       |
+| `split?`           | `string`                                                       |       |
+| `validateSearch?`  | `(query: string, split: string) => boolean`                    |       |
+| `value?`           | `string`                                                       |       |
+
+### `MentionsConfig`
+
+_Type._
+
+### `MentionsEntity`
+
+_Type._
+
+<sub>`src/components/Menu.tsx`</sub>
+
+### `Menu`
+
+| Prop                    | Type                                     | Notes                                                           |
+| ----------------------- | ---------------------------------------- | --------------------------------------------------------------- |
+| `'aria-label'?`         | `string`                                 |                                                                 |
+| `className?`            | `string`                                 |                                                                 |
+| `closeOnSelect?`        | `boolean`                                | Let a host own dismissal; defaults to false for multiple menus. |
+| `defaultOpenKeys?`      | `string[]`                               |                                                                 |
+| `defaultSelectedKeys?`  | `string[]`                               |                                                                 |
+| `disabled?`             | `boolean`                                |                                                                 |
+| `items`                 | `MenuItemSpec[]`                         |                                                                 |
+| `mode?`                 | `'vertical' \| 'horizontal' \| 'inline'` |                                                                 |
+| `multiple?`             | `boolean`                                |                                                                 |
+| `onOpenChange?`         | `(keys: string[]) => void`               |                                                                 |
+| `onSelect?`             | `(id: string) => void`                   |                                                                 |
+| `onSelectedKeysChange?` | `(keys: string[]) => void`               |                                                                 |
+| `openKeys?`             | `string[]`                               |                                                                 |
+| `searchable?`           | `boolean`                                | Renders a filter field above the items once the list gets long. |
+| `searchPlaceholder?`    | `string`                                 |                                                                 |
+| `selectable?`           | `boolean`                                |                                                                 |
+| `selectedKeys?`         | `string[]`                               |                                                                 |
+
+### `MenuItemSpec`
+
+_Type._
+
+<sub>`src/components/Nav.tsx`</sub>
+
+### `Nav`
+
+PingCode's top-level product tabs: a text row with a 2px accent "ink" bar that slides under the active tab.
+
+Also accepts: `Omit<HTMLAttributes<HTMLElement>, 'onChange'>`.
+
+| Prop               | Type                                       | Notes                                                                                                                                                                                                                                                               |
+| ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `'aria-label'?`    | `string`                                   |                                                                                                                                                                                                                                                                     |
+| `className?`       | `string`                                   |                                                                                                                                                                                                                                                                     |
+| `disabled?`        | `boolean`                                  |                                                                                                                                                                                                                                                                     |
+| `itemContextMenu?` | `(item: NavItemSpec) => ContextMenuItem[]` | Right-click commands for a tab; each must also be reachable another way.                                                                                                                                                                                            |
+| `items`            | `NavItemSpec[]`                            |                                                                                                                                                                                                                                                                     |
+| `onChange`         | `(id: string) => void`                     |                                                                                                                                                                                                                                                                     |
+| `overflowItems?`   | `NavItemSpec[]`                            | Extra destinations folded into a "More" menu, as the product does.                                                                                                                                                                                                  |
+| `size?`            | `NavSize`                                  | Height and side padding of the strip. `md` (the default) is the 52px top strip; `sm` is the 48px second-level strip the Admin console nests under it — the only two measured differences. Everything else (ink bar, overflow, ←→ keyboard, context menu) is shared. |
+| `value`            | `string`                                   | The current tab. Controlled — routing owns the selection.                                                                                                                                                                                                           |
+
+### `NavItemSpec`
+
+_Type._
+
+### `NavSize`
+
+`md` is the 52px / 16px product strip; `sm` the 48px / 8px second-level one.
+
+_Type._
+
+<sub>`src/components/Pagination.tsx`</sub>
+
+### `Pagination`
+
+Ship's footer pager: page-size menu on the left, numbered pages in the middle, and an explicit "Go to" field for long lists.
+
+| Prop                | Type                                                    | Notes                                                                    |
+| ------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------ |
+| `children?`         | `ReactNode`                                             | Extra controls pinned to the right of the pager (column settings, etc.). |
+| `className?`        | `string`                                                |                                                                          |
+| `defaultPage?`      | `number`                                                |                                                                          |
+| `defaultPageSize?`  | `number`                                                |                                                                          |
+| `disabled?`         | `boolean`                                               |                                                                          |
+| `hideOnSinglePage?` | `boolean`                                               |                                                                          |
+| `left?`             | `ReactNode`                                             | View controls pinned to the left of the row count (Ship's list footer).  |
+| `onChange?`         | `(page: number, pageSize: number) => void`              |                                                                          |
+| `onPageChange?`     | `(page: number) => void`                                |                                                                          |
+| `onPageSizeChange?` | `(size: number) => void`                                |                                                                          |
+| `page?`             | `number`                                                |                                                                          |
+| `pageSize?`         | `number`                                                |                                                                          |
+| `pageSizeOptions?`  | `number[]`                                              |                                                                          |
+| `showQuickJumper?`  | `boolean`                                               |                                                                          |
+| `showSizeChanger?`  | `boolean`                                               |                                                                          |
+| `showTotal?`        | `(total: number, range: [number, number]) => ReactNode` |                                                                          |
+| `total`             | `number`                                                |                                                                          |
+
+<sub>`src/components/PasswordInput.tsx`</sub>
+
+### `PasswordInput`
+
+Password field with an explicit, keyboard-accessible visibility toggle.
+
+Also accepts: `Omit<InputProps, 'type'>`.
+
+| Prop               | Type                         | Notes |
+| ------------------ | ---------------------------- | ----- |
+| `defaultVisible?`  | `boolean`                    |       |
+| `hideLabel?`       | `string`                     |       |
+| `onVisibleChange?` | `(visible: boolean) => void` |       |
+| `showLabel?`       | `string`                     |       |
+| `visible?`         | `boolean`                    |       |
+
+<sub>`src/components/PeoplePicker.tsx`</sub>
+
+### `PeoplePicker`
+
+The inline assignee quick editor: the panel the Ship grid opens when an Assignee cell is clicked — a search field, a Members / Dept / Group segment and the people of the active tab, with `Unassigned` pinned to the top.
+
+| Prop                 | Type                | Notes |
+| -------------------- | ------------------- | ----- |
+| `'aria-label'?`      | `string`            |       |
+| `disabled?`          | `boolean`           |       |
+| `emptyHint?`         | `string`            |       |
+| `error?`             | `ReactNode`         |       |
+| `loading?`           | `boolean`           |       |
+| `onRetry?`           | `() => void`        |       |
+| `searchPlaceholder?` | `string`            |       |
+| `tabs`               | `PeoplePickerTab[]` |       |
+| `value?`             | `string \| null`    |       |
+
+### `PeoplePickerPerson`
+
+One selectable person.
+
+_Type._
+
+### `PeoplePickerTab`
+
+_Type._
+
+<sub>`src/components/Popconfirm.tsx`</sub>
+
+### `Popconfirm`
+
+Also accepts: `ButtonProps`.
+
+| Prop            | Type                                                | Notes |
+| --------------- | --------------------------------------------------- | ----- |
+| `cancelText?`   | `ReactNode`                                         |       |
+| `defaultOpen?`  | `boolean`                                           |       |
+| `description?`  | `ReactNode`                                         |       |
+| `okText?`       | `ReactNode`                                         |       |
+| `onCancel?`     | `() => void`                                        |       |
+| `onConfirm?`    | `() => void \| boolean \| Promise<void \| boolean>` |       |
+| `onError?`      | `(error: unknown) => void`                          |       |
+| `onOpenChange?` | `(open: boolean) => void`                           |       |
+| `open?`         | `boolean`                                           |       |
+| `placement?`    | `Placement`                                         |       |
+| `showCancel?`   | `boolean`                                           |       |
+| `title`         | `string`                                            |       |
+
+<sub>`src/components/Popover.tsx`</sub>
+
+### `Placement`
+
+_Type._
+
+### `Popover`
+
+A single floating layer: positioned against its anchor, portalled to <body> so it escapes the table's overflow context, dismissed on Esc / outside click.
+
+| Prop                     | Type                  | Notes                                                                 |
+| ------------------------ | --------------------- | --------------------------------------------------------------------- |
+| `'aria-label'?`          | `string`              |                                                                       |
+| `anchor`                 | `HTMLElement \| null` | The element the layer is anchored to — usually the trigger itself.    |
+| `autoFocus?`             | `boolean`             | Moves focus into the layer when it was opened from the keyboard.      |
+| `children`               | `ReactNode`           |                                                                       |
+| `className?`             | `string`              |                                                                       |
+| `dismissOnOutsideClick?` | `boolean`             | Skips outside-click dismissal (used for menus that manage their own). |
+| `matchAnchorWidth?`      | `boolean`             |                                                                       |
+| `onClose`                | `() => void`          |                                                                       |
+| `open`                   | `boolean`             |                                                                       |
+| `placement?`             | `Placement`           |                                                                       |
+
+### `useAnchorRef`
+
+Keeps `ref` in state so an anchored layer can measure it after mount.
+
+_No props type — see the source._
+
+### `usePopoverClose`
+
+_No props type — see the source._
+
+<sub>`src/components/QRCode.tsx`</sub>
+
+### `QRCode`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop             | Type                                                                                           | Notes |
+| ---------------- | ---------------------------------------------------------------------------------------------- | ----- |
+| `bgColor?`       | `string`                                                                                       |       |
+| `boostLevel?`    | `boolean`                                                                                      |       |
+| `bordered?`      | `boolean`                                                                                      |       |
+| `color?`         | `string`                                                                                       |       |
+| `errorLevel?`    | `QRCodeErrorLevel`                                                                             |       |
+| `icon?`          | `string`                                                                                       |       |
+| `iconSize?`      | `number \| { width: number; height: number }`                                                  |       |
+| `imageSettings?` | `QRCodeImageSettings`                                                                          |       |
+| `marginSize?`    | `number`                                                                                       |       |
+| `onRefresh?`     | `() => void`                                                                                   |       |
+| `size?`          | `number`                                                                                       |       |
+| `status?`        | `'active' \| 'loading' \| 'expired' \| 'scanned'`                                              |       |
+| `statusRender?`  | `(info: { status: 'loading' \| 'expired' \| 'scanned'; onRefresh?: () => void }) => ReactNode` |       |
+| `type?`          | `'svg' \| 'canvas'`                                                                            |       |
+| `value`          | `string \| string[]`                                                                           |       |
+
+### `QRCodeErrorLevel`
+
+_Type._
+
+### `QRCodeImageSettings`
+
+_Type._
+
+<sub>`src/components/QuickSelect.tsx`</sub>
+
+### `QuickSelect`
+
+The grid's inline enum quick editor: the cell _is_ the field — a box holding the current value and a caret — and the list it opens is portalled, so a table can never clip it.
+
+| Prop            | Type                                       | Notes                                                                                                                                                                                                                                                            |
+| --------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `'aria-label'?` | `string`                                   |                                                                                                                                                                                                                                                                  |
+| `allowClear?`   | `boolean`                                  | Adds a `Clear` row, for a field the record may leave empty.                                                                                                                                                                                                      |
+| `className?`    | `string`                                   | Extra class on the field itself, so a grid cell can widen its hit area.                                                                                                                                                                                          |
+| `disabled?`     | `boolean`                                  |                                                                                                                                                                                                                                                                  |
+| `display?`      | `ReactNode`                                | The node the field shows for its current value while it is not being typed in — normally the very node the cell already renders, so opening the editor never changes what the cell looks like.                                                                   |
+| `options`       | `QuickSelectOption[]`                      |                                                                                                                                                                                                                                                                  |
+| `placeholder?`  | `string`                                   |                                                                                                                                                                                                                                                                  |
+| `readOnly?`     | `boolean`                                  |                                                                                                                                                                                                                                                                  |
+| `renderOption?` | `(option: QuickSelectOption) => ReactNode` | Draws an option — in the list rows and, when the field has no `display` of its own, in the field box. The host supplies it for enums that carry a visual representation (`LevelTag`, `StatusTag`, the category pill); the library never re-implements a palette. |
+| `value`         | `string \| null`                           |                                                                                                                                                                                                                                                                  |
+
+### `QuickSelectOption`
+
+_Type._
+
+<sub>`src/components/QuickText.tsx`</sub>
+
+### `QuickText`
+
+The grid's inline text editor: the cell itself becomes a bordered input holding the current value, selected, so the first keystroke replaces it.
+
+| Prop            | Type                    | Notes                                                                                                                                                                                                                                                                                                                                        |
+| --------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `'aria-label'?` | `string`                |                                                                                                                                                                                                                                                                                                                                              |
+| `disabled?`     | `boolean`               |                                                                                                                                                                                                                                                                                                                                              |
+| `display?`      | `ReactNode`             | What the cell shows while the field is at rest — normally the very node the column already draws (its `TitleCell`), so opening the editor changes nothing about the cell but the input itself.                                                                                                                                               |
+| `maxLength?`    | `number`                |                                                                                                                                                                                                                                                                                                                                              |
+| `nullable?`     | `boolean`               | Lets a commit write an empty value. A title is not blankable by default.                                                                                                                                                                                                                                                                     |
+| `placeholder?`  | `string`                |                                                                                                                                                                                                                                                                                                                                              |
+| `readOnly?`     | `boolean`               |                                                                                                                                                                                                                                                                                                                                              |
+| `selectOnOpen?` | `boolean`               |                                                                                                                                                                                                                                                                                                                                              |
+| `trigger?`      | `'click' \| 'dblclick'` | The gesture that swaps the cell for the input. `click` by default, so the three inline editors answer to the same gesture — the live cell is a `*-quick-editor`, and its column carries no other click of its own. A host whose cell already navigates on click can pass `dblclick`, in which case `onActivate` keeps that navigation alive. |
+| `value`         | `string`                |                                                                                                                                                                                                                                                                                                                                              |
+
+<sub>`src/components/Radio.tsx`</sub>
+
+### `Radio`
+
+Also accepts: `Omit<InputHTMLAttributes<HTMLInputElement>, 'type'>`.
+
+| Prop     | Type        | Notes |
+| -------- | ----------- | ----- |
+| `label?` | `ReactNode` |       |
+
+### `RadioGroup`
+
+Native same-name radios provide arrow navigation and form submission.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>`.
+
+| Prop            | Type                                                                                                                                                                                                           | Notes |
+| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| `'aria-label'`  | `string`                                                                                                                                                                                                       |       |
+| `className?`    | `string`                                                                                                                                                                                                       |       |
+| `defaultValue?` | `string`                                                                                                                                                                                                       |       |
+| `disabled?`     | `boolean`                                                                                                                                                                                                      |       |
+| `name?`         | `string`                                                                                                                                                                                                       |       |
+| `onChange?`     | `(value: string) => void`                                                                                                                                                                                      |       |
+| `options`       | `Array<{ value: string; label: ReactNode; disabled?: boolean; id?: string; title?: string; required?: boolean; className?: string; style?: CSSProperties; onChange?: ChangeEventHandler<HTMLInputElement>; }>` |       |
+| `orientation?`  | `'horizontal' \| 'vertical'`                                                                                                                                                                                   |       |
+| `required?`     | `boolean`                                                                                                                                                                                                      |       |
+| `value?`        | `string`                                                                                                                                                                                                       |       |
+
+<sub>`src/components/Rate.tsx`</sub>
+
+### `Rate`
+
+Native radios provide discrete ratings, form values and arrow navigation.
+
+| Prop             | Type                      | Notes                                                  |
+| ---------------- | ------------------------- | ------------------------------------------------------ |
+| `'aria-label'`   | `string`                  |                                                        |
+| `allowClear?`    | `boolean`                 |                                                        |
+| `allowHalf?`     | `boolean`                 |                                                        |
+| `character?`     | `ReactNode`               |                                                        |
+| `className?`     | `string`                  |                                                        |
+| `clearLabel?`    | `string`                  |                                                        |
+| `count?`         | `number`                  | Rating from 0 to count, optionally in half-star steps. |
+| `defaultValue?`  | `number`                  |                                                        |
+| `disabled?`      | `boolean`                 |                                                        |
+| `name?`          | `string`                  |                                                        |
+| `onChange?`      | `(value: number) => void` |                                                        |
+| `onHoverChange?` | `(value: number) => void` |                                                        |
+| `readOnly?`      | `boolean`                 |                                                        |
+| `tooltips?`      | `string[]`                |                                                        |
+| `value?`         | `number`                  |                                                        |
+
+<sub>`src/components/Segment.tsx`</sub>
+
+### `Chip`
+
+Filter pills in the products toolbar (All / Starred / Recent).
+
+Also accepts: `ButtonHTMLAttributes<HTMLButtonElement>`.
+
+| Prop       | Type                 | Notes |
+| ---------- | -------------------- | ----- |
+| `children` | `ReactNode`          |       |
+| `icon?`    | `IconName \| string` |       |
+| `pressed?` | `boolean`            |       |
+
+### `Segment`
+
+Compact view switcher (List / Board / Table) used above entity grids.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>`.
+
+| Prop            | Type                         | Notes |
+| --------------- | ---------------------------- | ----- |
+| `'aria-label'?` | `string`                     |       |
+| `block?`        | `boolean`                    |       |
+| `className?`    | `string`                     |       |
+| `defaultValue?` | `string`                     |       |
+| `disabled?`     | `boolean`                    |       |
+| `onChange?`     | `(value: string) => void`    |       |
+| `options`       | `SegmentOption[]`            |       |
+| `orientation?`  | `'horizontal' \| 'vertical'` |       |
+| `value?`        | `string`                     |       |
+
+### `SegmentOption`
+
+_Type._
+
+<sub>`src/components/Select.tsx`</sub>
+
+### `MultiSelect`
+
+Also accepts: `Omit< ButtonHTMLAttributes<HTMLButtonElement>, 'value' | 'defaultValue' | 'onChange' | 'children' | 'size' >`, `( | { labelInValue?: false; values?: string[]; defaultValues?: string[]; onChange?: (values: string[]) => void } | { labelInValue: true; values?: SelectLabelValue[]; defaultValues?: SelectLabelValue[]; onChange?: (values: SelectLabelValue[]) => void; } )`.
+
+| Prop                 | Type                                                            | Notes |
+| -------------------- | --------------------------------------------------------------- | ----- |
+| `allowClear?`        | `boolean`                                                       |       |
+| `clearLabel?`        | `string`                                                        |       |
+| `defaultOpen?`       | `boolean`                                                       |       |
+| `error?`             | `ReactNode`                                                     |       |
+| `filterOption?`      | `boolean \| ((query: string, option: SelectOption) => boolean)` |       |
+| `filterSort?`        | `(a: SelectOption, b: SelectOption) => number`                  |       |
+| `invalid?`           | `boolean`                                                       |       |
+| `itemHeight?`        | `number`                                                        |       |
+| `label?`             | `ReactNode`                                                     |       |
+| `listHeight?`        | `number`                                                        |       |
+| `loading?`           | `boolean`                                                       |       |
+| `maxCount?`          | `number`                                                        |       |
+| `mode?`              | `'multiple' \| 'tags'`                                          |       |
+| `notFoundContent?`   | `ReactNode`                                                     |       |
+| `onClear?`           | `() => void`                                                    |       |
+| `onOpenChange?`      | `(open: boolean) => void`                                       |       |
+| `onSearch?`          | `(query: string) => void`                                       |       |
+| `open?`              | `boolean`                                                       |       |
+| `optionRender?`      | `(option: SelectOption, info: { index: number }) => ReactNode`  |       |
+| `options`            | `(SelectOption \| SelectOptionGroup)[]`                         |       |
+| `placeholder?`       | `string`                                                        |       |
+| `searchable?`        | `boolean`                                                       |       |
+| `searchPlaceholder?` | `string`                                                        |       |
+| `searchValue?`       | `string`                                                        |       |
+| `size?`              | `'md' \| 'lg'`                                                  |       |
+| `tagRender?`         | `(props: SelectTagRenderProps) => ReactNode`                    |       |
+| `tokenSeparators?`   | `string[]`                                                      |       |
+| `virtual?`           | `boolean`                                                       |       |
+
+### `Select`
+
+Also accepts: `Omit< ButtonHTMLAttributes<HTMLButtonElement>, 'value' | 'defaultValue' | 'onChange' | 'children' | 'size' >`, `( | { labelInValue?: false; allowClear?: false; value?: string | null; defaultValue?: string | null; onChange?: (value: string) => void; } | { labelInValue?: false; allowClear: true; value?: string | null; defaultValue?: string | null; onChange?: (value: string | null) => void; } | { labelInValue: true; allowClear?: boolean; value?: SelectLabelValue | null; defaultValue?: SelectLabelValue | null; onChange?: (value: SelectLabelValue | null) => void; } )`.
+
+| Prop                 | Type                                                            | Notes |
+| -------------------- | --------------------------------------------------------------- | ----- |
+| `clearLabel?`        | `string`                                                        |       |
+| `defaultOpen?`       | `boolean`                                                       |       |
+| `error?`             | `ReactNode`                                                     |       |
+| `filterOption?`      | `boolean \| ((query: string, option: SelectOption) => boolean)` |       |
+| `filterSort?`        | `(a: SelectOption, b: SelectOption) => number`                  |       |
+| `invalid?`           | `boolean`                                                       |       |
+| `itemHeight?`        | `number`                                                        |       |
+| `labelRender?`       | `(value: SelectLabelValue) => ReactNode`                        |       |
+| `listHeight?`        | `number`                                                        |       |
+| `loading?`           | `boolean`                                                       |       |
+| `notFoundContent?`   | `ReactNode`                                                     |       |
+| `onClear?`           | `() => void`                                                    |       |
+| `onOpenChange?`      | `(open: boolean) => void`                                       |       |
+| `onSearch?`          | `(query: string) => void`                                       |       |
+| `open?`              | `boolean`                                                       |       |
+| `optionRender?`      | `(option: SelectOption, info: { index: number }) => ReactNode`  |       |
+| `options`            | `(SelectOption \| SelectOptionGroup)[]`                         |       |
+| `placeholder?`       | `string`                                                        |       |
+| `searchable?`        | `boolean`                                                       |       |
+| `searchPlaceholder?` | `string`                                                        |       |
+| `searchValue?`       | `string`                                                        |       |
+| `size?`              | `'md' \| 'lg'`                                                  |       |
+| `virtual?`           | `boolean`                                                       |       |
+
+### `SelectLabelValue`
+
+_Type._
+
+### `SelectOption`
+
+_Type._
+
+### `SelectOptionGroup`
+
+_Type._
+
+### `useSelectAnchor`
+
+Imperative helper used by toolbars that need "sorted by X" labels.
+
+_No props type — see the source._
+
+<sub>`src/components/SelectionBar.tsx`</sub>
+
+### `BulkActions`
+
+The standard bulk commands, as data: the component builds the bar, the submenus, the round-robin spread and the messages; a page supplies the choices and the write.
+
+_Type._
+
+### `SelectionBar`
+
+"N selected" strip that stands in for the grid's header row while rows are selected: a select-all box, the count, a divider, the commands and Cancel.
+
+| Prop            | Type                                                                                   | Notes                                                                    |
+| --------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| `actions?`      | `Array<MenuItemSpec & { items?: MenuItemSpec[]; group?: string; groupIcon?: string }>` | Inline icon commands. An item may carry `items` to become a submenu.     |
+| `allSelected?`  | `boolean`                                                                              |                                                                          |
+| `clearLabel?`   | `string`                                                                               | The product labels this action "Cancel" while a selection is active.     |
+| `count`         | `number`                                                                               |                                                                          |
+| `disabled?`     | `boolean`                                                                              |                                                                          |
+| `loading?`      | `boolean`                                                                              | Locks selection and commands while the host has a request in progress.   |
+| `more?`         | `MenuItemSpec[]`                                                                       |                                                                          |
+| `onClear`       | `() => void`                                                                           |                                                                          |
+| `onError?`      | `(error: unknown) => void`                                                             |                                                                          |
+| `onToggleAll?`  | `() => void`                                                                           |                                                                          |
+| `overlay?`      | `boolean`                                                                              | `false` puts the bar in the flow instead of over a header row (a board). |
+| `someSelected?` | `boolean`                                                                              | Some, but not all: the bar's box reads the same as the header's did.     |
+| `withPick?`     | `boolean`                                                                              | The grid has a 44px pick column: the bar's own box sits inside it.       |
+
+<sub>`src/components/Sidebar.tsx`</sub>
+
+### `Sidebar`
+
+The category column that sits under the product header — 300px by default, the width measured on the live product.
+
+Also accepts: `Omit<HTMLAttributes<HTMLElement>, 'title'>`.
+
+| Prop             | Type                      | Notes                                                         |
+| ---------------- | ------------------------- | ------------------------------------------------------------- |
+| `'aria-label'?`  | `string`                  |                                                               |
+| `children`       | `ReactNode`               |                                                               |
+| `className?`     | `string`                  |                                                               |
+| `collapsed?`     | `boolean`                 |                                                               |
+| `defaultWidth?`  | `number`                  | Width in px; the resizer clamps it to the token bounds.       |
+| `footer?`        | `ReactNode`               |                                                               |
+| `maxWidth?`      | `number`                  |                                                               |
+| `minWidth?`      | `number`                  |                                                               |
+| `onWidthChange?` | `(width: number) => void` |                                                               |
+| `operations?`    | `ReactNode`               | Header controls — the product puts "add" and "collapse" here. |
+| `title`          | `ReactNode`               |                                                               |
+| `width?`         | `number`                  |                                                               |
+
+### `SidebarCollapseProvider`
+
+| Prop         | Type        | Notes |
+| ------------ | ----------- | ----- |
+| `children`   | `ReactNode` |       |
+| `collapsed?` | `boolean`   |       |
+
+### `useSidebarCollapsed`
+
+The state the surrounding shell asked for, if it asked for anything.
+
+_No props type — see the source._
+
+<sub>`src/components/Slider.tsx`</sub>
+
+### `Slider`
+
+Native ranges retain step rounding, keyboard interaction and form values.
+
+| Prop        | Type                                                   | Notes |
+| ----------- | ------------------------------------------------------ | ----- |
+| `marks?`    | `SliderMarks`                                          |       |
+| `tooltip?`  | `boolean \| { formatter?: (value: number) => string }` |       |
+| `vertical?` | `boolean`                                              |       |
+
+### `SliderMarks`
+
+_Type._
+
+<sub>`src/components/Splitter.tsx`</sub>
+
+### `Splitter`
+
+Also accepts: `HTMLAttributes<HTMLDivElement>`.
+
+| Prop               | Type                                              | Notes |
+| ------------------ | ------------------------------------------------- | ----- |
+| `destroyOnHidden?` | `boolean`                                         |       |
+| `disabled?`        | `boolean`                                         |       |
+| `onCollapse?`      | `(collapsed: boolean[], sizes: number[]) => void` |       |
+| `onResize?`        | `(sizes: number[]) => void`                       |       |
+| `onResizeEnd?`     | `(sizes: number[]) => void`                       |       |
+| `onResizeStart?`   | `(sizes: number[]) => void`                       |       |
+| `orientation?`     | `'horizontal' \| 'vertical'`                      |       |
+
+<sub>`src/components/States.tsx`</sub>
+
+### `Banner`
+
+| Prop       | Type                              | Notes |
+| ---------- | --------------------------------- | ----- |
+| `action?`  | `ReactNode`                       |       |
+| `children` | `ReactNode`                       |       |
+| `icon?`    | `string`                          |       |
+| `tone?`    | `'warning' \| 'info' \| 'danger'` |       |
+
+### `Empty`
+
+General empty state; string images are URLs, React nodes allow custom art.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'children'>`.
+
+| Prop           | Type        | Notes |
+| -------------- | ----------- | ----- |
+| `children?`    | `ReactNode` |       |
+| `compact?`     | `boolean`   |       |
+| `description?` | `ReactNode` |       |
+| `image?`       | `ReactNode` |       |
+
+### `EmptyArt`
+
+PingCode's empty illustration: the "no results" code card with a figure standing beside it.
+
+| Prop         | Type                              | Notes |
+| ------------ | --------------------------------- | ----- |
+| `className?` | `string`                          |       |
+| `variant?`   | `'empty' \| 'error' \| 'offline'` |       |
+
+### `EmptyState`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'title'>`.
+
+| Prop         | Type                              | Notes                                                              |
+| ------------ | --------------------------------- | ------------------------------------------------------------------ |
+| `action?`    | `ReactNode`                       |                                                                    |
+| `className?` | `string`                          |                                                                    |
+| `compact?`   | `boolean`                         |                                                                    |
+| `hint?`      | `ReactNode`                       | The "why" and "what now" — always render both when they are known. |
+| `title?`     | `ReactNode`                       |                                                                    |
+| `variant?`   | `'empty' \| 'error' \| 'offline'` | What the operator sees when nothing came back.                     |
+
+### `ErrorState`
+
+Error block that always answers: what happened / why / what to do now.
+
+| Prop          | Type         | Notes |
+| ------------- | ------------ | ----- |
+| `action?`     | `ReactNode`  |       |
+| `onRetry?`    | `() => void` |       |
+| `retryLabel?` | `string`     |       |
+| `what?`       | `ReactNode`  |       |
+| `why?`        | `ReactNode`  |       |
+
+### `InlineSpinner`
+
+| Prop     | Type     | Notes |
+| -------- | -------- | ----- |
+| `label?` | `string` |       |
+
+### `LoadingBlock`
+
+| Prop     | Type     | Notes |
+| -------- | -------- | ----- |
+| `label?` | `string` |       |
+
+### `Result`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'title'>`.
+
+| Prop        | Type                                                                                          | Notes |
+| ----------- | --------------------------------------------------------------------------------------------- | ----- |
+| `extra?`    | `ReactNode`                                                                                   |       |
+| `icon?`     | `ReactNode`                                                                                   |       |
+| `status?`   | `'success' \| 'error' \| 'info' \| 'warning' \| '403' \| '404' \| '500' \| 403 \| 404 \| 500` |       |
+| `subTitle?` | `ReactNode`                                                                                   |       |
+| `title?`    | `ReactNode`                                                                                   |       |
+
+### `Skeleton`
+
+| Prop         | Type                                                                             | Notes |
+| ------------ | -------------------------------------------------------------------------------- | ----- |
+| `active?`    | `boolean`                                                                        |       |
+| `avatar?`    | `boolean`                                                                        |       |
+| `children?`  | `ReactNode`                                                                      |       |
+| `className?` | `string`                                                                         |       |
+| `height?`    | `number \| string`                                                               |       |
+| `loading?`   | `boolean`                                                                        |       |
+| `paragraph?` | `boolean \| { rows?: number; width?: number \| string \| (number \| string)[] }` |       |
+| `radius?`    | `number`                                                                         |       |
+| `title?`     | `boolean`                                                                        |       |
+| `width?`     | `number \| string`                                                               |       |
+
+### `Spin`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'children'>`.
+
+| Prop           | Type                             | Notes |
+| -------------- | -------------------------------- | ----- |
+| `children?`    | `ReactNode`                      |       |
+| `delay?`       | `number`                         |       |
+| `description?` | `ReactNode`                      |       |
+| `fullscreen?`  | `boolean`                        |       |
+| `indicator?`   | `ReactNode`                      |       |
+| `size?`        | `'small' \| 'medium' \| 'large'` |       |
+| `spinning?`    | `boolean`                        |       |
+
+### `TableSkeleton`
+
+Row skeletons matching the 45px grid rhythm, so loading doesn't jump.
+
+| Prop       | Type       | Notes |
+| ---------- | ---------- | ----- |
+| `columns?` | `number[]` |       |
+| `rows?`    | `number`   |       |
+
+<sub>`src/components/Statistic.tsx`</sub>
+
+### `Statistic`
+
+Formatted headline value, preserving string digits without coercing large integers.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'prefix'>`.
+
+| Prop                | Type                                     | Notes |
+| ------------------- | ---------------------------------------- | ----- |
+| `decimalSeparator?` | `string`                                 |       |
+| `formatter?`        | `(value: number \| string) => ReactNode` |       |
+| `groupSeparator?`   | `string`                                 |       |
+| `loading?`          | `boolean`                                |       |
+| `precision?`        | `number`                                 |       |
+| `prefix?`           | `ReactNode`                              |       |
+| `suffix?`           | `ReactNode`                              |       |
+| `title?`            | `ReactNode`                              |       |
+| `value?`            | `number \| string`                       |       |
+| `valueStyle?`       | `CSSProperties`                          |       |
+
+<sub>`src/components/Steps.tsx`</sub>
+
+### `Steps`
+
+| Prop           | Type                                                                                                                                                                                  | Notes                                                                                    |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `'aria-label'` | `string`                                                                                                                                                                              |                                                                                          |
+| `className?`   | `string`                                                                                                                                                                              |                                                                                          |
+| `current?`     | `number`                                                                                                                                                                              | Active step number (offset by initial); initial + items.length marks all steps complete. |
+| `disabled?`    | `boolean`                                                                                                                                                                             |                                                                                          |
+| `initial?`     | `number`                                                                                                                                                                              |                                                                                          |
+| `items`        | `Array<{ key: string; title: ReactNode; description?: ReactNode; disabled?: boolean; status?: 'wait' \| 'process' \| 'finish' \| 'error'; icon?: ReactNode; subTitle?: ReactNode; }>` |                                                                                          |
+| `onChange?`    | `(index: number) => void`                                                                                                                                                             | Optional step navigation; without it the steps are a read-only list.                     |
+| `orientation?` | `'horizontal' \| 'vertical'`                                                                                                                                                          |                                                                                          |
+| `status?`      | `'wait' \| 'process' \| 'finish' \| 'error'`                                                                                                                                          |                                                                                          |
+
+<sub>`src/components/Switch.tsx`</sub>
+
+### `Switch`
+
+PingCode's 36×20 primary switch (20×16 in the sidebar footer's small form).
+
+Also accepts: `Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'>`.
+
+| Prop                 | Type           | Notes |
+| -------------------- | -------------- | ----- |
+| `checkedChildren?`   | `ReactNode`    |       |
+| `label`              | `string`       |       |
+| `loading?`           | `boolean`      |       |
+| `size?`              | `'sm' \| 'md'` |       |
+| `unCheckedChildren?` | `ReactNode`    |       |
+
+<sub>`src/components/table/DataTable.tsx`</sub>
+
+### `DataTable`
+
+The entity grid shared by every Ship tab: hover checkboxes, a row-number column, sortable headers, optional group headers and per-row actions.
+
+| Prop                       | Type                                                                                                                                            | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ariaLabel?`               | `string`                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `bulk?`                    | `BulkActions`                                                                                                                                   | What the selection bar offers while rows are selected. The bar, its submenus, the round-robin spread and the messages are the table's; the host supplies the choices and the write.                                                                                                                                                                                                                                                                                                |
+| `bulkActions?`             | `(keys: string[]) => MenuItemSpec[]`                                                                                                            | Extra commands appended after the standard ones.                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `className?`               | `string`                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `columns`                  | `Array<ColumnDefinition<T>>`                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `cursor?`                  | `boolean`                                                                                                                                       | The product's cursor: the grid is **one** tab stop, its unit is the **cell** — ← → walk the columns, ↑ ↓ walk the rows, Home / End jump to the ends of the row, Enter opens the record and Space toggles its selection when the host can write one. Focus rides with the cursor. A key a widget inside the cell owns (an editor, a button, a link) stays with it. Without a cursor every row that has an `onRowClick` is its own tab stop — fine for three rows, 16 presses at 16. |
+| `defaultExpandedGroups?`   | `string[]`                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `defaultExpandedRowKeys?`  | `string[]`                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `defaultFilters?`          | `Record<string, string[]>`                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `defaultSort?`             | `SortState`                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `defaultSorts?`            | `Exclude<SortState, null>[]`                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `density?`                 | `'default' \| 'compact'`                                                                                                                        | `compact` is the 36px row the product uses where space is tight (a preview panel, a comparison table). It also reserves the actions column instead of floating the commands over the last data column.                                                                                                                                                                                                                                                                             |
+| `disabled?`                | `boolean`                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `emptyState?`              | `ReactNode`                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `errorState?`              | `ReactNode`                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `expandedGroups?`          | `string[]`                                                                                                                                      | Which group headers are open. Uncontrolled (every group open) unless `expandedGroups` is given; `onExpandedGroupsChange` reports every toggle.                                                                                                                                                                                                                                                                                                                                     |
+| `expandedRowKeys?`         | `string[]`                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `expandedRowRender?`       | `(row: T, index: number) => ReactNode`                                                                                                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `filters?`                 | `Record<string, string[]>`                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `footer?`                  | `ReactNode`                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `getChildren?`             | `(row: T) => T[] \| undefined`                                                                                                                  | Opt into hierarchical rows; root records are paginated before expansion.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `groupBy?`                 | `(row: T) => string`                                                                                                                            | Renders collapsible group headers; rows keep their original order.                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `headerTools?`             | `ReactNode`                                                                                                                                     | Rendered in a trailing sticky header cell — the product puts its column settings gear there.                                                                                                                                                                                                                                                                                                                                                                                       |
+| `indentSize?`              | `number`                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `isRowSelectable?`         | `(row: T) => boolean`                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `loadingColumns?`          | `Array<number \| string>`                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `loadingRows?`             | `number`                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onChange?`                | `(change: TableChange<T>) => void`                                                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onColumnCommand?`         | `(command: ColumnCommand) => void`                                                                                                              | Renders the ⋯ menu in every data column's header and reports what it asked for: sort, move left/right, insert left/right, freeze/unfreeze, remove. Nothing happens inside the table — the host applies it to `columns`.                                                                                                                                                                                                                                                            |
+| `onDelete?`                | `(keys: string[]) => void`                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onEditProperties?`        | `() => void`                                                                                                                                    | Opens whatever dialog the host uses to edit the selection's properties.                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `onExpandedGroupsChange?`  | `(labels: string[]) => void`                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onExpandedRowKeysChange?` | `(keys: string[]) => void`                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onExportSelection?`       | `(keys: string[]) => void`                                                                                                                      | The bar's "More" entries: the host writes the CSV, the host deletes.                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `onFiltersChange?`         | `(filters: Record<string, string[]>) => void`                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onNotify?`                | `(message: string) => void`                                                                                                                     | Where the bar's confirmations go; the library raises no toasts of its own.                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `onRowClick?`              | `(row: T) => void`                                                                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onSelectedKeysChange?`    | `(keys: string[]) => void`                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onSortChange?`            | `(sort: SortState) => void`                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `onSortsChange?`           | `(sorts: Exclude<SortState, null>[]) => void`                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `pagination?`              | `Omit<PaginationProps, 'className'> & Required<Pick<PaginationProps, 'page' \| 'pageSize' \| 'onPageChange'>> & { mode?: 'local' \| 'remote' }` | Local slicing by default; remote mode expects already paged rows.                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `rowActions?`              | `(row: T) => ReactNode`                                                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `rowClassName?`            | `(row: T, index: number) => string`                                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `rowContextMenu?`          | `(row: T) => ContextMenuItem[]`                                                                                                                 | Right-click commands for a row. The same commands must also exist in `rowActions` — a context menu is never the only entry point.                                                                                                                                                                                                                                                                                                                                                  |
+| `rowExpandable?`           | `(row: T) => boolean`                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `rowKey`                   | `(row: T) => string`                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `rows`                     | `T[]`                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `scroll?`                  | `{ x?: number \| string; y?: number \| string }`                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `selectable?`              | `boolean`                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `selectedKeys?`            | `string[]`                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `selectionMode?`           | `'multiple' \| 'single'`                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `selectionNoun?`           | `BulkNoun`                                                                                                                                      | How the bar names its rows, e.g. `{ one: 'idea', many: 'ideas' }`.                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `showHeader?`              | `boolean`                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `showIndex?`               | `boolean`                                                                                                                                       | Row numbers, exactly as the product prints them in the `#` column.                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `sort?`                    | `SortState`                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `sorts?`                   | `Exclude<SortState, null>[]`                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `status?`                  | `'loading' \| 'error' \| 'ready'`                                                                                                               | The five states: loading / error / empty / populated / edge.                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `stickyHeader?`            | `boolean`                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `summary?`                 | `(rows: T[]) => ReactNode`                                                                                                                      | Render summary cells/rows here; the component supplies tfoot.                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `title?`                   | `ReactNode`                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `virtual?`                 | `boolean \| { rowHeight?: number; overscan?: number }`                                                                                          | Fixed-height windowing. Spanning cells, groups and expanded detail rows use the full body.                                                                                                                                                                                                                                                                                                                                                                                         |
+
+<sub>`src/components/table/types.ts`</sub>
+
+### `CellAction`
+
+One command that lives _inside_ a cell and appears while the pointer is on it — the product's copy-the-identifier and quick-edit affordances.
+
+_Type._
+
+### `Column`
+
+_Type._
+
+### `ColumnCommand`
+
+What the header's ⋯ menu asks the host to do.
+
+_Type._
+
+### `ColumnDefinition`
+
+_Type._
+
+### `ColumnGroup`
+
+_Type._
+
+### `SortState`
+
+_Type._
+
+### `TableChange`
+
+_Type._
+
+<sub>`src/components/Tabs.tsx`</sub>
+
+### `TabItem`
+
+_Type._
+
+### `Tabs`
+
+Content tabs with automatic activation and a single roving tab stop.
+
+| Prop                | Type                                                | Notes                                             |
+| ------------------- | --------------------------------------------------- | ------------------------------------------------- |
+| `'aria-label'`      | `string`                                            |                                                   |
+| `activeKey?`        | `string`                                            |                                                   |
+| `className?`        | `string`                                            |                                                   |
+| `defaultActiveKey?` | `string`                                            |                                                   |
+| `disabled?`         | `boolean`                                           |                                                   |
+| `extra?`            | `ReactNode`                                         |                                                   |
+| `hideAdd?`          | `boolean`                                           |                                                   |
+| `items`             | `TabItem[]`                                         |                                                   |
+| `keepMounted?`      | `boolean`                                           | Preserve mounted panel state when switching tabs. |
+| `onChange?`         | `(key: string) => void`                             |                                                   |
+| `onEdit?`           | `(action: 'add' \| 'remove', key?: string) => void` |                                                   |
+| `placement?`        | `'top' \| 'bottom' \| 'start' \| 'end'`             |                                                   |
+| `type?`             | `'line' \| 'card' \| 'editable-card'`               |                                                   |
+
+<sub>`src/components/Tag.tsx`</sub>
+
+### `CountTag`
+
+| Prop    | Type                    | Notes |
+| ------- | ----------------------- | ----- |
+| `count` | `number`                |       |
+| `tone?` | `'neutral' \| 'accent'` |       |
+
+### `LevelTag`
+
+| Prop         | Type     | Notes |
+| ------------ | -------- | ----- |
+| `className?` | `string` |       |
+| `level`      | `string` |       |
+
+### `statusColor`
+
+_No props type — see the source._
+
+### `StatusTag`
+
+| Prop         | Type        | Notes |
+| ------------ | ----------- | ----- |
+| `className?` | `string`    |       |
+| `label?`     | `ReactNode` |       |
+| `status`     | `string`    |       |
+
+### `Tag`
+
+Also accepts: `Omit<HTMLAttributes<HTMLSpanElement>, 'onChange'>`.
+
+| Prop              | Type                                             | Notes                                                                |
+| ----------------- | ------------------------------------------------ | -------------------------------------------------------------------- |
+| `checkable?`      | `boolean`                                        |                                                                      |
+| `checked?`        | `boolean`                                        |                                                                      |
+| `children`        | `ReactNode`                                      |                                                                      |
+| `className?`      | `string`                                         |                                                                      |
+| `closable?`       | `boolean`                                        |                                                                      |
+| `closeLabel?`     | `string`                                         |                                                                      |
+| `color?`          | `string`                                         | Explicit colour; defaults to the neutral surface.                    |
+| `defaultChecked?` | `boolean`                                        |                                                                      |
+| `disabled?`       | `boolean`                                        |                                                                      |
+| `icon?`           | `ReactNode`                                      |                                                                      |
+| `onChange?`       | `(checked: boolean) => void`                     |                                                                      |
+| `onClose?`        | `(event: MouseEvent<HTMLButtonElement>) => void` |                                                                      |
+| `pill?`           | `boolean`                                        | The fully-rounded shape. The default is the button's radius.         |
+| `size?`           | `'md' \| 'sm'`                                   | `sm` is the 22px chip the property strips print.                     |
+| `title?`          | `string`                                         |                                                                      |
+| `tone?`           | `'neutral' \| 'accent'`                          | The neutral surface, or the accent wash a classifying chip uses.     |
+| `variant?`        | `'solid' \| 'soft' \| 'outline'`                 | Solid pills carry state (status, level); soft/outline tags classify. |
+
+<sub>`src/components/Timeline.tsx`</sub>
+
+### `Timeline`
+
+A semantic chronological list; hosts own timestamps and activity meanings.
+
+Also accepts: `HTMLAttributes<HTMLOListElement>`.
+
+| Prop           | Type                                                   | Notes |
+| -------------- | ------------------------------------------------------ | ----- |
+| `items?`       | `TimelineItem[]`                                       |       |
+| `mode?`        | `'start' \| 'end' \| 'alternate' \| 'left' \| 'right'` |       |
+| `orientation?` | `'vertical' \| 'horizontal'`                           |       |
+| `pending?`     | `ReactNode`                                            |       |
+| `pendingDot?`  | `ReactNode`                                            |       |
+| `reverse?`     | `boolean`                                              |       |
+
+<sub>`src/components/TimePicker.tsx`</sub>
+
+### `TimePicker`
+
+Native accessible clock picker with Form/config integration and validation.
+
+Also accepts: `Omit< InputProps, 'type' | 'value' | 'defaultValue' | 'onChange' | 'step' | 'min' | 'max' >`.
+
+| Prop            | Type                         | Notes                                                                            |
+| --------------- | ---------------------------- | -------------------------------------------------------------------------------- |
+| `defaultValue?` | `string`                     |                                                                                  |
+| `disabledTime?` | `(value: string) => boolean` |                                                                                  |
+| `max?`          | `string`                     |                                                                                  |
+| `min?`          | `string`                     |                                                                                  |
+| `onChange?`     | `(value: string) => void`    |                                                                                  |
+| `step?`         | `number`                     | Seconds between native choices; 60 by default, use 1 to expose seconds.          |
+| `value?`        | `string`                     | Local clock time HH:mm or HH:mm:ss; no timezone conversion. Empty string clears. |
+
+<sub>`src/components/Toast.tsx`</sub>
+
+### `ToastAction`
+
+_Type._
+
+### `ToastPlacement`
+
+Where the stack is pinned: the six corners and edges of the viewport.
+
+_Type._
+
+### `ToastProvider`
+
+Toast host: a single live region that exists before any content arrives.
+
+| Prop         | Type             | Notes                                                                 |
+| ------------ | ---------------- | --------------------------------------------------------------------- |
+| `children`   | `ReactNode`      |                                                                       |
+| `className?` | `string`         |                                                                       |
+| `max?`       | `number`         | Caps the stack; the oldest toast leaves first. Unlimited by default.  |
+| `placement?` | `ToastPlacement` | Default `top-center`, which is where the product raises its messages. |
+
+### `ToastSpec`
+
+_Type._
+
+### `ToastTone`
+
+_Type._
+
+### `ToastVariant`
+
+`surface` is the white card the product raises (a toned hairline and icon); `filled` puts the same message on the tone's own colour, for a host that wants the confirmation to be unmissable.
+
+_Type._
+
+### `useToast`
+
+_No props type — see the source._
+
+<sub>`src/components/Tooltip.tsx`</sub>
+
+### `Tooltip`
+
+Lightweight text tooltip; the anchor keeps its own semantics.
+
+| Prop         | Type                | Notes                                                                     |
+| ------------ | ------------------- | ------------------------------------------------------------------------- |
+| `children`   | `ReactNode`         |                                                                           |
+| `delay?`     | `number`            | Milliseconds before the tooltip appears; keyboard focus shows it at once. |
+| `label`      | `ReactNode`         |                                                                           |
+| `placement?` | `'top' \| 'bottom'` |                                                                           |
+
+<sub>`src/components/Tour.tsx`</sub>
+
+### `Tour`
+
+| Prop                     | Type                                                                          | Notes |
+| ------------------------ | ----------------------------------------------------------------------------- | ----- |
+| `actionsRender?`         | `(actions: ReactNode, info: { current: number; total: number }) => ReactNode` |       |
+| `className?`             | `string`                                                                      |       |
+| `closable?`              | `boolean`                                                                     |       |
+| `current?`               | `number`                                                                      |       |
+| `defaultCurrent?`        | `number`                                                                      |       |
+| `defaultOpen?`           | `boolean`                                                                     |       |
+| `disabled?`              | `boolean`                                                                     |       |
+| `gap?`                   | `number`                                                                      |       |
+| `indicatorsRender?`      | `(current: number, total: number) => ReactNode`                               |       |
+| `keyboard?`              | `boolean`                                                                     |       |
+| `mask?`                  | `boolean`                                                                     |       |
+| `maskColor?`             | `string`                                                                      |       |
+| `onChange?`              | `(current: number) => void`                                                   |       |
+| `onClose?`               | `(current: number) => void`                                                   |       |
+| `onFinish?`              | `() => void`                                                                  |       |
+| `onOpenChange?`          | `(open: boolean) => void`                                                     |       |
+| `open?`                  | `boolean`                                                                     |       |
+| `placement?`             | `TourStep['placement']`                                                       |       |
+| `scrollIntoViewOptions?` | `false \| ScrollIntoViewOptions`                                              |       |
+| `steps`                  | `TourStep[]`                                                                  |       |
+| `style?`                 | `CSSProperties`                                                               |       |
+| `type?`                  | `'default' \| 'primary'`                                                      |       |
+
+### `TourStep`
+
+_Type._
+
+<sub>`src/components/Transfer.tsx`</sub>
+
+### `Transfer`
+
+Both selection states remain host-owned when controlled; moves preserve unknown targets.
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children'>`.
+
+| Prop                   | Type                                                                                      | Notes |
+| ---------------------- | ----------------------------------------------------------------------------------------- | ----- |
+| `'aria-label'`         | `string`                                                                                  |       |
+| `children?`            | `(props: TransferListProps) => ReactNode`                                                 |       |
+| `defaultSelectedKeys?` | `string[]`                                                                                |       |
+| `defaultTargetKeys?`   | `string[]`                                                                                |       |
+| `disabled?`            | `boolean`                                                                                 |       |
+| `emptyState?`          | `ReactNode`                                                                               |       |
+| `errorState?`          | `ReactNode`                                                                               |       |
+| `filterOption?`        | `(query: string, item: TransferItem, direction: TransferDirection) => boolean`            |       |
+| `footer?`              | `(props: TransferListProps) => ReactNode`                                                 |       |
+| `items`                | `TransferItem[]`                                                                          |       |
+| `onChange?`            | `(keys: string[], direction: TransferDirection, moveKeys: string[]) => void`              |       |
+| `onSearch?`            | `(direction: TransferDirection, query: string) => void`                                   |       |
+| `onSelectChange?`      | `(sourceSelectedKeys: string[], targetSelectedKeys: string[]) => void`                    |       |
+| `pagination?`          | `boolean \| { pageSize?: number; showSizeChanger?: boolean; pageSizeOptions?: number[] }` |       |
+| `render?`              | `(item: TransferItem) => ReactNode`                                                       |       |
+| `searchable?`          | `boolean`                                                                                 |       |
+| `selectedKeys?`        | `string[]`                                                                                |       |
+| `showSelectAll?`       | `boolean`                                                                                 |       |
+| `status?`              | `'ready' \| 'loading' \| 'error'`                                                         |       |
+| `targetKeys?`          | `string[]`                                                                                |       |
+| `titles?`              | `[string, string]`                                                                        |       |
+
+### `TransferDirection`
+
+_Type._
+
+### `TransferItem`
+
+_Type._
+
+<sub>`src/components/Tree.tsx`</sub>
+
+### `DirectoryTree`
+
+File-browser selection with Ctrl/Meta toggles and Shift ranges.
+
+| Prop                   | Type                                                                                                                     | Notes                                                                    |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
+| `'aria-label'?`        | `string`                                                                                                                 |                                                                          |
+| `allowDrop?`           | `(info: { dropNode: TreeNode \| null; dragNode: TreeNode; dropPosition: -1 \| 0 \| 1 }) => boolean`                      |                                                                          |
+| `autoExpandParent?`    | `boolean`                                                                                                                |                                                                          |
+| `blockNode?`           | `boolean`                                                                                                                |                                                                          |
+| `checkable?`           | `boolean`                                                                                                                |                                                                          |
+| `checkedKeys?`         | `TreeCheckedKeys`                                                                                                        |                                                                          |
+| `checkStrictly?`       | `boolean`                                                                                                                |                                                                          |
+| `className?`           | `string`                                                                                                                 |                                                                          |
+| `classNames?`          | `Partial<Record<TreeSemantic, string>>`                                                                                  |                                                                          |
+| `defaultCheckedKeys?`  | `string[]`                                                                                                               |                                                                          |
+| `defaultExpandAll?`    | `boolean`                                                                                                                |                                                                          |
+| `defaultExpanded?`     | `string[]`                                                                                                               |                                                                          |
+| `defaultExpandedKeys?` | `string[]`                                                                                                               |                                                                          |
+| `defaultExpandParent?` | `boolean`                                                                                                                |                                                                          |
+| `defaultLoadedKeys?`   | `string[]`                                                                                                               |                                                                          |
+| `defaultSelectedKeys?` | `string[]`                                                                                                               |                                                                          |
+| `disabled?`            | `boolean`                                                                                                                |                                                                          |
+| `draggable?`           | `boolean \| ((node: TreeNode) => boolean) \| { icon?: ReactNode \| false; nodeDraggable?: (node: TreeNode) => boolean }` |                                                                          |
+| `expandAction?`        | `false \| 'click' \| 'doubleClick'`                                                                                      | Directory behavior; the regular Tree expands from its caret by default.  |
+| `expandedKeys?`        | `string[]`                                                                                                               |                                                                          |
+| `fieldNames?`          | `{ key?: string; title?: string; children?: string }`                                                                    |                                                                          |
+| `filterTreeNode?`      | `(node: TreeNode) => boolean`                                                                                            |                                                                          |
+| `height?`              | `number`                                                                                                                 | Fixed row height virtualization; virtual defaults on when height is set. |
+| `icon?`                | `ReactNode \| ((state: TreeNodeState) => ReactNode)`                                                                     |                                                                          |
+| `indent?`              | `number`                                                                                                                 |                                                                          |
+| `itemHeight?`          | `number`                                                                                                                 |                                                                          |
+| `loadData?`            | `(node: TreeNode) => Promise<TreeNode[] \| void>`                                                                        | May return children, or update host-owned data and resolve void.         |
+| `loadedKeys?`          | `string[]`                                                                                                               |                                                                          |
+| `motion?`              | `boolean`                                                                                                                | CSS transitions; false disables them (reduced motion is respected).      |
+| `movable?`             | `(node: TreeNode) => boolean`                                                                                            |                                                                          |
+| `multiple?`            | `boolean`                                                                                                                |                                                                          |
+| `nodeActions?`         | `(node: TreeNode) => ReactNode`                                                                                          |                                                                          |
+| `nodeContextMenu?`     | `(node: TreeNode) => ContextMenuItem[]`                                                                                  |                                                                          |
+| `nodes?`               | `TreeNode[]`                                                                                                             | Existing Klun data contract. Use either nodes or treeData.               |
+| `onCheck?`             | `(keys: TreeCheckedKeys, info: TreeCheckInfo) => void`                                                                   |                                                                          |
+| `onDoubleClick?`       | `(event: MouseEvent, node: TreeNode) => void`                                                                            |                                                                          |
+| `onDragEnd?`           | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDragEnter?`         | `(info: TreeDragInfo & { expandedKeys: string[] }) => void`                                                              |                                                                          |
+| `onDragLeave?`         | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDragOver?`          | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDragStart?`         | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDrop?`              | `(info: TreeDropInfo) => void`                                                                                           |                                                                          |
+| `onExpand?`            | `(keys: string[], info: { expanded: boolean; node: TreeNode }) => void`                                                  |                                                                          |
+| `onLoad?`              | `(keys: string[], info: { node: TreeNode }) => void`                                                                     |                                                                          |
+| `onLoadError?`         | `(error: unknown, node: TreeNode) => void`                                                                               |                                                                          |
+| `onMove?`              | `TreeMoveHandler`                                                                                                        |                                                                          |
+| `onRightClick?`        | `(info: { event: MouseEvent; node: TreeNode }) => void`                                                                  |                                                                          |
+| `onSelect?`            | `(node: TreeNode) => void`                                                                                               |                                                                          |
+| `onSelectionChange?`   | `(keys: string[], info: TreeSelectionInfo) => void`                                                                      |                                                                          |
+| `searchValue?`         | `string`                                                                                                                 | Highlights matches and reveals ancestors without discarding nodes.       |
+| `selectable?`          | `boolean`                                                                                                                |                                                                          |
+| `selectedKeys?`        | `string[]`                                                                                                               |                                                                          |
+| `showIcon?`            | `boolean`                                                                                                                |                                                                          |
+| `showLine?`            | `boolean \| { showLeafIcon?: ReactNode \| ((state: TreeNodeState) => ReactNode) }`                                       |                                                                          |
+| `style?`               | `CSSProperties`                                                                                                          |                                                                          |
+| `styles?`              | `Partial<Record<TreeSemantic, CSSProperties>>`                                                                           |                                                                          |
+| `switcherIcon?`        | `ReactNode \| ((state: TreeNodeState) => ReactNode)`                                                                     |                                                                          |
+| `switcherLoadingIcon?` | `ReactNode`                                                                                                              |                                                                          |
+| `titleRender?`         | `(node: TreeNode) => ReactNode`                                                                                          |                                                                          |
+| `treeData?`            | `TreeDataNode[] \| Record<string, unknown>[]`                                                                            |                                                                          |
+| `value?`               | `string \| null`                                                                                                         | Legacy route selection and callback remain compatible.                   |
+| `virtual?`             | `boolean`                                                                                                                |                                                                          |
+
+### `Tree`
+
+| Prop                   | Type                                                                                                                     | Notes                                                                    |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
+| `'aria-label'?`        | `string`                                                                                                                 |                                                                          |
+| `allowDrop?`           | `(info: { dropNode: TreeNode \| null; dragNode: TreeNode; dropPosition: -1 \| 0 \| 1 }) => boolean`                      |                                                                          |
+| `autoExpandParent?`    | `boolean`                                                                                                                |                                                                          |
+| `blockNode?`           | `boolean`                                                                                                                |                                                                          |
+| `checkable?`           | `boolean`                                                                                                                |                                                                          |
+| `checkedKeys?`         | `TreeCheckedKeys`                                                                                                        |                                                                          |
+| `checkStrictly?`       | `boolean`                                                                                                                |                                                                          |
+| `className?`           | `string`                                                                                                                 |                                                                          |
+| `classNames?`          | `Partial<Record<TreeSemantic, string>>`                                                                                  |                                                                          |
+| `defaultCheckedKeys?`  | `string[]`                                                                                                               |                                                                          |
+| `defaultExpandAll?`    | `boolean`                                                                                                                |                                                                          |
+| `defaultExpanded?`     | `string[]`                                                                                                               |                                                                          |
+| `defaultExpandedKeys?` | `string[]`                                                                                                               |                                                                          |
+| `defaultExpandParent?` | `boolean`                                                                                                                |                                                                          |
+| `defaultLoadedKeys?`   | `string[]`                                                                                                               |                                                                          |
+| `defaultSelectedKeys?` | `string[]`                                                                                                               |                                                                          |
+| `disabled?`            | `boolean`                                                                                                                |                                                                          |
+| `draggable?`           | `boolean \| ((node: TreeNode) => boolean) \| { icon?: ReactNode \| false; nodeDraggable?: (node: TreeNode) => boolean }` |                                                                          |
+| `expandAction?`        | `false \| 'click' \| 'doubleClick'`                                                                                      | Directory behavior; the regular Tree expands from its caret by default.  |
+| `expandedKeys?`        | `string[]`                                                                                                               |                                                                          |
+| `fieldNames?`          | `{ key?: string; title?: string; children?: string }`                                                                    |                                                                          |
+| `filterTreeNode?`      | `(node: TreeNode) => boolean`                                                                                            |                                                                          |
+| `height?`              | `number`                                                                                                                 | Fixed row height virtualization; virtual defaults on when height is set. |
+| `icon?`                | `ReactNode \| ((state: TreeNodeState) => ReactNode)`                                                                     |                                                                          |
+| `indent?`              | `number`                                                                                                                 |                                                                          |
+| `itemHeight?`          | `number`                                                                                                                 |                                                                          |
+| `loadData?`            | `(node: TreeNode) => Promise<TreeNode[] \| void>`                                                                        | May return children, or update host-owned data and resolve void.         |
+| `loadedKeys?`          | `string[]`                                                                                                               |                                                                          |
+| `motion?`              | `boolean`                                                                                                                | CSS transitions; false disables them (reduced motion is respected).      |
+| `movable?`             | `(node: TreeNode) => boolean`                                                                                            |                                                                          |
+| `multiple?`            | `boolean`                                                                                                                |                                                                          |
+| `nodeActions?`         | `(node: TreeNode) => ReactNode`                                                                                          |                                                                          |
+| `nodeContextMenu?`     | `(node: TreeNode) => ContextMenuItem[]`                                                                                  |                                                                          |
+| `nodes?`               | `TreeNode[]`                                                                                                             | Existing Klun data contract. Use either nodes or treeData.               |
+| `onCheck?`             | `(keys: TreeCheckedKeys, info: TreeCheckInfo) => void`                                                                   |                                                                          |
+| `onDoubleClick?`       | `(event: MouseEvent, node: TreeNode) => void`                                                                            |                                                                          |
+| `onDragEnd?`           | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDragEnter?`         | `(info: TreeDragInfo & { expandedKeys: string[] }) => void`                                                              |                                                                          |
+| `onDragLeave?`         | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDragOver?`          | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDragStart?`         | `(info: TreeDragInfo) => void`                                                                                           |                                                                          |
+| `onDrop?`              | `(info: TreeDropInfo) => void`                                                                                           |                                                                          |
+| `onExpand?`            | `(keys: string[], info: { expanded: boolean; node: TreeNode }) => void`                                                  |                                                                          |
+| `onLoad?`              | `(keys: string[], info: { node: TreeNode }) => void`                                                                     |                                                                          |
+| `onLoadError?`         | `(error: unknown, node: TreeNode) => void`                                                                               |                                                                          |
+| `onMove?`              | `TreeMoveHandler`                                                                                                        |                                                                          |
+| `onRightClick?`        | `(info: { event: MouseEvent; node: TreeNode }) => void`                                                                  |                                                                          |
+| `onSelect?`            | `(node: TreeNode) => void`                                                                                               |                                                                          |
+| `onSelectionChange?`   | `(keys: string[], info: TreeSelectionInfo) => void`                                                                      |                                                                          |
+| `searchValue?`         | `string`                                                                                                                 | Highlights matches and reveals ancestors without discarding nodes.       |
+| `selectable?`          | `boolean`                                                                                                                |                                                                          |
+| `selectedKeys?`        | `string[]`                                                                                                               |                                                                          |
+| `showIcon?`            | `boolean`                                                                                                                |                                                                          |
+| `showLine?`            | `boolean \| { showLeafIcon?: ReactNode \| ((state: TreeNodeState) => ReactNode) }`                                       |                                                                          |
+| `style?`               | `CSSProperties`                                                                                                          |                                                                          |
+| `styles?`              | `Partial<Record<TreeSemantic, CSSProperties>>`                                                                           |                                                                          |
+| `switcherIcon?`        | `ReactNode \| ((state: TreeNodeState) => ReactNode)`                                                                     |                                                                          |
+| `switcherLoadingIcon?` | `ReactNode`                                                                                                              |                                                                          |
+| `titleRender?`         | `(node: TreeNode) => ReactNode`                                                                                          |                                                                          |
+| `treeData?`            | `TreeDataNode[] \| Record<string, unknown>[]`                                                                            |                                                                          |
+| `value?`               | `string \| null`                                                                                                         | Legacy route selection and callback remain compatible.                   |
+| `virtual?`             | `boolean`                                                                                                                |                                                                          |
+
+### `TreeCheckedKeys`
+
+_Type._
+
+### `TreeCheckInfo`
+
+_Type._
+
+### `TreeDataNode`
+
+_Type._
+
+### `TreeDragInfo`
+
+_Type._
+
+### `TreeDropInfo`
+
+_Type._
+
+### `TreeGroup`
+
+Small caps section label between tree groups.
+
+| Prop      | Type        | Notes |
+| --------- | ----------- | ----- |
+| `action?` | `ReactNode` |       |
+| `label`   | `ReactNode` |       |
+
+### `TreeMoveHandler`
+
+_Type._
+
+### `TreeMovePosition`
+
+_Type._
+
+### `TreeNode`
+
+_Type._
+
+### `TreeNodeState`
+
+_Type._
+
+### `TreeRef`
+
+_Type._
+
+### `TreeSelectionInfo`
+
+_Type._
+
+### `TreeSemantic`
+
+_Type._
+
+<sub>`src/components/TreeSelect.tsx`</sub>
+
+### `TreeSelect`
+
+Hierarchical selection reuses Tree's check conduction, keyboard and lazy loading.
+
+Also accepts: `AriaAttributes`, `( | { multiple?: false; treeCheckable?: false; value?: string | null; defaultValue?: string | null; onChange?: (value: string | null, labels: ReactNode[]) => void; } | { multiple: true; value?: string[]; defaultValue?: string[]; onChange?: (value: string[], labels: ReactNode[]) => void; } | { treeCheckable: true; multiple?: boolean; value?: string[]; defaultValue?: string[]; onChange?: (value: string[], labels: ReactNode[]) => void; } )`.
+
+| Prop                 | Type                                                                                                                                                                                                                                                                          | Notes                                                                     |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `allowClear?`        | `boolean`                                                                                                                                                                                                                                                                     |                                                                           |
+| `className?`         | `string`                                                                                                                                                                                                                                                                      |                                                                           |
+| `clearLabel?`        | `string`                                                                                                                                                                                                                                                                      |                                                                           |
+| `defaultOpen?`       | `boolean`                                                                                                                                                                                                                                                                     |                                                                           |
+| `disabled?`          | `boolean`                                                                                                                                                                                                                                                                     |                                                                           |
+| `id?`                | `string`                                                                                                                                                                                                                                                                      |                                                                           |
+| `name?`              | `string`                                                                                                                                                                                                                                                                      |                                                                           |
+| `onBlur?`            | `FocusEventHandler<HTMLDivElement>`                                                                                                                                                                                                                                           |                                                                           |
+| `onFocus?`           | `FocusEventHandler<HTMLDivElement>`                                                                                                                                                                                                                                           |                                                                           |
+| `onOpenChange?`      | `(open: boolean) => void`                                                                                                                                                                                                                                                     |                                                                           |
+| `open?`              | `boolean`                                                                                                                                                                                                                                                                     |                                                                           |
+| `placeholder?`       | `ReactNode`                                                                                                                                                                                                                                                                   |                                                                           |
+| `placement?`         | `Placement`                                                                                                                                                                                                                                                                   |                                                                           |
+| `showSearch?`        | `boolean`                                                                                                                                                                                                                                                                     |                                                                           |
+| `style?`             | `CSSProperties`                                                                                                                                                                                                                                                               |                                                                           |
+| `treeCheckable?`     | `boolean`                                                                                                                                                                                                                                                                     |                                                                           |
+| `treeCheckStrictly?` | `boolean`                                                                                                                                                                                                                                                                     |                                                                           |
+| `treeData`           | `TreeSelectNode[]`                                                                                                                                                                                                                                                            |                                                                           |
+| `treeProps?`         | `Omit< TreeProps, \| 'nodes' \| 'treeData' \| 'value' \| 'onSelect' \| 'selectedKeys' \| 'defaultSelectedKeys' \| 'onSelectionChange' \| 'multiple' \| 'checkable' \| 'checkStrictly' \| 'checkedKeys' \| 'defaultCheckedKeys' \| 'onCheck' \| 'disabled' \| 'searchValue' >` | Reuse Tree expansion, loading, filtering and virtual scrolling contracts. |
+
+### `TreeSelectNode`
+
+_Type._
+
+<sub>`src/components/Typography.tsx`</sub>
+
+### `Typography`
+
+Also accepts: `HTMLAttributes<HTMLElement>`.
+
+| Prop         | Type                                                                                                                                                                                                    | Notes |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| `as?`        | `'div' \| 'span' \| 'p' \| 'h1' \| 'h2' \| 'h3' \| 'h4' \| 'h5'`                                                                                                                                        |       |
+| `code?`      | `boolean`                                                                                                                                                                                               |       |
+| `copyable?`  | `\| boolean \| { text?: string \| (() => string \| Promise<string>); onCopy?: () => void; onError?: (error: unknown) => void }`                                                                         |       |
+| `delete?`    | `boolean`                                                                                                                                                                                               |       |
+| `disabled?`  | `boolean`                                                                                                                                                                                               |       |
+| `editable?`  | `\| boolean \| { text?: string; editing?: boolean; onEditingChange?: (editing: boolean) => void; onStart?: () => void; onChange?: (text: string) => void; onCancel?: () => void; maxLength?: number; }` |       |
+| `ellipsis?`  | `\| boolean \| { rows?: number; expandable?: boolean; expanded?: boolean; defaultExpanded?: boolean; onExpand?: (expanded: boolean) => void; }`                                                         |       |
+| `italic?`    | `boolean`                                                                                                                                                                                               |       |
+| `keyboard?`  | `boolean`                                                                                                                                                                                               |       |
+| `mark?`      | `boolean`                                                                                                                                                                                               |       |
+| `strong?`    | `boolean`                                                                                                                                                                                               |       |
+| `type?`      | `'secondary' \| 'success' \| 'warning' \| 'danger'`                                                                                                                                                     |       |
+| `underline?` | `boolean`                                                                                                                                                                                               |       |
+
+<sub>`src/components/Upload.tsx`</sub>
+
+### `Upload`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onError'>`.
+
+| Prop               | Type                                                                                                                                                        | Notes |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| `accept?`          | `string`                                                                                                                                                    |       |
+| `action?`          | `string`                                                                                                                                                    |       |
+| `beforeUpload?`    | `( file: File, files: File[], ) => boolean \| void \| File \| Blob \| typeof LIST_IGNORE \| Promise<boolean \| void \| File \| Blob \| typeof LIST_IGNORE>` |       |
+| `children?`        | `ReactNode`                                                                                                                                                 |       |
+| `customRequest?`   | `(options: UploadRequestOptions) => void \| { abort: () => void }`                                                                                          |       |
+| `data?`            | `Record<string, string>`                                                                                                                                    |       |
+| `defaultFileList?` | `UploadFile[]`                                                                                                                                              |       |
+| `disabled?`        | `boolean`                                                                                                                                                   |       |
+| `drag?`            | `boolean`                                                                                                                                                   |       |
+| `fileList?`        | `UploadFile[]`                                                                                                                                              |       |
+| `headers?`         | `Record<string, string>`                                                                                                                                    |       |
+| `maxCount?`        | `number`                                                                                                                                                    |       |
+| `multiple?`        | `boolean`                                                                                                                                                   |       |
+| `name?`            | `string`                                                                                                                                                    |       |
+| `onChange?`        | `(info: UploadChange) => void`                                                                                                                              |       |
+| `onRemove?`        | `(file: UploadFile) => boolean \| void \| Promise<boolean \| void>`                                                                                         |       |
+| `showUploadList?`  | `boolean`                                                                                                                                                   |       |
+| `withCredentials?` | `boolean`                                                                                                                                                   |       |
+
+<sub>`src/components/Watermark.tsx`</sub>
+
+### `Watermark`
+
+Also accepts: `Omit<HTMLAttributes<HTMLDivElement>, 'content'>`.
+
+| Prop        | Type                                                     | Notes |
+| ----------- | -------------------------------------------------------- | ----- |
+| `content?`  | `string \| WatermarkText \| (string \| WatermarkText)[]` |       |
+| `font?`     | `WatermarkFont`                                          |       |
+| `gap?`      | `[number, number]`                                       |       |
+| `height?`   | `number`                                                 |       |
+| `image?`    | `string`                                                 |       |
+| `offset?`   | `[number, number]`                                       |       |
+| `onRemove?` | `() => void`                                             |       |
+| `rotate?`   | `number`                                                 |       |
+| `width?`    | `number`                                                 |       |
+| `zIndex?`   | `number`                                                 |       |
+
+### `WatermarkFont`
+
+_Type._
+
+### `WatermarkText`
+
+_Type._
+
+## Ship surface
+
+<sub>`src/ship/AttachmentUpload.tsx`</sub>
+
+### `AttachmentUpload`
+
+The detail sheet's attachment tool: a drop zone that also opens the file picker, a real per-file read with a progress bar, and the list of files already linked to this record with a confirmed unlink.
+
+| Prop          | Type                                              | Notes                                                                                |
+| ------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| `currentUser` | `string`                                          | The signed-in author — the host attributes the upload when it stores it.             |
+| `entityId?`   | `string`                                          | Record identity: changing it cancels pending reads and resets attachment dialogs.    |
+| `files`       | `Array<{ relationId: string; file: Attachment }>` | Files already linked to the record, in the order the list should show them.          |
+| `label?`      | `string`                                          | Rendered at the right of the drop zone header.                                       |
+| `maxSizeMb?`  | `number`                                          | Hard limit per file; anything larger is refused before a byte is read.               |
+| `onNotify?`   | `Notify`                                          | Raised for the two failures no callback can carry: a refused file and a broken read. |
+
+<sub>`src/ship/Bits.tsx`</sub>
+
+### `EntityKind`
+
+Entity kinds Ship renders with a coloured badge in front of the title.
+
+_Type._
+
+### `ProductCell`
+
+Product row in the products table: module icon, name, private lock.
+
+| Prop       | Type         | Notes |
+| ---------- | ------------ | ----- |
+| `locked?`  | `boolean`    |       |
+| `name`     | `string`     |       |
+| `onClick?` | `() => void` |       |
+
+### `QuickStart`
+
+The floating "Quick start" pill anchored to the bottom-right of the shell.
+
+| Prop       | Type         | Notes                                                  |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `done?`    | `number`     | Steps completed; shown only when `total` is given too. |
+| `label?`   | `string`     |                                                        |
+| `onClick?` | `() => void` |                                                        |
+| `total?`   | `number`     |                                                        |
+
+### `StarButton`
+
+| Prop       | Type         | Notes |
+| ---------- | ------------ | ----- |
+| `on`       | `boolean`    |       |
+| `onToggle` | `() => void` |       |
+
+### `TableBanner`
+
+| Prop           | Type                 | Notes |
+| -------------- | -------------------- | ----- |
+| `actionLabel?` | `string`             |       |
+| `children`     | `ReactNode`          |       |
+| `icon?`        | `IconName \| string` |       |
+| `onAction?`    | `() => void`         |       |
+
+### `TitleCell`
+
+Title cell: type badge + truncated title, struck through when completed.
+
+| Prop       | Type                     | Notes                                                                                                                                                                                                                         |
+| ---------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `done?`    | `boolean`                |                                                                                                                                                                                                                               |
+| `kind`     | `EntityKind`             |                                                                                                                                                                                                                               |
+| `leading?` | `ReactNode`              | Replaces the type badge with the mark the live grid uses for this kind — the Customer grid opens every name with a filled circle carrying the record's glyph. Pass an `IconAvatar`; the cell keeps its own layout either way. |
+| `onClick?` | `() => void`             |                                                                                                                                                                                                                               |
+| `onEdit?`  | `(next: string) => void` | Double-click the title to rename it in place; Enter commits, Esc cancels.                                                                                                                                                     |
+| `suffix?`  | `ReactNode`              |                                                                                                                                                                                                                               |
+| `title`    | `string`                 |                                                                                                                                                                                                                               |
+
+### `TypeBadge`
+
+| Prop    | Type         | Notes |
+| ------- | ------------ | ----- |
+| `kind`  | `EntityKind` |       |
+| `size?` | `number`     |       |
+
+### `VoteCount`
+
+The vote counter a ticket row and a ticket sheet show.
+
+| Prop         | Type     | Notes |
+| ------------ | -------- | ----- |
+| `className?` | `string` |       |
+| `count`      | `number` |       |
+
+<sub>`src/ship/CommentThread.tsx`</sub>
+
+### `CommentThread`
+
+The editable comment area from the detail sheet: the thread oldest → newest with replies indented under their parent, inline edit, confirmed delete, reactions and the composer.
+
+| Prop          | Type         | Notes                                                                      |
+| ------------- | ------------ | -------------------------------------------------------------------------- |
+| `activities?` | `Activity[]` | The record's activity rows, accepted so a host can hand over one feed.     |
+| `comments`    | `Comment[]`  | Every comment of the record, replies included — the thread orders them.    |
+| `currentUser` | `string`     | The signed-in author: owns the edit and delete actions and the reactions.  |
+| `emptyHint?`  | `string`     | Explanation under the `No data available` title while the thread is empty. |
+| `onNotify?`   | `Notify`     | Raised for the one command no other callback carries: "Copy text".         |
+
+<sub>`src/ship/DetailBlock.tsx`</sub>
+
+### `DetailBlock`
+
+| Prop         | Type        | Notes                                                                  |
+| ------------ | ----------- | ---------------------------------------------------------------------- |
+| `actions?`   | `ReactNode` | Right-aligned controls in the head: an edit button, a counter, a menu. |
+| `children`   | `ReactNode` |                                                                        |
+| `className?` | `string`    |                                                                        |
+| `title?`     | `ReactNode` |                                                                        |
+
+### `DetailTool`
+
+| Prop         | Type                 | Notes                                                  |
+| ------------ | -------------------- | ------------------------------------------------------ |
+| `children?`  | `ReactNode`          |                                                        |
+| `className?` | `string`             |                                                        |
+| `icon?`      | `IconName \| string` |                                                        |
+| `label?`     | `string`             | `aria-label`; required when there is no visible label. |
+| `onClick?`   | `() => void`         |                                                        |
+
+<sub>`src/ship/DetailSheet.tsx`</sub>
+
+### `CommentComposer`
+
+The comment composer from the live detail sheet: the author's avatar, a bordered field whose toolbar sits inside its bottom edge, the character counter and a labelled Send.
+
+| Prop              | Type                                                | Notes                                                                                                                                                |
+| ----------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `author?`         | `string`                                            | The signed-in user, shown on the avatar left of the field.                                                                                           |
+| `className?`      | `string`                                            |                                                                                                                                                      |
+| `disabled?`       | `boolean`                                           |                                                                                                                                                      |
+| `maxLength?`      | `number`                                            | Character budget the field enforces; the live caps a comment at 4096.                                                                                |
+| `onAttachFile?`   | `(file: File) => void`                              | `+` → Attach file, handed the picked file. Without a handler the composer still does something honest with the pick: it names the file in the draft. |
+| `onChange`        | `(value: string) => void`                           |                                                                                                                                                      |
+| `onLinkWorkItem?` | `() => void`                                        | `+` → Link work item. Defaults to dropping a `#` at the caret.                                                                                       |
+| `onSubmit`        | `() => void \| boolean \| Promise<void \| boolean>` |                                                                                                                                                      |
+| `placeholder?`    | `string`                                            |                                                                                                                                                      |
+| `readOnly?`       | `boolean`                                           |                                                                                                                                                      |
+| `value`           | `string`                                            |                                                                                                                                                      |
+
+### `DetailField`
+
+One `label — value` line inside a section or the property strip.
+
+| Prop       | Type                 | Notes |
+| ---------- | -------------------- | ----- |
+| `children` | `ReactNode`          |       |
+| `icon?`    | `IconName \| string` |       |
+| `label`    | `ReactNode`          |       |
+| `onEdit?`  | `() => void`         |       |
+
+### `DetailProperty`
+
+_Type._
+
+### `DetailSection`
+
+Collapsible metadata group in the right rail.
+
+| Prop           | Type        | Notes |
+| -------------- | ----------- | ----- |
+| `actions?`     | `ReactNode` |       |
+| `children`     | `ReactNode` |       |
+| `defaultOpen?` | `boolean`   |       |
+| `title`        | `ReactNode` |       |
+
+### `DetailSheet`
+
+The entity sheet PingCode opens over the grid: identity bar, title, the property strip, tabs, the main column and the metadata rail.
+
+| Prop          | Type                                   | Notes                                          |
+| ------------- | -------------------------------------- | ---------------------------------------------- |
+| `activeTab`   | `string`                               |                                                |
+| `aside`       | `ReactNode`                            |                                                |
+| `children`    | `ReactNode`                            |                                                |
+| `className?`  | `string`                               |                                                |
+| `code`        | `ReactNode`                            | The human key, e.g. `SLC-T1`.                  |
+| `composer?`   | `ReactNode`                            |                                                |
+| `kind`        | `EntityKind`                           |                                                |
+| `onClose`     | `() => void`                           |                                                |
+| `onTabChange` | `(id: string) => void`                 |                                                |
+| `properties?` | `DetailProperty[]`                     |                                                |
+| `tabs`        | `Array<{ id: string; label: string }>` |                                                |
+| `title`       | `ReactNode`                            |                                                |
+| `tools?`      | `ReactNode`                            | Header tools (attachments, links, font size…). |
+
+### `Feed`
+
+Comments / activities / transitions share one timeline.
+
+| Prop      | Type          | Notes |
+| --------- | ------------- | ----- |
+| `empty?`  | `ReactNode`   |       |
+| `entries` | `FeedEntry[]` |       |
+
+### `FeedEntry`
+
+_Type._
+
+### `FeedFilter`
+
+Segmented filter above the feed (Comments / Activities / Transitions).
+
+| Prop       | Type                                   | Notes |
+| ---------- | -------------------------------------- | ----- |
+| `onChange` | `(value: string) => void`              |       |
+| `options`  | `Array<{ id: string; label: string }>` |       |
+| `right?`   | `ReactNode`                            |       |
+| `value`    | `string`                               |       |
+
+<sub>`src/ship/EditableText.tsx`</sub>
+
+### `EditableText`
+
+| Prop               | Type                         | Notes                                                                                                                                      |
+| ------------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `className?`       | `string`                     |                                                                                                                                            |
+| `defaultDraft?`    | `string`                     |                                                                                                                                            |
+| `defaultEditing?`  | `boolean`                    |                                                                                                                                            |
+| `disabled?`        | `boolean`                    |                                                                                                                                            |
+| `draft?`           | `string`                     | Controlled draft.                                                                                                                          |
+| `editing?`         | `boolean`                    | Controlled editing state.                                                                                                                  |
+| `editSeed?`        | `string`                     | Text the editor starts from when it differs from the read view — an entity whose stored copy is a template the product prints differently. |
+| `label?`           | `string`                     | Accessible name for the editor and the edit button; defaults to `title`.                                                                   |
+| `note?`            | `ReactNode`                  | Extra node under the body — a provenance note, a hint, a counter.                                                                          |
+| `onDraftChange?`   | `(draft: string) => void`    |                                                                                                                                            |
+| `onEditingChange?` | `(editing: boolean) => void` |                                                                                                                                            |
+| `onSave?`          | `(next: string) => void`     | Called with the committed value when the host presses Save.                                                                                |
+| `paragraphs?`      | `boolean`                    | Render blank-line-separated paragraphs instead of one block of text.                                                                       |
+| `readOnly?`        | `boolean`                    | Hides the edit affordance: a released or derived block cannot be edited.                                                                   |
+| `rows?`            | `number`                     | Editor height in rows.                                                                                                                     |
+| `text`             | `string`                     |                                                                                                                                            |
+| `title`            | `ReactNode`                  |                                                                                                                                            |
+
+<sub>`src/ship/EntityDialog.tsx`</sub>
+
+### `DialogField`
+
+_Type._
+
+### `EntityDialog`
+
+The "New …" sheet: near-full-height, a form column and a metadata column, a dirty guard on close, and validation that waits for the first blur instead of shouting on the first keystroke.
+
+| Prop             | Type                                                        | Notes                                                                   |
+| ---------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------- |
+| `asideFields?`   | `DialogField[]`                                             |                                                                         |
+| `fields`         | `DialogField[]`                                             |                                                                         |
+| `initialValues?` | `Record<string, string>`                                    | Prefills the form and switches the footer to "Save" (edit, not create). |
+| `kind`           | `EntityKind`                                                |                                                                         |
+| `onClose`        | `() => void`                                                |                                                                         |
+| `onSubmit`       | `(values: Record<string, string>) => void \| Promise<void>` |                                                                         |
+| `open`           | `boolean`                                                   |                                                                         |
+| `submitLabel?`   | `string`                                                    |                                                                         |
+| `title`          | `string`                                                    | Dialog title, e.g. "New idea".                                          |
+
+<sub>`src/ship/EntityPicker.tsx`</sub>
+
+### `EntityPicker`
+
+| Prop             | Type                                                                                                                    | Notes                                                                                                                          |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `columns?`       | `Array<Column<T>>`                                                                                                      | `table` only: the columns.                                                                                                     |
+| `confirmLabel?`  | `(state: EntityPickerState) => string`                                                                                  | Confirm button copy for the current counts.                                                                                    |
+| `count?`         | `ReactNode`                                                                                                             |                                                                                                                                |
+| `emptyState?`    | `ReactNode`                                                                                                             |                                                                                                                                |
+| `fields?`        | `FilterField[]`                                                                                                         |                                                                                                                                |
+| `hint?`          | `(state: EntityPickerState) => ReactNode`                                                                               | Footer copy for the current counts.                                                                                            |
+| `linked?`        | `string[]`                                                                                                              | Ids already related — the baseline the link/unlink counts are measured against.                                                |
+| `onChange`       | `(next: string[]) => void`                                                                                              |                                                                                                                                |
+| `onClose`        | `() => void`                                                                                                            |                                                                                                                                |
+| `onConfirm`      | `(selected: string[]) => void \| Promise<void>`                                                                         | Confirmed with the ticked ids; the host writes the relations.                                                                  |
+| `onRulesChange?` | `(rules: FilterRule[]) => void`                                                                                         |                                                                                                                                |
+| `onSortChange?`  | `(sort: SortState) => void`                                                                                             |                                                                                                                                |
+| `renderLabel?`   | `(row: T) => ReactNode`                                                                                                 | `list` only: what each row shows next to its tick.                                                                             |
+| `renderMeta?`    | `(row: T) => ReactNode`                                                                                                 | `list` only: the trailing cell of a row (a status pill, a count).                                                              |
+| `rowKey`         | `(row: T) => string`                                                                                                    |                                                                                                                                |
+| `rows`           | `T[]`                                                                                                                   | The candidates the host offers; the picker never fetches.                                                                      |
+| `rules?`         | `FilterRule[]`                                                                                                          |                                                                                                                                |
+| `scopes?`        | `{ nodes: TreeNode[]; value: string; onChange: (id: string) => void; defaultExpanded?: string[]; ariaLabel?: string; }` | Optional scope tree down the left side.                                                                                        |
+| `search?`        | `{ value: string; onChange: (value: string) => void; placeholder?: string; ariaLabel?: string; }`                       | `table` only: search box. Its presence shows the search/filter/sort toolbar.                                                   |
+| `size?`          | `'md' \| 'lg' \| 'xl'`                                                                                                  |                                                                                                                                |
+| `sort?`          | `SortState`                                                                                                             |                                                                                                                                |
+| `sortFields?`    | `Array<{ id: string; label: string }>`                                                                                  |                                                                                                                                |
+| `tableLabel?`    | `string`                                                                                                                | Table's accessible name.                                                                                                       |
+| `title`          | `string`                                                                                                                |                                                                                                                                |
+| `value`          | `string[]`                                                                                                              | Ticked ids, in the host's order.                                                                                               |
+| `variant?`       | `'list' \| 'table'`                                                                                                     | `list` is the compact form the product uses inside a record sheet (a tick and a label per row); `table` is the workbench form. |
+
+### `EntityPickerState`
+
+"Select ideas" — the dialog that links records to another record.
+
+_Type._
+
+<sub>`src/ship/FilePreview.tsx`</sub>
+
+### `downloadAttachment`
+
+Hands the stand-in bytes for `file` to the browser and reports it.
+
+_No props type — see the source._
+
+### `FilePreview`
+
+The preview sheet behind a document or attachment: a labelled stand-in body chosen from the extension, header metadata, a zoom that moves the body itself, and a download built from exactly the content on screen.
+
+| Prop        | Type          | Notes                                                                        |
+| ----------- | ------------- | ---------------------------------------------------------------------------- |
+| `file`      | `PreviewFile` | The attachment (or document page) to show.                                   |
+| `onClose`   | `() => void`  |                                                                              |
+| `onNotify?` | `Notify`      | Raised when a download is handed to the browser, so the host can confirm it. |
+| `open`      | `boolean`     |                                                                              |
+
+<sub>`src/ship/Header.tsx`</sub>
+
+### `AppHeader`
+
+The products-level header: brand + global search + account actions.
+
+| Prop            | Type                                                                                                                                                                                           | Notes                                                        |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `actions`       | `ReactNode`                                                                                                                                                                                    |                                                              |
+| `className?`    | `string`                                                                                                                                                                                       |                                                              |
+| `onBrandClick?` | `() => void`                                                                                                                                                                                   |                                                              |
+| `product?`      | `string`                                                                                                                                                                                       | Product name shown next to the brand mark ("Ship").          |
+| `search?`       | `{ value: string; onChange: (value: string) => void; /** Enter in the field — the product jumps to the full search page. */ onSubmit?: () => void; placeholder?: string; shortcut?: string; }` |                                                              |
+| `searchRef?`    | `RefObject<HTMLInputElement \| null>`                                                                                                                                                          | Focus target for the ⌘K shortcut the placeholder advertises. |
+
+### `BrandMark`
+
+PingCode's four-dot product mark.
+
+| Prop         | Type     | Notes |
+| ------------ | -------- | ----- |
+| `className?` | `string` |       |
+| `size?`      | `number` |       |
+
+### `HeaderActions`
+
+| Prop               | Type                                                                                             | Notes                                                                                                                                             |
+| ------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `className?`       | `string`                                                                                         |                                                                                                                                                   |
+| `onCreate?`        | `() => void`                                                                                     |                                                                                                                                                   |
+| `onHelp?`          | `() => void`                                                                                     |                                                                                                                                                   |
+| `onNotifications?` | `() => void`                                                                                     |                                                                                                                                                   |
+| `onPing?`          | `() => void`                                                                                     | Opens Ping, the AI assistant side panel. The button is additive: when the prop is omitted nothing is rendered, so existing headers are unchanged. |
+| `pingOpen?`        | `boolean`                                                                                        | Whether the Ping drawer is open; drives `aria-expanded` and the active tint.                                                                      |
+| `unread?`          | `number`                                                                                         | Unread count; renders the dot badge when > 0.                                                                                                     |
+| `user`             | `{ name: string; src?: string; onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void }` |                                                                                                                                                   |
+
+### `ProductHeader`
+
+The workbench header: product identity, the star / collapse tools, the category tabs with their ink bar, and the same account cluster as the shell.
+
+| Prop                 | Type                                                                                                                    | Notes                                                                |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| `actions`            | `ReactNode`                                                                                                             |                                                                      |
+| `activeTab`          | `string`                                                                                                                |                                                                      |
+| `className?`         | `string`                                                                                                                |                                                                      |
+| `onCollapseSidebar?` | `() => void`                                                                                                            | Collapses the tab sidebar; the header shows the outdent control.     |
+| `onHome?`            | `() => void`                                                                                                            |                                                                      |
+| `onSelectProduct?`   | `(id: string) => void`                                                                                                  |                                                                      |
+| `onTabChange`        | `(id: string) => void`                                                                                                  |                                                                      |
+| `onToggleStar?`      | `() => void`                                                                                                            |                                                                      |
+| `overflowTabs?`      | `NavItemSpec[]`                                                                                                         |                                                                      |
+| `product`            | `{ name: string; onClick?: () => void }`                                                                                |                                                                      |
+| `products?`          | `Array<{ id: string; name: string; hint?: string }>`                                                                    | Other products, shown as a switcher menu on the product name.        |
+| `search?`            | `{ value: string; onChange: (value: string) => void; onSubmit?: () => void; placeholder?: string; shortcut?: string; }` |                                                                      |
+| `searchRef?`         | `RefObject<HTMLInputElement \| null>`                                                                                   |                                                                      |
+| `sidebarCollapsed?`  | `boolean`                                                                                                               |                                                                      |
+| `starred?`           | `boolean`                                                                                                               |                                                                      |
+| `tabContextMenu?`    | `(tab: NavItemSpec) => ContextMenuItem[]`                                                                               | Right-click commands for a product tab (never the only entry point). |
+| `tabs`               | `NavItemSpec[]`                                                                                                         |                                                                      |
+
+<sub>`src/ship/LinkPicker.tsx`</sub>
+
+### `LinkCandidate`
+
+A row the picker can offer: the record's id and the label its list would show.
+
+_Type._
+
+### `LinkPicker`
+
+The generic relation picker: link this record to rows of any target kind and manage the links that already exist.
+
+| Prop        | Type                              | Notes                                                                    |
+| ----------- | --------------------------------- | ------------------------------------------------------------------------ |
+| `children?` | `(open: () => void) => ReactNode` | Render prop for the trigger; defaults to a "Links" button.               |
+| `fromId?`   | `string`                          | The record the links belong to; only names it in the copy.               |
+| `onNotify?` | `Notify`                          | Raised for the batched "Linked N …" confirmation the picker itself owns. |
+| `selected`  | `LinkSelection[]`                 | The links that already exist, grouped by kind inside the panel.          |
+| `targets`   | `LinkTarget[]`                    | Which kinds can be linked from here.                                     |
+| `title?`    | `string`                          | Optional heading; defaults to `Link <target label>`.                     |
+
+### `LinkSelection`
+
+A link that already exists, resolved by the host.
+
+_Type._
+
+### `LinkTarget`
+
+One kind the picker can link to; `kind` is the host's own collection name.
+
+_Type._
+
+<sub>`src/ship/ListWorkbench.tsx`</sub>
+
+### `AssigneeField`
+
+The grid's inline assignee quick editor, in the one shape the library can carry without owning a store: the host supplies the people and the write, the workbench renders the cell and anchors the picker to it.
+
+_Type._
+
+### `BulkCapabilities`
+
+The product's standard bulk commands.
+
+_Type._
+
+### `EnumField`
+
+One enum column the grid edits in place.
+
+_Type._
+
+### `exportRowsToCsv`
+
+Writes rows to a CSV download with the very writer the list's own export uses, so a host can back a single-row "Export as CSV" quick command without copying the format.
+
+_No props type — see the source._
+
+### `ListView`
+
+_Type._
+
+### `ListWorkbench`
+
+One list, wired end to end and owned by nobody: search, filter rules, sort, grouping, column visibility, the five states, selection + bulk actions, CSV import/export, pagination, the create/edit sheet and the per-row commands.
+
+| Prop              | Type                                     | Notes                                                                                                                                                                                                                     |
+| ----------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `assigneeField?`  | `AssigneeField<T>`                       | Opt-in: turns the Assignee column into the inline quick editor.                                                                                                                                                           |
+| `banner?`         | `ReactNode`                              |                                                                                                                                                                                                                           |
+| `boardView?`      | `(rows: T[]) => ReactNode`               |                                                                                                                                                                                                                           |
+| `bulk?`           | `BulkCapabilities<T>`                    | The standard commands, in the product's order, above whatever `bulkActions` adds. Nothing here needs a page: freezing, statuses, baselines, schedules, distributing and the bulk edit dialog all belong to the component. |
+| `columns`         | `Array<Column<T>>`                       |                                                                                                                                                                                                                           |
+| `compare?`        | `Record<string, (a: T, b: T) => number>` |                                                                                                                                                                                                                           |
+| `countLabel?`     | `(count: number) => ReactNode`           |                                                                                                                                                                                                                           |
+| `detailTemplate?` | `string`                                 | `/ship/products/slc/ideas/{key}` — fills "Copy link" / "Open in a new tab".                                                                                                                                               |
+| `editFields?`     | `DialogField[]`                          |                                                                                                                                                                                                                           |
+| `editTitle?`      | `string`                                 |                                                                                                                                                                                                                           |
+| `empty?`          | `ReactNode`                              | Replace the built-in empty / error states outright, or tune their copy.                                                                                                                                                   |
+| `emptyAction?`    | `ReactNode`                              |                                                                                                                                                                                                                           |
+| `emptyBoardText?` | `string`                                 |                                                                                                                                                                                                                           |
+| `emptyHint?`      | `ReactNode`                              |                                                                                                                                                                                                                           |
+| `entityKind?`     | `EntityKind`                             |                                                                                                                                                                                                                           |
+| `enumFields?`     | `Array<EnumField<T>>`                    | Opt-in: turns the listed enum columns into inline quick selects.                                                                                                                                                          |
+| `errorState?`     | `ReactNode`                              |                                                                                                                                                                                                                           |
+| `filterFields?`   | `FilterField[]`                          |                                                                                                                                                                                                                           |
+| `footerLeft?`     | `ReactNode`                              |                                                                                                                                                                                                                           |
+| `forceEmpty?`     | `boolean`                                | The demo's `?state=empty`: empties the rows, keeps the count's real value.                                                                                                                                                |
+| `groupFields?`    | `Array<{ id: string; label: string }>`   |                                                                                                                                                                                                                           |
+| `headerExtras?`   | `ReactNode`                              |                                                                                                                                                                                                                           |
+| `identity?`       | `string`                                 |                                                                                                                                                                                                                           |
+| `importable?`     | `boolean`                                |                                                                                                                                                                                                                           |
+| `matches?`        | `(row: T, rule: FilterRule) => boolean`  | Tests one filter rule; a rule with an empty value always passes.                                                                                                                                                          |
+| `newLabel?`       | `string`                                 |                                                                                                                                                                                                                           |
+| `newMenu?`        | `MenuItemSpec[]`                         |                                                                                                                                                                                                                           |
+| `noun`            | `{ one: string; many: string }`          |                                                                                                                                                                                                                           |
+| `onNotify?`       | `Notify`                                 |                                                                                                                                                                                                                           |
+| `rowKey`          | `(row: T) => string`                     |                                                                                                                                                                                                                           |
+| `rows`            | `T[]`                                    |                                                                                                                                                                                                                           |
+| `searchText?`     | `(row: T) => string`                     | Text the search box matches; without it a search matches nothing.                                                                                                                                                         |
+| `selection`       | `string[]`                               |                                                                                                                                                                                                                           |
+| `sortFields?`     | `Array<{ id: string; label: string }>`   |                                                                                                                                                                                                                           |
+| `status?`         | `'loading' \| 'error' \| 'ready'`        |                                                                                                                                                                                                                           |
+| `textFields?`     | `Array<TextField<T>>`                    | Opt-in: turns the listed title / name columns into inline text editors.                                                                                                                                                   |
+| `title`           | `string`                                 |                                                                                                                                                                                                                           |
+| `titleIcon?`      | `IconName \| string`                     |                                                                                                                                                                                                                           |
+| `toolbarExtras?`  | `ReactNode`                              |                                                                                                                                                                                                                           |
+| `view`            | `ListView`                               |                                                                                                                                                                                                                           |
+| `views?`          | `ViewMode[]`                             |                                                                                                                                                                                                                           |
+
+### `PreviewState`
+
+Lets a host show each of the five grid states without a backend.
+
+_Type._
+
+### `TextField`
+
+One text column the grid edits in place — a title or a name.
+
+_Type._
+
+### `ViewMode`
+
+How the workbench arranges its rows.
+
+_Type._
+
+<sub>`src/ship/ProjectWizard.tsx`</sub>
+
+### `componentLine`
+
+One line of the type's component list, as the preview pane prints it.
+
+| Prop          | Type                 | Notes                                                                    |
+| ------------- | -------------------- | ------------------------------------------------------------------------ |
+| `color?`      | `string`             | Icon-tile colour, from the semantic token palette.                       |
+| `components`  | `string[]`           | The components the type installs, in the order the tab strip shows them. |
+| `description` | `string`             | The card's grey line, verbatim from the product capture.                 |
+| `icon`        | `IconName \| string` |                                                                          |
+| `id`          | `string`             |                                                                          |
+
+### `primaryComponents`
+
+The tabs a type shows before its "More" menu.
+
+| Prop          | Type                 | Notes                                                                    |
+| ------------- | -------------------- | ------------------------------------------------------------------------ |
+| `color?`      | `string`             | Icon-tile colour, from the semantic token palette.                       |
+| `components`  | `string[]`           | The components the type installs, in the order the tab strip shows them. |
+| `description` | `string`             | The card's grey line, verbatim from the product capture.                 |
+| `icon`        | `IconName \| string` |                                                                          |
+| `id`          | `string`             |                                                                          |
+
+### `ProjectDraft`
+
+_Type._
+
+### `ProjectMemberOption`
+
+_Type._
+
+### `ProjectTypeOption`
+
+The three-step `New project` dialog: a fixed left pane that previews the chosen type, and a right pane that walks Project type → Details → Members.
+
+_Type._
+
+### `ProjectWizard`
+
+Step 1 and step 3 are the capture's; the details step validates on blur, keeps everything typed, and only unlocks `Next step` once the name and the key are valid.
+
+| Prop                | Type                                             | Notes                                                        |
+| ------------------- | ------------------------------------------------ | ------------------------------------------------------------ |
+| `belongsToOptions?` | `string[]`                                       |                                                              |
+| `categoryOptions?`  | `string[]`                                       |                                                              |
+| `defaults?`         | `Partial<ProjectDraft>`                          | Overrides for the initial values.                            |
+| `existingKeys?`     | `Array<{ key: string; name: string }>`           | Keys already in use, so the key field can refuse them.       |
+| `members`           | `ProjectMemberOption[]`                          | Everyone the member step can add.                            |
+| `onClose`           | `() => void`                                     |                                                              |
+| `onSubmit`          | `(draft: ProjectDraft) => void \| Promise<void>` | The draft is complete and valid; the host writes it.         |
+| `owner`             | `string`                                         | The project owner: pre-selected on step 3 and not removable. |
+| `types`             | `ProjectTypeOption[]`                            | The types step 1 offers; the first one is the default.       |
+
+<sub>`src/ship/Rail.tsx`</sub>
+
+### `AppRail`
+
+The 60px product rail.
+
+| Prop           | Type             | Notes                                               |
+| -------------- | ---------------- | --------------------------------------------------- |
+| `activeId?`    | `string`         |                                                     |
+| `className?`   | `string`         |                                                     |
+| `footerItems?` | `RailItemSpec[]` | Rendered under the spacer, at the foot of the rail. |
+| `items`        | `RailItemSpec[]` |                                                     |
+
+### `RailItemSpec`
+
+_Type._
+
+<sub>`src/ship/ReportCanvas.tsx`</sub>
+
+### `CanvasData`
+
+The dataset projection.
+
+_Type._
+
+### `CanvasRecord`
+
+One flattened record of the dataset a canvas is bound to.
+
+_Type._
+
+### `CanvasWidget`
+
+One canvas widget.
+
+_Type._
+
+### `CanvasWidgetData`
+
+Per-kind configuration the widget bodies need: metric — which measure of the dataset to show text — the note body Every other kind draws the host's `data` directly.
+
+_Type._
+
+### `CanvasWidgetSpan`
+
+Width of a widget in the 12-column grid.
+
+_Type._
+
+### `defaultCanvasWidgets`
+
+The seed a fresh canvas starts from: a Metric, a Donut and a Bar.
+
+_No props type — see the source._
+
+### `isCanvasWidgetSpan`
+
+The persisted-layout guard the hosts run over a stored `span`.
+
+_No props type — see the source._
+
+### `ReportCanvas`
+
+The report canvas: a 12-column grid of widgets that can be added, resized, reordered by mouse drag or by the ▲/▼ buttons, and removed behind a confirm.
+
+| Prop             | Type                                       | Notes                                                                                                                                                                                                                       |
+| ---------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `chartTypes?`    | `string[]`                                 | Widget kinds the "Add widget" dialog offers; all five by default.                                                                                                                                                           |
+| `data?`          | `CanvasData`                               | Dataset the widgets read, for the bodies and the title suggestions.                                                                                                                                                         |
+| `emptyHint?`     | `string`                                   |                                                                                                                                                                                                                             |
+| `loading?`       | `boolean`                                  |                                                                                                                                                                                                                             |
+| `renderActions?` | `(openAddDialog: () => void) => ReactNode` | The host's own controls for the canvas. `openAddDialog` is the library's "Add widget" trigger, so the host's header button opens the same dialog (with its type picker, suggestion and Enter-to-submit) as the empty state. |
+| `renderBody?`    | `(widget: CanvasWidget) => ReactNode`      | Renders the widget body instead of the built-in one.                                                                                                                                                                        |
+| `widgets`        | `CanvasWidget[]`                           |                                                                                                                                                                                                                             |
+
+### `WidgetType`
+
+The five widget bodies the canvas can draw.
+
+_Type._
+
+<sub>`src/ship/RichTextToolbar.tsx`</sub>
+
+### `RichTextToolbar`
+
+Rich-text toolbar strip; the editor itself is intentionally inert.
+
+_No props type — see the source._
+
+<sub>`src/ship/RoadmapEditor.tsx`</sub>
+
+### `quarterWeekendDays`
+
+Weekend days inside one quarter.
+
+_No props type — see the source._
+
+### `RoadmapBar`
+
+One draggable bar: a single initiative sitting in one period of a lane.
+
+_Type._
+
+### `RoadmapEditor`
+
+The roadmap timeline: lane rows across a quarter grid, with bars that move by mouse drag or ← / →, rename inline on blur, recolour, and delete behind a confirm.
+
+| Prop             | Type                                       | Notes                                                                                                                                                                                                                                |
+| ---------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `bars`           | `RoadmapBar[]`                             |                                                                                                                                                                                                                                      |
+| `barsLabel?`     | `string`                                   | Which dataset style name the bars use, e.g. "initiatives".                                                                                                                                                                           |
+| `colors?`        | `string[]`                                 |                                                                                                                                                                                                                                      |
+| `lanes`          | `string[]`                                 |                                                                                                                                                                                                                                      |
+| `periods`        | `string[]`                                 | Columns of the grid, e.g. ['Q1 2026', 'Q2 2026', 'Q3 2026', 'Q4 2026'].                                                                                                                                                              |
+| `renderActions?` | `(openAddDialog: () => void) => ReactNode` | The host's own controls for the timeline. `openAddDialog` is the library's "Add initiative" trigger, so a header button opens the same dialog (with its lane / quarter / colour fields and the empty-name error) as the empty state. |
+| `showWeekends?`  | `boolean`                                  |                                                                                                                                                                                                                                      |
+| `weekendGrid?`   | `RoadmapWeekendGrid`                       | Overrides the weekend day counts (the built-in ones assume quarters).                                                                                                                                                                |
+| `zoom?`          | `RoadmapZoom`                              |                                                                                                                                                                                                                                      |
+
+### `RoadmapWeekendGrid`
+
+Bounded weekend counts, keyed by period, for hosts that do not use quarters.
+
+_Type._
+
+### `RoadmapZoom`
+
+Timeline granularity of the quarter header.
+
+_Type._
+
+<sub>`src/ship/ShareDialog.tsx`</sub>
+
+### `DEFAULT_SHARING`
+
+_No props type — see the source._
+
+### `ReportSharing`
+
+_Type._
+
+### `ShareDialog`
+
+Share + scheduled export for a report: the visibility select, the copyable link, the expiry menu and the scheduled-export half (cadence → hour, validated recipients, CSV/XLSX/PDF).
+
+| Prop         | Type                                             | Notes                                                                                                                                                    |
+| ------------ | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `onChange`   | `(next: ReportSharing) => void`                  |                                                                                                                                                          |
+| `onClose`    | `() => void`                                     |                                                                                                                                                          |
+| `onCopy?`    | `(link: string) => void \| Promise<void>`        | The host writes the clipboard; Copied is shown only after this callback succeeds.                                                                        |
+| `onSave?`    | `(next: ReportSharing) => void \| Promise<void>` | Fired after the dialog validated and handed the caller the next value. Purely a notification hook for host side effects; the dialog itself never toasts. |
+| `open`       | `boolean`                                        |                                                                                                                                                          |
+| `reportName` | `string`                                         |                                                                                                                                                          |
+| `value`      | `ReportSharing`                                  |                                                                                                                                                          |
+
+<sub>`src/ship/ShellSurfaces.tsx`</sub>
+
+### `AccountMenu`
+
+| Prop     | Type                               | Notes                        |
+| -------- | ---------------------------------- | ---------------------------- |
+| `items`  | `MenuItemSpec[]`                   |                              |
+| `label?` | `string`                           | Accessible name of the menu. |
+| `user`   | `{ name: string; email?: string }` |                              |
+
+### `QuickStartDialog`
+
+The getting-started checklist: a progress bar, one tickable row per step and a shortcut into the product for the steps that have somewhere to go.
+
+| Prop       | Type                                  | Notes                                                          |
+| ---------- | ------------------------------------- | -------------------------------------------------------------- |
+| `checked`  | `Record<string, boolean>`             |                                                                |
+| `intro?`   | `ReactNode`                           |                                                                |
+| `onClose`  | `() => void`                          |                                                                |
+| `onGo?`    | `(step: QuickStartStep) => void`      | "Go to …": the host navigates and usually marks the step done. |
+| `onReset?` | `() => void`                          |                                                                |
+| `onToggle` | `(id: string, next: boolean) => void` |                                                                |
+| `open`     | `boolean`                             |                                                                |
+| `steps`    | `QuickStartStep[]`                    |                                                                |
+
+### `QuickStartStep`
+
+_Type._
+
+### `ShortcutsDialog`
+
+The keyboard help sheet: `<kbd>` on the left, what it does on the right.
+
+| Prop        | Type             | Notes |
+| ----------- | ---------------- | ----- |
+| `onClose`   | `() => void`     |       |
+| `open`      | `boolean`        |       |
+| `shortcuts` | `ShortcutSpec[]` |       |
+| `title?`    | `string`         |       |
+
+### `ShortcutSpec`
+
+_Type._
+
+<sub>`src/ship/Toolbar.tsx`</sub>
+
+### `FilterChip`
+
+Removable chip summarising one active condition.
+
+| Prop       | Type         | Notes |
+| ---------- | ------------ | ----- |
+| `label`    | `ReactNode`  |       |
+| `onRemove` | `() => void` |       |
+| `value?`   | `ReactNode`  |       |
+
+### `FilterField`
+
+_Type._
+
+### `FilterPanel`
+
+The filter builder: one row per condition, AND-ed together.
+
+| Prop            | Type                            | Notes |
+| --------------- | ------------------------------- | ----- |
+| `fields`        | `FilterField[]`                 |       |
+| `onClose`       | `() => void`                    |       |
+| `onRulesChange` | `(rules: FilterRule[]) => void` |       |
+| `rules`         | `FilterRule[]`                  |       |
+
+### `FilterRule`
+
+_Type._
+
+### `ListHeader`
+
+The 48px strip above a grid: view name on the left, primary actions right.
+
+| Prop         | Type                 | Notes |
+| ------------ | -------------------- | ----- |
+| `actions?`   | `ReactNode`          |       |
+| `className?` | `string`             |       |
+| `title`      | `ReactNode`          |       |
+| `titleIcon?` | `IconName \| string` |       |
+
+### `ListToolbar`
+
+The entity toolbar: search, then Filter / Sort / Group / More, with the result count pinned to the right — the same order and wording as the product.
+
+| Prop              | Type                                                                                                          | Notes                                                               |
+| ----------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| `className?`      | `string`                                                                                                      |                                                                     |
+| `count?`          | `ReactNode`                                                                                                   |                                                                     |
+| `expanded?`       | `boolean`                                                                                                     |                                                                     |
+| `extraControls?`  | `ReactNode`                                                                                                   |                                                                     |
+| `fields?`         | `FilterField[]`                                                                                               |                                                                     |
+| `group?`          | `string \| null`                                                                                              |                                                                     |
+| `groupFields?`    | `Array<{ id: string; label: string }>`                                                                        |                                                                     |
+| `onGroupChange?`  | `(id: string \| null) => void`                                                                                |                                                                     |
+| `onRulesChange?`  | `(rules: FilterRule[]) => void`                                                                               |                                                                     |
+| `onSortChange?`   | `(sort: SortState) => void`                                                                                   |                                                                     |
+| `onToggleExpand?` | `() => void`                                                                                                  | Collapses the filter bar (Ship's chevron next to the search field). |
+| `rules?`          | `FilterRule[]`                                                                                                |                                                                     |
+| `search`          | `{ value: string; onChange: (value: string) => void; placeholder?: string; ariaLabel?: string; id?: string }` |                                                                     |
+| `sort?`           | `SortState`                                                                                                   |                                                                     |
+| `sortFields?`     | `Array<{ id: string; label: string }>`                                                                        |                                                                     |
+
+<sub>`src/ship/TransitionsTimeline.tsx`</sub>
+
+### `TransitionsTimeline`
+
+The record's workflow history as a vertical timeline — newest first, one dot per status move, with the configured flow above the rail.
+
+| Prop             | Type         | Notes                                                                                              |
+| ---------------- | ------------ | -------------------------------------------------------------------------------------------------- |
+| `currentStatus?` | `string`     | The status the record sits at right now, when the host knows it.                                   |
+| `emptyHint?`     | `string`     | Explanation under `No transitions yet` while nothing qualifies.                                    |
+| `entries`        | `Activity[]` | The record's activity rows; the timeline picks the status changes out of them.                     |
+| `statuses?`      | `string[]`   | Optional: the statuses to order the flow by, e.g. ['Pending','Planned','In progress','Completed']. |
+
+<sub>`src/ship/Views.tsx`</sub>
+
+### `BoardCard`
+
+_Type._
+
+### `BoardColumn`
+
+_Type._
+
+### `BoardView`
+
+Kanban view: fixed 288px columns, cards carry their own status pill.
+
+| Prop         | Type            | Notes |
+| ------------ | --------------- | ----- |
+| `className?` | `string`        |       |
+| `columns`    | `BoardColumn[]` |       |
+
+### `DocSplit`
+
+Documents tab: page tree on the left, rendered document on the right.
+
+| Prop       | Type         | Notes |
+| ---------- | ------------ | ----- |
+| `children` | `ReactNode`  |       |
+| `tree`     | `TreeNode[]` |       |
+
+### `RoadmapLane`
+
+_Type._
+
+### `RoadmapView`
+
+Quarter-grid roadmap: one lane per product line, bars per initiative.
+
+| Prop         | Type            | Notes |
+| ------------ | --------------- | ----- |
+| `className?` | `string`        |       |
+| `lanes`      | `RoadmapLane[]` |       |
+| `periods`    | `string[]`      |       |
+
+## Hooks
+
+<sub>`src/hooks/useBreakpoint.ts`</sub>
+
+### `Breakpoint`
+
+_Type._
+
+<sub>`src/hooks/useControllableState.ts`</sub>
+
+### `useControllableState`
+
+One state hook for every component that supports both `value` and `defaultValue`: uncontrolled by default, fully controlled when the host passes `value`, and never a silent no-op in between.
+
+| Prop           | Type                 | Notes |
+| -------------- | -------------------- | ----- |
+| `defaultValue` | `T`                  |       |
+| `onChange?`    | `(value: T) => void` |       |
+| `value?`       | `T`                  |       |
+
+<sub>`src/hooks/useListCursor.ts`</sub>
+
+### `useListCursor`
+
+The cursor an inline picker roves over its rows, shared by `PeoplePicker` and `QuickSelect`.
+
+_No props type — see the source._
+
+## Utilities
+
+<sub>`src/utils/cx.ts`</sub>
+
+### `cx`
+
+_No props type — see the source._
+
+<sub>`src/utils/format.ts`</sub>
+
+### `formatCompact`
+
+Turns 1234 into 1.2k the way the product's vote counters do.
+
+_No props type — see the source._
+
+### `formatCount`
+
+`1,234` in the UI, but the full value stays available for screen readers.
+
+_No props type — see the source._
+
+### `formatDateTime`
+
+Full timestamp for tooltips / detail panels.
+
+_No props type — see the source._
+
+### `formatDay`
+
+_No props type — see the source._
+
+### `formatListTime`
+
+PingCode's list timestamps are relative for the current week ("Today 15:44", "Yesterday 15:44", "Tuesday 09:12") and absolute beyond it.
+
+_No props type — see the source._
+
+### `formatNumber`
+
+_No props type — see the source._
+
+### `pluralize`
+
+_No props type — see the source._
+
+<sub>`src/utils/options.ts`</sub>
+
+### `cursorAfter`
+
+Where a listbox key moves the cursor, clamped to the list — no wrap, so the ends of a list behave the way the arrow keys do everywhere else in the grid.
+
+_No props type — see the source._
+
+### `matchesQuery`
+
+Case-insensitive substring match of a query against the fields a row exposes.
+
+_No props type — see the source._
+
+---
+
+Generated from 131 source files. Run `pnpm docs` after changing a
+component, or `pnpm verify` will fail on the diff.