@telus-uds/components-base 3.23.0 → 3.25.0

package/lib/cjs/Shortcuts/Shortcuts.js

@@ -0,0 +1,169 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+var _systemConstants = require("@telus-uds/system-constants");
+var _ThemeProvider = require("../ThemeProvider");
+var _ViewportProvider = require("../ViewportProvider");
+var _utils = require("../utils");
+var _HorizontalScroll = _interopRequireWildcard(require("../HorizontalScroll"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.viewProps]);
+const {
+  selectHorizontalScrollTokens,
+  useItemPositions
+} = _HorizontalScroll.horizontalScrollUtils;
+const selectStyles = (themeTokens, maxWidth, viewport) => {
+  const isDesktop = viewport === _systemConstants.viewports.md || viewport === _systemConstants.viewports.lg || viewport === _systemConstants.viewports.xl;
+  return {
+    wrapper: {
+      alignItems: isDesktop ? 'center' : 'flex-start'
+    },
+    scrollContainer: {
+      width: '100%',
+      ...(isDesktop && {
+        maxWidth
+      })
+    },
+    container: {
+      paddingTop: themeTokens.mainContainerTopPadding,
+      paddingBottom: themeTokens.mainContainerBottomPadding,
+      paddingLeft: themeTokens.mainContainerLeftPadding,
+      paddingRight: themeTokens.mainContainerRightPadding,
+      gap: themeTokens.mainContainerGap,
+      ...(isDesktop && {
+        alignItems: 'flex-start',
+        justifyContent: 'center'
+      })
+    }
+  };
+};
+
+/**
+ * A horizontal scrollable shortcuts component that displays a collection of shortcut items.
+ * This component automatically injects shared configuration props to all ShortcutsItem children
+ * via React.cloneElement, including variant settings, hideLabels, and iconVariant.
+ *
+ * @component
+ * @param {Object} props - Component properties
+ * @param {Object} [props.tokens] - Theme tokens to customize the component's appearance
+ * @param {Object} [props.variant] - Visual variant configuration for the shortcuts container and its items
+ * @param {string} [props.variant.width] - Width variant to apply to all items (e.g., 'equal', 'dynamic')
+ * @param {Object} [props.scrollButtonTokens] - Tokens to customize scroll button appearance
+ * @param {boolean} [props.hideLabels=false] - Whether to hide labels on all shortcut items (can be overridden per item)
+ * @param {Object} [props.iconVariant] - Icon variant to apply to all shortcut items (can be overridden per item)
+ * @param {React.ReactNode} props.children - ShortcutsItem components to render
+ * @param {React.Ref} ref - Forwarded ref to the component's root element
+ * @returns {React.ReactElement} Rendered shortcuts component with horizontal scroll functionality
+ *
+ * @example
+ * <Shortcuts hideLabels={false} variant={{ width: 'equal' }}>
+ *   <ShortcutsItem icon={HomeIcon} label="Home" href="/home" />
+ *   <ShortcutsItem icon={SettingsIcon} label="Settings" href="/settings" />
+ * </Shortcuts>
+ *
+ * @example
+ * // Item-level props override container props
+ * <Shortcuts hideLabels iconVariant={{ size: 'small' }}>
+ *   <ShortcutsItem icon={HomeIcon} label="Home" hideLabel={false} />
+ *   <ShortcutsItem icon={SettingsIcon} label="Settings" />
+ * </Shortcuts>
+ */
+const Shortcuts = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
+  let {
+    tokens,
+    variant,
+    scrollButtonTokens,
+    hideLabels = false,
+    iconVariant,
+    children,
+    ...rest
+  } = _ref;
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Shortcuts', tokens, variant, {
+    viewport
+  });
+  const {
+    themeOptions
+  } = (0, _ThemeProvider.useTheme)();
+  const maxWidth = (0, _utils.useResponsiveProp)(themeOptions?.contentMaxWidth, _systemConstants.viewports.map.get(_systemConstants.viewports.xl));
+  const [itemPositions] = useItemPositions();
+  const [maxItemWidth, setMaxItemWidth] = _react.default.useState(null);
+  const registerWidth = _react.default.useCallback(width => setMaxItemWidth(prev => prev == null || width > prev ? width : prev), []);
+  const styles = selectStyles(themeTokens, maxWidth, viewport);
+  const childrenWithProps = _react.default.Children.map(children, child => {
+    if (! /*#__PURE__*/_react.default.isValidElement(child)) {
+      return child;
+    }
+    return /*#__PURE__*/_react.default.cloneElement(child, {
+      maxWidth: maxItemWidth,
+      registerWidth,
+      containerVariant: variant,
+      containerHideLabels: hideLabels,
+      containerIconVariant: iconVariant
+    });
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+    style: [staticStyles.wrapper, styles.wrapper],
+    ref: ref,
+    ...selectProps(rest),
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+      style: styles.scrollContainer,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_HorizontalScroll.default, {
+        ScrollButton: _HorizontalScroll.HorizontalScrollButton,
+        itemPositions: itemPositions,
+        tokens: selectHorizontalScrollTokens(themeTokens),
+        scrollButtonTokens: scrollButtonTokens,
+        variant: {
+          hideNavigationButtons: _Platform.default.OS !== 'web'
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: [staticStyles.container, styles.container],
+          children: childrenWithProps
+        })
+      })
+    })
+  });
+});
+Shortcuts.displayName = 'Shortcuts';
+Shortcuts.propTypes = {
+  ...selectedSystemPropTypes,
+  tokens: (0, _utils.getTokensPropType)('Shortcuts'),
+  variant: _utils.variantProp.propType,
+  /**
+   * Custom tokens for `HorizontalScrollButton`
+   */
+  scrollButtonTokens: (0, _utils.getTokensPropType)('HorizontalScrollButton'),
+  /**
+   * Hide labels for all ShortcutsItem children. When true, labels are visually hidden but remain accessible to screen readers via the icon's accessibilityLabel.
+   */
+  hideLabels: _propTypes.default.bool,
+  /**
+   * Icon variant to apply to all ShortcutsItem children.
+   */
+  iconVariant: _utils.variantProp.propType,
+  /**
+   * ShortcutsItem components to be rendered within the Shortcuts container
+   */
+  children: _propTypes.default.node
+};
+const staticStyles = _StyleSheet.default.create({
+  wrapper: {
+    flexGrow: 1
+  },
+  container: {
+    flexDirection: 'row',
+    flex: 1
+  }
+});
+var _default = exports.default = Shortcuts;

package/lib/cjs/Shortcuts/ShortcutsItem.js

@@ -0,0 +1,280 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _Image = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Image"));
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+var _Pressable = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Pressable"));
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _ThemeProvider = require("../ThemeProvider");
+var _utils = require("../utils");
+var _Icon = _interopRequireDefault(require("../Icon"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const DYNAMIC_WIDTH_VARIANT = 'dynamic';
+const EQUAL_WIDTH_VARIANT = 'equal';
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.linkProps, _utils.viewProps]);
+const selectPressableStyles = (tokens, widthVariant, equalWidth) => {
+  const styles = {
+    borderColor: tokens.borderColor,
+    borderRadius: tokens.borderRadius,
+    borderWidth: tokens.borderWidth,
+    ..._Platform.default.select({
+      web: {
+        outline: 'none'
+      }
+    })
+  };
+  if (widthVariant === DYNAMIC_WIDTH_VARIANT) {
+    styles.width = 'auto';
+  } else if (widthVariant === EQUAL_WIDTH_VARIANT) {
+    if (equalWidth) {
+      styles.width = equalWidth;
+    } else {
+      styles.minWidth = tokens.width;
+    }
+  } else {
+    styles.width = tokens.width;
+  }
+  return styles;
+};
+const selectIconContainerStyles = tokens => ({
+  paddingBottom: tokens.iconContainerPaddingBottom,
+  paddingLeft: tokens.iconContainerPaddingLeft,
+  paddingRight: tokens.iconContainerPaddingRight,
+  paddingTop: tokens.iconContainerPaddingTop
+});
+const selectIconVariant = () => ({
+  background: true,
+  padding: 'medium'
+});
+const selectIconTokens = tokens => ({
+  backgroundColor: tokens.iconBackgroundColor,
+  color: tokens.iconColor,
+  size: tokens.iconSize,
+  width: tokens.iconWidth
+});
+const selectImageStyles = tokens => ({
+  width: tokens.imageWidth,
+  height: tokens.imageHeight
+});
+const selectLabelContainerStyles = tokens => ({
+  paddingBottom: tokens.labelContainerPaddingBottom,
+  paddingLeft: tokens.labelContainerPaddingLeft,
+  paddingRight: tokens.labelContainerPaddingRight,
+  paddingTop: tokens.labelContainerPaddingTop
+});
+const selectTitleTextStyles = tokens => (0, _ThemeProvider.applyTextStyles)({
+  fontColor: tokens.labelFontColor,
+  fontName: tokens.labelFontName,
+  fontSize: tokens.labelFontSize,
+  fontWeight: tokens.labelFontWeight,
+  lineHeight: tokens.labelLineHeight,
+  textDecorationLine: tokens.labelUnderline,
+  textAlign: tokens.labelTextAlign
+});
+
+/**
+ * A clickable shortcut item component that displays an icon or image with an optional label.
+ * Can be used within a Shortcuts container to create a grid of navigation shortcuts.
+ *
+ * @component
+ * @param {Object} props - Component props
+ * @param {string} [props.icon] - Icon identifier to display
+ * @param {Object} [props.image={ src: '', alt: '' }] - Image object with src and alt properties
+ * @param {string} [props.image.src] - Image source URL
+ * @param {string} [props.image.alt] - Image alt text for accessibility
+ * @param {string|React.ReactNode} props.label - Label text or content to display below the icon/image
+ * @param {boolean} [props.hideLabel=false] - Whether to hide the label for this specific item
+ * @param {string} [props.href] - Link URL for navigation
+ * @param {Object} [props.iconVariant] - Icon variant to apply to this specific item
+ * @param {Object} [props.tokens] - Theme tokens to customize appearance
+ * @param {Object} [props.variant] - Variant configuration object for this specific item
+ * @param {string} [props.variant.width] - Width variant (e.g., 'dynamic', 'equal')
+ * @param {Function} [props.onPressableStateChange] - Callback function that receives the pressable state object (pressed, hovered, focused)
+ * @param {number} [props.maxWidth] - Maximum width for equal width variant (injected by Shortcuts container)
+ * @param {Function} [props.registerWidth] - Callback to register width for equal width variant (injected by Shortcuts container)
+ * @param {Object} [props.containerVariant] - Variant configuration from Shortcuts container (injected by Shortcuts container)
+ * @param {boolean} [props.containerHideLabels] - Hide labels setting from Shortcuts container (injected by Shortcuts container)
+ * @param {Object} [props.containerIconVariant] - Icon variant from Shortcuts container (injected by Shortcuts container)
+ * @param {React.Ref} ref - Forwarded ref to the Pressable component
+ * @returns {React.ReactElement} The rendered shortcut item
+ *
+ * @example
+ * <ShortcutsItem
+ *   icon={HomeIcon}
+ *   label="Home"
+ *   href="/home"
+ *   onPressableStateChange={(state) => console.log(state)}
+ * />
+ */
+const ShortcutsItem = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
+  let {
+    icon,
+    image = {
+      src: '',
+      alt: ''
+    },
+    label,
+    hideLabel = false,
+    href,
+    iconVariant,
+    tokens,
+    variant,
+    onPressableStateChange,
+    maxWidth,
+    registerWidth,
+    containerVariant,
+    containerHideLabels,
+    containerIconVariant,
+    ...rest
+  } = _ref;
+  const mergedVariant = {
+    ...containerVariant,
+    ...variant
+  };
+  const widthVariant = mergedVariant?.width;
+  const shouldHideLabel = hideLabel || containerHideLabels;
+  const mergedIconVariant = iconVariant ?? containerIconVariant;
+  const getThemeTokens = (0, _ThemeProvider.useThemeTokensCallback)('ShortcutsItem', tokens, mergedVariant);
+  const getTokens = pressableState => getThemeTokens((0, _utils.resolvePressableState)(pressableState));
+  const {
+    onPress,
+    ...props
+  } = _utils.clickProps.toPressProps(rest);
+  const {
+    hrefAttrs,
+    rawRest
+  } = _utils.hrefAttrsProp.bundle(props);
+  const selectedProps = selectProps({
+    href,
+    onPress: _utils.linkProps.handleHref({
+      href,
+      onPress
+    }),
+    hrefAttrs,
+    ...rawRest
+  });
+  const handleLayout = event => {
+    if (widthVariant === EQUAL_WIDTH_VARIANT && registerWidth) {
+      const {
+        width
+      } = event.nativeEvent.layout;
+      registerWidth(width);
+    }
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+    ref: ref,
+    style: pressableState => selectPressableStyles(getTokens(pressableState), widthVariant, maxWidth),
+    onLayout: handleLayout,
+    ...selectedProps,
+    children: pressableState => {
+      const themeTokens = getTokens(pressableState);
+      if (onPressableStateChange) {
+        onPressableStateChange((0, _utils.resolvePressableState)(pressableState));
+      }
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+        style: staticStyles.container,
+        children: [icon && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: selectIconContainerStyles(themeTokens),
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Icon.default, {
+            icon: icon,
+            variant: mergedIconVariant ?? selectIconVariant(),
+            tokens: mergedIconVariant ? {} : selectIconTokens(themeTokens),
+            ...(_Platform.default.OS === 'web' && {
+              accessibilityLabel: label
+            })
+          })
+        }), !icon && image && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Image.default, {
+          source: image.src,
+          alt: image.alt,
+          style: selectImageStyles(themeTokens),
+          resizeMethod: "resize",
+          accessibilityIgnoresInvertColors: true
+        }), label && !shouldHideLabel && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: [staticStyles.label, selectLabelContainerStyles(themeTokens)],
+          children: (0, _utils.wrapStringsInText)(label, {
+            style: selectTitleTextStyles(themeTokens)
+          })
+        })]
+      });
+    }
+  });
+});
+ShortcutsItem.displayName = 'ShortcutsItem';
+ShortcutsItem.propTypes = {
+  ...selectedSystemPropTypes,
+  tokens: (0, _utils.getTokensPropType)('ShortcutsItem'),
+  variant: _utils.variantProp.propType,
+  /**
+   * Icon for the ShortcutsItem
+   */
+  icon: _propTypes.default.elementType,
+  /**
+   * Image for the ShortcutsItem
+   */
+  image: _propTypes.default.shape({
+    src: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number, _propTypes.default.object]),
+    alt: _propTypes.default.string
+  }),
+  /**
+   * Label for the ShortcutsItem
+   */
+  label: _propTypes.default.string,
+  /**
+   * Hide the label for this specific ShortcutsItem. When true, the label is visually hidden but remains accessible to screen readers via the icon's accessibilityLabel.
+   */
+  hideLabel: _propTypes.default.bool,
+  /**
+   * href for the ShortcutsItem
+   */
+  href: _propTypes.default.string,
+  /**
+   * Icon variant for this specific ShortcutsItem
+   */
+  iconVariant: _utils.variantProp.propType,
+  /**
+   * Callback function that receives the pressable state object containing pressed, hovered, and focused boolean properties
+   */
+  onPressableStateChange: _propTypes.default.func,
+  /**
+   * Maximum width for equal width variant (automatically injected by Shortcuts container)
+   * @private
+   */
+  maxWidth: _propTypes.default.number,
+  /**
+   * Callback to register width for equal width variant (automatically injected by Shortcuts container)
+   * @private
+   */
+  registerWidth: _propTypes.default.func,
+  /**
+   * Variant configuration from Shortcuts container (automatically injected by Shortcuts container)
+   * @private
+   */
+  containerVariant: _utils.variantProp.propType,
+  /**
+   * Hide labels setting from Shortcuts container (automatically injected by Shortcuts container)
+   * @private
+   */
+  containerHideLabels: _propTypes.default.bool,
+  /**
+   * Icon variant from Shortcuts container (automatically injected by Shortcuts container)
+   * @private
+   */
+  containerIconVariant: _utils.variantProp.propType
+};
+const staticStyles = _StyleSheet.default.create({
+  container: {
+    alignItems: 'center',
+    justifyContent: 'center'
+  },
+  label: {
+    flexWrap: 'wrap'
+  }
+});
+var _default = exports.default = ShortcutsItem;

package/lib/cjs/Shortcuts/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ShortcutsItem", {
+  enumerable: true,
+  get: function () {
+    return _ShortcutsItem.default;
+  }
+});
+exports.default = void 0;
+var _Shortcuts = _interopRequireDefault(require("./Shortcuts"));
+var _ShortcutsItem = _interopRequireDefault(require("./ShortcutsItem"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+var _default = exports.default = _Shortcuts.default;

package/lib/cjs/TextInput/TextInputBase.js

@@ -332,7 +332,7 @@ const TextInputBase = /*#__PURE__*/_react.default.forwardRef((_ref8, ref) => {
       icon: ClearButtonIcon,
       onPress: handleClear,
       variant: {
-        compact: true
+        subtle: true
       }
     }, "clear"));
   }
@@ -342,8 +342,7 @@ const TextInputBase = /*#__PURE__*/_react.default.forwardRef((_ref8, ref) => {
       icon: !showPassword ? passwordShowButtonIcon : passwordHideButtonIcon,
       onPress: handleShowOrHide,
       variant: {
-        compact: true,
-        password: true,
+        subtle: true,
         inactive: variant.inactive,
         size: 'large'
       },

package/lib/cjs/Tooltip/Tooltip.native.js

@@ -169,6 +169,7 @@ const Tooltip = /*#__PURE__*/_react.default.forwardRef((_ref7, ref) => {
     nativeID,
     activateOnHover = false,
     tooltipButtonTokens,
+    testID,
     ...rest
   } = _ref7;
   const [isOpen, setIsOpen] = _react.default.useState(false);
@@ -312,6 +313,7 @@ const Tooltip = /*#__PURE__*/_react.default.forwardRef((_ref7, ref) => {
         display: inline ? 'inline-block' : 'flex'
       }
     })],
+    testID: testID,
     ...selectProps(rest),
     children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
       onPress: toggleIsOpen,

package/lib/cjs/index.js

@@ -59,6 +59,8 @@ var _exportNames = {
   Responsive: true,
   Search: true,
   Select: true,
+  Shortcuts: true,
+  ShortcutsItem: true,
   SideNav: true,
   Skeleton: true,
   SkipLink: true,
@@ -432,6 +434,18 @@ Object.defineProperty(exports, "Select", {
     return _Select.default;
   }
 });
+Object.defineProperty(exports, "Shortcuts", {
+  enumerable: true,
+  get: function () {
+    return _Shortcuts.default;
+  }
+});
+Object.defineProperty(exports, "ShortcutsItem", {
+  enumerable: true,
+  get: function () {
+    return _Shortcuts.ShortcutsItem;
+  }
+});
 Object.defineProperty(exports, "SideNav", {
   enumerable: true,
   get: function () {
@@ -744,6 +758,7 @@ var _RadioCard = _interopRequireWildcard(require("./RadioCard"));
 var _Responsive = _interopRequireDefault(require("./Responsive"));
 var _Search = _interopRequireDefault(require("./Search"));
 var _Select = _interopRequireDefault(require("./Select"));
+var _Shortcuts = _interopRequireWildcard(require("./Shortcuts"));
 var _SideNav = _interopRequireDefault(require("./SideNav"));
 var _Skeleton = _interopRequireDefault(require("./Skeleton"));
 var _SkipLink = _interopRequireDefault(require("./SkipLink"));

package/lib/cjs/utils/index.js

@@ -23,7 +23,8 @@ var _exportNames = {
   formatImageSource: true,
   getSpacingScale: true,
   useVariants: true,
-  isTouchDevice: true
+  isTouchDevice: true,
+  resolveContentMaxWidth: true
 };
 Object.defineProperty(exports, "BaseView", {
   enumerable: true,
@@ -73,6 +74,12 @@ Object.defineProperty(exports, "isTouchDevice", {
     return _isTouchDevice.default;
   }
 });
+Object.defineProperty(exports, "resolveContentMaxWidth", {
+  enumerable: true,
+  get: function () {
+    return _resolveContentMaxWidth.default;
+  }
+});
 Object.defineProperty(exports, "transformGradient", {
   enumerable: true,
   get: function () {
@@ -272,6 +279,7 @@ var _formatImageSource = _interopRequireDefault(require("./formatImageSource"));
 var _getSpacingScale = _interopRequireDefault(require("./getSpacingScale"));
 var _useVariants = _interopRequireDefault(require("./useVariants"));
 var _isTouchDevice = _interopRequireDefault(require("./isTouchDevice"));
+var _resolveContentMaxWidth = _interopRequireDefault(require("./resolveContentMaxWidth"));
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/lib/cjs/utils/resolveContentMaxWidth.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+const CONTENT_MAX_WIDTH = 'max';
+const CONTENT_FULL_WIDTH = 'full';
+
+/**
+ * Resolves the maximum width for content based on the provided value and responsive width.
+ *
+ * @param {number|string|null|undefined} contentMaxWidthValue - The maximum width value for the content.
+ * Can be a number, a special string constant (e.g., CONTENT_FULL_WIDTH, CONTENT_MAX_WIDTH), or null/undefined.
+ * @param {number} responsiveWidth - The responsive width to use when contentMaxWidthValue is CONTENT_MAX_WIDTH.
+ * @returns {number|string|null} The resolved maximum width value, or null if full width is desired.
+ */
+const resolveContentMaxWidth = (contentMaxWidthValue, responsiveWidth) => {
+  if (!contentMaxWidthValue || contentMaxWidthValue === CONTENT_FULL_WIDTH) {
+    return null;
+  }
+  if (Number.isFinite(contentMaxWidthValue)) {
+    return contentMaxWidthValue;
+  }
+  if (contentMaxWidthValue === CONTENT_MAX_WIDTH) {
+    return responsiveWidth;
+  }
+  return contentMaxWidthValue;
+};
+var _default = exports.default = resolveContentMaxWidth;

package/lib/esm/Button/ButtonGroup.js

@@ -129,6 +129,7 @@ const ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
           id = label,
           accessibilityLabel,
           ref: itemRef,
+          inactive: itemInactive,
           ...itemRest
         } = _ref2;
         const isSelected = currentValues.includes(id);
@@ -152,6 +153,7 @@ const ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
           accessibilityLabel,
           ...a11yProps.getPositionInSet(items.length, index)
         };
+        const isInactive = itemInactive !== undefined ? itemInactive : inactive;
 
         // Ensure button is direct child of group as MacOS voiceover only applies "X of Y" to
         // "radio" if it's a direct child of "radiogroup", even if aria-posinset etc exists
@@ -162,7 +164,7 @@ const ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
           onPress: handlePress,
           tokens: getButtonTokens,
           selected: isSelected,
-          inactive: inactive,
+          inactive: isInactive,
           icon: iconProp,
           ...selectItemProps({
             ...itemRest,
@@ -216,7 +218,12 @@ ButtonGroup.propTypes = {
     /**
      * An optional ref for one individual button in the ButtonGroup
      */
-    ref: ABBPropTypes.ref()
+    ref: ABBPropTypes.ref(),
+    /**
+     * If true, this individual button cannot be interacted with. Takes precedence
+     * over the group-level `inactive` prop. Useful for disabling specific options.
+     */
+    inactive: PropTypes.bool
   })),
   /**
    * If provided, this function is called when the current selection is changed