@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 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. Base tokens (brand,
456
- * semantic, light-mode, radii, shadows, fonts and any extensions) go in a
457
- * `:root {}` block; dark-mode tokens go in a separate selector block, emitted
458
- * only when the name map defines at least one `dark*` variable.
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
- * What is left, and what this preset commits to, is the arcade marquee: a
737
- * SIGNAL AMBER primary (the "this is the one to buy" colour — the same amber a
738
- * trophy, a coin and a highlight reel use), a deep TEAL secondary as the calm
739
- * counterweight for structure and links, and an arcade MAGENTA accent for the
740
- * one thing per screen that must be looked at. None of the three sits within
741
- * 60 degrees of a console brand hue, so a platform badge never blends into the
742
- * chrome.
743
- *
744
- * The grounds are WARM: a paper-toned light mode (#FBF7F0) and a warm near-black
745
- * dark mode (#12100E) rather than the cold blue-grey every dashboard ships. It
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) rather
753
- * than inheriting the older presets' registered gaps — a preset that ships
754
- * before the app has pixels has no regression to protect. `semantic.error` is
755
- * tuned for the LIGHT surfaces and registers the usual dark-mode gap: one hex
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. Base tokens (brand,
456
- * semantic, light-mode, radii, shadows, fonts and any extensions) go in a
457
- * `:root {}` block; dark-mode tokens go in a separate selector block, emitted
458
- * only when the name map defines at least one `dark*` variable.
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
- * What is left, and what this preset commits to, is the arcade marquee: a
737
- * SIGNAL AMBER primary (the "this is the one to buy" colour — the same amber a
738
- * trophy, a coin and a highlight reel use), a deep TEAL secondary as the calm
739
- * counterweight for structure and links, and an arcade MAGENTA accent for the
740
- * one thing per screen that must be looked at. None of the three sits within
741
- * 60 degrees of a console brand hue, so a platform badge never blends into the
742
- * chrome.
743
- *
744
- * The grounds are WARM: a paper-toned light mode (#FBF7F0) and a warm near-black
745
- * dark mode (#12100E) rather than the cold blue-grey every dashboard ships. It
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) rather
753
- * than inheriting the older presets' registered gaps — a preset that ships
754
- * before the app has pixels has no regression to protect. `semantic.error` is
755
- * tuned for the LIGHT surfaces and registers the usual dark-mode gap: one hex
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 };