@cognitap/radiant 0.0.2 → 0.0.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 (190) hide show
  1. package/CHANGELOG.md +315 -0
  2. package/README.md +939 -28
  3. package/dist/library/Accordion.d.ts +56 -0
  4. package/dist/library/Accordion.d.ts.map +1 -0
  5. package/dist/library/Accordion.js +89 -0
  6. package/dist/library/Accordion.js.map +1 -0
  7. package/dist/library/Button.d.ts +25 -3
  8. package/dist/library/Button.d.ts.map +1 -1
  9. package/dist/library/Button.js +31 -3
  10. package/dist/library/Button.js.map +1 -1
  11. package/dist/library/Card.d.ts +31 -0
  12. package/dist/library/Card.d.ts.map +1 -0
  13. package/dist/library/Card.js +69 -0
  14. package/dist/library/Card.js.map +1 -0
  15. package/dist/library/Checkbox.d.ts +13 -0
  16. package/dist/library/Checkbox.d.ts.map +1 -0
  17. package/dist/library/Checkbox.js +77 -0
  18. package/dist/library/Checkbox.js.map +1 -0
  19. package/dist/library/Collapsible.d.ts +32 -0
  20. package/dist/library/Collapsible.d.ts.map +1 -0
  21. package/dist/library/Collapsible.js +99 -0
  22. package/dist/library/Collapsible.js.map +1 -0
  23. package/dist/library/Dialog.d.ts +50 -0
  24. package/dist/library/Dialog.d.ts.map +1 -0
  25. package/dist/library/Dialog.js +215 -0
  26. package/dist/library/Dialog.js.map +1 -0
  27. package/dist/library/Field.d.ts +68 -0
  28. package/dist/library/Field.d.ts.map +1 -0
  29. package/dist/library/Field.js +114 -0
  30. package/dist/library/Field.js.map +1 -0
  31. package/dist/library/Input.d.ts +10 -0
  32. package/dist/library/Input.d.ts.map +1 -0
  33. package/dist/library/Input.js +51 -0
  34. package/dist/library/Input.js.map +1 -0
  35. package/dist/library/Link.d.ts +27 -0
  36. package/dist/library/Link.d.ts.map +1 -0
  37. package/dist/library/Link.js +50 -0
  38. package/dist/library/Link.js.map +1 -0
  39. package/dist/library/RadioGroup.d.ts +27 -0
  40. package/dist/library/RadioGroup.d.ts.map +1 -0
  41. package/dist/library/RadioGroup.js +103 -0
  42. package/dist/library/RadioGroup.js.map +1 -0
  43. package/dist/library/ThemeScope.d.ts +10 -0
  44. package/dist/library/ThemeScope.d.ts.map +1 -0
  45. package/dist/library/ThemeScope.js +41 -0
  46. package/dist/library/ThemeScope.js.map +1 -0
  47. package/dist/library/actionStyles.d.ts +11 -0
  48. package/dist/library/actionStyles.d.ts.map +1 -0
  49. package/dist/library/actionStyles.js +75 -0
  50. package/dist/library/actionStyles.js.map +1 -0
  51. package/dist/library/cn.d.ts +1 -2
  52. package/dist/library/cn.d.ts.map +1 -1
  53. package/dist/library/cn.js +1 -8
  54. package/dist/library/cn.js.map +1 -1
  55. package/dist/library/controlStyles.d.ts +5 -0
  56. package/dist/library/controlStyles.d.ts.map +1 -0
  57. package/dist/library/controlStyles.js +15 -0
  58. package/dist/library/controlStyles.js.map +1 -0
  59. package/dist/library/index.d.ts +24 -1
  60. package/dist/library/index.d.ts.map +1 -1
  61. package/dist/library/index.js +11 -0
  62. package/dist/library/index.js.map +1 -1
  63. package/dist/library/internal/events.d.ts +8 -0
  64. package/dist/library/internal/events.d.ts.map +1 -0
  65. package/dist/library/internal/events.js +13 -0
  66. package/dist/library/internal/events.js.map +1 -0
  67. package/dist/library/internal/ids.d.ts +3 -0
  68. package/dist/library/internal/ids.d.ts.map +1 -0
  69. package/dist/library/internal/ids.js +6 -0
  70. package/dist/library/internal/ids.js.map +1 -0
  71. package/dist/library/internal/selection.d.ts +5 -0
  72. package/dist/library/internal/selection.d.ts.map +1 -0
  73. package/dist/library/internal/selection.js +18 -0
  74. package/dist/library/internal/selection.js.map +1 -0
  75. package/dist/library/presentation.d.ts +18 -0
  76. package/dist/library/presentation.d.ts.map +1 -0
  77. package/dist/library/presentation.js +2 -0
  78. package/dist/library/presentation.js.map +1 -0
  79. package/dist/library/react/useComposedRefs.d.ts +4 -0
  80. package/dist/library/react/useComposedRefs.d.ts.map +1 -0
  81. package/dist/library/react/useComposedRefs.js +28 -0
  82. package/dist/library/react/useComposedRefs.js.map +1 -0
  83. package/dist/library/react/useControllableState.d.ts +16 -0
  84. package/dist/library/react/useControllableState.d.ts.map +1 -0
  85. package/dist/library/react/useControllableState.js +29 -0
  86. package/dist/library/react/useControllableState.js.map +1 -0
  87. package/dist/library/react/useNativeOwner.d.ts +17 -0
  88. package/dist/library/react/useNativeOwner.d.ts.map +1 -0
  89. package/dist/library/react/useNativeOwner.js +17 -0
  90. package/dist/library/react/useNativeOwner.js.map +1 -0
  91. package/dist/library/reset.css +1 -0
  92. package/dist/library/styles.css +2 -1
  93. package/dist/library/themes/components.d.ts +217 -0
  94. package/dist/library/themes/components.d.ts.map +1 -0
  95. package/dist/library/themes/components.js +229 -0
  96. package/dist/library/themes/components.js.map +1 -0
  97. package/dist/library/themes/default.d.ts +2 -0
  98. package/dist/library/themes/default.d.ts.map +1 -0
  99. package/dist/library/themes/default.js +4 -0
  100. package/dist/library/themes/default.js.map +1 -0
  101. package/dist/library/themes/defineTheme.d.ts +33 -0
  102. package/dist/library/themes/defineTheme.d.ts.map +1 -0
  103. package/dist/library/themes/defineTheme.js +98 -0
  104. package/dist/library/themes/defineTheme.js.map +1 -0
  105. package/dist/library/themes/expressive.d.ts +2 -0
  106. package/dist/library/themes/expressive.d.ts.map +1 -0
  107. package/dist/library/themes/expressive.js +132 -0
  108. package/dist/library/themes/expressive.js.map +1 -0
  109. package/dist/library/themes/glass.d.ts +2 -0
  110. package/dist/library/themes/glass.d.ts.map +1 -0
  111. package/dist/library/themes/glass.js +132 -0
  112. package/dist/library/themes/glass.js.map +1 -0
  113. package/dist/library/themes/index.d.ts +14 -0
  114. package/dist/library/themes/index.d.ts.map +1 -0
  115. package/dist/library/themes/index.js +21 -0
  116. package/dist/library/themes/index.js.map +1 -0
  117. package/dist/library/themes/jelly.d.ts +2 -0
  118. package/dist/library/themes/jelly.d.ts.map +1 -0
  119. package/dist/library/themes/jelly.js +130 -0
  120. package/dist/library/themes/jelly.js.map +1 -0
  121. package/dist/library/themes/preset-values.d.ts +4 -0
  122. package/dist/library/themes/preset-values.d.ts.map +1 -0
  123. package/dist/library/themes/preset-values.js +5 -0
  124. package/dist/library/themes/preset-values.js.map +1 -0
  125. package/dist/library/themes/radiant.d.ts +2 -0
  126. package/dist/library/themes/radiant.d.ts.map +1 -0
  127. package/dist/library/themes/radiant.js +129 -0
  128. package/dist/library/themes/radiant.js.map +1 -0
  129. package/dist/library/themes/sharp-3d.d.ts +2 -0
  130. package/dist/library/themes/sharp-3d.d.ts.map +1 -0
  131. package/dist/library/themes/sharp-3d.js +142 -0
  132. package/dist/library/themes/sharp-3d.js.map +1 -0
  133. package/dist/library/themes/soft-squircle.d.ts +2 -0
  134. package/dist/library/themes/soft-squircle.d.ts.map +1 -0
  135. package/dist/library/themes/soft-squircle.js +131 -0
  136. package/dist/library/themes/soft-squircle.js.map +1 -0
  137. package/dist/library/themes/ticket.d.ts +2 -0
  138. package/dist/library/themes/ticket.d.ts.map +1 -0
  139. package/dist/library/themes/ticket.js +141 -0
  140. package/dist/library/themes/ticket.js.map +1 -0
  141. package/dist/library/themes/tokens.d.ts +100 -0
  142. package/dist/library/themes/tokens.d.ts.map +1 -0
  143. package/dist/library/themes/tokens.js +171 -0
  144. package/dist/library/themes/tokens.js.map +1 -0
  145. package/dist/library/themes/types.d.ts +2 -0
  146. package/dist/library/themes/types.d.ts.map +1 -0
  147. package/dist/library/themes/types.js +2 -0
  148. package/dist/library/themes/types.js.map +1 -0
  149. package/docs/accessibility.md +189 -0
  150. package/docs/system.md +218 -0
  151. package/docs/theming.md +392 -0
  152. package/package.json +26 -9
  153. package/src/Accordion.tsx +235 -0
  154. package/src/Button.tsx +95 -15
  155. package/src/Card.tsx +143 -0
  156. package/src/Checkbox.tsx +189 -0
  157. package/src/Collapsible.tsx +193 -0
  158. package/src/Dialog.tsx +333 -0
  159. package/src/Field.tsx +293 -0
  160. package/src/Input.tsx +82 -0
  161. package/src/Link.tsx +95 -0
  162. package/src/RadioGroup.tsx +255 -0
  163. package/src/ThemeScope.tsx +64 -0
  164. package/src/actionStyles.ts +90 -0
  165. package/src/cn.ts +1 -10
  166. package/src/controlStyles.ts +19 -0
  167. package/src/index.ts +93 -1
  168. package/src/internal/events.ts +17 -0
  169. package/src/internal/ids.ts +5 -0
  170. package/src/internal/selection.ts +20 -0
  171. package/src/presentation.ts +12 -0
  172. package/src/react/useComposedRefs.ts +32 -0
  173. package/src/react/useControllableState.ts +50 -0
  174. package/src/react/useNativeOwner.ts +33 -0
  175. package/src/styles.css +2 -14
  176. package/src/themes/baseline.css +116 -0
  177. package/src/themes/components.ts +249 -0
  178. package/src/themes/default.ts +4 -0
  179. package/src/themes/defineTheme.ts +145 -0
  180. package/src/themes/expressive.ts +132 -0
  181. package/src/themes/glass.ts +135 -0
  182. package/src/themes/index.ts +33 -0
  183. package/src/themes/jelly.ts +130 -0
  184. package/src/themes/preset-values.ts +5 -0
  185. package/src/themes/radiant.ts +129 -0
  186. package/src/themes/sharp-3d.ts +142 -0
  187. package/src/themes/soft-squircle.ts +131 -0
  188. package/src/themes/ticket.ts +141 -0
  189. package/src/themes/tokens.ts +262 -0
  190. package/src/themes/types.ts +10 -0
package/CHANGELOG.md CHANGED
@@ -4,6 +4,321 @@ See the [release policy](RELEASE_POLICY.md) for versioning and migration rules.
4
4
 
5
5
  ## Unreleased
6
6
 
7
+ ## 0.0.3
8
+
9
+ Experimental release of the harmonised ten-family system. **Breaking changes**
10
+ to component props, composition and theme interfaces are detailed below, with
11
+ migration guidance in `docs/system.md` and `docs/theming.md`. Version 0.0.3 is
12
+ explicitly selected for this experimental release. Automated installed-consumer
13
+ checks cover native/TanStack flows; actual VoiceOver verification is deferred
14
+ and is not claimed by this release.
15
+
16
+ - Verify the canonical native/TanStack forms and ten-family Workspace composition
17
+ through an installed production archive (DEV-57), including hydration, native
18
+ keyboard/form/reset behavior and modal cleanup. Add an opt-in Cognitap
19
+ production checkpoint that preserves its registry pins and distinguishes the
20
+ historical Button-only package from unreleased archive evidence. Actual AT
21
+ verification remains explicitly pending; these checks do not publish a release.
22
+
23
+ - Verify installed styling artifacts through production builds (DEV-135):
24
+ compiled CSS and Tailwind, with both reset choices, across all eight presets
25
+ in light/dark. The required gate now retains versioned results and captures.
26
+ - Preserve complete CSS layer order in both compiled exports so consumer
27
+ bundling cannot put Preflight above component utilities. Action-shaped Links
28
+ explicitly remove native underlining without depending on a global reset.
29
+ - Let caller `hover:`/`active:` color utilities replace the shared action defaults,
30
+ while explicit disabled/busy backgrounds preserve paint guards.
31
+
32
+ - Audit the ten-family harmonisation coverage (DEV-134), adding focused rendered
33
+ scope and reduced-motion/forced-colors browser checks. Record the required gate
34
+ and explicit manual/browser/artifact gaps without expanding support claims.
35
+
36
+ - Publish the browser/assistive-technology target matrix and evidence process
37
+ (DEV-47), including manual scenarios, WCAG 2.2 A/AA mapping and explicit gaps.
38
+ Browser runs now capture exact environment versions with their existing
39
+ result artifacts. This does not declare untested browser/screen-reader support.
40
+
41
+ - Add the concise Radiant system guide (DEV-133), shipped with the package and
42
+ linked from introductory, theming, Storybook and agent documentation. It covers
43
+ the current ten-family contract and points to canonical live recipes; the
44
+ original harmonisation sketches remain labelled as historical design evidence.
45
+
46
+ - **Breaking: remove superseded theme paths (DEV-132).** Remove all ten family
47
+ `*Theme()` helpers and their corresponding type aliases, `radiantTheme`, and
48
+ the resolved `Theme.style`/`Theme.surface` compatibility fields. Author shared
49
+ themes with `defineTheme`, apply them with `ThemeScope`, and use
50
+ `ThemeComponentOverrides` for reusable exceptions or `ThemeStyle` for local
51
+ `--rad-*` styles. The old Radio gap shortcut moves to `components.radioGroup.gap`.
52
+ - Remove unused unprefixed Tailwind color/radius aliases and ambient
53
+ `--ease-spring`, `--ease-snap`, `--ease-settle` variables. Use prefixed roles
54
+ directly and define literal motion curves or application-owned variables.
55
+ See the [migration steps and cleanup inventory](docs/theming.md#migration-from-button-centred-themes).
56
+ Preset mode values, native composition and shared action styling are preserved.
57
+ Button/Link local styles now accept typed CSS custom properties directly.
58
+
59
+ Earlier entries below record behavior at delivery time; DEV-132 supersedes their
60
+ compatibility-export and ambient-token availability notes.
61
+
62
+ - **Button-owned host replacement (DEV-119).** Button now accepts
63
+ `render(resolvedNativeProps)` and exports ButtonRenderProps. DialogTrigger/Close
64
+ inherit ButtonProps and compose Button in both default and replacement paths.
65
+ Button owns resolved presentation and compatible-host validation.
66
+ - **Breaking: Dialog action replacement contract (DEV-119).** `render` now
67
+ receives Button's resolved native presentation, including merged classes,
68
+ children/pending markup, native attributes/ref and protected Dialog semantics.
69
+ Set presentation props on DialogTrigger/Close and forward to one native/custom
70
+ button; replace render→Button adapters, which would style and wrap children
71
+ twice. Null, text, arrays, fragments and direct non-button hosts are rejected.
72
+ `DialogRenderProps` exposes required, typed resolved presentation attributes.
73
+ - Both Dialog paths compose Button; guards run before the consumer once and
74
+ then uncancelled Dialog requests. Pending busy state and computed presentation attributes are protected;
75
+ composed actions retain both Button and Dialog part identities.
76
+
77
+ - **Breaking: Link replacement contract (DEV-118).** `render` returns one
78
+ compatible `ReactElement`; null, text, arrays, fragments and direct native
79
+ hosts other than anchors are rejected. Return your router element directly
80
+ and forward its resolved native props to one anchor. `LinkRenderProps` now
81
+ exposes the real anchor ref and required, typed resolved presentation attributes.
82
+ - Link protects its computed identity and presentation attributes from caller
83
+ overrides. Native handlers/attributes/ref and merged presentation reach
84
+ default and router anchors unchanged, including React callback-ref cleanup.
85
+ - Real Chromium checks cover Link click/Enter/Space, form behaviour, consumer
86
+ cancellation, router interception, modified/middle-click tabs, external
87
+ targets and downloads in Light/Dark. Storybook's router example now performs
88
+ visible navigation and verifies it under every theme/mode.
89
+
90
+ - **Breaking: action presentation API (DEV-117).** Button and action-shaped
91
+ Link use `variant="solid|soft|outline|ghost"`, `tone="accent|neutral|warning|danger"`
92
+ and `controlSize="small|medium|large"`. Button defaults to solid/accent/medium;
93
+ Link defaults to inline/accent/medium and also retains subtle decoration.
94
+ Dialog actions inherit these props. `size`, `radius`, Link's `button` variant,
95
+ and the old colour-named variants/tones are removed. Replace `ButtonSize` with
96
+ `ControlSize`; remove `ButtonRadius` and use theme/local CSS. `ButtonVariant`
97
+ and `LinkVariant` reflect the new vocabulary; `Tone` is a shared export.
98
+ Selectors migrate from `data-size` to `data-control-size`, with `data-tone`
99
+ recording palette independently. See the README's action migration table.
100
+ - Soft actions support all four tones; unfilled action/text-link ink derives
101
+ from the selected palette and scope foreground. Neutral soft/outline/ghost
102
+ preserve the previous neutral palette. The private shared recipe retains
103
+ theme shape, motion, focus and elevation for both native buttons and anchors.
104
+ - Storybook controls and examples use the new API. Button's treatment/tone and
105
+ size comparisons verify matching Link presentation across every theme/mode;
106
+ inline/subtle links have a corresponding tone comparison.
107
+
108
+ - Shared private React bindings now preserve composed callback-ref cleanup,
109
+ deduplicate owned/external description IDs and apply one cancellable activation
110
+ order. Disabled Accordion activation guards run before consumer handlers.
111
+ - Dialog, Collapsible and Accordion share state ownership and no-op suppression.
112
+ Composite defaults remain initial snapshots; prop synchronisation/restoration
113
+ no longer emit semantic change requests. Ownership/type switches and supplying
114
+ a controlled value together with its default now throw a descriptive error;
115
+ remount with a new key for a new owner/type.
116
+ - An open Dialog now responds to changes in `modal` and preserves cleanup when
117
+ rendered in another document. Interactive/context modules retain individual
118
+ client boundaries; the package entry and pure modules remain server-safe.
119
+ - Storybook plays and axe now run as a required part of `pnpm check` and CI,
120
+ across every preset in Light and Dark. Native Chromium scenarios cover modal
121
+ keyboard/focus, cancellation, refs, StrictMode cleanup and hydration. CI saves
122
+ JUnit results and failure screenshots; see the verification guide.
123
+ - Field groups no longer emit unsupported `aria-required` on fieldsets. Native
124
+ radio `required` behavior is preserved. Disabled Field help/error text remains
125
+ readable while its controls and labels dim once.
126
+ - Dialog ignores a queued native close notification when the same element has
127
+ already reopened, preventing StrictMode effect cleanup from dismissing it.
128
+ - Storybook paints the real Canvas page background once instead of using a
129
+ pseudo-element, so accessibility checks resolve the same backdrop as viewers.
130
+ - DialogTrigger and DialogClose now compose Button by default, inheriting its
131
+ presentation options, theme effects, interaction states, and pending behavior.
132
+ The separate Dialog action style recipe is removed. Action slots now include
133
+ both identities (`button dialog-trigger` / `button dialog-close`); migrate
134
+ equality selectors to `[data-slot~="dialog-trigger"]` / `[data-slot~="dialog-close"]`.
135
+ DEV-119 subsequently migrates native render callbacks to resolved presentation.
136
+ - Dialog's default Storybook play compares its actual rendered actions against
137
+ Button. The theme comparison uses default Dialog composition rather than
138
+ manually opting into Button, exposing future drift at the default call site.
139
+ - A complete Storybook audit covers all 58 stories and 11 Docs pages across
140
+ eight themes in light and dark. Form controls have clearer outlines, Checkbox
141
+ keeps a box shape, and disabled checked/mixed marks remain visible, including
142
+ forced colors. Nested disclosure arrows follow their own open state and focus
143
+ rings follow the themed shape. Glass dialogs frost underlying content, and
144
+ Sharp 3D links retain readable hover text. Responsive examples and Docs frames
145
+ avoid clipping; Docs controls follow the selected palette and open dialogs no
146
+ longer scroll the page on load. Demo actions and navigation show useful results.
147
+ - Browser play checks guard disabled selection visibility/alignment and the
148
+ custom native Field input. These complement the theme comparison and now run
149
+ in the required browser matrix.
150
+ - Ticket checkboxes use a compact solid outline instead of inheriting the
151
+ scooped, dashed shape intended for larger controls and surfaces.
152
+ - Button-styled links share Button hover and pressed feedback while retaining
153
+ native anchor navigation. Disabled and pending buttons keep suppressing it.
154
+ - Checkbox check and mixed marks stay aligned with the native control when
155
+ an unlabelled checkbox is placed in a stretched grid or Field.
156
+ - Storybook has global **Theme** and **Mode** controls, backed by the public
157
+ preset registry and `ThemeScope`. Canvas and Docs share the selection.
158
+ Ordinary stories inherit it; one system comparison replaces repeated family
159
+ theme galleries. Stories use a shared default/state/composition/customisation
160
+ structure and public imports.
161
+ - **Breaking: shared theme system (DEV-44).** `defineTheme` now authors typed
162
+ semantic tokens, optional component overrides, and light/dark layers.
163
+ `ThemeScope` applies a theme and independent light/dark/system mode to a
164
+ subtree. The stylesheet supplies a provider-free neutral baseline; nested
165
+ named themes reset omitted tokens and effects. Components consume shared
166
+ roles instead of Button's overrides, and Button focus overrides are local.
167
+ - All eight presets have stable IDs and deliberate light/dark palettes. The
168
+ `themes` registry is readonly; individual presets are exported. Font loading
169
+ remains the application's responsibility, with system fallbacks supplied.
170
+ - Storybook theme frames use `ThemeScope`, keeping canvases, ghost text and
171
+ shadows in the same mode. Sharp 3D retains its explicit hard borders. The
172
+ Button comparison story checks its rendered canvases, palettes and shadows.
173
+ - **Migration:** replace `{ name, style }` themes with `defineTheme` and
174
+ `theme.style` wrappers with `ThemeScope`. `Theme.style`, `Theme.surface`, and
175
+ `radiantTheme` remain deprecated compatibility exports. Family theme helpers
176
+ remain available but emit `--rad-<family>-*` variables; direct old CSS
177
+ overrides must migrate. Shared primary/secondary/destructive roles become
178
+ accent/neutral/danger. `radio.gap` moves to `radioGroup.gap`; inert
179
+ `glowHover` is rejected by the new theme API. See the
180
+ [theming guide](docs/theming.md) for defaults and the complete migration.
181
+
182
+ Earlier batch entries below record behavior at delivery time; the theme
183
+ migration above supersedes their token names and baseline measurements.
184
+
185
+ - `Card` is a grouped surface. It is a `<div>`, not a button, link, or region.
186
+ The title is a level-2 heading unless `level` says otherwise. Actions inside
187
+ the card stay real controls. In Storybook on Chrome 155, the accessibility
188
+ tree exposed the title as a level-2 heading, the description as a paragraph,
189
+ and the footer actions as a button and a link. The card itself had no role.
190
+ The first Tab landed on Track, and the next Tab landed on the Details link.
191
+ Tab on a card with no actions moved to the document body. A consumer
192
+ section labelled by the title was exposed as a region. The Radiant surface
193
+ was 384px wide in a 24rem frame, with an 8px radius, an 18px title at
194
+ weight 550, and a shadow of 0 1px 2px at 6% black. The Ticket surface used
195
+ the scooped corner. The card does not set a transition. Screen reader
196
+ checks were not run.
197
+ - `Accordion` groups `Collapsible` sections. `single` keeps one section open,
198
+ and `multiple` toggles each section on its own. The trigger is the summary,
199
+ and its label is a level-3 heading unless `level` says otherwise. A disabled
200
+ summary stays out of the tab order and does not toggle. In Storybook on
201
+ Chrome 155, the accessibility tree exposed each trigger label as a level-3
202
+ heading. Space and Enter toggled the focused summary and left focus there.
203
+ Tab from a closed summary moved to the next summary. Tab from an open
204
+ summary reached a button in the content. ArrowDown left focus on the summary.
205
+ Opening one section in single mode closed the other. In multiple mode, Enter
206
+ opened a second section and left the first open. Clicking another summary
207
+ while focus was on a button inside the open section closed the first, opened
208
+ the second, and left focus on that summary. Tab skipped a disabled summary.
209
+ Space, Enter, and a click did not open it. Enter on a nested summary left
210
+ the parent section open. A controlled accordion followed `onValueChange`.
211
+ Submitting a form while the section was closed included the hidden field.
212
+ Reduced motion set `transition-property` to `none` on the panel and marker.
213
+ The Radiant surface was 384px wide in a 24rem frame, with an 8px radius.
214
+ The summary focus ring was a 2px solid outline, offset 2px. The Ticket
215
+ surface used the scooped corner. Screen reader checks were not run.
216
+ - `Collapsible` is a native `<details>` element. The summary toggles it, and
217
+ `open` is the browser's open state. Uncontrolled disclosures use
218
+ `defaultOpen`. Controlled disclosures use `open` and `onOpenChange`; if
219
+ `open` stays unchanged, the disclosure restores that value. A shared `name`
220
+ is the native exclusive group. Closed content stays mounted, so a field
221
+ inside it still submits with an ancestor form. The panel height and marker
222
+ animate for 200ms, and `prefers-reduced-motion` sets `transition-property`
223
+ to `none`. In Storybook on Chrome 155, Space and Enter toggled the summary
224
+ and left focus there. Tab reached a button in the content only while open;
225
+ while closed, Tab moved to the document body. Clicking the summary while
226
+ focus was inside the content closed the disclosure and moved focus to the
227
+ summary. Enter on a second disclosure with the same `name` opened it and
228
+ closed the first. Enter on a nested summary left the parent open. A
229
+ controlled disclosure followed `onOpenChange`. Submitting a form while the
230
+ disclosure was closed included the hidden field. The Radiant surface was
231
+ 384px wide in a 24rem frame, with an 8px radius. The Ticket surface used the
232
+ scooped corner. The summary focus ring was a 2px solid outline, offset 2px.
233
+ Screen reader checks were not run.
234
+ - `Dialog` is a native `<dialog>`. `showModal()` supplies the modal layer, so
235
+ the component does not add a portal, a focus trap, or a body scroll lock.
236
+ Uncontrolled dialogs use `defaultOpen`. Controlled dialogs use `open` and
237
+ `onOpenChange`; if `open` stays true after the browser closes, the dialog
238
+ opens again. `closeOnBackdrop` and `closeOnEscape` default to true. A form
239
+ with `method="dialog"` closes it. The panel stays in its document, so an
240
+ ancestor form still owns its fields. `dialogTheme` maps typed settings to
241
+ `--dialog-*` variables, and the panel inherits the button radius and corner
242
+ shape. In Storybook on Chrome 155, the first focusable control was focused,
243
+ and an `autoFocus` field took focus instead. Shift+Tab wrapped from the first
244
+ control to the last. Tab from the last control focused the document body, and
245
+ the next Tab returned to the first control without focusing the trigger.
246
+ Escape closed the top dialog and restored the opener, including a nested
247
+ dialog and a dialog opened without a trigger. A backdrop click closed and
248
+ restored the trigger. Turning backdrop or Escape dismissal off left the
249
+ dialog open. Submitting `method="dialog"` closed it. A field inside the
250
+ dialog submitted with its ancestor form. A wheel and `scrollTo` still moved
251
+ the page behind the open dialog. The Radiant panel was 512px wide with an
252
+ 8px radius, and the Ticket panel used the scooped corner. Screen reader
253
+ checks were not run.
254
+ - `RadioGroup` is a fieldset of native radios. Uncontrolled groups use
255
+ `defaultValue` and `form.reset()`. Controlled groups use `value` and
256
+ `onValueChange` or `onChange`. Each `Radio` keeps its own label. A disabled
257
+ choice stays in the group and is not selected. `radioTheme` maps typed
258
+ settings to `--radio-*` variables. The disk stays a circle instead of
259
+ inheriting the button corner shape. Arrow keys, focus entry, and focus exit
260
+ were checked in Storybook: Tab entered on the selected radio, ArrowDown and
261
+ ArrowUp skipped a disabled choice, and Tab left the group. Screen reader
262
+ checks were not run.
263
+ - `Checkbox` is a native checkbox. Uncontrolled boxes use `defaultChecked` and
264
+ `form.reset()`. Controlled boxes use `checked` and `onChange`. `indeterminate`
265
+ is a visual mixed state on the DOM property, not a submitted value. A `label`
266
+ wraps the input so the text toggles it, and a single-control Field supplies
267
+ the accessible name. `checkboxTheme` maps typed settings to `--checkbox-*`
268
+ variables. Space activation was checked in Storybook. Screen reader checks
269
+ were not run.
270
+ - `Input` is a native text field. Uncontrolled inputs use `defaultValue` and
271
+ `form.reset()`. Controlled inputs use `value` and `onChange`; `onBlur` stays
272
+ the native event. Inside Field it takes the label, description, and error
273
+ relationships. `inputTheme` maps typed settings to `--input-*` variables, which
274
+ fall back to the button metrics. The native `size` attribute stays the
275
+ character width. A plain form and a TanStack Form 1.33.5 reference (value,
276
+ change, blur, reset) were verified. TanStack Form is not a package dependency.
277
+ Keyboard, focus, and screen reader checks were not run.
278
+ - `Field` is the form anatomy for one control or a group. A host control receives
279
+ its label, description, and error relationships; component controls read them
280
+ with `useField()`. The consumer owns the error message. `fieldTheme` maps typed
281
+ settings to `--field-*` variables. Keyboard, focus, and screen reader checks
282
+ were not run. A native form submit was verified.
283
+ - `Link` joins the library: a native anchor for navigation with `inline`,
284
+ `subtle`, and `button` variants (the button form reuses Button's variants via
285
+ `tone`, `size`, and `radius`). `external` adds a safe target and rel when the
286
+ consumer has not set them. A `render` prop hands the anchor props to a router
287
+ adapter, keeping routers outside the core. `linkTheme` maps typed settings to
288
+ `--link-*` variables, and links share the button focus variables and the shared
289
+ themes. Keyboard, focus, and screen reader checks were not run for Link either.
290
+ - Themes moved to a shared `themes` export (with a `Theme` type), so future
291
+ components wear the same design systems. Button stories consume the registry.
292
+ - Button ships with a neutral baseline (sizes, type, an ink-and-gray palette,
293
+ focus ring, quiet press). Every value is a CSS variable, and Storybook shows
294
+ the baseline next to fully themed variants, including the pine Radiant theme.
295
+ - Button's shape, size, type, elevation, state colors, and motion are CSS
296
+ variables. Press and release take separate durations and easings, and the
297
+ radius and `corner-shape` can change on press. `buttonTheme` maps typed settings
298
+ to those variables. Button sets `data-slot`, `data-variant`, and `data-size`.
299
+ - `--ease-spring`, `--ease-snap`, and `--ease-settle` are new easing tokens.
300
+ - Migration: `--color-primary-hover` and `--color-primary-active` are removed.
301
+ Hover and press colors are derived from `--color-primary`. Tune them with
302
+ `--button-hover-layer` and `--button-press-layer`. `--color-disabled` and
303
+ `--color-disabled-foreground` are removed. A disabled button fades to
304
+ `--button-disabled-opacity` when a theme sets it.
305
+ - Button adds `variant` (primary, secondary, warning, destructive, outline,
306
+ ghost), `size` (small, default, large), `radius` (none, small, default, large,
307
+ full), `iconOnly`, and `fullWidth`. New color tokens back each variant.
308
+ - `buttonTheme` adds `fontFamily`, `textTransform`, and `borderStyle`. Each DesignSystems theme
309
+ now sets a matching Google Font, loaded in Storybook. The
310
+ DesignSystems story replaces Midnight and Clay with Jelly (squircle pills,
311
+ deep squishy press, spring release) and Ticket (scooped corners, dashed border).
312
+ - `buttonTheme` adds `borderWidth`, `borderColor`, `pressShiftX`,
313
+ `ghostShadow`, and `ghostShadowPressed`. The
314
+ DesignSystems story adds a Sharp 3D theme with square corners, 2px borders,
315
+ and hard offset shadows.
316
+ - `class-variance-authority` 0.7.1 is a new runtime dependency.
317
+ - `pending` keeps the label's space, shows a spinner, and ignores activation.
318
+ It does not set `disabled`, so focus can stay on the button.
319
+ - Keyboard, focus, and screen reader checks were not run in this change.
320
+ Storybook has no interaction runner yet, and Button is not marked ready.
321
+
7
322
  ## 0.0.2
8
323
 
9
324
  - Documentation and maintainer tooling cleanup. The Button API, styles and