chore: Merge latest prerelease/major

Author: Alan Smith

.storybook/routes.js

@@ -3,9 +3,11 @@
 // and will rewrite the URL to point to the correct URL for the story. The Storybook key will be
 // rewritten to something like `?path=/docs/${id}`
 const routes = {
+  // Assets
   '/assets/accent-icons/': 'assets-icons--docs#accent-icon-list',
   '/assets/applet-icons/': 'assets-icons--docs#applet-icon-list',
   '/assets/system-icons/': 'assets-icons--docs#system-icon-list',
+  // Components
   '/components/buttons/action-bar/': 'components-buttons-action-bar--docs',
   '/components/buttons/button/': 'components-buttons--docs',
   '/components/buttons/segmented-control/': 'preview-segmented-control--docs',
@@ -41,39 +43,42 @@ const routes = {
   '/components/text/subtext/': 'components-text-subtext--docs',
   '/components/text/text/': 'components-text-text--docs',
   '/components/text/title/': 'components-text-title--docs',
-  '/examples/layout/': 'examples-layouts--docs',
+  // Get Started
   '/get-started/for-developers/theming/overview/': 'features-theming-overview--docs',
-  '/getting-started/for-developers/contributing/': 'guides-contributing--docs',
+  '/get-started/for-contributors/code/': 'guides-contributing--docs',
   '/get-started/for-developers/guides/combobox/': 'features-combobox--docs',
-  '/getting-started/for-developers/resources/api-pattern-guidelines/':
+  '/get-started/for-developers/documentation/api-pattern-guidelines/':
     'guides-api-pattern-guidelines--docs',
-  '/getting-started/for-developers/resources/collection-api/': 'features-collections--docs',
-  '/getting-started/for-developers/resources/compound-components/':
+  '/get-started/for-developers/guides/collection-api/': 'features-collections--docs',
+  '/get-started/for-developers/documentation/compound-components/':
     'guides-compound-components--docs',
-  '/getting-started/for-developers/resources/creating-compound-components/':
+  '/get-started/for-developers/documentation/creating-compound-components/':
     'guides-creating-compound-components--docs',
-  '/getting-started/for-developers/resources/responsive-styling/':
+  '/get-started/for-developers/guides/responsive-styling/':
     'features-responsive-styling--responsive-container',
-  '/getting-started/for-developers/resources/style-props/': 'features-style-props--docs',
-  '/getting-started/for-developers/resources/testing/': 'guides-testing--docs',
-  '/getting-started/introduction/': 'guides-getting-started--docs',
-  '/help/upgrade-guides/canvas-v14-upgrade-guide/': 'guides-upgrade-guides-v14-0-overview--docs',
-  '/help/upgrade-guides/canvas-v14-upgrade-guide/#tab=visual-changes':
-    'guides-upgrade-guides-v14-0-visual-changes--docs',
+  '/get-started/for-developers/documentation/style-props/': 'features-style-props--docs',
+  '/get-started/for-developers/documentation/testing/': 'guides-testing--docs',
+  '/get-started/for-developers/documentation/testing#visual-tests':
+    'hooks-and-utilities-testing--docs',
+  '/get-started/introduction/': 'guides-getting-started--docs',
+  // Tokens
   '/tokens/color/': 'tokens-tokens--docs#colors',
   '/tokens/depth/': 'tokens-tokens--docs#depth',
   '/tokens/space/': 'tokens-tokens--docs#space',
   '/tokens/type/': 'tokens-tokens--docs#type',
-  '/utilities/testing/': 'hooks-and-utilities-testing--docs',
-  '/whats-new/upgrade-guides/canvas-kit-v4-upgrade-guide/': 'guides-upgrade-guides-v4-0--docs',
-  '/whats-new/upgrade-guides/canvas-kit-v5-upgrade-guide/': 'guides-upgrade-guides-v5-0--docs',
-  '/whats-new/upgrade-guides/canvas-kit-v6-upgrade-guide/': 'guides-upgrade-guides-v6-0--docs',
-  '/whats-new/upgrade-guides/canvas-kit-v7-upgrade-guide/': 'guides-upgrade-guides-v7-0--docs',
-  '/whats-new/upgrade-guides/canvas-kit-v8-upgrade-guide/': 'guides-upgrade-guides-v8-0--docs',
-  '/whats-new/upgrade-guides/canvas-v9-upgrade-guide/': 'guides-upgrade-guides-v9-0--docs',
-  '/whats-new/upgrade-guides/canvas-v10-upgrade-guide/': 'guides-upgrade-guides-v10-0--docs',
-  '/whats-new/upgrade-guides/canvas-v11-upgrade-guide/': 'guides-upgrade-guides-v11-0--docs',
-  '/whats-new/upgrade-guides/canvas-v12-upgrade-guide/': 'guides-upgrade-guides-v12-0--docs',
+  // Upgrade Guides
+  '/help/upgrade-guides/canvas-kit-v4-upgrade-guide/': 'guides-upgrade-guides-v4-0--docs',
+  '/help/upgrade-guides/canvas-kit-v5-upgrade-guide/': 'guides-upgrade-guides-v5-0--docs',
+  '/help/upgrade-guides/canvas-kit-v6-upgrade-guide/': 'guides-upgrade-guides-v6-0--docs',
+  '/help/upgrade-guides/canvas-kit-v7-upgrade-guide/': 'guides-upgrade-guides-v7-0--docs',
+  '/help/upgrade-guides/canvas-kit-v8-upgrade-guide/': 'guides-upgrade-guides-v8-0--docs',
+  '/help/upgrade-guides/canvas-v9-upgrade-guide/': 'guides-upgrade-guides-v9-0--docs',
+  '/help/upgrade-guides/canvas-v10-upgrade-guide/': 'guides-upgrade-guides-v10-0--docs',
+  '/help/upgrade-guides/canvas-v11-upgrade-guide/': 'guides-upgrade-guides-v11-0--docs',
+  '/help/upgrade-guides/canvas-v12-upgrade-guide/': 'guides-upgrade-guides-v12-0--docs',
+  '/help/upgrade-guides/canvas-v14-upgrade-guide/': 'guides-upgrade-guides-v14-0-overview--docs',
+  '/help/upgrade-guides/canvas-v14-upgrade-guide/#tab=visual-changes':
+    'guides-upgrade-guides-v14-0-visual-changes--docs',
 };
 
 export default routes;

CHANGELOG.md

@@ -3,6 +3,39 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [v14.2.4](https://github.com/Workday/canvas-kit/releases/tag/v14.2.4) (2026-01-07)
+
+### Components
+
+- fix: Add missing heading component and update to remove aria labels on toggle button ([#3655](https://github.com/Workday/canvas-kit/pull/3655)) ([@williamjstanton](https://github.com/williamjstanton), William Stanton, manuel.carrera)
+- fix: Select should close on blur ([#3674](https://github.com/Workday/canvas-kit/pull/3674)) ([@mannycarrera4](https://github.com/mannycarrera4), manuel.carrera)
+
+### Documentation
+
+- docs: Fixed Box style props links ([#3672](https://github.com/Workday/canvas-kit/pull/3672)) ([@josh-bagwell](https://github.com/josh-bagwell))
+  Updates style props links in the `Box` component documentation.
+
+
+## [v13.2.50](https://github.com/Workday/canvas-kit/releases/tag/v13.2.50) (2026-01-06)
+
+### Components
+
+- fix: Select should close on blur ([#3674](https://github.com/Workday/canvas-kit/pull/3674)) ([@mannycarrera4](https://github.com/mannycarrera4), manuel.carrera)
+
+
+## [v13.2.49](https://github.com/Workday/canvas-kit/releases/tag/v13.2.49) (2026-01-06)
+
+### Documentation
+
+- docs: Fixed Box style props links ([#3672](https://github.com/Workday/canvas-kit/pull/3672)) ([@josh-bagwell](https://github.com/josh-bagwell))
+  Updates style props links in the `Box` component documentation.
+## [v14.2.3](https://github.com/Workday/canvas-kit/releases/tag/v14.2.3) (2026-01-02)
+
+### Documentation
+
+- docs: Fix broken docs links ([#3667](https://github.com/Workday/canvas-kit/pull/3667)) ([@alanbsmith](https://github.com/alanbsmith), [@jamesfan](https://github.com/jamesfan), Alan Smith)
+
+
 ## [v14.2.2](https://github.com/Workday/canvas-kit/releases/tag/v14.2.2) (2025-12-31)
 
 ### Documentation

cypress/component/Avatar.spec.tsx

@@ -1,38 +1,20 @@
-import {Basic} from '../../modules/react/avatar/stories/avatar/examples/Basic';
-import {Button} from '../../modules/react/avatar/stories/avatar/examples/Button';
-import {CustomStyles} from '../../modules/react/avatar/stories/avatar/examples/CustomStyles';
-import {Image} from '../../modules/react/avatar/stories/avatar/examples/Image';
-import {LazyLoad} from '../../modules/react/avatar/stories/avatar/examples/LazyLoad';
-import {ObjectFit} from '../../modules/react/avatar/stories/avatar/examples/ObjectFit';
-import {Size} from '../../modules/react/avatar/stories/avatar/examples/Size';
-import {Variant} from '../../modules/react/avatar/stories/avatar/examples/Variant';
+import {Image} from '../../modules/react/avatar/stories/examples/Image';
 
 describe('Avatar', () => {
-  [Basic, Size, Variant, CustomStyles].forEach(Example => {
-    context(`${Example.name} Example`, () => {
-      beforeEach(() => {
-        cy.mount(<Example />);
-      });
-
-      it('should not have any axe errors', () => {
-        cy.checkA11y();
-      });
+  context(`Image Example`, () => {
+    beforeEach(() => {
+      cy.mount(<Image />);
     });
-  });
-
-  [Image, Button, LazyLoad, ObjectFit].forEach(Example => {
-    context(`${Example.name} Example`, () => {
-      beforeEach(() => {
-        cy.mount(<Example />);
-      });
 
-      it('should not have any axe errors', () => {
-        cy.checkA11y();
-      });
-
-      it('should have images', () => {
-        cy.get('img').should('be.visible'); // wait for image to load
-      });
+    it('should not have any axe errors', () => {
+      cy.checkA11y();
+    });
+    it('should show the initials HD given the name is Happy Doggo until the image is loaded ', () => {
+      cy.findByText('HD').should('be.visible');
+      cy.findByRole('img').should('not.exist');
+      // wait for the image to load
+      cy.wait(1000);
+      cy.findByRole('img').should('exist');
     });
   });
 });

cypress/component/AvatarPreview.spec.tsx

@@ -28,8 +28,8 @@ describe('Side Panel', () => {
           cy.findByRole('button', {name}).should('exist');
         });
 
-        it(`should have an aria-expanded attribute of 'true'`, () => {
-          cy.findByRole('button', {name}).should('have.attr', 'aria-expanded', 'true');
+        it(`should have an aria-pressed attribute of 'false'`, () => {
+          cy.findByRole('button', {name}).should('have.attr', 'aria-pressed', 'false');
         });
 
         it(`should have an aria-controls attribute equal to the id of the panel`, () => {
@@ -50,8 +50,8 @@ describe('Side Panel', () => {
         });
 
         context('the button', () => {
-          it(`should have an aria-expanded attribute of 'false'`, () => {
-            cy.findByRole('button', {name}).should('have.attr', 'aria-expanded', 'false');
+          it(`should have an aria-pressed attribute of 'false'`, () => {
+            cy.findByRole('button', {name}).should('have.attr', 'aria-pressed', 'false');
           });
         });
       });
@@ -62,7 +62,7 @@ describe('Side Panel', () => {
     context(`when focused on a focusable element preceding the Side Panel`, () => {
       beforeEach(() => {
         cy.mount(<FirstFocusable />);
-        cy.findByLabelText('Avatar').focus();
+        cy.findByRole('button', {name: 'Open'}).focus();
       });
 
       context('when the tab key is pressed once', () => {

cypress/component/SidePanelLabs.spec.tsx

@@ -62,7 +62,7 @@ describe('Side Panel', () => {
     context(`when focused on a focusable element preceding the Side Panel`, () => {
       beforeEach(() => {
         cy.mount(<FirstFocusable />);
-        cy.findByLabelText('Avatar').focus();
+        cy.findByRole('button', {name: 'Open'}).focus();
       });
 
       context('when the tab key is pressed once', () => {

cypress/component/SidePanelPreview.spec.tsx

@@ -2,7 +2,7 @@
   "packages": [
     "modules/**"
   ],
-  "version": "14.2.2",
+  "version": "14.2.4",
   "npmClient": "yarn",
   "command": {
     "version": {

lerna.json

@@ -1,12 +1,18 @@
 import {Transform} from 'jscodeshift';
 
+import promoteAvatar from './promoteAvatar';
 import promoteInformationHighlight from './promoteInformationHighlight';
 import promotePill from './promotePill';
 import promoteSegmentedControl from './promoteSegmentedControl';
 
 const transform: Transform = (file, api, options) => {
   // These will run in order. If your transform depends on others, place yours after dependent transforms
-  const fixes: Transform[] = [promoteSegmentedControl, promoteInformationHighlight, promotePill];
+  const fixes: Transform[] = [
+    promoteSegmentedControl,
+    promoteInformationHighlight,
+    promotePill,
+    promoteAvatar,
+  ];
   return fixes.reduce((source, fix) => fix({...file, source}, api, options) as string, file.source);
 };
 

modules/codemod/lib/v15/index.ts

@@ -0,0 +1,97 @@
+import {ASTPath, ImportDeclaration, Transform} from 'jscodeshift';
+
+type SpecifierType = {importedName: string; name?: string};
+
+// List of all Avatar-related exports from preview that should be promoted
+const AVATAR_EXPORTS = [
+  'Avatar',
+  'AvatarProps',
+  'avatarStencil',
+  'AvatarImage',
+  'AvatarImageProps',
+  'avatarImageStencil',
+  'AvatarName',
+  'AvatarNameProps',
+  'avatarNameStencil',
+  'BaseAvatar',
+  'BaseAvatarProps',
+  'baseAvatarStencil',
+  'getInitialsFromName',
+];
+
+const transform: Transform = (file, api) => {
+  const j = api.jscodeshift;
+
+  const root = j(file.source);
+  const avatarSpecifiers: SpecifierType[] = [];
+  const foundImport: ASTPath<ImportDeclaration>[] = [];
+
+  root
+    .find(j.ImportDeclaration, {
+      source: {value: (value: string) => value.includes('@workday/canvas-kit-preview-react')},
+    })
+    .forEach(nodePath => {
+      nodePath.value.specifiers = nodePath.value.specifiers?.filter(specifier => {
+        if (
+          specifier.type === 'ImportSpecifier' &&
+          specifier.local &&
+          AVATAR_EXPORTS.includes(specifier.imported.name)
+        ) {
+          avatarSpecifiers.push({
+            importedName: specifier.imported.name,
+            name: specifier.local.name,
+          });
+
+          return false;
+        }
+        return true;
+      });
+
+      if (avatarSpecifiers.length) {
+        foundImport.push(nodePath);
+      }
+    });
+
+  const existingAvatarImports = root.find(j.ImportDeclaration, {
+    source: {value: '@workday/canvas-kit-react/avatar'},
+  });
+
+  const mapToSpecifiers = (specifier: SpecifierType) => {
+    return j.importSpecifier(
+      j.identifier(specifier.importedName),
+      specifier.name ? j.identifier(specifier.name) : undefined
+    );
+  };
+
+  // add to existing import
+  if (existingAvatarImports.length) {
+    existingAvatarImports.forEach(nodePath => {
+      nodePath.value.specifiers = nodePath.value.specifiers?.concat(
+        avatarSpecifiers.map(mapToSpecifiers)
+      );
+    });
+  } else {
+    // create new import
+    if (foundImport.length) {
+      foundImport[0].insertBefore(
+        j.importDeclaration(
+          avatarSpecifiers.map(mapToSpecifiers),
+          j.stringLiteral('@workday/canvas-kit-react/avatar')
+        )
+      );
+    }
+  }
+
+  foundImport.forEach(importPath => {
+    if (
+      !importPath.value.specifiers?.length ||
+      importPath.value.source.value === '@workday/canvas-kit-preview-react/avatar'
+    ) {
+      importPath.prune();
+    }
+  });
+
+  return root.toSource();
+};
+
+export default transform;