npm - @abuzareal/contour-ui - Versions diffs - 0.2.1 → 0.3.0 - Mend

@abuzareal/contour-ui 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/CHANGELOG.md +17 -0
package/COMPOSITION.md +193 -0
package/CONTRACTS.md +24 -24
package/NEXTJS.md +3 -1
package/PUBLIC-API.md +174 -174
package/README.md +7 -7
package/dist/components/ui/Button.d.ts +10 -2
package/dist/components/ui/Button.js +7 -3
package/dist/components/ui/Checkbox.d.ts +7 -1
package/dist/components/ui/Checkbox.js +8 -6
package/dist/components/ui/DepthButton.d.ts +5 -2
package/dist/components/ui/DepthButton.js +8 -3
package/dist/components/ui/Dialog.d.ts +21 -3
package/dist/components/ui/Dialog.js +17 -11
package/dist/components/ui/ExternalLink.d.ts +3 -2
package/dist/components/ui/ExternalLink.js +7 -3
package/dist/components/ui/IconButton.d.ts +10 -2
package/dist/components/ui/IconButton.js +7 -3
package/dist/components/ui/Popover.d.ts +19 -4
package/dist/components/ui/Popover.js +16 -9
package/dist/components/ui/Slider.d.ts +2 -1
package/dist/components/ui/Slider.js +5 -4
package/dist/components/ui/Switch.d.ts +2 -1
package/dist/components/ui/Switch.js +5 -4
package/dist/components/ui/Tabs.d.ts +16 -4
package/dist/components/ui/Tabs.js +46 -24
package/dist/components/ui/ThemeToggle.d.ts +2 -1
package/dist/components/ui/ThemeToggle.js +5 -3
package/dist/hooks/useControlRef.js +2 -2
package/dist/hooks/useTabRefs.d.ts +4 -0
package/dist/hooks/useTabRefs.js +12 -0
package/dist/lib/componentProps.d.ts +5 -0
package/dist/lib/componentProps.js +1 -0
package/dist/lib/composeEventHandlers.d.ts +4 -0
package/dist/lib/composeEventHandlers.js +8 -0
package/dist/lib/composeRefs.d.ts +3 -0
package/dist/lib/composeRefs.js +24 -0
package/package.json +3 -2

package/PUBLIC-API.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # Public API and maturity register
-Contract version: **0.2.1**, reviewed 12 October 2026. Export names, prop types and stylesheet APIs are unchanged from 0.2.0; Checkbox ARIA and clipboard lifecycle behavior receive compatible fixes. This register inventories the public entry declarations and actual JavaScript module exports; a catalogue specimen is not automatically a package export. Source links target the matching release tag. The catalogue URLs are discovery links, not immutable versioned documentation; its displayed example version may differ.
+Contract version: **0.3.0**, reviewed 12 October 2026. Export names and stylesheet APIs remain unchanged. Native refs and typed root/part props are added; state callbacks and default appearance remain compatible. These additions are absent from 0.2.1. See [composition contracts](COMPOSITION.md). This register inventories the public entry declarations and actual JavaScript module exports; a catalogue specimen is not automatically a package export. Source links target the matching release tag. The catalogue URLs are discovery links, not immutable versioned documentation; its displayed example version may differ.
 Maintainer: [@abuzareal](https://github.com/abuzareal). Every row has the same named owner; there is no implied support team or response-time guarantee. See [architecture, scope and compatibility](CONTRACTS.md), [contributing](CONTRIBUTING.md) and [private security reporting](SECURITY.md).
@@ -13,7 +13,7 @@ Maintainer: [@abuzareal](https://github.com/abuzareal). Every row has the same n
 ## Validation evidence key
-**D**: emitted `.d.ts` contract and TypeScript checks. **C**: core import and packed consumers, with selected component regressions. **N**: separate packed optional-peer/declaration/build fixtures. **P**: package/bootstrap and exact pinned Next fixture. **G**: selected graphics lifecycle/paused-resize browser checks. The source fixtures are [public API](https://github.com/abuzareal/contour-ui/blob/v0.2.1/tests/public-api.test.mjs), [component behavior](https://github.com/abuzareal/contour-ui/blob/v0.2.1/tests/components.test.mjs), [native dialog](https://github.com/abuzareal/contour-ui/blob/v0.2.1/tests/dialog.browser.mjs), [graphics lifecycle](https://github.com/abuzareal/contour-ui/blob/v0.2.1/tests/stage.browser.mjs), [React matrix](https://github.com/abuzareal/contour-ui/blob/v0.2.1/scripts/test-compat.mjs) and [Next](https://github.com/abuzareal/contour-ui/blob/v0.2.1/scripts/test-next.mjs).
+**D**: emitted `.d.ts` contract and TypeScript checks. **C**: core import and packed consumers, with selected component regressions. **N**: separate packed optional-peer/declaration/build fixtures. **P**: package/bootstrap and exact pinned Next fixture. **G**: selected graphics lifecycle/paused-resize browser checks. The source fixtures are [public API](https://github.com/abuzareal/contour-ui/blob/v0.3.0/tests/public-api.test.mjs), [component behavior](https://github.com/abuzareal/contour-ui/blob/v0.3.0/tests/components.test.mjs), [native dialog](https://github.com/abuzareal/contour-ui/blob/v0.3.0/tests/dialog.browser.mjs), [graphics lifecycle](https://github.com/abuzareal/contour-ui/blob/v0.3.0/tests/stage.browser.mjs), [React matrix](https://github.com/abuzareal/contour-ui/blob/v0.3.0/scripts/test-compat.mjs) and [Next](https://github.com/abuzareal/contour-ui/blob/v0.3.0/scripts/test-next.mjs).
 These identify reproducible checks, not claims that every row has a dedicated behavioral test. In particular, declaration compilation is not runtime validation, passing Chromium/axe is not manual screen-reader verification, and no blanket WCAG or framework certification is claimed. Release gates must run against the candidate archive before publication.
@@ -23,145 +23,145 @@ These identify reproducible checks, not claims that every row has a dedicated be
 ### Runtime exports
-| Export / source | Maintainer | Status | Intended use | Known limits | Documentation | Evidence |
-| --- | --- | --- | --- | --- | --- | --- |
-| [`Alert`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Alert.tsx#L37) | @abuzareal | stable (0.x) | Inline feedback or banner | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#feedback) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Avatar`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Avatar.tsx#L19) | @abuzareal | stable (0.x) | Image or initials identity | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Badge`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Badge.tsx#L16) | @abuzareal | stable (0.x) | Short status label | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`BrandMark`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/BrandMark.tsx#L12) | @abuzareal | legacy | Fixed inherited AA mark | Fixed inherited personal mark; supported for existing consumers, not a general logo system. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Breadcrumbs`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Breadcrumbs.tsx#L9) | @abuzareal | stable (0.x) | Page hierarchy navigation | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#navigation) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Button`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Button.tsx#L19) | @abuzareal | stable (0.x) | Native action button | No forwarded DOM ref on React 18; native attributes otherwise supported. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Card`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Card.tsx#L16) | @abuzareal | stable (0.x) | Content and footer container | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Checkbox`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Checkbox.tsx#L18) | @abuzareal | stable (0.x) | Native checkbox with label/error | Internal ref/generated ID; no caller ID/ref contract; 0.2.1 preserves external ARIA and composes description/error. | [Reference](https://contour.abuzr.in/docs/components/checkbox) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`CountUp`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/CountUp.tsx#L18) | @abuzareal | stable (0.x) | Animated numeric display | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DataTable`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DataTable.tsx#L24) | @abuzareal | stable (0.x) | Scalar rows with local sorting | String/number row values and local sort only; no remote sort, selection, loading controller or virtualization. | [Reference](https://contour.abuzr.in/docs#data-table) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DepthButton`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DepthButton.tsx#L8) | @abuzareal | stable (0.x) | Native action with CSS depth | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Dialog`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Dialog.tsx#L19) | @abuzareal | stable (0.x) | Native modal or edge drawer | Closed props; no native ref/root/part or initial-focus customization; app owns open/onClose. | [Reference](https://contour.abuzr.in/docs/components/dialog) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Disclosure`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Disclosure.tsx#L14) | @abuzareal | stable (0.x) | Native details/summary disclosure | Native details; defaultOpen only, no controlled open/onOpenChange; className is required. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Divider`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Divider.tsx#L6) | @abuzareal | stable (0.x) | Content separation | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DropdownMenu`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DropdownMenu.tsx#L30) | @abuzareal | experimental | Action menu with keyboard selection | Local absolute panel; no portal/collision/submenu API; shares nested-dismissal limitation. | [Reference](https://contour.abuzr.in/docs/components/dropdown-menu) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`EmptyState`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/EmptyState.tsx#L11) | @abuzareal | stable (0.x) | Empty-result content and action | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ExternalLink`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ExternalLink.tsx#L10) | @abuzareal | stable (0.x) | Styled native external anchor | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Field`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Field.tsx#L19) | @abuzareal | stable (0.x) | Label, hint and error frame | Caller wires the child ID/describedby; wrapper does not wire arbitrary children automatically. | [Reference](https://contour.abuzr.in/docs#field) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`FlipCard`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/FlipCard.tsx#L19) | @abuzareal | stable (0.x) | Button-controlled two-face card | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`IconButton`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/IconButton.tsx#L14) | @abuzareal | stable (0.x) | Native button with required accessible label | No forwarded DOM ref on React 18; caller supplies meaningful label. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Kbd`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Kbd.tsx#L4) | @abuzareal | stable (0.x) | Keyboard shortcut label | Displays a shortcut, does not register one. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Magnetic`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Magnetic.tsx#L13) | @abuzareal | stable (0.x) | Pointer-dependent decorative movement | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Marquee`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Marquee.tsx#L12) | @abuzareal | stable (0.x) | Repeated moving content strip | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Pagination`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Pagination.tsx#L25) | @abuzareal | stable (0.x) | Page-selection controls | Positive integer pages and in-range one-based page; application owns URL/fetch/slicing. | [Reference](https://contour.abuzr.in/docs#navigation) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Popover`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Popover.tsx#L20) | @abuzareal | experimental | Nonmodal panel with owned trigger | Local absolute panel; no portal/collision/custom-trigger/initial-focus API; nested Escape closes multiple layers. | [Reference](https://contour.abuzr.in/docs#floating) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ProgressBar`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ProgressBar.tsx#L12) | @abuzareal | stable (0.x) | Determinate or indeterminate progress | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs/components/progress-bar) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`RadioGroup`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/RadioGroup.tsx#L21) | @abuzareal | stable (0.x) | Native radio choices | Uses generated name; no caller field-name/form/ref contract; submit application state for stable keys. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Reveal`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Reveal.tsx#L13) | @abuzareal | stable (0.x) | Visibility-triggered content reveal | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`RevealHeading`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/RevealHeading.tsx#L15) | @abuzareal | legacy | Editorial heading-line composition | Editorial h2 composition; application must preserve heading order. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ScrollProgress`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ScrollProgress.tsx#L6) | @abuzareal | stable (0.x) | Document scroll readout | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SectionLabel`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SectionLabel.tsx#L11) | @abuzareal | legacy | Editorial section metadata | Depends on Section editorial metadata/aside contract; not a general label primitive. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SegmentedControl`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SegmentedControl.tsx#L14) | @abuzareal | stable (0.x) | Controlled single-choice buttons | No native named field or disabled-option API; application owns value and submission. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SelectField`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SelectField.tsx#L17) | @abuzareal | stable (0.x) | Labelled native select | Native forwarded select ref; native choices, not searchable Combobox. | [Reference](https://contour.abuzr.in/docs/components/select-field) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Skeleton`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Skeleton.tsx#L11) | @abuzareal | stable (0.x) | Loading placeholder | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#feedback) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Slider`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Slider.tsx#L18) | @abuzareal | stable (0.x) | Controlled native range input | No name/form/ref contract; submit application state; keep numeric values within meaningful bounds. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`GitHubIcon`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SocialIcons.tsx#L5) | @abuzareal | stable (0.x) | GitHub SVG mark | SVG only; caller owns link destination and accessible name. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`LinkedInIcon`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SocialIcons.tsx#L16) | @abuzareal | stable (0.x) | LinkedIn SVG mark | SVG only; caller owns link destination and accessible name. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Spinner`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Spinner.tsx#L13) | @abuzareal | stable (0.x) | Loading status indicator | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#feedback) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Stat`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Stat.tsx#L10) | @abuzareal | stable (0.x) | Supplied value and label display | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Stepper`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Stepper.tsx#L13) | @abuzareal | stable (0.x) | Step-progress display | Progress display, not a navigable wizard; application owns state and validation. | [Reference](https://contour.abuzr.in/docs#navigation) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Switch`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Switch.tsx#L14) | @abuzareal | stable (0.x) | Controlled on/off button | State callback only; no name/form/ref/uncontrolled reset contract; submit application state. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Tabs`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Tabs.tsx#L29) | @abuzareal | stable (0.x) | Controlled or default tab selection | Closed props; selected ID controlled or default; no general slot/disabled-tab/orientation API. | [Reference](https://contour.abuzr.in/docs/components/tabs) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Tag`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Tag.tsx#L11) | @abuzareal | stable (0.x) | Short label with optional removal | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TextArea`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/TextArea.tsx#L24) | @abuzareal | stable (0.x) | Native textarea, counter and resize | Native forwarded textarea ref; parent owns controlled reset; sizing is browser dependent. | [Reference](https://contour.abuzr.in/docs/components/text-area) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TextField`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/TextField.tsx#L26) | @abuzareal | stable (0.x) | Native input with label/counter | Native forwarded input ref; parent owns controlled values/reset; do not switch state ownership. | [Reference](https://contour.abuzr.in/docs/components/text-field) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ThemeToggle`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ThemeToggle.tsx#L12) | @abuzareal | stable (0.x) | Document-theme control | Root data-theme and aa-theme origin storage; no independently scoped theme provider. | [Reference](https://contour.abuzr.in/docs#theme-copy) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TiltCard`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/TiltCard.tsx#L13) | @abuzareal | stable (0.x) | Pointer-dependent CSS depth | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Timeline`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Timeline.tsx#L8) | @abuzareal | stable (0.x) | Ordered entries supplied by caller | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ToastProvider`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ToastProvider.tsx#L67) | @abuzareal | stable (0.x) | Toast context, queue and announcements | No application persistence; important failures need a durable visible record as well. | [Reference](https://contour.abuzr.in/docs/components/toast-provider) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Tooltip`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Tooltip.tsx#L14) | @abuzareal | experimental | Supplemental text hint | Pointer leave closes it and CSS prevents content hover; supplemental noninteractive text only; no collision engine. | [Reference](https://contour.abuzr.in/docs#floating) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useClipboardCopy`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useClipboardCopy.ts#L10) | @abuzareal | stable (0.x) | Clipboard operation and feedback state | Clipboard access can fail; obsolete text/request/unmount completions are discarded in 0.2.1; app presents truthful feedback. | [Reference](https://contour.abuzr.in/docs#theme-copy) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useDismiss`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useDismiss.ts#L6) | @abuzareal | experimental | Document Escape/outside-press subscription | Independent global document listeners; no layer stack/portal/owner-document model; caller manages focus. | [Reference](https://contour.abuzr.in/docs#browser-hooks) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useHeaderScroll`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useHeaderScroll.ts#L9) | @abuzareal | legacy | Editorial header/section state | Assumes main section[id] and header-theme regions; application owns page structure. | [Reference](https://contour.abuzr.in/docs#browser-hooks) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useIdleTrigger`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useIdleTrigger.ts#L9) | @abuzareal | stable (0.x) | Idle-time activation | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#browser-hooks) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useInitialHashScroll`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useInitialHashScroll.ts#L8) | @abuzareal | legacy | Initial document-hash scrolling | Initial hash only; application owns routing and unknown targets. | [Reference](https://contour.abuzr.in/docs#browser-hooks) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useMobileMenu`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useMobileMenu.ts#L8) | @abuzareal | experimental | Menu open/close and resize state | Caller provides semantics/focus; closes on Escape/outside press and desktop resize. | [Reference](https://contour.abuzr.in/docs#browser-hooks) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useMotionPreference`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useMotionPreference.ts#L8) | @abuzareal | stable (0.x) | System reduced-motion subscription | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#theme-copy) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`usePrintPreparation`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/usePrintPreparation.ts#L6) | @abuzareal | legacy | Temporary print theme/disclosure changes | Mutates root theme/details during printing; application must verify print layout. | [Reference](https://contour.abuzr.in/docs#browser-hooks) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useScrollSpy`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useScrollSpy.ts#L9) | @abuzareal | stable (0.x) | Active section observation | Stable section IDs and existing DOM anchors required; does not provide routing. | [Reference](https://contour.abuzr.in/docs#browser-hooks) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useTheme`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useTheme.ts#L84) | @abuzareal | stable (0.x) | Shared document-theme preference | Root data-theme and aa-theme origin storage; client lifecycle; embedding needs one theme owner. | [Reference](https://contour.abuzr.in/docs#theme-copy) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`useToast`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useToast.ts#L19) | @abuzareal | stable (0.x) | Toast commands from provider | Must be called under ToastProvider; ephemeral feedback is not an operation result. | [Reference](https://contour.abuzr.in/docs#toasts) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SceneBoundary`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/hero/SceneBoundary.tsx#L9) | @abuzareal | experimental | Hide failed scene subtree | Renders null after failure; no fallback prop/reset API; keep usable static content outside it. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`safeHref`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/safeHref.ts#L2) | @abuzareal | stable (0.x) | Reject executable URL schemes | Scheme validation only, not URL trust/authorization validation. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`cx`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/classNames.ts#L2) | @abuzareal | stable (0.x) | Join optional CSS class names | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`buttonClassName`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/classNames.ts#L10) | @abuzareal | stable (0.x) | Shared button-class recipe for buttons/anchors | Returns existing global classes; styled anchor retains native link responsibilities. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`formatIndex`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/format.ts#L4) | @abuzareal | stable (0.x) | Two-digit index formatting | Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`readStorage`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/storage.ts#L14) | @abuzareal | legacy | Read local/session string safely | Returns raw string/null; caller parses and validates; no persistence guarantee. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`writeStorage`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/storage.ts#L23) | @abuzareal | legacy | Attempt local/session string persistence | Returns success boolean; browser policy can block persistence. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`storageKeys`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/storage.ts#L3) | @abuzareal | legacy | Inherited shared storage key names | Legacy aa-* keys are public compatibility constraints; no silent rename. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`nextIndexForKey`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/keyboard.ts#L14) | @abuzareal | stable (0.x) | Keyboard navigation index calculation | Calculates index, does not move focus or perform selection. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`fieldDescribedBy`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/a11y.ts#L4) | @abuzareal | stable (0.x) | Field hint/error ID calculation | Error description takes precedence over hint; caller connects the target input. | [Reference](https://contour.abuzr.in/docs#field) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`motionDisabledFor`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/motion.ts#L4) | @abuzareal | stable (0.x) | System and ancestor motion check | Browser/ancestor check; app still owns animation cancellation. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| Export / source                                                                                                      | Maintainer | Status       | Intended use                                   | Known limits                                                                                                                               | Documentation                                                        | Evidence                                                                             |
+| -------------------------------------------------------------------------------------------------------------------- | ---------- | ------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| [`Alert`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Alert.tsx#L37)                       | @abuzareal | stable (0.x) | Inline feedback or banner                      | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#feedback)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Avatar`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Avatar.tsx#L19)                     | @abuzareal | stable (0.x) | Image or initials identity                     | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Badge`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Badge.tsx#L16)                       | @abuzareal | stable (0.x) | Short status label                             | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`BrandMark`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/BrandMark.tsx#L12)               | @abuzareal | legacy       | Fixed inherited AA mark                        | Fixed inherited personal mark; supported for existing consumers, not a general logo system.                                                | [Reference](https://contour.abuzr.in/docs#identity)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Breadcrumbs`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Breadcrumbs.tsx#L9)            | @abuzareal | stable (0.x) | Page hierarchy navigation                      | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#navigation)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Button`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Button.tsx#L21)                     | @abuzareal | stable (0.x) | Native action button                           | Forwarded native button ref on React 18/19; loading disables activation; native attributes preserved.                                      | [Reference](https://contour.abuzr.in/docs#buttons)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Card`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Card.tsx#L16)                         | @abuzareal | stable (0.x) | Content and footer container                   | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Checkbox`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Checkbox.tsx#L19)                 | @abuzareal | stable (0.x) | Native checkbox with label/error               | Forwarded native input ref coexists with indeterminate handling; generated ID remains; caller ARIA descriptions/validity preserved.        | [Reference](https://contour.abuzr.in/docs/components/checkbox)       | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`CountUp`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/CountUp.tsx#L18)                   | @abuzareal | stable (0.x) | Animated numeric display                       | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DataTable`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DataTable.tsx#L24)               | @abuzareal | stable (0.x) | Scalar rows with local sorting                 | String/number row values and local sort only; no remote sort, selection, loading controller or virtualization.                             | [Reference](https://contour.abuzr.in/docs#data-table)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DepthButton`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DepthButton.tsx#L11)           | @abuzareal | stable (0.x) | Native action with CSS depth                   | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#buttons)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Dialog`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Dialog.tsx#L29)                     | @abuzareal | stable (0.x) | Native modal or edge drawer                    | Native dialog ref and root/panel/body/footer/close-button props; app owns open/onClose; no initial-focus override.                         | [Reference](https://contour.abuzr.in/docs/components/dialog)         | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Disclosure`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Disclosure.tsx#L14)             | @abuzareal | stable (0.x) | Native details/summary disclosure              | Native details; defaultOpen only, no controlled open/onOpenChange; className is required.                                                  | [Reference](https://contour.abuzr.in/docs#content)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Divider`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Divider.tsx#L6)                    | @abuzareal | stable (0.x) | Content separation                             | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DropdownMenu`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DropdownMenu.tsx#L30)         | @abuzareal | experimental | Action menu with keyboard selection            | Local absolute panel; no portal/collision/submenu API; shares nested-dismissal limitation.                                                 | [Reference](https://contour.abuzr.in/docs/components/dropdown-menu)  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`EmptyState`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/EmptyState.tsx#L11)             | @abuzareal | stable (0.x) | Empty-result content and action                | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ExternalLink`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ExternalLink.tsx#L12)         | @abuzareal | stable (0.x) | Styled native external anchor                  | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#buttons)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Field`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Field.tsx#L19)                       | @abuzareal | stable (0.x) | Label, hint and error frame                    | Caller wires the child ID/describedby; wrapper does not wire arbitrary children automatically.                                             | [Reference](https://contour.abuzr.in/docs#field)                     | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`FlipCard`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/FlipCard.tsx#L19)                 | @abuzareal | stable (0.x) | Button-controlled two-face card                | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`IconButton`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/IconButton.tsx#L16)             | @abuzareal | stable (0.x) | Native button with required accessible label   | Forwarded native button ref on React 18/19; caller supplies a meaningful accessible label.                                                 | [Reference](https://contour.abuzr.in/docs#buttons)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Kbd`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Kbd.tsx#L4)                            | @abuzareal | stable (0.x) | Keyboard shortcut label                        | Displays a shortcut, does not register one.                                                                                                | [Reference](https://contour.abuzr.in/docs#metadata)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Magnetic`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Magnetic.tsx#L13)                 | @abuzareal | stable (0.x) | Pointer-dependent decorative movement          | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Marquee`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Marquee.tsx#L12)                   | @abuzareal | stable (0.x) | Repeated moving content strip                  | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Pagination`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Pagination.tsx#L25)             | @abuzareal | stable (0.x) | Page-selection controls                        | Positive integer pages and in-range one-based page; application owns URL/fetch/slicing.                                                    | [Reference](https://contour.abuzr.in/docs#navigation)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Popover`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Popover.tsx#L25)                   | @abuzareal | experimental | Nonmodal panel with owned trigger              | Root/owned trigger/panel props and refs supported; no portal/collision/custom-trigger/initial-focus API; nested Escape limitation remains. | [Reference](https://contour.abuzr.in/docs#floating)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ProgressBar`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ProgressBar.tsx#L12)           | @abuzareal | stable (0.x) | Determinate or indeterminate progress          | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs/components/progress-bar)   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`RadioGroup`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/RadioGroup.tsx#L21)             | @abuzareal | stable (0.x) | Native radio choices                           | Uses generated name; no caller field-name/form/ref contract; submit application state for stable keys.                                     | [Reference](https://contour.abuzr.in/docs#choices)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Reveal`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Reveal.tsx#L13)                     | @abuzareal | stable (0.x) | Visibility-triggered content reveal            | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`RevealHeading`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/RevealHeading.tsx#L15)       | @abuzareal | legacy       | Editorial heading-line composition             | Editorial h2 composition; application must preserve heading order.                                                                         | [Reference](https://contour.abuzr.in/docs#identity)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ScrollProgress`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ScrollProgress.tsx#L6)      | @abuzareal | stable (0.x) | Document scroll readout                        | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SectionLabel`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SectionLabel.tsx#L11)         | @abuzareal | legacy       | Editorial section metadata                     | Depends on Section editorial metadata/aside contract; not a general label primitive.                                                       | [Reference](https://contour.abuzr.in/docs#identity)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SegmentedControl`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SegmentedControl.tsx#L14) | @abuzareal | stable (0.x) | Controlled single-choice buttons               | No native named field or disabled-option API; application owns value and submission.                                                       | [Reference](https://contour.abuzr.in/docs#choices)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SelectField`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SelectField.tsx#L17)           | @abuzareal | stable (0.x) | Labelled native select                         | Native forwarded select ref; native choices, not searchable Combobox.                                                                      | [Reference](https://contour.abuzr.in/docs/components/select-field)   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Skeleton`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Skeleton.tsx#L11)                 | @abuzareal | stable (0.x) | Loading placeholder                            | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#feedback)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Slider`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Slider.tsx#L18)                     | @abuzareal | stable (0.x) | Controlled native range input                  | Forwarded native range-input ref; no name/form/reset API; submit application state and keep values within meaningful bounds.               | [Reference](https://contour.abuzr.in/docs#choices)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`GitHubIcon`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SocialIcons.tsx#L5)             | @abuzareal | stable (0.x) | GitHub SVG mark                                | SVG only; caller owns link destination and accessible name.                                                                                | [Reference](https://contour.abuzr.in/docs#identity)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`LinkedInIcon`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SocialIcons.tsx#L16)          | @abuzareal | stable (0.x) | LinkedIn SVG mark                              | SVG only; caller owns link destination and accessible name.                                                                                | [Reference](https://contour.abuzr.in/docs#identity)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Spinner`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Spinner.tsx#L13)                   | @abuzareal | stable (0.x) | Loading status indicator                       | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#feedback)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Stat`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Stat.tsx#L10)                         | @abuzareal | stable (0.x) | Supplied value and label display               | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Stepper`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Stepper.tsx#L13)                   | @abuzareal | stable (0.x) | Step-progress display                          | Progress display, not a navigable wizard; application owns state and validation.                                                           | [Reference](https://contour.abuzr.in/docs#navigation)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Switch`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Switch.tsx#L14)                     | @abuzareal | stable (0.x) | Controlled on/off button                       | Forwarded native switch-button ref; boolean value callback; no name/form/uncontrolled reset API.                                           | [Reference](https://contour.abuzr.in/docs#choices)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Tabs`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Tabs.tsx#L35)                         | @abuzareal | stable (0.x) | Controlled or default tab selection            | Root/list/tab/panel props and refs; controlled/default selected ID; no disabled-tab/orientation/component-replacement API.                 | [Reference](https://contour.abuzr.in/docs/components/tabs)           | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Tag`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Tag.tsx#L11)                           | @abuzareal | stable (0.x) | Short label with optional removal              | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TextArea`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/TextArea.tsx#L24)                 | @abuzareal | stable (0.x) | Native textarea, counter and resize            | Native forwarded textarea ref; parent owns controlled reset; sizing is browser dependent.                                                  | [Reference](https://contour.abuzr.in/docs/components/text-area)      | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TextField`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/TextField.tsx#L26)               | @abuzareal | stable (0.x) | Native input with label/counter                | Native forwarded input ref; parent owns controlled values/reset; do not switch state ownership.                                            | [Reference](https://contour.abuzr.in/docs/components/text-field)     | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ThemeToggle`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ThemeToggle.tsx#L13)           | @abuzareal | stable (0.x) | Document-theme control                         | Native button ref; root data-theme and aa-theme storage; no scoped theme provider.                                                         | [Reference](https://contour.abuzr.in/docs#theme-copy)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TiltCard`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/TiltCard.tsx#L13)                 | @abuzareal | stable (0.x) | Pointer-dependent CSS depth                    | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Timeline`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Timeline.tsx#L8)                  | @abuzareal | stable (0.x) | Ordered entries supplied by caller             | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ToastProvider`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ToastProvider.tsx#L67)       | @abuzareal | stable (0.x) | Toast context, queue and announcements         | No application persistence; important failures need a durable visible record as well.                                                      | [Reference](https://contour.abuzr.in/docs/components/toast-provider) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Tooltip`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Tooltip.tsx#L14)                   | @abuzareal | experimental | Supplemental text hint                         | Pointer leave closes it and CSS prevents content hover; supplemental noninteractive text only; no collision engine.                        | [Reference](https://contour.abuzr.in/docs#floating)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useClipboardCopy`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useClipboardCopy.ts#L10)          | @abuzareal | stable (0.x) | Clipboard operation and feedback state         | Clipboard access can fail; obsolete text/request/unmount completions are discarded in 0.2.1; app presents truthful feedback.               | [Reference](https://contour.abuzr.in/docs#theme-copy)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useDismiss`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useDismiss.ts#L6)                       | @abuzareal | experimental | Document Escape/outside-press subscription     | Independent global document listeners; no layer stack/portal/owner-document model; caller manages focus.                                   | [Reference](https://contour.abuzr.in/docs#browser-hooks)             | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useHeaderScroll`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useHeaderScroll.ts#L9)             | @abuzareal | legacy       | Editorial header/section state                 | Assumes main section[id] and header-theme regions; application owns page structure.                                                        | [Reference](https://contour.abuzr.in/docs#browser-hooks)             | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useIdleTrigger`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useIdleTrigger.ts#L9)               | @abuzareal | stable (0.x) | Idle-time activation                           | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#browser-hooks)             | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useInitialHashScroll`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useInitialHashScroll.ts#L8)   | @abuzareal | legacy       | Initial document-hash scrolling                | Initial hash only; application owns routing and unknown targets.                                                                           | [Reference](https://contour.abuzr.in/docs#browser-hooks)             | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useMobileMenu`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useMobileMenu.ts#L8)                 | @abuzareal | experimental | Menu open/close and resize state               | Caller provides semantics/focus; closes on Escape/outside press and desktop resize.                                                        | [Reference](https://contour.abuzr.in/docs#browser-hooks)             | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useMotionPreference`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useMotionPreference.ts#L8)     | @abuzareal | stable (0.x) | System reduced-motion subscription             | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#theme-copy)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`usePrintPreparation`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/usePrintPreparation.ts#L6)     | @abuzareal | legacy       | Temporary print theme/disclosure changes       | Mutates root theme/details during printing; application must verify print layout.                                                          | [Reference](https://contour.abuzr.in/docs#browser-hooks)             | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useScrollSpy`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useScrollSpy.ts#L9)                   | @abuzareal | stable (0.x) | Active section observation                     | Stable section IDs and existing DOM anchors required; does not provide routing.                                                            | [Reference](https://contour.abuzr.in/docs#browser-hooks)             | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useTheme`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useTheme.ts#L84)                          | @abuzareal | stable (0.x) | Shared document-theme preference               | Root data-theme and aa-theme origin storage; client lifecycle; embedding needs one theme owner.                                            | [Reference](https://contour.abuzr.in/docs#theme-copy)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`useToast`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useToast.ts#L19)                          | @abuzareal | stable (0.x) | Toast commands from provider                   | Must be called under ToastProvider; ephemeral feedback is not an operation result.                                                         | [Reference](https://contour.abuzr.in/docs#toasts)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SceneBoundary`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/hero/SceneBoundary.tsx#L9)      | @abuzareal | experimental | Hide failed scene subtree                      | Renders null after failure; no fallback prop/reset API; keep usable static content outside it.                                             | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`safeHref`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/safeHref.ts#L2)                             | @abuzareal | stable (0.x) | Reject executable URL schemes                  | Scheme validation only, not URL trust/authorization validation.                                                                            | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`cx`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/classNames.ts#L2)                                 | @abuzareal | stable (0.x) | Join optional CSS class names                  | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`buttonClassName`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/classNames.ts#L10)                   | @abuzareal | stable (0.x) | Shared button-class recipe for buttons/anchors | Returns existing global classes; styled anchor retains native link responsibilities.                                                       | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`formatIndex`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/format.ts#L4)                            | @abuzareal | stable (0.x) | Two-digit index formatting                     | Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`readStorage`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/storage.ts#L14)                          | @abuzareal | legacy       | Read local/session string safely               | Returns raw string/null; caller parses and validates; no persistence guarantee.                                                            | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`writeStorage`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/storage.ts#L23)                         | @abuzareal | legacy       | Attempt local/session string persistence       | Returns success boolean; browser policy can block persistence.                                                                             | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`storageKeys`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/storage.ts#L3)                           | @abuzareal | legacy       | Inherited shared storage key names             | Legacy aa-* keys are public compatibility constraints; no silent rename.                                                                   | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`nextIndexForKey`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/keyboard.ts#L14)                     | @abuzareal | stable (0.x) | Keyboard navigation index calculation          | Calculates index, does not move focus or perform selection.                                                                                | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`fieldDescribedBy`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/a11y.ts#L4)                         | @abuzareal | stable (0.x) | Field hint/error ID calculation                | Error description takes precedence over hint; caller connects the target input.                                                            | [Reference](https://contour.abuzr.in/docs#field)                     | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`motionDisabledFor`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/motion.ts#L4)                      | @abuzareal | stable (0.x) | System and ancestor motion check               | Browser/ancestor check; app still owns animation cancellation.                                                                             | [Reference](https://contour.abuzr.in/docs#utilities)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
 ### Type-only exports
-| Export / source | Maintainer | Status | Intended use | Known limits | Documentation | Evidence |
-| --- | --- | --- | --- | --- | --- | --- |
-| [`Section`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/types.ts#L1) | @abuzareal | stable (0.x) | Type contract for Section | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`AlertTone`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Alert.tsx#L15) | @abuzareal | stable (0.x) | Type contract for Alert | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#feedback) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`AlertProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Alert.tsx#L27) | @abuzareal | stable (0.x) | Type contract for Alert | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#feedback) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`AvatarProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Avatar.tsx#L4) | @abuzareal | stable (0.x) | Type contract for Avatar | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`BadgeTone`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Badge.tsx#L5) | @abuzareal | stable (0.x) | Type contract for Badge | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`BadgeProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Badge.tsx#L8) | @abuzareal | stable (0.x) | Type contract for Badge | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`BrandMarkProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/BrandMark.tsx#L6) | @abuzareal | legacy | Type contract for BrandMark | Type-only; no runtime value. Fixed inherited personal mark; supported for existing consumers, not a general logo system. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`BreadcrumbsProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Breadcrumbs.tsx#L5) | @abuzareal | stable (0.x) | Type contract for Breadcrumbs | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#navigation) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ButtonProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Button.tsx#L10) | @abuzareal | stable (0.x) | Type contract for Button | Type-only; no runtime value. No forwarded DOM ref on React 18; native attributes otherwise supported. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`CardProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Card.tsx#L5) | @abuzareal | stable (0.x) | Type contract for Card | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`CheckboxProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Checkbox.tsx#L8) | @abuzareal | stable (0.x) | Type contract for Checkbox | Type-only; no runtime value. Internal ref/generated ID; no caller ID/ref contract; 0.2.1 preserves external ARIA and composes description/error. | [Reference](https://contour.abuzr.in/docs/components/checkbox) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`CountUpProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/CountUp.tsx#L7) | @abuzareal | stable (0.x) | Type contract for CountUp | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TableColumn`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DataTable.tsx#L7) | @abuzareal | stable (0.x) | Type contract for DataTable | Type-only; no runtime value. String/number row values and local sort only; no remote sort, selection, loading controller or virtualization. | [Reference](https://contour.abuzr.in/docs#data-table) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DataTableProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DataTable.tsx#L15) | @abuzareal | stable (0.x) | Type contract for DataTable | Type-only; no runtime value. String/number row values and local sort only; no remote sort, selection, loading controller or virtualization. | [Reference](https://contour.abuzr.in/docs#data-table) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DepthButtonProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DepthButton.tsx#L4) | @abuzareal | stable (0.x) | Type contract for DepthButton | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DialogProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Dialog.tsx#L9) | @abuzareal | stable (0.x) | Type contract for Dialog | Type-only; no runtime value. Closed props; no native ref/root/part or initial-focus customization; app owns open/onClose. | [Reference](https://contour.abuzr.in/docs/components/dialog) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DisclosureProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Disclosure.tsx#L5) | @abuzareal | stable (0.x) | Type contract for Disclosure | Type-only; no runtime value. Native details; defaultOpen only, no controlled open/onOpenChange; className is required. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DividerProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Divider.tsx#L2) | @abuzareal | stable (0.x) | Type contract for Divider | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`MenuItem`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DropdownMenu.tsx#L11) | @abuzareal | experimental | Type contract for DropdownMenu | Type-only; no runtime value. Local absolute panel; no portal/collision/submenu API; shares nested-dismissal limitation. | [Reference](https://contour.abuzr.in/docs/components/dropdown-menu) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`DropdownMenuProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/DropdownMenu.tsx#L21) | @abuzareal | experimental | Type contract for DropdownMenu | Type-only; no runtime value. Local absolute panel; no portal/collision/submenu API; shares nested-dismissal limitation. | [Reference](https://contour.abuzr.in/docs/components/dropdown-menu) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`EmptyStateProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/EmptyState.tsx#L4) | @abuzareal | stable (0.x) | Type contract for EmptyState | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ExternalLinkProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ExternalLink.tsx#L5) | @abuzareal | stable (0.x) | Type contract for ExternalLink | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`FieldProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Field.tsx#L6) | @abuzareal | stable (0.x) | Type contract for Field | Type-only; no runtime value. Caller wires the child ID/describedby; wrapper does not wire arbitrary children automatically. | [Reference](https://contour.abuzr.in/docs#field) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`FlipCardProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/FlipCard.tsx#L8) | @abuzareal | stable (0.x) | Type contract for FlipCard | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`IconButtonProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/IconButton.tsx#L5) | @abuzareal | stable (0.x) | Type contract for IconButton | Type-only; no runtime value. No forwarded DOM ref on React 18; caller supplies meaningful label. | [Reference](https://contour.abuzr.in/docs#buttons) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`MagneticProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Magnetic.tsx#L7) | @abuzareal | stable (0.x) | Type contract for Magnetic | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`MarqueeProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Marquee.tsx#L5) | @abuzareal | stable (0.x) | Type contract for Marquee | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`PaginationProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Pagination.tsx#L7) | @abuzareal | stable (0.x) | Type contract for Pagination | Type-only; no runtime value. Positive integer pages and in-range one-based page; application owns URL/fetch/slicing. | [Reference](https://contour.abuzr.in/docs#navigation) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`PopoverProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Popover.tsx#L9) | @abuzareal | experimental | Type contract for Popover | Type-only; no runtime value. Local absolute panel; no portal/collision/custom-trigger/initial-focus API; nested Escape closes multiple layers. | [Reference](https://contour.abuzr.in/docs#floating) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ProgressBarProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ProgressBar.tsx#L5) | @abuzareal | stable (0.x) | Type contract for ProgressBar | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs/components/progress-bar) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`RadioGroupProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/RadioGroup.tsx#L7) | @abuzareal | stable (0.x) | Type contract for RadioGroup | Type-only; no runtime value. Uses generated name; no caller field-name/form/ref contract; submit application state for stable keys. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`RevealProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Reveal.tsx#L6) | @abuzareal | stable (0.x) | Type contract for Reveal | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`HeadingLine`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/RevealHeading.tsx#L4) | @abuzareal | legacy | Type contract for RevealHeading | Type-only; no runtime value. Editorial h2 composition; application must preserve heading order. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`RevealHeadingProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/RevealHeading.tsx#L10) | @abuzareal | legacy | Type contract for RevealHeading | Type-only; no runtime value. Editorial h2 composition; application must preserve heading order. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SectionLabelProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SectionLabel.tsx#L5) | @abuzareal | legacy | Type contract for SectionLabel | Type-only; no runtime value. Depends on Section editorial metadata/aside contract; not a general label primitive. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SegmentedControlProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SegmentedControl.tsx#L7) | @abuzareal | stable (0.x) | Type contract for SegmentedControl | Type-only; no runtime value. No native named field or disabled-option API; application owns value and submission. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SelectFieldProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SelectField.tsx#L9) | @abuzareal | stable (0.x) | Type contract for SelectField | Type-only; no runtime value. Native forwarded select ref; native choices, not searchable Combobox. | [Reference](https://contour.abuzr.in/docs/components/select-field) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SkeletonProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Skeleton.tsx#L5) | @abuzareal | stable (0.x) | Type contract for Skeleton | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#feedback) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SliderProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Slider.tsx#L6) | @abuzareal | stable (0.x) | Type contract for Slider | Type-only; no runtime value. No name/form/ref contract; submit application state; keep numeric values within meaningful bounds. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SocialIconProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/SocialIcons.tsx#L3) | @abuzareal | stable (0.x) | Type contract for LinkedInIcon | Type-only; no runtime value. SVG only; caller owns link destination and accessible name. | [Reference](https://contour.abuzr.in/docs#identity) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SpinnerProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Spinner.tsx#L5) | @abuzareal | stable (0.x) | Type contract for Spinner | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#feedback) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`StatProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Stat.tsx#L4) | @abuzareal | stable (0.x) | Type contract for Stat | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`StepperProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Stepper.tsx#L6) | @abuzareal | stable (0.x) | Type contract for Stepper | Type-only; no runtime value. Progress display, not a navigable wizard; application owns state and validation. | [Reference](https://contour.abuzr.in/docs#navigation) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`SwitchProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Switch.tsx#L6) | @abuzareal | stable (0.x) | Type contract for Switch | Type-only; no runtime value. State callback only; no name/form/ref/uncontrolled reset contract; submit application state. | [Reference](https://contour.abuzr.in/docs#choices) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TabItem`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Tabs.tsx#L14) | @abuzareal | stable (0.x) | Type contract for Tabs | Type-only; no runtime value. Closed props; selected ID controlled or default; no general slot/disabled-tab/orientation API. | [Reference](https://contour.abuzr.in/docs/components/tabs) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TabsProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Tabs.tsx#L20) | @abuzareal | stable (0.x) | Type contract for Tabs | Type-only; no runtime value. Closed props; selected ID controlled or default; no general slot/disabled-tab/orientation API. | [Reference](https://contour.abuzr.in/docs/components/tabs) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TagProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Tag.tsx#L6) | @abuzareal | stable (0.x) | Type contract for Tag | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#metadata) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TextAreaProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/TextArea.tsx#L16) | @abuzareal | stable (0.x) | Type contract for TextArea | Type-only; no runtime value. Native forwarded textarea ref; parent owns controlled reset; sizing is browser dependent. | [Reference](https://contour.abuzr.in/docs/components/text-area) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TextFieldProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/TextField.tsx#L16) | @abuzareal | stable (0.x) | Type contract for TextField | Type-only; no runtime value. Native forwarded input ref; parent owns controlled values/reset; do not switch state ownership. | [Reference](https://contour.abuzr.in/docs/components/text-field) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ThemeToggleProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/ThemeToggle.tsx#L7) | @abuzareal | stable (0.x) | Type contract for ThemeToggle | Type-only; no runtime value. Root data-theme and aa-theme origin storage; no independently scoped theme provider. | [Reference](https://contour.abuzr.in/docs#theme-copy) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TiltCardProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/TiltCard.tsx#L7) | @abuzareal | stable (0.x) | Type contract for TiltCard | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#motion) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TimelineProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Timeline.tsx#L4) | @abuzareal | stable (0.x) | Type contract for Timeline | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#content) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`TooltipProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/ui/Tooltip.tsx#L7) | @abuzareal | experimental | Type contract for Tooltip | Type-only; no runtime value. Pointer leave closes it and CSS prevents content hover; supplemental noninteractive text only; no collision engine. | [Reference](https://contour.abuzr.in/docs#floating) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`CopyStatus`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useClipboardCopy.ts#L6) | @abuzareal | stable (0.x) | Type contract for useClipboardCopy | Type-only; no runtime value. Clipboard access can fail; obsolete text/request/unmount completions are discarded in 0.2.1; app presents truthful feedback. | [Reference](https://contour.abuzr.in/docs#theme-copy) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`Theme`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useTheme.ts#L9) | @abuzareal | stable (0.x) | Type contract for useTheme | Type-only; no runtime value. Root data-theme and aa-theme origin storage; client lifecycle; embedding needs one theme owner. | [Reference](https://contour.abuzr.in/docs#theme-copy) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ToastInput`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useToast.ts#L7) | @abuzareal | stable (0.x) | Type contract for useToast | Type-only; no runtime value. Must be called under ToastProvider; ephemeral feedback is not an operation result. | [Reference](https://contour.abuzr.in/docs#toasts) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ToastContextValue`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useToast.ts#L13) | @abuzareal | stable (0.x) | Type contract for useToast | Type-only; no runtime value. Must be called under ToastProvider; ephemeral feedback is not an operation result. | [Reference](https://contour.abuzr.in/docs#toasts) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ToastContext`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useToast.ts#L17) | @abuzareal | stable (0.x) | Type contract for useToast | Type-only; no runtime value. Must be called under ToastProvider; ephemeral feedback is not an operation result. | [Reference](https://contour.abuzr.in/docs#toasts) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ButtonVariant`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/classNames.ts#L5) | @abuzareal | stable (0.x) | Type contract for buttonClassName | Type-only; no runtime value. Returns existing global classes; styled anchor retains native link responsibilities. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
-| [`ButtonSize`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/classNames.ts#L7) | @abuzareal | stable (0.x) | Type contract for buttonClassName | Type-only; no runtime value. Returns existing global classes; styled anchor retains native link responsibilities. | [Reference](https://contour.abuzr.in/docs#utilities) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| Export / source                                                                                                          | Maintainer | Status       | Intended use                       | Known limits                                                                                                                                                            | Documentation                                                       | Evidence                                                                             |
+| ------------------------------------------------------------------------------------------------------------------------ | ---------- | ------------ | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| [`Section`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/types.ts#L1)                                         | @abuzareal | stable (0.x) | Type contract for Section          | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#utilities)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`AlertTone`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Alert.tsx#L15)                       | @abuzareal | stable (0.x) | Type contract for Alert            | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#feedback)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`AlertProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Alert.tsx#L27)                      | @abuzareal | stable (0.x) | Type contract for Alert            | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#feedback)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`AvatarProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Avatar.tsx#L4)                     | @abuzareal | stable (0.x) | Type contract for Avatar           | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`BadgeTone`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Badge.tsx#L5)                        | @abuzareal | stable (0.x) | Type contract for Badge            | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`BadgeProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Badge.tsx#L8)                       | @abuzareal | stable (0.x) | Type contract for Badge            | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`BrandMarkProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/BrandMark.tsx#L6)               | @abuzareal | legacy       | Type contract for BrandMark        | Type-only; no runtime value. Fixed inherited personal mark; supported for existing consumers, not a general logo system.                                                | [Reference](https://contour.abuzr.in/docs#identity)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`BreadcrumbsProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Breadcrumbs.tsx#L5)           | @abuzareal | stable (0.x) | Type contract for Breadcrumbs      | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#navigation)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ButtonProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Button.tsx#L12)                    | @abuzareal | stable (0.x) | Type contract for Button           | Type-only; no runtime value. Forwarded native button ref on React 18/19; loading disables activation; native attributes preserved.                                      | [Reference](https://contour.abuzr.in/docs#buttons)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`CardProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Card.tsx#L5)                         | @abuzareal | stable (0.x) | Type contract for Card             | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`CheckboxProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Checkbox.tsx#L9)                 | @abuzareal | stable (0.x) | Type contract for Checkbox         | Type-only; no runtime value. Forwarded native input ref coexists with indeterminate handling; generated ID remains; caller ARIA descriptions/validity preserved.        | [Reference](https://contour.abuzr.in/docs/components/checkbox)      | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`CountUpProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/CountUp.tsx#L7)                   | @abuzareal | stable (0.x) | Type contract for CountUp          | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TableColumn`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DataTable.tsx#L7)                  | @abuzareal | stable (0.x) | Type contract for DataTable        | Type-only; no runtime value. String/number row values and local sort only; no remote sort, selection, loading controller or virtualization.                             | [Reference](https://contour.abuzr.in/docs#data-table)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DataTableProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DataTable.tsx#L15)              | @abuzareal | stable (0.x) | Type contract for DataTable        | Type-only; no runtime value. String/number row values and local sort only; no remote sort, selection, loading controller or virtualization.                             | [Reference](https://contour.abuzr.in/docs#data-table)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DepthButtonProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DepthButton.tsx#L7)           | @abuzareal | stable (0.x) | Type contract for DepthButton      | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#buttons)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DialogProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Dialog.tsx#L12)                    | @abuzareal | stable (0.x) | Type contract for Dialog           | Type-only; no runtime value. Native dialog ref and root/panel/body/footer/close-button props; app owns open/onClose; no initial-focus override.                         | [Reference](https://contour.abuzr.in/docs/components/dialog)        | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DisclosureProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Disclosure.tsx#L5)             | @abuzareal | stable (0.x) | Type contract for Disclosure       | Type-only; no runtime value. Native details; defaultOpen only, no controlled open/onOpenChange; className is required.                                                  | [Reference](https://contour.abuzr.in/docs#content)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DividerProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Divider.tsx#L2)                   | @abuzareal | stable (0.x) | Type contract for Divider          | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`MenuItem`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DropdownMenu.tsx#L11)                 | @abuzareal | experimental | Type contract for DropdownMenu     | Type-only; no runtime value. Local absolute panel; no portal/collision/submenu API; shares nested-dismissal limitation.                                                 | [Reference](https://contour.abuzr.in/docs/components/dropdown-menu) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`DropdownMenuProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/DropdownMenu.tsx#L21)        | @abuzareal | experimental | Type contract for DropdownMenu     | Type-only; no runtime value. Local absolute panel; no portal/collision/submenu API; shares nested-dismissal limitation.                                                 | [Reference](https://contour.abuzr.in/docs/components/dropdown-menu) | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`EmptyStateProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/EmptyState.tsx#L4)             | @abuzareal | stable (0.x) | Type contract for EmptyState       | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ExternalLinkProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ExternalLink.tsx#L7)         | @abuzareal | stable (0.x) | Type contract for ExternalLink     | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#buttons)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`FieldProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Field.tsx#L6)                       | @abuzareal | stable (0.x) | Type contract for Field            | Type-only; no runtime value. Caller wires the child ID/describedby; wrapper does not wire arbitrary children automatically.                                             | [Reference](https://contour.abuzr.in/docs#field)                    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`FlipCardProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/FlipCard.tsx#L8)                 | @abuzareal | stable (0.x) | Type contract for FlipCard         | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`IconButtonProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/IconButton.tsx#L7)             | @abuzareal | stable (0.x) | Type contract for IconButton       | Type-only; no runtime value. Forwarded native button ref on React 18/19; caller supplies a meaningful accessible label.                                                 | [Reference](https://contour.abuzr.in/docs#buttons)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`MagneticProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Magnetic.tsx#L7)                 | @abuzareal | stable (0.x) | Type contract for Magnetic         | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`MarqueeProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Marquee.tsx#L5)                   | @abuzareal | stable (0.x) | Type contract for Marquee          | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`PaginationProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Pagination.tsx#L7)             | @abuzareal | stable (0.x) | Type contract for Pagination       | Type-only; no runtime value. Positive integer pages and in-range one-based page; application owns URL/fetch/slicing.                                                    | [Reference](https://contour.abuzr.in/docs#navigation)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`PopoverProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Popover.tsx#L12)                  | @abuzareal | experimental | Type contract for Popover          | Type-only; no runtime value. Root/owned trigger/panel props and refs supported; no portal/collision/custom-trigger/initial-focus API; nested Escape limitation remains. | [Reference](https://contour.abuzr.in/docs#floating)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ProgressBarProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ProgressBar.tsx#L5)           | @abuzareal | stable (0.x) | Type contract for ProgressBar      | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs/components/progress-bar)  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`RadioGroupProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/RadioGroup.tsx#L7)             | @abuzareal | stable (0.x) | Type contract for RadioGroup       | Type-only; no runtime value. Uses generated name; no caller field-name/form/ref contract; submit application state for stable keys.                                     | [Reference](https://contour.abuzr.in/docs#choices)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`RevealProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Reveal.tsx#L6)                     | @abuzareal | stable (0.x) | Type contract for Reveal           | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`HeadingLine`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/RevealHeading.tsx#L4)              | @abuzareal | legacy       | Type contract for RevealHeading    | Type-only; no runtime value. Editorial h2 composition; application must preserve heading order.                                                                         | [Reference](https://contour.abuzr.in/docs#identity)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`RevealHeadingProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/RevealHeading.tsx#L10)      | @abuzareal | legacy       | Type contract for RevealHeading    | Type-only; no runtime value. Editorial h2 composition; application must preserve heading order.                                                                         | [Reference](https://contour.abuzr.in/docs#identity)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SectionLabelProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SectionLabel.tsx#L5)         | @abuzareal | legacy       | Type contract for SectionLabel     | Type-only; no runtime value. Depends on Section editorial metadata/aside contract; not a general label primitive.                                                       | [Reference](https://contour.abuzr.in/docs#identity)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SegmentedControlProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SegmentedControl.tsx#L7) | @abuzareal | stable (0.x) | Type contract for SegmentedControl | Type-only; no runtime value. No native named field or disabled-option API; application owns value and submission.                                                       | [Reference](https://contour.abuzr.in/docs#choices)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SelectFieldProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SelectField.tsx#L9)           | @abuzareal | stable (0.x) | Type contract for SelectField      | Type-only; no runtime value. Native forwarded select ref; native choices, not searchable Combobox.                                                                      | [Reference](https://contour.abuzr.in/docs/components/select-field)  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SkeletonProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Skeleton.tsx#L5)                 | @abuzareal | stable (0.x) | Type contract for Skeleton         | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#feedback)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SliderProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Slider.tsx#L6)                     | @abuzareal | stable (0.x) | Type contract for Slider           | Type-only; no runtime value. Forwarded native range-input ref; no name/form/reset API; submit application state and keep values within meaningful bounds.               | [Reference](https://contour.abuzr.in/docs#choices)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SocialIconProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/SocialIcons.tsx#L3)            | @abuzareal | stable (0.x) | Type contract for LinkedInIcon     | Type-only; no runtime value. SVG only; caller owns link destination and accessible name.                                                                                | [Reference](https://contour.abuzr.in/docs#identity)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SpinnerProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Spinner.tsx#L5)                   | @abuzareal | stable (0.x) | Type contract for Spinner          | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#feedback)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`StatProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Stat.tsx#L4)                         | @abuzareal | stable (0.x) | Type contract for Stat             | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`StepperProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Stepper.tsx#L6)                   | @abuzareal | stable (0.x) | Type contract for Stepper          | Type-only; no runtime value. Progress display, not a navigable wizard; application owns state and validation.                                                           | [Reference](https://contour.abuzr.in/docs#navigation)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`SwitchProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Switch.tsx#L6)                     | @abuzareal | stable (0.x) | Type contract for Switch           | Type-only; no runtime value. Forwarded native switch-button ref; boolean value callback; no name/form/uncontrolled reset API.                                           | [Reference](https://contour.abuzr.in/docs#choices)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TabItem`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Tabs.tsx#L18)                          | @abuzareal | stable (0.x) | Type contract for Tabs             | Type-only; no runtime value. Root/list/tab/panel props and refs; controlled/default selected ID; no disabled-tab/orientation/component-replacement API.                 | [Reference](https://contour.abuzr.in/docs/components/tabs)          | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TabsProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Tabs.tsx#L26)                        | @abuzareal | stable (0.x) | Type contract for Tabs             | Type-only; no runtime value. Root/list/tab/panel props and refs; controlled/default selected ID; no disabled-tab/orientation/component-replacement API.                 | [Reference](https://contour.abuzr.in/docs/components/tabs)          | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TagProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Tag.tsx#L6)                           | @abuzareal | stable (0.x) | Type contract for Tag              | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#metadata)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TextAreaProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/TextArea.tsx#L16)                | @abuzareal | stable (0.x) | Type contract for TextArea         | Type-only; no runtime value. Native forwarded textarea ref; parent owns controlled reset; sizing is browser dependent.                                                  | [Reference](https://contour.abuzr.in/docs/components/text-area)     | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TextFieldProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/TextField.tsx#L16)              | @abuzareal | stable (0.x) | Type contract for TextField        | Type-only; no runtime value. Native forwarded input ref; parent owns controlled values/reset; do not switch state ownership.                                            | [Reference](https://contour.abuzr.in/docs/components/text-field)    | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ThemeToggleProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/ThemeToggle.tsx#L8)           | @abuzareal | stable (0.x) | Type contract for ThemeToggle      | Type-only; no runtime value. Native button ref; root data-theme and aa-theme storage; no scoped theme provider.                                                         | [Reference](https://contour.abuzr.in/docs#theme-copy)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TiltCardProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/TiltCard.tsx#L7)                 | @abuzareal | stable (0.x) | Type contract for TiltCard         | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#motion)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TimelineProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Timeline.tsx#L4)                 | @abuzareal | stable (0.x) | Type contract for Timeline         | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.                                          | [Reference](https://contour.abuzr.in/docs#content)                  | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`TooltipProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/ui/Tooltip.tsx#L7)                   | @abuzareal | experimental | Type contract for Tooltip          | Type-only; no runtime value. Pointer leave closes it and CSS prevents content hover; supplemental noninteractive text only; no collision engine.                        | [Reference](https://contour.abuzr.in/docs#floating)                 | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`CopyStatus`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useClipboardCopy.ts#L6)                     | @abuzareal | stable (0.x) | Type contract for useClipboardCopy | Type-only; no runtime value. Clipboard access can fail; obsolete text/request/unmount completions are discarded in 0.2.1; app presents truthful feedback.               | [Reference](https://contour.abuzr.in/docs#theme-copy)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`Theme`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useTheme.ts#L9)                                  | @abuzareal | stable (0.x) | Type contract for useTheme         | Type-only; no runtime value. Root data-theme and aa-theme origin storage; client lifecycle; embedding needs one theme owner.                                            | [Reference](https://contour.abuzr.in/docs#theme-copy)               | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ToastInput`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useToast.ts#L7)                             | @abuzareal | stable (0.x) | Type contract for useToast         | Type-only; no runtime value. Must be called under ToastProvider; ephemeral feedback is not an operation result.                                                         | [Reference](https://contour.abuzr.in/docs#toasts)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ToastContextValue`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useToast.ts#L13)                     | @abuzareal | stable (0.x) | Type contract for useToast         | Type-only; no runtime value. Must be called under ToastProvider; ephemeral feedback is not an operation result.                                                         | [Reference](https://contour.abuzr.in/docs#toasts)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ToastContext`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useToast.ts#L17)                          | @abuzareal | stable (0.x) | Type contract for useToast         | Type-only; no runtime value. Must be called under ToastProvider; ephemeral feedback is not an operation result.                                                         | [Reference](https://contour.abuzr.in/docs#toasts)                   | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ButtonVariant`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/classNames.ts#L5)                          | @abuzareal | stable (0.x) | Type contract for buttonClassName  | Type-only; no runtime value. Returns existing global classes; styled anchor retains native link responsibilities.                                                       | [Reference](https://contour.abuzr.in/docs#utilities)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
+| [`ButtonSize`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/classNames.ts#L7)                             | @abuzareal | stable (0.x) | Type contract for buttonClassName  | Type-only; no runtime value. Returns existing global classes; styled anchor retains native link responsibilities.                                                       | [Reference](https://contour.abuzr.in/docs#utilities)                | D: emitted declaration; C: core package compile/import; behavior coverage is sampled |
 ## Optional: @abuzareal/contour-ui/three
@@ -169,31 +169,31 @@ These identify reproducible checks, not claims that every row has a dedicated be
 ### Runtime exports
-| Export / source | Maintainer | Status | Intended use | Known limits | Documentation | Evidence |
-| --- | --- | --- | --- | --- | --- | --- |
-| [`Sculpture`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/hero/Sculpture.tsx#L73) | @abuzareal | experimental | Experimental link sculpture scene | WebGL, sized container, lazy/static fallback and motionEnabled required; setup captured on mount. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`ObjectStudy`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/three/ObjectStudy.tsx#L34) | @abuzareal | experimental | Experimental material/geometry scene | WebGL, sized container, study/label/motionEnabled required; experimental scene contract. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`useThreeStage`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useThreeStage.ts#L41) | @abuzareal | experimental | Experimental renderer and scene lifecycle | Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`createLinkGeometry`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeMaterials.ts#L58) | @abuzareal | experimental | Create owned link geometry | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`createChrome`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeMaterials.ts#L4) | @abuzareal | experimental | Create owned chrome material | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`createLime`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeMaterials.ts#L12) | @abuzareal | experimental | Create owned lime material | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`createInk`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeMaterials.ts#L20) | @abuzareal | experimental | Create owned ink material | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`createGlass`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeMaterials.ts#L29) | @abuzareal | experimental | Create owned glass material | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`createMaterialSet`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeStudies.ts#L18) | @abuzareal | experimental | Create owned material-study objects | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`createGeometrySet`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeStudies.ts#L31) | @abuzareal | experimental | Create owned geometry-study objects | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`objectStudies`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeStudies.ts#L52) | @abuzareal | experimental | Named scene factories | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| Export / source                                                                                               | Maintainer | Status       | Intended use                              | Known limits                                                                                       | Documentation                                             | Evidence                                                                                     |
+| ------------------------------------------------------------------------------------------------------------- | ---------- | ------------ | ----------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| [`Sculpture`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/hero/Sculpture.tsx#L73)      | @abuzareal | experimental | Experimental link sculpture scene         | WebGL, sized container, lazy/static fallback and motionEnabled required; setup captured on mount.  | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`ObjectStudy`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/three/ObjectStudy.tsx#L34) | @abuzareal | experimental | Experimental material/geometry scene      | WebGL, sized container, study/label/motionEnabled required; experimental scene contract.           | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`useThreeStage`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useThreeStage.ts#L41)         | @abuzareal | experimental | Experimental renderer and scene lifecycle | Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`createLinkGeometry`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeMaterials.ts#L58)     | @abuzareal | experimental | Create owned link geometry                | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`createChrome`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeMaterials.ts#L4)            | @abuzareal | experimental | Create owned chrome material              | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`createLime`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeMaterials.ts#L12)             | @abuzareal | experimental | Create owned lime material                | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`createInk`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeMaterials.ts#L20)              | @abuzareal | experimental | Create owned ink material                 | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`createGlass`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeMaterials.ts#L29)            | @abuzareal | experimental | Create owned glass material               | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`createMaterialSet`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeStudies.ts#L18)        | @abuzareal | experimental | Create owned material-study objects       | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`createGeometrySet`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeStudies.ts#L31)        | @abuzareal | experimental | Create owned geometry-study objects       | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`objectStudies`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeStudies.ts#L52)            | @abuzareal | experimental | Named scene factories                     | Experimental GPU resource; caller owns disposal, sized lazy scene and usable static fallback.      | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
 ### Type-only exports
-| Export / source | Maintainer | Status | Intended use | Known limits | Documentation | Evidence |
-| --- | --- | --- | --- | --- | --- | --- |
-| [`StageFrame`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useThreeStage.ts#L8) | @abuzareal | experimental | Type contract for useThreeStage | Type-only; no runtime value. Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`StageScene`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useThreeStage.ts#L15) | @abuzareal | experimental | Type contract for useThreeStage | Type-only; no runtime value. Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`StageContext`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useThreeStage.ts#L24) | @abuzareal | experimental | Type contract for useThreeStage | Type-only; no runtime value. Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`SculptureProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/hero/Sculpture.tsx#L16) | @abuzareal | experimental | Type contract for Sculpture | Type-only; no runtime value. WebGL, sized container, lazy/static fallback and motionEnabled required; setup captured on mount. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`ObjectStudyProps`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/components/three/ObjectStudy.tsx#L12) | @abuzareal | experimental | Type contract for ObjectStudy | Type-only; no runtime value. WebGL, sized container, study/label/motionEnabled required; experimental scene contract. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`ObjectSet`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeStudies.ts#L12) | @abuzareal | experimental | Type contract for objectStudies | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
-| [`ObjectStudyKind`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/threeStudies.ts#L57) | @abuzareal | experimental | Type contract for objectStudies | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| Export / source                                                                                                    | Maintainer | Status       | Intended use                    | Known limits                                                                                                                    | Documentation                                             | Evidence                                                                                     |
+| ------------------------------------------------------------------------------------------------------------------ | ---------- | ------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| [`StageFrame`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useThreeStage.ts#L8)                  | @abuzareal | experimental | Type contract for useThreeStage | Type-only; no runtime value. Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`StageScene`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useThreeStage.ts#L15)                 | @abuzareal | experimental | Type contract for useThreeStage | Type-only; no runtime value. Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`StageContext`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useThreeStage.ts#L24)               | @abuzareal | experimental | Type contract for useThreeStage | Type-only; no runtime value. Setup captured on mount; register owned cleanup immediately with onDispose; do not double-dispose. | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`SculptureProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/hero/Sculpture.tsx#L16)      | @abuzareal | experimental | Type contract for Sculpture     | Type-only; no runtime value. WebGL, sized container, lazy/static fallback and motionEnabled required; setup captured on mount.  | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`ObjectStudyProps`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/components/three/ObjectStudy.tsx#L12) | @abuzareal | experimental | Type contract for ObjectStudy   | Type-only; no runtime value. WebGL, sized container, study/label/motionEnabled required; experimental scene contract.           | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`ObjectSet`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeStudies.ts#L12)                     | @abuzareal | experimental | Type contract for objectStudies | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.  | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
+| [`ObjectStudyKind`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/threeStudies.ts#L57)               | @abuzareal | experimental | Type contract for objectStudies | Type-only; no runtime value. Global CSS/root theme; use declared props only; application composition needs its own validation.  | [Reference](https://contour.abuzr.in/docs#optional-three) | D: emitted declaration; N: optional declaration/build fixture; G: sampled graphics lifecycle |
 ## Optional: @abuzareal/contour-ui/scroll
@@ -201,9 +201,9 @@ These identify reproducible checks, not claims that every row has a dedicated be
 ### Runtime exports
-| Export / source | Maintainer | Status | Intended use | Known limits | Documentation | Evidence |
-| --- | --- | --- | --- | --- | --- | --- |
-| [`useSmoothScroll`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/hooks/useSmoothScroll.ts#L7) | @abuzareal | experimental | Optional Lenis lifecycle | Install Lenis and its CSS explicitly; one owner; caller disables it for pause/reduced motion. | [Reference](https://contour.abuzr.in/docs#optional-scroll) | D: emitted declaration; N: optional declaration/build fixture |
+| Export / source                                                                                          | Maintainer | Status       | Intended use             | Known limits                                                                                  | Documentation                                              | Evidence                                                      |
+| -------------------------------------------------------------------------------------------------------- | ---------- | ------------ | ------------------------ | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------- |
+| [`useSmoothScroll`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/hooks/useSmoothScroll.ts#L7) | @abuzareal | experimental | Optional Lenis lifecycle | Install Lenis and its CSS explicitly; one owner; caller disables it for pause/reduced motion. | [Reference](https://contour.abuzr.in/docs#optional-scroll) | D: emitted declaration; N: optional declaration/build fixture |
 ## Server-safe string/helpers: @abuzareal/contour-ui/theme-bootstrap
@@ -211,20 +211,20 @@ These identify reproducible checks, not claims that every row has a dedicated be
 ### Runtime exports
-| Export / source | Maintainer | Status | Intended use | Known limits | Documentation | Evidence |
-| --- | --- | --- | --- | --- | --- | --- |
-| [`themeColors`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/themeBootstrap.ts#L6) | @abuzareal | stable (0.x) | Theme-background constants | Fixed backgrounds must match token defaults; consumer themes may need own metadata. | [Reference](https://contour.abuzr.in/docs/getting-started#theme-motion) | D: emitted declaration; P: bootstrap package/Next fixture |
-| [`themeBootstrapScript`](https://github.com/abuzareal/contour-ui/blob/v0.2.1/src/lib/themeBootstrap.ts#L11) | @abuzareal | stable (0.x) | Pre-paint theme initialization string | Authorize inline script through CSP nonce/hash; no user interpolation; root preference only. | [Reference](https://contour.abuzr.in/docs/getting-started#theme-motion) | D: emitted declaration; P: bootstrap package/Next fixture |
+| Export / source                                                                                             | Maintainer | Status       | Intended use                          | Known limits                                                                                 | Documentation                                                           | Evidence                                                  |
+| ----------------------------------------------------------------------------------------------------------- | ---------- | ------------ | ------------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------- |
+| [`themeColors`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/themeBootstrap.ts#L6)           | @abuzareal | stable (0.x) | Theme-background constants            | Fixed backgrounds must match token defaults; consumer themes may need own metadata.          | [Reference](https://contour.abuzr.in/docs/getting-started#theme-motion) | D: emitted declaration; P: bootstrap package/Next fixture |
+| [`themeBootstrapScript`](https://github.com/abuzareal/contour-ui/blob/v0.3.0/src/lib/themeBootstrap.ts#L11) | @abuzareal | stable (0.x) | Pre-paint theme initialization string | Authorize inline script through CSP nonce/hash; no user interpolation; root preference only. | [Reference](https://contour.abuzr.in/docs/getting-started#theme-motion) | D: emitted declaration; P: bootstrap package/Next fixture |
 ## Stylesheet exports
-| Import | Maintainer | Status | Purpose and limits | Documentation | Evidence |
-| --- | --- | --- | --- | --- | --- |
-| `styles.css` | @abuzareal | stable (0.x) | Aggregate component CSS, tokens and utilities; global classes, not selective CSS tree shaking. | [Styles](README.md#styles-and-customization) | Package/export and consumer build checks |
-| `tokens.css` | @abuzareal | stable (0.x) | Root semantic tokens; includes inherited product values, no general scoped-theme contract. | [Theme contract](CONTRACTS.md#styles-theme-and-motion) | Package/export and source-token inspection |
-| `reset.css` | @abuzareal | legacy | Optional global element defaults plus inherited page-width/site-shell/section offsets; affects the host document. | [Reset scope](CONTRACTS.md#styles-theme-and-motion) | Package/export and consumer build checks |
-| `fonts.css` | @abuzareal | stable (0.x) | Optional Fontsource CSS; branded font dependencies still install; wider character coverage. | [Fonts](README.md#optional-latin-fonts) | Core packed consumer/CSS build checks |
-| `fonts-latin.css` | @abuzareal | stable (0.x) | Optional relative Latin WOFF2 files and notices; choose instead of fonts.css; narrower coverage. | [Fonts](README.md#optional-latin-fonts) | Optional consumer asset and Next webpack checks |
+| Import            | Maintainer | Status       | Purpose and limits                                                                                                | Documentation                                          | Evidence                                        |
+| ----------------- | ---------- | ------------ | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ----------------------------------------------- |
+| `styles.css`      | @abuzareal | stable (0.x) | Aggregate component CSS, tokens and utilities; global classes, not selective CSS tree shaking.                    | [Styles](README.md#styles-and-customization)           | Package/export and consumer build checks        |
+| `tokens.css`      | @abuzareal | stable (0.x) | Root semantic tokens; includes inherited product values, no general scoped-theme contract.                        | [Theme contract](CONTRACTS.md#styles-theme-and-motion) | Package/export and source-token inspection      |
+| `reset.css`       | @abuzareal | legacy       | Optional global element defaults plus inherited page-width/site-shell/section offsets; affects the host document. | [Reset scope](CONTRACTS.md#styles-theme-and-motion)    | Package/export and consumer build checks        |
+| `fonts.css`       | @abuzareal | stable (0.x) | Optional Fontsource CSS; branded font dependencies still install; wider character coverage.                       | [Fonts](README.md#optional-latin-fonts)                | Core packed consumer/CSS build checks           |
+| `fonts-latin.css` | @abuzareal | stable (0.x) | Optional relative Latin WOFF2 files and notices; choose instead of fonts.css; narrower coverage.                  | [Fonts](README.md#optional-latin-fonts)                | Optional consumer asset and Next webpack checks |
 The inventory has 86 runtime entries, 67 type-only entries and five stylesheet entries across public paths. Core includes 48 default UI components, two social icons, SceneBoundary, 11 hooks and ten helpers/constants. No `Drawer`, `Banner`, `Combobox`, `FocusBand` or `ProjectCard` runtime export is implied. Drawer is Dialog placement; banner is Alert layout; native Disclosure supplies disclosure behavior. Catalogue page/grid/spacing/resource-card and workflow specimens are application examples.