@vegastack/design 0.4.1 → 0.5.0

package/skills/vegastack-design-system/references/components.md

@@ -3,74 +3,72 @@
 <!-- GENERATED — do not hand-edit. Regenerated from the design system's component contract,
      which is the authority for membership and counts. -->
 
-**116 components**, plus 467 animated-icon items, 11 hooks (`use-animation-replay`, `use-announcer`, `use-drag-reorder`, `use-file-drop`, `use-inline-edit`, `use-list-nav`, `use-media-query`, `use-mobile`, `use-modal-inert`, `use-overflow`, `use-platform`), 1 starter block (`dashboard-01`), and 2 data libs (`geo-data`, `drag-item`) — 597 registry items in total.
+**109 components**, plus 467 animated-icon items, 11 hooks (`use-animation-replay`, `use-announcer`, `use-drag-reorder`, `use-file-drop`, `use-inline-edit`, `use-list-nav`, `use-media-query`, `use-mobile`, `use-modal-inert`, `use-overflow`, `use-platform`), 32 starter blocks (`app-shell-01`, `board-01`, `dashboard-01`, `login-01`, `login-02`, `login-03`, `login-04`, `login-05`, `onboarding-01`, `preview-03`, `settings-01`, `sidebar-01`, `sidebar-02`, `sidebar-03`, `sidebar-04`, `sidebar-05`, `sidebar-06`, `sidebar-07`, `sidebar-08`, `sidebar-09`, `sidebar-10`, `sidebar-11`, `sidebar-12`, `sidebar-13`, `sidebar-14`, `sidebar-15`, `sidebar-16`, `signup-01`, `signup-02`, `signup-03`, `signup-04`, `signup-05`), 68 chart blocks across 7 families, and 2 data libs (`geo-data`, `drag-item`) — 689 registry items in total.
 
 Install any of them with `shadcn add @vegastack/<name>`. Animated icons install as
-`@vegastack/icon-<name>`; the bare name is reserved for components, so `icon-button` is the
-component and never an icon.
+`@vegastack/icon-<name>`; the bare name is reserved for components, so a component whose name
+starts with `icon-` is a component and never an icon.
 
 ## Actions
 
-- **`button`** — Trigger an action. Six variants × five tones × four sizes, with loading + Base UI Button semantics.
+- **`button`** — Trigger an action — upstream's six variants and eight sizes, plus a loading state (API-5).
+- **`button-group`** — Joins buttons, inputs, selects and dropdowns into one connected control group — horizontal or vertical, with a separator and a text addon.
 - **`copy-button`** — Copy a value to the clipboard with transient check feedback — a ghost icon button that swaps Copy → Check and fires onCopied.
-- **`icon-button`** — A square or round icon-only action button — a thin Button wrapper that requires an accessible label.
-- **`segmented`** — Segmented control — a single-select, always-one-selected view/mode switcher on a muted track with a raised active chip.
-- **`split-button`** — A primary action joined to a dropdown of related secondary actions — one default click, plus a chevron menu.
-- **`toggle`** — A two-state button that can be pressed on or off — bold/italic, mute, pin.
-- **`toggle-group`** — Joined toggle buttons sharing one selection — single or multiple, variants/sizes, horizontal/vertical, full keyboard navigation.
+- **`toggle`** — A two-state button that can be pressed on or off, with a loading state (API-5).
+- **`toggle-group`** — Toggle buttons sharing one selection — single or multiple, horizontal or vertical.
 
 ## Form
 
 - **`auto-save-input`** — An input that debounces edits and persists them via an async onSave, with an inline idle/saving/saved/error status.
-- **`checkbox`** — A binary (or tri-state) toggle — checked, unchecked, indeterminate, disabled, built on Base UI Checkbox.
-- **`checkbox-group`** — Shared state for a set of checkboxes, with first-class “select all” — parent, mixed, and the whole-set toggle, built on Base UI Checkbox Group.
+- **`calendar`** — A date-field calendar on React DayPicker — single, multiple and range selection.
+- **`checkbox`** — A binary (or indeterminate) toggle on Base UI Checkbox, with a 24px invisible hit area (A11Y-2).
 - **`chip-input`** — Free-token entry field — Enter/comma/paste commits chips, Backspace removes, per-chip validation marks invalid entries instead of dropping them. Combobox field chrome + real Tag chips.
 - **`color-picker`** — A swatch-triggered popover presenting a grid of preset colors — pick one, fire onValueChange, mark the selection.
-- **`combobox`** — A filterable, keyboard-navigable listbox behind a text input — type-to-filter, grouped items, async status, and a multi-select chip mode.
+- **`combobox`** — A filterable listbox behind a text input — grouped items, an announced empty state and a chips mode.
 - **`country-select`** — A searchable country picker returning the ISO 3166-1 alpha-2 code, with flag + name. A thin wrapper over SearchableSelect fed by the geo-data item.
 - **`date-picker`** — Pick a single date or a date range from a calendar popover — token-styled, keyboard-navigable, with optional quick presets.
 - **`dropzone`** — File acquisition surface — drop, click-to-browse, and paste — as a thin shell over use-file-drop; the surface is the named focusable control over a hidden picker-bridge input; data-dragging/data-drag-invalid styling flags.
 - **`editable-cell`** — Inline-editable value with an async commit lifecycle — optimistic display, saving/saved/error status, revert on a rejected write, and a typed text/select/custom editor registry.
 - **`emoji-picker`** — A popover with a searchable, category-grouped grid of emoji that returns the selected character via onSelect (curated set, not full Unicode).
-- **`field`** — A form-field wrapper — label, inline label action, description, and error/success message, built on Base UI Field.
-- **`field-inline`** — Click-to-edit text — displays a value, swaps to a focused input on click, commits on Enter or blur, cancels on Escape.
-- **`input`** — A styled Base UI input — all input types, Field state data attributes, error and disabled states, a focus border tint, and optional prefix/suffix addons.
-- **`label`** — A styled native label for form controls — htmlFor association, disabled dimming, optional required indicator.
-- **`number-field`** — Locale-aware numeric input on Base UI's NumberField in Input's field chrome — Intl formatting (money is a format prop), min/max/step, keyboard stepping, wheel scrub, full-height steppers.
-- **`otp-input`** — A multi-slot one-time-passcode input — keyboard navigation, paste distribution, masking, disabled, built on Base UI OTP Field.
-- **`password-input`** — A password field with a show/hide eye toggle and an optional live requirements checklist.
-- **`radio-group`** — A set of mutually-exclusive options — single selection, arrow-key navigation, disabled, built on Base UI Radio Group.
+- **`field`** — The form-field scaffold — label, description, error, legend, separator and choice-card layouts.
+- **`input`** — A styled Base UI input for every text-entry type, with the text-entry focus border tint (FOC-3).
+- **`input-group`** — An input or textarea with addons — icons, text, buttons, kbd hints and spinners on one surface.
+- **`input-otp`** — A one-time-password field with per-character slots, driven by one hidden input.
+- **`label`** — A styled native label for form controls.
+- **`native-select`** — The platform <select>, tokenized — the OS picker on mobile, with option groups.
+- **`number-field`** — Locale-aware numeric input on Base UI's NumberField in upstream's InputGroup chrome, with full-height flanking steppers.
+- **`radio-group`** — Mutually-exclusive options with arrow-key navigation and a 24px invisible hit area (A11Y-2).
 - **`region-select`** — A searchable picker of states/provinces for a country, with a free-text fallback for countries with no subdivisions. A thin wrapper over SearchableSelect fed by the geo-data item.
 - **`searchable-select`** — The Select-shaped Combobox preset: a full-width trigger, an in-panel search field, a check on the selected row and an optional clear control. Single-select, controlled through value/onValueChange.
-- **`select`** — A dropdown for choosing one option — trigger with value and chevron, grouped scrollable popup, full keyboard navigation, animated enter/exit.
-- **`slider`** — Pick a number or a [from, to] range from a continuous track — keyboard accessible, with optional steps. Built on Base UI Slider.
-- **`switch`** — An on/off toggle for instant, self-saving binary settings — built on Base UI Switch.
-- **`textarea`** — A styled native textarea for multi-line text — error/disabled states, a focus border tint, and an optional auto-grow mode.
+- **`select`** — A dropdown for one value — trigger, grouped scrollable popup and item-aligned positioning.
+- **`slider`** — A number or range over a continuous track — horizontal or vertical, any number of thumbs.
+- **`switch`** — An on/off toggle for instant settings — two sizes and a 24px invisible hit area (A11Y-2).
+- **`textarea`** — A styled native textarea that grows with its content, with the text-entry focus border tint (FOC-3).
 
 ## Display
 
 - **`chip`** — The one labelled pill primitive — 10 decorative hues, two tiers, an optional selection rung, and a real 24x24 remove control. Behind Tag, FilterChip and Combobox chips.
 - **`code-block`** — A code panel with a language header and copy affordance — the shared code surface for chat transcripts, docs, and examples.
-- **`onboarding-checklist`** — A getting-started card — segmented progress + step rows, collapsible to a progress pill.
 - **`stat`** — A labelled value block — muted label over a value, honest faint empty state, optional delta line. Two scales.
 - **`tag-group`** — Hue-tinted label chips on the 10-hue tag palette, with +N overflow collapsing and removable tags.
 
 ## Data display
 
-- **`accordion`** — A stack of collapsible sections — single or multiple open, animated height, a rotating chevron, full keyboard support.
+- **`accordion`** — A vertically stacked set of interactive headings that each reveal a section of content — one open at a time, or several.
 - **`animated-number`** — A number display that tweens from its previous value to a new one on every change — Intl.NumberFormat-aware (currency/percent/compact), instant under reduced motion, the dashboard stat-card counter.
-- **`avatar`** — A circular user/entity image with an initials fallback, five sizes, and an overlapping AvatarGroup stack.
-- **`badge`** — A compact status or label chip — solid / soft / outline / minimal × 5 semantic colors × 3 real size tiers, with a dot, a leading icon, and loading.
-- **`card`** — A borders-only content surface — no shadows, with composable header, content, and footer parts.
-- **`chart`** — A themed Recharts wrapper — token-only series colors (--chart-1…--chart-8), a bordered tooltip/legend, and Recharts' own built-in keyboard + screen-reader layer.
-- **`collapsible`** — A single toggleable open/close region with an animated height, built on Base UI Collapsible.
-- **`empty`** — A zero-data placeholder — icon, title, description, actions, with intent tints and a plain, card, or dashed container.
-- **`item`** — A compact anatomy row for list/feed content — media, title, description, actions, groupable with dividers.
-- **`kbd`** — The one keyboard-key chip — modifier labels the caller resolves per platform, a keys array, and three inline sizes.
+- **`avatar`** — A circular user or entity image with a fallback, a badge, and an overlapping group.
+- **`badge`** — A compact label or status chip — upstream's six variants plus our four status tones (COL-12).
+- **`card`** — A content surface with composable header, content, footer and action parts.
+- **`carousel`** — A slide track with previous and next controls — horizontal or vertical, any slide size or spacing, Embla options, events and plugins.
+- **`chart`** — A themed Recharts wrapper — a ChartConfig that maps each series to a colour and a label, a bordered tooltip and legend, and Recharts' own built-in keyboard + screen-reader layer.
+- **`collapsible`** — An interactive component which expands and collapses a panel, with an animated height and a trigger you supply.
+- **`empty`** — A zero-data placeholder — media, title, description and a content slot.
+- **`item`** — A composable row for list and feed content — media, title, description, actions.
+- **`kbd`** — A keyboard-key chip, and a group that lays several of them out inline.
 - **`markdown-view`** — Render a markdown string to safe, token-styled HTML — headings, lists, code, blockquotes, links, GFM tables — XSS-safe, no raw HTML.
 - **`relative-time`** — Render a date as a human-relative string ("2 hours ago", "yesterday") with native Intl.RelativeTimeFormat — self-updating, with an absolute-date tooltip.
 - **`status-icon`** — A small status indicator icon — todo, in progress, blocked, done — each mapping to a lucide icon and semantic color.
-- **`table`** — Styled semantic table primitives — a scrollable container plus header, body, footer, row, head, cell, caption.
+- **`table`** — A responsive table component — caption, header, body, footer, row, head and cell parts over semantic table markup.
 - **`timeline`** — Rail geometry for chronological records — a continuous connector with a node per entry. Rows compose Item parts; separators render through Marker; entries carry content-visibility render skipping.
 - **`truncated-text`** — Truncate text to one line or N lines with an ellipsis, revealing the full text in a tooltip only when it overflows — with per-region control over the tab stop.
 
@@ -86,46 +84,50 @@ component and never an icon.
 
 ## Overlay
 
-- **`alert-dialog`** — A modal confirmation dialog with four semantic intents — non-dismissable, forcing a deliberate Cancel/confirm choice.
-- **`context-menu`** — A menu of actions revealed by right-click (or long-press) — items, submenus, separators, labels, shortcuts, checkbox/radio.
-- **`dialog`** — A modal overlay — five sizes, a header/footer layout, focus trapping, and animated enter/exit.
-- **`dropdown-menu`** — A menu of actions triggered by a button — items, submenus, separators, labels, shortcuts, and checkbox/radio selections.
-- **`floating-surface`** — The shared floating-overlay module: one Portal/Positioner/Popup composer, the popup surface recipes, the list-item recipe, and the in-panel search row.
-- **`hover-card`** — A rich preview panel that opens on hover or focus — interactive content, four directions, forgiving delays.
-- **`popover`** — A click-triggered floating panel for arbitrary content — positioning, an optional arrow, and built-in dismiss.
-- **`sheet`** — A dialog that slides in from a screen edge — four sides, header/footer layout, focus trapping, animated slide.
+- **`alert-dialog`** — A modal that interrupts for a decision — an optional media slot, two sizes and an action/cancel footer.
+- **`context-menu`** — The same menu vocabulary opened by right-click, positioned at the pointer.
+- **`dialog`** — A modal overlay — a backdrop, a centred popup, an optional close button and a sticky footer band.
+- **`drawer`** — A swipeable panel with snap points — four directions, a swipe handle, nesting and a non-modal mode.
+- **`dropdown-menu`** — An anchored action menu — items, submenus, checkboxes, radio groups, shortcuts and a destructive variant.
+- **`hover-card`** — A preview surface that opens on hover or focus, with configurable delays and sides.
+- **`panel-search`** — The sticky, box-free search row a filtering popup puts at the top of its panel (decision OVL-11) — shared by EmojiPicker and ShortcutOverlay.
+- **`popover`** — An anchored, dismissible surface for secondary content, with a header, title and description.
+- **`sheet`** — A panel that slides in from any edge — Dialog semantics with a side, a header and a footer.
 - **`shortcut-overlay`** — The ?-triggered dialog listing keyboard shortcuts, rendered from a declaration registry (keys, label, category, when) — grouped, filterable, platform-aware via use-platform + Kbd.
-- **`tooltip`** — A floating label on hover or focus — smart shared delay, rich content, optional keyboard hints, collision-aware positioning.
+- **`tooltip`** — A floating label on hover or focus, portaled inside the theme scope (OVL-13).
 
 ## Navigation
 
 - **`breadcrumb`** — A hierarchical navigation trail — links, separators, the current page, and ellipsis collapse for long paths.
 - **`command`** — A searchable command palette — filtered, grouped items with keyboard navigation, optionally inside a ⌘K dialog.
-- **`navigation-menu`** — Site-nav mega-dropdown on the Base UI NavigationMenu primitive — chip triggers, one shared sliding panel, grid links.
+- **`menubar`** — A persistent horizontal bar of menus — application-style File / Edit / View navigation.
+- **`navigation-menu`** — A collection of links for navigating websites — triggers that open one shared panel, and plain links styled to match.
 - **`page-header`** — The standardized header at the top of a page — back button, breadcrumb trail, title, description, actions, secondary menu, and a favorite star.
 - **`pagination`** — Page navigation — previous/next, numbered page links, an ellipsis for long ranges, and the active page.
-- **`sidebar`** — A collapsible app navigation rail — header/content/footer, labelled groups, menu items with active state, and an expand/collapse trigger.
+- **`sidebar`** — A composable, themeable and customizable sidebar — a provider, a collapsible panel with header, content and footer, labelled groups, menu rows with actions, badges and submenus, a rail and a trigger.
 - **`stepper`** — A bounded linear process as an ordered list — complete/current/upcoming/error states on StatusIcon's vocabulary, aria-current=step, advance-gating message, focus follows the process.
-- **`tabs`** — Layered content sections — line or pill variants, optional icons and count badges, horizontal or vertical, full keyboard navigation.
+- **`tabs`** — A set of layered sections of content — known as tab panels — that are displayed one at a time.
 
 ## Feedback
 
 - **`action-bar`** — Floating contextual bar — status region + action children, CSS-only enter/exit, raised band. Bulk selection, unsaved changes, and batch progress are recipes over it.
-- **`alert`** — A status banner — five semantic variants, an optional icon, and an optional dismiss button.
-- **`progress`** — A horizontal progress bar for measurable, ongoing tasks — determinate or a sweeping indeterminate segment, built on Base UI Progress.
-- **`progress-indicator`** — A compact circular pie-fill progress indicator (0–100%) with optional visible percentage variants.
+- **`alert`** — A status banner — upstream's two variants plus our three extra status tones (COL-12).
+- **`progress`** — Displays an indicator showing the completion progress of a task, typically displayed as a progress bar.
 - **`provider`** — The single app-root wrapper — theme (next-themes), Base UI toasts, tooltip delays, and text direction in one mount-once component.
-- **`skeleton`** — A token-driven loading placeholder — line, circle, rect, card shapes, a configurable count, and a pulse that stops under reduced motion.
-- **`spinner`** — An indeterminate loading indicator — a spinning icon inheriting currentColor, four sizes, role=status by default.
-- **`toast`** — Brief, non-blocking notifications — a stacking Base UI Toast surface with success, error, warning, info and loading types, promise toasts and swipe-to-dismiss.
+- **`skeleton`** — A pulsing placeholder that reserves layout space while content loads.
+- **`sonner`** — The sonner toaster, themed onto the token contract — an alternative notification engine with its own imperative API.
+- **`spinner`** — An indeterminate loading indicator that inherits its host's ink.
+- **`toast`** — Brief, non-blocking notifications — a stacking Base UI Toast surface with typed icons, actions and promise toasts.
 
 ## Layout
 
 - **`app-shell`** — The shared dashboard layout — a skip-linked sidebar + header + scrollable main region, composing Sidebar/SidebarTrigger into one reusable, hash-tracked shell.
+- **`aspect-ratio`** — Constrains its children to a given width-to-height ratio.
 - **`board`** — Kanban columns over use-drag-reorder — content/chrome split (host renders card content only), pointer drag, keyboard move mode + roving focus, lossless per-card Move menu with lock reasons, server-refusable moves, collapsed lanes, Empty-bordered drop targets.
-- **`resizable`** — Draggable, keyboard-resizable split panes — horizontal or vertical, nestable, with an optional collapsible panel. Built on react-resizable-panels.
-- **`scroll-area`** — A scroll container with custom, auto-hiding scrollbars — dual-axis, token-styled, built on Base UI ScrollArea.
-- **`separator`** — A thin rule dividing content — horizontal or vertical, decorative by default, built on Base UI.
+- **`direction`** — Base UI's DirectionProvider and useDirection — the text-direction context components read.
+- **`resizable`** — Accessible resizable panel groups and layouts with keyboard support — horizontal or vertical, nestable, with an optional visible grip.
+- **`scroll-area`** — Augments native scroll functionality for custom, cross-browser styling — a viewport, an auto-hiding scrollbar, and a corner.
+- **`separator`** — A thin rule dividing content — horizontal or vertical, built on Base UI.
 - **`settings-row`** — A borders-only settings layout — titled sections, bordered cards, and label-plus-control rows.
 
 ## Media
@@ -146,26 +148,14 @@ component and never an icon.
 
 ## Communication
 
-- **`attachment`** — A file chip / thumbnail card for chat and message-compose surfaces - media slot, name + meta, uploading/error/complete states, remove/download actions.
+- **`attachment`** — A file chip / thumbnail card for chat and message-compose surfaces — media slot, name + meta, idle/uploading/processing/error/done states, an actions row and a full-bleed trigger.
 - **`bubble`** — A chat speech bubble - 7 token-driven variants (incl. brand-tinted), start/end alignment, interactive content, and a floating reactions chip.
 - **`marker`** — An inline conversation marker - status lines, system notes, and labelled dividers. 3 variants, Base UI render-polymorphic.
 - **`message`** — Layout primitives for a conversation row - avatar anchoring, content column, header/footer slots, start/end alignment. Server-safe.
 - **`message-scroller`** — A virtualised, auto-scrolling conversation viewport - pins to the latest message, preserves position on prepend, tracks the anchor, and a floating scroll-to-end button.
+- **`questionnaire`** — A guided one-question-at-a-time form — choices, freeform answers, skip, shortcuts, validation, resume and conditional items, built on the @shadcn/react questionnaire state machine.
 
 ## Marketing
 
 - **`announcement-banner`** — A dismissible one-line announcement — the full-width inverse page-top band (in-content notices use Alert variant=strip).
-- **`comparison-matrix`** — A plan-feature matrix with accessible ✓/− availability cells and a highlighted plan column.
-- **`figure-frame`** — A sharp-cornered media frame with an optional mono FIG-annotation caption.
-- **`logo-row`** — A muted logo/wordmark strip — alpha-dimmed at rest, restoring on hover for linked items.
-- **`marketing-surface`** — Opts a subtree into the brand's dark warm ground, independent of the page's .dark class.
-- **`particle-field`** — A deterministic, very-low-alpha canvas field of drifting phosphor dots — hero atmosphere only.
-- **`pricing-section`** — Marketing plan cards — mono price display, check feature lists, highlighted-plan treatment.
-- **`ruled-band`** — A hairline-bounded editorial strip with mono-label ends — the changelog/serial-number furniture.
-- **`section-header`** — A marketing section lead-in — mono uppercase eyebrow, display-scale title, optional description.
 - **`terminal`** — A dark mono command block with a phosphor prompt glyph and a composed copy button.
-- **`testimonial`** — A pull-quote — a serif-italic quote over a mono uppercase attribution line.
-
-## Marketing motion
-
-- **`staggered-text-reveal`** — Display text whose words rise in on mount, staggered one motion-enter-up step apart — CSS-only.

package/dist/chunk-DS7SBEDS.js

@@ -1,186 +0,0 @@
-// src/index.ts
-import { clsx } from "clsx";
-import { extendTailwindMerge } from "tailwind-merge";
-
-// src/prose.ts
-var prose = {
-  /** The root's own ink and size — every rule below is relative to this. */
-  root: "text-base text-foreground",
-  // Headings. `scroll-m-20` keeps an anchored heading clear of a sticky header; the weight ladder
-  // caps at 500, which the `text-h*` roles already carry.
-  h1: "[&_h1]:mt-6 [&_h1]:mb-3 [&_h1]:scroll-m-20 [&_h1]:text-h1 [&_h1]:text-foreground [&_h1]:first:mt-0",
-  h2: "[&_h2]:mt-6 [&_h2]:mb-3 [&_h2]:scroll-m-20 [&_h2]:text-h2 [&_h2]:text-foreground [&_h2]:first:mt-0",
-  h3: "[&_h3]:mt-5 [&_h3]:mb-2 [&_h3]:scroll-m-20 [&_h3]:text-h3 [&_h3]:text-foreground [&_h3]:first:mt-0",
-  h4: "[&_h4]:mt-4 [&_h4]:mb-2 [&_h4]:scroll-m-20 [&_h4]:text-h4 [&_h4]:text-foreground [&_h4]:first:mt-0",
-  // h5/h6 leave the display tier and become labels — the type scale has no sixth heading size.
-  h5: "[&_h5]:mt-4 [&_h5]:mb-2 [&_h5]:text-label [&_h5]:text-foreground [&_h5]:first:mt-0",
-  h6: "[&_h6]:mt-4 [&_h6]:mb-2 [&_h6]:text-label [&_h6]:text-muted-foreground [&_h6]:first:mt-0",
-  p: "[&_p]:my-3 [&_p]:leading-relaxed [&_p]:text-foreground [&_p]:first:mt-0 [&_p]:last:mb-0",
-  // Marks. Links are `info` ink per design.md §Colours; `s` is Tiptap's strike element and `del`
-  // is GFM's — the same mark from two producers.
-  a: "[&_a]:font-medium [&_a]:text-info-text [&_a]:underline [&_a]:underline-offset-4 [&_a]:hover:text-info-text/(--alpha-link-hover)",
-  strong: "[&_strong]:font-medium [&_strong]:text-foreground",
-  em: "[&_em]:italic",
-  del: "[&_del]:text-muted-foreground [&_del]:line-through [&_s]:text-muted-foreground [&_s]:line-through",
-  // Lists. A GFM task list carries `contains-task-list` and its checkbox IS the marker, so the
-  // disc goes — expressed as a second, more specific descendant rule rather than a class on the
-  // element, which would lose the cascade (see the header).
-  ul: "[&_ul]:my-3 [&_ul]:ms-6 [&_ul]:list-disc [&_ul]:text-foreground [&_ul]:marker:text-muted-foreground [&_ul.contains-task-list]:list-none",
-  ol: "[&_ol]:my-3 [&_ol]:ms-6 [&_ol]:list-decimal [&_ol]:text-foreground [&_ol]:marker:text-muted-foreground",
-  li: "[&_li]:mt-1.5 [&_li]:leading-relaxed",
-  blockquote: "[&_blockquote]:my-3 [&_blockquote]:border-s-2 [&_blockquote]:border-border [&_blockquote]:ps-4 [&_blockquote]:text-muted-foreground [&_blockquote]:italic",
-  // Inline code is a chip. Code inside a `pre` is not: it inherits the panel's ground, so the chip
-  // is undone at higher specificity (`[&_pre_code]` is (0,1,2) against the chip's (0,1,1)).
-  code: "[&_code]:rounded-sm [&_code]:bg-muted [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:font-mono [&_code]:text-base [&_code]:text-foreground",
-  // A bare `<pre>` wears `CodeBlock`'s surface — the same sunken panel, one vocabulary (B4-09).
-  // `CodeBlock`'s own `pre` is excluded: it already sits inside a `figure` carrying the border,
-  // radius and ground, and re-applying them here would draw a second panel inside the first.
-  pre: "[&_pre:not([data-slot='code-block-pre'])]:my-3 [&_pre:not([data-slot='code-block-pre'])]:overflow-x-auto [&_pre:not([data-slot='code-block-pre'])]:rounded-lg [&_pre:not([data-slot='code-block-pre'])]:border [&_pre:not([data-slot='code-block-pre'])]:border-border [&_pre:not([data-slot='code-block-pre'])]:bg-muted [&_pre:not([data-slot='code-block-pre'])]:p-4 [&_pre:not([data-slot='code-block-pre'])]:text-foreground",
-  preCode: "[&_pre_code]:bg-transparent [&_pre_code]:p-0 [&_pre_code]:font-mono [&_pre_code]:text-code [&_pre_code]:text-foreground",
-  hr: "[&_hr]:my-6 [&_hr]:border-border",
-  // GFM tables. The scroll container is structural and belongs to the consumer (MarkdownView wraps
-  // the table in an `overflow-x-auto` div); these are the cell and rule tokens.
-  table: "[&_table]:w-full [&_table]:border-collapse [&_table]:text-base [&_table]:text-foreground [&_thead]:border-b [&_thead]:border-border [&_tr]:border-b [&_tr]:border-border [&_tr]:last:border-0 [&_th]:px-3 [&_th]:py-2 [&_th]:text-start [&_th]:font-medium [&_th]:text-foreground [&_td]:px-3 [&_td]:py-2 [&_td]:text-muted-foreground",
-  img: "[&_img]:my-3 [&_img]:max-w-full [&_img]:rounded-lg [&_img]:border [&_img]:border-border"
-};
-var proseClassName = Object.values(prose).join(" ");
-
-// src/index.ts
-var twMerge = extendTailwindMerge({
-  extend: {
-    classGroups: {
-      "font-size": [
-        {
-          text: [
-            "h1",
-            "h2",
-            "h3",
-            "h4",
-            "label",
-            "label-sm",
-            "code",
-            "code-sm",
-            "mono-label",
-            "display-sm",
-            "display-md",
-            "display-lg",
-            "display-xl"
-          ]
-        }
-      ]
-    }
-  }
-});
-function cn(...inputs) {
-  return twMerge(clsx(inputs));
-}
-var surfaceInteractive = "hover:bg-surface-2 active:bg-surface-3";
-var surfaceInteractiveGroup = "group-hover/wash:bg-surface-2 group-active/wash:bg-surface-3";
-var fillInteractive = {
-  foreground: "hover:bg-foreground/(--alpha-hover) active:bg-foreground/(--alpha-pressed)",
-  primary: "hover:bg-primary/(--alpha-hover) active:bg-primary/(--alpha-pressed)",
-  destructive: "hover:bg-destructive/(--alpha-hover) active:bg-destructive/(--alpha-pressed)",
-  success: "hover:bg-success/(--alpha-hover) active:bg-success/(--alpha-pressed)",
-  warning: "hover:bg-warning/(--alpha-hover) active:bg-warning/(--alpha-pressed)",
-  info: "hover:bg-info/(--alpha-hover) active:bg-info/(--alpha-pressed)",
-  brand: "hover:bg-brand/(--alpha-hover) active:bg-brand/(--alpha-pressed)"
-};
-var fieldControl = [
-  "rounded-md border border-input bg-transparent dark:bg-input/(--alpha-input)",
-  "placeholder:text-muted-foreground-faint",
-  "not-disabled:not-data-disabled:hover:border-foreground/(--alpha-border-subtle)",
-  "focus:border-ring/(--alpha-tint-border)",
-  "not-focus:aria-invalid:border-destructive-border/(--alpha-tint-border)",
-  "not-focus:data-invalid:border-destructive-border/(--alpha-tint-border)",
-  "disabled:cursor-not-allowed disabled:bg-surface-1 disabled:opacity-(--opacity-dim)",
-  "data-disabled:cursor-not-allowed data-disabled:bg-surface-1 data-disabled:opacity-(--opacity-dim)"
-].join(" ");
-var fieldControlGroup = [
-  "rounded-md border border-input bg-transparent dark:bg-input/(--alpha-input)",
-  "not-has-disabled:not-data-disabled:hover:border-foreground/(--alpha-border-subtle)",
-  "focus-within:border-ring/(--alpha-tint-border)",
-  "data-focused:border-ring/(--alpha-tint-border)",
-  // Both the SELF and the DESCENDANT form of the invalid tint (2026-09-09). `has-aria-invalid:` is
-  // a `:has()` over descendants, so a group that carries `aria-invalid` on ITSELF — which is where
-  // `<NumberField aria-invalid />` lands the attribute, on the `[data-field-group]` element —
-  // matched nothing and measured the neutral `--input` border. Inside a `Field` the state arrives
-  // as `data-invalid` on the group and was always correct; this is the standalone path.
-  "not-focus-within:aria-invalid:border-destructive-border/(--alpha-tint-border)",
-  "not-focus-within:has-aria-invalid:border-destructive-border/(--alpha-tint-border)",
-  "not-focus-within:data-invalid:border-destructive-border/(--alpha-tint-border)",
-  "has-disabled:cursor-not-allowed has-disabled:bg-surface-1 has-disabled:opacity-(--opacity-dim)",
-  "data-disabled:cursor-not-allowed data-disabled:bg-surface-1 data-disabled:opacity-(--opacity-dim)"
-].join(" ");
-var selectedChipVariants = {
-  /**
-   * The muted track the chips sit in — the ladder's well rung with a drawn inset boundary. The
-   * pseudo-element keeps the 28 / 32px track boxes unchanged; a real root border would add 2px and
-   * silently break the shared control scale.
-   */
-  track: "relative bg-surface-1 after:pointer-events-none after:absolute after:inset-0 after:rounded-[inherit] after:border after:border-border after:content-['']",
-  /**
-   * Chrome shared by every chip: a transparent hairline reserved at rest (so selecting adds no
-   * layout shift) and the muted→ink text step.
-   */
-  item: "border border-transparent hover:text-foreground",
-  /** Selected keyed on Base UI's `data-pressed` — Toggle, ToggleGroup, Segmented. */
-  pressed: "not-data-pressed:hover:bg-foreground/(--alpha-hover) not-data-pressed:active:bg-foreground/(--alpha-pressed) data-pressed:border-border data-pressed:bg-foreground/(--alpha-ink-tint) data-pressed:text-foreground data-pressed:hover:bg-foreground/(--alpha-ink-tint-strong) data-pressed:active:bg-foreground/(--alpha-ink-tint)",
-  /** Selected keyed on Base UI's `data-active` — Tabs. */
-  active: "not-data-[active]:hover:bg-foreground/(--alpha-hover) not-data-[active]:active:bg-foreground/(--alpha-pressed) data-[active]:border-border data-[active]:bg-foreground/(--alpha-ink-tint) data-[active]:text-foreground data-[active]:hover:bg-foreground/(--alpha-ink-tint-strong) data-[active]:active:bg-foreground/(--alpha-ink-tint)"
-};
-var TIMINGS = {
-  /** How long transient success feedback holds before reverting (CopyButton "Copied ✓"). */
-  feedbackRevertMs: 1500,
-  /** Debounce before auto-persisting a text field (AutoSaveInput). */
-  autoSaveDebounceMs: 800,
-  /** Hover delay before a rich preview (HoverCard) opens — guards accidental opens. */
-  hoverOpenDelayMs: 700,
-  /** Hover delay before a rich preview closes — lets the pointer travel into the card. */
-  hoverCloseDelayMs: 300,
-  /**
-   * Hover delay before a tooltip opens. A tooltip is a cheap label, not a preview, so it is
-   * deliberately much faster than {@link TIMINGS.hoverOpenDelayMs} — long enough that sweeping
-   * across a toolbar does not flash five tips, short enough that a deliberate hover feels
-   * instant. Base UI's `Tooltip.Provider` grouping then opens adjacent tips with no delay at
-   * all. Set once, in the app-root provider.
-   */
-  tooltipOpenDelayMs: 300,
-  /**
-   * Delay before a tooltip closes. Zero: a tooltip has nothing to travel into (it is not
-   * hoverable content, unlike a HoverCard), so holding it after the pointer leaves only
-   * obscures what the user moved on to.
-   */
-  tooltipCloseDelayMs: 0
-};
-var FLOATING = {
-  sideOffsetAttached: 4,
-  sideOffsetDetached: 8,
-  collisionPadding: 8
-};
-function mergeRefs(...refs) {
-  return (node) => {
-    for (const ref of refs) {
-      if (ref == null) continue;
-      if (typeof ref === "function") {
-        ref(node);
-      } else {
-        ref.current = node;
-      }
-    }
-  };
-}
-
-export {
-  prose,
-  proseClassName,
-  cn,
-  surfaceInteractive,
-  surfaceInteractiveGroup,
-  fillInteractive,
-  fieldControl,
-  fieldControlGroup,
-  selectedChipVariants,
-  TIMINGS,
-  FLOATING,
-  mergeRefs
-};