@carbon/react 1.81.0-rc.0 → 1.82.0-rc.0

package/lib/components/Popover/index.js

@@ -18,7 +18,7 @@ var useIsomorphicEffect = require('../../internal/useIsomorphicEffect.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var useEvent = require('../../internal/useEvent.js');
-var createPropAdapter = require('../../tools/createPropAdapter.js');
+var mapPopoverAlign = require('../../tools/mapPopoverAlign.js');
 var react = require('@floating-ui/react');
 var index = require('../FeatureFlags/index.js');
 
@@ -43,19 +43,6 @@ const PopoverContext = /*#__PURE__*/React__default["default"].createContext({
  * @deprecated Use NewPopoverAlignment instead.
  */
 
-const propMappingFunction = deprecatedValue => {
-  const mapping = {
-    'top-left': 'top-start',
-    'top-right': 'top-end',
-    'bottom-left': 'bottom-start',
-    'bottom-right': 'bottom-end',
-    'left-bottom': 'left-end',
-    'left-top': 'left-start',
-    'right-bottom': 'right-end',
-    'right-top': 'right-start'
-  };
-  return mapping[deprecatedValue];
-};
 const Popover = /*#__PURE__*/React__default["default"].forwardRef(function PopoverRenderFunction(_ref,
 //this is a workaround, have to come back and fix this.
 forwardRef) {
@@ -80,7 +67,7 @@ forwardRef) {
   const caretRef = React.useRef(null);
   const popover = React.useRef(null);
   const enableFloatingStyles = index.useFeatureFlag('enable-v12-dynamic-floating-styles') || autoAlign;
-  let align = createPropAdapter.mapPopoverAlignProp(initialAlign);
+  let align = mapPopoverAlign.mapPopoverAlign(initialAlign);
 
   // If the `Popover` is the last focusable item in the tab order, it should also close when the browser window loses focus  (#12922)
   useEvent.useWindowEvent('blur', () => {
@@ -147,7 +134,7 @@ forwardRef) {
       alignmentAxis: alignmentAxisOffset,
       mainAxis: popoverDimensions?.current?.offset
     } : 0), autoAlign && react.flip({
-      fallbackPlacements: align.includes('bottom') ? ['bottom', 'bottom-start', 'bottom-end', 'right', 'right-start', 'right-end', 'left', 'left-start', 'left-end', 'top', 'top-start', 'top-end'] : ['top', 'top-start', 'top-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end', 'bottom', 'bottom-start', 'bottom-end'],
+      fallbackPlacements: isTabTip ? align.includes('bottom') ? ['bottom-start', 'bottom-end', 'top-start', 'top-end'] : ['top-start', 'top-end', 'bottom-start', 'bottom-end'] : align.includes('bottom') ? ['bottom', 'bottom-start', 'bottom-end', 'right', 'right-start', 'right-end', 'left', 'left-start', 'left-end', 'top', 'top-start', 'top-end'] : ['top', 'top-start', 'top-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end', 'bottom', 'bottom-start', 'bottom-end'],
       fallbackStrategy: 'initialPlacement',
       fallbackAxisSideDirection: 'start',
       boundary: autoAlignBoundary
@@ -307,11 +294,7 @@ Popover.propTypes = {
   // deprecated use right-start instead
 
   // new values to match floating-ui
-  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
-  //allowed prop values
-  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
-  //optional mapper function
-  propMappingFunction),
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']), ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'], mapPopoverAlign.mapPopoverAlign),
   /**
    * Provide a custom element or component to render the top-level node for the
    * component.

package/lib/components/Search/Search.d.ts

@@ -4,7 +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 React, { type HTMLAttributes, type ReactNode, type KeyboardEvent, type ComponentType, type FunctionComponent, type MouseEvent } from 'react';
+import React, { type ChangeEvent, type ComponentType, type FunctionComponent, type HTMLAttributes, type KeyboardEvent, type MouseEvent, type ReactNode } from 'react';
 type InputPropsBase = Omit<HTMLAttributes<HTMLInputElement>, 'onChange'>;
 export interface SearchProps extends InputPropsBase {
     /**
@@ -43,10 +43,7 @@ export interface SearchProps extends InputPropsBase {
     /**
      * Optional callback called when the search value changes.
      */
-    onChange?(e: {
-        target: HTMLInputElement;
-        type: 'change';
-    }): void;
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
     /**
      * Optional callback called when the search value is cleared.
      */

package/lib/components/Search/Search.js

@@ -23,6 +23,7 @@ var useMergedRefs = require('../../internal/useMergedRefs.js');
 var deprecate = require('../../prop-types/deprecate.js');
 require('../FluidForm/FluidForm.js');
 var FormContext = require('../FluidForm/FormContext.js');
+var noopFn = require('../../internal/noopFn.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -89,14 +90,29 @@ const Search = /*#__PURE__*/React__default["default"].forwardRef(function Search
     if (!value && inputRef.current) {
       inputRef.current.value = '';
     }
-    const inputTarget = Object.assign({}, inputRef.current, {
-      value: ''
-    });
-    const clearedEvt = {
-      target: inputTarget,
-      type: 'change'
-    };
-    onChange(clearedEvt);
+    if (inputRef.current) {
+      const inputTarget = Object.assign({}, inputRef.current, {
+        value: ''
+      });
+      const syntheticEvent = {
+        bubbles: false,
+        cancelable: false,
+        currentTarget: inputRef.current,
+        defaultPrevented: false,
+        eventPhase: 0,
+        isDefaultPrevented: () => false,
+        isPropagationStopped: () => false,
+        isTrusted: false,
+        nativeEvent: new Event('change'),
+        persist: noopFn.noopFn,
+        preventDefault: noopFn.noopFn,
+        stopPropagation: noopFn.noopFn,
+        target: inputTarget,
+        timeStamp: 0,
+        type: 'change'
+      };
+      onChange(syntheticEvent);
+    }
     onClear();
     setHasContent(false);
     inputRef.current?.focus();

package/lib/components/Stack/HStack.d.ts

@@ -1,10 +1,9 @@
 /**
- * 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 React from 'react';
 import { StackProps } from './Stack';
-declare const HStack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<React.ReactNode>>;
-export { HStack };
+export declare const HStack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLElement>>;

package/lib/components/Stack/HStack.js

@@ -17,15 +17,12 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-const HStack = /*#__PURE__*/React__default["default"].forwardRef(function HStack(_ref, ref) {
-  let {
-    children,
-    ...props
-  } = _ref;
+const HStack = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(Stack.Stack, _rollupPluginBabelHelpers["extends"]({}, props, {
     ref: ref,
     orientation: "horizontal"
-  }), children);
+  }));
 });
+HStack.propTypes = Stack.Stack.propTypes;
 
 exports.HStack = HStack;

package/lib/components/Stack/Stack.d.ts

@@ -1,5 +1,5 @@
 /**
- * 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.
@@ -7,7 +7,6 @@
 import React from 'react';
 /**
  * The steps in the spacing scale
- * @type {Array<number>}
  */
 declare const SPACING_STEPS: number[];
 export interface StackProps extends React.HTMLAttributes<HTMLElement> {
@@ -54,5 +53,5 @@ export interface StackProps extends React.HTMLAttributes<HTMLElement> {
  * - https://paste.twilio.design/layout/stack/
  * - https://github.com/Workday/canvas-kit/blob/f2f599654876700f483a1d8c5de82a41315c76f1/modules/labs-react/layout/lib/Stack.tsx
  */
-declare const Stack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<React.ReactNode>>;
-export { Stack };
+export declare const Stack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLElement>>;
+export {};

package/lib/components/Stack/Stack.js

@@ -24,13 +24,10 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 
 /**
  * The steps in the spacing scale
- * @type {Array<number>}
  */
 const SPACING_STEPS = Array.from({
   length: layout.spacing.length - 1
-}).map((_, step) => {
-  return step + 1;
-});
+}, (_, step) => step + 1);
 /**
  * The Stack component is a useful layout utility in a component-based model.
  * This allows components to not use margin and instead delegate the
@@ -48,7 +45,7 @@ const SPACING_STEPS = Array.from({
  * - https://paste.twilio.design/layout/stack/
  * - https://github.com/Workday/canvas-kit/blob/f2f599654876700f483a1d8c5de82a41315c76f1/modules/labs-react/layout/lib/Stack.tsx
  */
-const Stack = /*#__PURE__*/React__default["default"].forwardRef(function Stack(props, ref) {
+const Stack = /*#__PURE__*/React.forwardRef((props, ref) => {
   const {
     as: BaseComponent = 'div',
     children,

package/lib/components/Stack/VStack.d.ts

@@ -1,10 +1,9 @@
 /**
- * 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 React from 'react';
 import { StackProps } from './Stack';
-declare const VStack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<React.ReactNode>>;
-export { VStack };
+export declare const VStack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLElement>>;

package/lib/components/Stack/VStack.js

@@ -17,11 +17,12 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-const VStack = /*#__PURE__*/React__default["default"].forwardRef(function VStack(props, ref) {
+const VStack = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(Stack.Stack, _rollupPluginBabelHelpers["extends"]({}, props, {
     ref: ref,
     orientation: "vertical"
   }));
 });
+VStack.propTypes = Stack.Stack.propTypes;
 
 exports.VStack = VStack;

package/lib/components/Stack/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * 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.
  */
-export { HStack } from './HStack';
-export { VStack } from './VStack';
-export { Stack, type StackProps } from './Stack';
+export * from './HStack';
+export * from './Stack';
+export * from './VStack';

package/lib/components/TextArea/TextArea.js

@@ -32,10 +32,8 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
-// TODO: This type was added to prevent the formatter from changing the
-// indentation of this entire function. Delete it in a future pull request.
-
-const TextArea = /*#__PURE__*/React.forwardRef((props, forwardRef) => {
+const frFn = React.forwardRef;
+const TextArea = frFn((props, forwardRef) => {
   const {
     className,
     decorator,

package/lib/components/TimePicker/TimePicker.d.ts

@@ -1,11 +1,11 @@
 /**
- * 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 React from 'react';
-import { ForwardRefReturn, ReactAttr } from '../../types/common';
+import { ReactAttr } from '../../types/common';
 type ExcludedAttributes = 'id' | 'value';
 export interface TimePickerProps extends Omit<ReactAttr<HTMLInputElement>, ExcludedAttributes> {
     /**
@@ -99,6 +99,5 @@ export interface TimePickerProps extends Omit<ReactAttr<HTMLInputElement>, Exclu
      */
     value?: string;
 }
-export type TimePickerComponent = ForwardRefReturn<HTMLInputElement, TimePickerProps>;
-declare const TimePicker: TimePickerComponent;
+declare const TimePicker: React.ForwardRefExoticComponent<TimePickerProps & React.RefAttributes<HTMLInputElement>>;
 export default TimePicker;

package/lib/components/TimePicker/TimePicker.js

@@ -23,8 +23,9 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-const TimePicker = /*#__PURE__*/React__default["default"].forwardRef(function TimePicker(_ref, ref) {
-  let {
+const frFn = React.forwardRef;
+const TimePicker = frFn((props, ref) => {
+  const {
     children,
     className,
     disabled = false,
@@ -47,7 +48,7 @@ const TimePicker = /*#__PURE__*/React__default["default"].forwardRef(function Ti
     type = 'text',
     value,
     ...rest
-  } = _ref;
+  } = props;
   const prefix = usePrefix.usePrefix();
   const [isValue, setValue] = React__default["default"].useState(value);
   const [prevValue, setPrevValue] = React__default["default"].useState(value);

package/lib/components/TimePickerSelect/TimePickerSelect.d.ts

@@ -1,11 +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 React from 'react';
-import { ForwardRefReturn } from '../../types/common';
 export type TimePickerSelectProps = {
     /**
      * Provide the contents of your TimePickerSelect
@@ -28,6 +27,26 @@ export type TimePickerSelectProps = {
      */
     id: string;
 } & React.SelectHTMLAttributes<HTMLSelectElement> & React.InputHTMLAttributes<HTMLSelectElement>;
-type TimePickerSelectComponent = ForwardRefReturn<HTMLSelectElement, TimePickerSelectProps>;
-declare const TimePickerSelect: TimePickerSelectComponent;
+declare const TimePickerSelect: React.ForwardRefExoticComponent<{
+    /**
+     * Provide the contents of your TimePickerSelect
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the node containing the label and the select box
+     */
+    className?: string;
+    /**
+     * Optionally provide the default value of the `<select>`
+     */
+    defaultValue?: any;
+    /**
+     * Specify whether the control is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify a custom `id` for the `<select>`
+     */
+    id: string;
+} & React.SelectHTMLAttributes<HTMLSelectElement> & React.InputHTMLAttributes<HTMLSelectElement> & React.RefAttributes<HTMLSelectElement>>;
 export default TimePickerSelect;

package/lib/components/TimePickerSelect/TimePickerSelect.js

@@ -22,15 +22,16 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-const TimePickerSelect = /*#__PURE__*/React__default["default"].forwardRef(function TimePickerSelect(_ref, ref) {
-  let {
+const frFn = React.forwardRef;
+const TimePickerSelect = frFn((props, ref) => {
+  const {
     ['aria-label']: ariaLabel = 'open list of options',
     children,
     id,
     disabled = false,
     className,
     ...rest
-  } = _ref;
+  } = props;
   const prefix = usePrefix.usePrefix();
   const selectClasses = cx__default["default"]({
     [`${prefix}--select`]: true,

package/lib/components/TreeView/TreeNode.js

@@ -54,7 +54,7 @@ const TreeNode = /*#__PURE__*/React__default["default"].forwardRef((_ref, forwar
   const enableTreeviewControllable = index.useFeatureFlag('enable-treeview-controllable');
   const {
     current: id
-  } = React.useRef(nodeId || uniqueId["default"]());
+  } = React.useRef(nodeId || uniqueId.uniqueId());
   const controllableExpandedState = useControllableState.useControllableState({
     value: isExpanded,
     onChange: newValue => {
@@ -211,6 +211,18 @@ const TreeNode = /*#__PURE__*/React__default["default"].forwardRef((_ref, forwar
     }
     if (match.matches(event, [keys.Enter, keys.Space])) {
       event.preventDefault();
+      if (match.match(event, keys.Enter) && children) {
+        // Toggle expansion state for parent nodes
+        if (!enableTreeviewControllable) {
+          onToggle?.(event, {
+            id,
+            isExpanded: !expanded,
+            label,
+            value
+          });
+        }
+        setExpanded(!expanded);
+      }
       if (href) {
         currentNode.current?.click();
       }

package/lib/components/TreeView/TreeView.js

@@ -44,7 +44,7 @@ const TreeView = _ref => {
   const enableTreeviewControllable = index.useFeatureFlag('enable-treeview-controllable');
   const {
     current: treeId
-  } = React.useRef(rest.id || uniqueId["default"]());
+  } = React.useRef(rest.id || uniqueId.uniqueId());
   const prefix = usePrefix.usePrefix();
   const treeClasses = cx__default["default"](className, `${prefix}--tree`, {
     // @ts-ignore - will always be false according to prop types

package/lib/index.js

@@ -110,8 +110,8 @@ var SkeletonPlaceholder = require('./components/SkeletonPlaceholder/SkeletonPlac
 var SkeletonText = require('./components/SkeletonText/SkeletonText.js');
 var index$d = require('./components/Slider/index.js');
 var HStack = require('./components/Stack/HStack.js');
-var VStack = require('./components/Stack/VStack.js');
 var Stack = require('./components/Stack/Stack.js');
+var VStack = require('./components/Stack/VStack.js');
 var StructuredList = require('./components/StructuredList/StructuredList.js');
 var StructuredList_Skeleton = require('./components/StructuredList/StructuredList.Skeleton.js');
 var Switch = require('./components/Switch/Switch.js');
@@ -366,8 +366,8 @@ exports.SkeletonPlaceholder = SkeletonPlaceholder["default"];
 exports.SkeletonText = SkeletonText["default"];
 exports.Slider = index$d["default"];
 exports.HStack = HStack.HStack;
-exports.VStack = VStack.VStack;
 exports.Stack = Stack.Stack;
+exports.VStack = VStack.VStack;
 exports.StructuredListBody = StructuredList.StructuredListBody;
 exports.StructuredListCell = StructuredList.StructuredListCell;
 exports.StructuredListHead = StructuredList.StructuredListHead;

package/lib/internal/FloatingMenu.js

@@ -275,13 +275,17 @@ const FloatingMenu = _ref2 => {
    * Blur handler used when focus trapping is enabled.
    */
   const handleBlur = event => {
-    if (menuBodyRef.current && startSentinelRef.current && endSentinelRef.current) {
-      wrapFocus["default"]({
+    const {
+      target,
+      relatedTarget
+    } = event;
+    if (menuBodyRef.current && startSentinelRef.current && endSentinelRef.current && target instanceof HTMLElement && relatedTarget instanceof HTMLElement) {
+      wrapFocus.wrapFocus({
         bodyNode: menuBodyRef.current,
         startTrapNode: startSentinelRef.current,
         endTrapNode: endSentinelRef.current,
-        currentActiveNode: event.relatedTarget,
-        oldActiveNode: event.target
+        currentActiveNode: relatedTarget,
+        oldActiveNode: target
       });
     }
   };
@@ -290,7 +294,7 @@ const FloatingMenu = _ref2 => {
    * Keydown handler for focus wrapping when experimental focus trap is enabled.
    */
   const handleKeyDown = event => {
-    if (match.match(event, keys.Tab) && menuBodyRef.current) {
+    if (match.match(event, keys.Tab) && menuBodyRef.current && event.target instanceof HTMLElement) {
       wrapFocus.wrapFocusWithoutSentinels({
         containerNode: menuBodyRef.current,
         currentActiveNode: event.target,

package/lib/internal/environment.js

@@ -15,9 +15,16 @@ Object.defineProperty(exports, '__esModule', { value: true });
  * @see https://github.com/facebook/fbjs/blob/4d1751311d3f67af2dcce2e40df8512a23c7b9c6/packages/fbjs/src/core/ExecutionEnvironment.js#L12
  */
 const canUseDOM = !!(typeof window !== 'undefined' &&
+// TODO: `ssr-friendly` doesn't support ESLint v9.
+// https://github.com/kopiro/eslint-plugin-ssr-friendly/issues/30
+// https://github.com/carbon-design-system/carbon/issues/18991
+/*
 // eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+*/
 window.document &&
+/*
 // eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+*/
 window.document.createElement);
 
 exports.canUseDOM = canUseDOM;

package/lib/internal/keyboard/navigation.d.ts

@@ -17,16 +17,6 @@ import { KeyboardEvent } from 'react';
  *  getNextIndex(keyCodes.RIGHT, 0, 4)
  */
 export declare const getNextIndex: (key: KeyboardEvent | number | string, index: number, arrayLength: number) => number | undefined;
-/**
- * A flag `node.compareDocumentPosition(target)` returns that indicates
- * `target` is located earlier than `node` in the document or `target` contains `node`.
- */
-export declare const DOCUMENT_POSITION_BROAD_PRECEDING: number;
-/**
- * A flag `node.compareDocumentPosition(target)` returns that indicates
- * `target` is located later than `node` in the document or `node` contains `target`.
- */
-export declare const DOCUMENT_POSITION_BROAD_FOLLOWING: number;
 /**
  * CSS selector that selects major nodes that are sequentially focusable.
  */

package/lib/internal/keyboard/navigation.js

@@ -33,18 +33,6 @@ const getNextIndex = (key, index, arrayLength) => {
   return;
 };
 
-/**
- * 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;
-
-/**
- * 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;
-
 /**
  * CSS selector that selects major nodes that are sequentially focusable.
  */
@@ -65,8 +53,6 @@ const selectorFocusable = `
   iframe, object, embed, *[tabindex]:not([disabled]), *[contenteditable=true]
 `;
 
-exports.DOCUMENT_POSITION_BROAD_FOLLOWING = DOCUMENT_POSITION_BROAD_FOLLOWING;
-exports.DOCUMENT_POSITION_BROAD_PRECEDING = DOCUMENT_POSITION_BROAD_PRECEDING;
 exports.getNextIndex = getNextIndex;
 exports.selectorFocusable = selectorFocusable;
 exports.selectorTabbable = selectorTabbable;

package/lib/internal/useNoInteractiveChildren.js

@@ -14,11 +14,15 @@ var React = require('react');
 function useNoInteractiveChildren(ref) {
   let message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'component should have no interactive child nodes';
   if (process.env.NODE_ENV !== 'production') {
+    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
+    /*
     // eslint-disable-next-line react-hooks/rules-of-hooks
+    */
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node) {
         const errorMessage = `Error: ${message}.\n\nInstead found: ${node.outerHTML}`;
+        // eslint-disable-next-line no-console
         console.error(errorMessage);
         throw new Error(errorMessage);
       }
@@ -28,7 +32,10 @@ function useNoInteractiveChildren(ref) {
 function useInteractiveChildrenNeedDescription(ref) {
   let message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : `interactive child node(s) should have an \`aria-describedby\` property`;
   if (process.env.NODE_ENV !== 'production') {
+    // TODO: https://github.com/carbon-design-system/carbon/issues/19005
+    /*
     // eslint-disable-next-line react-hooks/rules-of-hooks
+    */
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
       if (node && !node.hasAttribute('aria-describedby')) {

package/lib/internal/useOutsideClick.js

@@ -23,7 +23,10 @@ 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
+    */
     useEvent.useWindowEvent('click', event => {
       const {
         target

package/lib/internal/wrapFocus.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright IBM Corp. 2020, 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.
+ */
+/**
+ * Checks whether the given node or one of its ancestors matches any of the
+ * specified floating menu selectors.
+ *
+ * @param {Node} node - A DOM node.
+ * @param {string[]} selectorsFloatingMenus - Additional CSS selectors that
+ * match floating menus.
+ * @returns {boolean} Whether the node or one of its ancestors is in a floating
+ * menu.
+ */
+export declare const elementOrParentIsFloatingMenu: (node: Node, selectorsFloatingMenus?: string[]) => boolean;
+/**
+ * Ensures the focus is kept within the given container by implementing
+ * "focus-wrap" behavior.
+ */
+export declare const wrapFocus: ({ bodyNode, startTrapNode, endTrapNode, currentActiveNode, oldActiveNode, selectorsFloatingMenus, }: {
+    /** The DOM node of the container. */
+    bodyNode: HTMLElement | null;
+    /** The start sentinel node for focus trapping. */
+    startTrapNode: HTMLElement | null;
+    /** The end sentinel node for focus trapping. */
+    endTrapNode: HTMLElement | null;
+    /** The current active node (i.e., the one with focus). */
+    currentActiveNode: HTMLElement;
+    /** The previous active node (i.e., the one that had focus before). */
+    oldActiveNode: HTMLElement;
+    /** CSS selectors for floating menus. */
+    selectorsFloatingMenus?: string[];
+}) => void;
+/**
+ * Ensures the focus is kept in the given container, implementing "focus-wrap"
+ * behavior.
+ *
+ * Note: This must be called *before* focus moves using `onKeyDown` or similar.
+ */
+export declare const wrapFocusWithoutSentinels: ({ containerNode, currentActiveNode, event, }: {
+    /** The container node within which to keep focus. */
+    containerNode: HTMLElement;
+    /** The current active node (i.e., the one with focus). */
+    currentActiveNode: HTMLElement;
+    /** The event that triggered this function. */
+    event: React.KeyboardEvent | KeyboardEvent;
+}) => void;