@nurix/etna 0.19.42 → 0.19.44

package/data/harnesses/apollo/skills/design/components/collections.md

@@ -0,0 +1,132 @@
+# Collection Components
+
+> Generated reference (regen-owned; see [index.md](index.md)). Binds only under `primitives: nurix`.
+
+## Table
+
+Data table with sorting, pagination, and row selection. Zero-config `<Table data columns />` renders bare; selection, sorting, pagination, and resize are opt-in via `tableConfig`.
+
+**Props:**
+
+- `data` - Array of row objects (must have `id` field)
+- `columns` - Array of `ColumnDefinition` objects
+- `columnOrder` - Optional column order (defaults to column definition order)
+- `pagination` - `{ current, size, total, onChange }`
+- `sorting` - `{ columns, direction, onChange }` (max 3 sort columns)
+- `onSelect` - Callback with selected row IDs
+- `onCellChange` - Write-back from `editable` cells: `({ rowId, columnId, slug, value }) => void` (data stays consumer-controlled)
+- `loading` - Show loading skeleton
+- `tableConfig` - Optional; `{ preset, rowSelection, sort, pagination, header, density, columnBorders, tableBorders, resize, autoHeight }`
+
+`preset: "classic"` restores the legacy look in one key; `resize` gates column drag handles; the pagination footer is opt-in (`pagination: true`).
+
+```tsx
+<Table
+  data={users}
+  columns={columns}
+  pagination={{ current: 1, size: 10, total: 100, onChange: setPagination }}
+  sorting={{ columns: ["name"], direction: "asc", onChange: setSorting }}
+  onSelect={setSelectedIds}
+  tableConfig={{ rowSelection: true, resize: true }}
+/>
+```
+
+## ColumnDefinition
+
+Define table columns using the `defineColumn()` helper.
+
+**Fields:**
+
+- `slug` - Field key in data object
+- `label` - Column header text
+- `type` - Data type: `text`, `number`, `boolean`, `date`, `enum`, `user`
+- `component` - Renderer (defaults from `type`): `text`, `number`, `boolean`, `date`, `select`, `multiselect`, `slider`, `rating`, `status`, `priority`, `assignee`, `sparkline`, `date-range`
+- `hidden` - Hide column
+- `editable` - Activate the interactive widget; columns render the read-only display variant by default
+- `metadata` - Component-specific options (see table below)
+- `display` - `{ width, sortable }` (width optional — columns are fluid when unset)
+- `cell` - Custom render function `(row) => ReactNode`
+
+For full control, pass your own `cell()` or import a renderer from `@nurix/components/table` (`StatusPill`, `SelectCell`, etc.) as an escape hatch.
+
+### Metadata options by component
+
+| Component | Options |
+| --- | --- |
+| Text/Number | `placeholder`, `prefix`, `suffix`, `prefixIcon` |
+| Number/Slider | `min`, `max`, `step`, `stepButtons` [arrows \| plusminus \| none] |
+| Enum/Select | `options: [{ value, label, color }]` |
+| Date | `relativeFormat` |
+| Date Range | `showPresets` |
+| Rating | `allowHalf` |
+| Sparkline | `sparklineType` [bar \| line \| pie \| stacked], `sparklineWidth`, `sparklineHeight`, `sparklineGap`, `sparklineStrokeWidth`, `sparklineColors` |
+
+### Example
+
+```tsx
+import { defineColumn } from "@nurix/components/table";
+
+const columns = [
+  defineColumn({
+    slug: "name",
+    label: "Name",
+    type: "text",
+    editable: true,
+  }),
+  defineColumn({
+    slug: "status",
+    label: "Status",
+    type: "enum",
+    component: "status",
+    metadata: {
+      options: [{ value: "active", label: "Active", color: "#22c55e" }],
+    },
+  }),
+  defineColumn({
+    slug: "progress",
+    label: "Progress",
+    type: "number",
+    component: "slider",
+    metadata: { min: 0, max: 100 },
+  }),
+  defineColumn({
+    slug: "createdAt",
+    label: "Created",
+    type: "date",
+    metadata: { relativeFormat: true },
+  }),
+];
+```
+
+## PageHeader
+
+Config-driven page masthead with an optional stat ledger — router-agnostic (the consumer owns navigation). Import from `@nurix/components/page-header`.
+
+**Props:** `title`, `eyebrow` (breadcrumb segments — strings or linked `Crumb`s; last is the current page), `description`, `statusSlot`, `actions`, `stats` (`Stat[]` ledger), `back` (`BackLink`), `onBack`, `onNavigate` (fired with a crumb's/stat's `href`), `statsAlign` [left|right], `tall`
+
+```tsx
+<PageHeader
+  title="Q3 Pipeline"
+  eyebrow={["Sales", "Pipelines"]}
+  actions={<Button size="sm">Export</Button>}
+  stats={[{ label: "Open deals", value: "142" }, { label: "Won", value: "$1.2M" }]}
+/>
+```
+
+## Conversation surfaces
+
+Chat/AI message chrome; import each from its kebab-case subpath.
+
+- `message` — docs-style message rows: `MessageGroup`, `Message`, `MessageAvatar`, `MessageHeader`, `MessageContent`, `MessageFooter`, `MessageStatus` (`status` [sending|sent|failed…] with icon + `data-status`)
+- `message-scroller` — pinned-to-bottom scroll container for feeds: `MessageScrollerProvider`, `MessageScroller`, `MessageScrollerViewport`, `MessageScrollerContent`, `MessageScrollerItem`, `MessageScrollerButton` (jump-to-latest); hooks `useMessageScroller`, `useMessageScrollerScrollable`, `useMessageScrollerVisibility`
+- `bubble` — chat-bubble rows: `BubbleGroup`, `Bubble`, `BubbleContent`, `BubbleReactions`
+- `attachment` — file chips for composer/thread: `Attachment` (+ `AttachmentGroup`, `AttachmentMedia`, `AttachmentContent`, `AttachmentTitle`, `AttachmentDescription`, `AttachmentActions`, `AttachmentAction`, `AttachmentTrigger`); `size` [default|sm], dashed border in idle state, `data-[state=error]` styling
+- `marker` — inline annotation row in a stream: `Marker`, `MarkerIcon`, `MarkerContent`; `variant` [default|separator|border]
+
+## Other Collections
+
+- `activity-timeline` — `GanttChart`: D3-based activity timeline (`Task`, `TaskStatus`, `ViewMode`, `GanttChartProps` types; `DEFAULT_STATUS_COLORS`, `getTaskDuration` helpers)
+- `changes-list` — `ChangesList`: grouped change-history feed (`ChangeItem`, `EntityConfig`, `OperationConfig`, `GroupBy` types)
+- `header` — `Header`: config-driven page header taking a single `config: HeaderConfig` (breadcrumbs, profile, status bar, grid, actions sections); sub-components `HeaderBreadcrumbs`, `HeaderActions`, `HeaderSection`, `HeaderCell`
+- `list` — `List`: data list with `ListToolbar`, `ListPagination`, `ListItemErrorBoundary`
+- `ui-table` — `UiTable`, `UiTableHeader`, `UiTableBody`, `UiTableFooter`, `UiTableHead`, `UiTableRow`, `UiTableCell`, `UiTableCaption`: bare HTML-table primitives; prefer `Table`

package/data/harnesses/apollo/skills/design/components/feedback.md

@@ -0,0 +1,47 @@
+# Feedback Components
+
+> Generated reference (regen-owned; see [index.md](index.md)). Binds only under `primitives: nurix`.
+
+## EmptyState
+
+Placeholder for empty content areas.
+
+**Props:** `icon`, `title`, `description`, `action`
+
+```tsx
+<EmptyState
+  icon={<InboxIcon className="h-12 w-12 text-muted-foreground" />}
+  title="No messages"
+  description="Start a conversation to see messages here"
+  action={<Button>New Message</Button>}
+/>
+```
+
+## Alert
+
+Dismissible status block; `Alert` is the container, `AlertTitle`/`AlertDescription` lay out the icon-led grid.
+
+**Props:** `variant` [default|destructive], `dismissible`, `onDismiss`, `dismissButton` (custom node, overrides the default X button)
+
+```tsx
+<Alert variant="destructive" dismissible onDismiss={handleDismiss}>
+  <TriangleAlert />
+  <AlertTitle>Sync failed</AlertTitle>
+  <AlertDescription>Retry in a few minutes.</AlertDescription>
+</Alert>
+```
+
+## Other Components
+
+- `loader` — `Loader`: five-dot pulse indicator; `size`, `gap`, `colors` (array, cycles if fewer than `numberOfDots`), `numberOfDots`, `height`
+- `progress` — `Progress`: Radix `Progress.Root`/`Indicator` pair; `value` (0–100)
+- `skeleton` — `Skeleton`: pulsing placeholder `div`; size it with `className` to match the final layout
+- `typing-indicator` — `TypingIndicator`: `users` (`string[]` or `{ id, name, avatar }[]`), `maxVisible` — stacked avatars plus "X and N others are typing…"
+- `error-boundary` — `ErrorBoundary`: class component catching render errors; `fallback`, `onError`, `onRetry` (default UI renders a retry link)
+- `not-found` — `NotFound`: built on `EmptyState`; `title`, `description`, `showHomeButton`, `onGoBack`
+- `sonner` — `Toaster`: theme-synced wrapper over `sonner`'s `Toaster`, watches `document.documentElement`'s `dark` class via a `MutationObserver`
+- `braille` — `Braille`: animated unicode-braille spinner; `spinner` (18 named patterns — `braille`, `braillewave`, `dna`, `scan`, `rain`, `scanline`, `pulse`, `snake`, `sparkle`, `cascade`, `columns`, `orbit`, `breathe`, `waverows`, `checkerboard`, `helix`, `fillsweep`, `diagswipe`), `interval` (ms, overrides the spinner's default), `label` (screen-reader text). The `inline-spinner` subpath exports the underlying frame registry and grid utilities: `spinners`, `gridToBraille`, `makeGrid`.
+
+```tsx
+<Braille spinner="dna" label="Loading" />
+```

package/data/harnesses/apollo/skills/design/components/hooks.md

@@ -0,0 +1,35 @@
+# Hooks
+
+> Generated reference (regen-owned; see [index.md](index.md)). Binds only under `primitives: nurix`.
+
+Standalone React hooks, each imported from its own subpath under `@nurix/components/`.
+
+## useClickOutside
+
+`useClickOutside(ref, callback)` — invokes `callback` on `mousedown`/`touchstart` outside the referenced element.
+
+```tsx
+const ref = useRef<HTMLDivElement>(null);
+useClickOutside(ref, () => setOpen(false));
+```
+
+## useFileUpload
+
+`useFileUpload(options?)` — returns `[state, actions]`.
+
+**Options:** `maxFiles` (multi mode only, default Infinity), `maxSize` (bytes), `accept`, `multiple`, `initialFiles`, `onFilesChange`, `onFilesAdded`
+
+**State:** `{ files: FileWithPreview[], isDragging, errors }` **Actions:** `addFiles`, `removeFile`, `clearFiles`, `clearErrors`, `handleDragEnter/Leave/Over/Drop`, `handleFileChange`, `openFileDialog`, `getInputProps()`. Also exports `formatBytes`.
+
+```tsx
+const [state, actions] = useFileUpload({ multiple: true, maxFiles: 5 });
+<div {...actions.getInputProps()} onDrop={actions.handleDrop} />
+```
+
+## useMediaQuery
+
+`useMediaQuery(query)` — reactive boolean for a CSS media query string, updates on `matchMedia` change events.
+
+## useIsMobile
+
+`useIsMobile()` (from `hooks/use-mobile`) — reactive boolean, true below the 768px breakpoint.

package/data/harnesses/apollo/skills/design/components/index.md

@@ -0,0 +1,143 @@
+# Component catalog — the fused index
+
+> **Generated folder — never hand-edit.** Everything under `skills/design/components/` is emitted by the components-repo regen instruction set (`docs/architecture/skills/case-studies/components-regen-spec.md`, run against the `@nurix/components` library checkout). Regeneration may reshape any file beneath this one; the design skill's only seam with this folder is this index.
+
+**Load contract.** This index loads in **both** positions of the project's `primitives` switch (`design.md`, `primitives: nurix | native`) — it is how the skill knows what chrome *exists* to compose with. The per-category deep references beside it ([inputs](inputs.md), [overlays](overlays.md), [collections](collections.md), [navigation](navigation.md), [layout](layout.md), [feedback](feedback.md), [charts](charts.md), [typography](typography.md), [media](media.md), [motion](motion.md), [hooks](hooks.md), [utils](utils.md), plus [setup](setup.md) for install/Tailwind wiring) load **only under `primitives: nurix`**, and only when that category is touched.
+
+**The ratchet.** Deep references bind only when `@nurix/components` is actually importable in the target project: the intake probe defaults the switch, the recorded `primitives:` line is the authority. Under `nurix`, a row binds to its **nurix** column and the category reference supplies the API. Under `native`, the per-category references never load; a row binds to its **shadcn** column (when the project uses shadcn/ui) or to the **fallback** column — a semantic-HTML/behavior spec the model implements with the incumbent stack.
+
+Columns: `concept` (the composable idea) · `category` (which deep reference covers it) · `nurix` (symbols + `@nurix/components/<subpath>`; empty = the library has no primitive for this concept) · `shadcn` (shadcn/ui equivalent; `—` = none) · `fallback` (plain spec, always present).
+
+```csv
+concept,category,nurix,shadcn,fallback
+button,inputs,Button (button),Button,"native <button>, variants via class, focus-visible ring"
+text-input,inputs,"Input (input) — onSave commit, regex validator",Input,"<input type=text>, commit on blur/Enter"
+number-input,inputs,"NumberInput (number-input) — min/max/step",—,"<input inputmode=numeric>, clamp on commit, Escape reverts"
+textarea,inputs,"Textarea (textarea) — Cmd/Ctrl+Enter commits",Textarea,"<textarea>, blur commits, Escape resets draft"
+checkbox,inputs,Checkbox (checkbox),Checkbox,"<input type=checkbox> + label, indeterminate via JS"
+switch,inputs,Switch (switch),Switch,"role=switch button, aria-checked, Space toggles"
+radio-group,inputs,"RadioGroup + card/segmented variants (radio-group)",RadioGroup,"fieldset of <input type=radio>, arrow-key roving focus"
+select,inputs,"Select — searchable, multi, async (select)","Select; Combobox (Popover + Command)","<select> or listbox popover, typeahead, option objects not raw values"
+native-select,inputs,"Select* Radix family (native-select)",Select,"plain <select> behind a styled trigger"
+date-picker,inputs,DatePicker (date-picker),Date Picker (Calendar + Popover),"<input type=date> or calendar popover, ISO value"
+date-range-picker,inputs,"DateRangePicker — presets sidebar (date-range-picker)",—,"two bound date inputs, partial selection reverts on close"
+calendar,inputs,"Calendar (calendar) — react-day-picker",Calendar,"month grid <table>, arrow-key day navigation"
+slider,inputs,Slider (slider),Slider,"<input type=range> with visible value readout"
+rating,inputs,Rating (rating),—,"radio group of icon buttons, half-step optional"
+toggle,inputs,"Toggle · ToggleGroup (toggle, toggle-group)","Toggle, Toggle Group","aria-pressed buttons, single or multiple selection"
+otp-input,inputs,InputOTP (input-otp),Input OTP,"segmented one-char inputs, paste distributes across slots"
+icon-picker,inputs,"IconPicker · Icon (icon-picker)",—,"searchable icon grid in a popover, categorized"
+file-upload,inputs,MediaFilePicker (media-file-picker),—,"<input type=file> + drop zone, previews, size and count caps"
+form-field,inputs,"Cell — label/content/helper/error slots (cell)",Form + FormField (react-hook-form),"label + control + helper in one block, error slot below control"
+form-validation,inputs,,Form (react-hook-form),"form element with submit-time validation and inline field errors"
+rich-text-editor,inputs,,—,"@tiptap/react editor with toolbar and markdown shortcuts"
+code-editor,inputs,,—,"@monaco-editor/react, mono, optional read-only diff mode"
+modal-dialog,overlays,Dialog (dialog),Dialog,"<dialog> or fixed layer, focus trap, ESC closes, header→body→footer"
+confirm-dialog,overlays,"Dialog variant=danger — non-dismissible (dialog)",Alert Dialog,"modal with explicit confirm/cancel, no outside-click dismiss"
+side-panel,overlays,Sheet (sheet),Sheet,"fixed aside, focus-trapped, ESC closes, interruptible slide"
+bottom-drawer,overlays,Sheet side=bottom (sheet),Drawer (vaul),"fixed bottom panel spanning full width"
+command-palette,overlays,Command (command),Command (cmdk),"filtered list in a dialog, ⌘K opens, arrow-key + Enter"
+dropdown-menu,overlays,DropdownMenu (dropdown-menu),Dropdown Menu,"role=menu under a trigger, arrow-key nav, outside click closes"
+context-menu,overlays,ContextMenu (context-menu),Context Menu,"right-click menu at pointer position"
+popover,overlays,Popover (popover),Popover,"anchored floating panel, dismiss on outside/ESC"
+hover-card,overlays,HoverCard (hover-card),Hover Card,"preview panel on hover intent, delayed open/close"
+tooltip,overlays,Tooltip (tooltip),Tooltip,"short hint on hover/focus, never load-bearing content"
+data-table,collections,"Table + defineColumn (table)","<Table> + TanStack Table","semantic <table>, sticky header, tabular-nums, real pagination, status chips"
+table-primitives,collections,UiTable* family (ui-table),Table,"bare styled <table>/<thead>/<tbody> parts"
+list,collections,"List + ListToolbar + ListPagination (list)",—,"<ul> of rows with toolbar and pager"
+record-header,collections,"Header — config-driven (header)",—,"page-top block: breadcrumbs, title, status bar, actions"
+page-header-stats,collections,"PageHeader — Stat/Crumb/BackLink (page-header)",—,"title row + KPI strip + back link"
+gantt-timeline,collections,GanttChart (activity-timeline),—,"time-scaled task rows, date axis, horizontal scroll"
+changes-feed,collections,ChangesList (changes-list),—,"grouped change-history feed, entity + operation labels"
+message-thread,collections,"Message family + MessageScroller (message, message-scroller)",—,"scrolling feed pinned to bottom, jump-to-new button"
+chat-bubble,collections,BubbleGroup + Bubble (bubble),—,"aligned bubble rows with reactions row"
+attachment,collections,Attachment family (attachment),—,"file card: media, title, actions, error state, dashed idle border"
+thread-marker,collections,"Marker — separator/border variants (marker)",—,"inline separator row with icon and label"
+json-viewer,collections,,—,"react18-json-view collapsible tree, mono"
+virtualized-list,collections,,—,"react-window fixed-row virtualization for 1k+ rows"
+kanban-board,collections,,—,"flex columns of cards, @dnd-kit drag between columns, per-column count"
+event-calendar,collections,,—,"month/week grid of events, today marker, overflow +N"
+description-list,collections,,—,"<dl> two-column key/value grid, tabular values"
+filter-toolbar,collections,,—,"row of faceted filter chips + clear-all + result count"
+vertical-timeline,collections,,—,"ordered event list with time rail and node markers"
+sidebar,navigation,"Sidebar family + Brand/Switcher/ItemGroup/UserMenu/Callout (sidebar)",Sidebar,"fixed <nav>: brand + icon sections + badges + user footer, collapsible to icons"
+file-tree,navigation,FileTree (sidebar),—,"nested tree with disclosure carets, keyboard nav"
+breadcrumb,navigation,Breadcrumb (breadcrumb),Breadcrumb,"<nav aria-label=breadcrumb>, current page unlinked"
+tabs,navigation,Tabs (tabs),Tabs,"role=tablist, arrow-key switching, one panel per tab"
+pagination,navigation,Pagination (pagination),Pagination,"page buttons + prev/next, aria-current on active page"
+navbar,navigation,Navbar (navbar),—,"horizontal top <nav> with links and actions"
+navigation-menu,navigation,NavigationMenu (navigation-menu),Navigation Menu,"top-level nav with flyout panels"
+menubar,navigation,Menubar (menubar),Menubar,"desktop-app menu strip with full keyboard model"
+slide-out-menu,navigation,SlideOutMenu (slide-out-menu),—,"off-canvas nav panel for narrow viewports"
+icon-rail,navigation,VerticalIconBar (vertical-icon-bar),—,"narrow vertical icon strip with tooltips"
+stepper,navigation,,—,"ordered steps with done/current/todo states, aria-current=step"
+alert,feedback,Alert (alert),Alert,"role=alert block, tone via border + icon"
+empty-state,feedback,EmptyState (empty-state),Empty,"icon + heading + motivation line + primary action"
+error-boundary,feedback,ErrorBoundary (error-boundary),—,"React boundary rendering a retry block"
+not-found,feedback,NotFound (not-found),—,"404 block with a way back"
+skeleton,feedback,Skeleton (skeleton),Skeleton,"pulsing placeholder matching the final layout"
+loader,feedback,Loader (loader),Spinner,"centered spinner with optional label"
+text-spinner,feedback,"Braille (braille) · spinner frames (inline-spinner)",—,"animated unicode frames inline with text"
+progress,feedback,Progress (progress),Progress,"role=progressbar with aria-valuenow"
+toast,feedback,Toaster (sonner),Sonner,"stacked corner notifications, auto-dismiss, action slot"
+typing-indicator,feedback,TypingIndicator (typing-indicator),—,"three-dot pulse row"
+sparkline,charts,"Spark — line|bar|pie (spark) · Sparkline (sparkline)",—,"inline no-axis SVG mark, token or self-contained color"
+inline-bar,charts,BarGraph (bar-graph),—,"compact bar SVG with skeleton, token colors"
+inline-line,charts,LineGraph (line-graph),—,"compact line SVG with skeleton"
+pie-donut,charts,"PieGraph — pie|half-pie|doughnut|half-doughnut (pie-graph)",—,"SVG arcs, max ~6 slices, center slot in doughnut"
+segmented-progress,charts,ProgressBar (progress-bar),—,"stacked horizontal segments with legend"
+area-chart,charts,"AreaChart + Area/RangeArea marks (charts)",Chart (recharts),"axes + gridlines + filled series + tooltip"
+bar-chart,charts,"BarChart + ParetoLine, BarSort, stack modes (charts)",Chart (recharts),"grouped/stacked bars, value labels opt-in"
+line-chart,charts,"LineChart + projection/reference overlays (charts)",Chart (recharts),"multi-series lines, reference lines, brush"
+scatter-chart,charts,ScatterChart + Scatter (charts),—,"x/y point field, hover ring, box select"
+composed-chart,charts,ComposedChart (charts),—,"mixed marks over one shared scale pair"
+histogram,charts,Histogram + computeHistogramBins (charts),—,"binned bars over a continuous axis"
+bullet-chart,charts,"Bullet (gauge; also charts)",—,"measure bar + target tick + zone bands"
+funnel,charts,"Funnel + FunnelTooltip/FunnelLegend (funnel)",—,"ordered stage bands, percent-of-previous labels"
+gauge,charts,"Gauge — arc or notch track, zones, target (gauge)",—,"value arc with threshold zones and center readout"
+contribution-heatmap,charts,Heatmap + chrome (heatmap),—,"calendar cell grid with level legend"
+matrix-heatmap,charts,MatrixHeatmap + legend/tooltip (heatmap),—,"x-by-y cell matrix on the tokenized ramp"
+radar,charts,Radar (radar),—,"spider axes with series polygons"
+ring,charts,Ring (ring),—,"segmented circular progress with center info"
+chart-chrome,charts,"ChartEmpty · ChartHoverCard · ChartLegend (chart-primitives)",—,"shared empty/tooltip/legend chrome for inline charts"
+card,layout,Card family (card),Card,"bordered section: header, content, footer"
+stat-card,layout,Statistics family (statistics),—,"number + comparison + trend + state + door, composable regions"
+accordion,layout,Accordion (accordion),Accordion,"stacked disclosure sections, single or multiple open"
+collapsible,layout,"Collapsible (collapsible) · CollapsiblePanel (collapsible-panel)",Collapsible,"button-controlled region with hidden state"
+split-panes,layout,ResizablePanelGroup (resizable),Resizable,"draggable divider panes, keyboard resize"
+scroll-area,layout,ScrollArea (scroll-area),Scroll Area,"styled overflow container, visible-on-hover scrollbar"
+separator,layout,"Separator (separator) · SeparatorWithText (separator-with-text)",Separator,"<hr>/role=separator, optional centered label"
+aspect-ratio,layout,AspectRatio (aspect-ratio),Aspect Ratio,"CSS aspect-ratio box"
+carousel,layout,Carousel (carousel),Carousel,"scroll-snap track with prev/next controls"
+bento-grid,layout,BentoGrid + BentoCard (bento-grid),—,"asymmetric feature grid with spanning cells"
+editable-card,layout,EditableCard (editable-card),—,"card with edit-in-place body and commit footer"
+drag-reorder,layout,Sortable family (sortable),—,"dnd-kit list reorder, keyboard sortable, drag overlay ghost"
+text,typography,Text (text),Typography,"semantic p/span with size and weight scale"
+badge,typography,Badge (badge),Badge,"small status pill, tokenized tone"
+chip,typography,"Chip (chip) · Option display (select)",—,"removable tag, optional color dot"
+code,typography,Code (code),—,"inline <code>, mono"
+kbd,typography,Kbd (kbd),Kbd,"<kbd> keycap"
+label,typography,Label (label),Label,"<label for> bound to a control"
+link,typography,Link (link),—,"<a> with underline discipline"
+secure-text,typography,SecureText (secure-text),—,"masked value with reveal toggle, mono"
+markdown,typography,Markdown (markdown),—,"react-markdown rendering with typographic defaults"
+avatar,media,Avatar (avatar),Avatar,"image with initials fallback, round"
+copy-button,media,CopyButton (copy-button),—,"clipboard write with copied-state swap"
+icon,media,"IconRenderer (icon-renderer) + icons-data (icons-data)",—,"lucide icon by name, consistent stroke and size grid"
+voice-waveform,media,"LiveWaveform (live-waveform) · MicIcon (mic-icon)",—,"animated level bars from mic input"
+brand-logo,media,"NurixLogo — color|monochrome (nurix-logo)",—,"inline SVG wordmark sized by height"
+shine-border,media,ShineBorder (shine-border),—,"animated gradient border wrapper, decorative"
+theme-toggle,media,ThemeToggler (theme-toggler),—,"light/dark switch writing data-theme"
+view-switcher,media,ViewSwitcher (view-switcher),—,"segmented control switching view-type projections"
+animated-number,motion,"AnimatedNumber (animated-number) · SlidingNumber (motion-primitives/sliding-number)",—,"tick-up numerals, renders plain text until JS ready"
+stagger-entrance,motion,AnimatedGroup (motion-primitives/animated-group),—,"staggered child arrival, identity moments only, never on 100×/day actions"
+text-effects,motion,"TextEffect · TextMorph · TextScramble · TextShimmer (motion-primitives/*)",—,"per-character text animation, low-frequency surfaces only"
+morphing-overlay,motion,"MorphingDialog · MorphingPopover (motion-primitives/*)",—,"trigger morphs into overlay, interruptible"
+panel-transitions,motion,"TransitionPanel · Disclosure · motion Accordion (motion-primitives/*) · animated Tabs (animate-ui)",—,"crossfade/slide between sibling panels, height-animated reveal, interruptible"
+decorative-effects,motion,"Spotlight · GlowEffect · AnimatedBackground · InfiniteSlider · Highlight (motion-primitives/*, animate-ui/*)",—,"pointer-tracked washes and loops, decorative only, never on data"
+dynamic-toolbar,motion,ToolbarDynamic (motion-primitives/toolbar-dynamic),—,"toolbar expanding to contextual actions"
+utility-hooks,hooks,"useClickOutside · useFileUpload · useMediaQuery · useIsMobile (hooks/*)",—,"outside-click, file-upload state, matchMedia boolean, <768px boolean"
+class-merge,utils,cn (utils),cn,"clsx + tailwind-merge"
+formatting-utils,utils,"formatDate (format) · generateId (id) · getErrorMessage (handle-error)",—,"Intl date formatting, nanoid ids, error-to-message normalization"
+composition-utils,utils,"getStrictContext (get-strict-context) · composeRefs (compose-refs)",—,"throwing Provider/hook pair, ref composition"
+```