blip-tokens 2.3.0 → 2.4.1

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/README.md CHANGED
@@ -235,8 +235,10 @@ blip-ds loads the tokens once, in its own entry:
235
235
  import 'blip-tokens/css/colors';
236
236
  import 'blip-tokens/css/typography';
237
237
  import 'blip-tokens/css/dimensions';
238
+ import 'blip-tokens/css/layout';
239
+ import 'blip-tokens/css/motion';
238
240
  import 'blip-tokens/css/shadows';
239
- // or, for all four: import 'blip-tokens/css';
241
+ // or, for all: import 'blip-tokens/css';
240
242
  ```
241
243
 
242
244
  Components then read the variables in their own styles. There is nothing to
@@ -276,14 +278,27 @@ The output is split by what the tokens are. Only colors depend on the theme:
276
278
 
277
279
  | Entry | File | Tokens | Declared on |
278
280
  |---|---|---|---|
279
- | `blip-tokens/css` | `build/css/uai.css` | Imports the four files below | — |
280
- | `blip-tokens/css/colors` | `build/css/uai-colors.css` | Surface, content, action, border, feedback, overlay and fixed colors | Every theme root (light and dark) |
281
+ | `blip-tokens/css` | `build/css/uai.css` | Imports the grouped files below | — |
282
+ | `blip-tokens/css/colors` | `build/css/uai-colors.css` | Surface, content, action, border, feedback, overlay, fixed and AI accent colors | Every theme root (light and dark) |
281
283
  | `blip-tokens/css/typography` | `build/css/uai-typography.css` | Font families, sizes and line heights per role, weights, letter spacing | The outermost theme root |
282
- | `blip-tokens/css/dimensions` | `build/css/uai-dimensions.css` | Spacing, sizing, radius, border width | The outermost theme root |
284
+ | `blip-tokens/css/dimensions` | `build/css/uai-dimensions.css` | Spacing, sizing, control heights, radius, border width, opacity | The outermost theme root |
285
+ | `blip-tokens/css/layout` | `build/css/uai-layout.css` | Layout widths, z-index layers | The outermost theme root |
286
+ | `blip-tokens/css/motion` | `build/css/uai-motion.css` | Durations and easing curves | The outermost theme root |
283
287
  | `blip-tokens/css/shadows` | `build/css/uai-shadows.css` | Eight elevation shadows | The outermost theme root |
284
288
 
285
289
  SCSS follows the same split: `blip-tokens/scss/colors-light`,
286
- `scss/colors-dark`, `scss/typography`, `scss/dimensions` and `scss/shadows`.
290
+ `scss/colors-dark`, `scss/typography`, `scss/dimensions`, `scss/layout`,
291
+ `scss/motion` and `scss/shadows`.
292
+
293
+ Breakpoints (`$uai-breakpoint-xs|sm|md|lg`) are published only to SCSS
294
+ (`scss/layout`), JavaScript and JSON, never as CSS custom properties, because
295
+ media queries cannot read `var()`:
296
+
297
+ ```scss
298
+ @use 'blip-tokens/scss/layout' as layout;
299
+
300
+ @media (max-width: layout.$uai-breakpoint-lg) { … }
301
+ ```
287
302
 
288
303
  The tokens are never declared at `:root`, `html` or `body`, so loading the CSS
289
304
  does not change anything outside the theme roots. The `--uai-` prefix also keeps
@@ -317,9 +332,9 @@ keeps the v1 `theme--*` classes and `--color-*` variables for the v1 components,
317
332
  and also renders `data-uai-theme` for the new ones. The v1 classes and variables
318
333
  do not feed the new tokens.
319
334
 
320
- Each theme root also sets the CSS `color-scheme`. Typography, dimensions and
321
- shadows do not depend on the theme, so they are declared only on the outermost
322
- root and inherited by nested regions; that is why an override on a container
335
+ Each theme root also sets the CSS `color-scheme`. Typography, dimensions, layout,
336
+ motion and shadows do not depend on the theme, so they are declared only on the
337
+ outermost root and inherited by nested regions; that is why an override on a container
323
338
  reaches components inside a nested region. The selectors use `:where()`, so a
324
339
  rule that overrides a token on the theme root itself always wins.
325
340
 
@@ -375,13 +390,18 @@ from the semantic variables:
375
390
  ```css
376
391
  .card-title {
377
392
  font-family: var(--uai-font-family-sans);
378
- font-size: var(--uai-title-font-size);
379
- line-height: var(--uai-title-line-height);
393
+ font-size: var(--uai-title-md-font-size);
394
+ line-height: var(--uai-title-md-line-height);
380
395
  font-weight: var(--uai-font-weight-semibold);
381
396
  letter-spacing: var(--uai-letter-spacing-normal);
382
397
  }
383
398
  ```
384
399
 
400
+ Typography size roles are `title/lg` (18/24), `title/md` (16/24),
401
+ `title/sm` (14/20), `body/lg` (16/24), and `body/sm` (12/20), in pixels.
402
+ The existing `title/font-size` and `title/line-height` tokens remain
403
+ compatibility aliases to `title/md`.
404
+
385
405
  The 28 Figma text styles are published as metadata only. Each entry in
386
406
  `textStyles` names the variables that make it up, so a component can match its
387
407
  Figma text style exactly:
@@ -446,18 +466,23 @@ resolver. They hold static values, so prefer the CSS variables for themed styles
446
466
  | Usage | Source/normalized DTCG | Web output |
447
467
  |---|---|---|
448
468
  | Font size and line height | px | rem, at 16 px per rem |
449
- | Spacing, sizing, radius | px | rem, at 16 px per rem |
469
+ | Spacing, sizing, control height, radius, breakpoint and layout width | px | rem, at 16 px per rem |
450
470
  | Border width | px | px |
451
471
  | Shadow geometry | px | px |
452
472
  | Letter spacing / font tracking | px | px |
453
- | Opacity and font weight | number | number |
473
+ | Opacity and font weight | number | unitless number |
474
+ | Layer / z-index | integer | unitless integer |
475
+ | Duration | seconds | milliseconds (`ms`) |
476
+ | Easing curve | Figma cubic Bezier | CSS `cubic-bezier(...)` |
454
477
 
455
478
  The current Figma tracking primitives explicitly document pixels; do not infer
456
479
  `em` or percent from their numeric values. A future change requires an explicit
457
480
  policy and tests. Conversion is applied by semantic usage after resolving raw
458
481
  aliases: a shared Foundation dimension can become `rem` when used as spacing,
459
- sizing, radius or typography, while remaining `px` for border width. The build
460
- does not change the application's root font size.
482
+ sizing, control height, radius, breakpoint, width or typography, while remaining
483
+ `px` for border width. Figma opacity percentages are normalized to 0–1, while
484
+ layers remain non-negative integers. Figma durations in seconds are emitted as milliseconds. The build does not
485
+ change the application's root font size.
461
486
 
462
487
  Raw Figma floats are preserved in the snapshot. Normalized numeric/color values
463
488
  are rounded to six decimal places to remove serialization noise (for example,
@@ -805,10 +830,12 @@ next to the legacy files, which keep their original names and paths:
805
830
  ```
806
831
  build/
807
832
  ├── css/
808
- │ ├── uai.css # Entry: imports the four uai-* files below
833
+ │ ├── uai.css # Entry: imports all grouped uai-* files below
809
834
  │ ├── uai-colors.css # Color variables: one block per theme root
810
835
  │ ├── uai-typography.css # Typography variables, outermost theme root
811
- │ ├── uai-dimensions.css # Spacing, sizing, radius and border width, outermost theme root
836
+ │ ├── uai-dimensions.css # Spacing, sizing, control heights, radius, border width and opacity
837
+ │ ├── uai-layout.css # Widths and z-index layers (breakpoints are SCSS/JS only)
838
+ │ ├── uai-motion.css # Durations and easing curves
812
839
  │ ├── uai-shadows.css # Elevation variables, outermost theme root
813
840
  │ └── classes.css # Legacy color and background classes
814
841
  ├── scss/
@@ -816,6 +843,8 @@ build/
816
843
  │ ├── uai-colors-dark.scss # $uai-* color variables, dark values
817
844
  │ ├── uai-typography.scss
818
845
  │ ├── uai-dimensions.scss
846
+ │ ├── uai-layout.scss
847
+ │ ├── uai-motion.scss
819
848
  │ ├── uai-shadows.scss
820
849
  │ └── theme-*.scss, variables.scss, extended-color.scss # Legacy palette and themes
821
850
  ├── json/
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "version": "2.3.0",
3
+ "version": "2.4.1",
4
4
  "baseUrl": "https://cdn.blip.ai/blip-tokens/",
5
5
  "assets": {
6
6
  "asset-icon-123-outline": {
@@ -4517,8 +4517,8 @@
4517
4517
  },
4518
4518
  "asset-logo-google-rcs": {
4519
4519
  "path": "logos/google-rcs.svg",
4520
- "bytes": 2336,
4521
- "sha256": "4a2d1ae6c0e9f11aa5385fe05d19608c2129c2051636b7485787771f625e660b",
4520
+ "bytes": 11852,
4521
+ "sha256": "bcb7d470b4179665ba3dd871accdde0b64252aefee7cfd9444aeaf5d1cd5bd88",
4522
4522
  "contentType": "image/svg+xml"
4523
4523
  },
4524
4524
  "asset-logo-hangouts": {
@@ -1,171 +1,187 @@
1
1
  :where([data-uai-theme="light"]) {
2
- /* Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces. */
2
+ /* Last stop of the AI accent gradient (cyan). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features. */
3
+ --uai-accent-ai-end: #00c6d7;
4
+ /* Middle stop of the AI accent gradient (purple). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features. */
5
+ --uai-accent-ai-middle: #a855f7;
6
+ /* First stop of the AI accent gradient (blue). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features. */
7
+ --uai-accent-ai-start: #0099ff;
8
+ /* Theme-aware destructive action accent. Use: background of filled destructive buttons, and text and border of outline or text destructive actions on standard surfaces. Pair: action/destructive-foreground on filled buttons, never fixed/bright. Avoid: error messages; use feedback/error. */
3
9
  --uai-action-destructive: #cf0022;
4
- /* Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright. */
10
+ /* Theme-aware text and icon color on action/destructive: white in Light, dark neutral in Dark. Avoid: replacing it with fixed/bright. */
5
11
  --uai-action-destructive-foreground: #ffffff;
6
- /* Outline and text button background — default state. */
12
+ /* Theme-aware background of outline and text (ghost) actions, default state. Pair: content/primary for the label. States: action/outline/hover and action/outline/pressed. */
7
13
  --uai-action-outline-default: #ffffff;
8
- /* Outline and text button background — hover state. Also list item hover. */
14
+ /* Theme-aware hover background of outline and text actions. Also the hover background of list and menu items. */
9
15
  --uai-action-outline-hover: #f2f3f3;
10
- /* Outline and text button background — pressed state. Also selected list item. */
16
+ /* Theme-aware pressed background of outline and text actions. Also the background of the selected list or menu item. */
11
17
  --uai-action-outline-pressed: #e4e6e7;
12
- /* Filled positive button background. Always pair with action/positive-foreground, never fixed/bright. Feedback text and outline/text actions use feedback/success instead. */
18
+ /* Theme-aware background of filled positive buttons. Pair: action/positive-foreground, never fixed/bright. Avoid: success text and outline or text actions; use feedback/success. */
13
19
  --uai-action-positive: #047857;
14
- /* Text and icons on action/positive. Theme-aware foreground for filled positive buttons. */
20
+ /* Theme-aware text and icon color on action/positive: white in Light, dark neutral in Dark. */
15
21
  --uai-action-positive-foreground: #ffffff;
16
- /* Primary button background — default state. */
22
+ /* Theme-aware background of primary actions, default state: solid uai-button and the checked checkbox fill. Neutral (near-black in Light), not brand blue. Pair: action/primary/foreground. States: action/primary/hover and action/primary/pressed. */
17
23
  --uai-action-primary-default: #242729;
18
- /* Text and icons on primary buttons. */
24
+ /* Theme-aware text and icon color on action/primary backgrounds, including the checkbox check mark. Avoid: fixed/bright or content/inverse on primary actions. */
19
25
  --uai-action-primary-foreground: #ffffff;
20
- /* Primary button background — hover state. */
26
+ /* Theme-aware background of primary actions on hover. Use only as the hover state of action/primary/default. Pair: action/primary/foreground. */
21
27
  --uai-action-primary-hover: #181a1b;
22
- /* Primary button background — pressed state. */
28
+ /* Theme-aware background of primary actions while pressed or active. Use only as the pressed state of action/primary/default. Pair: action/primary/foreground. */
23
29
  --uai-action-primary-pressed: #0a0a0a;
24
- /* Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring. */
30
+ /* Theme-aware decorative border. Use: cards, dividers and separators. Avoid: as the only boundary of a form control or as the sole state indicator; use border/input or border/ring. */
25
31
  --uai-border-default: #e4e6e7;
26
- /* Essential form control boundary. Dark mode meets 3:1 on background, paper, contrast, muted and outline pressed surfaces. Do not use border/default as the only control boundary. */
32
+ /* Theme-aware essential boundary of form controls. Use: default borders of inputs, selects, checkboxes and radios. Dark mode meets 3:1 on background, paper, contrast, muted and outline pressed surfaces. Avoid: decorative dividers; use border/default. */
27
33
  --uai-border-input: #adb4b8;
28
- /* Solid neutral focus indicator, dark in Light and light in Dark. Use at full opacity. Inputs may add a separate outer halo with opacity/focus-ring, while keeping the solid focus border. Never reduce the opacity of the whole control. */
34
+ /* Theme-aware solid focus indicator: dark in Light, light in Dark. Use: focus border of inputs and focus outline of buttons, checkboxes and radios, always at full opacity. Inputs may add a separate outer halo with opacity/focus-ring. Avoid: reducing the opacity of the whole control. */
29
35
  --uai-border-ring: #242729;
30
- /* Disabled text and icons. */
36
+ /* Theme-aware color for disabled text, icons and control borders (inputs, checkbox, radio). Avoid: placeholders (use content/placeholder) and readable secondary text, because disabled content is exempt from contrast rules. */
31
37
  --uai-content-disabled: #848e94;
32
- /* Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary. */
38
+ /* Theme-aware text and icon color for inverted surfaces. Use: text and icons on surface/inverse, such as tooltips and snackbars. Avoid: labels on filled actions; use the matching action foreground token. */
33
39
  --uai-content-inverse: #ffffff;
34
- /* Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. */
40
+ /* Theme-aware link color. Use: links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. Avoid: non-interactive emphasis. */
35
41
  --uai-content-link: #0073e5;
36
- /* Input placeholder and hint text on standard surfaces. Not for disabled content. Dark mode meets 4.5:1 on background, paper, contrast, muted and outline pressed surfaces. */
42
+ /* Theme-aware placeholder color. Use: placeholder and empty-value hint text inside inputs and selects on standard surfaces. Dark mode meets 4.5:1 on background, paper, contrast, muted and outline pressed surfaces. Avoid: disabled content; use content/disabled. */
37
43
  --uai-content-placeholder: #adb4b8;
38
- /* Primary text and icons. Headings, body text, form labels. */
44
+ /* Theme-aware primary text and icon color. Use: headings, body text, input values and form labels on standard surfaces (background, paper, contrast, muted). Avoid: text on surface/inverse or on filled actions; use content/inverse or the matching action foreground. */
39
45
  --uai-content-primary: #242729;
40
- /* Secondary text and icons. Descriptions, supporting text, text on muted surfaces. */
46
+ /* Theme-aware secondary text and icon color. Use: descriptions, supporting text, input icons, avatar initials and text on surface/muted. Avoid: essential information that must be read at a glance; use content/primary. */
41
47
  --uai-content-secondary: #5f676d;
42
- /* Error text and icons on standard surfaces or feedback/error-subtle. Keep a message or icon as a non-color cue. Filled destructive actions use action/destructive and its foreground. */
48
+ /* Theme-aware error color for text, icons and borders, such as an invalid input and its message, on standard surfaces or on feedback/error-subtle. Keep a message or icon as a non-color cue. Avoid: filled destructive buttons; use action/destructive. */
43
49
  --uai-feedback-error: #cf0022;
44
- /* Error alert background. Pair with feedback/error for the icon. */
50
+ /* Theme-aware background of error alerts, banners and inline status areas. Pair: feedback/error for the icon and content/primary for the text. */
45
51
  --uai-feedback-error-subtle: #fef2f2;
46
- /* Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background. */
52
+ /* Theme-aware information color for text, icons and borders on standard surfaces or on feedback/info-subtle. Avoid: filled button backgrounds. */
47
53
  --uai-feedback-info: #0073e5;
48
- /* Info alert background. Pair with feedback/info for the icon. */
54
+ /* Theme-aware background of information alerts, banners and inline status areas. Pair: feedback/info for the icon and content/primary for the text. */
49
55
  --uai-feedback-info-subtle: #eff6ff;
50
- /* Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons. */
56
+ /* Theme-aware success color for text, icons and borders, such as a valid input and its message, on standard surfaces or on feedback/success-subtle. Avoid: filled buttons; use action/positive with action/positive-foreground. */
51
57
  --uai-feedback-success: #3da329;
52
- /* Success alert background. Pair with feedback/success for the icon. */
58
+ /* Theme-aware background of success alerts, banners and inline status areas. Pair: feedback/success for the icon and content/primary for the text. */
53
59
  --uai-feedback-success-subtle: #ecfdf5;
54
- /* Warning text and icons on standard surfaces or feedback/warning-subtle. Light-mode text still requires a contrast check. Not a filled button background. */
60
+ /* Theme-aware warning color for text, icons and borders on standard surfaces or on feedback/warning-subtle. Check text contrast in Light mode. Avoid: filled button backgrounds. */
55
61
  --uai-feedback-warning: #ff8000;
56
- /* Warning alert background. Pair with feedback/warning for the icon. */
62
+ /* Theme-aware background of warning alerts, banners and inline status areas. Pair: feedback/warning for the icon and content/primary for the text. */
57
63
  --uai-feedback-warning-subtle: #fff7ed;
58
- /* Fixed Blip blue. Pair with fixed/bright for text on it. Do not use it as the sole selected-state boundary on every surface. */
64
+ /* Fixed Blip blue, the same in every theme. Pair: fixed/bright for text on it. Avoid: as the only selected-state boundary on every surface, and as a replacement for the neutral action/primary. */
59
65
  --uai-fixed-blue: #1e6bf1;
60
- /* Product brand color, invariant across themes. Use fixed/dim for normal text on this background, not fixed/bright. Brand color alone is not an accessible selected-state boundary on every surface. */
66
+ /* Product brand color, invariant across themes. Use: brand marks and illustrations. Pair: fixed/dim for normal text on it, not fixed/bright. Avoid: as the only selected-state boundary on every surface. */
61
67
  --uai-fixed-brand: #0099ff;
62
- /* Fixed white. Not a universal foreground: fails normal-text contrast on fixed/brand and bright feedback colors. Use on fixed/dim or fixed/blue; use fixed/dim on fixed/brand. */
68
+ /* Fixed white that does not change with the theme. Use: text and icons on fixed/dim or fixed/blue. Avoid: text on fixed/brand or on light feedback colors, where it fails normal-text contrast. */
63
69
  --uai-fixed-bright: #ffffff;
64
- /* Dark color that does not change with the theme. */
70
+ /* Fixed dark neutral that does not change with the theme. Use: text on fixed/brand, and dark areas that must look the same in Light and Dark. Avoid: theme-aware text; use content/primary. */
65
71
  --uai-fixed-dim: #242729;
66
- /* Backdrop behind modals, drawers and dialogs. */
72
+ /* Theme-aware translucent backdrop behind modals, drawers and dialogs. Avoid: hover or pressed feedback; use overlay/hover or overlay/pressed. */
67
73
  --uai-overlay-default: rgba(0, 0, 0, 0.72);
68
- /* Translucent layer for hover on any interactive surface. */
74
+ /* Theme-aware translucent hover layer placed over any interactive surface: black tint in Light, white tint in Dark. Use: menu items, icon buttons and the radio hover halo. Avoid: as a solid background. */
69
75
  --uai-overlay-hover: rgba(0, 0, 0, 0.08);
70
- /* Translucent background for insight panels and floating cards. */
76
+ /* Theme-aware translucent background for insight panels and floating cards over content. Pair: content/primary. */
71
77
  --uai-overlay-insight: rgba(255, 255, 255, 0.9);
72
- /* Translucent layer for pressed state on any interactive surface. */
78
+ /* Theme-aware translucent pressed layer placed over any interactive surface. Use: the pressed state wherever overlay/hover is the hover state. */
73
79
  --uai-overlay-pressed: rgba(0, 0, 0, 0.16);
74
- /* Page background. The base layer behind every screen. */
80
+ /* Theme-aware translucent layer for the selected item in navigation placed over any surface: black tint in Light, white tint in Dark. Use: selected header navigation and side menu items, together with medium font weight. Pair: content/primary. Avoid: selected list or menu options in panels; use action/outline/pressed. */
81
+ --uai-overlay-selected: rgba(0, 0, 0, 0.06);
82
+ /* Theme-aware page background, the base layer behind every screen. Use: app canvas and the area around cards. Pair: content/primary and content/secondary. Avoid: cards, fields and floating panels; use surface/paper. */
75
83
  --uai-surface-background: #f2f3f3;
76
- /* Subtle contrast surface. Secondary panels, alternating sections, hovered or selected rows. */
84
+ /* Theme-aware subtle contrast surface. Use: secondary panels, alternating sections, hovered or selected table rows. Pair: content/primary. Avoid: the page background. */
77
85
  --uai-surface-contrast: #e4e6e7;
78
- /* Inverted surface. Tooltips, snackbars, dark banners in light mode (and the reverse). Use content/inverse on it. */
86
+ /* Theme-aware inverted surface: dark in Light mode, light in Dark mode. Use: tooltips, snackbars and banners that must stand out from the page. Pair: content/inverse for text and icons. Avoid: large areas. */
79
87
  --uai-surface-inverse: #242729;
80
- /* Muted surface. Chips, tags, code blocks, table headers. Use content/secondary on it. */
88
+ /* Theme-aware muted surface. Use: chips, tags, code blocks, table headers, input adornment boxes and the avatar initials background. Pair: content/secondary for text and icons. */
81
89
  --uai-surface-muted: #f2f3f3;
82
- /* Cards, modals, popovers, dropdowns and drawers. Add an elevation style when it floats. */
90
+ /* Theme-aware main container surface. Use: cards, modals, popovers, dropdown panels, drawers, input fields and the app header. Pair: content/* tokens; add an elevation style when it floats. Avoid: the page canvas; use surface/background. */
83
91
  --uai-surface-paper: #ffffff;
84
92
  color-scheme: light;
85
93
  }
86
94
 
87
95
  :where([data-uai-theme="dark"]) {
88
- /* Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces. */
96
+ /* Last stop of the AI accent gradient (cyan). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features. */
97
+ --uai-accent-ai-end: #00c6d7;
98
+ /* Middle stop of the AI accent gradient (purple). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features. */
99
+ --uai-accent-ai-middle: #a855f7;
100
+ /* First stop of the AI accent gradient (blue). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features. */
101
+ --uai-accent-ai-start: #0099ff;
102
+ /* Theme-aware destructive action accent. Use: background of filled destructive buttons, and text and border of outline or text destructive actions on standard surfaces. Pair: action/destructive-foreground on filled buttons, never fixed/bright. Avoid: error messages; use feedback/error. */
89
103
  --uai-action-destructive: #fca5a5;
90
- /* Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright. */
104
+ /* Theme-aware text and icon color on action/destructive: white in Light, dark neutral in Dark. Avoid: replacing it with fixed/bright. */
91
105
  --uai-action-destructive-foreground: #181a1b;
92
- /* Outline and text button background — default state. */
106
+ /* Theme-aware background of outline and text (ghost) actions, default state. Pair: content/primary for the label. States: action/outline/hover and action/outline/pressed. */
93
107
  --uai-action-outline-default: #242729;
94
- /* Outline and text button background — hover state. Also list item hover. */
108
+ /* Theme-aware hover background of outline and text actions. Also the hover background of list and menu items. */
95
109
  --uai-action-outline-hover: #2f3437;
96
- /* Outline and text button background — pressed state. Also selected list item. */
110
+ /* Theme-aware pressed background of outline and text actions. Also the background of the selected list or menu item. */
97
111
  --uai-action-outline-pressed: #3b4144;
98
- /* Filled positive button background. Always pair with action/positive-foreground, never fixed/bright. Feedback text and outline/text actions use feedback/success instead. */
112
+ /* Theme-aware background of filled positive buttons. Pair: action/positive-foreground, never fixed/bright. Avoid: success text and outline or text actions; use feedback/success. */
99
113
  --uai-action-positive: #35de90;
100
- /* Text and icons on action/positive. Theme-aware foreground for filled positive buttons. */
114
+ /* Theme-aware text and icon color on action/positive: white in Light, dark neutral in Dark. */
101
115
  --uai-action-positive-foreground: #181a1b;
102
- /* Primary button background — default state. */
116
+ /* Theme-aware background of primary actions, default state: solid uai-button and the checked checkbox fill. Neutral (near-black in Light), not brand blue. Pair: action/primary/foreground. States: action/primary/hover and action/primary/pressed. */
103
117
  --uai-action-primary-default: #e4e6e7;
104
- /* Text and icons on primary buttons. */
118
+ /* Theme-aware text and icon color on action/primary backgrounds, including the checkbox check mark. Avoid: fixed/bright or content/inverse on primary actions. */
105
119
  --uai-action-primary-foreground: #242729;
106
- /* Primary button background — hover state. */
120
+ /* Theme-aware background of primary actions on hover. Use only as the hover state of action/primary/default. Pair: action/primary/foreground. */
107
121
  --uai-action-primary-hover: #d6d9db;
108
- /* Primary button background — pressed state. */
122
+ /* Theme-aware background of primary actions while pressed or active. Use only as the pressed state of action/primary/default. Pair: action/primary/foreground. */
109
123
  --uai-action-primary-pressed: #c8cccf;
110
- /* Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring. */
124
+ /* Theme-aware decorative border. Use: cards, dividers and separators. Avoid: as the only boundary of a form control or as the sole state indicator; use border/input or border/ring. */
111
125
  --uai-border-default: #2f3437;
112
- /* Essential form control boundary. Dark mode meets 3:1 on background, paper, contrast, muted and outline pressed surfaces. Do not use border/default as the only control boundary. */
126
+ /* Theme-aware essential boundary of form controls. Use: default borders of inputs, selects, checkboxes and radios. Dark mode meets 3:1 on background, paper, contrast, muted and outline pressed surfaces. Avoid: decorative dividers; use border/default. */
113
127
  --uai-border-input: #848e94;
114
- /* Solid neutral focus indicator, dark in Light and light in Dark. Use at full opacity. Inputs may add a separate outer halo with opacity/focus-ring, while keeping the solid focus border. Never reduce the opacity of the whole control. */
128
+ /* Theme-aware solid focus indicator: dark in Light, light in Dark. Use: focus border of inputs and focus outline of buttons, checkboxes and radios, always at full opacity. Inputs may add a separate outer halo with opacity/focus-ring. Avoid: reducing the opacity of the whole control. */
115
129
  --uai-border-ring: #ffffff;
116
- /* Disabled text and icons. */
130
+ /* Theme-aware color for disabled text, icons and control borders (inputs, checkbox, radio). Avoid: placeholders (use content/placeholder) and readable secondary text, because disabled content is exempt from contrast rules. */
117
131
  --uai-content-disabled: #768188;
118
- /* Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary. */
132
+ /* Theme-aware text and icon color for inverted surfaces. Use: text and icons on surface/inverse, such as tooltips and snackbars. Avoid: labels on filled actions; use the matching action foreground token. */
119
133
  --uai-content-inverse: #181a1b;
120
- /* Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. */
134
+ /* Theme-aware link color. Use: links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. Avoid: non-interactive emphasis. */
121
135
  --uai-content-link: #93c5fd;
122
- /* Input placeholder and hint text on standard surfaces. Not for disabled content. Dark mode meets 4.5:1 on background, paper, contrast, muted and outline pressed surfaces. */
136
+ /* Theme-aware placeholder color. Use: placeholder and empty-value hint text inside inputs and selects on standard surfaces. Dark mode meets 4.5:1 on background, paper, contrast, muted and outline pressed surfaces. Avoid: disabled content; use content/disabled. */
123
137
  --uai-content-placeholder: #adb4b8;
124
- /* Primary text and icons. Headings, body text, form labels. */
138
+ /* Theme-aware primary text and icon color. Use: headings, body text, input values and form labels on standard surfaces (background, paper, contrast, muted). Avoid: text on surface/inverse or on filled actions; use content/inverse or the matching action foreground. */
125
139
  --uai-content-primary: #ffffff;
126
- /* Secondary text and icons. Descriptions, supporting text, text on muted surfaces. */
140
+ /* Theme-aware secondary text and icon color. Use: descriptions, supporting text, input icons, avatar initials and text on surface/muted. Avoid: essential information that must be read at a glance; use content/primary. */
127
141
  --uai-content-secondary: #adb4b8;
128
- /* Error text and icons on standard surfaces or feedback/error-subtle. Keep a message or icon as a non-color cue. Filled destructive actions use action/destructive and its foreground. */
142
+ /* Theme-aware error color for text, icons and borders, such as an invalid input and its message, on standard surfaces or on feedback/error-subtle. Keep a message or icon as a non-color cue. Avoid: filled destructive buttons; use action/destructive. */
129
143
  --uai-feedback-error: #fca5a5;
130
- /* Error alert background. Pair with feedback/error for the icon. */
144
+ /* Theme-aware background of error alerts, banners and inline status areas. Pair: feedback/error for the icon and content/primary for the text. */
131
145
  --uai-feedback-error-subtle: #450a0a;
132
- /* Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background. */
146
+ /* Theme-aware information color for text, icons and borders on standard surfaces or on feedback/info-subtle. Avoid: filled button backgrounds. */
133
147
  --uai-feedback-info: #93c5fd;
134
- /* Info alert background. Pair with feedback/info for the icon. */
148
+ /* Theme-aware background of information alerts, banners and inline status areas. Pair: feedback/info for the icon and content/primary for the text. */
135
149
  --uai-feedback-info-subtle: #072563;
136
- /* Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons. */
150
+ /* Theme-aware success color for text, icons and borders, such as a valid input and its message, on standard surfaces or on feedback/success-subtle. Avoid: filled buttons; use action/positive with action/positive-foreground. */
137
151
  --uai-feedback-success: #35de90;
138
- /* Success alert background. Pair with feedback/success for the icon. */
152
+ /* Theme-aware background of success alerts, banners and inline status areas. Pair: feedback/success for the icon and content/primary for the text. */
139
153
  --uai-feedback-success-subtle: #022c22;
140
- /* Warning text and icons on standard surfaces or feedback/warning-subtle. Light-mode text still requires a contrast check. Not a filled button background. */
154
+ /* Theme-aware warning color for text, icons and borders on standard surfaces or on feedback/warning-subtle. Check text contrast in Light mode. Avoid: filled button backgrounds. */
141
155
  --uai-feedback-warning: #fb923c;
142
- /* Warning alert background. Pair with feedback/warning for the icon. */
156
+ /* Theme-aware background of warning alerts, banners and inline status areas. Pair: feedback/warning for the icon and content/primary for the text. */
143
157
  --uai-feedback-warning-subtle: #431407;
144
- /* Fixed Blip blue. Pair with fixed/bright for text on it. Do not use it as the sole selected-state boundary on every surface. */
158
+ /* Fixed Blip blue, the same in every theme. Pair: fixed/bright for text on it. Avoid: as the only selected-state boundary on every surface, and as a replacement for the neutral action/primary. */
145
159
  --uai-fixed-blue: #1e6bf1;
146
- /* Product brand color, invariant across themes. Use fixed/dim for normal text on this background, not fixed/bright. Brand color alone is not an accessible selected-state boundary on every surface. */
160
+ /* Product brand color, invariant across themes. Use: brand marks and illustrations. Pair: fixed/dim for normal text on it, not fixed/bright. Avoid: as the only selected-state boundary on every surface. */
147
161
  --uai-fixed-brand: #0099ff;
148
- /* Fixed white. Not a universal foreground: fails normal-text contrast on fixed/brand and bright feedback colors. Use on fixed/dim or fixed/blue; use fixed/dim on fixed/brand. */
162
+ /* Fixed white that does not change with the theme. Use: text and icons on fixed/dim or fixed/blue. Avoid: text on fixed/brand or on light feedback colors, where it fails normal-text contrast. */
149
163
  --uai-fixed-bright: #ffffff;
150
- /* Dark color that does not change with the theme. */
164
+ /* Fixed dark neutral that does not change with the theme. Use: text on fixed/brand, and dark areas that must look the same in Light and Dark. Avoid: theme-aware text; use content/primary. */
151
165
  --uai-fixed-dim: #242729;
152
- /* Backdrop behind modals, drawers and dialogs. */
166
+ /* Theme-aware translucent backdrop behind modals, drawers and dialogs. Avoid: hover or pressed feedback; use overlay/hover or overlay/pressed. */
153
167
  --uai-overlay-default: rgba(0, 0, 0, 0.8);
154
- /* Translucent layer for hover on any interactive surface. */
168
+ /* Theme-aware translucent hover layer placed over any interactive surface: black tint in Light, white tint in Dark. Use: menu items, icon buttons and the radio hover halo. Avoid: as a solid background. */
155
169
  --uai-overlay-hover: rgba(255, 255, 255, 0.08);
156
- /* Translucent background for insight panels and floating cards. */
170
+ /* Theme-aware translucent background for insight panels and floating cards over content. Pair: content/primary. */
157
171
  --uai-overlay-insight: rgba(0, 0, 0, 0.8);
158
- /* Translucent layer for pressed state on any interactive surface. */
172
+ /* Theme-aware translucent pressed layer placed over any interactive surface. Use: the pressed state wherever overlay/hover is the hover state. */
159
173
  --uai-overlay-pressed: rgba(255, 255, 255, 0.16);
160
- /* Page background. The base layer behind every screen. */
174
+ /* Theme-aware translucent layer for the selected item in navigation placed over any surface: black tint in Light, white tint in Dark. Use: selected header navigation and side menu items, together with medium font weight. Pair: content/primary. Avoid: selected list or menu options in panels; use action/outline/pressed. */
175
+ --uai-overlay-selected: rgba(255, 255, 255, 0.06);
176
+ /* Theme-aware page background, the base layer behind every screen. Use: app canvas and the area around cards. Pair: content/primary and content/secondary. Avoid: cards, fields and floating panels; use surface/paper. */
161
177
  --uai-surface-background: #181a1b;
162
- /* Subtle contrast surface. Secondary panels, alternating sections, hovered or selected rows. */
178
+ /* Theme-aware subtle contrast surface. Use: secondary panels, alternating sections, hovered or selected table rows. Pair: content/primary. Avoid: the page background. */
163
179
  --uai-surface-contrast: #2f3437;
164
- /* Inverted surface. Tooltips, snackbars, dark banners in light mode (and the reverse). Use content/inverse on it. */
180
+ /* Theme-aware inverted surface: dark in Light mode, light in Dark mode. Use: tooltips, snackbars and banners that must stand out from the page. Pair: content/inverse for text and icons. Avoid: large areas. */
165
181
  --uai-surface-inverse: #f2f3f3;
166
- /* Muted surface. Chips, tags, code blocks, table headers. Use content/secondary on it. */
182
+ /* Theme-aware muted surface. Use: chips, tags, code blocks, table headers, input adornment boxes and the avatar initials background. Pair: content/secondary for text and icons. */
167
183
  --uai-surface-muted: #2f3437;
168
- /* Cards, modals, popovers, dropdowns and drawers. Add an elevation style when it floats. */
184
+ /* Theme-aware main container surface. Use: cards, modals, popovers, dropdown panels, drawers, input fields and the app header. Pair: content/* tokens; add an elevation style when it floats. Avoid: the page canvas; use surface/background. */
169
185
  --uai-surface-paper: #242729;
170
186
  color-scheme: dark;
171
187
  }
@@ -1,74 +1,88 @@
1
1
  :where([data-uai-theme]:not([data-uai-theme] *)) {
2
- /* Border width. 1px. Standard borders. */
2
+ /* Border width 1px. Default for every border: inputs, selects, checkboxes, cards and dividers, including the solid focus border of inputs. */
3
3
  --uai-border-width-default: 1px;
4
- /* Border width. 0px. */
4
+ /* Border width 0px. Use: removing a border explicitly. */
5
5
  --uai-border-width-none: 0px;
6
- /* Border width. 2px. Focus rings and emphasis borders. */
6
+ /* Border width 2px. Use: focus rings and halos, the checked radio border and emphasis borders. */
7
7
  --uai-border-width-thick: 2px;
8
- /* Supplementary outer focus halo opacity: 30 percent in Figma, normalized to unitless 0.3 in web outputs. Apply only to the halo layer; retain a solid focus border or outline. Never apply to the full control or as the sole focus indication. */
8
+ /* Control height 24px. Compact controls: 24px icon-only buttons and the compact uai-button, toolbars and dense tables. Pair: radius/md and caption text. Avoid: primary actions and form fields in regular forms. Avoid: spacing tokens for heights. */
9
+ --uai-control-height-compact: 1.5rem;
10
+ /* Control height 56px. Large controls: 56px buttons for prominent single actions, such as hero or empty-state calls to action. Pair: radius/lg and spacing/md horizontal padding. Avoid: dense forms and tables. Avoid: spacing tokens for heights. */
11
+ --uai-control-height-large: 3.5rem;
12
+ /* Control height 40px. Default control height: buttons, inputs, selects, datepickers and header actions. Pair: radius/lg, spacing/sm horizontal padding and body/base text. Use this size when unsure. Avoid: spacing tokens for heights. */
13
+ --uai-control-height-medium: 2.5rem;
14
+ /* Control height 32px. Short controls: 32px buttons, inputs and selects in dense areas such as filters, table toolbars and breadcrumb items. Pair: radius/lg and body/base text. Avoid: spacing tokens for heights. */
15
+ --uai-control-height-short: 2rem;
16
+ /* Opacity of a disabled control: 50 percent in Figma, unitless 0.5 in web outputs. Use only where the component contract dims the whole control, such as uai-button. Avoid: inputs and selection controls, which use content/disabled colors instead. */
17
+ --uai-opacity-disabled: 0.5;
18
+ /* Opacity of the supplementary outer focus halo: 30 percent in Figma, unitless 0.3 in web outputs. Apply only to the halo layer and keep a solid border/ring focus indicator. Avoid: the whole control, or the halo as the only focus cue. */
9
19
  --uai-opacity-focus-ring: 0.3;
10
- /* Border radius. 24px. */
20
+ /* Corner radius 24px. Reserved for very large surfaces; no UAI component uses it yet. Confirm with design before applying. */
11
21
  --uai-radius-2xl: 1.5rem;
12
- /* Border radius. Full round. */
22
+ /* Fully rounded corners (pill or circle). Use: avatars, radio buttons, the radio hover halo, badges and pill-shaped chips. */
13
23
  --uai-radius-full: 624.9375rem;
14
- /* Border radius. 12px. */
24
+ /* Corner radius 12px. Default for controls and the panels they open: inputs, selects, buttons (32 to 56px), dropdown and listbox panels, menu items, datepicker day cells and header actions. */
15
25
  --uai-radius-lg: 0.75rem;
16
- /* Border radius. 8px. */
26
+ /* Corner radius 8px. Use: compact 24px controls, such as the compact uai-button, and other small interactive elements. */
17
27
  --uai-radius-md: 0.5rem;
18
- /* Border radius. 0px. */
28
+ /* Corner radius 0px. Use: square corners on full-bleed surfaces, table cells and edges that touch other elements. */
19
29
  --uai-radius-none: 0rem;
20
- /* Border radius. 4px. */
30
+ /* Corner radius 4px. Use: checkboxes, chip remove buttons, small badges and other small inner elements. */
21
31
  --uai-radius-sm: 0.25rem;
22
- /* Border radius. 16px. */
32
+ /* Corner radius 16px. Reserved for large surfaces; no UAI component uses it yet. Confirm with design before applying. */
23
33
  --uai-radius-xl: 1rem;
24
- /* Border radius. 2px. */
34
+ /* Corner radius 2px. Use: tiny inner marks and indicators. Avoid: controls and containers. */
25
35
  --uai-radius-xs: 0.125rem;
26
- /* Fixed size. 40px. Medium avatars. */
36
+ /* Fixed size 40px. Use: small avatar and square icon containers. Avoid: control heights of buttons, inputs and selects; use control-height/medium. */
27
37
  --uai-sizing-2xl: 2.5rem;
28
- /* Fixed size. 48px. Large avatars. */
38
+ /* Fixed size 8px. Use: the tooltip arrow, notification dots on header actions and other very small indicators. Avoid: padding and gaps; use spacing/*. */
39
+ --uai-sizing-2xs: 0.5rem;
40
+ /* Fixed size 48px. Use: standard avatar. */
29
41
  --uai-sizing-3xl: 3rem;
30
- /* Fixed size. 64px. Extra large avatars. */
42
+ /* Fixed size 64px. Use: large avatar. */
31
43
  --uai-sizing-4xl: 4rem;
32
- /* Fixed size. 24px. Icon medium (default). */
44
+ /* Fixed size 72px. Use: extra-large avatar. */
45
+ --uai-sizing-5xl: 4.5rem;
46
+ /* Fixed size 24px. Use: default icons (uai-icon size medium) and the micro avatar. Avoid: control heights; use control-height/compact. */
33
47
  --uai-sizing-lg: 1.5rem;
34
- /* Fixed size. 20px. Icon small. */
48
+ /* Fixed size 20px. Use: small icons (uai-icon size small), checkbox and radio controls. */
35
49
  --uai-sizing-md: 1.25rem;
36
- /* Fixed size. 16px. Icon x-small. */
50
+ /* Fixed size 16px. Use: x-small icons (uai-icon size x-small), such as the header breadcrumb chevrons. */
37
51
  --uai-sizing-sm: 1rem;
38
- /* Fixed size. 32px. Small avatars. */
52
+ /* Fixed size 32px. Use: extra-small avatar, the radio hover halo and datepicker day cells. Avoid: control heights; use control-height/short. */
39
53
  --uai-sizing-xl: 2rem;
40
- /* Fixed size. 12px. Status dots, tiny indicators. */
54
+ /* Fixed size 12px. Use: status dots, tiny indicators and the selected radio dot. Avoid: padding and gaps; use spacing/*. */
41
55
  --uai-sizing-xs: 0.75rem;
42
- /* Spacing. 40px. */
56
+ /* Spacing 40px. Layout spacing between large page regions. Avoid: control heights; use control-height/medium. */
43
57
  --uai-spacing-2xl: 2.5rem;
44
- /* Spacing. 4px. */
58
+ /* Spacing 4px. Smallest gap between related items: label to field and field to message in inputs, and the offset of a dropdown or popover from its trigger. */
45
59
  --uai-spacing-2xs: 0.25rem;
46
- /* Spacing. 48px. */
60
+ /* Spacing 48px. Layout spacing between large page regions. */
47
61
  --uai-spacing-3xl: 3rem;
48
- /* Spacing. 2px. */
62
+ /* Spacing 2px. Hairline gaps and offsets inside small elements, such as the side padding of avatar initials. Avoid: widths and heights; use sizing/*. */
49
63
  --uai-spacing-3xs: 0.125rem;
50
- /* Spacing. 56px. */
64
+ /* Spacing 56px. Layout spacing for page margins and large regions. Avoid: control heights; use control-height/large. */
51
65
  --uai-spacing-4xl: 3.5rem;
52
- /* Spacing. 64px. */
66
+ /* Spacing 64px. Layout spacing for page margins and large regions. */
53
67
  --uai-spacing-5xl: 4rem;
54
- /* Spacing. 72px. */
68
+ /* Spacing 72px. Layout spacing for page margins and large regions. Avoid: the header height, which comes from its content and padding. */
55
69
  --uai-spacing-6xl: 4.5rem;
56
- /* Spacing. 80px. */
70
+ /* Spacing 80px. Layout spacing for page margins and hero areas. */
57
71
  --uai-spacing-7xl: 5rem;
58
- /* Spacing. 88px. */
72
+ /* Spacing 88px. Layout spacing for page margins and hero areas. */
59
73
  --uai-spacing-8xl: 5.5rem;
60
- /* Spacing. 96px. */
74
+ /* Spacing 96px. Largest layout spacing, for hero and landing areas. */
61
75
  --uai-spacing-9xl: 6rem;
62
- /* Spacing. 24px. */
76
+ /* Spacing 24px. Gap between groups of content and between navigation bar items (uai-navbar). */
63
77
  --uai-spacing-lg: 1.5rem;
64
- /* Spacing. 16px. */
78
+ /* Spacing 16px. Default padding of containers such as the app header, cards and dropdown search rows. The header height comes from sizing/2xl content plus this padding above and below. */
65
79
  --uai-spacing-md: 1rem;
66
- /* Spacing. 0px. */
80
+ /* Spacing 0px. Use: removing gaps or padding explicitly. */
67
81
  --uai-spacing-none: 0rem;
68
- /* Spacing. 12px. */
82
+ /* Spacing 12px. Horizontal padding of buttons and other controls. */
69
83
  --uai-spacing-sm: 0.75rem;
70
- /* Spacing. 32px. */
84
+ /* Spacing 32px. Layout spacing between page sections. */
71
85
  --uai-spacing-xl: 2rem;
72
- /* Spacing. 8px. */
86
+ /* Spacing 8px. Gap between an icon and its label, between a checkbox or radio and its label, and between header actions; minimum distance from the viewport edge for floating panels and the tooltip offset from its trigger. */
73
87
  --uai-spacing-xs: 0.5rem;
74
88
  }