@workday/canvas-kit-docs 16.0.0-alpha.0478-next.0 → 16.0.0-alpha.0483-next.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.
@@ -127743,22 +127743,50 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
127743
127743
  },
127744
127744
  {
127745
127745
  "kind": "string",
127746
- "value": "standalone"
127746
+ "value": "secondary"
127747
+ }
127748
+ ]
127749
+ },
127750
+ "description": "Sets color styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes. Use this\n variant on dark backgrounds.\n- `secondary`: sets the color to a dark gray (keeps the underline by default). Use this\n variant on colored backgrounds.",
127751
+ "declarations": [
127752
+ {
127753
+ "name": "variant",
127754
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
127755
+ }
127756
+ ],
127757
+ "tags": {}
127758
+ },
127759
+ {
127760
+ "kind": "property",
127761
+ "name": "linkType",
127762
+ "required": false,
127763
+ "type": {
127764
+ "kind": "union",
127765
+ "value": [
127766
+ {
127767
+ "kind": "string",
127768
+ "value": "inline"
127747
127769
  },
127748
127770
  {
127749
127771
  "kind": "string",
127750
- "value": "standaloneInverse"
127772
+ "value": "standalone"
127751
127773
  }
127752
127774
  ]
127753
127775
  },
127754
- "description": "sets modifier styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes\n- `standalone`: removes the underline of the Hyperlink. This is useful when a hyperlink is used outside the context of a paragraph or body text.\n- `standaloneInverse`: removes the underline of the Hyperlink and sets the color to white. This is useful when a hyperlink is used outside the context of a paragraph or body text on a dark background.",
127776
+ "description": "Sets underline behavior for Hyperlink\n- `inline` (default): keeps the underline. Use when the hyperlink appears in body text.\n- `standalone`: removes the underline. Use when a hyperlink is outside paragraph or body text.",
127755
127777
  "declarations": [
127756
127778
  {
127757
- "name": "variant",
127779
+ "name": "linkType",
127758
127780
  "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
127759
127781
  }
127760
127782
  ],
127761
- "tags": {}
127783
+ "tags": {
127784
+ "default": "'inline'"
127785
+ },
127786
+ "defaultValue": {
127787
+ "kind": "string",
127788
+ "value": "inline"
127789
+ }
127762
127790
  },
127763
127791
  {
127764
127792
  "kind": "property",
@@ -148805,7 +148833,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
148805
148833
  {
148806
148834
  "name": "ExternalHyperlink",
148807
148835
  "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/ExternalHyperlink.tsx",
148808
- "description": "`ExternalHyperlink`s also have an `inverse` variant. Use this variant when you need to place the\nlink on a dark or colorful background such as `system.color.accent.info`.",
148836
+ "description": "`ExternalHyperlink`s also have an `inverse` variant. Use this variant when you need to place the\nlink on a dark background such as `system.color.accent.info`.",
148809
148837
  "declarations": [
148810
148838
  {
148811
148839
  "name": "ExternalHyperlink",
@@ -148848,22 +148876,50 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
148848
148876
  },
148849
148877
  {
148850
148878
  "kind": "string",
148851
- "value": "standalone"
148879
+ "value": "secondary"
148880
+ }
148881
+ ]
148882
+ },
148883
+ "description": "Sets color styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes. Use this\n variant on dark backgrounds.\n- `secondary`: sets the color to a dark gray (keeps the underline by default). Use this\n variant on colored backgrounds.",
148884
+ "declarations": [
148885
+ {
148886
+ "name": "variant",
148887
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
148888
+ }
148889
+ ],
148890
+ "tags": {}
148891
+ },
148892
+ {
148893
+ "kind": "property",
148894
+ "name": "linkType",
148895
+ "required": false,
148896
+ "type": {
148897
+ "kind": "union",
148898
+ "value": [
148899
+ {
148900
+ "kind": "string",
148901
+ "value": "inline"
148852
148902
  },
148853
148903
  {
148854
148904
  "kind": "string",
148855
- "value": "standaloneInverse"
148905
+ "value": "standalone"
148856
148906
  }
148857
148907
  ]
148858
148908
  },
148859
- "description": "sets modifier styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes\n- `standalone`: removes the underline of the Hyperlink. This is useful when a hyperlink is used outside the context of a paragraph or body text.\n- `standaloneInverse`: removes the underline of the Hyperlink and sets the color to white. This is useful when a hyperlink is used outside the context of a paragraph or body text on a dark background.",
148909
+ "description": "Sets underline behavior for Hyperlink\n- `inline` (default): keeps the underline. Use when the hyperlink appears in body text.\n- `standalone`: removes the underline. Use when a hyperlink is outside paragraph or body text.",
148860
148910
  "declarations": [
148861
148911
  {
148862
- "name": "variant",
148912
+ "name": "linkType",
148863
148913
  "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
148864
148914
  }
148865
148915
  ],
148866
- "tags": {}
148916
+ "tags": {
148917
+ "default": "'inline'"
148918
+ },
148919
+ "defaultValue": {
148920
+ "kind": "string",
148921
+ "value": "inline"
148922
+ }
148867
148923
  },
148868
148924
  {
148869
148925
  "kind": "property",
@@ -148873,7 +148929,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
148873
148929
  "kind": "primitive",
148874
148930
  "value": "string"
148875
148931
  },
148876
- "description": "attribute for the hyperlink URL",
148932
+ "description": "Attribute for the hyperlink URL",
148877
148933
  "declarations": [
148878
148934
  {
148879
148935
  "name": "href",
@@ -149716,22 +149772,50 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
149716
149772
  },
149717
149773
  {
149718
149774
  "kind": "string",
149719
- "value": "standalone"
149775
+ "value": "secondary"
149776
+ }
149777
+ ]
149778
+ },
149779
+ "description": "Sets color styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes. Use this\n variant on dark backgrounds.\n- `secondary`: sets the color to a dark gray (keeps the underline by default). Use this\n variant on colored backgrounds.",
149780
+ "declarations": [
149781
+ {
149782
+ "name": "variant",
149783
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
149784
+ }
149785
+ ],
149786
+ "tags": {}
149787
+ },
149788
+ {
149789
+ "kind": "property",
149790
+ "name": "linkType",
149791
+ "required": false,
149792
+ "type": {
149793
+ "kind": "union",
149794
+ "value": [
149795
+ {
149796
+ "kind": "string",
149797
+ "value": "inline"
149720
149798
  },
149721
149799
  {
149722
149800
  "kind": "string",
149723
- "value": "standaloneInverse"
149801
+ "value": "standalone"
149724
149802
  }
149725
149803
  ]
149726
149804
  },
149727
- "description": "sets modifier styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes\n- `standalone`: removes the underline of the Hyperlink. This is useful when a hyperlink is used outside the context of a paragraph or body text.\n- `standaloneInverse`: removes the underline of the Hyperlink and sets the color to white. This is useful when a hyperlink is used outside the context of a paragraph or body text on a dark background.",
149805
+ "description": "Sets underline behavior for Hyperlink\n- `inline` (default): keeps the underline. Use when the hyperlink appears in body text.\n- `standalone`: removes the underline. Use when a hyperlink is outside paragraph or body text.",
149728
149806
  "declarations": [
149729
149807
  {
149730
- "name": "variant",
149808
+ "name": "linkType",
149731
149809
  "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
149732
149810
  }
149733
149811
  ],
149734
- "tags": {}
149812
+ "tags": {
149813
+ "default": "'inline'"
149814
+ },
149815
+ "defaultValue": {
149816
+ "kind": "string",
149817
+ "value": "inline"
149818
+ }
149735
149819
  },
149736
149820
  {
149737
149821
  "kind": "property",
@@ -149741,7 +149825,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
149741
149825
  "kind": "primitive",
149742
149826
  "value": "string"
149743
149827
  },
149744
- "description": "attribute for the hyperlink URL",
149828
+ "description": "Attribute for the hyperlink URL",
149745
149829
  "declarations": [
149746
149830
  {
149747
149831
  "name": "href",
@@ -266088,22 +266172,50 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
266088
266172
  },
266089
266173
  {
266090
266174
  "kind": "string",
266091
- "value": "standalone"
266175
+ "value": "secondary"
266176
+ }
266177
+ ]
266178
+ },
266179
+ "description": "Sets color styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes. Use this\n variant on dark backgrounds.\n- `secondary`: sets the color to a dark gray (keeps the underline by default). Use this\n variant on colored backgrounds.",
266180
+ "declarations": [
266181
+ {
266182
+ "name": "variant",
266183
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
266184
+ }
266185
+ ],
266186
+ "tags": {}
266187
+ },
266188
+ {
266189
+ "kind": "property",
266190
+ "name": "linkType",
266191
+ "required": false,
266192
+ "type": {
266193
+ "kind": "union",
266194
+ "value": [
266195
+ {
266196
+ "kind": "string",
266197
+ "value": "inline"
266092
266198
  },
266093
266199
  {
266094
266200
  "kind": "string",
266095
- "value": "standaloneInverse"
266201
+ "value": "standalone"
266096
266202
  }
266097
266203
  ]
266098
266204
  },
266099
- "description": "sets modifier styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes\n- `standalone`: removes the underline of the Hyperlink. This is useful when a hyperlink is used outside the context of a paragraph or body text.\n- `standaloneInverse`: removes the underline of the Hyperlink and sets the color to white. This is useful when a hyperlink is used outside the context of a paragraph or body text on a dark background.",
266205
+ "description": "Sets underline behavior for Hyperlink\n- `inline` (default): keeps the underline. Use when the hyperlink appears in body text.\n- `standalone`: removes the underline. Use when a hyperlink is outside paragraph or body text.",
266100
266206
  "declarations": [
266101
266207
  {
266102
- "name": "variant",
266208
+ "name": "linkType",
266103
266209
  "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
266104
266210
  }
266105
266211
  ],
266106
- "tags": {}
266212
+ "tags": {
266213
+ "default": "'inline'"
266214
+ },
266215
+ "defaultValue": {
266216
+ "kind": "string",
266217
+ "value": "inline"
266218
+ }
266107
266219
  },
266108
266220
  {
266109
266221
  "kind": "property",
@@ -266113,7 +266225,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
266113
266225
  "kind": "primitive",
266114
266226
  "value": "string"
266115
266227
  },
266116
- "description": "attribute for the hyperlink URL",
266228
+ "description": "Attribute for the hyperlink URL",
266117
266229
  "declarations": [
266118
266230
  {
266119
266231
  "name": "href",
@@ -455697,22 +455809,50 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
455697
455809
  },
455698
455810
  {
455699
455811
  "kind": "string",
455700
- "value": "standalone"
455812
+ "value": "secondary"
455813
+ }
455814
+ ]
455815
+ },
455816
+ "description": "Sets color styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes. Use this\n variant on dark backgrounds.\n- `secondary`: sets the color to a dark gray (keeps the underline by default). Use this\n variant on colored backgrounds.",
455817
+ "declarations": [
455818
+ {
455819
+ "name": "variant",
455820
+ "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
455821
+ }
455822
+ ],
455823
+ "tags": {}
455824
+ },
455825
+ {
455826
+ "kind": "property",
455827
+ "name": "linkType",
455828
+ "required": false,
455829
+ "type": {
455830
+ "kind": "union",
455831
+ "value": [
455832
+ {
455833
+ "kind": "string",
455834
+ "value": "inline"
455701
455835
  },
455702
455836
  {
455703
455837
  "kind": "string",
455704
- "value": "standaloneInverse"
455838
+ "value": "standalone"
455705
455839
  }
455706
455840
  ]
455707
455841
  },
455708
- "description": "sets modifier styles for Hyperlink\n- `inverse`: sets the color to white and updates hover, focus, and active pseudo-classes\n- `standalone`: removes the underline of the Hyperlink. This is useful when a hyperlink is used outside the context of a paragraph or body text.\n- `standaloneInverse`: removes the underline of the Hyperlink and sets the color to white. This is useful when a hyperlink is used outside the context of a paragraph or body text on a dark background.",
455842
+ "description": "Sets underline behavior for Hyperlink\n- `inline` (default): keeps the underline. Use when the hyperlink appears in body text.\n- `standalone`: removes the underline. Use when a hyperlink is outside paragraph or body text.",
455709
455843
  "declarations": [
455710
455844
  {
455711
- "name": "variant",
455845
+ "name": "linkType",
455712
455846
  "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/button/lib/Hyperlink.tsx"
455713
455847
  }
455714
455848
  ],
455715
- "tags": {}
455849
+ "tags": {
455850
+ "default": "'inline'"
455851
+ },
455852
+ "defaultValue": {
455853
+ "kind": "string",
455854
+ "value": "inline"
455855
+ }
455716
455856
  },
455717
455857
  {
455718
455858
  "kind": "property",
@@ -455722,7 +455862,7 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
455722
455862
  "kind": "primitive",
455723
455863
  "value": "string"
455724
455864
  },
455725
- "description": "attribute for the hyperlink URL",
455865
+ "description": "Attribute for the hyperlink URL",
455726
455866
  "declarations": [
455727
455867
  {
455728
455868
  "name": "href",
@@ -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": "15.1.3",
22
- "@workday/canvas-kit-preview-react": "15.1.3",
23
- "@workday/canvas-kit-react": "15.1.3",
24
- "@workday/canvas-kit-react-fonts": "^15.1.3",
25
- "@workday/canvas-kit-styling": "15.1.3",
21
+ "@workday/canvas-kit-labs-react": "15.1.4",
22
+ "@workday/canvas-kit-preview-react": "15.1.4",
23
+ "@workday/canvas-kit-react": "15.1.4",
24
+ "@workday/canvas-kit-react-fonts": "^15.1.4",
25
+ "@workday/canvas-kit-styling": "15.1.4",
26
26
  "@workday/canvas-system-icons-web": "4.0.2",
27
27
  "@workday/canvas-expressive-icons-web": "1.0.1",
28
28
  "@workday/canvas-tokens-web": "4.2.0"
@@ -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": "15.1.3",
23
- "@workday/canvas-kit-preview-react": "15.1.3",
24
- "@workday/canvas-kit-react": "15.1.3",
25
- "@workday/canvas-kit-react-fonts": "^15.1.3",
26
- "@workday/canvas-kit-styling": "15.1.3",
22
+ "@workday/canvas-kit-labs-react": "15.1.4",
23
+ "@workday/canvas-kit-preview-react": "15.1.4",
24
+ "@workday/canvas-kit-react": "15.1.4",
25
+ "@workday/canvas-kit-react-fonts": "^15.1.4",
26
+ "@workday/canvas-kit-styling": "15.1.4",
27
27
  "@workday/canvas-system-icons-web": "4.0.2",
28
28
  "@workday/canvas-expressive-icons-web": "1.0.1",
29
29
  "@workday/canvas-tokens-web": "4.2.0"
@@ -37,10 +37,14 @@ Soon to be...
37
37
  - [MultiSelect](#multiselect)
38
38
  - [Menu](#menu)
39
39
  - [Modal](#modal)
40
+ - [Navigation Components](#navigation-components)
41
+ - [Hyperlink](#hyperlink)
42
+ - [Breadcrumbs](#breadcrumbs)
43
+ - [Pagination](#pagination)
40
44
  - [Popup](#popup)
41
45
  - [Segmented Control](#segmented-control)
42
- - [Toast](#toast)
43
- - [Tooltip](#tooltip)
46
+ - [Toast](#toast)
47
+ - [Tooltip](#tooltip)
44
48
  - [New Utilities](#new-utilities)
45
49
  - [cornerShapeStencil](#cornershapestencil)
46
50
  - [Deprecations](#deprecations)
@@ -409,50 +413,6 @@ No API changes. No migration is required unless you render a custom dropdown ind
409
413
  No API changes. No migration is required unless you render a custom dropdown indicator or override
410
414
  `multiSelectInputStencil` styles.
411
415
 
412
- ### Toast
413
-
414
- **PR:** [#4053](https://github.com/Workday/canvas-kit/pull/4053)
415
-
416
- #### Visual Updates
417
-
418
- - Padding is now applied to the `Toast` container itself instead of being distributed across
419
- `Toast.Body` and `Toast.Icon`.
420
- - Gap between the icon, body, and close icon is now `base.size150` (12px).
421
- - Shape uses `system.shape.xl`.
422
- - Box-shadow updated from `system.depth[3]` to `system.depth[5]`.
423
- - `Toast.Body` no longer has a gap between text and link.
424
- - `Toast.CloseIcon` is set to have absolute positioning and aligned with the top-right corner (in
425
- LTR).
426
- - `Toast.CloseIcon` was changed to be `extraSmall` tertiary button.
427
-
428
- ### Tooltip
429
-
430
- **PR:** [#4053](https://github.com/Workday/canvas-kit/pull/4053)
431
-
432
- #### Visual Updates
433
-
434
- - The default tooltip has been restyled from a dark surface to a light surface.
435
- - A visible border (`system.color.border.default`) is now applied to the container, replacing the
436
- previous transparent outline.
437
- - Tooltip boundaries remain visible in Windows High Contrast mode: when High Contrast is detected,
438
- Tooltip uses a solid outline (`outline: solid 1px CanvasText`) to ensure clear visibility.
439
- - Shape is now fully rounded using `system.shape.full`.
440
- - Box-shadow updated from `system.depth[2]` to `system.depth[3]`.
441
- - Type level is now `subtext.lg` (previously `subtext.md`).
442
- - Padding and spacing have been adjusted to accommodate the new styling.
443
-
444
- ### Modal
445
-
446
- #### Visual Updates
447
-
448
- - `Modal.Card` box-shadow updated from `system.depth[5]` to `system.depth[6]`.
449
-
450
- ### Popup
451
-
452
- #### Visual Updates
453
-
454
- - `Popup.Card` box-shadow updated from `system.depth[3]` to `system.depth[4]`.
455
-
456
416
  ### Menu
457
417
 
458
418
  **PR:** [#3987](https://github.com/Workday/canvas-kit/pull/3987)
@@ -511,35 +471,127 @@ selectable menus, see the
511
471
 
512
472
  ##### Menu.Item
513
473
 
514
- | State | v15 | v16 |
515
- | ------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------- |
516
- | Active/pressed | Not styled | `surface.overlay.pressed` background |
517
- | Focus | Solid blue fill (`brand.accent.primary`) and white text | Inset outline using `brand.border.primary` |
474
+ | State | v15 | v16 |
475
+ | ----------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
476
+ | Active/pressed | Not styled | `surface.overlay.pressed` background |
477
+ | Focus | Solid blue fill (`brand.accent.primary`) and white text | Inset outline using `brand.border.primary` |
518
478
  | Disabled + Focus (`aria-disabled="true"`) | Solid blue fill and white text with disabled opacity (dims focus style) | Light blue background and blue text (`brand.surface.selected` / `brand.fg.selected`) with disabled opacity (dims focus indicator) |
519
- | Expanded submenu parent + Focus | Same blue fill and white text focus style as other focused items | Focus ring removed; ancestor-trail styling shown instead (`Submenu.TargetItem`) |
479
+ | Expanded submenu parent + Focus | Same blue fill and white text focus style as other focused items | Focus ring removed; ancestor-trail styling shown instead (`Submenu.TargetItem`) |
520
480
 
521
481
  ##### Menu.Option
522
482
 
523
483
  Used in `Select`, `Combobox`, and other listbox menus. Selected states apply when
524
484
  `aria-selected="true"`.
525
485
 
526
- | State | v15 | v16 |
527
- | --------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
528
- | Active/pressed | Not styled | `surface.overlay.pressed` background |
529
- | Focus | Solid blue fill (`brand.accent.primary`) and white text | Inset outline using `brand.border.primary` |
530
- | Selected (`aria-selected="true"`) | Solid blue fill and white text (`brand.surface.primary.strong` / `brand.fg.primary.strong`) | Light blue background and blue text (`brand.surface.selected` / `brand.fg.selected`) |
531
- | Selected + Focus | Solid blue fill and white text | Inset outline with selected background preserved |
532
- | Disabled + Focus (`aria-disabled="true"`) | Solid blue fill and white text with disabled opacity (dims focus style) | Light blue background and blue text (`brand.surface.selected` / `brand.fg.selected`) with disabled opacity (dims focus indicator) |
533
- | Disabled + Selected | Solid blue fill and white text with disabled opacity | Light blue background and blue text (`brand.surface.selected` / `brand.fg.selected`) with disabled opacity |
486
+ | State | v15 | v16 |
487
+ | ----------------------------------------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
488
+ | Active/pressed | Not styled | `surface.overlay.pressed` background |
489
+ | Focus | Solid blue fill (`brand.accent.primary`) and white text | Inset outline using `brand.border.primary` |
490
+ | Selected (`aria-selected="true"`) | Solid blue fill and white text (`brand.surface.primary.strong` / `brand.fg.primary.strong`) | Light blue background and blue text (`brand.surface.selected` / `brand.fg.selected`) |
491
+ | Selected + Focus | Solid blue fill and white text | Inset outline with selected background preserved |
492
+ | Disabled + Focus (`aria-disabled="true"`) | Solid blue fill and white text with disabled opacity (dims focus style) | Light blue background and blue text (`brand.surface.selected` / `brand.fg.selected`) with disabled opacity (dims focus indicator) |
493
+ | Disabled + Selected | Solid blue fill and white text with disabled opacity | Light blue background and blue text (`brand.surface.selected` / `brand.fg.selected`) with disabled opacity |
494
+
495
+ ### Modal
496
+
497
+ #### Visual Updates
498
+
499
+ - `Modal.Card` box-shadow updated from `system.depth[5]` to `system.depth[6]`.
500
+
501
+ ### Navigation Components
502
+
503
+ #### Hyperlink
504
+
505
+ ##### Visual Updates
506
+
507
+ - Default link color uses new link tokens (`system.color.fg.link.default` / `.hover`). Hover and
508
+ active text is now the darker link-hover blue.
509
+ - Hover and active backgrounds use surface overlay tokens instead of `surface.alt`.
510
+
511
+ ##### New Secondary Variant and `linkType` Prop
512
+
513
+ A new "secondary" variant and `linkType` prop have been added to `Hyperlink` and
514
+ `ExternalHyperlink`. Color and underline are now controlled by separate props:
515
+
516
+ | Need | API |
517
+ | -------------------------- | --------------------------------------------- |
518
+ | Blue, underlined (default) | _(no props)_ |
519
+ | Blue, no underline | `linkType="standalone"` |
520
+ | Inverse, underlined | `variant="inverse"` |
521
+ | Inverse, no underline | `variant="inverse"` `linkType="standalone"` |
522
+ | Dark gray, underlined | `variant="secondary"` |
523
+ | Dark gray, no underline | `variant="secondary"` `linkType="standalone"` |
524
+
525
+ `variant` is now either 'inverse' or 'secondary'. Underline is controlled by `linkType` which is
526
+ either 'inline' or 'standalone', defaulting to 'inline'. The compound variants `standalone` and
527
+ `standaloneInverse` are **removed**.
528
+
529
+ ```tsx
530
+ import {ExternalHyperlink, Hyperlink} from '@workday/canvas-kit-react/button';
531
+
532
+ <Hyperlink variant="secondary" href="#secondary-hyperlink">
533
+ Secondary Hyperlink
534
+ </Hyperlink>
535
+ <Hyperlink linkType="standalone" href="#standalone-hyperlink">
536
+ Standalone Hyperlink
537
+ </Hyperlink>
538
+ <ExternalHyperlink
539
+ variant="secondary"
540
+ linkType="standalone"
541
+ href="#secondary-standalone-external-hyperlink"
542
+ iconLabel="Opens new window"
543
+ >
544
+ Secondary Standalone External Hyperlink
545
+ </ExternalHyperlink>
546
+ ```
547
+
548
+ ###### Breaking Change Migration
549
+
550
+ Run the Canvas Kit v16 codemod (`updateHyperlinkProps`) to migrate automatically:
551
+
552
+ | Before | After |
553
+ | ----------------------------- | ------------------------------------------- |
554
+ | `variant="standalone"` | `linkType="standalone"` |
555
+ | `variant="standaloneInverse"` | `variant="inverse"` `linkType="standalone"` |
556
+
557
+ #### Breadcrumbs
558
+
559
+ ##### Visual Updates
560
+
561
+ - Trail links (`Breadcrumbs.Link`) use Hyperlink `variant="secondary"` and `linkType="standalone"`.
562
+ Trail text uses `system.color.fg.default`; hover and active states use surface overlay tokens with
563
+ underline on hover.
564
+ - The current item (`Breadcrumbs.CurrentItem`) uses `system.color.fg.muted.default`.
565
+ - Overflow and separator chevrons use muted/strong foreground colors with
566
+ `component.legacy.systemIcon.size.md`.
567
+
568
+ #### Pagination
569
+
570
+ ##### Visual Updates
571
+
572
+ - Page buttons use overlay hover/pressed backgrounds and a focus ring (aligned with the
573
+ TertiaryButton pattern). The current page uses `system.color.brand.accent.primary` with inverse
574
+ label text.
575
+ - Control chevrons (previous/next and jump controls) are sized to 16px via
576
+ `component.legacy.systemIcon.size.xs`.
577
+ - GoTo label uses `size="large"` (14px). GoTo input text is centered; border radius inherits from
578
+ TextInput `shape.lg` (12px).
579
+ - GoToForm spacing uses `marginInlineStart: gap.xs` alongside Controls `gap.xs`.
580
+
581
+ ### Popup
582
+
583
+ #### Visual Updates
584
+
585
+ - `Popup.Card` box-shadow updated from `system.depth[3]` to `system.depth[4]`.
534
586
 
535
587
  ### Segmented Control
536
588
 
537
589
  **PR:** [#4048](https://github.com/Workday/canvas-kit/pull/4048)
538
590
 
539
-
540
591
  #### Visual Updates
541
592
 
542
- - Container background changed from `surface.alt.strong` to `surface.alt.default` (a lighter background color).
593
+ - Container background changed from `surface.alt.strong` to `surface.alt.default` (a lighter
594
+ background color).
543
595
  - Border radius changed to `shape.full` (full rounded corners) on the container.
544
596
  - Grid gap reduced from `gap.sm` (8px) to `gap.xs` (4px).
545
597
  - Selected/pressed item now uses boxShadow: system.depth[2] instead of a visible border.
@@ -547,10 +599,43 @@ Used in `Select`, `Combobox`, and other listbox menus. Selected states apply whe
547
599
  - Medium size now uses semi-bold font weight.
548
600
  - Size adjustments: large height shrunk to size.sm (32px) (was size.md (40px));
549
601
  - Medium size is now 28px in height (was 32px).
550
- - Hover and pressed states now use `surface.overlay.hover.default` and `surface.overlay.pressed.default` respectively for the item.
602
+ - Hover and pressed states now use `surface.overlay.hover.default` and
603
+ `surface.overlay.pressed.default` respectively for the item.
551
604
  - Container padding changed to `padding.md` (16px) including for mobile devices.
552
605
  - On mobile devices, the container padding remains `padding.md` (16px).
553
606
 
607
+ ### Toast
608
+
609
+ **PR:** [#4053](https://github.com/Workday/canvas-kit/pull/4053)
610
+
611
+ #### Visual Updates
612
+
613
+ - Padding is now applied to the `Toast` container itself instead of being distributed across
614
+ `Toast.Body` and `Toast.Icon`.
615
+ - Gap between the icon, body, and close icon is now `base.size150` (12px).
616
+ - Shape uses `system.shape.xl`.
617
+ - Box-shadow updated from `system.depth[3]` to `system.depth[5]`.
618
+ - `Toast.Body` no longer has a gap between text and link.
619
+ - `Toast.CloseIcon` is set to have absolute positioning and aligned with the top-right corner (in
620
+ LTR).
621
+ - `Toast.CloseIcon` was changed to be `extraSmall` tertiary button.
622
+
623
+ ### Tooltip
624
+
625
+ **PR:** [#4053](https://github.com/Workday/canvas-kit/pull/4053)
626
+
627
+ #### Visual Updates
628
+
629
+ - The default tooltip has been restyled from a dark surface to a light surface.
630
+ - A visible border (`system.color.border.default`) is now applied to the container, replacing the
631
+ previous transparent outline.
632
+ - Tooltip boundaries remain visible in Windows High Contrast mode: when High Contrast is detected,
633
+ Tooltip uses a solid outline (`outline: solid 1px CanvasText`) to ensure clear visibility.
634
+ - Shape is now fully rounded using `system.shape.full`.
635
+ - Box-shadow updated from `system.depth[2]` to `system.depth[3]`.
636
+ - Type level is now `subtext.lg` (previously `subtext.md`).
637
+ - Padding and spacing have been adjusted to accommodate the new styling.
638
+
554
639
  ## New Utilities
555
640
 
556
641
  ### cornerShapeStencil
@@ -6,6 +6,7 @@ import ExternalLinkRTL from './examples/ExternalHyperlinkRTL';
6
6
  import Link from './examples/Hyperlink';
7
7
  import InBodyText from './examples/HyperlinkInBodyText';
8
8
  import LinkInverse from './examples/HyperlinkInverse';
9
+ import SecondaryLink from './examples/SecondaryHyperlink';
9
10
  import StandaloneLink from './examples/StandaloneHyperlink';
10
11
 
11
12
 
@@ -33,31 +34,44 @@ the current page. By default, `Hyperlink`s have an underline for accessibility.
33
34
  #### Inverse
34
35
 
35
36
  `Hyperlink`s also have an `inverse` variant. Use this variant when you need to place a `Hyperlink`
36
- on a dark or colorful background.
37
+ on a dark background.
37
38
 
38
39
  <ExampleCodeBlock code={LinkInverse} />
39
40
 
40
- #### Standalone
41
+ #### Secondary
42
+
43
+ `Hyperlink`s also have a `secondary` variant. This is a dark gray alternate to the default blue
44
+ hyperlink. Use this variant when you need to place a `Hyperlink` on a colored background.
41
45
 
42
- `Hyperlink`s also have a `standalone` variant. Use this variant when you need to place a `Hyperlink`
43
- outside of a paragraph or body text. This will remove the underline.
46
+ <ExampleCodeBlock code={SecondaryLink} />
44
47
 
45
- This variant can also be used with the `ExternalHyperlink` component.
48
+ #### Standalone
49
+
50
+ Use `linkType="standalone"` when you need to place a `Hyperlink` outside of paragraph or body text,
51
+ such as in a button group or navigation list. This removes the underline. By default, `linkType` is
52
+ `"inline"` and links are underlined.
46
53
 
47
54
  <ExampleCodeBlock code={StandaloneLink} />
48
55
 
56
+ > **Accessibility Note:** Only use `linkType="standalone"` when something other than color already
57
+ > shows it's a link — for example, it's set apart from surrounding content, like in a button or
58
+ > navigation list. Never use `linkType="standalone"` for links embedded in body copy; a hover-only
59
+ > underline is not enough for inline links to meet
60
+ > [WCAG v2.2 success criterion 1.4.1 Use of Color](https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html).
61
+
49
62
  #### In Body Text
50
63
 
51
- In most cases use `HyperLink` and `ExternalHyperlink` in body text of a sentence where you need to
52
- link to another page or part of the document. By default they will wrap to a new line.
64
+ In most cases use `Hyperlink` and `ExternalHyperlink` with the default `linkType="inline"` in body
65
+ text of a sentence where you need to link to another page or part of the document. By default they
66
+ will wrap to a new line.
53
67
 
54
68
  <ExampleCodeBlock code={InBodyText} />
55
69
 
56
70
  > **Accessibility Note:** Underlining links is not required in most cases. However, the example
57
71
  > above is one such exception. When hyperlinked text appears inline with static text, a text
58
- > decoration is required to avoid failing WCAG v2.2 success criterion 1.4.1 Use of Color.
59
- >
60
- > [Failure of Success Criterion 1.4.1 due to creating links that are not visually evident without color vision](https://www.w3.org/WAI/WCAG22/Techniques/failures/F73)
72
+ > decoration is required to avoid
73
+ > [failing WCAG v2.2 success criterion 1.4.1 Use of Color](https://www.w3.org/WAI/WCAG22/Techniques/failures/F73).
74
+ > Do not use `linkType="standalone"` here, as removing the underline would fail this criterion.
61
75
 
62
76
  ### Accessibility
63
77
 
@@ -98,7 +112,7 @@ users know about the behavior by adding an icon, `externalLinkIcon`.
98
112
  <ExampleCodeBlock code={ExternalLink} />
99
113
 
100
114
  `ExternalHyperlink`s also have an `inverse` variant. Use this variant when you need to place the
101
- link on a dark or colorful background.
115
+ link on a dark background.
102
116
 
103
117
  <ExampleCodeBlock code={ExternalLinkInverse} />
104
118
 
@@ -23,7 +23,8 @@ export default () => (
23
23
  </ExternalHyperlink>
24
24
  <ExternalHyperlink
25
25
  href="https://workday.com"
26
- variant="standaloneInverse"
26
+ variant="inverse"
27
+ linkType="standalone"
27
28
  iconLabel="Opens new window"
28
29
  >
29
30
  Hyperlink
@@ -17,7 +17,7 @@ export default () => (
17
17
  <Hyperlink href="#hyperlink" variant="inverse">
18
18
  Hyperlink
19
19
  </Hyperlink>
20
- <Hyperlink href="#hyperlink" variant="standaloneInverse">
20
+ <Hyperlink href="#hyperlink" variant="inverse" linkType="standalone">
21
21
  Hyperlink
22
22
  </Hyperlink>
23
23
  </Box>
@@ -0,0 +1,18 @@
1
+ import {Hyperlink} from '@workday/canvas-kit-react/button';
2
+ import {createStyles} from '@workday/canvas-kit-styling';
3
+ import {system} from '@workday/canvas-tokens-web';
4
+
5
+ const containerStyles = createStyles({
6
+ backgroundColor: system.legacy.color.surface.info.default,
7
+ padding: system.padding.md,
8
+ display: 'inline-flex',
9
+ gap: system.gap.md,
10
+ });
11
+
12
+ export default () => (
13
+ <div className={containerStyles}>
14
+ <Hyperlink variant="secondary" href="#secondary-hyperlink">
15
+ Hyperlink
16
+ </Hyperlink>
17
+ </div>
18
+ );
@@ -9,15 +9,8 @@ const containerStyles = createStyles({
9
9
 
10
10
  export default () => (
11
11
  <div className={containerStyles}>
12
- <Hyperlink variant="standalone" href="#standalone-hyperlink">
13
- Standalone Hyperlink
12
+ <Hyperlink linkType="standalone" href="#standalone-hyperlink">
13
+ Hyperlink
14
14
  </Hyperlink>
15
- <ExternalHyperlink
16
- variant="standalone"
17
- href="#standalone-external-hyperlink"
18
- iconLabel="Opens new window"
19
- >
20
- Standalone External Hyperlink
21
- </ExternalHyperlink>
22
15
  </div>
23
16
  );
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@workday/canvas-kit-docs",
3
- "version": "16.0.0-alpha.0478-next.0",
3
+ "version": "16.0.0-alpha.0483-next.0",
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,12 +47,12 @@
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-alpha.0478-next.0",
51
- "@workday/canvas-kit-preview-react": "^16.0.0-alpha.0478-next.0",
52
- "@workday/canvas-kit-react": "^16.0.0-alpha.0478-next.0",
53
- "@workday/canvas-kit-styling": "^16.0.0-alpha.0478-next.0",
50
+ "@workday/canvas-kit-labs-react": "^16.0.0-alpha.0483-next.0",
51
+ "@workday/canvas-kit-preview-react": "^16.0.0-alpha.0483-next.0",
52
+ "@workday/canvas-kit-react": "^16.0.0-alpha.0483-next.0",
53
+ "@workday/canvas-kit-styling": "^16.0.0-alpha.0483-next.0",
54
54
  "@workday/canvas-system-icons-web": "4.0.4",
55
- "@workday/canvas-tokens-web": "4.4.0-beta.6",
55
+ "@workday/canvas-tokens-web": "4.4.0-beta.7",
56
56
  "markdown-to-jsx": "^7.2.0",
57
57
  "react-syntax-highlighter": "^15.5.0",
58
58
  "ts-node": "^10.9.1"
@@ -63,5 +63,5 @@
63
63
  "mkdirp": "^1.0.3",
64
64
  "typescript": "5.0"
65
65
  },
66
- "gitHead": "d84620c64bada313ccd29fa9672193473f9b5633"
66
+ "gitHead": "d78aaca7a4894a345fbf05f88ba6e84b41b8028b"
67
67
  }