@adea-ai/ui 0.125.0 → 0.127.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/NOTICE +40 -0
- package/dist/components/theme/index.d.ts +1 -1
- package/dist/components/theme/index.d.ts.map +1 -1
- package/dist/components/theme/index.js +4 -3
- package/dist/components/theme/theme-document.d.ts +25 -1
- package/dist/components/theme/theme-document.d.ts.map +1 -1
- package/dist/components/theme/theme-document.js +18 -3
- package/dist/components/theme/theme-document.js.map +1 -1
- package/dist/components/theme/theme-persistence.d.ts +87 -0
- package/dist/components/theme/theme-persistence.d.ts.map +1 -1
- package/dist/components/theme/theme-persistence.js +63 -2
- package/dist/components/theme/theme-persistence.js.map +1 -1
- package/dist/components/theme/theme-provider.d.ts +40 -40
- package/dist/components/theme/theme-provider.d.ts.map +1 -1
- package/dist/components/theme/theme-provider.js +57 -52
- package/dist/components/theme/theme-provider.js.map +1 -1
- package/dist/components/theme/theme-script.d.ts +100 -0
- package/dist/components/theme/theme-script.d.ts.map +1 -0
- package/dist/components/theme/theme-script.js +57 -0
- package/dist/components/theme/theme-script.js.map +1 -0
- package/dist/components/theme/theme-state.d.ts +58 -0
- package/dist/components/theme/theme-state.d.ts.map +1 -1
- package/dist/components/theme/theme-state.js +22 -1
- package/dist/components/theme/theme-state.js.map +1 -1
- package/dist/index.d.ts +4 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -4
- package/dist/lib/font-zoom.d.ts +25 -0
- package/dist/lib/font-zoom.d.ts.map +1 -0
- package/dist/lib/font-zoom.js +45 -0
- package/dist/lib/font-zoom.js.map +1 -0
- package/dist/lib/preference-store.d.ts +126 -0
- package/dist/lib/preference-store.d.ts.map +1 -0
- package/dist/lib/preference-store.js +126 -0
- package/dist/lib/preference-store.js.map +1 -0
- package/dist/lib/theme-surface.d.ts +71 -0
- package/dist/lib/theme-surface.d.ts.map +1 -0
- package/dist/lib/theme-surface.js +62 -0
- package/dist/lib/theme-surface.js.map +1 -0
- package/dist/lib/themes.d.ts +9 -0
- package/dist/lib/themes.d.ts.map +1 -1
- package/dist/lib/themes.js +12 -1
- package/dist/lib/themes.js.map +1 -1
- package/dist/lib/tokens.d.ts.map +1 -1
- package/dist/lib/tokens.js +15 -0
- package/dist/lib/tokens.js.map +1 -1
- package/dist/r/lib.json +15 -0
- package/dist/r/registry.json +20 -0
- package/dist/r/src/components/theme/index.ts +6 -0
- package/dist/r/src/components/theme/theme-document.ts +51 -2
- package/dist/r/src/components/theme/theme-persistence.ts +167 -0
- package/dist/r/src/components/theme/theme-provider.tsx +115 -50
- package/dist/r/src/components/theme/theme-script.ts +201 -0
- package/dist/r/src/components/theme/theme-state.ts +72 -0
- package/dist/r/src/lib/font-zoom.ts +74 -0
- package/dist/r/src/lib/preference-store.ts +216 -0
- package/dist/r/src/lib/theme-surface.ts +110 -0
- package/dist/r/src/lib/themes.ts +14 -0
- package/dist/r/src/lib/tokens.ts +17 -0
- package/dist/r/src/styles/theme.css +38 -0
- package/dist/r/theming.json +5 -0
- package/package.json +1 -1
- package/registry.json +20 -0
- package/src/components/theme/index.ts +6 -0
- package/src/components/theme/theme-document.ts +51 -2
- package/src/components/theme/theme-persistence.ts +167 -0
- package/src/components/theme/theme-provider.tsx +115 -50
- package/src/components/theme/theme-script.ts +201 -0
- package/src/components/theme/theme-state.ts +72 -0
- package/src/index.ts +26 -0
- package/src/lib/font-zoom.ts +74 -0
- package/src/lib/preference-store.ts +216 -0
- package/src/lib/theme-surface.ts +110 -0
- package/src/lib/themes.ts +14 -0
- package/src/lib/tokens.ts +17 -0
- package/src/styles/theme.css +38 -0
package/dist/r/registry.json
CHANGED
|
@@ -2557,6 +2557,11 @@
|
|
|
2557
2557
|
"type": "registry:ui",
|
|
2558
2558
|
"target": "components/theming/theme-provider.tsx"
|
|
2559
2559
|
},
|
|
2560
|
+
{
|
|
2561
|
+
"path": "src/components/theme/theme-script.ts",
|
|
2562
|
+
"type": "registry:ui",
|
|
2563
|
+
"target": "components/theming/theme-script.ts"
|
|
2564
|
+
},
|
|
2560
2565
|
{
|
|
2561
2566
|
"path": "src/components/theme/theme-state.ts",
|
|
2562
2567
|
"type": "registry:ui",
|
|
@@ -2674,6 +2679,11 @@
|
|
|
2674
2679
|
"type": "registry:lib",
|
|
2675
2680
|
"target": "lib/font-catalog.ts"
|
|
2676
2681
|
},
|
|
2682
|
+
{
|
|
2683
|
+
"path": "src/lib/font-zoom.ts",
|
|
2684
|
+
"type": "registry:lib",
|
|
2685
|
+
"target": "lib/font-zoom.ts"
|
|
2686
|
+
},
|
|
2677
2687
|
{
|
|
2678
2688
|
"path": "src/lib/form-field.ts",
|
|
2679
2689
|
"type": "registry:lib",
|
|
@@ -2689,6 +2699,11 @@
|
|
|
2689
2699
|
"type": "registry:lib",
|
|
2690
2700
|
"target": "lib/overlay.ts"
|
|
2691
2701
|
},
|
|
2702
|
+
{
|
|
2703
|
+
"path": "src/lib/preference-store.ts",
|
|
2704
|
+
"type": "registry:lib",
|
|
2705
|
+
"target": "lib/preference-store.ts"
|
|
2706
|
+
},
|
|
2692
2707
|
{
|
|
2693
2708
|
"path": "src/lib/safe-script.ts",
|
|
2694
2709
|
"type": "registry:lib",
|
|
@@ -2699,6 +2714,11 @@
|
|
|
2699
2714
|
"type": "registry:lib",
|
|
2700
2715
|
"target": "lib/theme-accents.ts"
|
|
2701
2716
|
},
|
|
2717
|
+
{
|
|
2718
|
+
"path": "src/lib/theme-surface.ts",
|
|
2719
|
+
"type": "registry:lib",
|
|
2720
|
+
"target": "lib/theme-surface.ts"
|
|
2721
|
+
},
|
|
2702
2722
|
{
|
|
2703
2723
|
"path": "src/lib/themes.ts",
|
|
2704
2724
|
"type": "registry:lib",
|
|
@@ -9,6 +9,7 @@ export {
|
|
|
9
9
|
} from './theme-picker'
|
|
10
10
|
export {
|
|
11
11
|
ThemeProvider,
|
|
12
|
+
createVersionedPersistence,
|
|
12
13
|
defaultThemeSelection,
|
|
13
14
|
inlineScriptLiteral,
|
|
14
15
|
localStoragePersistence,
|
|
@@ -20,7 +21,12 @@ export {
|
|
|
20
21
|
type ThemeDensity,
|
|
21
22
|
type ThemePersistence,
|
|
22
23
|
type ThemeProviderProps,
|
|
24
|
+
type ThemeScriptOptions,
|
|
23
25
|
type ThemeSelection,
|
|
26
|
+
type ThemeStorageSchema,
|
|
27
|
+
type ThemeSurface,
|
|
28
|
+
type VersionedCodec,
|
|
29
|
+
type VersionedPersistenceOptions,
|
|
24
30
|
} from './theme-provider'
|
|
25
31
|
export { ThemeToggle, type ThemeToggleProps } from './theme-toggle'
|
|
26
32
|
export { ThemeModeToggle, type ThemeModeToggleProps } from './theme-mode-toggle'
|
|
@@ -4,11 +4,14 @@ import {
|
|
|
4
4
|
} from '../../lib/appearance-font-settings'
|
|
5
5
|
import {
|
|
6
6
|
accentVariables,
|
|
7
|
+
terminalCssVariables,
|
|
8
|
+
themeById,
|
|
7
9
|
themeCssVariables,
|
|
8
10
|
type ThemeAppearance,
|
|
9
11
|
type ThemeVariant,
|
|
10
12
|
} from '../../lib/themes'
|
|
11
13
|
import { isCustomAccent } from '../../lib/accent-roles'
|
|
14
|
+
import { surfaceAlpha, type SurfaceState } from '../../lib/theme-surface'
|
|
12
15
|
import { resolvedDensity, type ThemeSelection } from './theme-state'
|
|
13
16
|
|
|
14
17
|
/**
|
|
@@ -27,6 +30,16 @@ export type ThemeDocumentState = {
|
|
|
27
30
|
selection: ThemeSelection
|
|
28
31
|
appearance: ThemeAppearance
|
|
29
32
|
variant: ThemeVariant
|
|
33
|
+
/**
|
|
34
|
+
* The variant whose terminal palette is pinned over the interface variant's.
|
|
35
|
+
* Absent, the terminal follows the interface theme.
|
|
36
|
+
*/
|
|
37
|
+
terminalVariant?: ThemeVariant
|
|
38
|
+
/**
|
|
39
|
+
* The resolved surface axis. Absent, the axis is off: no attribute and no
|
|
40
|
+
* `--surface-alpha` is written, and any this writer wrote before is removed.
|
|
41
|
+
*/
|
|
42
|
+
surface?: SurfaceState
|
|
30
43
|
}
|
|
31
44
|
|
|
32
45
|
export type ThemeDocumentOptions = {
|
|
@@ -42,11 +55,29 @@ export type ThemeDocumentOptions = {
|
|
|
42
55
|
* only a custom `#rrggbb` is held to the default floor of 3:1.
|
|
43
56
|
*/
|
|
44
57
|
accentContrastFloor?: number
|
|
58
|
+
/**
|
|
59
|
+
* Where a catalogue variant's palette comes from. `inline` (the default) writes
|
|
60
|
+
* every role onto the root. `stylesheet` writes none for a catalogue variant,
|
|
61
|
+
* because the host loads a stylesheet that carries a `[data-theme]` block for it;
|
|
62
|
+
* a variant the catalogue does not hold (a host's imported theme) is still written
|
|
63
|
+
* inline, since no stylesheet can know it. The accent, the terminal pin, the
|
|
64
|
+
* surface alpha and the fonts are written the same in both.
|
|
65
|
+
*
|
|
66
|
+
* Switching from an imported variant back to a catalogue one removes what the
|
|
67
|
+
* imported one wrote, so nothing inline outlives it to beat the stylesheet.
|
|
68
|
+
*/
|
|
69
|
+
palette?: 'inline' | 'stylesheet'
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** True for the catalogue's own variant, not a host's copy that merely shares its id. */
|
|
73
|
+
function isCatalogueVariant(variant: ThemeVariant): boolean {
|
|
74
|
+
return themeById(variant.id) === variant
|
|
45
75
|
}
|
|
46
76
|
|
|
47
77
|
/**
|
|
48
78
|
* The custom properties a state paints: the variant's roles, with the accent
|
|
49
|
-
* selection laid over them,
|
|
79
|
+
* selection laid over them, the pinned terminal palette over that, the surface
|
|
80
|
+
* alpha, then `transformTokens`.
|
|
50
81
|
*
|
|
51
82
|
* The accent is applied *here* rather than left to the `[data-accent]` blocks in
|
|
52
83
|
* `theme.css`, because the properties are written inline and an inline declaration
|
|
@@ -59,13 +90,20 @@ export function themeDocumentTokens(
|
|
|
59
90
|
state: ThemeDocumentState,
|
|
60
91
|
options: ThemeDocumentOptions = {}
|
|
61
92
|
): { tokens: Record<string, string>; accented: boolean } {
|
|
62
|
-
const
|
|
93
|
+
const fromStylesheet = options.palette === 'stylesheet' && isCatalogueVariant(state.variant)
|
|
94
|
+
const properties = fromStylesheet ? {} : { ...themeCssVariables(state.variant) }
|
|
63
95
|
const accent = accentVariables(state.selection.accent, state.appearance, state.selection, {
|
|
64
96
|
background: state.variant.colors.background,
|
|
65
97
|
floor: options.accentContrastFloor,
|
|
66
98
|
variantId: state.variant.id,
|
|
67
99
|
})
|
|
68
100
|
if (accent) Object.assign(properties, accent)
|
|
101
|
+
// Written after the variant and the accent, so it wins over the interface
|
|
102
|
+
// variant's own terminal ramp (and over the stylesheet's, which it outranks as an
|
|
103
|
+
// inline declaration). Dropping the pin needs no removal of its own: the ramp is
|
|
104
|
+
// then rewritten by the variant, or swept back to the stylesheet.
|
|
105
|
+
if (state.terminalVariant) Object.assign(properties, terminalCssVariables(state.terminalVariant))
|
|
106
|
+
if (state.surface) properties['--surface-alpha'] = surfaceAlpha[state.surface.surface]
|
|
69
107
|
return {
|
|
70
108
|
tokens: options.transformTokens ? options.transformTokens(properties) : properties,
|
|
71
109
|
accented: accent !== undefined,
|
|
@@ -111,6 +149,17 @@ export function applyThemeToRoot(
|
|
|
111
149
|
? 'custom'
|
|
112
150
|
: state.selection.accent
|
|
113
151
|
|
|
152
|
+
// The surface axis is opt-in, so its absence removes rather than defaults: a host
|
|
153
|
+
// that never enables it keeps an `<html>` with neither attribute, and one that
|
|
154
|
+
// turns it off leaves nothing behind. (`--surface-alpha` is swept with the tokens.)
|
|
155
|
+
if (state.surface) {
|
|
156
|
+
root.dataset['surface'] = state.surface.surface
|
|
157
|
+
root.dataset['reduceTransparency'] = state.surface.reduceTransparencyActive ? 'true' : 'false'
|
|
158
|
+
} else {
|
|
159
|
+
root.removeAttribute('data-surface')
|
|
160
|
+
root.removeAttribute('data-reduce-transparency')
|
|
161
|
+
}
|
|
162
|
+
|
|
114
163
|
applyAppearanceFontSettings(
|
|
115
164
|
root,
|
|
116
165
|
normalizeAppearanceEditorFontSettings(state.selection.fonts, state.selection.font).settings
|
|
@@ -2,6 +2,15 @@ import { normalizeCustomAccent } from '../../lib/accent-roles'
|
|
|
2
2
|
import { accentPresets } from '../../lib/tokens'
|
|
3
3
|
import { normalizeAppearanceEditorFontSettings } from '../../lib/appearance-font-settings'
|
|
4
4
|
import { defaultDarkThemeId, defaultLightThemeId, isThemeAccentId, themeById } from '../../lib/themes'
|
|
5
|
+
import { normalizeSurface } from '../../lib/theme-surface'
|
|
6
|
+
import {
|
|
7
|
+
defaultPreferenceStorage,
|
|
8
|
+
readLegacyValue,
|
|
9
|
+
readVersionedRecord,
|
|
10
|
+
recoveryKeyFor,
|
|
11
|
+
writeVersionedRecord,
|
|
12
|
+
type PreferenceStorage,
|
|
13
|
+
} from '../../lib/preference-store'
|
|
5
14
|
import { defaultThemeSelection, resolvedDensity, type ThemeSelection } from './theme-state'
|
|
6
15
|
|
|
7
16
|
/**
|
|
@@ -83,6 +92,17 @@ function readSelection(storageKey: string): ThemeSelection {
|
|
|
83
92
|
// document effect removes the `data-density` that `themeScript` set for the first paint, and
|
|
84
93
|
// the next `setSelection` rewrites the store without it.
|
|
85
94
|
density: resolvedDensity(parsed as ThemeSelection),
|
|
95
|
+
// The newer axes are read back only when the store holds a usable value and are
|
|
96
|
+
// otherwise left `undefined`, never defaulted: `JSON.stringify` drops them, so a
|
|
97
|
+
// consumer that never sets one writes the bytes it always did. An id is kept as
|
|
98
|
+
// stored, known or not, for the same reason a theme id the registry lacks is.
|
|
99
|
+
terminalThemeId:
|
|
100
|
+
typeof parsed.terminalThemeId === 'string' && parsed.terminalThemeId.trim() !== ''
|
|
101
|
+
? parsed.terminalThemeId
|
|
102
|
+
: undefined,
|
|
103
|
+
surface: normalizeSurface(parsed.surface),
|
|
104
|
+
reduceTransparency:
|
|
105
|
+
typeof parsed.reduceTransparency === 'boolean' ? parsed.reduceTransparency : undefined,
|
|
86
106
|
}
|
|
87
107
|
} catch {
|
|
88
108
|
return defaultThemeSelection
|
|
@@ -141,3 +161,150 @@ export function writePersisted(persistence: ThemePersistence, next: ThemeSelecti
|
|
|
141
161
|
// session and does not survive the reload.
|
|
142
162
|
}
|
|
143
163
|
}
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* Where a host's versioned preference document lives. One schema describes the
|
|
167
|
+
* document to both halves of the system: {@link createVersionedPersistence} reads and
|
|
168
|
+
* writes it, and `themeScript(options)` reads it before first paint, so the two
|
|
169
|
+
* cannot disagree about a key or a version.
|
|
170
|
+
*/
|
|
171
|
+
export type ThemeStorageSchema = {
|
|
172
|
+
/** The storage key of the document. */
|
|
173
|
+
key: string
|
|
174
|
+
/**
|
|
175
|
+
* The only top-level `version` read. Absent, the document is unversioned. A record
|
|
176
|
+
* of any other version is quarantined (see `recoveryKey`), not interpreted.
|
|
177
|
+
*/
|
|
178
|
+
version?: number
|
|
179
|
+
/**
|
|
180
|
+
* The document field that holds the appearance preference (`system`, `light`,
|
|
181
|
+
* `dark`). Read by `themeScript`; the persistence leaves field names to the codec.
|
|
182
|
+
* Default `appearance`.
|
|
183
|
+
*/
|
|
184
|
+
appearanceField?: 'appearance' | 'mode'
|
|
185
|
+
/**
|
|
186
|
+
* An older single-value key (`light` | `dark` | `system`) read only while `key` is
|
|
187
|
+
* absent, and never deleted. The persistence hands it to the codec's `fromLegacy`.
|
|
188
|
+
*/
|
|
189
|
+
legacyAppearanceKey?: string
|
|
190
|
+
/**
|
|
191
|
+
* The stored library of imported themes, for `themeScript` only: an imported
|
|
192
|
+
* theme's id and verbatim tokens, so the first paint can use the right variant. The
|
|
193
|
+
* persistence neither reads nor writes it.
|
|
194
|
+
*/
|
|
195
|
+
libraryKey?: string
|
|
196
|
+
/** Where an unreadable document is kept. Default `${key}.recovery`. */
|
|
197
|
+
recoveryKey?: string
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* How a host's document maps to and from the shared {@link ThemeSelection}.
|
|
202
|
+
*
|
|
203
|
+
* The codec is the product schema: it decides which fields a document has, how an
|
|
204
|
+
* unknown value is corrected, and what a fresh install looks like. The engine decides
|
|
205
|
+
* everything about *storage*: what is quarantined, when the legacy key is read, and
|
|
206
|
+
* that nothing is written until `setSelection` asks.
|
|
207
|
+
*/
|
|
208
|
+
export type VersionedCodec<Doc> = {
|
|
209
|
+
/**
|
|
210
|
+
* A readable record (the right JSON shape and version) as a selection patch. Fields
|
|
211
|
+
* it leaves `undefined` fall back to the provider's defaults. It may keep an id the
|
|
212
|
+
* catalogue lacks; the provider resolves it, it does not rewrite it.
|
|
213
|
+
*/
|
|
214
|
+
decode(record: Readonly<Record<string, unknown>>): Partial<ThemeSelection>
|
|
215
|
+
/**
|
|
216
|
+
* The legacy key's value (never `null`) as a selection patch, or `undefined` for a
|
|
217
|
+
* value it does not recognise. Called only when the main key is absent.
|
|
218
|
+
*/
|
|
219
|
+
fromLegacy?(value: string): Partial<ThemeSelection> | undefined
|
|
220
|
+
/**
|
|
221
|
+
* What a store with nothing readable answers: a fresh install, an unreadable
|
|
222
|
+
* document, a blocked store. Absent, the provider's own defaults apply.
|
|
223
|
+
*/
|
|
224
|
+
defaults?(): Partial<ThemeSelection> | undefined
|
|
225
|
+
/**
|
|
226
|
+
* The document to store for a selection. `previous` is the record last read or
|
|
227
|
+
* written, so a codec can carry a field the selection does not model.
|
|
228
|
+
*/
|
|
229
|
+
encode(next: ThemeSelection, previous?: Readonly<Record<string, unknown>>): Doc
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
/** Seams for the storage and the clock; both default to the real ones. */
|
|
233
|
+
export type VersionedPersistenceOptions = {
|
|
234
|
+
/** The store, or nothing. Called per access; default is `localStorage` (blocked-safe). */
|
|
235
|
+
storage?: () => PreferenceStorage | undefined
|
|
236
|
+
/** The clock for the recovery envelope's `capturedAt`. */
|
|
237
|
+
now?: () => Date
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* A {@link ThemePersistence} over a versioned document and a host codec.
|
|
242
|
+
*
|
|
243
|
+
* `read` follows the engine's rules (`lib/preference-store.ts`): the main key first;
|
|
244
|
+
* an unreadable or unsupported document is quarantined byte for byte into the
|
|
245
|
+
* recovery key and the codec's `defaults` answer; the legacy key only when the main
|
|
246
|
+
* key is absent. It never writes the main key, so the first write is a user's
|
|
247
|
+
* decision. `write` stores `codec.encode(next, previous)` as JSON and swallows a
|
|
248
|
+
* failure.
|
|
249
|
+
*
|
|
250
|
+
* Neither method throws. The stored bytes are exactly what the codec encodes, so a
|
|
251
|
+
* host keeps its keys, field names and bytes by keeping its codec.
|
|
252
|
+
*/
|
|
253
|
+
export function createVersionedPersistence<Doc>(
|
|
254
|
+
schema: ThemeStorageSchema,
|
|
255
|
+
codec: VersionedCodec<Doc>,
|
|
256
|
+
options: VersionedPersistenceOptions = {}
|
|
257
|
+
): ThemePersistence {
|
|
258
|
+
const storageOf = options.storage ?? defaultPreferenceStorage
|
|
259
|
+
const recordSchema = {
|
|
260
|
+
key: schema.key,
|
|
261
|
+
version: schema.version,
|
|
262
|
+
recoveryKey: recoveryKeyFor(schema),
|
|
263
|
+
}
|
|
264
|
+
let previous: Readonly<Record<string, unknown>> | undefined
|
|
265
|
+
|
|
266
|
+
const fallback = () => {
|
|
267
|
+
try {
|
|
268
|
+
return codec.defaults?.()
|
|
269
|
+
} catch {
|
|
270
|
+
return undefined
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
return {
|
|
275
|
+
read() {
|
|
276
|
+
const storage = storageOf()
|
|
277
|
+
if (!storage) return fallback()
|
|
278
|
+
try {
|
|
279
|
+
const found = readVersionedRecord(storage, recordSchema, options.now)
|
|
280
|
+
if (found.status === 'record') {
|
|
281
|
+
previous = found.record
|
|
282
|
+
return codec.decode(found.record)
|
|
283
|
+
}
|
|
284
|
+
if (found.status === 'absent' && schema.legacyAppearanceKey && codec.fromLegacy) {
|
|
285
|
+
const legacy = readLegacyValue(storage, schema.legacyAppearanceKey)
|
|
286
|
+
const migrated = legacy === null ? undefined : codec.fromLegacy(legacy)
|
|
287
|
+
if (migrated) return migrated
|
|
288
|
+
}
|
|
289
|
+
} catch {
|
|
290
|
+
// A codec that throws on a record it cannot read is an unreadable store.
|
|
291
|
+
}
|
|
292
|
+
return fallback()
|
|
293
|
+
},
|
|
294
|
+
write(next) {
|
|
295
|
+
const storage = storageOf()
|
|
296
|
+
if (!storage) return
|
|
297
|
+
try {
|
|
298
|
+
const document = codec.encode(next, previous)
|
|
299
|
+
if (writeVersionedRecord(storage, schema.key, document)) {
|
|
300
|
+
previous =
|
|
301
|
+
typeof document === 'object' && document !== null
|
|
302
|
+
? (document as Readonly<Record<string, unknown>>)
|
|
303
|
+
: undefined
|
|
304
|
+
}
|
|
305
|
+
} catch {
|
|
306
|
+
// An encoder that throws loses the preference, not the switch.
|
|
307
|
+
}
|
|
308
|
+
},
|
|
309
|
+
}
|
|
310
|
+
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { JSX } from 'solid-js'
|
|
2
|
-
import { createEffect, createMemo, createSignal, onCleanup, splitProps } from 'solid-js'
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
2
|
+
import { createEffect, createMemo, createSignal, onCleanup, splitProps, untrack } from 'solid-js'
|
|
3
|
+
import { fontZoomShortcut, type FontZoomIntent } from '../../lib/font-zoom'
|
|
4
|
+
import { REDUCED_TRANSPARENCY_QUERY, resolveSurfaceState } from '../../lib/theme-surface'
|
|
5
5
|
import {
|
|
6
6
|
builtinThemes,
|
|
7
7
|
themeAccentsFor,
|
|
@@ -21,13 +21,24 @@ import {
|
|
|
21
21
|
initialThemeSelection,
|
|
22
22
|
mergeRegistry,
|
|
23
23
|
mergeThemeSelection,
|
|
24
|
+
resolveTerminalVariant,
|
|
24
25
|
resolveThemeState,
|
|
26
|
+
zoomedFontSettings,
|
|
25
27
|
type ThemeContextValue,
|
|
26
28
|
type ThemeSelection,
|
|
27
29
|
} from './theme-state'
|
|
28
30
|
|
|
29
31
|
export { useOptionalTheme, useTheme } from './theme-context'
|
|
30
|
-
export {
|
|
32
|
+
export {
|
|
33
|
+
createVersionedPersistence,
|
|
34
|
+
localStoragePersistence,
|
|
35
|
+
type ThemePersistence,
|
|
36
|
+
type ThemeStorageSchema,
|
|
37
|
+
type VersionedCodec,
|
|
38
|
+
type VersionedPersistenceOptions,
|
|
39
|
+
} from './theme-persistence'
|
|
40
|
+
export type { ThemeSurface } from '../../lib/theme-surface'
|
|
41
|
+
export { inlineScriptLiteral, themeScript, type ThemeScriptOptions } from './theme-script'
|
|
31
42
|
export {
|
|
32
43
|
defaultThemeSelection,
|
|
33
44
|
resolvedDensity,
|
|
@@ -121,6 +132,48 @@ export type ThemeProviderProps = {
|
|
|
121
132
|
* own themes the floor changes no preset.
|
|
122
133
|
*/
|
|
123
134
|
accentContrastFloor?: number
|
|
135
|
+
/**
|
|
136
|
+
* Turns the surface axis on: `selection.surface` and `selection.reduceTransparency`
|
|
137
|
+
* are resolved against the operating system's Reduce Transparency setting and the
|
|
138
|
+
* host's capability, and `data-surface`, `data-reduce-transparency` and
|
|
139
|
+
* `--surface-alpha` are written to `<html>` (the frost rule in `theme.css` reads
|
|
140
|
+
* them). Off by default: a provider that never opts in writes none of them, adds no
|
|
141
|
+
* media-query listener, and stores nothing new.
|
|
142
|
+
*
|
|
143
|
+
* An object also states the host's capability. `nativeTranslucency` is whether the
|
|
144
|
+
* window can render the OS's own translucency; without it a `translucent`
|
|
145
|
+
* preference paints the tokenized `frosted` surface instead of pretending to
|
|
146
|
+
* vibrancy. A function is read inside the provider's reactive scope, for a
|
|
147
|
+
* capability that is learned after mount.
|
|
148
|
+
*
|
|
149
|
+
* A selection that already carries a `surface` turns the axis on for itself, so a
|
|
150
|
+
* host that stores the field gets the same document without the prop.
|
|
151
|
+
*/
|
|
152
|
+
surface?: boolean | { nativeTranslucency?: boolean | (() => boolean) }
|
|
153
|
+
/**
|
|
154
|
+
* Where a catalogue variant's palette comes from. `inline` (the default) writes
|
|
155
|
+
* every role onto `<html>`. `stylesheet` leaves a catalogue variant to the host's
|
|
156
|
+
* `[data-theme]` stylesheet and writes inline only what no stylesheet can know: a
|
|
157
|
+
* host's own `themes`, the accent, the pinned terminal palette, the surface alpha
|
|
158
|
+
* and the fonts. Switching from a host variant back to a catalogue one removes the
|
|
159
|
+
* properties the host variant wrote.
|
|
160
|
+
*/
|
|
161
|
+
palette?: 'inline' | 'stylesheet'
|
|
162
|
+
/**
|
|
163
|
+
* Bind the platform zoom chords (Cmd or Ctrl with `=`, `+`, `-`, `0`) to the three
|
|
164
|
+
* text sizes instead of the browser's page zoom: stepping them together is zoom
|
|
165
|
+
* inside the persisted type system. Off by default: it adds a capturing `keydown`
|
|
166
|
+
* listener to `window`, and an event already handled elsewhere is left alone.
|
|
167
|
+
* `zoomFonts` on the context does the same from a menu or a host's own binding.
|
|
168
|
+
*/
|
|
169
|
+
fontZoom?: boolean
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** The operating system's Reduce Transparency query, where there is a window to ask. */
|
|
173
|
+
function reducedTransparencyMedia(): MediaQueryList | undefined {
|
|
174
|
+
return typeof window !== 'undefined' && typeof window.matchMedia === 'function'
|
|
175
|
+
? window.matchMedia(REDUCED_TRANSPARENCY_QUERY)
|
|
176
|
+
: undefined
|
|
124
177
|
}
|
|
125
178
|
|
|
126
179
|
export function ThemeProvider(props: ThemeProviderProps) {
|
|
@@ -134,6 +187,9 @@ export function ThemeProvider(props: ThemeProviderProps) {
|
|
|
134
187
|
'transformTokens',
|
|
135
188
|
'disableTransitionOnChange',
|
|
136
189
|
'accentContrastFloor',
|
|
190
|
+
'surface',
|
|
191
|
+
'palette',
|
|
192
|
+
'fontZoom',
|
|
137
193
|
])
|
|
138
194
|
const storageKey = () => local.storageKey ?? 'adea-appearance'
|
|
139
195
|
const persistence = local.persistence ?? localStoragePersistence(storageKey)
|
|
@@ -186,6 +242,37 @@ export function ThemeProvider(props: ThemeProviderProps) {
|
|
|
186
242
|
draft() ? resolveThemeState(shownSelection(), systemAppearance(), registry()) : committed()
|
|
187
243
|
)
|
|
188
244
|
|
|
245
|
+
// The surface axis. Off, none of this reads the operating system: the media query
|
|
246
|
+
// is subscribed only while the axis is on, so a provider that never opts in adds no
|
|
247
|
+
// listener and no repaint.
|
|
248
|
+
const surfaceOn = (candidate: ThemeSelection) =>
|
|
249
|
+
local.surface === true || typeof local.surface === 'object' || candidate.surface !== undefined
|
|
250
|
+
const nativeTranslucency = () => {
|
|
251
|
+
const capability = typeof local.surface === 'object' ? local.surface.nativeTranslucency : false
|
|
252
|
+
return (typeof capability === 'function' ? capability() : capability) === true
|
|
253
|
+
}
|
|
254
|
+
const [osReducedTransparency, setOsReducedTransparency] = createSignal(
|
|
255
|
+
surfaceOn(untrack(shownSelection)) ? (reducedTransparencyMedia()?.matches ?? false) : false
|
|
256
|
+
)
|
|
257
|
+
const axisOn = createMemo(() => surfaceOn(shownSelection()))
|
|
258
|
+
createEffect(() => {
|
|
259
|
+
const query = axisOn() ? reducedTransparencyMedia() : undefined
|
|
260
|
+
setOsReducedTransparency(query?.matches ?? false)
|
|
261
|
+
if (!query) return
|
|
262
|
+
const onChange = (event: MediaQueryListEvent) => setOsReducedTransparency(event.matches)
|
|
263
|
+
query.addEventListener('change', onChange)
|
|
264
|
+
onCleanup(() => query.removeEventListener('change', onChange))
|
|
265
|
+
})
|
|
266
|
+
const surfaceStateOf = (candidate: ThemeSelection) =>
|
|
267
|
+
resolveSurfaceState(candidate.surface, {
|
|
268
|
+
osReducedTransparency: osReducedTransparency(),
|
|
269
|
+
userReducedTransparency: candidate.reduceTransparency === true,
|
|
270
|
+
nativeTranslucency: nativeTranslucency(),
|
|
271
|
+
})
|
|
272
|
+
const committedSurface = createMemo(() =>
|
|
273
|
+
surfaceOn(selection()) ? surfaceStateOf(selection()) : undefined
|
|
274
|
+
)
|
|
275
|
+
|
|
189
276
|
let written: ReadonlySet<string> | undefined
|
|
190
277
|
let restoreTransitions: (() => void) | undefined
|
|
191
278
|
createEffect(() => {
|
|
@@ -194,10 +281,13 @@ export function ThemeProvider(props: ThemeProviderProps) {
|
|
|
194
281
|
selection: shownSelection(),
|
|
195
282
|
appearance: shown().appearance,
|
|
196
283
|
variant: shown().variant,
|
|
284
|
+
terminalVariant: resolveTerminalVariant(shownSelection().terminalThemeId, registry()),
|
|
285
|
+
surface: axisOn() ? surfaceStateOf(shownSelection()) : undefined,
|
|
197
286
|
}
|
|
198
287
|
const options = {
|
|
199
288
|
transformTokens: local.transformTokens,
|
|
200
289
|
accentContrastFloor: local.accentContrastFloor,
|
|
290
|
+
palette: local.palette,
|
|
201
291
|
}
|
|
202
292
|
const apply = () => {
|
|
203
293
|
written = applyThemeToRoot(document.documentElement, state, options, written)
|
|
@@ -215,6 +305,24 @@ export function ThemeProvider(props: ThemeProviderProps) {
|
|
|
215
305
|
themeAccentsFor(selection().lightThemeId, selection().darkThemeId)
|
|
216
306
|
)
|
|
217
307
|
|
|
308
|
+
const zoomFonts = (intent: FontZoomIntent) =>
|
|
309
|
+
value.setSelection({ fonts: zoomedFontSettings(selection(), intent) })
|
|
310
|
+
|
|
311
|
+
// The platform zoom chords drive the three text sizes, captured like the other
|
|
312
|
+
// global chords; an event something else already handled never double-steps.
|
|
313
|
+
const onKeyDown = (event: KeyboardEvent) => {
|
|
314
|
+
if (event.defaultPrevented) return
|
|
315
|
+
const intent = fontZoomShortcut(event)
|
|
316
|
+
if (!intent) return
|
|
317
|
+
event.preventDefault()
|
|
318
|
+
zoomFonts(intent)
|
|
319
|
+
}
|
|
320
|
+
createEffect(() => {
|
|
321
|
+
if (!local.fontZoom || typeof window === 'undefined') return
|
|
322
|
+
window.addEventListener('keydown', onKeyDown, { capture: true })
|
|
323
|
+
onCleanup(() => window.removeEventListener('keydown', onKeyDown, { capture: true }))
|
|
324
|
+
})
|
|
325
|
+
|
|
218
326
|
const value: ThemeContextValue = {
|
|
219
327
|
selection,
|
|
220
328
|
resolvedAppearance,
|
|
@@ -233,6 +341,9 @@ export function ThemeProvider(props: ThemeProviderProps) {
|
|
|
233
341
|
registry: registry(),
|
|
234
342
|
accentContrastFloor: local.accentContrastFloor,
|
|
235
343
|
}),
|
|
344
|
+
effectiveSurface: () => committedSurface()?.surface ?? 'opaque',
|
|
345
|
+
reduceTransparencyActive: () => committedSurface()?.reduceTransparencyActive ?? false,
|
|
346
|
+
zoomFonts,
|
|
236
347
|
setSelection(patch) {
|
|
237
348
|
const next = mergeThemeSelection(selection(), patch)
|
|
238
349
|
setSelectionState(next)
|
|
@@ -245,49 +356,3 @@ export function ThemeProvider(props: ThemeProviderProps) {
|
|
|
245
356
|
const Context = themeContext()
|
|
246
357
|
return <Context.Provider value={value}>{local.children}</Context.Provider>
|
|
247
358
|
}
|
|
248
|
-
|
|
249
|
-
/**
|
|
250
|
-
* A string as a JavaScript literal that is also safe inside an inline `<script>`.
|
|
251
|
-
*
|
|
252
|
-
* `JSON.stringify` produces a correct JavaScript literal, and it is **not** safe
|
|
253
|
-
* here: it leaves `<` and `>` alone, so a value containing `</script>` ends the tag
|
|
254
|
-
* early and everything after it is parsed as HTML. That is the classic inline-script
|
|
255
|
-
* injection, and it is a real one even though the value is a developer-supplied prop
|
|
256
|
-
* rather than user input — a prop can come from configuration, and a key that happens
|
|
257
|
-
* to contain a closing tag should not be able to execute.
|
|
258
|
-
*
|
|
259
|
-
* The escape is also correct JavaScript: `\u003c` is `<` to the parser, so the value
|
|
260
|
-
* is byte-identical at runtime and inert to the HTML tokenizer. `\u2028` and `\u2029`
|
|
261
|
-
* are escaped for the neighbouring reason — they are legal inside a JSON string and
|
|
262
|
-
* were, before ES2019, line terminators to a JavaScript parser.
|
|
263
|
-
*
|
|
264
|
-
* CodeQL flags the unescaped form as `js/bad-code-sanitization`, which is how this
|
|
265
|
-
* was found; `tests/theme-script.test.ts` pins it so it cannot come back.
|
|
266
|
-
*/
|
|
267
|
-
export function inlineScriptLiteral(value: string): string {
|
|
268
|
-
return safeScriptStringLiteral(value)
|
|
269
|
-
}
|
|
270
|
-
|
|
271
|
-
/**
|
|
272
|
-
* The no-flash script.
|
|
273
|
-
*
|
|
274
|
-
* Rendered inline in `<head>` before any stylesheet that matters. Without it a dark
|
|
275
|
-
* preference paints the light theme first and then swaps, which is the flash every
|
|
276
|
-
* themed application has to solve and the one thing a provider cannot do from
|
|
277
|
-
* inside the body.
|
|
278
|
-
*
|
|
279
|
-
* Deliberately tiny and dependency-free: it reads the stored preference, resolves
|
|
280
|
-
* `system`, and sets the class. It does not apply the variant's roles — the default
|
|
281
|
-
* theme in `theme.css` covers the first paint, and the provider writes the rest on
|
|
282
|
-
* mount.
|
|
283
|
-
*
|
|
284
|
-
* The script reads two values out of `localStorage` and writes them to `dataset`,
|
|
285
|
-
* which is a *property* assignment rather than code: a stored accent or font id can
|
|
286
|
-
* set an attribute and cannot execute. The one value that reaches the source as text
|
|
287
|
-
* is `storageKey`, and it goes through {@link inlineScriptLiteral} for the reason
|
|
288
|
-
* documented there.
|
|
289
|
-
*/
|
|
290
|
-
export function themeScript(storageKey = 'adea-appearance'): string {
|
|
291
|
-
const script = `(function(){try{var s=localStorage.getItem(${inlineScriptLiteral(storageKey)});var p=s?JSON.parse(s):{};var a=p.appearance||'system';var d=a==='dark'||(a==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches);var r=document.documentElement;if(d)r.classList.add('dark');r.style.colorScheme=d?'dark':'light';if(p.accent&&p.accent!=='theme')r.dataset.accent=p.accent;if(p.density==='compact')r.dataset.density='compact';}catch(e){}})();`
|
|
292
|
-
return `${script}${fontSettingsBootstrapScript(storageKey)}`
|
|
293
|
-
}
|