@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.
- package/CHANGELOG.md +357 -0
- package/README.md +944 -29
- package/dist/library/Accordion.d.ts +56 -0
- package/dist/library/Accordion.d.ts.map +1 -0
- package/dist/library/Accordion.js +89 -0
- package/dist/library/Accordion.js.map +1 -0
- package/dist/library/Button.d.ts +25 -3
- package/dist/library/Button.d.ts.map +1 -1
- package/dist/library/Button.js +31 -3
- package/dist/library/Button.js.map +1 -1
- package/dist/library/Card.d.ts +31 -0
- package/dist/library/Card.d.ts.map +1 -0
- package/dist/library/Card.js +69 -0
- package/dist/library/Card.js.map +1 -0
- package/dist/library/Checkbox.d.ts +13 -0
- package/dist/library/Checkbox.d.ts.map +1 -0
- package/dist/library/Checkbox.js +77 -0
- package/dist/library/Checkbox.js.map +1 -0
- package/dist/library/Collapsible.d.ts +32 -0
- package/dist/library/Collapsible.d.ts.map +1 -0
- package/dist/library/Collapsible.js +99 -0
- package/dist/library/Collapsible.js.map +1 -0
- package/dist/library/Dialog.d.ts +50 -0
- package/dist/library/Dialog.d.ts.map +1 -0
- package/dist/library/Dialog.js +215 -0
- package/dist/library/Dialog.js.map +1 -0
- package/dist/library/Field.d.ts +68 -0
- package/dist/library/Field.d.ts.map +1 -0
- package/dist/library/Field.js +114 -0
- package/dist/library/Field.js.map +1 -0
- package/dist/library/Input.d.ts +10 -0
- package/dist/library/Input.d.ts.map +1 -0
- package/dist/library/Input.js +51 -0
- package/dist/library/Input.js.map +1 -0
- package/dist/library/Link.d.ts +27 -0
- package/dist/library/Link.d.ts.map +1 -0
- package/dist/library/Link.js +50 -0
- package/dist/library/Link.js.map +1 -0
- package/dist/library/RadioGroup.d.ts +27 -0
- package/dist/library/RadioGroup.d.ts.map +1 -0
- package/dist/library/RadioGroup.js +103 -0
- package/dist/library/RadioGroup.js.map +1 -0
- package/dist/library/ThemeScope.d.ts +10 -0
- package/dist/library/ThemeScope.d.ts.map +1 -0
- package/dist/library/ThemeScope.js +41 -0
- package/dist/library/ThemeScope.js.map +1 -0
- package/dist/library/actionStyles.d.ts +11 -0
- package/dist/library/actionStyles.d.ts.map +1 -0
- package/dist/library/actionStyles.js +75 -0
- package/dist/library/actionStyles.js.map +1 -0
- package/dist/library/cn.d.ts +1 -2
- package/dist/library/cn.d.ts.map +1 -1
- package/dist/library/cn.js +1 -8
- package/dist/library/cn.js.map +1 -1
- package/dist/library/color/colorFamilies.d.ts +3 -0
- package/dist/library/color/colorFamilies.d.ts.map +1 -0
- package/dist/library/color/colorFamilies.js +20 -0
- package/dist/library/color/colorFamilies.js.map +1 -0
- package/dist/library/color/generateColorWall.d.ts +54 -0
- package/dist/library/color/generateColorWall.d.ts.map +1 -0
- package/dist/library/color/generateColorWall.js +231 -0
- package/dist/library/color/generateColorWall.js.map +1 -0
- package/dist/library/color/index.d.ts +5 -0
- package/dist/library/color/index.d.ts.map +1 -0
- package/dist/library/color/index.js +3 -0
- package/dist/library/color/index.js.map +1 -0
- package/dist/library/color/oklch.d.ts +17 -0
- package/dist/library/color/oklch.d.ts.map +1 -0
- package/dist/library/color/oklch.js +79 -0
- package/dist/library/color/oklch.js.map +1 -0
- package/dist/library/color/recommendColorPalette.d.ts +65 -0
- package/dist/library/color/recommendColorPalette.d.ts.map +1 -0
- package/dist/library/color/recommendColorPalette.js +263 -0
- package/dist/library/color/recommendColorPalette.js.map +1 -0
- package/dist/library/controlStyles.d.ts +5 -0
- package/dist/library/controlStyles.d.ts.map +1 -0
- package/dist/library/controlStyles.js +15 -0
- package/dist/library/controlStyles.js.map +1 -0
- package/dist/library/index.d.ts +30 -1
- package/dist/library/index.d.ts.map +1 -1
- package/dist/library/index.js +14 -0
- package/dist/library/index.js.map +1 -1
- package/dist/library/internal/events.d.ts +8 -0
- package/dist/library/internal/events.d.ts.map +1 -0
- package/dist/library/internal/events.js +13 -0
- package/dist/library/internal/events.js.map +1 -0
- package/dist/library/internal/ids.d.ts +3 -0
- package/dist/library/internal/ids.d.ts.map +1 -0
- package/dist/library/internal/ids.js +6 -0
- package/dist/library/internal/ids.js.map +1 -0
- package/dist/library/internal/selection.d.ts +5 -0
- package/dist/library/internal/selection.d.ts.map +1 -0
- package/dist/library/internal/selection.js +18 -0
- package/dist/library/internal/selection.js.map +1 -0
- package/dist/library/presentation.d.ts +18 -0
- package/dist/library/presentation.d.ts.map +1 -0
- package/dist/library/presentation.js +2 -0
- package/dist/library/presentation.js.map +1 -0
- package/dist/library/react/useComposedRefs.d.ts +4 -0
- package/dist/library/react/useComposedRefs.d.ts.map +1 -0
- package/dist/library/react/useComposedRefs.js +28 -0
- package/dist/library/react/useComposedRefs.js.map +1 -0
- package/dist/library/react/useControllableState.d.ts +16 -0
- package/dist/library/react/useControllableState.d.ts.map +1 -0
- package/dist/library/react/useControllableState.js +29 -0
- package/dist/library/react/useControllableState.js.map +1 -0
- package/dist/library/react/useNativeOwner.d.ts +17 -0
- package/dist/library/react/useNativeOwner.d.ts.map +1 -0
- package/dist/library/react/useNativeOwner.js +17 -0
- package/dist/library/react/useNativeOwner.js.map +1 -0
- package/dist/library/reset.css +1 -0
- package/dist/library/styles.css +2 -1
- package/dist/library/themes/components.d.ts +217 -0
- package/dist/library/themes/components.d.ts.map +1 -0
- package/dist/library/themes/components.js +229 -0
- package/dist/library/themes/components.js.map +1 -0
- package/dist/library/themes/default.d.ts +2 -0
- package/dist/library/themes/default.d.ts.map +1 -0
- package/dist/library/themes/default.js +4 -0
- package/dist/library/themes/default.js.map +1 -0
- package/dist/library/themes/defineTheme.d.ts +33 -0
- package/dist/library/themes/defineTheme.d.ts.map +1 -0
- package/dist/library/themes/defineTheme.js +98 -0
- package/dist/library/themes/defineTheme.js.map +1 -0
- package/dist/library/themes/expressive.d.ts +2 -0
- package/dist/library/themes/expressive.d.ts.map +1 -0
- package/dist/library/themes/expressive.js +132 -0
- package/dist/library/themes/expressive.js.map +1 -0
- package/dist/library/themes/glass.d.ts +2 -0
- package/dist/library/themes/glass.d.ts.map +1 -0
- package/dist/library/themes/glass.js +132 -0
- package/dist/library/themes/glass.js.map +1 -0
- package/dist/library/themes/index.d.ts +18 -0
- package/dist/library/themes/index.d.ts.map +1 -0
- package/dist/library/themes/index.js +23 -0
- package/dist/library/themes/index.js.map +1 -0
- package/dist/library/themes/jelly.d.ts +2 -0
- package/dist/library/themes/jelly.d.ts.map +1 -0
- package/dist/library/themes/jelly.js +130 -0
- package/dist/library/themes/jelly.js.map +1 -0
- package/dist/library/themes/preset-values.d.ts +4 -0
- package/dist/library/themes/preset-values.d.ts.map +1 -0
- package/dist/library/themes/preset-values.js +5 -0
- package/dist/library/themes/preset-values.js.map +1 -0
- package/dist/library/themes/radiant.d.ts +2 -0
- package/dist/library/themes/radiant.d.ts.map +1 -0
- package/dist/library/themes/radiant.js +129 -0
- package/dist/library/themes/radiant.js.map +1 -0
- package/dist/library/themes/sharp-3d.d.ts +2 -0
- package/dist/library/themes/sharp-3d.d.ts.map +1 -0
- package/dist/library/themes/sharp-3d.js +142 -0
- package/dist/library/themes/sharp-3d.js.map +1 -0
- package/dist/library/themes/soft-squircle.d.ts +2 -0
- package/dist/library/themes/soft-squircle.d.ts.map +1 -0
- package/dist/library/themes/soft-squircle.js +131 -0
- package/dist/library/themes/soft-squircle.js.map +1 -0
- package/dist/library/themes/themeDocument.d.ts +16 -0
- package/dist/library/themes/themeDocument.d.ts.map +1 -0
- package/dist/library/themes/themeDocument.js +307 -0
- package/dist/library/themes/themeDocument.js.map +1 -0
- package/dist/library/themes/themeDocumentTypes.d.ts +69 -0
- package/dist/library/themes/themeDocumentTypes.d.ts.map +1 -0
- package/dist/library/themes/themeDocumentTypes.js +2 -0
- package/dist/library/themes/themeDocumentTypes.js.map +1 -0
- package/dist/library/themes/ticket.d.ts +2 -0
- package/dist/library/themes/ticket.d.ts.map +1 -0
- package/dist/library/themes/ticket.js +141 -0
- package/dist/library/themes/ticket.js.map +1 -0
- package/dist/library/themes/tokens.d.ts +100 -0
- package/dist/library/themes/tokens.d.ts.map +1 -0
- package/dist/library/themes/tokens.js +171 -0
- package/dist/library/themes/tokens.js.map +1 -0
- package/dist/library/themes/types.d.ts +2 -0
- package/dist/library/themes/types.d.ts.map +1 -0
- package/dist/library/themes/types.js +2 -0
- package/dist/library/themes/types.js.map +1 -0
- package/dist/library/themes/updateThemeAppearance.d.ts +29 -0
- package/dist/library/themes/updateThemeAppearance.d.ts.map +1 -0
- package/dist/library/themes/updateThemeAppearance.js +138 -0
- package/dist/library/themes/updateThemeAppearance.js.map +1 -0
- package/docs/accessibility.md +189 -0
- package/docs/system.md +231 -0
- package/docs/theming.md +804 -0
- package/package.json +34 -10
- package/src/Accordion.tsx +235 -0
- package/src/Button.tsx +95 -15
- package/src/Card.tsx +143 -0
- package/src/Checkbox.tsx +189 -0
- package/src/Collapsible.tsx +193 -0
- package/src/Dialog.tsx +333 -0
- package/src/Field.tsx +293 -0
- package/src/Input.tsx +82 -0
- package/src/Link.tsx +95 -0
- package/src/RadioGroup.tsx +255 -0
- package/src/ThemeScope.tsx +64 -0
- package/src/actionStyles.ts +90 -0
- package/src/cn.ts +1 -10
- package/src/color/colorFamilies.ts +19 -0
- package/src/color/generateColorWall.ts +358 -0
- package/src/color/index.ts +11 -0
- package/src/color/oklch.ts +95 -0
- package/src/color/recommendColorPalette.ts +375 -0
- package/src/controlStyles.ts +19 -0
- package/src/index.ts +130 -1
- package/src/internal/events.ts +17 -0
- package/src/internal/ids.ts +5 -0
- package/src/internal/selection.ts +20 -0
- package/src/presentation.ts +12 -0
- package/src/react/useComposedRefs.ts +32 -0
- package/src/react/useControllableState.ts +50 -0
- package/src/react/useNativeOwner.ts +33 -0
- package/src/styles.css +2 -14
- package/src/themes/baseline.css +116 -0
- package/src/themes/components.ts +249 -0
- package/src/themes/default.ts +4 -0
- package/src/themes/defineTheme.ts +145 -0
- package/src/themes/expressive.ts +132 -0
- package/src/themes/glass.ts +135 -0
- package/src/themes/index.ts +57 -0
- package/src/themes/jelly.ts +130 -0
- package/src/themes/preset-values.ts +5 -0
- package/src/themes/radiant.ts +129 -0
- package/src/themes/sharp-3d.ts +142 -0
- package/src/themes/soft-squircle.ts +131 -0
- package/src/themes/themeDocument.ts +340 -0
- package/src/themes/themeDocumentTypes.ts +76 -0
- package/src/themes/ticket.ts +141 -0
- package/src/themes/tokens.ts +262 -0
- package/src/themes/types.ts +10 -0
- 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,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
|
+
}
|