@dloizides/design-tokens 1.10.0 → 1.12.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/CHANGELOG.md +27 -0
- package/README.md +1 -0
- package/dist/index.d.mts +124 -23
- package/dist/index.d.ts +124 -23
- package/dist/index.js +202 -43
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +201 -44
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,32 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.12.0
|
|
4
|
+
|
|
5
|
+
- New `INTERVIEWPREP_TOKENS` preset + `INTERVIEWPREP_CSS_VAR_NAMES`, seeded from InterviewPrep theme.css (REDESIGN-IP-1 Q-TOKENS "New interviewprep preset").
|
|
6
|
+
- `toCssVars` `lightSelector` option: dark-first output (dark in `:root`, light in the given selector). Light-first output is byte-identical.
|
|
7
|
+
- `CssVarNames` gains per-mode names for the optional `ModeColors` fields (textTertiary, focusRing, brandFill, onBrandFill, successText, dangerText, dangerFill).
|
|
8
|
+
|
|
9
|
+
## 1.11.0
|
|
10
|
+
|
|
11
|
+
**Optional mode extras, increased-contrast overrides, motion springs, and the D1 "Living Room" `nextgame` preset.**
|
|
12
|
+
|
|
13
|
+
Additive types: no existing field changes and no emitter reads the new ones, so other presets
|
|
14
|
+
and consumers are byte-identical.
|
|
15
|
+
|
|
16
|
+
- `ModeColors` gains optional `textTertiary`, `focusRing`, `brandFill`, `onBrandFill`,
|
|
17
|
+
`successText`, `dangerText`, `dangerFill`.
|
|
18
|
+
- `DesignTokens.contrastMore?: ContrastMoreOverrides` — per-mode `Partial<ModeColors>` plus
|
|
19
|
+
`focusRingWidth`, applied under `prefers-contrast: more`.
|
|
20
|
+
- `Motion.springs?: MotionSprings` (`focus` / `settle` / `press`, each `{ stiffness, damping }`).
|
|
21
|
+
`DEFAULT_MOTION` is unchanged.
|
|
22
|
+
- New exported types: `MotionSpring`, `MotionSprings`, `ContrastMoreOverrides`.
|
|
23
|
+
- `NEXTGAME_TOKENS` rebuilt for the dark console dashboard (sole consumer: nextgame-web):
|
|
24
|
+
graphite dark grounds (`#0A0D12` / `#121720` / `#1A212C`), amber `#FFD37A` brand fill with
|
|
25
|
+
`#1A1204` ink, white focus ring, dark-tuned success and danger text, contrast-more tiers,
|
|
26
|
+
Barlow type, spec §6 durations (160/240/320ms) and easings, springs. The light-surface
|
|
27
|
+
amber/teal/magenta triad is kept for OG images and email. `monoFamily` is dropped and
|
|
28
|
+
`headingScale` is now 1.
|
|
29
|
+
|
|
3
30
|
## 1.10.0
|
|
4
31
|
|
|
5
32
|
**New `nextgame` preset — the NextGame game-recommendation app.**
|
package/README.md
CHANGED
|
@@ -75,6 +75,7 @@ Each preset is seeded from that app's current source of truth:
|
|
|
75
75
|
| `EREVNA_TOKENS` | `erevna-web/src/theme/presets/default.ts` + `theme/utils/palette.ts` | primary `#005f73`, secondary `#94d2bd`, accent `#008d5c`; full light+dark mode |
|
|
76
76
|
| `KATALOGOS_TOKENS` | `katalogos-web/src/theme/presets/default.ts` | currently **identical** to Erevna; kept separate so they can diverge |
|
|
77
77
|
| `AML_TOKENS` | `PROOViD/AMLService/.../wwwroot/shared/ui.css` `:root` | brand `#4f46e5`; dark app-shell + light workspace + verdict palette + radii/shadows/fonts |
|
|
78
|
+
| `INTERVIEWPREP_TOKENS` | `InterviewPrep/sites/portal/theme.css` (dark `:root` + `[data-theme='light']`) | DARK-FIRST: emit with `toCssVars(INTERVIEWPREP_TOKENS, INTERVIEWPREP_CSS_VAR_NAMES, { lightSelector: ":root[data-theme='light']" })` (1.12.0); per-mode `brandFill`/`dangerFill`/... carry the site colours |
|
|
78
79
|
|
|
79
80
|
RN presets carry **no** `typography`/`radii`/`shadows`/`extensions` — the RN theme has no
|
|
80
81
|
centralized tokens for those today, so they are omitted (nothing to emit → zero change). The AML
|
package/dist/index.d.mts
CHANGED
|
@@ -41,6 +41,20 @@ interface ModeColors {
|
|
|
41
41
|
* lifts. Optional; consumers fall back to `surface` when a preset omits it.
|
|
42
42
|
*/
|
|
43
43
|
surfaceMuted?: string;
|
|
44
|
+
/** Third text tier — unavailable/"same" labels. Consumers fall back to `textSecondary`. */
|
|
45
|
+
textTertiary?: string;
|
|
46
|
+
/** Keyboard/gamepad focus ring colour. Consumers fall back to `text`. */
|
|
47
|
+
focusRing?: string;
|
|
48
|
+
/** Mode-specific brand FILL (CTA, selected item) when the top-level `primary` does not suit this mode's ground. */
|
|
49
|
+
brandFill?: string;
|
|
50
|
+
/** Text on `brandFill`. Required whenever `brandFill` is set; only the nextgame preset test measures the pair. */
|
|
51
|
+
onBrandFill?: string;
|
|
52
|
+
/** Success colour tuned for TEXT on this mode's grounds (semantic.success is tuned for light). */
|
|
53
|
+
successText?: string;
|
|
54
|
+
/** Error colour tuned for TEXT on this mode's grounds. */
|
|
55
|
+
dangerText?: string;
|
|
56
|
+
/** Fill behind `dangerText` (icon well, destructive button). */
|
|
57
|
+
dangerFill?: string;
|
|
44
58
|
}
|
|
45
59
|
/**
|
|
46
60
|
* Semantic/status colours. The four base fields match `TenantThemeConfig`'s
|
|
@@ -132,6 +146,17 @@ interface MotionEasings {
|
|
|
132
146
|
decelerate: MotionEasing;
|
|
133
147
|
accelerate: MotionEasing;
|
|
134
148
|
}
|
|
149
|
+
/** Spring parameters (mass 1) for RN `Animated.spring`. */
|
|
150
|
+
interface MotionSpring {
|
|
151
|
+
stiffness: number;
|
|
152
|
+
damping: number;
|
|
153
|
+
}
|
|
154
|
+
/** Named springs: `focus` for a focus move, `settle` for layout settling, `press` for confirm feedback. */
|
|
155
|
+
interface MotionSprings {
|
|
156
|
+
focus: MotionSpring;
|
|
157
|
+
settle: MotionSpring;
|
|
158
|
+
press: MotionSpring;
|
|
159
|
+
}
|
|
135
160
|
/**
|
|
136
161
|
* Motion token group — durations + easings. Framework-agnostic values only; the
|
|
137
162
|
* RN `Animated`/`Easing` wiring lives in `@dloizides/ui-motion`, which reads these.
|
|
@@ -143,6 +168,8 @@ interface MotionEasings {
|
|
|
143
168
|
interface Motion {
|
|
144
169
|
durations: MotionDurations;
|
|
145
170
|
easings: MotionEasings;
|
|
171
|
+
/** Optional named springs. Absent from {@link DEFAULT_MOTION}; presets that animate with springs set them. */
|
|
172
|
+
springs?: MotionSprings;
|
|
146
173
|
}
|
|
147
174
|
/** Branding asset references (ContentService GUIDs). Matches `TenantThemeConfig`'s `BrandingConfig`. */
|
|
148
175
|
interface Branding {
|
|
@@ -218,6 +245,16 @@ interface TokenExtensions {
|
|
|
218
245
|
workspace?: WorkspaceExtras;
|
|
219
246
|
verdict?: VerdictColors;
|
|
220
247
|
}
|
|
248
|
+
/**
|
|
249
|
+
* Overrides applied when the user asks for more contrast (`prefers-contrast: more`).
|
|
250
|
+
* Partial per mode: only the fields that change. Optional; presets without it get none.
|
|
251
|
+
*/
|
|
252
|
+
interface ContrastMoreOverrides {
|
|
253
|
+
light?: Partial<ModeColors>;
|
|
254
|
+
dark?: Partial<ModeColors>;
|
|
255
|
+
/** Focus ring width in px under increased contrast. */
|
|
256
|
+
focusRingWidth?: number;
|
|
257
|
+
}
|
|
221
258
|
/**
|
|
222
259
|
* One app's complete token set. The single source the three emitters read.
|
|
223
260
|
* Core fields align with `TenantThemeConfig`; optional groups are supersets.
|
|
@@ -265,6 +302,8 @@ interface DesignTokens {
|
|
|
265
302
|
* changes nothing for existing presets or emitters.
|
|
266
303
|
*/
|
|
267
304
|
motion?: Motion;
|
|
305
|
+
/** Optional increased-contrast overrides (`prefers-contrast: more`). */
|
|
306
|
+
contrastMore?: ContrastMoreOverrides;
|
|
268
307
|
/** Branding asset references */
|
|
269
308
|
branding: Branding;
|
|
270
309
|
/** Optional stack-specific token supersets */
|
|
@@ -385,6 +424,20 @@ interface CssVarNames {
|
|
|
385
424
|
darkTextSecondary?: string;
|
|
386
425
|
darkBorder?: string;
|
|
387
426
|
darkDivider?: string;
|
|
427
|
+
lightTextTertiary?: string;
|
|
428
|
+
darkTextTertiary?: string;
|
|
429
|
+
lightFocusRing?: string;
|
|
430
|
+
darkFocusRing?: string;
|
|
431
|
+
lightBrandFill?: string;
|
|
432
|
+
darkBrandFill?: string;
|
|
433
|
+
lightOnBrandFill?: string;
|
|
434
|
+
darkOnBrandFill?: string;
|
|
435
|
+
lightSuccessText?: string;
|
|
436
|
+
darkSuccessText?: string;
|
|
437
|
+
lightDangerText?: string;
|
|
438
|
+
darkDangerText?: string;
|
|
439
|
+
lightDangerFill?: string;
|
|
440
|
+
darkDangerFill?: string;
|
|
388
441
|
radiusXs?: string;
|
|
389
442
|
radiusSm?: string;
|
|
390
443
|
radiusMd?: string;
|
|
@@ -442,6 +495,20 @@ declare const DEFAULT_CSS_VAR_NAMES: CssVarNames;
|
|
|
442
495
|
* - all `dark*` — AML has no dark-mode toggle (its shell lives in the extension).
|
|
443
496
|
*/
|
|
444
497
|
declare const AML_CSS_VAR_NAMES: CssVarNames;
|
|
498
|
+
/**
|
|
499
|
+
* InterviewPrep's existing `sites/portal/theme.css` variable names. InterviewPrep is
|
|
500
|
+
* DARK-FIRST (dark on `:root`, light under `:root[data-theme='light']`), so emit with
|
|
501
|
+
* `toCssVars(INTERVIEWPREP_TOKENS, INTERVIEWPREP_CSS_VAR_NAMES, { lightSelector:
|
|
502
|
+
* ":root[data-theme='light']" })`. `darkSelector` alone cannot express it: a later
|
|
503
|
+
* `:root` dark block would override the light values in both modes.
|
|
504
|
+
*
|
|
505
|
+
* Covers only the variables that have a token field. Every brand/status colour in
|
|
506
|
+
* theme.css differs per mode, so it is carried by a per-mode field (`brandFill` ->
|
|
507
|
+
* `--primary`, `dangerFill` -> `--status-error`, ...) and the top-level single-value
|
|
508
|
+
* fields are left unnamed. Mode-specific shadows and the app-only variables
|
|
509
|
+
* (`--space-*`, `--code-*`, `--line-*`, `--xp-*`, alpha tints) stay hand-written.
|
|
510
|
+
*/
|
|
511
|
+
declare const INTERVIEWPREP_CSS_VAR_NAMES: CssVarNames;
|
|
445
512
|
|
|
446
513
|
/** Options for {@link toCssVars}. */
|
|
447
514
|
interface ToCssVarsOptions {
|
|
@@ -450,12 +517,24 @@ interface ToCssVarsOptions {
|
|
|
450
517
|
* `dark*` variables. Defaults to `:root[data-theme="dark"]`.
|
|
451
518
|
*/
|
|
452
519
|
darkSelector?: string;
|
|
520
|
+
/**
|
|
521
|
+
* DARK-FIRST output. When set, `:root` carries the shared tokens plus the
|
|
522
|
+
* DARK-mode colours (the site's default), and the light-mode colours move to
|
|
523
|
+
* this selector (e.g. `:root[data-theme='light']`); `darkSelector` is ignored.
|
|
524
|
+
* The light selector must out-rank plain `:root` (an attribute selector does),
|
|
525
|
+
* so the order the blocks are loaded in does not matter.
|
|
526
|
+
*/
|
|
527
|
+
lightSelector?: string;
|
|
453
528
|
}
|
|
454
529
|
/**
|
|
455
|
-
* Emit a {@link DesignTokens} as CSS custom properties.
|
|
456
|
-
*
|
|
457
|
-
*
|
|
458
|
-
*
|
|
530
|
+
* Emit a {@link DesignTokens} as CSS custom properties.
|
|
531
|
+
*
|
|
532
|
+
* Light-first (default): shared tokens (brand, semantic, radii, shadows, fonts,
|
|
533
|
+
* extensions) and the LIGHT-mode colours go in `:root {}`; DARK-mode colours go
|
|
534
|
+
* in `darkSelector`, emitted only when the name map names at least one `dark*`
|
|
535
|
+
* variable. Dark-first (`lightSelector` set): `:root {}` carries the shared
|
|
536
|
+
* tokens plus the DARK-mode colours and the LIGHT-mode colours go in
|
|
537
|
+
* `lightSelector`.
|
|
459
538
|
*/
|
|
460
539
|
declare function toCssVars(tokens: DesignTokens, names: CssVarNames, options?: ToCssVarsOptions): string;
|
|
461
540
|
|
|
@@ -704,6 +783,32 @@ declare const DIGITALKIN_TOKENS: DesignTokens;
|
|
|
704
783
|
*/
|
|
705
784
|
declare const EREVNA_TOKENS: DesignTokens;
|
|
706
785
|
|
|
786
|
+
/**
|
|
787
|
+
* InterviewPrep (interview-prep-hub.dloizides.com) tokens, seeded from
|
|
788
|
+
* `InterviewPrep/sites/portal/theme.css` as of 2026-09-29 (REDESIGN-IP-1, owner
|
|
789
|
+
* decision Q-TOKENS "New interviewprep preset"), so emitting it changes nothing on
|
|
790
|
+
* the site.
|
|
791
|
+
*
|
|
792
|
+
* DARK-FIRST. theme.css declares the dark palette on `:root` and the light one on
|
|
793
|
+
* `:root[data-theme='light']`; emit with `lightSelector` (see
|
|
794
|
+
* `INTERVIEWPREP_CSS_VAR_NAMES`). Every brand/status colour differs by mode, so the
|
|
795
|
+
* site-facing values live in the per-mode fields (`brandFill`, `dangerFill`, ...).
|
|
796
|
+
* The top-level single-value fields follow the nextgame precedent and carry the
|
|
797
|
+
* LIGHT values, for RN / OG-image consumers:
|
|
798
|
+
* - `primary`/`accent` `#c0512d` (light --primary / --accent); `onBrand` white, 4.71:1.
|
|
799
|
+
* - `secondary` `#1f9d8a` (light --accent-2 teal).
|
|
800
|
+
* - `semantic.error` `#b91c1c` = light --status-error-text, the TEXT-tuned red (the
|
|
801
|
+
* contrast guard reads semantic.error as text); the light FILL `#dc2626` is
|
|
802
|
+
* `light.dangerFill`.
|
|
803
|
+
*
|
|
804
|
+
* `textSecondary` = --text-muted, `textTertiary` = --text-secondary (the lighter tier
|
|
805
|
+
* in light mode). `border`/`divider`/`surfaceMuted`/`focusRing` are rgba overlays in
|
|
806
|
+
* theme.css and are kept verbatim. No `shadows`: theme.css shadows differ per mode and
|
|
807
|
+
* the token shape has one set. `radii.xs` has no theme.css step: it aliases `sm` and
|
|
808
|
+
* the name map does not emit it.
|
|
809
|
+
*/
|
|
810
|
+
declare const INTERVIEWPREP_TOKENS: DesignTokens;
|
|
811
|
+
|
|
707
812
|
/**
|
|
708
813
|
* Katalogos (online menus — realm `onlinemenu`) tokens.
|
|
709
814
|
*
|
|
@@ -733,28 +838,24 @@ declare const KATALOGOS_TOKENS: DesignTokens;
|
|
|
733
838
|
* endorsement of any of them. That rules out blue, green and red as the brand
|
|
734
839
|
* primary — the three colours a games product reaches for first.
|
|
735
840
|
*
|
|
736
|
-
*
|
|
737
|
-
*
|
|
738
|
-
*
|
|
739
|
-
*
|
|
740
|
-
*
|
|
741
|
-
*
|
|
742
|
-
*
|
|
743
|
-
*
|
|
744
|
-
*
|
|
745
|
-
*
|
|
746
|
-
* is the cheapest single decision that stops a consumer product reading as an
|
|
747
|
-
* internal tool.
|
|
841
|
+
* D1 "LIVING ROOM". The app is a dark console dashboard read from a couch, so
|
|
842
|
+
* the dark mode is the product and its grounds are GRAPHITE (#0A0D12 canvas,
|
|
843
|
+
* #121720 cards, #1A212C raised): neutral enough that box art and platform
|
|
844
|
+
* badges carry the colour. On those grounds the pick/selected colour is a warm
|
|
845
|
+
* AMBER fill (`dark.brandFill` #FFD37A with `onBrandFill` #1A1204), lighter than
|
|
846
|
+
* the top-level signal amber so a dark label clears AA on it. The top-level
|
|
847
|
+
* amber/teal/magenta triad is retained for LIGHT surfaces only (OG images,
|
|
848
|
+
* email); teal and magenta are not UI chrome in the dark app. Focus is a white
|
|
849
|
+
* ring, and `contrastMore` lifts the secondary text tiers and hairlines for
|
|
850
|
+
* `prefers-contrast: more`.
|
|
748
851
|
*
|
|
749
852
|
* Explicitly NOT used: the violet/indigo ramp, which is both the estate's banned
|
|
750
853
|
* AI default and, on a store page, indistinguishable from a dozen launcher UIs.
|
|
751
854
|
*
|
|
752
|
-
* ACCESSIBILITY. Both borders are authored to clear WCAG 1.4.11 (3:1)
|
|
753
|
-
*
|
|
754
|
-
*
|
|
755
|
-
*
|
|
756
|
-
* cannot serve error-as-text in both modes, and that is a token split, not a
|
|
757
|
-
* colour nudge.
|
|
855
|
+
* ACCESSIBILITY. Both borders are authored to clear WCAG 1.4.11 (3:1).
|
|
856
|
+
* `semantic.error` is tuned for the LIGHT surfaces and registers the usual
|
|
857
|
+
* dark-mode gap; the dark app reads error text from `dark.dangerText` on
|
|
858
|
+
* `dark.dangerFill` instead — one hex cannot serve error-as-text in both modes.
|
|
758
859
|
*/
|
|
759
860
|
declare const NEXTGAME_TOKENS: DesignTokens;
|
|
760
861
|
|
|
@@ -913,4 +1014,4 @@ declare function onBrandRatio(background: string, explicit?: string): number | n
|
|
|
913
1014
|
*/
|
|
914
1015
|
declare function canCarryAccessibleInk(background: string): boolean;
|
|
915
1016
|
|
|
916
|
-
export { AA_LARGE_TEXT_RATIO, AA_NON_TEXT_RATIO, AA_NORMAL_TEXT_RATIO, AML_CSS_VAR_NAMES, AML_TOKENS, type BrandExtras, type Branding, type CssVarNames, DEFAULT_CSS_VAR_NAMES, DEFAULT_MOTION, DIGITALKIN_TOKENS, type DesignTokens, EREVNA_TOKENS, FINREG_MODULE_COLORS, FINREG_SURFACE_COLORS, type FinregModuleColor, type FinregModuleColors, type FinregSurfaceColors, type InkScale, KATALOGOS_TOKENS, type ModeColors, type Motion, type MotionDurations, type MotionEasing, type MotionEasings, NEXTGAME_TOKENS, ON_BRAND_DARK_INK, ON_BRAND_LIGHT_INK, PRESETS, type Radii, type RnThemeConfig, type SemanticColors, type Shadows, type ShellColors, type TailwindColors, type TailwindPreset, type ToCssVarsOptions, type TokenExtensions, type Typography, UI_DEEP_STEP, UI_MAIN_STEP, UI_TINT_STEP, type UiColorScale, type UiThemeColors, type UiThemeConfig, type UiThemeMode, type UiThemePalette, type UiThemeSemantic, type VerdictColors, type WorkspaceExtras, canCarryAccessibleInk, contrastRatio, isHexColor, meetsContrast, onBrandRatio, relativeLuminance, resolveOnBrand, toCssVars, toRnTheme, toTailwindPreset, toUiTheme };
|
|
1017
|
+
export { AA_LARGE_TEXT_RATIO, AA_NON_TEXT_RATIO, AA_NORMAL_TEXT_RATIO, AML_CSS_VAR_NAMES, AML_TOKENS, type BrandExtras, type Branding, type ContrastMoreOverrides, type CssVarNames, DEFAULT_CSS_VAR_NAMES, DEFAULT_MOTION, DIGITALKIN_TOKENS, type DesignTokens, EREVNA_TOKENS, FINREG_MODULE_COLORS, FINREG_SURFACE_COLORS, type FinregModuleColor, type FinregModuleColors, type FinregSurfaceColors, INTERVIEWPREP_CSS_VAR_NAMES, INTERVIEWPREP_TOKENS, type InkScale, KATALOGOS_TOKENS, type ModeColors, type Motion, type MotionDurations, type MotionEasing, type MotionEasings, type MotionSpring, type MotionSprings, NEXTGAME_TOKENS, ON_BRAND_DARK_INK, ON_BRAND_LIGHT_INK, PRESETS, type Radii, type RnThemeConfig, type SemanticColors, type Shadows, type ShellColors, type TailwindColors, type TailwindPreset, type ToCssVarsOptions, type TokenExtensions, type Typography, UI_DEEP_STEP, UI_MAIN_STEP, UI_TINT_STEP, type UiColorScale, type UiThemeColors, type UiThemeConfig, type UiThemeMode, type UiThemePalette, type UiThemeSemantic, type VerdictColors, type WorkspaceExtras, canCarryAccessibleInk, contrastRatio, isHexColor, meetsContrast, onBrandRatio, relativeLuminance, resolveOnBrand, toCssVars, toRnTheme, toTailwindPreset, toUiTheme };
|
package/dist/index.d.ts
CHANGED
|
@@ -41,6 +41,20 @@ interface ModeColors {
|
|
|
41
41
|
* lifts. Optional; consumers fall back to `surface` when a preset omits it.
|
|
42
42
|
*/
|
|
43
43
|
surfaceMuted?: string;
|
|
44
|
+
/** Third text tier — unavailable/"same" labels. Consumers fall back to `textSecondary`. */
|
|
45
|
+
textTertiary?: string;
|
|
46
|
+
/** Keyboard/gamepad focus ring colour. Consumers fall back to `text`. */
|
|
47
|
+
focusRing?: string;
|
|
48
|
+
/** Mode-specific brand FILL (CTA, selected item) when the top-level `primary` does not suit this mode's ground. */
|
|
49
|
+
brandFill?: string;
|
|
50
|
+
/** Text on `brandFill`. Required whenever `brandFill` is set; only the nextgame preset test measures the pair. */
|
|
51
|
+
onBrandFill?: string;
|
|
52
|
+
/** Success colour tuned for TEXT on this mode's grounds (semantic.success is tuned for light). */
|
|
53
|
+
successText?: string;
|
|
54
|
+
/** Error colour tuned for TEXT on this mode's grounds. */
|
|
55
|
+
dangerText?: string;
|
|
56
|
+
/** Fill behind `dangerText` (icon well, destructive button). */
|
|
57
|
+
dangerFill?: string;
|
|
44
58
|
}
|
|
45
59
|
/**
|
|
46
60
|
* Semantic/status colours. The four base fields match `TenantThemeConfig`'s
|
|
@@ -132,6 +146,17 @@ interface MotionEasings {
|
|
|
132
146
|
decelerate: MotionEasing;
|
|
133
147
|
accelerate: MotionEasing;
|
|
134
148
|
}
|
|
149
|
+
/** Spring parameters (mass 1) for RN `Animated.spring`. */
|
|
150
|
+
interface MotionSpring {
|
|
151
|
+
stiffness: number;
|
|
152
|
+
damping: number;
|
|
153
|
+
}
|
|
154
|
+
/** Named springs: `focus` for a focus move, `settle` for layout settling, `press` for confirm feedback. */
|
|
155
|
+
interface MotionSprings {
|
|
156
|
+
focus: MotionSpring;
|
|
157
|
+
settle: MotionSpring;
|
|
158
|
+
press: MotionSpring;
|
|
159
|
+
}
|
|
135
160
|
/**
|
|
136
161
|
* Motion token group — durations + easings. Framework-agnostic values only; the
|
|
137
162
|
* RN `Animated`/`Easing` wiring lives in `@dloizides/ui-motion`, which reads these.
|
|
@@ -143,6 +168,8 @@ interface MotionEasings {
|
|
|
143
168
|
interface Motion {
|
|
144
169
|
durations: MotionDurations;
|
|
145
170
|
easings: MotionEasings;
|
|
171
|
+
/** Optional named springs. Absent from {@link DEFAULT_MOTION}; presets that animate with springs set them. */
|
|
172
|
+
springs?: MotionSprings;
|
|
146
173
|
}
|
|
147
174
|
/** Branding asset references (ContentService GUIDs). Matches `TenantThemeConfig`'s `BrandingConfig`. */
|
|
148
175
|
interface Branding {
|
|
@@ -218,6 +245,16 @@ interface TokenExtensions {
|
|
|
218
245
|
workspace?: WorkspaceExtras;
|
|
219
246
|
verdict?: VerdictColors;
|
|
220
247
|
}
|
|
248
|
+
/**
|
|
249
|
+
* Overrides applied when the user asks for more contrast (`prefers-contrast: more`).
|
|
250
|
+
* Partial per mode: only the fields that change. Optional; presets without it get none.
|
|
251
|
+
*/
|
|
252
|
+
interface ContrastMoreOverrides {
|
|
253
|
+
light?: Partial<ModeColors>;
|
|
254
|
+
dark?: Partial<ModeColors>;
|
|
255
|
+
/** Focus ring width in px under increased contrast. */
|
|
256
|
+
focusRingWidth?: number;
|
|
257
|
+
}
|
|
221
258
|
/**
|
|
222
259
|
* One app's complete token set. The single source the three emitters read.
|
|
223
260
|
* Core fields align with `TenantThemeConfig`; optional groups are supersets.
|
|
@@ -265,6 +302,8 @@ interface DesignTokens {
|
|
|
265
302
|
* changes nothing for existing presets or emitters.
|
|
266
303
|
*/
|
|
267
304
|
motion?: Motion;
|
|
305
|
+
/** Optional increased-contrast overrides (`prefers-contrast: more`). */
|
|
306
|
+
contrastMore?: ContrastMoreOverrides;
|
|
268
307
|
/** Branding asset references */
|
|
269
308
|
branding: Branding;
|
|
270
309
|
/** Optional stack-specific token supersets */
|
|
@@ -385,6 +424,20 @@ interface CssVarNames {
|
|
|
385
424
|
darkTextSecondary?: string;
|
|
386
425
|
darkBorder?: string;
|
|
387
426
|
darkDivider?: string;
|
|
427
|
+
lightTextTertiary?: string;
|
|
428
|
+
darkTextTertiary?: string;
|
|
429
|
+
lightFocusRing?: string;
|
|
430
|
+
darkFocusRing?: string;
|
|
431
|
+
lightBrandFill?: string;
|
|
432
|
+
darkBrandFill?: string;
|
|
433
|
+
lightOnBrandFill?: string;
|
|
434
|
+
darkOnBrandFill?: string;
|
|
435
|
+
lightSuccessText?: string;
|
|
436
|
+
darkSuccessText?: string;
|
|
437
|
+
lightDangerText?: string;
|
|
438
|
+
darkDangerText?: string;
|
|
439
|
+
lightDangerFill?: string;
|
|
440
|
+
darkDangerFill?: string;
|
|
388
441
|
radiusXs?: string;
|
|
389
442
|
radiusSm?: string;
|
|
390
443
|
radiusMd?: string;
|
|
@@ -442,6 +495,20 @@ declare const DEFAULT_CSS_VAR_NAMES: CssVarNames;
|
|
|
442
495
|
* - all `dark*` — AML has no dark-mode toggle (its shell lives in the extension).
|
|
443
496
|
*/
|
|
444
497
|
declare const AML_CSS_VAR_NAMES: CssVarNames;
|
|
498
|
+
/**
|
|
499
|
+
* InterviewPrep's existing `sites/portal/theme.css` variable names. InterviewPrep is
|
|
500
|
+
* DARK-FIRST (dark on `:root`, light under `:root[data-theme='light']`), so emit with
|
|
501
|
+
* `toCssVars(INTERVIEWPREP_TOKENS, INTERVIEWPREP_CSS_VAR_NAMES, { lightSelector:
|
|
502
|
+
* ":root[data-theme='light']" })`. `darkSelector` alone cannot express it: a later
|
|
503
|
+
* `:root` dark block would override the light values in both modes.
|
|
504
|
+
*
|
|
505
|
+
* Covers only the variables that have a token field. Every brand/status colour in
|
|
506
|
+
* theme.css differs per mode, so it is carried by a per-mode field (`brandFill` ->
|
|
507
|
+
* `--primary`, `dangerFill` -> `--status-error`, ...) and the top-level single-value
|
|
508
|
+
* fields are left unnamed. Mode-specific shadows and the app-only variables
|
|
509
|
+
* (`--space-*`, `--code-*`, `--line-*`, `--xp-*`, alpha tints) stay hand-written.
|
|
510
|
+
*/
|
|
511
|
+
declare const INTERVIEWPREP_CSS_VAR_NAMES: CssVarNames;
|
|
445
512
|
|
|
446
513
|
/** Options for {@link toCssVars}. */
|
|
447
514
|
interface ToCssVarsOptions {
|
|
@@ -450,12 +517,24 @@ interface ToCssVarsOptions {
|
|
|
450
517
|
* `dark*` variables. Defaults to `:root[data-theme="dark"]`.
|
|
451
518
|
*/
|
|
452
519
|
darkSelector?: string;
|
|
520
|
+
/**
|
|
521
|
+
* DARK-FIRST output. When set, `:root` carries the shared tokens plus the
|
|
522
|
+
* DARK-mode colours (the site's default), and the light-mode colours move to
|
|
523
|
+
* this selector (e.g. `:root[data-theme='light']`); `darkSelector` is ignored.
|
|
524
|
+
* The light selector must out-rank plain `:root` (an attribute selector does),
|
|
525
|
+
* so the order the blocks are loaded in does not matter.
|
|
526
|
+
*/
|
|
527
|
+
lightSelector?: string;
|
|
453
528
|
}
|
|
454
529
|
/**
|
|
455
|
-
* Emit a {@link DesignTokens} as CSS custom properties.
|
|
456
|
-
*
|
|
457
|
-
*
|
|
458
|
-
*
|
|
530
|
+
* Emit a {@link DesignTokens} as CSS custom properties.
|
|
531
|
+
*
|
|
532
|
+
* Light-first (default): shared tokens (brand, semantic, radii, shadows, fonts,
|
|
533
|
+
* extensions) and the LIGHT-mode colours go in `:root {}`; DARK-mode colours go
|
|
534
|
+
* in `darkSelector`, emitted only when the name map names at least one `dark*`
|
|
535
|
+
* variable. Dark-first (`lightSelector` set): `:root {}` carries the shared
|
|
536
|
+
* tokens plus the DARK-mode colours and the LIGHT-mode colours go in
|
|
537
|
+
* `lightSelector`.
|
|
459
538
|
*/
|
|
460
539
|
declare function toCssVars(tokens: DesignTokens, names: CssVarNames, options?: ToCssVarsOptions): string;
|
|
461
540
|
|
|
@@ -704,6 +783,32 @@ declare const DIGITALKIN_TOKENS: DesignTokens;
|
|
|
704
783
|
*/
|
|
705
784
|
declare const EREVNA_TOKENS: DesignTokens;
|
|
706
785
|
|
|
786
|
+
/**
|
|
787
|
+
* InterviewPrep (interview-prep-hub.dloizides.com) tokens, seeded from
|
|
788
|
+
* `InterviewPrep/sites/portal/theme.css` as of 2026-09-29 (REDESIGN-IP-1, owner
|
|
789
|
+
* decision Q-TOKENS "New interviewprep preset"), so emitting it changes nothing on
|
|
790
|
+
* the site.
|
|
791
|
+
*
|
|
792
|
+
* DARK-FIRST. theme.css declares the dark palette on `:root` and the light one on
|
|
793
|
+
* `:root[data-theme='light']`; emit with `lightSelector` (see
|
|
794
|
+
* `INTERVIEWPREP_CSS_VAR_NAMES`). Every brand/status colour differs by mode, so the
|
|
795
|
+
* site-facing values live in the per-mode fields (`brandFill`, `dangerFill`, ...).
|
|
796
|
+
* The top-level single-value fields follow the nextgame precedent and carry the
|
|
797
|
+
* LIGHT values, for RN / OG-image consumers:
|
|
798
|
+
* - `primary`/`accent` `#c0512d` (light --primary / --accent); `onBrand` white, 4.71:1.
|
|
799
|
+
* - `secondary` `#1f9d8a` (light --accent-2 teal).
|
|
800
|
+
* - `semantic.error` `#b91c1c` = light --status-error-text, the TEXT-tuned red (the
|
|
801
|
+
* contrast guard reads semantic.error as text); the light FILL `#dc2626` is
|
|
802
|
+
* `light.dangerFill`.
|
|
803
|
+
*
|
|
804
|
+
* `textSecondary` = --text-muted, `textTertiary` = --text-secondary (the lighter tier
|
|
805
|
+
* in light mode). `border`/`divider`/`surfaceMuted`/`focusRing` are rgba overlays in
|
|
806
|
+
* theme.css and are kept verbatim. No `shadows`: theme.css shadows differ per mode and
|
|
807
|
+
* the token shape has one set. `radii.xs` has no theme.css step: it aliases `sm` and
|
|
808
|
+
* the name map does not emit it.
|
|
809
|
+
*/
|
|
810
|
+
declare const INTERVIEWPREP_TOKENS: DesignTokens;
|
|
811
|
+
|
|
707
812
|
/**
|
|
708
813
|
* Katalogos (online menus — realm `onlinemenu`) tokens.
|
|
709
814
|
*
|
|
@@ -733,28 +838,24 @@ declare const KATALOGOS_TOKENS: DesignTokens;
|
|
|
733
838
|
* endorsement of any of them. That rules out blue, green and red as the brand
|
|
734
839
|
* primary — the three colours a games product reaches for first.
|
|
735
840
|
*
|
|
736
|
-
*
|
|
737
|
-
*
|
|
738
|
-
*
|
|
739
|
-
*
|
|
740
|
-
*
|
|
741
|
-
*
|
|
742
|
-
*
|
|
743
|
-
*
|
|
744
|
-
*
|
|
745
|
-
*
|
|
746
|
-
* is the cheapest single decision that stops a consumer product reading as an
|
|
747
|
-
* internal tool.
|
|
841
|
+
* D1 "LIVING ROOM". The app is a dark console dashboard read from a couch, so
|
|
842
|
+
* the dark mode is the product and its grounds are GRAPHITE (#0A0D12 canvas,
|
|
843
|
+
* #121720 cards, #1A212C raised): neutral enough that box art and platform
|
|
844
|
+
* badges carry the colour. On those grounds the pick/selected colour is a warm
|
|
845
|
+
* AMBER fill (`dark.brandFill` #FFD37A with `onBrandFill` #1A1204), lighter than
|
|
846
|
+
* the top-level signal amber so a dark label clears AA on it. The top-level
|
|
847
|
+
* amber/teal/magenta triad is retained for LIGHT surfaces only (OG images,
|
|
848
|
+
* email); teal and magenta are not UI chrome in the dark app. Focus is a white
|
|
849
|
+
* ring, and `contrastMore` lifts the secondary text tiers and hairlines for
|
|
850
|
+
* `prefers-contrast: more`.
|
|
748
851
|
*
|
|
749
852
|
* Explicitly NOT used: the violet/indigo ramp, which is both the estate's banned
|
|
750
853
|
* AI default and, on a store page, indistinguishable from a dozen launcher UIs.
|
|
751
854
|
*
|
|
752
|
-
* ACCESSIBILITY. Both borders are authored to clear WCAG 1.4.11 (3:1)
|
|
753
|
-
*
|
|
754
|
-
*
|
|
755
|
-
*
|
|
756
|
-
* cannot serve error-as-text in both modes, and that is a token split, not a
|
|
757
|
-
* colour nudge.
|
|
855
|
+
* ACCESSIBILITY. Both borders are authored to clear WCAG 1.4.11 (3:1).
|
|
856
|
+
* `semantic.error` is tuned for the LIGHT surfaces and registers the usual
|
|
857
|
+
* dark-mode gap; the dark app reads error text from `dark.dangerText` on
|
|
858
|
+
* `dark.dangerFill` instead — one hex cannot serve error-as-text in both modes.
|
|
758
859
|
*/
|
|
759
860
|
declare const NEXTGAME_TOKENS: DesignTokens;
|
|
760
861
|
|
|
@@ -913,4 +1014,4 @@ declare function onBrandRatio(background: string, explicit?: string): number | n
|
|
|
913
1014
|
*/
|
|
914
1015
|
declare function canCarryAccessibleInk(background: string): boolean;
|
|
915
1016
|
|
|
916
|
-
export { AA_LARGE_TEXT_RATIO, AA_NON_TEXT_RATIO, AA_NORMAL_TEXT_RATIO, AML_CSS_VAR_NAMES, AML_TOKENS, type BrandExtras, type Branding, type CssVarNames, DEFAULT_CSS_VAR_NAMES, DEFAULT_MOTION, DIGITALKIN_TOKENS, type DesignTokens, EREVNA_TOKENS, FINREG_MODULE_COLORS, FINREG_SURFACE_COLORS, type FinregModuleColor, type FinregModuleColors, type FinregSurfaceColors, type InkScale, KATALOGOS_TOKENS, type ModeColors, type Motion, type MotionDurations, type MotionEasing, type MotionEasings, NEXTGAME_TOKENS, ON_BRAND_DARK_INK, ON_BRAND_LIGHT_INK, PRESETS, type Radii, type RnThemeConfig, type SemanticColors, type Shadows, type ShellColors, type TailwindColors, type TailwindPreset, type ToCssVarsOptions, type TokenExtensions, type Typography, UI_DEEP_STEP, UI_MAIN_STEP, UI_TINT_STEP, type UiColorScale, type UiThemeColors, type UiThemeConfig, type UiThemeMode, type UiThemePalette, type UiThemeSemantic, type VerdictColors, type WorkspaceExtras, canCarryAccessibleInk, contrastRatio, isHexColor, meetsContrast, onBrandRatio, relativeLuminance, resolveOnBrand, toCssVars, toRnTheme, toTailwindPreset, toUiTheme };
|
|
1017
|
+
export { AA_LARGE_TEXT_RATIO, AA_NON_TEXT_RATIO, AA_NORMAL_TEXT_RATIO, AML_CSS_VAR_NAMES, AML_TOKENS, type BrandExtras, type Branding, type ContrastMoreOverrides, type CssVarNames, DEFAULT_CSS_VAR_NAMES, DEFAULT_MOTION, DIGITALKIN_TOKENS, type DesignTokens, EREVNA_TOKENS, FINREG_MODULE_COLORS, FINREG_SURFACE_COLORS, type FinregModuleColor, type FinregModuleColors, type FinregSurfaceColors, INTERVIEWPREP_CSS_VAR_NAMES, INTERVIEWPREP_TOKENS, type InkScale, KATALOGOS_TOKENS, type ModeColors, type Motion, type MotionDurations, type MotionEasing, type MotionEasings, type MotionSpring, type MotionSprings, NEXTGAME_TOKENS, ON_BRAND_DARK_INK, ON_BRAND_LIGHT_INK, PRESETS, type Radii, type RnThemeConfig, type SemanticColors, type Shadows, type ShellColors, type TailwindColors, type TailwindPreset, type ToCssVarsOptions, type TokenExtensions, type Typography, UI_DEEP_STEP, UI_MAIN_STEP, UI_TINT_STEP, type UiColorScale, type UiThemeColors, type UiThemeConfig, type UiThemeMode, type UiThemePalette, type UiThemeSemantic, type VerdictColors, type WorkspaceExtras, canCarryAccessibleInk, contrastRatio, isHexColor, meetsContrast, onBrandRatio, relativeLuminance, resolveOnBrand, toCssVars, toRnTheme, toTailwindPreset, toUiTheme };
|