@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
@@ -0,0 +1,262 @@
1
+ /** The complete shared-token registry. CSS names are derived from these paths. */
2
+ export interface SharedTokens {
3
+ color: {
4
+ surface: string
5
+ foreground: string
6
+ mutedForeground: string
7
+ border: string
8
+ placeholder: string
9
+ disabledBackground: string
10
+ disabledBorder: string
11
+ invalid: string
12
+ focus: string
13
+ accent: string
14
+ accentForeground: string
15
+ neutral: string
16
+ neutralForeground: string
17
+ warning: string
18
+ warningForeground: string
19
+ danger: string
20
+ dangerForeground: string
21
+ }
22
+ typography: {
23
+ family: string
24
+ bodySize: string
25
+ smallSize: string
26
+ headingSize: string
27
+ bodyWeight: string | number
28
+ labelWeight: string | number
29
+ headingWeight: string | number
30
+ letterSpacing: string
31
+ }
32
+ control: {
33
+ small: ControlMetrics
34
+ medium: ControlMetrics
35
+ large: ControlMetrics
36
+ radius: string
37
+ cornerShape: string
38
+ borderWidth: string
39
+ borderStyle: string
40
+ }
41
+ surface: {
42
+ canvas: string
43
+ radius: string
44
+ cornerShape: string
45
+ borderWidth: string
46
+ borderStyle: string
47
+ padding: string
48
+ gap: string
49
+ shadow: string
50
+ overlayShadow: string
51
+ backdrop: string
52
+ }
53
+ focus: { width: string; offset: string; style: string }
54
+ motion: {
55
+ pressDuration: string
56
+ pressEase: string
57
+ releaseDuration: string
58
+ releaseEase: string
59
+ colorDuration: string
60
+ disclosureDuration: string
61
+ }
62
+ spacing: {
63
+ labelGap: string
64
+ fieldGap: string
65
+ groupGap: string
66
+ headerGap: string
67
+ footerGap: string
68
+ }
69
+ state: { disabledOpacity: number }
70
+ }
71
+
72
+ interface ControlMetrics {
73
+ height: string
74
+ paddingInline: string
75
+ fontSize: string
76
+ indicatorSize: string
77
+ }
78
+
79
+ export type PartialTree<T> = {
80
+ readonly [K in keyof T]?: T[K] extends object ? PartialTree<T[K]> : T[K]
81
+ }
82
+ export type ThemeTokens = PartialTree<SharedTokens>
83
+ export type ThemeVariableValues = Record<`--rad-${string}`, string | number>
84
+
85
+ const light: SharedTokens = {
86
+ color: {
87
+ surface: 'oklch(1 0 0)',
88
+ foreground: 'oklch(0.21 0.006 286)',
89
+ mutedForeground: 'oklch(0.45 0.01 286)',
90
+ border: 'oklch(0.885 0.005 286)',
91
+ placeholder: 'oklch(0.5 0.01 286)',
92
+ disabledBackground: 'oklch(0.96 0.005 286)',
93
+ disabledBorder: 'oklch(0.88 0.005 286)',
94
+ invalid: 'oklch(0.56 0.19 25)',
95
+ focus: 'oklch(0.55 0.13 255)',
96
+ accent: 'oklch(0.21 0.006 286)',
97
+ accentForeground: 'oklch(0.985 0 0)',
98
+ neutral: 'oklch(0.955 0.004 286)',
99
+ neutralForeground: 'oklch(0.21 0.006 286)',
100
+ warning: 'oklch(0.8 0.14 78)',
101
+ warningForeground: 'oklch(0.3 0.07 55)',
102
+ danger: 'oklch(0.56 0.19 25)',
103
+ dangerForeground: 'oklch(0.99 0 0)'
104
+ },
105
+ typography: {
106
+ family: 'system-ui, sans-serif',
107
+ bodySize: '0.875rem',
108
+ smallSize: '0.8125rem',
109
+ headingSize: '1.125rem',
110
+ bodyWeight: 400,
111
+ labelWeight: 550,
112
+ headingWeight: 600,
113
+ letterSpacing: '-0.011em'
114
+ },
115
+ control: {
116
+ small: {
117
+ height: '2rem',
118
+ paddingInline: '0.75rem',
119
+ fontSize: '0.8125rem',
120
+ indicatorSize: '1rem'
121
+ },
122
+ medium: {
123
+ height: '2.5rem',
124
+ paddingInline: '1rem',
125
+ fontSize: '0.875rem',
126
+ indicatorSize: '1.125rem'
127
+ },
128
+ large: {
129
+ height: '3rem',
130
+ paddingInline: '1.375rem',
131
+ fontSize: '0.9375rem',
132
+ indicatorSize: '1.25rem'
133
+ },
134
+ radius: '0.5rem',
135
+ cornerShape: 'round',
136
+ borderWidth: '1px',
137
+ borderStyle: 'solid'
138
+ },
139
+ surface: {
140
+ canvas: 'oklch(1 0 0)',
141
+ radius: '0.75rem',
142
+ cornerShape: 'round',
143
+ borderWidth: '1px',
144
+ borderStyle: 'solid',
145
+ padding: '1.5rem',
146
+ gap: '1rem',
147
+ shadow: '0 1px 2px 0 rgb(0 0 0 / 0.06)',
148
+ overlayShadow: '0 24px 64px -16px rgb(0 0 0 / 0.3)',
149
+ backdrop: 'rgb(0 0 0 / 0.45)'
150
+ },
151
+ focus: { width: '2px', offset: '2px', style: 'solid' },
152
+ motion: {
153
+ pressDuration: '80ms',
154
+ pressEase: 'cubic-bezier(0.3, 0, 0, 1)',
155
+ releaseDuration: '160ms',
156
+ releaseEase: 'cubic-bezier(0.2, 0.8, 0.2, 1)',
157
+ colorDuration: '150ms',
158
+ disclosureDuration: '150ms'
159
+ },
160
+ spacing: {
161
+ labelGap: '0.5rem',
162
+ fieldGap: '0.375rem',
163
+ groupGap: '0.75rem',
164
+ headerGap: '0.375rem',
165
+ footerGap: '0.5rem'
166
+ },
167
+ state: { disabledOpacity: 0.5 }
168
+ }
169
+
170
+ const dark: SharedTokens = {
171
+ ...light,
172
+ color: {
173
+ surface: 'oklch(0.21 0.006 286)',
174
+ foreground: 'oklch(0.985 0 0)',
175
+ mutedForeground: 'oklch(0.75 0.01 286)',
176
+ border: 'oklch(0.4 0.008 286)',
177
+ placeholder: 'oklch(0.7 0.01 286)',
178
+ disabledBackground: 'oklch(0.26 0.006 286)',
179
+ disabledBorder: 'oklch(0.38 0.006 286)',
180
+ invalid: 'oklch(0.75 0.16 25)',
181
+ focus: 'oklch(0.75 0.13 255)',
182
+ accent: 'oklch(0.92 0.005 286)',
183
+ accentForeground: 'oklch(0.21 0.006 286)',
184
+ neutral: 'oklch(0.3 0.006 286)',
185
+ neutralForeground: 'oklch(0.985 0 0)',
186
+ warning: 'oklch(0.8 0.14 78)',
187
+ warningForeground: 'oklch(0.3 0.07 55)',
188
+ danger: 'oklch(0.72 0.17 25)',
189
+ dangerForeground: 'oklch(0.2 0.04 25)'
190
+ },
191
+ surface: {
192
+ ...light.surface,
193
+ canvas: 'oklch(0.16 0.006 286)',
194
+ shadow: '0 1px 2px 0 rgb(0 0 0 / 0.25)',
195
+ overlayShadow: '0 24px 64px -16px rgb(0 0 0 / 0.6)',
196
+ backdrop: 'rgb(0 0 0 / 0.65)'
197
+ }
198
+ }
199
+
200
+ /** Immutable at runtime as well as in declarations: defaults are shared by every theme. */
201
+ export function freezeTree<T extends object>(value: T): Readonly<T> {
202
+ for (const item of Object.values(value)) {
203
+ if (item && typeof item === 'object') freezeTree(item)
204
+ }
205
+ return Object.freeze(value)
206
+ }
207
+
208
+ export const tokenDefaults = freezeTree({ light, dark })
209
+
210
+ export function kebabCase(value: string): string {
211
+ return value.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`)
212
+ }
213
+
214
+ export function flattenTokens(tokens: ThemeTokens): ThemeVariableValues {
215
+ const result: ThemeVariableValues = {}
216
+ function visit(tree: object, path: string[]) {
217
+ for (const [key, value] of Object.entries(tree)) {
218
+ if (value === undefined) continue
219
+ const next = [...path, kebabCase(key)]
220
+ if (typeof value === 'object' && value !== null) visit(value, next)
221
+ else result[`--rad-${next.join('-')}`] = value
222
+ }
223
+ }
224
+ visit(tokens, [])
225
+ return result
226
+ }
227
+
228
+ /** Registry-derived CSS names keyed by canonical dotted authoring paths. */
229
+ function collectTokenVariables(
230
+ tree: object,
231
+ path: string[] = []
232
+ ): Record<string, `--rad-${string}`> {
233
+ const variables: Record<string, `--rad-${string}`> = {}
234
+ for (const [key, value] of Object.entries(tree)) {
235
+ const next = [...path, key]
236
+ if (typeof value === 'object' && value !== null)
237
+ Object.assign(variables, collectTokenVariables(value, next))
238
+ else variables[next.join('.')] = `--rad-${next.map(kebabCase).join('-')}`
239
+ }
240
+ return variables
241
+ }
242
+
243
+ export const tokenVariables = Object.freeze(collectTokenVariables(light))
244
+
245
+ /** Select values through inherited CSS flags; no browser APIs or first-render mode guesses. */
246
+ export function modeStyle(
247
+ light: Readonly<ThemeVariableValues>,
248
+ dark: Readonly<ThemeVariableValues>
249
+ ): ThemeVariableValues {
250
+ const style: ThemeVariableValues = {}
251
+ for (const variable of Object.keys(light) as Array<keyof ThemeVariableValues>) {
252
+ const lightValue = light[variable]
253
+ const darkValue = dark[variable]
254
+ if (lightValue === darkValue) style[variable] = lightValue
255
+ else {
256
+ const lightBranch = lightValue === 'initial' ? 'var(--_rad-unset)' : lightValue
257
+ const darkBranch = darkValue === 'initial' ? 'var(--_rad-unset)' : darkValue
258
+ style[variable] = `var(--_rad-light, ${lightBranch}) var(--_rad-dark, ${darkBranch})`
259
+ }
260
+ }
261
+ return style
262
+ }
@@ -0,0 +1,10 @@
1
+ export type {
2
+ SharedTokens,
3
+ Theme,
4
+ ThemeComponentOverrides,
5
+ ThemeDefinition,
6
+ ThemeLayer,
7
+ ThemeMode,
8
+ ThemeStyle,
9
+ ThemeTokens
10
+ } from './defineTheme.js'
@@ -0,0 +1,172 @@
1
+ import type { ColorPalette } from '../color/recommendColorPalette.js'
2
+ import { tokenDefaults, type ThemeTokens } from './tokens.js'
3
+ import { defineThemeDocument, updateThemeDocument } from './themeDocument.js'
4
+ import type { ThemeDocument, ThemeSection } from './themeDocumentTypes.js'
5
+
6
+ /** Bounded workshop controls; dimensions are derived from the neutral baseline, not compounded. */
7
+ export interface ThemeGeometrySettings {
8
+ /** 0.5–2; scales shared gaps and panel padding, retaining rem units. */
9
+ readonly spacing?: number
10
+ /** 0.75–1.5; scales all three control heights, inline padding and indicators, not fonts. */
11
+ readonly density?: number
12
+ /** Pixels, 0–32. Checkbox still caps its inherited radius; Radio stays circular. */
13
+ readonly controlRadius?: number
14
+ /** Pixels, 0–48. */
15
+ readonly surfaceRadius?: number
16
+ /** Pixels, 0–4. */
17
+ readonly controlBorderWidth?: number
18
+ readonly surfaceBorderWidth?: number
19
+ readonly borderStyle?: 'solid' | 'dashed' | 'dotted'
20
+ /** 0 = none, 1 = baseline, 2 = raised, 3 = floating. Passive and overlay shadows only. */
21
+ readonly elevation?: 0 | 1 | 2 | 3
22
+ /** 0–0.9; black modal backdrop. Panel filtering remains a component exception. */
23
+ readonly backdropOpacity?: number
24
+ }
25
+
26
+ export interface ThemeAppearanceSettings {
27
+ readonly version?: 1
28
+ readonly palette?: Pick<ColorPalette, 'version' | 'color' | 'surface'>
29
+ readonly geometry?: ThemeSection<ThemeGeometrySettings>
30
+ }
31
+
32
+ const bounds = {
33
+ spacing: [0.5, 2],
34
+ density: [0.75, 1.5],
35
+ controlRadius: [0, 32],
36
+ surfaceRadius: [0, 48],
37
+ controlBorderWidth: [0, 4],
38
+ surfaceBorderWidth: [0, 4],
39
+ elevation: [0, 3],
40
+ backdropOpacity: [0, 0.9]
41
+ } as const
42
+ function record(value: unknown, path: string): asserts value is Record<string, unknown> {
43
+ if (!value || typeof value !== 'object' || Array.isArray(value))
44
+ throw new TypeError(`${path} must be an object.`)
45
+ }
46
+ function keys(value: object, allowed: readonly string[], path: string) {
47
+ for (const key of Object.keys(value))
48
+ if (!allowed.includes(key)) throw new TypeError(`Unknown ${path}.${key}.`)
49
+ }
50
+ function validate(value: unknown, path: string): asserts value is ThemeGeometrySettings {
51
+ record(value, path)
52
+ keys(value, [...Object.keys(bounds), 'borderStyle'], path)
53
+ for (const [key, item] of Object.entries(value)) {
54
+ if (item === undefined) continue
55
+ if (key === 'borderStyle') {
56
+ if (typeof item === 'string' && ['solid', 'dashed', 'dotted'].includes(item)) continue
57
+ } else {
58
+ const [min, max] = bounds[key as keyof typeof bounds]
59
+ if (
60
+ typeof item === 'number' &&
61
+ Number.isFinite(item) &&
62
+ item >= min &&
63
+ item <= max &&
64
+ (key !== 'elevation' || Number.isInteger(item))
65
+ )
66
+ continue
67
+ throw new TypeError(
68
+ `${path}.${key} must be a finite number from ${min} to ${max}${key === 'elevation' ? ' (integer)' : ''}.`
69
+ )
70
+ }
71
+ throw new TypeError(`${path}.borderStyle must be solid, dashed or dotted.`)
72
+ }
73
+ }
74
+ const scaled = (rem: string, factor: number) =>
75
+ `${Number((parseFloat(rem) * factor).toFixed(6))}rem`
76
+
77
+ function geometryTokens(settings: ThemeGeometrySettings, mode: 'light' | 'dark'): ThemeTokens {
78
+ const base = tokenDefaults[mode]
79
+ const spacing: Record<string, string> = {}
80
+ const control: Record<string, unknown> = {}
81
+ const surface: Record<string, string> = {}
82
+ if (settings.spacing !== undefined) {
83
+ for (const [key, value] of Object.entries(base.spacing))
84
+ spacing[key] = scaled(value, settings.spacing)
85
+ for (const key of ['padding', 'gap'] as const)
86
+ surface[key] = scaled(base.surface[key], settings.spacing)
87
+ }
88
+ if (settings.density !== undefined)
89
+ for (const size of ['small', 'medium', 'large'] as const) {
90
+ const metrics: Record<string, string> = {}
91
+ for (const key of ['height', 'paddingInline', 'indicatorSize'] as const)
92
+ metrics[key] = scaled(base.control[size][key], settings.density)
93
+ control[size] = metrics
94
+ }
95
+ for (const [key, target] of [
96
+ ['Radius', 'radius'],
97
+ ['BorderWidth', 'borderWidth']
98
+ ] as const) {
99
+ const a = settings[`control${key}`],
100
+ b = settings[`surface${key}`]
101
+ if (a !== undefined) control[target] = `${a}px`
102
+ if (b !== undefined) surface[target] = `${b}px`
103
+ }
104
+ if (settings.borderStyle !== undefined)
105
+ control.borderStyle = surface.borderStyle = settings.borderStyle
106
+ if (settings.elevation !== undefined) {
107
+ const level = settings.elevation
108
+ surface.shadow =
109
+ level === 0
110
+ ? 'none'
111
+ : level === 1
112
+ ? base.surface.shadow
113
+ : `0 ${level * 2}px ${level * 6}px -2px rgb(0 0 0 / ${mode === 'light' ? 0.12 : 0.4})`
114
+ surface.overlayShadow =
115
+ level === 0
116
+ ? 'none'
117
+ : level === 1
118
+ ? base.surface.overlayShadow
119
+ : `0 ${level * 12}px ${level * 32}px -16px rgb(0 0 0 / ${mode === 'light' ? 0.3 : 0.6})`
120
+ }
121
+ if (settings.backdropOpacity !== undefined)
122
+ surface.backdrop = `rgb(0 0 0 / ${settings.backdropOpacity})`
123
+ return {
124
+ ...(Object.keys(spacing).length ? { spacing } : {}),
125
+ ...(Object.keys(control).length ? { control } : {}),
126
+ ...(Object.keys(surface).length ? { surface } : {})
127
+ }
128
+ }
129
+
130
+ /** Apply generated color/canvas atomically and geometry leaves without erasing authored exceptions. */
131
+ export function updateThemeAppearance(
132
+ document: ThemeDocument,
133
+ settings: ThemeAppearanceSettings
134
+ ): ThemeDocument {
135
+ record(settings, 'appearance')
136
+ keys(settings, ['version', 'palette', 'geometry'], 'appearance')
137
+ if (settings.version !== undefined && settings.version !== 1)
138
+ throw new TypeError('Unsupported appearance.version; expected 1.')
139
+ let next = defineThemeDocument(document)
140
+ if (settings.palette !== undefined) {
141
+ record(settings.palette, 'appearance.palette')
142
+ if (settings.palette.version !== 1) throw new TypeError('appearance.palette.version must be 1.')
143
+ record(settings.palette.color, 'appearance.palette.color')
144
+ record(settings.palette.surface, 'appearance.palette.surface')
145
+ next = updateThemeDocument(next, { color: settings.palette.color }, 'replace')
146
+ next = updateThemeDocument(next, { surface: settings.palette.surface })
147
+ }
148
+ const geometry = settings.geometry
149
+ if (geometry === undefined) return next
150
+ record(geometry, 'appearance.geometry')
151
+ keys(geometry, ['values', 'modes'], 'appearance.geometry')
152
+ if (geometry.values !== undefined) validate(geometry.values, 'appearance.geometry.values')
153
+ if (geometry.modes !== undefined) {
154
+ record(geometry.modes, 'appearance.geometry.modes')
155
+ keys(geometry.modes, ['light', 'dark'], 'appearance.geometry.modes')
156
+ }
157
+ for (const mode of ['light', 'dark'] as const) {
158
+ if (geometry.modes?.[mode] !== undefined)
159
+ validate(geometry.modes[mode], `appearance.geometry.modes.${mode}`)
160
+ const values = { ...geometry.values }
161
+ for (const [key, value] of Object.entries(geometry.modes?.[mode] ?? {}))
162
+ if (value !== undefined) Object.assign(values, { [key]: value })
163
+ const tokens = geometryTokens(values, mode)
164
+ next = updateThemeDocument(
165
+ next,
166
+ Object.fromEntries(
167
+ Object.entries(tokens).map(([group, value]) => [group, { modes: { [mode]: value } }])
168
+ )
169
+ )
170
+ }
171
+ return next
172
+ }