@workday/canvas-kit-docs 16.0.0-alpha.0441-next.0 → 16.0.0-alpha.0445-next.0

package/dist/es6/lib/docs.js

@@ -451464,6 +451464,34 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
           "tags": {
             "default": "'accent'"
           }
+        },
+        {
+          "kind": "property",
+          "name": "surfaceType",
+          "required": false,
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "string",
+                "value": "default"
+              },
+              {
+                "kind": "string",
+                "value": "inverse"
+              }
+            ]
+          },
+          "description": "A string that will determine which surface overlay variant to use.",
+          "declarations": [
+            {
+              "name": "surfaceType",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/styling/lib/colorSpace.tsx"
+            }
+          ],
+          "tags": {
+            "default": "'default'"
+          }
         }
       ]
     }

package/dist/mdx/16.0-UPGRADE-GUIDE.mdx

@@ -16,14 +16,18 @@ Soon to be...
   - [KBD](#kbd)
 - [Component Updates](#component-updates)
   - [Avatar](#avatar)
-  - [Buttons](#buttons)
-    - [Delete Button Outline Variant](#delete-button-outline-variant)
+  - [Buttons](#buttons) - [Delete Button Outline Variant](#delete-button-outline-variant)
   - [Card](#card)
-  - [Color Input](#color-input)
-  - [Color Picker](#color-picker)
-  - [Form Field](#form-field)
-  - [Text Area](#text-area)
-  - [Text Input](#text-input)
+  - [Inputs](#inputs)
+    - [Accessibility: Checked-State Contrast](#accessibility-checked-state-contrast)
+    - [Checkbox](#checkbox)
+    - [Color Input](#color-input)
+    - [Color Picker](#color-picker)
+    - [Form Field](#form-field)
+    - [Radio](#radio)
+    - [Switch](#switch)
+    - [Text Area](#text-area)
+    - [Text Input](#text-input)
 - [New Utilities](#new-utilities)
   - [cornerShapeStencil](#cornershapestencil)
 - [Deprecations](#deprecations)
@@ -211,48 +215,116 @@ import {DeleteButton} from '@workday/canvas-kit-react/button';
 - Card's border radius is now managed via the new `cornerShapeStencil` (see
   [New Utilities](#new-utilities)).
 
-### Color Input
+### Inputs
+
+#### Accessibility: Checked-State Contrast
+
+> **Important:** The checked states of `Checkbox`, `Radio`, and `Switch` now derive their
+> background/fill color from `system.color.brand.accent.positive` (which maps to your theme's
+> `brand.success.base`), while the foreground (the check icon, radio dot, and switch thumb) remains
+> an inverse/white color. This pairing relies on `brand.success.base` being a sufficiently dark
+> color.
+
+This change is safe for the default Canvas themes, where `brand.success.base` is dark enough to
+maintain adequate contrast against the white foreground. However, **consumer themes that override
+`brand.success.base` with a light color may produce insufficient contrast** between the checked
+background and the white check icon, radio dot, or switch thumb. This can cause the checked state to
+fail
+[WCAG 1.4.11 Non-text Contrast (3:1)](https://www.w3.org/WAI/WCAG21/Understanding/non-text-contrast.html).
+
+If you customize `brand.success.base` in your theme, please verify the following:
+
+- **Maintain a minimum 3:1 contrast ratio** between your `brand.success.main` value and the white
+  (`#ffffff`) foreground used for the check icon, radio dot, and switch thumb.
+- Prefer a `brand.success.base` value that is dark enough to pair with a light foreground. If your
+  brand requires a light success color, you may need to override the component styles so the
+  foreground uses a darker, paired contrast color instead of white.
+  > **Note:** All visual updates apply to both the Default Canvas theme and new Sana Canvas theme
+  > unless specified otherwise.
+
+#### Checkbox
+
+**PR:** [#3984](https://github.com/Workday/canvas-kit/pull/3984)
+
+##### Visual Updates
+
+- The default Checkbox size is now **20px** (previously 24px).
+- Checked state uses `system.color.brand.accent.positive` instead of
+  `system.color.brand.accent.primary` for the background.
+- Error and alert states no longer display a status background color; only the standard background
+  is shown.
+- The hover ring is smaller to better align with the smaller size. The hover ring background color
+  uses neutral instead of slate in `sana-canvas` theme.
+
+#### Color Input
 
 **PR:** [#3992](https://github.com/Workday/canvas-kit/pull/3992)
 
-#### Visual Updates
+##### Visual Updates
 
 - Shape is now **12px** (previously 8px).
 
-### Color Picker
+#### Color Picker
 
 **PR:** [#3992](https://github.com/Workday/canvas-kit/pull/3992)
 
-#### Visual Updates
+##### Visual Updates
 
 - **Sana Canvas:** swatch shape is now **6px** (previously **4px**).
 
-### Form Field
+#### Form Field
 
 **PR:** [#3992](https://github.com/Workday/canvas-kit/pull/3992)
 
-#### Visual Updates
+##### Visual Updates
 
 - Shape for grouped inputs (Radio groups and Checkbox groups) is now **12px** (previously 8px). As
   in v15, this shape is primarily visible for error and caution states.
 - Error and caution states no longer display a status background color; only the standard background
   is shown.
 
-### Text Area
+#### Radio
+
+**PR:** [#3984](https://github.com/Workday/canvas-kit/pull/3984)
+
+##### Visual Updates
+
+- The default Radio size is now **20px** (previously 24px).
+- Checked state uses `system.color.brand.accent.positive` instead of
+  `system.color.brand.accent.primary` for the background.
+- Error and alert states no longer display a status background color; only the standard background
+  is shown.
+- The hover ring is smaller to better align with the smaller size. The hover ring background color
+  uses a neutral color instead of slate in `sana-canvas` theme.
+
+#### Switch
+
+**PR:** [#3984](https://github.com/Workday/canvas-kit/pull/3984)
+
+##### Visual Updates
+
+- The Switch thumb is now **16px** (was 14px). The icon-thumb container width remains unchanged.
+- The checked state background now uses `system.color.brand.accent.positive` instead of
+  `system.color.brand.accent.primary`.
+- The default (unchecked) background color now uses `system.color.surface.muted.default` instead of
+  `system.color.surface.muted.soft`. Background color uses a neutral color instead of slate in
+  `sana-canvas` theme.
+
+#### Text Area
 
 **PR:** [#3992](https://github.com/Workday/canvas-kit/pull/3992)
 
-#### Visual Updates
+##### Visual Updates
 
 - Shape is now **12px** (previously 8px).
 - Error and caution states no longer display a status background color; only the standard background
   is shown.
 
-### Text Input
+#### Text Input
 
 **PR:** [#3992](https://github.com/Workday/canvas-kit/pull/3992)
 
-#### Visual Updates
+##### Visual Updates
 
 - Shape is now **12px** (previously 8px).
 - Error and caution states no longer display a status background color; only the standard background

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workday/canvas-kit-docs",
-  "version": "16.0.0-alpha.0441-next.0",
+  "version": "16.0.0-alpha.0445-next.0",
   "description": "Documentation components of Canvas Kit components",
   "author": "Workday, Inc. (https://www.workday.com)",
   "license": "Apache-2.0",
@@ -47,10 +47,10 @@
     "@stackblitz/sdk": "^1.11.0",
     "@storybook/csf": "0.0.1",
     "@workday/canvas-expressive-icons-web": "1.0.2",
-    "@workday/canvas-kit-labs-react": "^16.0.0-alpha.0441-next.0",
-    "@workday/canvas-kit-preview-react": "^16.0.0-alpha.0441-next.0",
-    "@workday/canvas-kit-react": "^16.0.0-alpha.0441-next.0",
-    "@workday/canvas-kit-styling": "^16.0.0-alpha.0441-next.0",
+    "@workday/canvas-kit-labs-react": "^16.0.0-alpha.0445-next.0",
+    "@workday/canvas-kit-preview-react": "^16.0.0-alpha.0445-next.0",
+    "@workday/canvas-kit-react": "^16.0.0-alpha.0445-next.0",
+    "@workday/canvas-kit-styling": "^16.0.0-alpha.0445-next.0",
     "@workday/canvas-system-icons-web": "4.0.4",
     "@workday/canvas-tokens-web": "4.4.0-beta.3",
     "markdown-to-jsx": "^7.2.0",
@@ -63,5 +63,5 @@
     "mkdirp": "^1.0.3",
     "typescript": "5.0"
   },
-  "gitHead": "df9a69acd1329b7bc14a225dfbe46d4cfe3265c0"
+  "gitHead": "fc927ea8a9cdb16ad227bbfc5d843dba09009b43"
 }