@abuzareal/contour-ui 0.6.3 → 0.6.4
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.
- package/CHANGELOG.md +10 -2
- package/COMBOBOX.md +1 -1
- package/COMPONENT-GUIDES.md +62 -62
- package/COMPOSITION.md +1 -1
- package/CONTRACTS.md +1 -1
- package/DOCS.md +1 -1
- package/FORMS.md +1 -1
- package/GETTING-STARTED.md +4 -4
- package/HELPERS.md +1 -1
- package/HOOKS.md +2 -2
- package/MANUAL-QA.md +1 -1
- package/MIGRATION.md +1 -1
- package/MODELS.md +1 -1
- package/NEXTJS.md +2 -2
- package/OVERLAYS.md +1 -1
- package/PROP-REFERENCE.md +1 -1
- package/PUBLIC-API.md +166 -166
- package/README.md +4 -4
- package/RECIPES.md +1 -1
- package/REFERENCE.md +1 -1
- package/SIZE.md +2 -2
- package/STYLING.md +1 -1
- package/SUPPORT.md +1 -1
- package/THREE.md +1 -1
- package/dist/components/ui/Avatar.js +6 -2
- package/dist/components/ui/SegmentedControl.js +2 -1
- package/dist/components/ui/ToastProvider.js +14 -2
- package/docs/component-guides.json +7 -7
- package/docs/prop-metadata.json +1 -1
- package/examples/catalogue/theme-copy.tsx +1 -1
- package/examples/reproduction/package.json +2 -2
- package/examples/starters/next/README.md +1 -1
- package/examples/starters/next/package.json +2 -2
- package/examples/starters/vite/README.md +1 -1
- package/examples/starters/vite/package.json +2 -2
- package/package.json +2 -2
package/FORMS.md
CHANGED
|
@@ -95,4 +95,4 @@ References: [React native input ownership](https://react.dev/reference/react-dom
|
|
|
95
95
|
|
|
96
96
|
## Version and reproduction
|
|
97
97
|
|
|
98
|
-
Reference version **0.6.
|
|
98
|
+
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 Forms 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Forms&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|
package/GETTING-STARTED.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
# Adopt Contour — 0.6.
|
|
1
|
+
# Adopt Contour — 0.6.4
|
|
2
2
|
|
|
3
3
|
Use [the standalone Vite starter](examples/starters/vite), [Next App Router starter](examples/starters/next), or add one component to an existing app. Each folder is public and independent; no private catalogue source, repository aliases, provider stack or application layout is required. Direct dependencies are exact; generate and commit your application's lockfile, then use npm ci. Candidate source requires an archive until its matching version is published.
|
|
4
4
|
|
|
5
5
|
## Existing application
|
|
6
6
|
|
|
7
7
|
```sh
|
|
8
|
-
npm install --save-exact @abuzareal/contour-ui@0.6.
|
|
8
|
+
npm install --save-exact @abuzareal/contour-ui@0.6.4
|
|
9
9
|
```
|
|
10
10
|
|
|
11
11
|
Install matching react/react-dom versions in the supported ranges (^18.3.1 or ^19.0.0). React 18.3.1, 19.0.0 and 19.3.0 have independent packed consumer checks; a peer range is not a claim of every framework configuration. Native form/overlay APIs are client interactions. Use the library's emitted declarations instead of a copied API from an old catalogue.
|
|
@@ -58,9 +58,9 @@ Copy [OptionalSmoothScroll.tsx](examples/optional/OptionalSmoothScroll.tsx) and
|
|
|
58
58
|
|
|
59
59
|
## Framework boundaries and reproduction
|
|
60
60
|
|
|
61
|
-
Supported evidence names the exact pair: Next 16.4.
|
|
61
|
+
Supported evidence names the exact pair: Next 16.4.3 App Router, React/React DOM 19.3.0, webpack production build, plus its separate optional lazy Three fixture. Turbopack, Pages Router, Next Lenis, static nonce export and arbitrary third-party modal interoperability are not promoted to supported configurations. Vite starter pins 8.3.2 with React 18.3.1. Server-safe helper imports, client directives, declarations and hydration are checked independently; SSR rendering alone does not prove hydration.
|
|
62
62
|
|
|
63
|
-
Copy [the public reproduction folder](examples/reproduction), reduce it to the failing interaction, and include exact package/browser versions and keyboard steps. Its [issue link](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&title=Integration%200.6.
|
|
63
|
+
Copy [the public reproduction folder](examples/reproduction), reduce it to the failing interaction, and include exact package/browser versions and keyboard steps. Its [issue link](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&title=Integration%200.6.4%3A%20&component=Integration&version=0.6.4) contains version/component, not private data. Report only synthetic records and public reproducible source. [Documentation coverage and limits](DOCS.md).
|
|
64
64
|
|
|
65
65
|
## JavaScript and TypeScript examples
|
|
66
66
|
|
package/HELPERS.md
CHANGED
|
@@ -30,4 +30,4 @@ The JavaScript onboarding example in [GETTING-STARTED.md](GETTING-STARTED.md) us
|
|
|
30
30
|
|
|
31
31
|
## Version and reproduction
|
|
32
32
|
|
|
33
|
-
Reference version **0.6.
|
|
33
|
+
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 Helpers 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Helpers&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|
package/HOOKS.md
CHANGED
|
@@ -48,7 +48,7 @@ PanelFocusOptions is a public type used by built-in floating panels: initialFocu
|
|
|
48
48
|
|
|
49
49
|
## Toast
|
|
50
50
|
|
|
51
|
-
`useToast()` returns ToastContextValue `{show(toast): void}` and throws outside ToastProvider. ToastInput requires title, accepts message and AlertTone (`neutral | accent | info | success | warning | danger`); neutral is the visual default. The provider requires children and defaults label="Notifications", dismissLabel="Dismiss notification". It renders a polite live region, retains at most the latest three notifications and dismisses each after 5,000 ms while not hovered/focused. Leaving a pause starts a new full timeout, not a remaining-time countdown. Close buttons dismiss individual items. The public command returns no ID and has no update/dismiss/promise/undo API.
|
|
51
|
+
`useToast()` returns ToastContextValue `{show(toast): void}` and throws outside ToastProvider. ToastInput requires title, accepts message and AlertTone (`neutral | accent | info | success | warning | danger`); neutral is the visual default. The provider requires children and defaults label="Notifications", dismissLabel="Dismiss notification". It renders a polite live region, retains at most the latest three notifications and dismisses each after 5,000 ms while not hovered/focused and the document is visible. Leaving a pause starts a new full timeout, not a remaining-time countdown. Close buttons dismiss individual items. The public command returns no ID and has no update/dismiss/promise/undo API.
|
|
52
52
|
|
|
53
53
|
A toast describes an already established result. Fetching, business validation, persistence and retry remain application-owned. Keep important errors beside the task and use durable state when a message must outlive a temporary notification. ToastContext appears only as a type-level export through the current public re-export surface; it is not a runtime provider escape hatch.
|
|
54
54
|
|
|
@@ -64,4 +64,4 @@ Copyable [HookExamples.tsx](examples/reference/HookExamples.tsx) uses these publ
|
|
|
64
64
|
|
|
65
65
|
## Version and reproduction
|
|
66
66
|
|
|
67
|
-
Reference version **0.6.
|
|
67
|
+
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 Hooks 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Hooks&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|
package/MANUAL-QA.md
CHANGED
|
@@ -35,4 +35,4 @@ Mark unattempted scenarios explicitly. A passing session covers only its recorde
|
|
|
35
35
|
|
|
36
36
|
## Version and reproduction
|
|
37
37
|
|
|
38
|
-
Reference version **0.6.
|
|
38
|
+
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 Manual accessibility 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Manual%20accessibility&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|
package/MIGRATION.md
CHANGED
|
@@ -41,4 +41,4 @@ The 0.6.1 work is intended as compatible lifecycle/documentation corrections. It
|
|
|
41
41
|
|
|
42
42
|
## Version and reproduction
|
|
43
43
|
|
|
44
|
-
Reference version **0.6.
|
|
44
|
+
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 Migration 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Migration&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|
package/MODELS.md
CHANGED
|
@@ -15,4 +15,4 @@ The bounded Base UI/Radix+cmdk/React Aria decision, exact versions, licenses and
|
|
|
15
15
|
|
|
16
16
|
## Version and reproduction
|
|
17
17
|
|
|
18
|
-
Reference version **0.6.
|
|
18
|
+
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 Library models 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Library%20models&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|
package/NEXTJS.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Next.js App Router integration
|
|
2
2
|
|
|
3
|
-
This guide describes **Contour 0.6.
|
|
3
|
+
This guide describes **Contour 0.6.4**. Check npm for release availability before installing. The fixture pins Next 16.4.3 with React/React DOM 19.3.0, uses the webpack production build, and consumes an npm archive. It does not establish every Next version, Turbopack, Pages Router, scroll entries or hosting platform. A separate optional mode checks a lazy Three.js scene with SSR disabled and disposal on navigation.
|
|
4
4
|
|
|
5
5
|
In `app/layout.tsx`, load CSS once:
|
|
6
6
|
|
|
@@ -56,4 +56,4 @@ Named form/reset APIs and copyable form recipes are described in [FORMS.md](FORM
|
|
|
56
56
|
|
|
57
57
|
For embedded first use, substitute scoped.css, omit fonts/bootstrap/reset, and wrap client controls in controlled ThemeScope. The size fixture separately measures Button/settings/table routes with system fonts on the same pinned webpack configuration. Existing document-owned/branded integration above remains compatible; new portal migration and family imports are described in OVERLAYS.md and SIZE.md.
|
|
58
58
|
|
|
59
|
-
The standalone [Next starter](examples/starters/next) adds a tested per-request nonce CSP and dynamic layout using Next 16.4.
|
|
59
|
+
The standalone [Next starter](examples/starters/next) adds a tested per-request nonce CSP and dynamic layout using Next 16.4.3/React 19.3.0/webpack and TypeScript 7.0.2. Its strict DOM/ES2024 declaration check is separate from the older generated JS fixture. Follow [onboarding](GETTING-STARTED.md) for the existing-app, provider and optional-feature paths.
|
package/OVERLAYS.md
CHANGED
|
@@ -55,4 +55,4 @@ Default-open children choose an enclosing native dialog even before its open att
|
|
|
55
55
|
|
|
56
56
|
## Version and reproduction
|
|
57
57
|
|
|
58
|
-
Reference version **0.6.
|
|
58
|
+
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 Overlays 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Overlays&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|
package/PROP-REFERENCE.md
CHANGED
|
@@ -34,4 +34,4 @@ Read [FORMS.md](FORMS.md), [COMPOSITION.md](COMPOSITION.md), [OVERLAYS.md](OVERL
|
|
|
34
34
|
|
|
35
35
|
## Version and reproduction
|
|
36
36
|
|
|
37
|
-
Reference version **0.6.
|
|
37
|
+
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 Prop reference 0.6.4](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Prop%20reference&version=0.6.4), using the [public minimal reproduction](examples/reproduction) and synthetic data.
|