@carbon/react 1.99.0 → 1.100.0

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

@@ -1,15 +1,23 @@
 /**
- * Copyright IBM Corp. 2021
+ * Copyright IBM Corp. 2021, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React from 'react';
+import PropTypes from 'prop-types';
 interface SideNavDividerProps {
     /**
      * Provide an optional class to be applied to the containing node
      */
     className?: string;
 }
-declare const SideNavDivider: React.FC<SideNavDividerProps>;
+declare const SideNavDivider: {
+    ({ className }: SideNavDividerProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default SideNavDivider;

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

@@ -4,6 +4,7 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import PropTypes from 'prop-types';
 import React from 'react';
 export interface SideNavHeaderProps {
     /**
@@ -24,5 +25,27 @@ export interface SideNavHeaderProps {
      */
     renderIcon: React.ComponentType;
 }
-declare const SideNavHeader: React.FC<SideNavHeaderProps>;
+declare const SideNavHeader: {
+    ({ children, className: customClassName, renderIcon: IconElement, }: SideNavHeaderProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+    propTypes: {
+        /**
+         * The child nodes to be rendered
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Property to indicate if the side nav container is open (or not). Use to
+         * keep local state and styling in step with the SideNav expansion state.
+         */
+        isSideNavExpanded: PropTypes.Requireable<boolean>;
+        /**
+         * A component used to render an icon.
+         */
+        renderIcon: PropTypes.Validator<object>;
+    };
+};
 export default SideNavHeader;

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

@@ -1,9 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import PropTypes from 'prop-types';
 import React from 'react';
 export interface SideNavIconProps {
     /**
@@ -21,5 +22,22 @@ export interface SideNavIconProps {
      */
     small?: boolean;
 }
-declare const SideNavIcon: React.FC<SideNavIconProps>;
+declare const SideNavIcon: {
+    ({ children, className: customClassName, small, }: SideNavIconProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide a single icon as the child to `SideNavIcon` to render in the
+         * container
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the icon should be placed in a smaller bounding box
+         */
+        small: PropTypes.Requireable<boolean>;
+    };
+};
 export default SideNavIcon;

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

@@ -1,9 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import PropTypes from 'prop-types';
 import React from 'react';
 export interface SideNavItemProps {
     /**
@@ -20,5 +21,22 @@ export interface SideNavItemProps {
      */
     large?: boolean;
 }
-declare const SideNavItem: React.FC<SideNavItemProps>;
+declare const SideNavItem: {
+    ({ className: customClassName, children, large, }: SideNavItemProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide a single icon as the child to `SideNavItem` to render in the
+         * container
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify if this is a large variation of the SideNavItem
+         */
+        large: PropTypes.Requireable<boolean>;
+    };
+};
 export default SideNavItem;

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

@@ -1,9 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import PropTypes from 'prop-types';
 import React from 'react';
 export interface SideNavItemsProps {
     /**
@@ -21,5 +22,24 @@ export interface SideNavItemsProps {
      */
     isSideNavExpanded?: boolean;
 }
-declare const SideNavItems: React.FC<SideNavItemsProps>;
+declare const SideNavItems: {
+    ({ className: customClassName, children, isSideNavExpanded, }: SideNavItemsProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+    propTypes: {
+        /**
+         * Provide a single icon as the child to `SideNavIcon` to render in the
+         * container
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Provide an optional class to be applied to the containing node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Property to indicate if the side nav container is open (or not). Use to
+         * keep local state and styling in step with the SideNav expansion state.
+         */
+        isSideNavExpanded: PropTypes.Requireable<boolean>;
+    };
+};
 export default SideNavItems;

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

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * 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/SideNavLink.js

@@ -22,16 +22,18 @@ var SideNav = require('./SideNav.js');
 
 // First define a non-generic base component to work with forwardRef
 
-const SideNavLinkBase = ({
-  children,
-  className: customClassName,
-  renderIcon: IconElement,
-  isActive,
-  isSideNavExpanded,
-  large = false,
-  tabIndex,
-  ...rest
-}, ref) => {
+const frFn = React.forwardRef;
+const SideNavLink = frFn((props, ref) => {
+  const {
+    children,
+    className: customClassName,
+    renderIcon: IconElement,
+    isActive,
+    isSideNavExpanded,
+    large = false,
+    tabIndex,
+    ...rest
+  } = props;
   const isRail = React.useContext(SideNav.SideNavContext);
   const prefix = usePrefix.usePrefix();
   const className = cx({
@@ -48,10 +50,8 @@ const SideNavLinkBase = ({
   }), IconElement && /*#__PURE__*/React.createElement(SideNavIcon.default, {
     small: true
   }, /*#__PURE__*/React.createElement(IconElement, null)), /*#__PURE__*/React.createElement(SideNavLinkText.default, null, children)));
-};
-
-// Use forwardRef with the non-generic function and cast to the generic component type
-const SideNavLink = /*#__PURE__*/React.forwardRef(SideNavLinkBase);
+  // Cast preserves the generic call signature for consumers after forwardRef.
+});
 SideNavLink.displayName = 'SideNavLink';
 SideNavLink.propTypes = {
   ...Link.LinkPropTypes,

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

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * 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/SideNavMenuItem.d.ts

@@ -1,10 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React, { ElementType, ComponentProps } from 'react';
+import React, { type ComponentProps, type ElementType } from 'react';
 import Link from './Link';
 export type SideNavMenuItemProps = ComponentProps<typeof Link> & {
     /**

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

@@ -4,12 +4,20 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React from 'react';
+import PropTypes from 'prop-types';
 export interface SwitcherDividerProps {
     /**
      * Optionally provide a custom class to apply to the underlying `<li>` node
      */
     className?: string;
 }
-declare const SwitcherDivider: React.FC<SwitcherDividerProps>;
+declare const SwitcherDivider: {
+    ({ className: customClassName, ...other }: SwitcherDividerProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Optionally provide a custom class to apply to the underlying `<li>` node
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default SwitcherDivider;

package/lib/internal/FloatingMenu.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * 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/internal/FloatingMenu.js

@@ -174,8 +174,6 @@ const FloatingMenu = ({
       // Re-check after setting the position if not already adjusting.
       if (!isAdjustment) {
         const newMenuSize = menuBody.getBoundingClientRect();
-        // TODO: Was there a bug in the old code? How could one `DOMRect` be
-        // compared to another using `!==`?
         if (newMenuSize.width !== menuSize.width || newMenuSize.height !== menuSize.height) {
           updateMenuPosition(true);
         }

package/lib/internal/PolymorphicProps.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2025
+ * Copyright IBM Corp. 2025, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -8,9 +8,9 @@ type AsProp<C extends React.ElementType> = {
     as?: C;
 };
 type PropsToOmit<C extends React.ElementType, P> = keyof (AsProp<C> & P);
-export type PolymorphicComponentProp<C extends React.ElementType, Props = {}> = React.PropsWithChildren<Props & AsProp<C>> & Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
+export type PolymorphicComponentProp<C extends React.ElementType, Props = Record<string, never>> = React.PropsWithChildren<Props & AsProp<C>> & Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
 export type PolymorphicRef<C extends React.ElementType> = React.ComponentPropsWithRef<C>['ref'];
-export type PolymorphicComponentPropWithRef<C extends React.ElementType, Props = {}> = PolymorphicComponentProp<C, Props> & {
+export type PolymorphicComponentPropWithRef<C extends React.ElementType, Props = Record<string, never>> = PolymorphicComponentProp<C, Props> & {
     ref?: PolymorphicRef<C>;
 };
 export {};

package/lib/internal/useNoInteractiveChildren.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * 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/internal/useNoInteractiveChildren.js

@@ -10,13 +10,12 @@
 var React = require('react');
 
 const useNoInteractiveChildren = (ref, message = 'component should have no interactive child nodes') => {
-  // TODO: Why can't the condition go inside the hook?
   if (process.env.NODE_ENV !== 'production') {
-    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
-    /*
+    // This hook is intentionally called conditionally because it is
+    // stripped from production builds. In development it runs once
+    // to enforce accessibility constraints.
+    //
     // eslint-disable-next-line react-hooks/rules-of-hooks
-    */
-    // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node) {
@@ -30,13 +29,12 @@ const useNoInteractiveChildren = (ref, message = 'component should have no inter
   }
 };
 const useInteractiveChildrenNeedDescription = (ref, message = `interactive child node(s) should have an \`aria-describedby\` property`) => {
-  // TODO: Why can't the condition go inside the hook?
   if (process.env.NODE_ENV !== 'production') {
-    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
-    /*
+    // This hook is intentionally called conditionally because it is
+    // stripped from production builds. In development it runs once
+    // to enforce accessibility constraints.
+    //
     // eslint-disable-next-line react-hooks/rules-of-hooks
-    */
-    // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node && !node.hasAttribute('aria-describedby')) {

package/lib/internal/useOutsideClick.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * 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/internal/useOutsideClick.js

@@ -21,11 +21,7 @@ const useOutsideClick = (ref, callback) => {
   // treated as a constant as it will be false when executed in a Node.js
   // environment and true when executed in the browser
   if (environment.canUseDOM) {
-    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
-    /*
     // eslint-disable-next-line react-hooks/rules-of-hooks
-    */
-    // eslint-disable-next-line  react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
     useEvent.useWindowEvent('click', event => {
       const {
         target

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/react",
   "description": "React components for the Carbon Design System",
-  "version": "1.99.0",
+  "version": "1.100.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -53,10 +53,10 @@
   "dependencies": {
     "@babel/runtime": "^7.27.3",
     "@carbon/feature-flags": ">=0.32.0",
-    "@carbon/icons-react": "^11.73.0",
-    "@carbon/layout": "^11.46.0",
-    "@carbon/styles": "^1.98.0",
-    "@carbon/utilities": "^0.14.0",
+    "@carbon/icons-react": "^11.74.0",
+    "@carbon/layout": "^11.47.0",
+    "@carbon/styles": "^1.99.0",
+    "@carbon/utilities": "^0.15.0",
     "@floating-ui/react": "^0.27.4",
     "@ibm/telemetry-js": "^1.5.0",
     "classnames": "2.5.1",
@@ -79,7 +79,7 @@
     "@babel/preset-react": "^7.27.1",
     "@babel/preset-typescript": "^7.27.1",
     "@carbon/test-utils": "^10.39.0",
-    "@carbon/themes": "^11.66.0",
+    "@carbon/themes": "^11.67.0",
     "@figma/code-connect": "^1.3.5",
     "@rollup/plugin-babel": "^6.0.0",
     "@rollup/plugin-commonjs": "^28.0.3",
@@ -131,5 +131,5 @@
     "**/*.scss",
     "**/*.css"
   ],
-  "gitHead": "ce7846aab8a3a1afe9b03d2d07d267af6cdb6ac2"
+  "gitHead": "f366448449df3d81c9bb63a8a842772d734c163a"
 }

package/scss/_carbon-utilities.scss

@@ -0,0 +1,9 @@
+// Code generated by @carbon/react. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 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.
+//
+
+@forward '@carbon/styles/scss/carbon-utilities';

package/telemetry.yml

@@ -531,7 +531,6 @@ collect:
         - textSize
         # SideNav
         - addMouseListeners
-        - inert
         - isChildOfHeader
         - isFixedNav
         - isPersistent

package/es/internal/createClassWrapper.d.ts

@@ -1,12 +0,0 @@
-/**
- * Copyright IBM Corp. 2016, 2025
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-import { type ComponentClass, type ForwardRefExoticComponent, type FunctionComponent, type PropsWithChildren } from 'react';
-/**
- * Wrap a class component with a functional component. This prevents an end-user
- * from being able to pass `ref` and access the underlying class instance.
- */
-export declare const createClassWrapper: <Props extends PropsWithChildren>(Component: ComponentClass<Props> | ForwardRefExoticComponent<Props>) => FunctionComponent<Props>;

package/lib/internal/createClassWrapper.d.ts

@@ -1,12 +0,0 @@
-/**
- * Copyright IBM Corp. 2016, 2025
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-import { type ComponentClass, type ForwardRefExoticComponent, type FunctionComponent, type PropsWithChildren } from 'react';
-/**
- * Wrap a class component with a functional component. This prevents an end-user
- * from being able to pass `ref` and access the underlying class instance.
- */
-export declare const createClassWrapper: <Props extends PropsWithChildren>(Component: ComponentClass<Props> | ForwardRefExoticComponent<Props>) => FunctionComponent<Props>;