@abuzareal/contour-ui 0.6.2 → 0.6.4

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.4**. 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.4 --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.4 --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.
@@ -248,7 +250,7 @@ export function AccountControls() {
 }
 ```
 
-Interactive module boundaries retain `use client` in the built package. The pinned Next.js App Router consumer checks the packed candidate archive. Follow [Next.js setup](NEXTJS.md) for the pinned Next.js 16.4.0 / React 19.3.0 pair. Pure URL/theme-bootstrap helpers remain usable from the server. A separate fixture mode checks lazy optional Three.js loading and navigation cleanup. Lenis integration, other Next versions and alternate bundlers remain separate compatibility questions.
+Interactive module boundaries retain `use client` in the built package. The pinned Next.js App Router consumer checks the packed candidate archive. Follow [Next.js setup](NEXTJS.md) for the pinned Next.js 16.4.3 / React 19.3.0 pair. Pure URL/theme-bootstrap helpers remain usable from the server. A separate fixture mode checks lazy optional Three.js loading and navigation cleanup. Lenis integration, other Next versions and alternate bundlers remain separate compatibility questions.
 
 Custom `useThreeStage` setup can register disposal through `context.onDispose?.(cleanup)` immediately after acquiring each resource, including resources allocated before setup returns. Registered resources are released on failed initialization and unmount; avoid also disposing the same resource in `StageScene.dispose`. A stage may implement `resize()` to reflow after aspect changes while motion is paused.
 

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.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&title=Table%20recipes%200.6.4%3A%20&component=Table%20recipes&version=0.6.4); [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.4 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/SIZE.md

@@ -8,7 +8,7 @@ CONTOUR_SIZE_OUTPUT=/absolute/path/sizes.json npm run measure:size
 CONTOUR_SIZE_OUTPUT=/absolute/path/check.json npm run check:size
 ```
 
-Set `CONTOUR_ARCHIVE` to the already packed candidate to reuse it. Fixtures install React/React DOM 19.3.0; Next uses 16.4.0, and Vite/Chromium/Node versions are recorded from the running tools. The report names package/source commit/dirty state, archive checksum/files/compressed/unpacked bytes, the fresh dependency lock hash, resolved dependency versions, fixtures, exclusions, raw/gzip file sizes and actual Resource Timing transfers. These are reproducible fixtures, not latency or production-site benchmarks. No React/framework externals are removed from the application totals. Next shared JS is the intersection of actually fetched URLs across the measured fresh routes; route-specific JS is listed separately. Server build output is excluded from client bytes.
+Set `CONTOUR_ARCHIVE` to the already packed candidate to reuse it. Fixtures install React/React DOM 19.3.0; Next uses 16.4.3, and Vite/Chromium/Node versions are recorded from the running tools. The report names package/source commit/dirty state, archive checksum/files/compressed/unpacked bytes, the fresh dependency lock hash, resolved dependency versions, fixtures, exclusions, raw/gzip file sizes and actual Resource Timing transfers. These are reproducible fixtures, not latency or production-site benchmarks. No React/framework externals are removed from the application totals. Next shared JS is the intersection of actually fetched URLs across the measured fresh routes; route-specific JS is listed separately. Server build output is excluded from client bytes.
 
 Raw minified JS/CSS is reported per actual fetched file and by fixture. Gzip level 9 is reported **per file**, never summed and advertised as an application gzip total. Network transfer, encoded body and decoded body measurements are kept separately, including document/RSC resources. CSS/font requests, archive size and library dependency-closure installed file bytes are separate categories. Install counts exclude Next/Vite/development tooling and record React peers separately. Optional Three.js, Lenis and RHF are absent from core fixtures.
 
@@ -46,6 +46,6 @@ Three.js/Lenis stay optional peers behind their entries. Core imports do not ins
 
 ## 0.6 Combobox measurement
 
-On 14 October 2026, an initial 0.6.0 candidate used the same production fixtures to measure the new Combobox journey with React 19.3.0, Vite 8.3.2, Next 16.4.0/webpack, Node 26.10.0 and Chromium 153. A fresh Vite page fetched 365,549 raw JS bytes; selective forms/actions CSS fetched 24,729 bytes (aggregate 47,625). The Next Combobox route fetched 593,605 raw client JS bytes and 46,807 CSS bytes, including framework/shared assets. These are dated candidate measurements, not immutable final-archive byte counts. The release gate remeasures its exact archive. These whole-application fixtures are not an isolated component size or an upstream bundle-size badge. Per-file gzip and actual Resource Timing are retained in the report; independent gzip files are not advertised as an additive component total.
+On 14 October 2026, an initial 0.6.0 candidate used the same production fixtures to measure the new Combobox journey with React 19.3.0, Vite 8.3.2, Next 16.4.3/webpack, Node 26.10.0 and Chromium 153. A fresh Vite page fetched 365,549 raw JS bytes; selective forms/actions CSS fetched 24,729 bytes (aggregate 47,625). The Next Combobox route fetched 593,605 raw client JS bytes and 46,807 CSS bytes, including framework/shared assets. These are dated candidate measurements, not immutable final-archive byte counts. The release gate remeasures its exact archive. These whole-application fixtures are not an isolated component size or an upstream bundle-size badge. Per-file gzip and actual Resource Timing are retained in the report; independent gzip files are not advertised as an additive component total.
 
 Every previous journey stays within its existing budget. Initial Combobox budgets are added separately under the same 10% plus 1,024-byte policy; old budgets are not reset to the new measurements. The root Button fixture remains 227,291 raw Vite JS bytes with zero font requests; importing one component does not require downloading the Combobox route's full client code. All runtime dependencies still install with the package. Base UI adds installed files and an unstyled interaction dependency; see FOUNDATION.md for the identical-host comparison and its limitations. Its optional date/time peers are absent from core consumers. TanStack Table/Store and RHF are recipe dependencies only.

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.4**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.4/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Styles 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Styles&version=0.6.4), 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.4**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.4/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Support matrix 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Support%20matrix&version=0.6.4), 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.4**. A source version does not establish publication; check the npm registry for availability. [Versioned source](https://github.com/abuzareal/contour-ui/tree/v0.6.4/src) and [emitted type inventory](PUBLIC-API.md) describe this contract; tag links resolve after release. [Report Three 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Three&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.

package/dist/components/ui/Avatar.js

@@ -1,12 +1,16 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /** Round avatar showing a photo or Space Grotesk initials, with an optional presence dot. */
+import { useState } from "react";
 import { ccx } from "../../lib/classNames.js";
 const initialsOf = (name) => name
-    .split(" ")
+    .trim()
+    .split(/\s+/)
     .map((part) => part[0])
     .slice(0, 2)
     .join("")
     .toUpperCase();
 export default function Avatar({ name, initials, src, size = "md", status, statusLabel, }) {
-    return (_jsxs("span", { className: ccx("avatar", `avatar-${size}`), children: [src ? (_jsx("img", { src: src, alt: name, loading: "lazy", decoding: "async" })) : (_jsx("span", { role: "img", "aria-label": name, className: ccx("avatar-initials"), children: initials ?? initialsOf(name) })), status && (_jsx("span", { className: ccx("avatar-status", `avatar-status-${status}`), role: "img", "aria-label": statusLabel ?? (status === "online" ? "Online" : "Away") }))] }));
+    const [failedSource, setFailedSource] = useState();
+    return (_jsxs("span", { className: ccx("avatar", `avatar-${size}`), children: [src && src !== failedSource ? (_jsx("img", { src: src, alt: name, loading: "lazy", decoding: "async", onError: () => setFailedSource(src) }, src)) : (_jsx("span", { role: "img", "aria-label": name, className: ccx("avatar-initials"), children: initials ?? initialsOf(name) })), status && (_jsx("span", { className: ccx("avatar-status", `avatar-status-${status}`), role: "img", "aria-label": statusLabel ?? (status === "online" ? "Online" : "Away") }))] }));
 }

package/dist/components/ui/SegmentedControl.js

@@ -6,11 +6,12 @@ import { useRef } from "react";
 import { nextIndexForKey } from "../../lib/keyboard.js";
 export default function SegmentedControl({ label, options, value, onChange, }) {
     const buttons = useRef([]);
+    const focusIndex = Math.max(0, options.findIndex((option) => option.value === value));
     return (_jsx("div", { className: ccx("segmented"), role: "radiogroup", "aria-label": label, children: options.map((option, index) => {
             const selected = option.value === value;
             return (_jsx("button", { ref: (element) => {
                     buttons.current[index] = element;
-                }, type: "button", role: "radio", "aria-checked": selected, tabIndex: selected ? 0 : -1, className: ccx("segmented-option"), onClick: () => onChange(option.value), onKeyDown: (event) => {
+                }, type: "button", role: "radio", "aria-checked": selected, tabIndex: index === focusIndex ? 0 : -1, className: ccx("segmented-option"), onClick: () => onChange(option.value), onKeyDown: (event) => {
                     const next = nextIndexForKey(event.key, index, options.length, "horizontal", event.currentTarget.ownerDocument.defaultView?.getComputedStyle(event.currentTarget).direction === "rtl"
                         ? "rtl"
                         : "ltr");

package/dist/components/ui/ToastProvider.js

@@ -7,14 +7,26 @@ import { ToastContext, } from "../../hooks/useToast.js";
 import { ccx } from "../../lib/classNames.js";
 const autoDismissAfter = 5000;
 function Toast({ toast, onDismiss, dismissLabel, }) {
-    const [paused, setPaused] = useState(false);
+    const [hovered, setHovered] = useState(false);
+    const [focused, setFocused] = useState(false);
+    const [hidden, setHidden] = useState(false);
+    const paused = hovered || focused || hidden;
+    useEffect(() => {
+        const update = () => setHidden(document.visibilityState === "hidden");
+        update();
+        document.addEventListener("visibilitychange", update);
+        return () => document.removeEventListener("visibilitychange", update);
+    }, []);
     useEffect(() => {
         if (paused)
             return;
         const timer = window.setTimeout(() => onDismiss(toast.id), autoDismissAfter);
         return () => window.clearTimeout(timer);
     }, [paused, toast.id, onDismiss]);
-    return (_jsxs("li", { className: ccx("toast", `toast-${toast.tone ?? "neutral"}`), onPointerEnter: () => setPaused(true), onPointerLeave: () => setPaused(false), onFocus: () => setPaused(true), onBlur: () => setPaused(false), children: [_jsx("span", { className: ccx("toast-bar"), "aria-hidden": "true" }), _jsxs("div", { className: ccx("toast-content"), children: [_jsx("strong", { children: toast.title }), toast.message && _jsx("p", { children: toast.message })] }), _jsx("button", { type: "button", className: ccx("toast-close"), "aria-label": dismissLabel, onClick: () => onDismiss(toast.id), children: _jsx(X, { size: 15 }) })] }));
+    return (_jsxs("li", { className: ccx("toast", `toast-${toast.tone ?? "neutral"}`), onPointerEnter: () => setHovered(true), onPointerLeave: () => setHovered(false), onFocus: () => setFocused(true), onBlur: (event) => {
+            if (!event.currentTarget.contains(event.relatedTarget))
+                setFocused(false);
+        }, children: [_jsx("span", { className: ccx("toast-bar"), "aria-hidden": "true" }), _jsxs("div", { className: ccx("toast-content"), children: [_jsx("strong", { children: toast.title }), toast.message && _jsx("p", { children: toast.message })] }), _jsx("button", { type: "button", className: ccx("toast-close"), "aria-label": dismissLabel, onClick: () => onDismiss(toast.id), children: _jsx(X, { size: 15 }) })] }));
 }
 export default function ToastProvider({ children, label = "Notifications", dismissLabel = "Dismiss notification", }) {
     const [toasts, setToasts] = useState([]);