@abuzareal/contour-ui 0.6.2 → 0.6.3

package/README.md

@@ -6,7 +6,9 @@ Use it when you want this visual style with typed controls, feedback, navigation
 
 [Live catalogue](https://contour.abuzr.in/) · [npm package](https://www.npmjs.com/package/@abuzareal/contour-ui) · [Maintainer](https://github.com/abuzareal)
 
-This source checkout targets **0.6.2**. Package publication and application upgrades are separate; check the npm registry for release availability and each application's manifest for its installed version. Catalogue examples include application patterns as well as package components. Check the exports below before treating an example as an importable component.
+[Complete core component guides](COMPONENT-GUIDES.md) are maintained in a public authored dataset with runnable [family examples](examples/catalogue); they cover actual behavior as well as emitted props.
+
+This source checkout targets **0.6.3**. Package publication and application upgrades are separate; check the npm registry for release availability and each application's manifest for its installed version. Catalogue examples include application patterns as well as package components. Check the exports below before treating an example as an importable component.
 
 [Public API and maturity register](PUBLIC-API.md) · [Architecture, scope and compatibility](CONTRACTS.md)
 
@@ -23,7 +25,7 @@ Version 0.6 adds a single-select [Combobox](COMBOBOX.md) backed by pinned Base U
 Use an existing React application with a bundler that resolves package CSS imports. Contour ships ESM and TypeScript declarations. The package declares Node.js 22 or newer; repository tooling uses Vite 8, which needs Node.js 22.12+ or 24+.
 
 ```sh
-npm install @abuzareal/contour-ui@0.6.2 --save-exact
+npm install @abuzareal/contour-ui@0.6.3 --save-exact
 ```
 
 Your app must provide matching `react` and `react-dom` versions: **18.3.1 or React 19**. The compatibility script covers 18.3.1, 19.0.0, and 19.3.0; it doesn't establish support for every framework or React Server Component setup. Put interactive components inside a client boundary when your framework requires one.
@@ -180,7 +182,7 @@ Give scenes a sized container and a usable static fallback. `SceneBoundary` hide
 **0.2.0** adds native field refs, controlled tabs and popover/menu open state, menu keyboard improvements, native reset synchronization, Three.js lifecycle fixes and a tested Next.js App Router integration. Existing uncontrolled defaults and React 18/19 support remain. `fonts-latin.css`, introduced in 0.1.2, now uses packaged relative font URLs for webpack resolution. `CHANGELOG.md` is included in the package archive and [npm's Code view](https://www.npmjs.com/package/@abuzareal/contour-ui?activeTab=code); it contains the upgrade details for each version.
 
 ```sh
-npm install @abuzareal/contour-ui@0.6.2 --save-exact
+npm install @abuzareal/contour-ui@0.6.3 --save-exact
 ```
 
 Commit your manifest and lockfile, run your application's checks, and review both themes, dialogs, forms, and motion before deploying. Version 0.1.1 includes a document scroll lock for dialogs and drawers. Review any app-level lock before removing it, including nested dialogs and short screens. Package publication doesn't update deployed consumers automatically.

package/RECIPES.md

@@ -40,4 +40,4 @@ The optional **password visibility recipe** keeps the same input mounted, name a
 
 Use native p/span and h1–h6 with [typography tokens](STYLING.md). Heading level follows the document outline; size/weight are CSS choices. No Text/Heading wrappers are added without an independent semantic/variant contract. These explicit scope decisions do not complete deferred NumberField, full grid, calendar or other optional features.
 
-[Report Table/recipes 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&title=Table%20recipes%200.6.2%3A%20&component=Table%20recipes&version=0.6.2); [standalone reproduction](examples/reproduction). See [public API](PUBLIC-API.md) for exact types, [styling](STYLING.md) and [onboarding](GETTING-STARTED.md). Release source links become available with the published tag.
+[Report Table/recipes 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&title=Table%20recipes%200.6.3%3A%20&component=Table%20recipes&version=0.6.3); [standalone reproduction](examples/reproduction). See [public API](PUBLIC-API.md) for exact types, [styling](STYLING.md) and [onboarding](GETTING-STARTED.md). Release source links become available with the published tag.

package/REFERENCE.md

@@ -1,59 +1,59 @@
 # Export reference register
 
-Generated for 0.6.2 from actual source/runtime declarations and the manifest. This register maps all symbols and CSS/data entry points; it does not promote every component page. Human behavior guidance lives in the linked references. Source and exact types remain in [PUBLIC-API.md](PUBLIC-API.md). Run npm run check:reference; newly added hook/helper sources need an authored mapping before this register can update.
+Generated for 0.6.3 from actual source/runtime declarations and the manifest. This register maps all symbols and CSS/data entry points; it does not promote every component page. Human behavior guidance lives in the linked references. Source and exact types remain in [PUBLIC-API.md](PUBLIC-API.md). Run npm run check:reference; newly added hook/helper sources need an authored mapping before this register can update.
 
 | Entry | Symbol | Kind | Reference |
 | --- | --- | --- | --- |
-| . | Alert | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Avatar | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Badge | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | BrandMark | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Breadcrumbs | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Button | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Card | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Checkbox | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | CountUp | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | DataTable | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | DepthButton | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Dialog | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Disclosure | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Divider | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | DropdownMenu | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | EmptyState | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | ExternalLink | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Field | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | FlipCard | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | IconButton | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Kbd | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Magnetic | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Marquee | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Pagination | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Popover | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | ProgressBar | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | RadioGroup | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Reveal | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | RevealHeading | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | ScrollProgress | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | SectionLabel | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | SegmentedControl | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | SelectField | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Skeleton | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Slider | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | GitHubIcon | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | LinkedInIcon | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Spinner | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Stat | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Stepper | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Switch | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Tabs | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Tag | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | TextArea | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | TextField | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | ThemeToggle | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | TiltCard | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Timeline | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | ToastProvider | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
-| . | Tooltip | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
+| . | Alert | runtime | [COMPONENT-GUIDES.md#alert](COMPONENT-GUIDES.md#alert) |
+| . | Avatar | runtime | [COMPONENT-GUIDES.md#avatar](COMPONENT-GUIDES.md#avatar) |
+| . | Badge | runtime | [COMPONENT-GUIDES.md#badge](COMPONENT-GUIDES.md#badge) |
+| . | BrandMark | runtime | [COMPONENT-GUIDES.md#brandmark](COMPONENT-GUIDES.md#brandmark) |
+| . | Breadcrumbs | runtime | [COMPONENT-GUIDES.md#breadcrumbs](COMPONENT-GUIDES.md#breadcrumbs) |
+| . | Button | runtime | [COMPONENT-GUIDES.md#button](COMPONENT-GUIDES.md#button) |
+| . | Card | runtime | [COMPONENT-GUIDES.md#card](COMPONENT-GUIDES.md#card) |
+| . | Checkbox | runtime | [COMPONENT-GUIDES.md#checkbox](COMPONENT-GUIDES.md#checkbox) |
+| . | CountUp | runtime | [COMPONENT-GUIDES.md#countup](COMPONENT-GUIDES.md#countup) |
+| . | DataTable | runtime | [COMPONENT-GUIDES.md#datatable](COMPONENT-GUIDES.md#datatable) |
+| . | DepthButton | runtime | [COMPONENT-GUIDES.md#depthbutton](COMPONENT-GUIDES.md#depthbutton) |
+| . | Dialog | runtime | [COMPONENT-GUIDES.md#dialog](COMPONENT-GUIDES.md#dialog) |
+| . | Disclosure | runtime | [COMPONENT-GUIDES.md#disclosure](COMPONENT-GUIDES.md#disclosure) |
+| . | Divider | runtime | [COMPONENT-GUIDES.md#divider](COMPONENT-GUIDES.md#divider) |
+| . | DropdownMenu | runtime | [COMPONENT-GUIDES.md#dropdownmenu](COMPONENT-GUIDES.md#dropdownmenu) |
+| . | EmptyState | runtime | [COMPONENT-GUIDES.md#emptystate](COMPONENT-GUIDES.md#emptystate) |
+| . | ExternalLink | runtime | [COMPONENT-GUIDES.md#externallink](COMPONENT-GUIDES.md#externallink) |
+| . | Field | runtime | [COMPONENT-GUIDES.md#field](COMPONENT-GUIDES.md#field) |
+| . | FlipCard | runtime | [COMPONENT-GUIDES.md#flipcard](COMPONENT-GUIDES.md#flipcard) |
+| . | IconButton | runtime | [COMPONENT-GUIDES.md#iconbutton](COMPONENT-GUIDES.md#iconbutton) |
+| . | Kbd | runtime | [COMPONENT-GUIDES.md#kbd](COMPONENT-GUIDES.md#kbd) |
+| . | Magnetic | runtime | [COMPONENT-GUIDES.md#magnetic](COMPONENT-GUIDES.md#magnetic) |
+| . | Marquee | runtime | [COMPONENT-GUIDES.md#marquee](COMPONENT-GUIDES.md#marquee) |
+| . | Pagination | runtime | [COMPONENT-GUIDES.md#pagination](COMPONENT-GUIDES.md#pagination) |
+| . | Popover | runtime | [COMPONENT-GUIDES.md#popover](COMPONENT-GUIDES.md#popover) |
+| . | ProgressBar | runtime | [COMPONENT-GUIDES.md#progressbar](COMPONENT-GUIDES.md#progressbar) |
+| . | RadioGroup | runtime | [COMPONENT-GUIDES.md#radiogroup](COMPONENT-GUIDES.md#radiogroup) |
+| . | Reveal | runtime | [COMPONENT-GUIDES.md#reveal](COMPONENT-GUIDES.md#reveal) |
+| . | RevealHeading | runtime | [COMPONENT-GUIDES.md#revealheading](COMPONENT-GUIDES.md#revealheading) |
+| . | ScrollProgress | runtime | [COMPONENT-GUIDES.md#scrollprogress](COMPONENT-GUIDES.md#scrollprogress) |
+| . | SectionLabel | runtime | [COMPONENT-GUIDES.md#sectionlabel](COMPONENT-GUIDES.md#sectionlabel) |
+| . | SegmentedControl | runtime | [COMPONENT-GUIDES.md#segmentedcontrol](COMPONENT-GUIDES.md#segmentedcontrol) |
+| . | SelectField | runtime | [COMPONENT-GUIDES.md#selectfield](COMPONENT-GUIDES.md#selectfield) |
+| . | Skeleton | runtime | [COMPONENT-GUIDES.md#skeleton](COMPONENT-GUIDES.md#skeleton) |
+| . | Slider | runtime | [COMPONENT-GUIDES.md#slider](COMPONENT-GUIDES.md#slider) |
+| . | GitHubIcon | runtime | [COMPONENT-GUIDES.md#githubicon](COMPONENT-GUIDES.md#githubicon) |
+| . | LinkedInIcon | runtime | [COMPONENT-GUIDES.md#linkedinicon](COMPONENT-GUIDES.md#linkedinicon) |
+| . | Spinner | runtime | [COMPONENT-GUIDES.md#spinner](COMPONENT-GUIDES.md#spinner) |
+| . | Stat | runtime | [COMPONENT-GUIDES.md#stat](COMPONENT-GUIDES.md#stat) |
+| . | Stepper | runtime | [COMPONENT-GUIDES.md#stepper](COMPONENT-GUIDES.md#stepper) |
+| . | Switch | runtime | [COMPONENT-GUIDES.md#switch](COMPONENT-GUIDES.md#switch) |
+| . | Tabs | runtime | [COMPONENT-GUIDES.md#tabs](COMPONENT-GUIDES.md#tabs) |
+| . | Tag | runtime | [COMPONENT-GUIDES.md#tag](COMPONENT-GUIDES.md#tag) |
+| . | TextArea | runtime | [COMPONENT-GUIDES.md#textarea](COMPONENT-GUIDES.md#textarea) |
+| . | TextField | runtime | [COMPONENT-GUIDES.md#textfield](COMPONENT-GUIDES.md#textfield) |
+| . | ThemeToggle | runtime | [COMPONENT-GUIDES.md#themetoggle](COMPONENT-GUIDES.md#themetoggle) |
+| . | TiltCard | runtime | [COMPONENT-GUIDES.md#tiltcard](COMPONENT-GUIDES.md#tiltcard) |
+| . | Timeline | runtime | [COMPONENT-GUIDES.md#timeline](COMPONENT-GUIDES.md#timeline) |
+| . | ToastProvider | runtime | [COMPONENT-GUIDES.md#toastprovider](COMPONENT-GUIDES.md#toastprovider) |
+| . | Tooltip | runtime | [COMPONENT-GUIDES.md#tooltip](COMPONENT-GUIDES.md#tooltip) |
 | . | useClipboardCopy | runtime | [HOOKS.md#clipboard](HOOKS.md#clipboard) |
 | . | useDismiss | runtime | [HOOKS.md#dismissal-and-mobile-menus](HOOKS.md#dismissal-and-mobile-menus) |
 | . | useHeaderScroll | runtime | [HOOKS.md#scroll-and-navigation](HOOKS.md#scroll-and-navigation) |
@@ -66,15 +66,15 @@ Generated for 0.6.2 from actual source/runtime declarations and the manifest. Th
 | . | useTheme | runtime | [HOOKS.md#theme](HOOKS.md#theme) |
 | . | useToast | runtime | [HOOKS.md#toast](HOOKS.md#toast) |
 | . | Section | type | [HELPERS.md#public-types](HELPERS.md#public-types) |
-| . | SceneBoundary | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
+| . | SceneBoundary | runtime | [COMPONENT-GUIDES.md#sceneboundary](COMPONENT-GUIDES.md#sceneboundary) |
 | . | safeHref | runtime | [HELPERS.md](HELPERS.md) |
-| . | ThemeScope | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
+| . | ThemeScope | runtime | [COMPONENT-GUIDES.md#themescope](COMPONENT-GUIDES.md#themescope) |
 | . | FloatingOptions | type | [HOOKS.md#dismissal-and-mobile-menus](HOOKS.md#dismissal-and-mobile-menus) |
 | . | PanelFocusOptions | type | [HOOKS.md#dismissal-and-mobile-menus](HOOKS.md#dismissal-and-mobile-menus) |
 | . | DismissReason | type | [HELPERS.md#public-types](HELPERS.md#public-types) |
-| . | Table | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
+| . | Table | runtime | [COMPONENT-GUIDES.md#table](COMPONENT-GUIDES.md#table) |
 | . | TableProps | type | [PROP-REFERENCE.md](PROP-REFERENCE.md) |
-| . | Combobox | runtime | [PUBLIC-API.md](PUBLIC-API.md) |
+| . | Combobox | runtime | [COMPONENT-GUIDES.md#combobox](COMPONENT-GUIDES.md#combobox) |
 | . | ComboboxProps | type | [PROP-REFERENCE.md](PROP-REFERENCE.md) |
 | . | ComboboxOption | type | [PROP-REFERENCE.md](PROP-REFERENCE.md) |
 | . | AlertTone | type | [PROP-REFERENCE.md](PROP-REFERENCE.md) |

package/STYLING.md

@@ -69,4 +69,4 @@ Forced-color rules preserve focus, selected control outlines, radio marks, inval
 
 ## Version and reproduction
 
-Reference version **0.6.2**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.2/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Styles 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Styles&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
+Reference version **0.6.3**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.3/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Styles 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Styles&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.

package/SUPPORT.md

@@ -33,4 +33,4 @@ Every result should name package/commit/archive, date, OS/browser/tool versions,
 
 ## Version and reproduction
 
-Reference version **0.6.2**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.2/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Support matrix 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Support%20matrix&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
+Reference version **0.6.3**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.3/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Support matrix 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Support%20matrix&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.

package/THREE.md

@@ -37,4 +37,4 @@ Use one stage owner per host, stable setup and deliberate size. Product controls
 
 ## Version and reproduction
 
-Reference version **0.6.2**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.2/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Three 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Three&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
+Reference version **0.6.3**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.3/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Three 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Three&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.