@workday/canvas-kit-docs 16.0.0 → 16.0.2

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.
@@ -229805,7 +229805,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
229805
229805
  {
229806
229806
  "name": "BRAND_SCOPE_INDEPENDENT",
229807
229807
  "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
229808
- "description": "Independently brandable tokens — writable when explicitly provided,\nbut NEVER derived from primary.main / brand.primary.600.",
229808
+ "description": "Independently brandable tokens — writable when explicitly provided,\nbut NEVER derived from primary.main / brand.primary.600 / brand.primary.500.",
229809
229809
  "declarations": [
229810
229810
  {
229811
229811
  "name": "BRAND_SCOPE_INDEPENDENT",
@@ -229847,31 +229847,6 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
229847
229847
  ],
229848
229848
  "tags": {}
229849
229849
  },
229850
- {
229851
- "kind": "property",
229852
- "name": "brandToken",
229853
- "defaultValue": {
229854
- "kind": "property",
229855
- "name": "primary500",
229856
- "type": {
229857
- "kind": "string",
229858
- "value": "--cnvs-brand-primary-500"
229859
- }
229860
- },
229861
- "type": {
229862
- "kind": "string",
229863
- "value": "--cnvs-brand-primary-500"
229864
- },
229865
- "required": true,
229866
- "description": "",
229867
- "declarations": [
229868
- {
229869
- "name": "brandToken",
229870
- "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
229871
- }
229872
- ],
229873
- "tags": {}
229874
- },
229875
229850
  {
229876
229851
  "kind": "property",
229877
229852
  "name": "semanticKey",
@@ -229923,31 +229898,6 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
229923
229898
  ],
229924
229899
  "tags": {}
229925
229900
  },
229926
- {
229927
- "kind": "property",
229928
- "name": "brandToken",
229929
- "defaultValue": {
229930
- "kind": "property",
229931
- "name": "primary500",
229932
- "type": {
229933
- "kind": "string",
229934
- "value": "--cnvs-brand-primary-500"
229935
- }
229936
- },
229937
- "type": {
229938
- "kind": "string",
229939
- "value": "--cnvs-brand-primary-500"
229940
- },
229941
- "required": true,
229942
- "description": "",
229943
- "declarations": [
229944
- {
229945
- "name": "brandToken",
229946
- "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
229947
- }
229948
- ],
229949
- "tags": {}
229950
- },
229951
229901
  {
229952
229902
  "kind": "property",
229953
229903
  "name": "semanticKey",
@@ -230012,31 +229962,6 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
230012
229962
  ],
230013
229963
  "tags": {}
230014
229964
  },
230015
- {
230016
- "kind": "property",
230017
- "name": "brandToken",
230018
- "defaultValue": {
230019
- "kind": "property",
230020
- "name": "primary500",
230021
- "type": {
230022
- "kind": "string",
230023
- "value": "--cnvs-brand-primary-500"
230024
- }
230025
- },
230026
- "type": {
230027
- "kind": "string",
230028
- "value": "--cnvs-brand-primary-500"
230029
- },
230030
- "required": true,
230031
- "description": "",
230032
- "declarations": [
230033
- {
230034
- "name": "brandToken",
230035
- "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
230036
- }
230037
- ],
230038
- "tags": {}
230039
- },
230040
229965
  {
230041
229966
  "kind": "property",
230042
229967
  "name": "semanticKey",
@@ -230088,31 +230013,6 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
230088
230013
  ],
230089
230014
  "tags": {}
230090
230015
  },
230091
- {
230092
- "kind": "property",
230093
- "name": "brandToken",
230094
- "defaultValue": {
230095
- "kind": "property",
230096
- "name": "primary500",
230097
- "type": {
230098
- "kind": "string",
230099
- "value": "--cnvs-brand-primary-500"
230100
- }
230101
- },
230102
- "type": {
230103
- "kind": "string",
230104
- "value": "--cnvs-brand-primary-500"
230105
- },
230106
- "required": true,
230107
- "description": "",
230108
- "declarations": [
230109
- {
230110
- "name": "brandToken",
230111
- "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
230112
- }
230113
- ],
230114
- "tags": {}
230115
- },
230116
230016
  {
230117
230017
  "kind": "property",
230118
230018
  "name": "semanticKey",
@@ -230714,10 +230614,109 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
230714
230614
  }
230715
230615
  }
230716
230616
  },
230617
+ {
230618
+ "name": "writeFocusShortcuts",
230619
+ "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
230620
+ "description": "Writes first-class focus shortcuts — never derived from brand.primary.",
230621
+ "declarations": [
230622
+ {
230623
+ "name": "writeFocusShortcuts",
230624
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
230625
+ }
230626
+ ],
230627
+ "tags": {},
230628
+ "type": {
230629
+ "kind": "function",
230630
+ "parameters": [
230631
+ {
230632
+ "kind": "parameter",
230633
+ "name": "focus",
230634
+ "type": {
230635
+ "kind": "union",
230636
+ "value": [
230637
+ {
230638
+ "kind": "union",
230639
+ "value": [
230640
+ {
230641
+ "kind": "object",
230642
+ "properties": [
230643
+ {
230644
+ "kind": "property",
230645
+ "name": "primary",
230646
+ "required": false,
230647
+ "type": {
230648
+ "kind": "union",
230649
+ "value": [
230650
+ {
230651
+ "kind": "primitive",
230652
+ "value": "string"
230653
+ },
230654
+ {
230655
+ "kind": "primitive",
230656
+ "value": "undefined"
230657
+ }
230658
+ ]
230659
+ },
230660
+ "description": "",
230661
+ "tags": {},
230662
+ "declarations": []
230663
+ }
230664
+ ]
230665
+ },
230666
+ {
230667
+ "kind": "primitive",
230668
+ "value": "undefined"
230669
+ }
230670
+ ]
230671
+ },
230672
+ {
230673
+ "kind": "primitive",
230674
+ "value": "undefined"
230675
+ }
230676
+ ]
230677
+ },
230678
+ "required": false,
230679
+ "rest": false,
230680
+ "description": "",
230681
+ "declarations": [
230682
+ {
230683
+ "name": "focus",
230684
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
230685
+ }
230686
+ ],
230687
+ "tags": {}
230688
+ },
230689
+ {
230690
+ "kind": "parameter",
230691
+ "name": "style",
230692
+ "type": {
230693
+ "kind": "symbol",
230694
+ "name": "React.CSSProperties",
230695
+ "value": "CSSProperties"
230696
+ },
230697
+ "required": true,
230698
+ "rest": false,
230699
+ "description": "",
230700
+ "declarations": [
230701
+ {
230702
+ "name": "style",
230703
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
230704
+ }
230705
+ ],
230706
+ "tags": {}
230707
+ }
230708
+ ],
230709
+ "members": [],
230710
+ "returnType": {
230711
+ "kind": "primitive",
230712
+ "value": "void"
230713
+ }
230714
+ }
230715
+ },
230717
230716
  {
230718
230717
  "name": "writeIndependentBrandTokens",
230719
230718
  "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
230720
- "description": "Writes focus/border from explicit common or brand.primary.500 input never from primary.main.",
230719
+ "description": "Writes focus/border from explicit input — never from primary.main or primary.500.\nNumerical themes use {@link writeFocusShortcuts }; legacy uses `common.focusOutline`.",
230721
230720
  "declarations": [
230722
230721
  {
230723
230722
  "name": "writeIndependentBrandTokens",
@@ -233018,7 +233017,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
233018
233017
  {
233019
233018
  "name": "CanvasBrandRamp",
233020
233019
  "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
233021
- "description": "Numerical brand ramp keys. Each key maps 1:1 to a `--cnvs-brand-{family}-{key}` CSS variable.\n\nCommon keys:\n- `'600'` — main accent / button fill / default brand fg\n- `'700'` — strong fg / selected text (when not using `selected.fg`)\n- `'500'` — focus rings and border primary (independent of `'600'`)\n- `'A50'` — selected surface tint (when not using `selected.surface`)\n- `'25'` / `'A25'` — subtle brand surfaces\n\nNeutral-only Sana steps (`'150'`, `'850'`, `'A150'`) live on {@link CanvasNeutralBrandRamp }.",
233020
+ "description": "Numerical brand ramp keys. Each key maps 1:1 to a `--cnvs-brand-{family}-{key}` CSS variable.\n\nCommon keys:\n- `'600'` — main accent / button fill / default brand fg\n- `'700'` — strong fg / selected text (when not using `selected.fg`)\n- `'500'` — mid primary ramp (does **not** set focus — use {@link CanvasNumericalBrandTheme.focus })\n- `'A50'` — selected surface tint (when not using `selected.surface`)\n- `'25'` / `'A25'` — subtle brand surfaces\n\nNeutral-only Sana steps (`'150'`, `'850'`, `'A150'`) live on {@link CanvasNeutralBrandRamp }.",
233022
233021
  "declarations": [
233023
233022
  {
233024
233023
  "name": "CanvasBrandRamp",
@@ -233294,7 +233293,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
233294
233293
  }
233295
233294
  ],
233296
233295
  "tags": {
233297
- "example": "Minimal — brand buttons + selected states only\n```tsx\n<CanvasProvider theme={{brand: {primary: {'600': base.magenta600}}}} />\n```\nExplicit — focus independent of primary\n```tsx\n<CanvasProvider theme={{\nbrand: {primary: {'600': base.red600, '500': base.blue500}},\nselected: {fg: base.red700, surface: base.redA50},\n}} />\n```",
233296
+ "example": "Minimal — brand buttons + selected states only\n```tsx\n<CanvasProvider theme={{brand: {primary: {'600': base.magenta600}}}} />\n```\nExplicit — focus independent of primary\n```tsx\n<CanvasProvider theme={{\nbrand: {primary: {'600': base.red600}},\nselected: {fg: base.red700, surface: base.redA50},\nfocus: {primary: base.blue500},\n}} />\n```",
233298
233297
  "see": "sanaCanvasProviderTheme\n \nwhen `<html>` is unavailable and popups need Sana brand forwarding"
233299
233298
  },
233300
233299
  "type": {
@@ -233316,7 +233315,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
233316
233315
  "name": "CanvasBrandRamp",
233317
233316
  "value": "Partial<Record<\"25\" | \"50\" | \"100\" | \"200\" | \"300\" | \"400\" | \"500\" | \"600\" | \"700\" | \"800\" | \"900\" | \"950\" | \"975\" | \"A25\" | \"A50\" | \"A100\" | \"A200\", string>>"
233318
233317
  },
233319
- "description": "Primary brand ramp (`--cnvs-brand-primary-*`).\n\n**Shortcut (brand scope only):** when `'600'` is the only key under `primary`,\nalso sets:\n- `PrimaryButton` — `brand.action.base`, `accent.primary`, `accent.action`\n- Selected `Menu.Item` — `system.color.brand.fg.selected`, `surface.selected`\n\nDoes **not** set focus rings — use `'500'` or `canvas.palette.common.focusOutline`.\n\n| Key | CSS variable | Typical consumers |\n|-----|--------------|-------------------|\n| `'600'` | `--cnvs-brand-primary-600` | PrimaryButton, brand links, accent.primary |\n| `'700'` | `--cnvs-brand-primary-700` | Strong primary fg, selected text |\n| `'500'` | `--cnvs-brand-primary-500` | Focus rings, border primary |\n| `'A50'` | `--cnvs-brand-primary-A50` | Selected/hover surfaces |",
233318
+ "description": "Primary brand ramp (`--cnvs-brand-primary-*`).\n\n**Shortcut (brand scope only):** when `'600'` is the only key under `primary`,\nalso sets:\n- `PrimaryButton` — `brand.action.base`, `accent.primary`, `accent.action`\n- Selected `Menu.Item` — `system.color.brand.fg.selected`, `surface.selected`\n\nDoes **not** set focus rings — use {@link CanvasNumericalBrandTheme.focus }\nor legacy `canvas.palette.common.focusOutline`.\n\n| Key | CSS variable | Typical consumers |\n|-----|--------------|-------------------|\n| `'600'` | `--cnvs-brand-primary-600` | PrimaryButton, brand links, accent.primary |\n| `'700'` | `--cnvs-brand-primary-700` | Strong primary fg, selected text |\n| `'500'` | `--cnvs-brand-primary-500` | Mid primary ramp only (not focus) |\n| `'A50'` | `--cnvs-brand-primary-A50` | Selected/hover surfaces |",
233320
233319
  "declarations": [
233321
233320
  {
233322
233321
  "name": "primary",
@@ -233478,6 +233477,41 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
233478
233477
  ],
233479
233478
  "tags": {}
233480
233479
  },
233480
+ {
233481
+ "kind": "property",
233482
+ "name": "focus",
233483
+ "required": false,
233484
+ "type": {
233485
+ "kind": "object",
233486
+ "properties": [
233487
+ {
233488
+ "kind": "property",
233489
+ "name": "primary",
233490
+ "required": false,
233491
+ "type": {
233492
+ "kind": "primitive",
233493
+ "value": "string"
233494
+ },
233495
+ "description": "Focus ring and primary border color",
233496
+ "declarations": [
233497
+ {
233498
+ "name": "primary",
233499
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
233500
+ }
233501
+ ],
233502
+ "tags": {}
233503
+ }
233504
+ ]
233505
+ },
233506
+ "description": "Focus-ring shortcuts. Independent of `brand.primary` — matches tokens where\n`--cnvs-sys-color-brand-focus-primary` is not derived from primary brand.\n\n| Key | CSS variable | Typical consumers |\n|-----|--------------|-------------------|\n| `primary` | `--cnvs-sys-color-brand-focus-primary` (+ border primary) | Menu, Button, input focus rings |",
233507
+ "declarations": [
233508
+ {
233509
+ "name": "focus",
233510
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
233511
+ }
233512
+ ],
233513
+ "tags": {}
233514
+ },
233481
233515
  {
233482
233516
  "kind": "property",
233483
233517
  "name": "system",
@@ -18,11 +18,11 @@ export const packageJSONFile = `{
18
18
  "@emotion/react": "11.11.4",
19
19
  "@types/react": "18.2.60",
20
20
  "@types/react-dom": "18.2.19",
21
- "@workday/canvas-kit-labs-react": "16.0.0",
22
- "@workday/canvas-kit-preview-react": "16.0.0",
23
- "@workday/canvas-kit-react": "16.0.0",
24
- "@workday/canvas-kit-react-fonts": "^16.0.0",
25
- "@workday/canvas-kit-styling": "16.0.0",
21
+ "@workday/canvas-kit-labs-react": "16.0.2",
22
+ "@workday/canvas-kit-preview-react": "16.0.2",
23
+ "@workday/canvas-kit-react": "16.0.2",
24
+ "@workday/canvas-kit-react-fonts": "^16.0.2",
25
+ "@workday/canvas-kit-styling": "16.0.2",
26
26
  "@workday/canvas-system-icons-web": "^5.0.3",
27
27
  "@workday/canvas-expressive-icons-web": "1.0.1",
28
28
  "@workday/canvas-tokens-web": "4.4.0-beta.11"
@@ -19,11 +19,11 @@ export const packageJSONFile = `{
19
19
  "@emotion/react": "11.11.4",
20
20
  "@types/react": "18.2.60",
21
21
  "@types/react-dom": "18.2.19",
22
- "@workday/canvas-kit-labs-react": "16.0.0",
23
- "@workday/canvas-kit-preview-react": "16.0.0",
24
- "@workday/canvas-kit-react": "16.0.0",
25
- "@workday/canvas-kit-react-fonts": "^16.0.0",
26
- "@workday/canvas-kit-styling": "16.0.0",
22
+ "@workday/canvas-kit-labs-react": "16.0.2",
23
+ "@workday/canvas-kit-preview-react": "16.0.2",
24
+ "@workday/canvas-kit-react": "16.0.2",
25
+ "@workday/canvas-kit-react-fonts": "^16.0.2",
26
+ "@workday/canvas-kit-styling": "16.0.2",
27
27
  "@workday/canvas-system-icons-web": "^5.0.3",
28
28
  "@workday/canvas-expressive-icons-web": "1.0.1",
29
29
  "@workday/canvas-tokens-web": "4.4.0-beta.11"
@@ -14,6 +14,22 @@ The Sana Canvas **theme** (CSS variables + `data-theme="sana-canvas"`) is a sepa
14
14
  that updates brand colors, neutrals, surfaces, and shapes at the application level. See
15
15
  [Sana Canvas Theme](#sana-canvas-theme) below.
16
16
 
17
+ ### What You Need
18
+ - Canvas Tokens v4.4.0: Introduces the new Sana Canvas variables.
19
+ - Canvas System Icons v5.0.0: Introduces the new Sana Canvas icons.
20
+ - Canvas Kit v16: The new version of Canvas Kit that includes the new Sana Canvas components and utilities.
21
+
22
+ > **Note:** Canvas Tokens and Canvas System Icons are not included in the Canvas Kit package. Install
23
+ > them separately, then upgrade Canvas Kit itself:
24
+
25
+ ```sh
26
+ # Separate packages required by Canvas Kit v16
27
+ yarn add @workday/canvas-tokens-web@4.4.0 @workday/canvas-system-icons-web@5.0.0
28
+
29
+ # Upgrade Canvas Kit packages (adjust package names to what your app uses)
30
+ yarn add @workday/canvas-kit-react@^16
31
+ ```
32
+
17
33
 
18
34
  ## Sana Canvas Theme
19
35
 
@@ -160,6 +176,9 @@ remove the theme prop.
160
176
  - [Codemod](#codemod)
161
177
  - [Instructions](#instructions)
162
178
  - [Codemod Transformations for Icons](#codemod-transformations-for-icons)
179
+ - [MCP](#mcp)
180
+ - [Icon migration — `get-canvas-kit-icon-migration`](#icon-migration--get-canvas-kit-icon-migration)
181
+ - [Token references — `get-canvas-kit-tokens`](#token-references--get-canvas-kit-tokens)
163
182
  - [New Components](#new-components)
164
183
  - [KBD](#kbd)
165
184
  - [Tabs](#tabs)
@@ -207,6 +226,8 @@ remove the theme prop.
207
226
  - [New Utilities](#new-utilities)
208
227
  - [cornerShapeStencil](#cornershapestencil)
209
228
  - [Fonts](#fonts)
229
+ - [Sana Canvas Theme — Switch to Sana Sans](#sana-canvas-theme--switch-to-sana-sans)
230
+ - [Classic Canvas — Keep Roboto](#classic-canvas--keep-roboto)
210
231
  - [Deprecations](#deprecations)
211
232
  - [Glossary](#glossary)
212
233
  - [Main](#main)
@@ -381,6 +402,34 @@ import {Tabs} from '@workday/canvas-kit-preview-react/tabs';
381
402
  </Tabs>;
382
403
  ```
383
404
 
405
+ ## MCP
406
+
407
+ Canvas Kit's MCP server (`@workday/canvas-kit-mcp`) helps agents migrate icons and look up tokens for
408
+ v16 / tokens `4.4.0`.
409
+
410
+ ### Icon migration — `get-canvas-kit-icon-migration`
411
+
412
+ Use this tool when upgrading `@workday/canvas-system-icons-web` to v5 (Sana Canvas Assets), finding
413
+ replacements for deprecated icons, or running the `icon-migration` codemod.
414
+
415
+ 1. Install / enable the Canvas Kit MCP server (see the
416
+ [MCP docs](/docs/ai-for-llms-mcp-docs--docs)).
417
+ 2. Ask your agent to call `get-canvas-kit-icon-migration`.
418
+ 3. Follow the returned guides:
419
+ - [Sana Canvas Assets overview](/docs/guides-icon-migration-sana-canvas-assets-overview--docs)
420
+ (full deprecated → replacement table)
421
+ - [Icon Migration codemod](/docs/guides-icon-migration-codemod--docs)
422
+
423
+ ```sh
424
+ npx @workday/canvas-kit-codemod icon-migration [path]
425
+ ```
426
+
427
+ ### Token references — `get-canvas-kit-tokens`
428
+
429
+ Token docs were updated for `@workday/canvas-tokens-web` `4.4.0`. Call `get-canvas-kit-tokens` and
430
+ start with the v4.4 token reference served by the MCP (`docs://tokens/v4/v4.4-token-reference`) for
431
+ the current token surface (Sana Canvas, t-shirt scales, deprecations).
432
+
384
433
  ## Component Updates
385
434
 
386
435
  ### Action Bar
@@ -1163,6 +1212,65 @@ export const myStencil = createStencil({
1163
1212
  `Card`, `Expandable` (`Expandable.Target`), `Menu` (`Menu.Card`, `Menu.List`, `Menu.Item`),
1164
1213
  `MultiSelect`, and `Table` (`BaseTable`, `Table`) extend this stencil for their rounded corners.
1165
1214
 
1215
+ ## Fonts
1216
+
1217
+ Canvas Kit does not bundle fonts. In v16, which font you load depends on whether you opt into the
1218
+ [Sana Canvas theme](#sana-canvas-theme).
1219
+
1220
+ | Theme | Typeface | Package |
1221
+ | ----- | -------- | ------- |
1222
+ | Sana Canvas (`data-theme="sana-canvas"`) | Sana Sans (+ IBM Plex Mono) | `@workday/canvas-kit-react/fonts` |
1223
+ | Classic Canvas (default) | Roboto (+ Roboto Mono) | `@workday/canvas-kit-react-fonts` |
1224
+
1225
+ ### Sana Canvas Theme — Switch to Sana Sans
1226
+
1227
+ When you opt into Sana, `--cnvs-sys-font-family-default` (`system.fontFamily.default`) points at
1228
+ `'Sana Sans VF'`. Load the matching `@font-face` rules from the new fonts module (requires
1229
+ `@workday/canvas-tokens-web` `4.4.0` or later):
1230
+
1231
+ ```ts
1232
+ import {fonts} from '@workday/canvas-kit-react/fonts';
1233
+ import {injectGlobal} from '@workday/canvas-kit-styling';
1234
+ import {system} from '@workday/canvas-tokens-web';
1235
+
1236
+ injectGlobal({
1237
+ ...fonts,
1238
+ 'html, body': {
1239
+ fontFamily: system.fontFamily.default,
1240
+ margin: 0,
1241
+ minHeight: '100vh',
1242
+ },
1243
+ });
1244
+ ```
1245
+
1246
+ If your environment already provides Sana Sans, you can skip injecting `@font-face` and keep using
1247
+ `system.fontFamily.default`.
1248
+
1249
+ > **Note:** Prefer `@workday/canvas-kit-react/fonts` over `@workday/canvas-kit-react-fonts` when the
1250
+ > Sana Canvas theme is enabled. The older package still loads Roboto and will not match the Sana
1251
+ > font-family token.
1252
+
1253
+ ### Classic Canvas — Keep Roboto
1254
+
1255
+ If you are **not** setting `data-theme="sana-canvas"`, continue using
1256
+ `@workday/canvas-kit-react-fonts` as before:
1257
+
1258
+ ```ts
1259
+ import {fonts} from '@workday/canvas-kit-react-fonts';
1260
+ import {injectGlobal} from '@workday/canvas-kit-styling';
1261
+ import {system} from '@workday/canvas-tokens-web';
1262
+
1263
+ injectGlobal({
1264
+ ...fonts,
1265
+ 'html, body': {
1266
+ fontFamily: system.fontFamily.default,
1267
+ },
1268
+ });
1269
+ ```
1270
+
1271
+ For full installation details, variable-font notes, and monospace coverage, see the
1272
+ [Fonts guide](https://workday.github.io/canvas-kit/?path=/docs/guides-fonts--docs).
1273
+
1166
1274
  ## Deprecations
1167
1275
 
1168
1276
  We add the [@deprecated](https://jsdoc.app/tags-deprecated.html) JSDoc tag to code we plan to remove
@@ -61,7 +61,7 @@ supports multiple font weights and styles. It also provides more flexibility and
61
61
  traditional, static fonts. But you should be able to use it identically to how you've been using
62
62
  other fonts.
63
63
 
64
- - **Family**: Sana Sans
64
+ - **Family**: Sana Sans VF
65
65
  - **Format**: TrueType variable font
66
66
  - **Weight range**: 100–700 (Regular through Bold)
67
67
  - **Styles**: normal, italic
@@ -78,7 +78,7 @@ variable.
78
78
  | You set | Components affected |
79
79
  | ------- | ------------------- |
80
80
  | `brand.primary['600']` alone | `PrimaryButton`, selected `Menu.Item` (text + background) |
81
- | `brand.primary['500']` | Focus rings, border primary (independent of `600`) |
81
+ | `focus.primary` | Focus rings, border primary (independent of primary brand) |
82
82
  | `brand.action.*` | `PrimaryButton` (read before `brand.primary`) |
83
83
  | `brand.critical.*` | `TextInput` error, critical accents |
84
84
  | `brand.caution.*` | `TextInput` caution, caution focus |
@@ -87,7 +87,7 @@ variable.
87
87
  | `selected.fg` / `selected.surface` | Selected list/menu states directly |
88
88
 
89
89
  **Focus does not follow primary.** Setting only `brand.primary['600']` leaves focus rings at the
90
- default blue unless you also set `brand.primary['500']`.
90
+ default blue unless you also set `focus.primary`.
91
91
 
92
92
  ```tsx
93
93
  import {CanvasProvider} from '@workday/canvas-kit-react/common';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@workday/canvas-kit-docs",
3
- "version": "16.0.0",
3
+ "version": "16.0.2",
4
4
  "description": "Documentation components of Canvas Kit components",
5
5
  "author": "Workday, Inc. (https://www.workday.com)",
6
6
  "license": "Apache-2.0",
@@ -47,10 +47,10 @@
47
47
  "@stackblitz/sdk": "^1.11.0",
48
48
  "@storybook/csf": "0.0.1",
49
49
  "@workday/canvas-expressive-icons-web": "1.0.2",
50
- "@workday/canvas-kit-labs-react": "^16.0.0",
51
- "@workday/canvas-kit-preview-react": "^16.0.0",
52
- "@workday/canvas-kit-react": "^16.0.0",
53
- "@workday/canvas-kit-styling": "^16.0.0",
50
+ "@workday/canvas-kit-labs-react": "^16.0.2",
51
+ "@workday/canvas-kit-preview-react": "^16.0.2",
52
+ "@workday/canvas-kit-react": "^16.0.2",
53
+ "@workday/canvas-kit-styling": "^16.0.2",
54
54
  "@workday/canvas-system-icons-web": "^5.0.3",
55
55
  "@workday/canvas-tokens-web": "^4.4.0",
56
56
  "markdown-to-jsx": "^7.2.0",
@@ -63,5 +63,5 @@
63
63
  "mkdirp": "^1.0.3",
64
64
  "typescript": "5.0"
65
65
  },
66
- "gitHead": "3f3f7e9a3251cf61ffb40f93dba3dd50d9f3e3cf"
66
+ "gitHead": "72c62cffaadb20c6881fc9bb59365db3034186fd"
67
67
  }