@abuzareal/contour-ui 0.6.2 → 0.6.3

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 (45) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/COMBOBOX.md +1 -1
  3. package/COMPONENT-GUIDES.md +3534 -0
  4. package/COMPOSITION.md +1 -1
  5. package/CONTRIBUTING.md +4 -0
  6. package/DOCS.md +61 -61
  7. package/FORMS.md +1 -1
  8. package/GETTING-STARTED.md +3 -3
  9. package/HELPERS.md +1 -1
  10. package/HOOKS.md +1 -1
  11. package/MANUAL-QA.md +1 -1
  12. package/MIGRATION.md +1 -1
  13. package/MODELS.md +1 -1
  14. package/OVERLAYS.md +1 -1
  15. package/PROP-REFERENCE.md +4 -4
  16. package/PUBLIC-API.md +166 -166
  17. package/README.md +5 -3
  18. package/RECIPES.md +1 -1
  19. package/REFERENCE.md +55 -55
  20. package/STYLING.md +1 -1
  21. package/SUPPORT.md +1 -1
  22. package/THREE.md +1 -1
  23. package/docs/component-guides.json +2217 -0
  24. package/docs/prop-metadata.json +5734 -751
  25. package/examples/catalogue/buttons.tsx +27 -0
  26. package/examples/catalogue/choices.tsx +51 -0
  27. package/examples/catalogue/combobox.tsx +119 -0
  28. package/examples/catalogue/content.tsx +108 -0
  29. package/examples/catalogue/data-table.tsx +18 -0
  30. package/examples/catalogue/dialogs.tsx +20 -0
  31. package/examples/catalogue/feedback.tsx +24 -0
  32. package/examples/catalogue/field.tsx +18 -0
  33. package/examples/catalogue/floating.tsx +41 -0
  34. package/examples/catalogue/identity.tsx +35 -0
  35. package/examples/catalogue/metadata.tsx +17 -0
  36. package/examples/catalogue/motion.tsx +47 -0
  37. package/examples/catalogue/navigation.tsx +43 -0
  38. package/examples/catalogue/scene-boundary.tsx +37 -0
  39. package/examples/catalogue/text-inputs.tsx +60 -0
  40. package/examples/catalogue/theme-copy.tsx +32 -0
  41. package/examples/catalogue/toasts.tsx +21 -0
  42. package/examples/reproduction/package.json +1 -1
  43. package/examples/starters/next/package.json +1 -1
  44. package/examples/starters/vite/package.json +1 -1
  45. package/package.json +5 -2
package/COMPOSITION.md CHANGED
@@ -194,4 +194,4 @@ Each addition serves a bounded need: native focus/measurement/trigger refs; exis
194
194
 
195
195
  ## Version and reproduction
196
196
 
197
- 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 Composition 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Composition&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
197
+ 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 Composition 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Composition&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.
package/CONTRIBUTING.md CHANGED
@@ -15,3 +15,7 @@ Update the README and Unreleased changelog when public behavior changes. Keep do
15
15
  A pull request should name the concrete behavior change, why it helps, which checks passed and any remaining limitation. Review public exports, packed files and dependency changes. No publish, deploy or merge is implied by opening a pull request. Consumers adopt an exact published release with a lockfile update; local source edits do not update them.
16
16
 
17
17
  Public API changes must follow [the compatibility policy](CONTRACTS.md#change-deprecation-and-migration-policy) and update [the maturity register](PUBLIC-API.md). Preserve native semantics and optional entry isolation; an experimental or legacy label does not authorize an undocumented removal.
18
+
19
+ ## Component guide source
20
+
21
+ Edit authored behavior in `docs/component-guides.json` and its linked `examples/catalogue` TSX module. Preserve component-specific limits, native form/ref ownership, keyboard behavior and loading/error/locale responsibilities; generated type discovery does not replace those explanations. After building, review `node scripts/check-reference.mjs --write` and `node scripts/check-docs.mjs --write`, then run the normal checks. These commands regenerate `COMPONENT-GUIDES.md`, metadata and the coverage register. The catalogue consumes the released public contracts and exact example modules; do not maintain a second behavior description in a private repository.
package/DOCS.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Public documentation contract and coverage
2
2
 
3
- For Contour 0.6.1, the public package/repository is an independent source of installation, API, recipe and reproduction material. The separate catalogue can describe an older installed release; its visual demos are not proof that this source version is installed there. Catalogue editing and per-component website promotion are separate work.
3
+ For Contour 0.6.3, the public package/repository is an independent source of installation, API, recipe and reproduction material. The separate catalogue can describe an older installed release; its visual demos are not proof that this source version is installed there. Catalogue editing and per-component website promotion are separate work.
4
4
 
5
5
  ## Contract for a promoted guide
6
6
 
@@ -12,75 +12,75 @@ Every promoted stable component page must contain: purpose and when not to use;
12
12
 
13
13
  Displayed recipe links point to the actual shipped TSX modules, not a second copy. Packed tests copy those files into fresh React 18/19 consumers, compile with strict declarations and exercise behavior. Complete TSX fences in Combobox/onboarding references also compile. Starters are copied from the archive, installed independently and production-tested; final registry mode runs after publication. Source tags/issue versions match package.json; candidate tag links become available at publication. New release changes must update public guide labels, README, declarations and changelog together.
14
14
 
15
- The coverage register below maps public UI components to an explicit shared reference or dedicated guide. “Shared; promotion pending” means discovery/type coverage exists but a full component page has not been completed. It is a **documentation gap**, not an absent export or claim of stable-page completeness. Hook/helper/type coverage is retained in the complete PUBLIC-API register; optional entry setup/lifecycle is shared with GETTING-STARTED. The package's check:docs script compares the component list with source exports, requires guide targets and compiles advertised copyable source through the release gates.
15
+ The coverage register below maps every core UI component to its authored public contract and runnable family example. Optional scene exports retain their experimental shared reference. Catalogue delivery, manual assistive-technology evidence and stable API maturity remain separate from authored guide coverage. Hook/helper/type coverage is retained in the complete PUBLIC-API register; optional entry setup/lifecycle is shared with GETTING-STARTED. The package's check:docs script compares the component list with source exports, requires guide targets and compiles advertised copyable source through the release gates.
16
16
 
17
17
  <!-- component-coverage:start -->
18
18
 
19
- | Component | Public reference | Coverage |
20
- | ---------------- | ---------------------------------------- | ------------------------------ |
21
- | Alert | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
22
- | Avatar | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
23
- | Badge | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
24
- | BrandMark | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
25
- | Breadcrumbs | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
26
- | Button | [COMPOSITION.md](COMPOSITION.md) | Shared; promotion pending |
27
- | Card | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
28
- | Checkbox | [FORMS.md](FORMS.md) | Shared; promotion pending |
29
- | Combobox | [COMBOBOX.md](COMBOBOX.md) | New component contract covered |
30
- | CountUp | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
31
- | DataTable | [RECIPES.md](RECIPES.md) | Shared; promotion pending |
32
- | DepthButton | [COMPOSITION.md](COMPOSITION.md) | Shared; promotion pending |
33
- | Dialog | [OVERLAYS.md](OVERLAYS.md) | Shared; promotion pending |
34
- | Disclosure | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
35
- | Divider | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
36
- | DropdownMenu | [OVERLAYS.md](OVERLAYS.md) | Shared; promotion pending |
37
- | EmptyState | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
38
- | ExternalLink | [COMPOSITION.md](COMPOSITION.md) | Shared; promotion pending |
39
- | Field | [FORMS.md](FORMS.md) | Shared; promotion pending |
40
- | FlipCard | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
41
- | GitHubIcon | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
42
- | IconButton | [COMPOSITION.md](COMPOSITION.md) | Shared; promotion pending |
43
- | Kbd | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
44
- | LinkedInIcon | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
45
- | Magnetic | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
46
- | Marquee | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
47
- | Pagination | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
48
- | Popover | [OVERLAYS.md](OVERLAYS.md) | Shared; promotion pending |
49
- | ProgressBar | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
50
- | RadioGroup | [FORMS.md](FORMS.md) | Shared; promotion pending |
51
- | Reveal | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
52
- | RevealHeading | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
53
- | SceneBoundary | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
54
- | ScrollProgress | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
55
- | SectionLabel | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
56
- | SegmentedControl | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
57
- | SelectField | [FORMS.md](FORMS.md) | Shared; promotion pending |
58
- | Skeleton | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
59
- | Slider | [FORMS.md](FORMS.md) | Shared; promotion pending |
60
- | Spinner | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
61
- | Stat | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
62
- | Stepper | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
63
- | Switch | [FORMS.md](FORMS.md) | Shared; promotion pending |
64
- | Table | [RECIPES.md](RECIPES.md) | New component contract covered |
65
- | Tabs | [COMPOSITION.md](COMPOSITION.md) | Shared; promotion pending |
66
- | Tag | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
67
- | TextArea | [FORMS.md](FORMS.md) | Shared; promotion pending |
68
- | TextField | [FORMS.md](FORMS.md) | Shared; promotion pending |
69
- | ThemeScope | [GETTING-STARTED.md](GETTING-STARTED.md) | Shared; promotion pending |
70
- | ThemeToggle | [GETTING-STARTED.md](GETTING-STARTED.md) | Shared; promotion pending |
71
- | TiltCard | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
72
- | Timeline | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
73
- | ToastProvider | [PUBLIC-API.md](PUBLIC-API.md) | Shared; promotion pending |
74
- | Tooltip | [OVERLAYS.md](OVERLAYS.md) | Shared; promotion pending |
19
+ | Component | Public reference | Coverage |
20
+ | --- | --- | --- |
21
+ | Alert | [Component guide](COMPONENT-GUIDES.md#alert) | Authored public contract; catalogue release is separate |
22
+ | Avatar | [Component guide](COMPONENT-GUIDES.md#avatar) | Authored public contract; catalogue release is separate |
23
+ | Badge | [Component guide](COMPONENT-GUIDES.md#badge) | Authored public contract; catalogue release is separate |
24
+ | BrandMark | [Component guide](COMPONENT-GUIDES.md#brandmark) | Authored public contract; catalogue release is separate |
25
+ | Breadcrumbs | [Component guide](COMPONENT-GUIDES.md#breadcrumbs) | Authored public contract; catalogue release is separate |
26
+ | Button | [Component guide](COMPONENT-GUIDES.md#button) | Authored public contract; catalogue release is separate |
27
+ | Card | [Component guide](COMPONENT-GUIDES.md#card) | Authored public contract; catalogue release is separate |
28
+ | Checkbox | [Component guide](COMPONENT-GUIDES.md#checkbox) | Authored public contract; catalogue release is separate |
29
+ | Combobox | [Component guide](COMPONENT-GUIDES.md#combobox) | Authored public contract; catalogue release is separate |
30
+ | CountUp | [Component guide](COMPONENT-GUIDES.md#countup) | Authored public contract; catalogue release is separate |
31
+ | DataTable | [Component guide](COMPONENT-GUIDES.md#datatable) | Authored public contract; catalogue release is separate |
32
+ | DepthButton | [Component guide](COMPONENT-GUIDES.md#depthbutton) | Authored public contract; catalogue release is separate |
33
+ | Dialog | [Component guide](COMPONENT-GUIDES.md#dialog) | Authored public contract; catalogue release is separate |
34
+ | Disclosure | [Component guide](COMPONENT-GUIDES.md#disclosure) | Authored public contract; catalogue release is separate |
35
+ | Divider | [Component guide](COMPONENT-GUIDES.md#divider) | Authored public contract; catalogue release is separate |
36
+ | DropdownMenu | [Component guide](COMPONENT-GUIDES.md#dropdownmenu) | Authored public contract; catalogue release is separate |
37
+ | EmptyState | [Component guide](COMPONENT-GUIDES.md#emptystate) | Authored public contract; catalogue release is separate |
38
+ | ExternalLink | [Component guide](COMPONENT-GUIDES.md#externallink) | Authored public contract; catalogue release is separate |
39
+ | Field | [Component guide](COMPONENT-GUIDES.md#field) | Authored public contract; catalogue release is separate |
40
+ | FlipCard | [Component guide](COMPONENT-GUIDES.md#flipcard) | Authored public contract; catalogue release is separate |
41
+ | GitHubIcon | [Component guide](COMPONENT-GUIDES.md#githubicon) | Authored public contract; catalogue release is separate |
42
+ | IconButton | [Component guide](COMPONENT-GUIDES.md#iconbutton) | Authored public contract; catalogue release is separate |
43
+ | Kbd | [Component guide](COMPONENT-GUIDES.md#kbd) | Authored public contract; catalogue release is separate |
44
+ | LinkedInIcon | [Component guide](COMPONENT-GUIDES.md#linkedinicon) | Authored public contract; catalogue release is separate |
45
+ | Magnetic | [Component guide](COMPONENT-GUIDES.md#magnetic) | Authored public contract; catalogue release is separate |
46
+ | Marquee | [Component guide](COMPONENT-GUIDES.md#marquee) | Authored public contract; catalogue release is separate |
47
+ | Pagination | [Component guide](COMPONENT-GUIDES.md#pagination) | Authored public contract; catalogue release is separate |
48
+ | Popover | [Component guide](COMPONENT-GUIDES.md#popover) | Authored public contract; catalogue release is separate |
49
+ | ProgressBar | [Component guide](COMPONENT-GUIDES.md#progressbar) | Authored public contract; catalogue release is separate |
50
+ | RadioGroup | [Component guide](COMPONENT-GUIDES.md#radiogroup) | Authored public contract; catalogue release is separate |
51
+ | Reveal | [Component guide](COMPONENT-GUIDES.md#reveal) | Authored public contract; catalogue release is separate |
52
+ | RevealHeading | [Component guide](COMPONENT-GUIDES.md#revealheading) | Authored public contract; catalogue release is separate |
53
+ | SceneBoundary | [Component guide](COMPONENT-GUIDES.md#sceneboundary) | Authored public contract; catalogue release is separate |
54
+ | ScrollProgress | [Component guide](COMPONENT-GUIDES.md#scrollprogress) | Authored public contract; catalogue release is separate |
55
+ | SectionLabel | [Component guide](COMPONENT-GUIDES.md#sectionlabel) | Authored public contract; catalogue release is separate |
56
+ | SegmentedControl | [Component guide](COMPONENT-GUIDES.md#segmentedcontrol) | Authored public contract; catalogue release is separate |
57
+ | SelectField | [Component guide](COMPONENT-GUIDES.md#selectfield) | Authored public contract; catalogue release is separate |
58
+ | Skeleton | [Component guide](COMPONENT-GUIDES.md#skeleton) | Authored public contract; catalogue release is separate |
59
+ | Slider | [Component guide](COMPONENT-GUIDES.md#slider) | Authored public contract; catalogue release is separate |
60
+ | Spinner | [Component guide](COMPONENT-GUIDES.md#spinner) | Authored public contract; catalogue release is separate |
61
+ | Stat | [Component guide](COMPONENT-GUIDES.md#stat) | Authored public contract; catalogue release is separate |
62
+ | Stepper | [Component guide](COMPONENT-GUIDES.md#stepper) | Authored public contract; catalogue release is separate |
63
+ | Switch | [Component guide](COMPONENT-GUIDES.md#switch) | Authored public contract; catalogue release is separate |
64
+ | Table | [Component guide](COMPONENT-GUIDES.md#table) | Authored public contract; catalogue release is separate |
65
+ | Tabs | [Component guide](COMPONENT-GUIDES.md#tabs) | Authored public contract; catalogue release is separate |
66
+ | Tag | [Component guide](COMPONENT-GUIDES.md#tag) | Authored public contract; catalogue release is separate |
67
+ | TextArea | [Component guide](COMPONENT-GUIDES.md#textarea) | Authored public contract; catalogue release is separate |
68
+ | TextField | [Component guide](COMPONENT-GUIDES.md#textfield) | Authored public contract; catalogue release is separate |
69
+ | ThemeScope | [Component guide](COMPONENT-GUIDES.md#themescope) | Authored public contract; catalogue release is separate |
70
+ | ThemeToggle | [Component guide](COMPONENT-GUIDES.md#themetoggle) | Authored public contract; catalogue release is separate |
71
+ | TiltCard | [Component guide](COMPONENT-GUIDES.md#tiltcard) | Authored public contract; catalogue release is separate |
72
+ | Timeline | [Component guide](COMPONENT-GUIDES.md#timeline) | Authored public contract; catalogue release is separate |
73
+ | ToastProvider | [Component guide](COMPONENT-GUIDES.md#toastprovider) | Authored public contract; catalogue release is separate |
74
+ | Tooltip | [Component guide](COMPONENT-GUIDES.md#tooltip) | Authored public contract; catalogue release is separate |
75
75
 
76
76
  <!-- component-coverage:end -->
77
77
 
78
- ## Remaining promotion work
78
+ ## Authored guide and catalogue scope
79
79
 
80
- The original website per-component pages, search/pattern discovery, legacy URL preservation, full website prop-page generation and versioned website archives remain separate work. A bounded emitted-declaration prototype and drift gate now live in PROP-REFERENCE.md and docs/prop-metadata.json; REFERENCE.md maps all symbols and style/data paths. Existing shared guides must be audited against this contract before each component is promoted. Manual screen-reader/physical device evidence is tracked separately from automated fixture results. This register deliberately leaves those gaps visible.
80
+ All 54 existing core components have an authored public contract in COMPONENT-GUIDES.md, maintained from docs/component-guides.json. Each links an exact executable TSX family under examples/catalogue. Props/defaults/overloads, purpose, anatomy, state, native forms/ref, keyboard, styling, edge states, localization and explicit limits are checked independently of export discovery. The private catalogue consumes its own exact published package; a new source guide does not silently update that website. Optional scene exports retain THREE.md. Manual screen-reader, physical device and outside developer results are still separate evidence gates, not completed by these pages.
81
81
 
82
82
  ## Library reference work
83
83
 
84
- [HOOKS.md](HOOKS.md), [HELPERS.md](HELPERS.md) and [THREE.md](THREE.md) document non-component contracts and lifecycle ownership. [PROP-REFERENCE.md](PROP-REFERENCE.md) audits the nine historical guides and explains generated versus authored metadata. [MIGRATION.md](MIGRATION.md) preserves version-specific contracts and upgrade/rollback steps; [MODELS.md](MODELS.md) distinguishes package/source/company documentation models. [SUPPORT.md](SUPPORT.md) records automated/manual results and failures. Full PAGE website promotion remains separate.
84
+ [HOOKS.md](HOOKS.md), [HELPERS.md](HELPERS.md) and [THREE.md](THREE.md) document non-component contracts and lifecycle ownership. [PROP-REFERENCE.md](PROP-REFERENCE.md) audits the nine historical guides and explains generated versus authored metadata. [MIGRATION.md](MIGRATION.md) preserves version-specific contracts and upgrade/rollback steps; [MODELS.md](MODELS.md) distinguishes package/source/company documentation models. [SUPPORT.md](SUPPORT.md) records automated/manual results and failures. Catalogue delivery follows an explicit compatible release and actual consumer checks.
85
85
 
86
86
  JavaScript and TypeScript onboarding use the same source contract: scripts/build-onboarding.mjs strips types into the shipped JSX example and check:onboarding detects drift. The examples are copied from the actual archive for strict TS/build checks and exercised as independent browser journeys. No private workspace guidance is required to consume them.
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.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 Forms 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Forms&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
98
+ 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 Forms 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Forms&version=0.6.3), 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
1
+ # Adopt Contour — 0.6.3
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.1
8
+ npm install --save-exact @abuzareal/contour-ui@0.6.3
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.
@@ -60,7 +60,7 @@ Copy [OptionalSmoothScroll.tsx](examples/optional/OptionalSmoothScroll.tsx) and
60
60
 
61
61
  Supported evidence names the exact pair: Next 16.4.0 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.2%3A%20&component=Integration&version=0.6.2) contains version/component, not private data. Report only synthetic records and public reproducible source. [Documentation coverage and limits](DOCS.md).
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.3%3A%20&component=Integration&version=0.6.3) 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.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 Helpers 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Helpers&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
33
+ 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 Helpers 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Helpers&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.
package/HOOKS.md CHANGED
@@ -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.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 Hooks 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Hooks&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
67
+ 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 Hooks 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Hooks&version=0.6.3), 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.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 Manual accessibility 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Manual%20accessibility&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
38
+ 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 Manual accessibility 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Manual%20accessibility&version=0.6.3), 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.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 Migration 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Migration&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
44
+ 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 Migration 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Migration&version=0.6.3), 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.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 Library models 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Library%20models&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
18
+ 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 Library models 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Library%20models&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.
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.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 Overlays 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Overlays&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
58
+ 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 Overlays 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Overlays&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.
package/PROP-REFERENCE.md CHANGED
@@ -4,9 +4,9 @@ The installed package's `.d.ts` files are the full typed API. [PUBLIC-API.md](PU
4
4
 
5
5
  ## Generated metadata
6
6
 
7
- [docs/prop-metadata.json](docs/prop-metadata.json) is extracted from emitted declarations for Checkbox, SelectField, ProgressBar, TextField, TextArea, Dialog, Tabs, ToastProvider, DropdownMenu, Combobox and Table. It preserves all call signatures, authored/inherited prop names and selected prop types/required flags. Source destructuring initializers supply explicit defaults; missing initializer is not evidence of false, empty string or a browser default. Dependent expressions remain expressions, not evaluated promises. Generic/inherited React types may be verbose; read their emitted declaration for the complete context.
7
+ [docs/prop-metadata.json](docs/prop-metadata.json) is extracted for all 56 existing component exports across core and the optional scene entry. It preserves all call and construct signatures, authored/inherited prop names and selected prop types/required flags. Source destructuring initializers supply explicit defaults; missing initializer is not evidence of false, empty string or a browser default. Dependent expressions remain expressions, not evaluated promises. Generic/inherited React types may be verbose; read their emitted declaration for the complete context.
8
8
 
9
- Run `npm run check:reference` after build. It fails on removed documented props, changed types/defaults, reference targets and stale generated metadata. `node scripts/check-reference.mjs --write` updates only after reviewing the change. Human behavior, anatomy, form ownership, accessibility and unsupported combinations remain authored. This bounded generator avoids inventing defaults from optional TypeScript properties or flattening an overloaded component into a misleading universal schema. Other component pages remain PAGE promotion work; type discovery is not full-page coverage.
9
+ Run `npm run check:reference` after build. It fails on removed documented props, changed types/defaults, reference targets and stale generated metadata. `node scripts/check-reference.mjs --write` updates only after reviewing the change. Human behavior, anatomy, form ownership, accessibility and unsupported combinations remain authored. The generator avoids inventing defaults from optional TypeScript properties or flattening an overloaded component into a misleading universal schema. Authored behavior for all 54 core component pages lives in COMPONENT-GUIDES.md and docs/component-guides.json; type discovery alone is never full-page coverage. SceneBoundary retains its class constructor rather than inventing a function signature; zero-prop displays stay zero-prop.
10
10
 
11
11
  ## Nine existing guides: current contract differences
12
12
 
@@ -24,7 +24,7 @@ The catalogue has its own installed release. Its older release-labelled guides m
24
24
  | ToastProvider | Children plus translated region/dismiss labels. useToast().show requires provider; latest3 queue, polite region,5s timeout with hover/focus pause. No command ID/update/undo/durable inbox. HOOKS.md. |
25
25
  | DropdownMenu | Native trigger props/ref and one custom ref-forwarding button via renderTrigger; controlled/default state, stable item IDs and disabled choices. Portal/collision/native-dialog integration supersedes old local-only geometry; no general submenus. OVERLAYS.md. |
26
26
 
27
- The historical nine-guide audit compares the old installed declarations with the current implementation, rather than overwriting older limits. Guide URLs/search and catalogue composition remain deferred. The public component-page contract in DOCS.md still applies before promoting a full page; a row here is a focused audit record, not a claim that every PAGE acceptance item is finished.
27
+ The historical nine-guide audit compares the old installed declarations with the current implementation, rather than overwriting older limits. Catalogue delivery and composition follow an explicit published release and consumer verification. The public component-page contract in DOCS.md still applies before promoting a full page; a row here is a focused audit record, not a claim that every PAGE acceptance item is finished.
28
28
 
29
29
  ## Forms, anatomy and states
30
30
 
@@ -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.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 Prop reference 0.6.2](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Prop%20reference&version=0.6.2), using the [public minimal reproduction](examples/reproduction) and synthetic data.
37
+ 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 Prop reference 0.6.3](https://github.com/abuzareal/contour-ui/issues/new?template=bug_report.yml&component=Prop%20reference&version=0.6.3), using the [public minimal reproduction](examples/reproduction) and synthetic data.