@viraui/react 2026.3.11 → 2026.4.0

package/dist/specs/index.xml

@@ -0,0 +1,538 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<index package="@viraui/react" version="2026.4.0" generated="2026-09-16T13:34:08.732Z">
+  <categories>
+    <category id="layout" />
+    <category id="action" />
+    <category id="form" />
+    <category id="feedback" />
+    <category id="overlay" />
+    <category id="effect" />
+    <category id="typography" />
+    <category id="foundation" />
+    <category id="pattern" />
+  </categories>
+  <entry id="accordion" category="layout" title="Accordion">
+    <summary>Collapsible sections grouped into open/closed blocks with optional Surface wrapping, shared corner radius, and optional Item color for open-block background.</summary>
+    <units>
+      <unit kind="meta" href="components/accordion/meta.xml" />
+      <unit kind="a11y" href="components/accordion/a11y.xml" />
+      <unit kind="props" href="components/accordion/props.xml" />
+      <unit kind="usage" href="components/accordion/usage.xml" />
+      <unit kind="patterns" href="components/accordion/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="annotate" category="effect" title="Annotate">
+    <summary>Decorative arrow and handwritten label that wraps inline content with optional highlighter mark, positioned via CSS anchor positioning.</summary>
+    <units>
+      <unit kind="meta" href="components/annotate/meta.xml" />
+      <unit kind="a11y" href="components/annotate/a11y.xml" />
+      <unit kind="props" href="components/annotate/props.xml" />
+      <unit kind="usage" href="components/annotate/usage.xml" />
+      <unit kind="patterns" href="components/annotate/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="autocomplete" category="form" title="Autocomplete">
+    <summary>Field-wrapped free-form suggest input with Textfield chrome and Select-like popup list.</summary>
+    <units>
+      <unit kind="meta" href="components/autocomplete/meta.xml" />
+      <unit kind="a11y" href="components/autocomplete/a11y.xml" />
+      <unit kind="props" href="components/autocomplete/props.xml" />
+      <unit kind="usage" href="components/autocomplete/usage.xml" />
+      <unit kind="patterns" href="components/autocomplete/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="avatar" category="layout" title="Avatar">
+    <summary>Circular identity image or fallback for users, entities, or profile chips.</summary>
+    <units>
+      <unit kind="meta" href="components/avatar/meta.xml" />
+      <unit kind="a11y" href="components/avatar/a11y.xml" />
+      <unit kind="props" href="components/avatar/props.xml" />
+      <unit kind="usage" href="components/avatar/usage.xml" />
+      <unit kind="patterns" href="components/avatar/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="avatar-group" category="layout" title="AvatarGroup">
+    <summary>Overlapping avatar stack with shared sizing, directional layout, and an optional overflow pill.</summary>
+    <units>
+      <unit kind="meta" href="components/avatar-group/meta.xml" />
+      <unit kind="a11y" href="components/avatar-group/a11y.xml" />
+      <unit kind="props" href="components/avatar-group/props.xml" />
+      <unit kind="usage" href="components/avatar-group/usage.xml" />
+      <unit kind="patterns" href="components/avatar-group/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="badge" category="feedback" title="Badge">
+    <summary>Decorative status-dot overlay that wraps a child, with optional radial mask cutout on the child around the corner dot.</summary>
+    <units>
+      <unit kind="meta" href="components/badge/meta.xml" />
+      <unit kind="a11y" href="components/badge/a11y.xml" />
+      <unit kind="props" href="components/badge/props.xml" />
+      <unit kind="usage" href="components/badge/usage.xml" />
+      <unit kind="patterns" href="components/badge/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="beam" category="effect" title="Beam">
+    <summary>Decorative animated border, line, or pulse glow on a transparent Surface shell (radius only). Put the visual card as children. CSS-module geometry plus shared ~30fps pulse rAF for pulse variants. Mem…</summary>
+    <units>
+      <unit kind="meta" href="components/beam/meta.xml" />
+      <unit kind="a11y" href="components/beam/a11y.xml" />
+      <unit kind="props" href="components/beam/props.xml" />
+      <unit kind="usage" href="components/beam/usage.xml" />
+      <unit kind="patterns" href="components/beam/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="bleed" category="layout" title="Bleed">
+    <summary>Layout utility that pulls content past inline padding using negative margins or full viewport bleed.</summary>
+    <units>
+      <unit kind="meta" href="components/bleed/meta.xml" />
+      <unit kind="a11y" href="components/bleed/a11y.xml" />
+      <unit kind="props" href="components/bleed/props.xml" />
+      <unit kind="usage" href="components/bleed/usage.xml" />
+      <unit kind="patterns" href="components/bleed/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="breakpoints" category="layout" title="BreakpointsProvider">
+    <summary>Client provider plus `useBreakpoints` for mobile-first viewport min-width matches. Defaults are hardcoded em thresholds, not theme tokens.</summary>
+    <units>
+      <unit kind="meta" href="components/breakpoints/meta.xml" />
+      <unit kind="a11y" href="components/breakpoints/a11y.xml" />
+      <unit kind="props" href="components/breakpoints/props.xml" />
+      <unit kind="usage" href="components/breakpoints/usage.xml" />
+      <unit kind="patterns" href="components/breakpoints/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="button" category="action" title="Button">
+    <summary>Primary action control with size, variant, optional addon, optional pill shape, and loading state.</summary>
+    <units>
+      <unit kind="meta" href="components/button/meta.xml" />
+      <unit kind="a11y" href="components/button/a11y.xml" />
+      <unit kind="props" href="components/button/props.xml" />
+      <unit kind="usage" href="components/button/usage.xml" />
+      <unit kind="patterns" href="components/button/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="checkbox" category="form" title="Checkbox">
+    <summary>Field.Item checkbox option for standalone fields or CheckboxGroup children.</summary>
+    <units>
+      <unit kind="meta" href="components/checkbox/meta.xml" />
+      <unit kind="a11y" href="components/checkbox/a11y.xml" />
+      <unit kind="props" href="components/checkbox/props.xml" />
+      <unit kind="usage" href="components/checkbox/usage.xml" />
+      <unit kind="patterns" href="components/checkbox/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="chip" category="action" title="Chip">
+    <summary>Compact visual label primitive for short status, category, or metadata treatments.</summary>
+    <units>
+      <unit kind="meta" href="components/chip/meta.xml" />
+      <unit kind="a11y" href="components/chip/a11y.xml" />
+      <unit kind="props" href="components/chip/props.xml" />
+      <unit kind="usage" href="components/chip/usage.xml" />
+      <unit kind="patterns" href="components/chip/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="clamp-text" category="typography" title="ClampText">
+    <summary>Presentational utility that truncates overflowing copy to a fixed line count.</summary>
+    <units>
+      <unit kind="meta" href="components/clamp-text/meta.xml" />
+      <unit kind="a11y" href="components/clamp-text/a11y.xml" />
+      <unit kind="props" href="components/clamp-text/props.xml" />
+      <unit kind="usage" href="components/clamp-text/usage.xml" />
+      <unit kind="patterns" href="components/clamp-text/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="dialog" category="overlay" title="Dialog">
+    <summary>Compound drawer sheet with `Dialog.Trigger`, `Dialog.Sheet`, `Dialog.Close`, and Base UI pass-through `Dialog.Provider`, `Dialog.Indent`, and `Dialog.IndentBackground` for app-shell indent effects.</summary>
+    <units>
+      <unit kind="meta" href="components/dialog/meta.xml" />
+      <unit kind="a11y" href="components/dialog/a11y.xml" />
+      <unit kind="props" href="components/dialog/props.xml" />
+      <unit kind="usage" href="components/dialog/usage.xml" />
+      <unit kind="patterns" href="components/dialog/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="elevator" category="effect" title="Elevator">
+    <summary>No-DOM elevation utility that merges shadow hooks onto valid element children.</summary>
+    <units>
+      <unit kind="meta" href="components/elevator/meta.xml" />
+      <unit kind="a11y" href="components/elevator/a11y.xml" />
+      <unit kind="props" href="components/elevator/props.xml" />
+      <unit kind="usage" href="components/elevator/usage.xml" />
+      <unit kind="patterns" href="components/elevator/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="fieldset" category="form" title="Fieldset">
+    <summary>Semantic field grouping with shared legend and optional group helper copy.</summary>
+    <units>
+      <unit kind="meta" href="components/fieldset/meta.xml" />
+      <unit kind="a11y" href="components/fieldset/a11y.xml" />
+      <unit kind="props" href="components/fieldset/props.xml" />
+      <unit kind="usage" href="components/fieldset/usage.xml" />
+      <unit kind="patterns" href="components/fieldset/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="fit-text" category="typography" title="FitText">
+    <summary>CSS-only fit-to-width wrapper that scales children to fill available inline space.</summary>
+    <units>
+      <unit kind="meta" href="components/fit-text/meta.xml" />
+      <unit kind="a11y" href="components/fit-text/a11y.xml" />
+      <unit kind="props" href="components/fit-text/props.xml" />
+      <unit kind="usage" href="components/fit-text/usage.xml" />
+      <unit kind="patterns" href="components/fit-text/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="glow" category="effect" title="Glow">
+    <summary>Decorative pointer-driven border highlight on a transparent Surface shell (radius only). Put the visual card as children; a shared rAF tracker paints CSS variables without React re-renders. Memory-he…</summary>
+    <units>
+      <unit kind="meta" href="components/glow/meta.xml" />
+      <unit kind="a11y" href="components/glow/a11y.xml" />
+      <unit kind="props" href="components/glow/props.xml" />
+      <unit kind="usage" href="components/glow/usage.xml" />
+      <unit kind="patterns" href="components/glow/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="grid" category="layout" title="Grid">
+    <summary>CSS Grid layout primitive for auto-fill/fit or fixed track layouts with token gaps, Stack-aligned padding, and item placement (`fullWidth` / `fullHeight` / column / row).</summary>
+    <units>
+      <unit kind="meta" href="components/grid/meta.xml" />
+      <unit kind="a11y" href="components/grid/a11y.xml" />
+      <unit kind="props" href="components/grid/props.xml" />
+      <unit kind="usage" href="components/grid/usage.xml" />
+      <unit kind="patterns" href="components/grid/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="icon-button" category="action" title="IconButton">
+    <summary>Icon-only button that shares Button visual chrome (--vui-button-* CSS) and requires an accessible name through aria-label or aria-labelledby.</summary>
+    <units>
+      <unit kind="meta" href="components/icon-button/meta.xml" />
+      <unit kind="a11y" href="components/icon-button/a11y.xml" />
+      <unit kind="props" href="components/icon-button/props.xml" />
+      <unit kind="usage" href="components/icon-button/usage.xml" />
+      <unit kind="patterns" href="components/icon-button/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="linear-progress" category="feedback" title="LinearProgress">
+    <summary>Shows determinate or indeterminate progress for a task in a compact horizontal track.</summary>
+    <units>
+      <unit kind="meta" href="components/linear-progress/meta.xml" />
+      <unit kind="a11y" href="components/linear-progress/a11y.xml" />
+      <unit kind="props" href="components/linear-progress/props.xml" />
+      <unit kind="usage" href="components/linear-progress/usage.xml" />
+      <unit kind="patterns" href="components/linear-progress/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="masonry" category="layout" title="Masonry">
+    <summary>Responsive React-column layout primitive for read-only mixed-height content walls; root is a named CSS container query context (`masonry` / inline-size).</summary>
+    <units>
+      <unit kind="meta" href="components/masonry/meta.xml" />
+      <unit kind="a11y" href="components/masonry/a11y.xml" />
+      <unit kind="props" href="components/masonry/props.xml" />
+      <unit kind="usage" href="components/masonry/usage.xml" />
+      <unit kind="patterns" href="components/masonry/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="menu" category="overlay" title="Menu">
+    <summary>Compound menu built on Base UI Menu with `Menu.Trigger`, `Menu.Popup`, unified item rows, groups, checkbox/radio items, nested submenus, destructive sentiment, and `Menu.createHandle` for detached tr…</summary>
+    <units>
+      <unit kind="meta" href="components/menu/meta.xml" />
+      <unit kind="a11y" href="components/menu/a11y.xml" />
+      <unit kind="props" href="components/menu/props.xml" />
+      <unit kind="usage" href="components/menu/usage.xml" />
+      <unit kind="patterns" href="components/menu/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="meter" category="feedback" title="Meter">
+    <summary>Shows a determinate metric in a compact horizontal track for static capacity, level, or score values.</summary>
+    <units>
+      <unit kind="meta" href="components/meter/meta.xml" />
+      <unit kind="a11y" href="components/meter/a11y.xml" />
+      <unit kind="props" href="components/meter/props.xml" />
+      <unit kind="usage" href="components/meter/usage.xml" />
+      <unit kind="patterns" href="components/meter/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="popover" category="overlay" title="Popover">
+    <summary>Compound popover built on Base UI Popover with `Popover.Trigger`, `Popover.Sheet`, `Popover.Close`, `Popover.Title`, `Popover.Description`, and `Popover.createHandle` for detached and multiple trigge…</summary>
+    <units>
+      <unit kind="meta" href="components/popover/meta.xml" />
+      <unit kind="a11y" href="components/popover/a11y.xml" />
+      <unit kind="props" href="components/popover/props.xml" />
+      <unit kind="usage" href="components/popover/usage.xml" />
+      <unit kind="patterns" href="components/popover/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="progressive-blur" category="effect" title="ProgressiveBlur">
+    <summary>Decorative stacked backdrop-filter overlay that ramps blur from one edge toward the opposite edge.</summary>
+    <units>
+      <unit kind="meta" href="components/progressive-blur/meta.xml" />
+      <unit kind="a11y" href="components/progressive-blur/a11y.xml" />
+      <unit kind="props" href="components/progressive-blur/props.xml" />
+      <unit kind="usage" href="components/progressive-blur/usage.xml" />
+      <unit kind="patterns" href="components/progressive-blur/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="radio" category="form" title="Radio">
+    <summary>Mutually exclusive choice within a RadioGroup, with optional per-option label and helper text.</summary>
+    <units>
+      <unit kind="meta" href="components/radio/meta.xml" />
+      <unit kind="a11y" href="components/radio/a11y.xml" />
+      <unit kind="props" href="components/radio/props.xml" />
+      <unit kind="usage" href="components/radio/usage.xml" />
+      <unit kind="patterns" href="components/radio/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="select" category="form" title="Select">
+    <summary>Field-wrapped single-select dropdown with grouped options and field copy.</summary>
+    <units>
+      <unit kind="meta" href="components/select/meta.xml" />
+      <unit kind="a11y" href="components/select/a11y.xml" />
+      <unit kind="props" href="components/select/props.xml" />
+      <unit kind="usage" href="components/select/usage.xml" />
+      <unit kind="patterns" href="components/select/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="separator" category="layout" title="Separator">
+    <summary>Thematic or content divider with horizontal or vertical orientation, token padding, and preset line thickness.</summary>
+    <units>
+      <unit kind="meta" href="components/separator/meta.xml" />
+      <unit kind="a11y" href="components/separator/a11y.xml" />
+      <unit kind="props" href="components/separator/props.xml" />
+      <unit kind="usage" href="components/separator/usage.xml" />
+      <unit kind="patterns" href="components/separator/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="shimmer" category="effect" title="Shimmer">
+    <summary>Decorative inline text shimmer that inherits typography and color from a parent text primitive.</summary>
+    <units>
+      <unit kind="meta" href="components/shimmer/meta.xml" />
+      <unit kind="a11y" href="components/shimmer/a11y.xml" />
+      <unit kind="props" href="components/shimmer/props.xml" />
+      <unit kind="usage" href="components/shimmer/usage.xml" />
+      <unit kind="patterns" href="components/shimmer/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="skeleton" category="feedback" title="Skeleton">
+    <summary>Decorative opacity pulse block sized by props, or Overlay sized by hidden child content.</summary>
+    <units>
+      <unit kind="meta" href="components/skeleton/meta.xml" />
+      <unit kind="a11y" href="components/skeleton/a11y.xml" />
+      <unit kind="props" href="components/skeleton/props.xml" />
+      <unit kind="usage" href="components/skeleton/usage.xml" />
+      <unit kind="patterns" href="components/skeleton/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="slider" category="form" title="Slider">
+    <summary>Field-wrapped range input supporting single-thumb or two-thumb range selection.</summary>
+    <units>
+      <unit kind="meta" href="components/slider/meta.xml" />
+      <unit kind="a11y" href="components/slider/a11y.xml" />
+      <unit kind="props" href="components/slider/props.xml" />
+      <unit kind="usage" href="components/slider/usage.xml" />
+      <unit kind="patterns" href="components/slider/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="spinner" category="feedback" title="Spinner">
+    <summary>Decorative SVG pulsing loading indicator used inside interactive components.</summary>
+    <units>
+      <unit kind="meta" href="components/spinner/meta.xml" />
+      <unit kind="a11y" href="components/spinner/a11y.xml" />
+      <unit kind="props" href="components/spinner/props.xml" />
+      <unit kind="usage" href="components/spinner/usage.xml" />
+      <unit kind="patterns" href="components/spinner/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="stack" category="layout" title="Stack">
+    <summary>Flex layout primitive for arranging children with token spacing, alignment, and padding; optionally enables a named CSS container query context (`stack`) via `enableContainer`.</summary>
+    <units>
+      <unit kind="meta" href="components/stack/meta.xml" />
+      <unit kind="a11y" href="components/stack/a11y.xml" />
+      <unit kind="props" href="components/stack/props.xml" />
+      <unit kind="usage" href="components/stack/usage.xml" />
+      <unit kind="patterns" href="components/stack/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="static-noise" category="effect" title="StaticNoise">
+    <summary>Decorative SVG turbulence noise overlay for textured surfaces and hero sections. Memory-heavy — use sparingly (rarely).</summary>
+    <units>
+      <unit kind="meta" href="components/static-noise/meta.xml" />
+      <unit kind="a11y" href="components/static-noise/a11y.xml" />
+      <unit kind="props" href="components/static-noise/props.xml" />
+      <unit kind="usage" href="components/static-noise/usage.xml" />
+      <unit kind="patterns" href="components/static-noise/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="surface" category="layout" title="Surface">
+    <summary>Presentational container with token background, optional border, radius, and padding; `data-vibrant` frosts the fill even without `color` (page shell via `--global-background`); nested surfaces use r…</summary>
+    <units>
+      <unit kind="meta" href="components/surface/meta.xml" />
+      <unit kind="a11y" href="components/surface/a11y.xml" />
+      <unit kind="props" href="components/surface/props.xml" />
+      <unit kind="usage" href="components/surface/usage.xml" />
+      <unit kind="patterns" href="components/surface/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="switch" category="form" title="Switch">
+    <summary>Field-wrapped toggle control with medium or small track and optional field copy.</summary>
+    <units>
+      <unit kind="meta" href="components/switch/meta.xml" />
+      <unit kind="a11y" href="components/switch/a11y.xml" />
+      <unit kind="props" href="components/switch/props.xml" />
+      <unit kind="usage" href="components/switch/usage.xml" />
+      <unit kind="patterns" href="components/switch/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="tabs" category="layout" title="Tabs">
+    <summary>Compound segmented tab control with Surface list chrome, moving indicator, and animated panels.</summary>
+    <units>
+      <unit kind="meta" href="components/tabs/meta.xml" />
+      <unit kind="a11y" href="components/tabs/a11y.xml" />
+      <unit kind="props" href="components/tabs/props.xml" />
+      <unit kind="usage" href="components/tabs/usage.xml" />
+      <unit kind="patterns" href="components/tabs/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="text" category="typography" title="Text">
+    <summary>Theme-aware body-copy primitive with tone, family, and responsive body sizing.</summary>
+    <units>
+      <unit kind="meta" href="components/text/meta.xml" />
+      <unit kind="a11y" href="components/text/a11y.xml" />
+      <unit kind="props" href="components/text/props.xml" />
+      <unit kind="usage" href="components/text/usage.xml" />
+      <unit kind="patterns" href="components/text/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="textarea" category="form" title="Textarea">
+    <summary>Multi-line field control with shared field copy, optional resize, and optional content sizing.</summary>
+    <units>
+      <unit kind="meta" href="components/textarea/meta.xml" />
+      <unit kind="a11y" href="components/textarea/a11y.xml" />
+      <unit kind="props" href="components/textarea/props.xml" />
+      <unit kind="usage" href="components/textarea/usage.xml" />
+      <unit kind="patterns" href="components/textarea/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="textfield" category="form" title="Textfield">
+    <summary>Single-line field input with control-group chrome and optional addons.</summary>
+    <units>
+      <unit kind="meta" href="components/textfield/meta.xml" />
+      <unit kind="a11y" href="components/textfield/a11y.xml" />
+      <unit kind="props" href="components/textfield/props.xml" />
+      <unit kind="usage" href="components/textfield/usage.xml" />
+      <unit kind="patterns" href="components/textfield/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="title" category="typography" title="Title">
+    <summary>Theme-aware heading and display typography primitive.</summary>
+    <units>
+      <unit kind="meta" href="components/title/meta.xml" />
+      <unit kind="a11y" href="components/title/a11y.xml" />
+      <unit kind="props" href="components/title/props.xml" />
+      <unit kind="usage" href="components/title/usage.xml" />
+      <unit kind="patterns" href="components/title/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="toast" category="feedback" title="Toast">
+    <summary>Non-callable compound Toast namespace for transient notifications, with stacked or anchored placement, Banner high-level API, and optional action buttons.</summary>
+    <units>
+      <unit kind="meta" href="components/toast/meta.xml" />
+      <unit kind="a11y" href="components/toast/a11y.xml" />
+      <unit kind="props" href="components/toast/props.xml" />
+      <unit kind="usage" href="components/toast/usage.xml" />
+      <unit kind="patterns" href="components/toast/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="toggle-button" category="action" title="ToggleButton">
+    <summary>Icon-only two-state toggle that swaps resting and optional pressed icons on Base UI Toggle state; `interpolateIcons` (default false) opt-in crossfade + light rotate between dual icons.</summary>
+    <units>
+      <unit kind="meta" href="components/toggle-button/meta.xml" />
+      <unit kind="a11y" href="components/toggle-button/a11y.xml" />
+      <unit kind="props" href="components/toggle-button/props.xml" />
+      <unit kind="usage" href="components/toggle-button/usage.xml" />
+      <unit kind="patterns" href="components/toggle-button/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="toggle-group" category="action" title="ToggleGroup">
+    <summary>Toolbar toggle set with shared selection state; Stack direction follows orientation with zero default gap.</summary>
+    <units>
+      <unit kind="meta" href="components/toggle-group/meta.xml" />
+      <unit kind="a11y" href="components/toggle-group/a11y.xml" />
+      <unit kind="props" href="components/toggle-group/props.xml" />
+      <unit kind="usage" href="components/toggle-group/usage.xml" />
+      <unit kind="patterns" href="components/toggle-group/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="typewriter" category="typography" title="Typewriter">
+    <summary>Decorative inline typewriter animation that inherits typography and color from a parent text primitive.</summary>
+    <units>
+      <unit kind="meta" href="components/typewriter/meta.xml" />
+      <unit kind="a11y" href="components/typewriter/a11y.xml" />
+      <unit kind="props" href="components/typewriter/props.xml" />
+      <unit kind="usage" href="components/typewriter/usage.xml" />
+      <unit kind="patterns" href="components/typewriter/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="tooltip" category="overlay" title="Tooltip">
+    <summary>Compound tooltip built on Base UI Tooltip with `Tooltip.Provider`, `Tooltip.Trigger`, `Tooltip.Content`, and `Tooltip.createHandle` for detached and multiple triggers; `Content` encapsulates Portal +…</summary>
+    <units>
+      <unit kind="meta" href="components/tooltip/meta.xml" />
+      <unit kind="a11y" href="components/tooltip/a11y.xml" />
+      <unit kind="props" href="components/tooltip/props.xml" />
+      <unit kind="usage" href="components/tooltip/usage.xml" />
+      <unit kind="patterns" href="components/tooltip/patterns.xml" />
+    </units>
+  </entry>
+  <entry id="core" category="foundation" title="Core / preflight">
+    <summary>Preflight CSS, consumer bootstrap, data-* hooks, core CSS toggles (polarity + effects), elevation helpers, and theme token topic map shipping with @viraui/react.</summary>
+    <units>
+      <unit kind="meta" href="foundation/meta.xml" />
+      <unit kind="bootstrap" href="foundation/bootstrap.xml" />
+      <unit kind="attributes" href="foundation/attributes.xml" />
+      <unit kind="toggles" href="foundation/toggles.xml" />
+      <unit kind="theme-topics" href="foundation/theme-topics.xml" />
+      <unit kind="elevation" href="foundation/elevation.xml" />
+      <unit kind="modules" href="foundation/modules.xml" />
+    </units>
+  </entry>
+  <entry id="foundation-bootstrap" category="foundation" title="Consumer bootstrap">
+    <summary>Packages, import order, cascade layers, root providers, and framework bootstrap rules.</summary>
+    <units>
+      <unit kind="foundation" href="foundation/bootstrap.xml" />
+    </units>
+  </entry>
+  <entry id="foundation-attributes" category="foundation" title="Consumer attributes">
+    <summary>Consumer data-* attributes from preflight (mode, vibrancy, elevation, grow/shrink).</summary>
+    <units>
+      <unit kind="foundation" href="foundation/attributes.xml" />
+    </units>
+  </entry>
+  <entry id="foundation-toggles" category="foundation" title="Core CSS toggles">
+    <summary>Core polarity (--is-light-mode) and theme effect gates agents must not invent around.</summary>
+    <units>
+      <unit kind="foundation" href="foundation/toggles.xml" />
+    </units>
+  </entry>
+  <entry id="foundation-theme-topics" category="foundation" title="Theme topics">
+    <summary>Semantic theme token topics and bootstrap pointers (not full token tables).</summary>
+    <units>
+      <unit kind="foundation" href="foundation/theme-topics.xml" />
+    </units>
+  </entry>
+  <entry id="foundation-elevation" category="foundation" title="Elevation helpers">
+    <summary>Elevator / getElevationProps first; raw data-elevation* only when needed.</summary>
+    <units>
+      <unit kind="foundation" href="foundation/elevation.xml" />
+    </units>
+  </entry>
+  <entry id="foundation-modules" category="foundation" title="Preflight modules">
+    <summary>Preflight CSS modules and related custom properties that compose preflight.css.</summary>
+    <units>
+      <unit kind="foundation" href="foundation/modules.xml" />
+    </units>
+  </entry>
+  <entry id="settings-row" category="pattern" title="Settings row">
+    <summary>Use Stack for the row flex layout and token gap; put the control at the trailing edge.</summary>
+    <units>
+      <unit kind="pattern" href="patterns/settings-row.xml" />
+    </units>
+  </entry>
+</index>

package/dist/specs/patterns/settings-row.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<pattern id="settings-row" title="Settings row">
+  <uses>
+    <ref id="stack" units="meta,usage" />
+    <ref id="text" units="meta" />
+    <ref id="switch" units="meta,props" />
+  </uses>
+  <do>Use Stack for the row flex layout and token gap; put the control at the trailing edge.</do>
+  <dont>Do not reimplement row flex in app CSS when Stack covers alignment and gap.</dont>
+  <tsx><![CDATA[
+<Stack direction="row" vAlign="center" gap="3" fullWidth>
+  <Stack gap="1" expandChildren>
+    <Text weight="medium">Notifications</Text>
+    <Text size="sm" color="muted">Email digests for account activity</Text>
+  </Stack>
+  <Switch aria-label="Notifications" />
+</Stack>
+]]></tsx>
+</pattern>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viraui/react",
-  "version": "2026.3.11",
+  "version": "2026.4.0",
   "private": false,
   "files": [
     "dist"
@@ -16,11 +16,11 @@
     },
     "./preflight.css": "./dist/preflight.css",
     "./catalog.json": "./dist/catalog.json",
-    "./consumption.json": "./dist/consumption.json",
-    "./theme-surface.json": "./dist/theme-surface.json",
-    "./preflight-surface.json": "./dist/preflight-surface.json",
-    "./*.css": "./dist/components/*/*.css",
-    "./*.guide.json": "./dist/components/*/*.guide.json"
+    "./specs/PROTOCOL.md": "./dist/specs/PROTOCOL.md",
+    "./specs/index.xml": "./dist/specs/index.xml",
+    "./specs/activity-hints.xml": "./dist/specs/activity-hints.xml",
+    "./specs/*": "./dist/specs/*",
+    "./*.css": "./dist/components/*/*.css"
   },
   "publishConfig": {
     "access": "public",
@@ -28,7 +28,7 @@
   },
   "devDependencies": {
     "@base-ui/react": ">=1.7.0",
-    "@viraui/foundation": "2026.3.11",
+    "@viraui/foundation": "2026.4.0",
     "@viraui/icons": "2026.0.3",
     "@viraui/postcss-config": "2026.0.0",
     "@viraui/tsconfig": "2026.0.0",
@@ -37,8 +37,7 @@
     "react": ">=19.2.8",
     "react-dom": ">=19.2.8",
     "unplugin-dts": "1.0.3",
-    "vite": "8.2.2",
-    "vite-plugin-static-copy": "4.1.1"
+    "vite": "8.2.2"
   },
   "peerDependencies": {
     "@base-ui/react": ">=1.6.0",
@@ -55,9 +54,11 @@
   ],
   "scripts": {
     "clean": "node --import tsx src/clean-dist.ts",
-    "build": "run-s clean build:lib build:preflight build:catalog",
+    "build": "run-s clean build:lib build:preflight build:catalog build:specs",
     "build:lib": "vite build",
     "build:preflight": "postcss src/preflight.css --output dist/preflight.css",
-    "build:catalog": "node --import tsx src/build-catalog.ts"
+    "build:catalog": "node --import tsx src/build-catalog.ts",
+    "build:specs": "node --import tsx src/build-specs.ts",
+    "check:specs": "node --import tsx scripts/check-specs-completeness.ts"
   }
 }