blip-tokens 2.2.0 → 2.3.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/README.md CHANGED
@@ -147,15 +147,82 @@ references resolved to values so it has no dangling aliases. Descriptions,
147
147
  Figma scopes and variable IDs stay attached to each published semantic token.
148
148
  CSS custom properties include each token's Figma usage description as a
149
149
  comment. The legacy outputs remain available alongside them.
150
- The 305-variable count covers variable collections only: 206 Foundation
151
- primitives are internal, and 99 semantic variables are published. Separately,
150
+ The 306-variable count covers variable collections only: 206 Foundation
151
+ primitives are internal, and 100 semantic variables are published. Separately,
152
152
  the Figma file has eight elevation effect styles, published as variables, and
153
153
  28 text styles, published as metadata, without exposing Foundation primitives.
154
154
  There are no per-component color or typography tokens: components use the
155
155
  semantic tokens directly, so their names stay stable across light and dark modes.
156
156
 
157
+ ### Focus indicators
158
+
159
+ `border/ring` (`--uai-border-ring`) is a solid neutral focus color: dark in Light
160
+ mode and light in Dark mode, using the same Foundation aliases as `content/primary`.
161
+ It replaces the previous purple value without renaming the public token.
162
+ Consumers such as UaiButton keep a full-opacity focus outline.
163
+
164
+ For UaiInput, the focused control has two independent layers: a solid 1 px border
165
+ and a 2 px outer halo. Only the halo uses semantic `opacity/focus-ring`
166
+ (`--uai-opacity-focus-ring`, unitless `0.3`);
167
+ never reduce the opacity of the whole input or of every focus indicator.
168
+ The token lives in Dimensions: Figma opacity bindings require percentages, so
169
+ its source value is `30`, explicitly normalized to unitless `0.3` in DTCG,
170
+ CSS, SCSS and JavaScript outputs. Foundation's pre-existing fractional opacity
171
+ primitives remain private and unchanged. Do not invent a local opacity
172
+ value or reuse a pressed overlay for this role.
173
+ The halo is supplementary, not the only focus cue. Keep geometry tokenized,
174
+ avoid layout shifts, and verify focus contrast and forced-colors behavior in
175
+ the consuming component.
176
+
177
+ The halo maps directly to a zero-blur CSS shadow; it does not change the
178
+ control's box size:
179
+
180
+ ```css
181
+ .control[data-focused] {
182
+ border-color: var(--uai-border-ring);
183
+ box-shadow: 0 0 0 var(--uai-border-width-thick)
184
+ color-mix(in srgb, var(--uai-border-ring) calc(var(--uai-opacity-focus-ring) * 100%), transparent);
185
+ }
186
+
187
+ @media (forced-colors: active) {
188
+ .control[data-focused] {
189
+ box-shadow: none;
190
+ outline: var(--uai-border-width-thick) solid CanvasText;
191
+ outline-offset: var(--uai-border-width-default);
192
+ }
193
+ }
194
+ ```
195
+
196
+ The consumer tracks focus, not whether `value` is empty or typing is in progress.
197
+ Keep the normal border width and radius unchanged, and ensure that parent
198
+ containers do not clip the halo.
199
+
157
200
  ### Using the tokens in a component
158
201
 
202
+ #### Dark-mode contrast and action colors
203
+
204
+ The [dark-theme contrast and migration report](docs/dark-theme-contrast.md)
205
+ records the audited foreground/background pairs, changed values and consumer
206
+ impact. Dark text and feedback accents target **4.5:1** on the supported standard
207
+ surfaces; essential control borders and solid focus cues target **3:1**.
208
+ This is color-contrast coverage, not a claim of complete WCAG conformance.
209
+
210
+ - Use `feedback/*` for text/icons on standard or matching subtle surfaces, not
211
+ as a universal filled-button background.
212
+ - Filled positive actions pair `action/positive` with
213
+ `action/positive-foreground`. Filled destructive actions pair
214
+ `action/destructive` with `action/destructive-foreground`. Never assume
215
+ white text: both foregrounds are dark neutrals in Dark mode.
216
+ - `border/default` is decorative. Use `border/input` for an essential control
217
+ boundary and `border/ring` for focus.
218
+ - `fixed/brand` keeps its brand value; pair it with `fixed/dim`, not white.
219
+ Keep `fixed/bright` for supported dark backgrounds such as `fixed/dim` and
220
+ `fixed/blue`.
221
+ - Keep non-color cues for errors, links and selection. Disabled content is
222
+ exempt from contrast requirements; placeholders are not.
223
+ - Light placeholder, success and warning text have existing contrast gaps and
224
+ are outside this Dark correction. Do not infer Light compliance from this audit.
225
+
159
226
  The tokens are an internal contract of the blip-ds design system. Only blip-ds
160
227
  components read them. Micro frontends (MFEs) consume blip-ds components and do
161
228
  not import `blip-tokens` or use `var(--uai-*)`: spacing and layout come from the
@@ -666,7 +733,7 @@ Component artwork SVGs live in `assets/components/` and are registered under `as
666
733
 
667
734
  ## CDN Assets
668
735
 
669
- All five artwork families are delivered as standalone SVGs through the CDN, not embedded in the npm package. Import the packaged manifest to resolve an asset URL:
736
+ Artwork families and UAI icons are delivered as standalone SVGs through the CDN, not embedded in the npm package. Import the packaged manifest to resolve an asset URL:
670
737
 
671
738
  ```javascript
672
739
  import manifest from 'blip-tokens/assets/manifest' with { type: 'json' };
@@ -679,7 +746,25 @@ JSON import syntax depends on the consuming runtime or bundler. Each manifest en
679
746
 
680
747
  The default URL pattern is `https://cdn.blip.ai/blip-tokens/<version>/<asset.path>`. Use the manifest shipped with the installed package so its version and asset paths stay aligned. A local build's `unreleased` directory is not published automatically.
681
748
 
682
- The generator rejects invalid SVG documents, active content, external references, source paths outside `assets/`, and duplicate output paths. Add artwork to its registry as well as the filesystem; CDN generation reads registries, while icon names/types are generated from the filesystem.
749
+ ### Figtree
750
+
751
+ The CDN manifest includes the variable Figtree WOFF2 subsets `font/figtree/latin`
752
+ and `font/figtree/latin-ext`, both covering weights 300–900. Resolve each URL from
753
+ the installed package's manifest; use both subsets with the matching
754
+ `unicode-range` declarations from the
755
+ [Google Fonts stylesheet](https://fonts.googleapis.com/css2?family=Figtree:wght@300..900&display=swap).
756
+ The same CDN manifest also includes `font/figtree/license` (`fonts/figtree/OFL.txt`).
757
+ The font and license are CDN-only and are not included in the npm package.
758
+
759
+ Figtree is redistributed under the SIL Open Font License 1.1. Keep the license
760
+ available alongside the font when using these assets. Source files are from
761
+ [Google Fonts' Figtree family](https://github.com/google/fonts/tree/main/ofl/figtree).
762
+
763
+ The generator validates SVG documents, active content, external references,
764
+ WOFF2 signatures, the Figtree license, source paths outside `assets/`, and
765
+ duplicate output paths. Add artwork to its registry as well as the filesystem;
766
+ CDN generation reads registries, while icon names/types are generated from the
767
+ filesystem.
683
768
 
684
769
  ---
685
770
 
@@ -706,7 +791,7 @@ The build clears previous outputs and runs four steps:
706
791
  1. **Style Dictionary 2** (`config.cjs`) — transforms only color and theme tokens into the legacy JSON, CSS, and SCSS; artwork registries are not inputs
707
792
  2. **Icon types generator** (`scripts/generate_icon_types.js`) — produces `build/icons.js` and `build/icons.d.ts`
708
793
  3. **Figma token pipeline** (`scripts/build_tokens.js`) — validates the Figma snapshot, normalizes DTCG, resolves aliases and generates the `--uai-*` outputs with Style Dictionary 5. It runs after step 1 and writes only `uai-*` files, `tokens.js` and `tokens.d.ts`, so the legacy files are not touched
709
- 4. **CDN asset generator** (`scripts/generate_assets.cjs`) — reads the SVG source registries directly, validates and copies artwork, and generates the asset manifest without intermediate embedded JSON catalogs
794
+ 4. **CDN asset generator** (`scripts/generate_assets.cjs`) — reads the SVG source registries directly, validates and copies artwork and Figtree font files, and generates the asset manifest without intermediate embedded JSON catalogs
710
795
 
711
796
  Style Dictionary 5 is installed as the `style-dictionary-v5` alias next to
712
797
  Style Dictionary 2, which the legacy and asset builds still use. Run `npm test`
@@ -745,7 +830,8 @@ build/
745
830
  │ └── extended-color.json # Legacy extended palette
746
831
  ├── assets/v1/
747
832
  │ ├── manifest.json # Packaged inventory; used for validation, not uploaded
748
- │ └── .../*.svg # CDN upload only; excluded from npm
833
+ │ ├── .../*.svg # CDN upload only; excluded from npm
834
+ │ └── fonts/figtree/ # Variable WOFF2 subsets and OFL license; CDN only
749
835
  ├── tokens.js # ESM theme maps, styles and metadata
750
836
  ├── tokens.d.ts # Token, style and metadata types
751
837
  ├── icons.js # Runtime icon arrays + helpers
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "version": "2.2.0",
3
+ "version": "2.3.0",
4
4
  "baseUrl": "https://cdn.blip.ai/blip-tokens/",
5
5
  "assets": {
6
6
  "asset-icon-123-outline": {
@@ -11126,6 +11126,24 @@
11126
11126
  "bytes": 5296,
11127
11127
  "sha256": "eb10fd17c1112452ec9873e84a3511a26b70749c785064069c4182d73e9d92c2",
11128
11128
  "contentType": "image/svg+xml"
11129
+ },
11130
+ "font/figtree/latin": {
11131
+ "path": "fonts/figtree/latin.woff2",
11132
+ "bytes": 20184,
11133
+ "sha256": "8330490a01c60c196eae00b823de8102275aaa5862e7b76a7af21b8745338928",
11134
+ "contentType": "font/woff2"
11135
+ },
11136
+ "font/figtree/latin-ext": {
11137
+ "path": "fonts/figtree/latin-ext.woff2",
11138
+ "bytes": 10228,
11139
+ "sha256": "f153aa07c1b16fbb12391c2512860c97819a0a9fd014f338b2b3f12496479d13",
11140
+ "contentType": "font/woff2"
11141
+ },
11142
+ "font/figtree/license": {
11143
+ "path": "fonts/figtree/OFL.txt",
11144
+ "bytes": 4387,
11145
+ "sha256": "bb272dfcd8801eb31fb98fe51828f76f0e41ac82f89256101df8021aa3d30ce2",
11146
+ "contentType": "text/plain"
11129
11147
  }
11130
11148
  }
11131
11149
  }
@@ -1,7 +1,7 @@
1
1
  :where([data-uai-theme="light"]) {
2
- /* Destructive button (delete, remove). Same red as feedback/error. */
2
+ /* Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces. */
3
3
  --uai-action-destructive: #cf0022;
4
- /* Text and icons on destructive buttons. */
4
+ /* Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright. */
5
5
  --uai-action-destructive-foreground: #ffffff;
6
6
  /* Outline and text button background — default state. */
7
7
  --uai-action-outline-default: #ffffff;
@@ -9,6 +9,10 @@
9
9
  --uai-action-outline-hover: #f2f3f3;
10
10
  /* Outline and text button background — pressed state. Also selected list item. */
11
11
  --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. */
13
+ --uai-action-positive: #047857;
14
+ /* Text and icons on action/positive. Theme-aware foreground for filled positive buttons. */
15
+ --uai-action-positive-foreground: #ffffff;
12
16
  /* Primary button background — default state. */
13
17
  --uai-action-primary-default: #242729;
14
18
  /* Text and icons on primary buttons. */
@@ -17,45 +21,45 @@
17
21
  --uai-action-primary-hover: #181a1b;
18
22
  /* Primary button background — pressed state. */
19
23
  --uai-action-primary-pressed: #0a0a0a;
20
- /* Default border. Cards, dividers, separators. */
24
+ /* Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring. */
21
25
  --uai-border-default: #e4e6e7;
22
- /* Form control border. Inputs, selects, checkboxes, outline buttons. */
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. */
23
27
  --uai-border-input: #adb4b8;
24
- /* Focus ring for keyboard navigation. */
25
- --uai-border-ring: #c084fc;
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. */
29
+ --uai-border-ring: #242729;
26
30
  /* Disabled text and icons. */
27
31
  --uai-content-disabled: #848e94;
28
32
  /* Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary. */
29
33
  --uai-content-inverse: #ffffff;
30
- /* Links and interactive navigation text. */
34
+ /* Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. */
31
35
  --uai-content-link: #0073e5;
32
- /* Input placeholder and hint text. Not for disabled content. */
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. */
33
37
  --uai-content-placeholder: #adb4b8;
34
38
  /* Primary text and icons. Headings, body text, form labels. */
35
39
  --uai-content-primary: #242729;
36
40
  /* Secondary text and icons. Descriptions, supporting text, text on muted surfaces. */
37
41
  --uai-content-secondary: #5f676d;
38
- /* Error. Field errors, failures, destructive confirmations. Components call it &quot;negative&quot;. */
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. */
39
43
  --uai-feedback-error: #cf0022;
40
44
  /* Error alert background. Pair with feedback/error for the icon. */
41
45
  --uai-feedback-error-subtle: #fef2f2;
42
- /* Information. Info alerts, status badges and icons. */
46
+ /* Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background. */
43
47
  --uai-feedback-info: #0073e5;
44
48
  /* Info alert background. Pair with feedback/info for the icon. */
45
49
  --uai-feedback-info-subtle: #eff6ff;
46
- /* Success. Confirmations, positive validation, completed states. Components call it &quot;positive&quot;. */
50
+ /* Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons. */
47
51
  --uai-feedback-success: #3da329;
48
52
  /* Success alert background. Pair with feedback/success for the icon. */
49
53
  --uai-feedback-success-subtle: #ecfdf5;
50
- /* Warning. States that need attention. For text on light surfaces, check contrast. */
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. */
51
55
  --uai-feedback-warning: #ff8000;
52
56
  /* Warning alert background. Pair with feedback/warning for the icon. */
53
57
  --uai-feedback-warning-subtle: #fff7ed;
54
- /* Blip blue that does not change with the theme. Selected states and highlights. */
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. */
55
59
  --uai-fixed-blue: #1e6bf1;
56
- /* Product brand color. Changes per product, not per theme. Banners, highlights. */
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. */
57
61
  --uai-fixed-brand: #0099ff;
58
- /* Light color that does not change with the theme. Text on fixed/brand. */
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. */
59
63
  --uai-fixed-bright: #ffffff;
60
64
  /* Dark color that does not change with the theme. */
61
65
  --uai-fixed-dim: #242729;
@@ -81,16 +85,20 @@
81
85
  }
82
86
 
83
87
  :where([data-uai-theme="dark"]) {
84
- /* Destructive button (delete, remove). Same red as feedback/error. */
85
- --uai-action-destructive: #cf0022;
86
- /* Text and icons on destructive buttons. */
87
- --uai-action-destructive-foreground: #ffffff;
88
+ /* Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces. */
89
+ --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. */
91
+ --uai-action-destructive-foreground: #181a1b;
88
92
  /* Outline and text button background — default state. */
89
93
  --uai-action-outline-default: #242729;
90
94
  /* Outline and text button background — hover state. Also list item hover. */
91
95
  --uai-action-outline-hover: #2f3437;
92
96
  /* Outline and text button background — pressed state. Also selected list item. */
93
97
  --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. */
99
+ --uai-action-positive: #35de90;
100
+ /* Text and icons on action/positive. Theme-aware foreground for filled positive buttons. */
101
+ --uai-action-positive-foreground: #181a1b;
94
102
  /* Primary button background — default state. */
95
103
  --uai-action-primary-default: #e4e6e7;
96
104
  /* Text and icons on primary buttons. */
@@ -99,45 +107,45 @@
99
107
  --uai-action-primary-hover: #d6d9db;
100
108
  /* Primary button background — pressed state. */
101
109
  --uai-action-primary-pressed: #c8cccf;
102
- /* Default border. Cards, dividers, separators. */
110
+ /* Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring. */
103
111
  --uai-border-default: #2f3437;
104
- /* Form control border. Inputs, selects, checkboxes, outline buttons. */
105
- --uai-border-input: #5f676d;
106
- /* Focus ring for keyboard navigation. */
107
- --uai-border-ring: #c084fc;
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. */
113
+ --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. */
115
+ --uai-border-ring: #ffffff;
108
116
  /* Disabled text and icons. */
109
117
  --uai-content-disabled: #768188;
110
118
  /* Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary. */
111
119
  --uai-content-inverse: #181a1b;
112
- /* Links and interactive navigation text. */
113
- --uai-content-link: #0099ff;
114
- /* Input placeholder and hint text. Not for disabled content. */
115
- --uai-content-placeholder: #768188;
120
+ /* Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. */
121
+ --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. */
123
+ --uai-content-placeholder: #adb4b8;
116
124
  /* Primary text and icons. Headings, body text, form labels. */
117
125
  --uai-content-primary: #ffffff;
118
126
  /* Secondary text and icons. Descriptions, supporting text, text on muted surfaces. */
119
127
  --uai-content-secondary: #adb4b8;
120
- /* Error. Field errors, failures, destructive confirmations. Components call it &quot;negative&quot;. */
121
- --uai-feedback-error: #cf0022;
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. */
129
+ --uai-feedback-error: #fca5a5;
122
130
  /* Error alert background. Pair with feedback/error for the icon. */
123
131
  --uai-feedback-error-subtle: #450a0a;
124
- /* Information. Info alerts, status badges and icons. */
125
- --uai-feedback-info: #0073e5;
132
+ /* Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background. */
133
+ --uai-feedback-info: #93c5fd;
126
134
  /* Info alert background. Pair with feedback/info for the icon. */
127
135
  --uai-feedback-info-subtle: #072563;
128
- /* Success. Confirmations, positive validation, completed states. Components call it &quot;positive&quot;. */
129
- --uai-feedback-success: #3da329;
136
+ /* Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons. */
137
+ --uai-feedback-success: #35de90;
130
138
  /* Success alert background. Pair with feedback/success for the icon. */
131
139
  --uai-feedback-success-subtle: #022c22;
132
- /* Warning. States that need attention. For text on light surfaces, check contrast. */
133
- --uai-feedback-warning: #ff8000;
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. */
141
+ --uai-feedback-warning: #fb923c;
134
142
  /* Warning alert background. Pair with feedback/warning for the icon. */
135
143
  --uai-feedback-warning-subtle: #431407;
136
- /* Blip blue that does not change with the theme. Selected states and highlights. */
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. */
137
145
  --uai-fixed-blue: #1e6bf1;
138
- /* Product brand color. Changes per product, not per theme. Banners, highlights. */
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. */
139
147
  --uai-fixed-brand: #0099ff;
140
- /* Light color that does not change with the theme. Text on fixed/brand. */
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. */
141
149
  --uai-fixed-bright: #ffffff;
142
150
  /* Dark color that does not change with the theme. */
143
151
  --uai-fixed-dim: #242729;
@@ -5,6 +5,8 @@
5
5
  --uai-border-width-none: 0px;
6
6
  /* Border width. 2px. Focus rings 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. */
9
+ --uai-opacity-focus-ring: 0.3;
8
10
  /* Border radius. 24px. */
9
11
  --uai-radius-2xl: 1.5rem;
10
12
  /* Border radius. Full round. */