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