@sparkwire/styles 0.0.0-stage → 0.2.0
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/dist/index.d.mts +342 -0
- package/dist/index.d.ts +342 -0
- package/dist/index.js +393 -0
- package/dist/index.js.map +1 -0
- package/dist/index.mjs +385 -0
- package/dist/index.mjs.map +1 -0
- package/package.json +49 -4
- package/README.md +0 -3
package/dist/index.d.mts
ADDED
|
@@ -0,0 +1,342 @@
|
|
|
1
|
+
interface ThemeColors {
|
|
2
|
+
primary: {
|
|
3
|
+
gray: {
|
|
4
|
+
'25': string;
|
|
5
|
+
'50': string;
|
|
6
|
+
'100': string;
|
|
7
|
+
'200': string;
|
|
8
|
+
'300': string;
|
|
9
|
+
'400': string;
|
|
10
|
+
'500': string;
|
|
11
|
+
'600': string;
|
|
12
|
+
'700': string;
|
|
13
|
+
'800': string;
|
|
14
|
+
'900': string;
|
|
15
|
+
};
|
|
16
|
+
brand: {
|
|
17
|
+
'25': string;
|
|
18
|
+
'50': string;
|
|
19
|
+
'100': string;
|
|
20
|
+
'200': string;
|
|
21
|
+
'300': string;
|
|
22
|
+
'400': string;
|
|
23
|
+
'500': string;
|
|
24
|
+
'600': string;
|
|
25
|
+
'700': string;
|
|
26
|
+
'800': string;
|
|
27
|
+
'900': string;
|
|
28
|
+
};
|
|
29
|
+
error: {
|
|
30
|
+
'25': string;
|
|
31
|
+
'50': string;
|
|
32
|
+
'100': string;
|
|
33
|
+
'200': string;
|
|
34
|
+
'300': string;
|
|
35
|
+
'400': string;
|
|
36
|
+
'500': string;
|
|
37
|
+
'600': string;
|
|
38
|
+
'700': string;
|
|
39
|
+
'800': string;
|
|
40
|
+
'900': string;
|
|
41
|
+
};
|
|
42
|
+
warning: {
|
|
43
|
+
'25': string;
|
|
44
|
+
'50': string;
|
|
45
|
+
'100': string;
|
|
46
|
+
'200': string;
|
|
47
|
+
'300': string;
|
|
48
|
+
'400': string;
|
|
49
|
+
'500': string;
|
|
50
|
+
'600': string;
|
|
51
|
+
'700': string;
|
|
52
|
+
'800': string;
|
|
53
|
+
'900': string;
|
|
54
|
+
};
|
|
55
|
+
success: {
|
|
56
|
+
'25': string;
|
|
57
|
+
'50': string;
|
|
58
|
+
'100': string;
|
|
59
|
+
'200': string;
|
|
60
|
+
'300': string;
|
|
61
|
+
'400': string;
|
|
62
|
+
'500': string;
|
|
63
|
+
'600': string;
|
|
64
|
+
'700': string;
|
|
65
|
+
'800': string;
|
|
66
|
+
'900': string;
|
|
67
|
+
};
|
|
68
|
+
};
|
|
69
|
+
secondary: {
|
|
70
|
+
blueGray: {
|
|
71
|
+
'25': string;
|
|
72
|
+
'50': string;
|
|
73
|
+
'100': string;
|
|
74
|
+
'200': string;
|
|
75
|
+
'300': string;
|
|
76
|
+
'400': string;
|
|
77
|
+
'500': string;
|
|
78
|
+
'600': string;
|
|
79
|
+
'700': string;
|
|
80
|
+
'800': string;
|
|
81
|
+
'900': string;
|
|
82
|
+
};
|
|
83
|
+
blueLight: {
|
|
84
|
+
'25': string;
|
|
85
|
+
'50': string;
|
|
86
|
+
'100': string;
|
|
87
|
+
'200': string;
|
|
88
|
+
'300': string;
|
|
89
|
+
'400': string;
|
|
90
|
+
'500': string;
|
|
91
|
+
'600': string;
|
|
92
|
+
'700': string;
|
|
93
|
+
'800': string;
|
|
94
|
+
'900': string;
|
|
95
|
+
};
|
|
96
|
+
blue: {
|
|
97
|
+
'25': string;
|
|
98
|
+
'50': string;
|
|
99
|
+
'100': string;
|
|
100
|
+
'200': string;
|
|
101
|
+
'300': string;
|
|
102
|
+
'400': string;
|
|
103
|
+
'500': string;
|
|
104
|
+
'600': string;
|
|
105
|
+
'700': string;
|
|
106
|
+
'800': string;
|
|
107
|
+
'900': string;
|
|
108
|
+
};
|
|
109
|
+
indigo: {
|
|
110
|
+
'25': string;
|
|
111
|
+
'50': string;
|
|
112
|
+
'100': string;
|
|
113
|
+
'200': string;
|
|
114
|
+
'300': string;
|
|
115
|
+
'400': string;
|
|
116
|
+
'500': string;
|
|
117
|
+
'600': string;
|
|
118
|
+
'700': string;
|
|
119
|
+
'800': string;
|
|
120
|
+
'900': string;
|
|
121
|
+
};
|
|
122
|
+
purple: {
|
|
123
|
+
'25': string;
|
|
124
|
+
'50': string;
|
|
125
|
+
'100': string;
|
|
126
|
+
'200': string;
|
|
127
|
+
'300': string;
|
|
128
|
+
'400': string;
|
|
129
|
+
'500': string;
|
|
130
|
+
'600': string;
|
|
131
|
+
'700': string;
|
|
132
|
+
'800': string;
|
|
133
|
+
'900': string;
|
|
134
|
+
};
|
|
135
|
+
pink: {
|
|
136
|
+
'25': string;
|
|
137
|
+
'50': string;
|
|
138
|
+
'100': string;
|
|
139
|
+
'200': string;
|
|
140
|
+
'300': string;
|
|
141
|
+
'400': string;
|
|
142
|
+
'500': string;
|
|
143
|
+
'600': string;
|
|
144
|
+
'700': string;
|
|
145
|
+
'800': string;
|
|
146
|
+
'900': string;
|
|
147
|
+
};
|
|
148
|
+
rose: {
|
|
149
|
+
'25': string;
|
|
150
|
+
'50': string;
|
|
151
|
+
'100': string;
|
|
152
|
+
'200': string;
|
|
153
|
+
'300': string;
|
|
154
|
+
'400': string;
|
|
155
|
+
'500': string;
|
|
156
|
+
'600': string;
|
|
157
|
+
'700': string;
|
|
158
|
+
'800': string;
|
|
159
|
+
'900': string;
|
|
160
|
+
};
|
|
161
|
+
orange: {
|
|
162
|
+
'25': string;
|
|
163
|
+
'50': string;
|
|
164
|
+
'100': string;
|
|
165
|
+
'200': string;
|
|
166
|
+
'300': string;
|
|
167
|
+
'400': string;
|
|
168
|
+
'500': string;
|
|
169
|
+
'600': string;
|
|
170
|
+
'700': string;
|
|
171
|
+
'800': string;
|
|
172
|
+
'900': string;
|
|
173
|
+
};
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
type Sizes = 'small' | 'medium' | 'large' | 'xlarge' | '2xlarge' | '3xlarge';
|
|
177
|
+
/** Colours one tone (brand, success…) needs in the current mode. */
|
|
178
|
+
interface ToneTokens {
|
|
179
|
+
/** Filled backgrounds: contained buttons, checked boxes, lit nodes. */
|
|
180
|
+
fill: string;
|
|
181
|
+
/** Text, borders and icons drawn in this tone. Readable on `surface.base`. */
|
|
182
|
+
ink: string;
|
|
183
|
+
/** Fill on hover. */
|
|
184
|
+
hover: string;
|
|
185
|
+
/** Glow colour (with alpha) around lit elements. */
|
|
186
|
+
glow: string;
|
|
187
|
+
}
|
|
188
|
+
type ToneName = 'brand' | 'success' | 'warning' | 'error';
|
|
189
|
+
interface Theme {
|
|
190
|
+
/** Which colour mode these values are for. */
|
|
191
|
+
mode: 'dark' | 'light';
|
|
192
|
+
/** Per-tone colours, already adjusted for `mode`. */
|
|
193
|
+
tones: Record<ToneName, ToneTokens>;
|
|
194
|
+
colors: {
|
|
195
|
+
primary: {
|
|
196
|
+
gray: ThemeColors['primary']['gray'];
|
|
197
|
+
brand: ThemeColors['primary']['brand'];
|
|
198
|
+
error: ThemeColors['primary']['error'];
|
|
199
|
+
warning: ThemeColors['primary']['warning'];
|
|
200
|
+
success: ThemeColors['primary']['success'];
|
|
201
|
+
};
|
|
202
|
+
secondary: {
|
|
203
|
+
blueGray: ThemeColors['secondary']['blueGray'];
|
|
204
|
+
blueLight: ThemeColors['secondary']['blueLight'];
|
|
205
|
+
blue: ThemeColors['secondary']['blue'];
|
|
206
|
+
indigo: ThemeColors['secondary']['indigo'];
|
|
207
|
+
purple: ThemeColors['secondary']['purple'];
|
|
208
|
+
pink: ThemeColors['secondary']['pink'];
|
|
209
|
+
rose: ThemeColors['secondary']['rose'];
|
|
210
|
+
orange: ThemeColors['secondary']['orange'];
|
|
211
|
+
};
|
|
212
|
+
};
|
|
213
|
+
typography: {
|
|
214
|
+
fontFamily: string;
|
|
215
|
+
fontSize: {
|
|
216
|
+
small: string;
|
|
217
|
+
medium: string;
|
|
218
|
+
large: string;
|
|
219
|
+
};
|
|
220
|
+
fontWeight: {
|
|
221
|
+
regular: number;
|
|
222
|
+
medium: number;
|
|
223
|
+
bold: number;
|
|
224
|
+
};
|
|
225
|
+
lineHeight: {
|
|
226
|
+
small: string;
|
|
227
|
+
medium: string;
|
|
228
|
+
large: string;
|
|
229
|
+
};
|
|
230
|
+
};
|
|
231
|
+
spacing: {
|
|
232
|
+
extraSmall: string;
|
|
233
|
+
small: string;
|
|
234
|
+
medium: string;
|
|
235
|
+
large: string;
|
|
236
|
+
xlarge: string;
|
|
237
|
+
'2xlarge': string;
|
|
238
|
+
'3xlarge': string;
|
|
239
|
+
};
|
|
240
|
+
borderRadius: {
|
|
241
|
+
small: string;
|
|
242
|
+
medium: string;
|
|
243
|
+
large: string;
|
|
244
|
+
xlarge: string;
|
|
245
|
+
'2xlarge': string;
|
|
246
|
+
'3xlarge': string;
|
|
247
|
+
};
|
|
248
|
+
/** Live Wire: the surfaces components sit on (dark by default). */
|
|
249
|
+
surface: {
|
|
250
|
+
base: string;
|
|
251
|
+
raised: string;
|
|
252
|
+
sunken: string;
|
|
253
|
+
border: string;
|
|
254
|
+
borderStrong: string;
|
|
255
|
+
};
|
|
256
|
+
/** Live Wire: text colours for use on `surface`. */
|
|
257
|
+
text: {
|
|
258
|
+
primary: string;
|
|
259
|
+
secondary: string;
|
|
260
|
+
disabled: string;
|
|
261
|
+
/** Text drawn on top of an energised (filled) element. */
|
|
262
|
+
onEnergy: string;
|
|
263
|
+
};
|
|
264
|
+
/** Live Wire: the "current" that flows through interactive components. */
|
|
265
|
+
energy: {
|
|
266
|
+
current: string;
|
|
267
|
+
/** `current` when drawn as text or a thin line; readable on `surface.base`. */
|
|
268
|
+
ink: string;
|
|
269
|
+
hot: string;
|
|
270
|
+
glow: string;
|
|
271
|
+
off: string;
|
|
272
|
+
sparks: string[];
|
|
273
|
+
};
|
|
274
|
+
/** Live Wire: motion timings. Components respect prefers-reduced-motion. */
|
|
275
|
+
motion: {
|
|
276
|
+
fast: string;
|
|
277
|
+
normal: string;
|
|
278
|
+
spark: number;
|
|
279
|
+
easing: string;
|
|
280
|
+
};
|
|
281
|
+
padding: {
|
|
282
|
+
small: string;
|
|
283
|
+
medium: string;
|
|
284
|
+
large: string;
|
|
285
|
+
'2xlarge': string;
|
|
286
|
+
'3xlarge': string;
|
|
287
|
+
};
|
|
288
|
+
zIndex: {
|
|
289
|
+
modal: number;
|
|
290
|
+
dropdown: number;
|
|
291
|
+
tooltip: number;
|
|
292
|
+
};
|
|
293
|
+
shadows: {
|
|
294
|
+
extraSmall: string;
|
|
295
|
+
small: string;
|
|
296
|
+
medium: string;
|
|
297
|
+
large: string;
|
|
298
|
+
xlarge: string;
|
|
299
|
+
'2xlarge': string;
|
|
300
|
+
'3xlarge': string;
|
|
301
|
+
};
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
/**
|
|
305
|
+
* Live Wire: Spark UI's default theme. Components carry current: actions throw
|
|
306
|
+
* sparks, toggles close a circuit, inputs charge up as they become valid.
|
|
307
|
+
*/
|
|
308
|
+
declare const defaultTheme: Theme;
|
|
309
|
+
/** @deprecated Same as `Theme`; kept for older imports. */
|
|
310
|
+
type BaseTheme = Theme;
|
|
311
|
+
declare const liveWireTheme: Theme;
|
|
312
|
+
/**
|
|
313
|
+
* Live Wire, light mode. Fills keep their voltage; anything drawn as text or a
|
|
314
|
+
* thin line uses a darker "ink" so it stays readable on white (4.5:1 or more).
|
|
315
|
+
*/
|
|
316
|
+
declare const lightTheme: Theme;
|
|
317
|
+
declare const darkTheme: Theme;
|
|
318
|
+
|
|
319
|
+
/** Every key optional, at every depth. */
|
|
320
|
+
type DeepPartial<T> = T extends (infer U)[] ? U[] : T extends object ? {
|
|
321
|
+
[K in keyof T]?: DeepPartial<T[K]>;
|
|
322
|
+
} : T;
|
|
323
|
+
/**
|
|
324
|
+
* Build a theme by changing only what you need. Everything you leave out keeps
|
|
325
|
+
* its Live Wire value for the chosen mode.
|
|
326
|
+
*
|
|
327
|
+
* @example
|
|
328
|
+
* const ocean = createTheme({ energy: { current: '#3AF2FF', ink: '#3AF2FF' } });
|
|
329
|
+
* const oceanLight = createTheme({ tones: { brand: { fill: '#3AF2FF' } } }, 'light');
|
|
330
|
+
*/
|
|
331
|
+
declare function createTheme(overrides?: DeepPartial<Theme>, mode?: Theme['mode']): Theme;
|
|
332
|
+
|
|
333
|
+
/**
|
|
334
|
+
* Turn a theme into CSS custom properties, e.g. `--spark-energy-current`.
|
|
335
|
+
* The same names are used by `@sparkwire/core/styles.css`, so overriding a
|
|
336
|
+
* variable in plain CSS restyles every component that uses it.
|
|
337
|
+
*/
|
|
338
|
+
declare function themeToCssVars(theme: Theme): Record<string, string>;
|
|
339
|
+
/** The same variables as a CSS rule body, for a <style> tag or a stylesheet. */
|
|
340
|
+
declare function themeToCss(theme: Theme, selector?: string): string;
|
|
341
|
+
|
|
342
|
+
export { type BaseTheme, type DeepPartial, type Sizes, type Theme, type ThemeColors, type ToneName, type ToneTokens, createTheme, darkTheme, defaultTheme, lightTheme, liveWireTheme, themeToCss, themeToCssVars };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,342 @@
|
|
|
1
|
+
interface ThemeColors {
|
|
2
|
+
primary: {
|
|
3
|
+
gray: {
|
|
4
|
+
'25': string;
|
|
5
|
+
'50': string;
|
|
6
|
+
'100': string;
|
|
7
|
+
'200': string;
|
|
8
|
+
'300': string;
|
|
9
|
+
'400': string;
|
|
10
|
+
'500': string;
|
|
11
|
+
'600': string;
|
|
12
|
+
'700': string;
|
|
13
|
+
'800': string;
|
|
14
|
+
'900': string;
|
|
15
|
+
};
|
|
16
|
+
brand: {
|
|
17
|
+
'25': string;
|
|
18
|
+
'50': string;
|
|
19
|
+
'100': string;
|
|
20
|
+
'200': string;
|
|
21
|
+
'300': string;
|
|
22
|
+
'400': string;
|
|
23
|
+
'500': string;
|
|
24
|
+
'600': string;
|
|
25
|
+
'700': string;
|
|
26
|
+
'800': string;
|
|
27
|
+
'900': string;
|
|
28
|
+
};
|
|
29
|
+
error: {
|
|
30
|
+
'25': string;
|
|
31
|
+
'50': string;
|
|
32
|
+
'100': string;
|
|
33
|
+
'200': string;
|
|
34
|
+
'300': string;
|
|
35
|
+
'400': string;
|
|
36
|
+
'500': string;
|
|
37
|
+
'600': string;
|
|
38
|
+
'700': string;
|
|
39
|
+
'800': string;
|
|
40
|
+
'900': string;
|
|
41
|
+
};
|
|
42
|
+
warning: {
|
|
43
|
+
'25': string;
|
|
44
|
+
'50': string;
|
|
45
|
+
'100': string;
|
|
46
|
+
'200': string;
|
|
47
|
+
'300': string;
|
|
48
|
+
'400': string;
|
|
49
|
+
'500': string;
|
|
50
|
+
'600': string;
|
|
51
|
+
'700': string;
|
|
52
|
+
'800': string;
|
|
53
|
+
'900': string;
|
|
54
|
+
};
|
|
55
|
+
success: {
|
|
56
|
+
'25': string;
|
|
57
|
+
'50': string;
|
|
58
|
+
'100': string;
|
|
59
|
+
'200': string;
|
|
60
|
+
'300': string;
|
|
61
|
+
'400': string;
|
|
62
|
+
'500': string;
|
|
63
|
+
'600': string;
|
|
64
|
+
'700': string;
|
|
65
|
+
'800': string;
|
|
66
|
+
'900': string;
|
|
67
|
+
};
|
|
68
|
+
};
|
|
69
|
+
secondary: {
|
|
70
|
+
blueGray: {
|
|
71
|
+
'25': string;
|
|
72
|
+
'50': string;
|
|
73
|
+
'100': string;
|
|
74
|
+
'200': string;
|
|
75
|
+
'300': string;
|
|
76
|
+
'400': string;
|
|
77
|
+
'500': string;
|
|
78
|
+
'600': string;
|
|
79
|
+
'700': string;
|
|
80
|
+
'800': string;
|
|
81
|
+
'900': string;
|
|
82
|
+
};
|
|
83
|
+
blueLight: {
|
|
84
|
+
'25': string;
|
|
85
|
+
'50': string;
|
|
86
|
+
'100': string;
|
|
87
|
+
'200': string;
|
|
88
|
+
'300': string;
|
|
89
|
+
'400': string;
|
|
90
|
+
'500': string;
|
|
91
|
+
'600': string;
|
|
92
|
+
'700': string;
|
|
93
|
+
'800': string;
|
|
94
|
+
'900': string;
|
|
95
|
+
};
|
|
96
|
+
blue: {
|
|
97
|
+
'25': string;
|
|
98
|
+
'50': string;
|
|
99
|
+
'100': string;
|
|
100
|
+
'200': string;
|
|
101
|
+
'300': string;
|
|
102
|
+
'400': string;
|
|
103
|
+
'500': string;
|
|
104
|
+
'600': string;
|
|
105
|
+
'700': string;
|
|
106
|
+
'800': string;
|
|
107
|
+
'900': string;
|
|
108
|
+
};
|
|
109
|
+
indigo: {
|
|
110
|
+
'25': string;
|
|
111
|
+
'50': string;
|
|
112
|
+
'100': string;
|
|
113
|
+
'200': string;
|
|
114
|
+
'300': string;
|
|
115
|
+
'400': string;
|
|
116
|
+
'500': string;
|
|
117
|
+
'600': string;
|
|
118
|
+
'700': string;
|
|
119
|
+
'800': string;
|
|
120
|
+
'900': string;
|
|
121
|
+
};
|
|
122
|
+
purple: {
|
|
123
|
+
'25': string;
|
|
124
|
+
'50': string;
|
|
125
|
+
'100': string;
|
|
126
|
+
'200': string;
|
|
127
|
+
'300': string;
|
|
128
|
+
'400': string;
|
|
129
|
+
'500': string;
|
|
130
|
+
'600': string;
|
|
131
|
+
'700': string;
|
|
132
|
+
'800': string;
|
|
133
|
+
'900': string;
|
|
134
|
+
};
|
|
135
|
+
pink: {
|
|
136
|
+
'25': string;
|
|
137
|
+
'50': string;
|
|
138
|
+
'100': string;
|
|
139
|
+
'200': string;
|
|
140
|
+
'300': string;
|
|
141
|
+
'400': string;
|
|
142
|
+
'500': string;
|
|
143
|
+
'600': string;
|
|
144
|
+
'700': string;
|
|
145
|
+
'800': string;
|
|
146
|
+
'900': string;
|
|
147
|
+
};
|
|
148
|
+
rose: {
|
|
149
|
+
'25': string;
|
|
150
|
+
'50': string;
|
|
151
|
+
'100': string;
|
|
152
|
+
'200': string;
|
|
153
|
+
'300': string;
|
|
154
|
+
'400': string;
|
|
155
|
+
'500': string;
|
|
156
|
+
'600': string;
|
|
157
|
+
'700': string;
|
|
158
|
+
'800': string;
|
|
159
|
+
'900': string;
|
|
160
|
+
};
|
|
161
|
+
orange: {
|
|
162
|
+
'25': string;
|
|
163
|
+
'50': string;
|
|
164
|
+
'100': string;
|
|
165
|
+
'200': string;
|
|
166
|
+
'300': string;
|
|
167
|
+
'400': string;
|
|
168
|
+
'500': string;
|
|
169
|
+
'600': string;
|
|
170
|
+
'700': string;
|
|
171
|
+
'800': string;
|
|
172
|
+
'900': string;
|
|
173
|
+
};
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
type Sizes = 'small' | 'medium' | 'large' | 'xlarge' | '2xlarge' | '3xlarge';
|
|
177
|
+
/** Colours one tone (brand, success…) needs in the current mode. */
|
|
178
|
+
interface ToneTokens {
|
|
179
|
+
/** Filled backgrounds: contained buttons, checked boxes, lit nodes. */
|
|
180
|
+
fill: string;
|
|
181
|
+
/** Text, borders and icons drawn in this tone. Readable on `surface.base`. */
|
|
182
|
+
ink: string;
|
|
183
|
+
/** Fill on hover. */
|
|
184
|
+
hover: string;
|
|
185
|
+
/** Glow colour (with alpha) around lit elements. */
|
|
186
|
+
glow: string;
|
|
187
|
+
}
|
|
188
|
+
type ToneName = 'brand' | 'success' | 'warning' | 'error';
|
|
189
|
+
interface Theme {
|
|
190
|
+
/** Which colour mode these values are for. */
|
|
191
|
+
mode: 'dark' | 'light';
|
|
192
|
+
/** Per-tone colours, already adjusted for `mode`. */
|
|
193
|
+
tones: Record<ToneName, ToneTokens>;
|
|
194
|
+
colors: {
|
|
195
|
+
primary: {
|
|
196
|
+
gray: ThemeColors['primary']['gray'];
|
|
197
|
+
brand: ThemeColors['primary']['brand'];
|
|
198
|
+
error: ThemeColors['primary']['error'];
|
|
199
|
+
warning: ThemeColors['primary']['warning'];
|
|
200
|
+
success: ThemeColors['primary']['success'];
|
|
201
|
+
};
|
|
202
|
+
secondary: {
|
|
203
|
+
blueGray: ThemeColors['secondary']['blueGray'];
|
|
204
|
+
blueLight: ThemeColors['secondary']['blueLight'];
|
|
205
|
+
blue: ThemeColors['secondary']['blue'];
|
|
206
|
+
indigo: ThemeColors['secondary']['indigo'];
|
|
207
|
+
purple: ThemeColors['secondary']['purple'];
|
|
208
|
+
pink: ThemeColors['secondary']['pink'];
|
|
209
|
+
rose: ThemeColors['secondary']['rose'];
|
|
210
|
+
orange: ThemeColors['secondary']['orange'];
|
|
211
|
+
};
|
|
212
|
+
};
|
|
213
|
+
typography: {
|
|
214
|
+
fontFamily: string;
|
|
215
|
+
fontSize: {
|
|
216
|
+
small: string;
|
|
217
|
+
medium: string;
|
|
218
|
+
large: string;
|
|
219
|
+
};
|
|
220
|
+
fontWeight: {
|
|
221
|
+
regular: number;
|
|
222
|
+
medium: number;
|
|
223
|
+
bold: number;
|
|
224
|
+
};
|
|
225
|
+
lineHeight: {
|
|
226
|
+
small: string;
|
|
227
|
+
medium: string;
|
|
228
|
+
large: string;
|
|
229
|
+
};
|
|
230
|
+
};
|
|
231
|
+
spacing: {
|
|
232
|
+
extraSmall: string;
|
|
233
|
+
small: string;
|
|
234
|
+
medium: string;
|
|
235
|
+
large: string;
|
|
236
|
+
xlarge: string;
|
|
237
|
+
'2xlarge': string;
|
|
238
|
+
'3xlarge': string;
|
|
239
|
+
};
|
|
240
|
+
borderRadius: {
|
|
241
|
+
small: string;
|
|
242
|
+
medium: string;
|
|
243
|
+
large: string;
|
|
244
|
+
xlarge: string;
|
|
245
|
+
'2xlarge': string;
|
|
246
|
+
'3xlarge': string;
|
|
247
|
+
};
|
|
248
|
+
/** Live Wire: the surfaces components sit on (dark by default). */
|
|
249
|
+
surface: {
|
|
250
|
+
base: string;
|
|
251
|
+
raised: string;
|
|
252
|
+
sunken: string;
|
|
253
|
+
border: string;
|
|
254
|
+
borderStrong: string;
|
|
255
|
+
};
|
|
256
|
+
/** Live Wire: text colours for use on `surface`. */
|
|
257
|
+
text: {
|
|
258
|
+
primary: string;
|
|
259
|
+
secondary: string;
|
|
260
|
+
disabled: string;
|
|
261
|
+
/** Text drawn on top of an energised (filled) element. */
|
|
262
|
+
onEnergy: string;
|
|
263
|
+
};
|
|
264
|
+
/** Live Wire: the "current" that flows through interactive components. */
|
|
265
|
+
energy: {
|
|
266
|
+
current: string;
|
|
267
|
+
/** `current` when drawn as text or a thin line; readable on `surface.base`. */
|
|
268
|
+
ink: string;
|
|
269
|
+
hot: string;
|
|
270
|
+
glow: string;
|
|
271
|
+
off: string;
|
|
272
|
+
sparks: string[];
|
|
273
|
+
};
|
|
274
|
+
/** Live Wire: motion timings. Components respect prefers-reduced-motion. */
|
|
275
|
+
motion: {
|
|
276
|
+
fast: string;
|
|
277
|
+
normal: string;
|
|
278
|
+
spark: number;
|
|
279
|
+
easing: string;
|
|
280
|
+
};
|
|
281
|
+
padding: {
|
|
282
|
+
small: string;
|
|
283
|
+
medium: string;
|
|
284
|
+
large: string;
|
|
285
|
+
'2xlarge': string;
|
|
286
|
+
'3xlarge': string;
|
|
287
|
+
};
|
|
288
|
+
zIndex: {
|
|
289
|
+
modal: number;
|
|
290
|
+
dropdown: number;
|
|
291
|
+
tooltip: number;
|
|
292
|
+
};
|
|
293
|
+
shadows: {
|
|
294
|
+
extraSmall: string;
|
|
295
|
+
small: string;
|
|
296
|
+
medium: string;
|
|
297
|
+
large: string;
|
|
298
|
+
xlarge: string;
|
|
299
|
+
'2xlarge': string;
|
|
300
|
+
'3xlarge': string;
|
|
301
|
+
};
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
/**
|
|
305
|
+
* Live Wire: Spark UI's default theme. Components carry current: actions throw
|
|
306
|
+
* sparks, toggles close a circuit, inputs charge up as they become valid.
|
|
307
|
+
*/
|
|
308
|
+
declare const defaultTheme: Theme;
|
|
309
|
+
/** @deprecated Same as `Theme`; kept for older imports. */
|
|
310
|
+
type BaseTheme = Theme;
|
|
311
|
+
declare const liveWireTheme: Theme;
|
|
312
|
+
/**
|
|
313
|
+
* Live Wire, light mode. Fills keep their voltage; anything drawn as text or a
|
|
314
|
+
* thin line uses a darker "ink" so it stays readable on white (4.5:1 or more).
|
|
315
|
+
*/
|
|
316
|
+
declare const lightTheme: Theme;
|
|
317
|
+
declare const darkTheme: Theme;
|
|
318
|
+
|
|
319
|
+
/** Every key optional, at every depth. */
|
|
320
|
+
type DeepPartial<T> = T extends (infer U)[] ? U[] : T extends object ? {
|
|
321
|
+
[K in keyof T]?: DeepPartial<T[K]>;
|
|
322
|
+
} : T;
|
|
323
|
+
/**
|
|
324
|
+
* Build a theme by changing only what you need. Everything you leave out keeps
|
|
325
|
+
* its Live Wire value for the chosen mode.
|
|
326
|
+
*
|
|
327
|
+
* @example
|
|
328
|
+
* const ocean = createTheme({ energy: { current: '#3AF2FF', ink: '#3AF2FF' } });
|
|
329
|
+
* const oceanLight = createTheme({ tones: { brand: { fill: '#3AF2FF' } } }, 'light');
|
|
330
|
+
*/
|
|
331
|
+
declare function createTheme(overrides?: DeepPartial<Theme>, mode?: Theme['mode']): Theme;
|
|
332
|
+
|
|
333
|
+
/**
|
|
334
|
+
* Turn a theme into CSS custom properties, e.g. `--spark-energy-current`.
|
|
335
|
+
* The same names are used by `@sparkwire/core/styles.css`, so overriding a
|
|
336
|
+
* variable in plain CSS restyles every component that uses it.
|
|
337
|
+
*/
|
|
338
|
+
declare function themeToCssVars(theme: Theme): Record<string, string>;
|
|
339
|
+
/** The same variables as a CSS rule body, for a <style> tag or a stylesheet. */
|
|
340
|
+
declare function themeToCss(theme: Theme, selector?: string): string;
|
|
341
|
+
|
|
342
|
+
export { type BaseTheme, type DeepPartial, type Sizes, type Theme, type ThemeColors, type ToneName, type ToneTokens, createTheme, darkTheme, defaultTheme, lightTheme, liveWireTheme, themeToCss, themeToCssVars };
|