@carbon/react 1.78.1 → 1.78.2

package/lib/components/UIShell/HeaderContainer.js

@@ -12,9 +12,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
 var PropTypes = require('prop-types');
 var React = require('react');
-var keys = require('../../internal/keyboard/keys.js');
-var match = require('../../internal/keyboard/match.js');
 var useEvent = require('../../internal/useEvent.js');
+var match = require('../../internal/keyboard/match.js');
+var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 

package/lib/components/UIShell/HeaderMenu.js

@@ -14,12 +14,12 @@ var iconsReact = require('@carbon/icons-react');
 var cx = require('classnames');
 var React = require('react');
 var PropTypes = require('prop-types');
-var keys = require('../../internal/keyboard/keys.js');
-var match = require('../../internal/keyboard/match.js');
 var AriaPropTypes = require('../../prop-types/AriaPropTypes.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var deprecate = require('../../prop-types/deprecate.js');
 var events = require('../../tools/events.js');
+var match = require('../../internal/keyboard/match.js');
+var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 

package/lib/components/UIShell/HeaderPanel.js

@@ -14,10 +14,10 @@ var cx = require('classnames');
 var PropTypes = require('prop-types');
 var React = require('react');
 var usePrefix = require('../../internal/usePrefix.js');
-var keys = require('../../internal/keyboard/keys.js');
-var match = require('../../internal/keyboard/match.js');
 var useEvent = require('../../internal/useEvent.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
+var match = require('../../internal/keyboard/match.js');
+var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 

package/lib/components/UIShell/SideNav.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/UIShell/SideNav.js

@@ -16,13 +16,13 @@ var PropTypes = require('prop-types');
 var AriaPropTypes = require('../../prop-types/AriaPropTypes.js');
 var _utils = require('./_utils.js');
 var usePrefix = require('../../internal/usePrefix.js');
-var keys = require('../../internal/keyboard/keys.js');
-var match = require('../../internal/keyboard/match.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
 var useEvent = require('../../internal/useEvent.js');
 var useDelayedState = require('../../internal/useDelayedState.js');
 var layout = require('@carbon/layout');
 var useMatchMedia = require('../../internal/useMatchMedia.js');
+var match = require('../../internal/keyboard/match.js');
+var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 

package/lib/components/UIShell/SideNavHeader.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -20,7 +20,8 @@ export interface SideNavHeaderProps {
      */
     isSideNavExpanded?: boolean;
     /**
-     * A component used to render an icon.
+     * Provide an icon to render in the header of the side navigation. Should be
+     * a React class.
      */
     renderIcon: React.ComponentType;
 }

package/lib/components/UIShell/SideNavHeader.js

@@ -49,7 +49,8 @@ SideNavHeader.propTypes = {
    */
   isSideNavExpanded: PropTypes__default["default"].bool,
   /**
-   * A component used to render an icon.
+   * Provide an icon to render in the header of the side navigation. Should be
+   * a React class.
    */
   // @ts-expect-error - PropTypes are unable to cover this case.
   renderIcon: PropTypes__default["default"].oneOfType([PropTypes__default["default"].func, PropTypes__default["default"].object]).isRequired

package/lib/components/UIShell/SideNavLink.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -37,7 +37,7 @@ export type SideNavLinkProps<E extends ElementType> = LinkProps<E> & {
      */
     large?: boolean;
     /**
-     * A component used to render an icon.
+     * Provide an icon to render in the side navigation link. Should be a React class.
      */
     renderIcon?: ComponentType;
     /**

package/lib/components/UIShell/SideNavLink.js

@@ -79,7 +79,7 @@ SideNavLink.propTypes = {
    */
   large: PropTypes__default["default"].bool,
   /**
-   * A component used to render an icon.
+   * Provide an icon to render in the side navigation link. Should be a React class.
    */
   // @ts-expect-error - PropTypes are unable to cover this case.
   renderIcon: PropTypes__default["default"].oneOfType([PropTypes__default["default"].func, PropTypes__default["default"].object]),

package/lib/components/UIShell/SideNavMenu.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -27,7 +27,7 @@ export interface SideNavMenuProps {
      */
     large?: boolean;
     /**
-     * A component used to render an icon.
+     * A custom icon to render next to the SideNavMenu title. This can be a function returning JSX or JSX itself.
      */
     renderIcon?: React.ComponentType;
     /**

package/lib/components/UIShell/SideNavMenu.js

@@ -14,10 +14,10 @@ var cx = require('classnames');
 var PropTypes = require('prop-types');
 var React = require('react');
 var SideNavIcon = require('./SideNavIcon.js');
-var keys = require('../../internal/keyboard/keys.js');
-var match = require('../../internal/keyboard/match.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var SideNav = require('./SideNav.js');
+var match = require('../../internal/keyboard/match.js');
+var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -120,7 +120,7 @@ SideNavMenu.propTypes = {
    */
   large: PropTypes__default["default"].bool,
   /**
-   * A component used to render an icon.
+   * Pass in a custom icon to render next to the `SideNavMenu` title
    */
   // @ts-expect-error - PropTypes are unable to cover this case.
   renderIcon: PropTypes__default["default"].oneOfType([PropTypes__default["default"].func, PropTypes__default["default"].object]),

package/lib/components/UIShell/SwitcherItem.js

@@ -15,9 +15,9 @@ var cx = require('classnames');
 var PropTypes = require('prop-types');
 var Link = require('./Link.js');
 var usePrefix = require('../../internal/usePrefix.js');
-var keys = require('../../internal/keyboard/keys.js');
-var match = require('../../internal/keyboard/match.js');
 var AriaPropTypes = require('../../prop-types/AriaPropTypes.js');
+var match = require('../../internal/keyboard/match.js');
+var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 

package/lib/internal/FloatingMenu.js

@@ -13,13 +13,13 @@ var React = require('react');
 var FeatureFlags = require('@carbon/feature-flags');
 var ReactDOM = require('react-dom');
 var window = require('window-or-global');
-var keys = require('./keyboard/keys.js');
-var match = require('./keyboard/match.js');
-var navigation = require('./keyboard/navigation.js');
 var OptimizedResize = require('./OptimizedResize.js');
+var navigation = require('./keyboard/navigation.js');
 var usePrefix = require('./usePrefix.js');
 var warning = require('./warning.js');
 var wrapFocus = require('./wrapFocus.js');
+var match = require('./keyboard/match.js');
+var keys = require('./keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -230,11 +230,11 @@ const FloatingMenu = _ref2 => {
 
   // Attach a resize listener.
   React.useEffect(() => {
-    const resizeHandler = OptimizedResize.OptimizedResize.add(() => {
+    const resizeHandler = OptimizedResize["default"].add(() => {
       updateMenuPosition();
     });
     return () => {
-      resizeHandler.remove();
+      resizeHandler.release();
     };
   }, [triggerRef, menuOffset, menuDirection, flipped, target, updateOrientation]);
 

package/lib/internal/OptimizedResize.js

@@ -16,42 +16,44 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 var window__default = /*#__PURE__*/_interopDefaultLegacy(window);
 
 // mdn resize function
-
-/**
- * A callback function to be executed on `resize`.
- */
-
-const OptimizedResize = (() => {
+const OptimizedResize = function optimizedResize() {
   const callbacks = [];
   let running = false;
-  const runCallbacks = () => {
+
+  // run the actual callbacks
+  function runCallbacks() {
     callbacks.forEach(callback => {
       callback();
     });
     running = false;
-  };
-  const handleResize = () => {
+  }
+
+  // fired on resize event
+  function resize() {
     if (!running) {
       running = true;
       window__default["default"].requestAnimationFrame(runCallbacks);
     }
-  };
-  const addCallback = callback => {
-    const index = callbacks.indexOf(callback);
-    if (index < 0) {
-      callbacks.push(callback);
+  }
+
+  // adds callback to loop
+  function addCallback(callback) {
+    if (callback) {
+      const index = callbacks.indexOf(callback);
+      if (index < 0) {
+        callbacks.push(callback);
+      }
     }
-  };
+  }
   return {
-    /** Adds a callback function to be executed on window `resize`. */
+    // public method to add additional callback
     add: callback => {
       if (!callbacks.length) {
-        window__default["default"].addEventListener('resize', handleResize);
+        window__default["default"].addEventListener('resize', resize);
       }
       addCallback(callback);
       return {
-        /** Removes the callback. */
-        remove: () => {
+        release() {
           const index = callbacks.indexOf(callback);
           if (index >= 0) {
             callbacks.splice(index, 1);
@@ -60,6 +62,7 @@ const OptimizedResize = (() => {
       };
     }
   };
-})();
+}();
+var OptimizedResize$1 = OptimizedResize;
 
-exports.OptimizedResize = OptimizedResize;
+exports["default"] = OptimizedResize$1;

package/lib/internal/focus/index.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+function focus(elementOrRef) {
+  const element = elementOrRef.current || elementOrRef;
+  if (element && element.focus && document.activeElement !== element) {
+    element.focus();
+  }
+}
+
+exports.focus = focus;

package/lib/internal/keyboard/keys.js

@@ -73,8 +73,8 @@ const ArrowDown = {
 };
 const Delete = {
   key: 'Delete',
-  which: 8,
-  keyCode: 8,
+  which: 8 ,
+  keyCode: 8 ,
   code: 'ArrowDecimal'
 };
 

package/lib/internal/keyboard/match.js

@@ -9,38 +9,65 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+/**
+ * @typedef Key
+ * @property key {Array<string>|string}
+ * @property which {number}
+ * @property keyCode {number}
+ */
+
 /**
  * Check to see if at least one key code matches the key code of the
  * given event.
  *
- * @param event - The event to test.
- * @param keysToMatch - An array of key definitions to match against.
- * @returns `true` if one of the keys matches.
+ * @example
+ * import * as keys from '../keys';
+ * import { matches } from '../match';
+ *
+ * function handleOnKeyDown(event) {
+ *   if (matches(event, [keys.Enter, keys.Space]) {
+ *     // ...
+ *   }
+ * }
+ *
+ * @param {Event|React.SyntheticEvent} event
+ * @param {Array<Key>} keysToMatch
+ * @returns {boolean}
  */
-const matches = (event, keysToMatch) => {
+function matches(event, keysToMatch) {
   for (let i = 0; i < keysToMatch.length; i++) {
     if (match(event, keysToMatch[i])) {
       return true;
     }
   }
   return false;
-};
+}
 
 /**
  * Check to see if the given key matches the corresponding keyboard event. Also
- * supports passing in the value directly if you can't use the given event.
+ * supports passing in the value directly if you can't used the given event.
+ *
+ * @example
+ * import * as keys from '../keys';
+ * import { matches } from '../match';
+ *
+ * function handleOnKeyDown(event) {
+ *   if (match(event, keys.Enter) {
+ *     // ...
+ *   }
+ * }
  *
- * @param eventOrCode - A `KeyboardEvent`, a number, or a string value.
- * @param keyObj - An object with key properties to match against.
- * @returns `true` if the event or code matches the key definition.
+ * @param {React.SyntheticEvent|Event|number|string} eventOrCode
+ * @param {Key} key
+ * @returns {boolean}
  */
-const match = (eventOrCode, _ref) => {
+function match(eventOrCode) {
   let {
     key,
     which,
     keyCode,
     code
-  } = _ref;
+  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   if (typeof eventOrCode === 'string') {
     return eventOrCode === key;
   }
@@ -48,13 +75,10 @@ const match = (eventOrCode, _ref) => {
     return eventOrCode === which || eventOrCode === keyCode;
   }
   if (eventOrCode.key && Array.isArray(key)) {
-    return key.includes(eventOrCode.key);
+    return key.indexOf(eventOrCode.key) !== -1;
   }
-  return eventOrCode.key === key ||
-  // TODO: When can these checks for deprecated properties be deleted?
-  // Presumably, the `Key` type should also be pruned of these properties.
-  eventOrCode.which === which || eventOrCode.keyCode === keyCode || eventOrCode.code === code;
-};
+  return eventOrCode.key === key || eventOrCode.which === which || eventOrCode.keyCode === keyCode || eventOrCode.code === code;
+}
 
 exports.match = match;
 exports.matches = matches;

package/lib/internal/keyboard/navigation.js

@@ -13,16 +13,21 @@ var keys = require('./keys.js');
 var match = require('./match.js');
 
 /**
- * A "ring buffer" function that takes an array and, depending on an ArrowRight
- * or ArrowLeft key input, loops from last index to first or first index to last.
+ * Various utilities to help with a11y work
+ */
+
+/**
+ * A "ring buffer" function that takes an array and depending on an ArrowRight
+ * or ArrowLeft key input loops from last index to first or first index to last.
  *
- * @param key - the left or right arrow key (KeyboardEvent, number, or string)
- * @param index - the current index in the array
- * @param arrayLength - the total length of the array
+ * @param {string} key - the left or right arrow keys
+ * @param {number} index - the current index in a given array
+ * @param {number} arrayLength - the total length of the array
  *
  * @example
- *  getNextIndex(keyCodes.RIGHT, 0, 4)
+ * 	getNextIndex(keyCodes.RIGHT, 0, 4)
  */
+
 const getNextIndex = (key, index, arrayLength) => {
   if (match.match(key, keys.ArrowRight)) {
     return (index + 1) % arrayLength;
@@ -30,23 +35,30 @@ const getNextIndex = (key, index, arrayLength) => {
   if (match.match(key, keys.ArrowLeft)) {
     return (index + arrayLength - 1) % arrayLength;
   }
-  return;
 };
 
 /**
- * A flag `node.compareDocumentPosition(target)` returns that indicates
- * `target` is located earlier than `node` in the document or `target` contains `node`.
+ * A flag `node.compareDocumentPosition(target)` returns,
+ * that indicates `target` is located earlier than `node` in the document or `target` contains `node`.
  */
-const DOCUMENT_POSITION_BROAD_PRECEDING = typeof Node !== 'undefined' ? Node.DOCUMENT_POSITION_PRECEDING | Node.DOCUMENT_POSITION_CONTAINS : 0;
+const DOCUMENT_POSITION_BROAD_PRECEDING =
+// Checks `typeof Node` for `react-docgen`
+typeof Node !== 'undefined' &&
+// eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+Node.DOCUMENT_POSITION_PRECEDING | Node.DOCUMENT_POSITION_CONTAINS;
 
 /**
- * A flag `node.compareDocumentPosition(target)` returns that indicates
- * `target` is located later than `node` in the document or `node` contains `target`.
+ * A flag `node.compareDocumentPosition(target)` returns,
+ * that indicates `target` is located later than `node` in the document or `node` contains `target`.
  */
-const DOCUMENT_POSITION_BROAD_FOLLOWING = typeof Node !== 'undefined' ? Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_CONTAINED_BY : 0;
+const DOCUMENT_POSITION_BROAD_FOLLOWING =
+// Checks `typeof Node` for `react-docgen`
+typeof Node !== 'undefined' &&
+// eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_CONTAINED_BY;
 
 /**
- * CSS selector that selects major nodes that are sequentially focusable.
+ * CSS selector that selects major nodes that are sequential-focusable.
  */
 const selectorTabbable = `
   a[href], area[href], input:not([disabled]):not([tabindex='-1']),
@@ -56,7 +68,7 @@ const selectorTabbable = `
 `;
 
 /**
- * CSS selector that selects major nodes that are click focusable.
+ * CSS selector that selects major nodes that are click focusable
  */
 const selectorFocusable = `
   a[href], area[href], input:not([disabled]),

package/lib/internal/useMergedRefs.js

@@ -11,9 +11,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var React = require('react');
 
-// TODO: Investigate updating this hook based on the following code from
-// https://github.com/carbon-design-system/carbon/pull/18611:
-// https://github.com/adamalston/carbon/blob/dd403b6b10de3d8a6ccd8d2e21174c908c1e890a/packages/react/src/components/ListBox/ListBoxMenuItem.tsx#L23-L46
 /**
  * Combine multiple refs into a single ref. This use useful when you have two
  * refs from both `React.forwardRef` and `useRef` that you would like to add to

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/react",
   "description": "React components for the Carbon Design System",
-  "version": "1.78.1",
+  "version": "1.78.2",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -51,10 +51,10 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.24.7",
-    "@carbon/feature-flags": "^0.24.1",
+    "@carbon/feature-flags": "^0.24.0",
     "@carbon/icons-react": "^11.57.0",
-    "@carbon/layout": "^11.30.1",
-    "@carbon/styles": "^1.77.1",
+    "@carbon/layout": "^11.30.2",
+    "@carbon/styles": "^1.77.2",
     "@floating-ui/react": "^0.27.4",
     "@ibm/telemetry-js": "^1.5.0",
     "classnames": "2.5.1",
@@ -79,7 +79,7 @@
     "@babel/preset-react": "^7.24.7",
     "@babel/preset-typescript": "^7.24.7",
     "@carbon/test-utils": "^10.35.0",
-    "@carbon/themes": "^11.48.1",
+    "@carbon/themes": "^11.48.2",
     "@figma/code-connect": "^1.2.4",
     "@rollup/plugin-babel": "^6.0.0",
     "@rollup/plugin-commonjs": "^28.0.0",
@@ -146,5 +146,5 @@
     "**/*.scss",
     "**/*.css"
   ],
-  "gitHead": "538413f7766dea6ef4bc4eb5e752b0119779f10a"
+  "gitHead": "5c8f7e2a47c2bfb2865f1f2f4efe55b26f45ad5c"
 }

package/telemetry.yml

@@ -327,7 +327,6 @@ collect:
         - tilePadding
         # FeatureFlags
         - enableExperimentalFocusWrapWithoutSentinels
-        - enableDialogElement
         - enableTreeviewControllable
         - enableV12DynamicFloatingStyles
         - enableV12Overflowmenu