@telus-uds/components-base 1.16.0 → 1.18.0

package/lib/BaseProvider/HydrationContext.js

@@ -0,0 +1,74 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useHydrationContext = exports.default = exports.HydrationProvider = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+const HydrationContext = /*#__PURE__*/(0, _react.createContext)();
+const isSSR = typeof window === 'undefined';
+
+const hasWebStyleTag = () => {
+  var _document;
+
+  if (isSSR || _Platform.default.OS !== 'web' || typeof document !== 'object') {
+    return false;
+  }
+
+  return Boolean((_document = document) === null || _document === void 0 ? void 0 : _document.getElementById('react-native-stylesheet'));
+};
+/**
+ * Returns true if this render cycle is the hydration of existing SSR content.
+ *
+ * Use this when changing how content renders based on data that is instantly available
+ * during the very first client-side render or hydration, but not available on the server,
+ * to ensure no changes happen until the original SSR DOM has been hydrated.
+ */
+
+
+const useHydrationContext = () => (0, _react.useContext)(HydrationContext);
+/**
+ * Allows components and hooks to observe if SSR hydration is currently in progress
+ * and if so, to re-render with content that differs to the server when it is complete.
+ */
+
+
+exports.useHydrationContext = useHydrationContext;
+
+const HydrationProvider = _ref => {
+  let {
+    children
+  } = _ref;
+  const [hasMounted, setHasMounted] = (0, _react.useState)(false);
+  (0, _react.useEffect)(() => {
+    setHasMounted(true);
+  }, []); // If we've got a HydrationProvider inside a HydrationProvider somehow, defer to the top one
+
+  const valueFromAncestor = useHydrationContext();
+  const isHydrating = valueFromAncestor !== null && valueFromAncestor !== void 0 ? valueFromAncestor : Boolean(!hasMounted && hasWebStyleTag());
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(HydrationContext.Provider, {
+    value: isHydrating,
+    children: children
+  });
+};
+
+exports.HydrationProvider = HydrationProvider;
+HydrationProvider.propTypes = {
+  children: _propTypes.default.node
+};
+var _default = HydrationProvider;
+exports.default = _default;

package/lib/BaseProvider/index.js

@@ -9,12 +9,16 @@ var _react = _interopRequireDefault(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
+var _portal = require("@gorhom/portal");
+
 var _A11yInfoProvider = _interopRequireDefault(require("../A11yInfoProvider"));
 
 var _ViewportProvider = _interopRequireDefault(require("../ViewportProvider"));
 
 var _ThemeProvider = _interopRequireDefault(require("../ThemeProvider"));
 
+var _HydrationContext = require("./HydrationContext");
+
 var _jsxRuntime = require("react/jsx-runtime");
 
 var _ThemeProvider$propTy;
@@ -27,12 +31,16 @@ const BaseProvider = _ref => {
     children,
     themeOptions
   } = _ref;
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_A11yInfoProvider.default, {
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ViewportProvider.default, {
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ThemeProvider.default, {
-        defaultTheme: defaultTheme,
-        themeOptions: themeOptions,
-        children: children
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_HydrationContext.HydrationProvider, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_A11yInfoProvider.default, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ViewportProvider.default, {
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ThemeProvider.default, {
+          defaultTheme: defaultTheme,
+          themeOptions: themeOptions,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_portal.PortalProvider, {
+            children: children
+          })
+        })
       })
     })
   });

package/lib/Button/ButtonBase.js

@@ -195,11 +195,12 @@ const selectWebOnlyStyles = (inactive, themeTokens, _ref7) => {
 const selectItemIconTokens = _ref8 => {
   let {
     color,
+    iconColor,
     iconSize
   } = _ref8;
   return {
     size: iconSize,
-    color
+    color: iconColor || color
   };
 };
 

package/lib/List/List.js

@@ -15,8 +15,6 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 
 var _utils = require("../utils");
 
-var _ListItem = _interopRequireDefault(require("./ListItem"));
-
 var _jsxRuntime = require("react/jsx-runtime");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -26,11 +24,20 @@ function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "functio
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 
 const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.viewProps]);
+
+const isListItem = element => {
+  var _element$type, _element$type2;
+
+  const elementName = (element === null || element === void 0 ? void 0 : (_element$type = element.type) === null || _element$type === void 0 ? void 0 : _element$type.displayName) || (element === null || element === void 0 ? void 0 : (_element$type2 = element.type) === null || _element$type2 === void 0 ? void 0 : _element$type2.name); // Match our own ListItem, and also, custom list items
+
+  return Boolean(elementName.match(/Item/));
+};
 /**
  * An unordered List component has a child a ListItem that
  * allows icon, dividers and customized typography
  */
 
+
 const List = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
   let {
     children,
@@ -45,12 +52,8 @@ const List = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
   } = _ref;
 
   const items = _react.Children.map(children, (child, index) => {
-    var _child$type, _child$type2;
-
     // Pass ListItem-specific props to children (by name so teams can add their own ListItems)
-    const isListItem = componentName => Boolean(componentName === _ListItem.default.displayName);
-
-    if (isListItem(child === null || child === void 0 ? void 0 : (_child$type = child.type) === null || _child$type === void 0 ? void 0 : _child$type.displayName) || isListItem(child === null || child === void 0 ? void 0 : (_child$type2 = child.type) === null || _child$type2 === void 0 ? void 0 : _child$type2.name)) {
+    if (isListItem(child)) {
       return /*#__PURE__*/(0, _react.cloneElement)(child, {
         showDivider,
         isLastItem: index + 1 === _react.Children.count(children),
@@ -74,7 +77,7 @@ List.displayName = 'List';
 List.propTypes = { ...selectedSystemPropTypes,
   tokens: (0, _utils.getTokensPropType)('List'),
   variant: _utils.variantProp.propType,
-  children: (0, _utils.componentPropType)('ListItem'),
+  children: _propTypes.default.node,
 
   /**
    * In case it is not the last item allow display divider

package/lib/List/PressableListItemBase.js

@@ -21,9 +21,9 @@ var _utils = require("../utils");
 
 var _ListItemBase = _interopRequireDefault(require("./ListItemBase"));
 
-var _ListItemContent = _interopRequireWildcard(require("./ListItemContent"));
+var _ListItemContent = _interopRequireDefault(require("./ListItemContent"));
 
-var _ListItemMark = _interopRequireWildcard(require("./ListItemMark"));
+var _ListItemMark = _interopRequireDefault(require("./ListItemMark"));
 
 var _jsxRuntime = require("react/jsx-runtime");
 
@@ -82,9 +82,10 @@ const PressableListItemBase = /*#__PURE__*/(0, _react.forwardRef)((_ref2, ref) =
     onPress
   });
 
+  const listItemTokens = (0, _utils.selectTokens)('List', typeof tokens === 'function' ? tokens() : tokens);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ListItemBase.default, {
     ref: listItemRef,
-    tokens: tokens(),
+    tokens: listItemTokens,
     ...listItemProps,
     children: _ref3 => {
       let {
@@ -125,17 +126,12 @@ const staticStyles = _StyleSheet.default.create({
   itemContainer: {
     flexDirection: 'row',
     flex: 1
-  },
-  tokens: { ..._ListItemContent.tokenTypes,
-    ..._ListItemMark.tokenTypes
   }
 });
 
-PressableListItemBase.propTypes = {
+PressableListItemBase.propTypes = { ..._utils.withLinkRouter.propTypes,
   href: _propTypes.default.string,
   onPress: _propTypes.default.func,
-  // TODO - type this better, maybe import the subcomponent token types and run it through util
-  // eslint-disable-next-line react/forbid-prop-types
   tokens: _propTypes.default.any,
   icon: _propTypes.default.elementType,
   children: _propTypes.default.oneOfType([_propTypes.default.node, _propTypes.default.func]),

package/lib/QuickLinks/QuickLinks.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _ViewportProvider = require("../ViewportProvider");
+
+var _utils = require("../utils");
+
+var _List = _interopRequireDefault(require("../List"));
+
+var _StackWrap = _interopRequireDefault(require("../StackView/StackWrap"));
+
+var _QuickLinksCard = _interopRequireDefault(require("./QuickLinksCard"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+/**
+ * QuickLinks renders a list of interactive items. How it renders these items depends on theme options:
+ *  - If the theme returns `list` token as true, it renders an ordered list based on List
+ *  - If the theme returns `button` token as true and `list` as false, it renders a wrapping horizontal bar of buttons
+ *  - If the theme returns `card` token as true, it wraps the above with a `Card`.
+ */
+const QuickLinks = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
+  let {
+    tokens,
+    variant,
+    listTokens,
+    cardTokens,
+    children,
+    tag = 'ul',
+    ...rest
+  } = _ref;
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const {
+    dividers,
+    list,
+    card,
+    stackSpace,
+    stackGap,
+    stackJustify
+  } = (0, _ThemeProvider.useThemeTokens)('QuickLinks', tokens, variant, {
+    viewport
+  });
+  const content = list && /*#__PURE__*/(0, _jsxRuntime.jsx)(_List.default, {
+    ref: ref,
+    tokens: listTokens,
+    showDivider: dividers,
+    tag: tag,
+    ...rest,
+    children: children
+  }) || /*#__PURE__*/(0, _jsxRuntime.jsx)(_StackWrap.default, {
+    space: stackSpace,
+    gap: stackGap,
+    tokens: {
+      justifyContent: stackJustify
+    },
+    tag: tag,
+    ...rest,
+    children: children
+  });
+  return card ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_QuickLinksCard.default, {
+    tokens: cardTokens,
+    children: content
+  }) : content;
+});
+QuickLinks.displayName = 'QuickLinks';
+QuickLinks.propTypes = {
+  tokens: (0, _utils.getTokensPropType)('QuickLinks'),
+  cardTokens: (0, _utils.getTokensPropType)('Card'),
+  listTokens: (0, _utils.getTokensPropType)('QuickLinksList'),
+  tag: _propTypes.default.string,
+  variant: _utils.variantProp.propType,
+  children: _propTypes.default.node
+};
+var _default = QuickLinks;
+exports.default = _default;

package/lib/QuickLinks/QuickLinksCard.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _CardBase = _interopRequireDefault(require("../Card/CardBase"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Private subcomponent for use within QuickLinks.
+ *
+ * Restyled Card with identical behaviour to Card, but themed according to the
+ * QuickLinksCard theme rather than the Card theme.
+ */
+const QuickLinksList = _ref => {
+  let {
+    tokens,
+    variant,
+    children
+  } = _ref;
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('QuickLinksCard', tokens, variant);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_CardBase.default, {
+    tokens: themeTokens,
+    children: children
+  });
+};
+
+QuickLinksList.propTypes = {
+  tokens: (0, _utils.getTokensPropType)('QuickLinksCard'),
+  variant: _utils.variantProp.propType,
+  children: _propTypes.default.node
+};
+var _default = QuickLinksList;
+exports.default = _default;

package/lib/QuickLinks/QuickLinksItem.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _utils = require("../utils");
+
+var _ViewportProvider = require("../ViewportProvider");
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _PressableListItemBase = _interopRequireDefault(require("../List/PressableListItemBase"));
+
+var _ButtonBase = _interopRequireDefault(require("../Button/ButtonBase"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+/**
+ * Public component exported as QuickLinks.Item, for use as children of QuickLinks.
+ *
+ * Receives props injected by QuickLinks and renders the appropriate child component.
+ */
+const QuickLinksItem = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
+  let {
+    tokens,
+    variant,
+    children,
+    ...rest
+  } = _ref;
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const {
+    list
+  } = (0, _ThemeProvider.useThemeTokens)('QuickLinks', tokens, variant, {
+    viewport
+  });
+  const themeName = list ? 'QuickLinksList' : 'QuickLinksButton';
+  const getTokens = (0, _ThemeProvider.useThemeTokensCallback)(themeName, tokens, variant);
+  return list ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_PressableListItemBase.default, {
+    ref: ref,
+    tokens: getTokens,
+    ...rest,
+    children: children
+  }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_ButtonBase.default, {
+    ref: ref,
+    tokens: getTokens,
+    ...rest,
+    children: children
+  });
+});
+QuickLinksItem.displayName = 'QuickLinksItem';
+QuickLinksItem.propTypes = { ..._utils.withLinkRouter.propTypes,
+  ..._PressableListItemBase.default.propTypes,
+  ..._ButtonBase.default.propTypes,
+  tokens: (0, _utils.getTokensPropType)('QuickLinksList', 'QuickLinksButton'),
+  variant: _utils.variantProp.propType,
+  children: _propTypes.default.node
+};
+
+var _default = (0, _utils.withLinkRouter)(QuickLinksItem);
+
+exports.default = _default;

package/lib/QuickLinks/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _QuickLinks = _interopRequireDefault(require("./QuickLinks"));
+
+var _QuickLinksItem = _interopRequireDefault(require("./QuickLinksItem"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+_QuickLinks.default.Item = _QuickLinksItem.default;
+var _default = _QuickLinks.default;
+exports.default = _default;

package/lib/StackView/StackWrap.js

@@ -9,6 +9,8 @@ var _react = _interopRequireWildcard(require("react"));
 
 var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
 
+var _useSafeLayoutEffect = _interopRequireDefault(require("../utils/useSafeLayoutEffect"));
+
 var _StackWrapBox = _interopRequireDefault(require("./StackWrapBox"));
 
 var _StackWrapGap = _interopRequireDefault(require("./StackWrapGap"));
@@ -22,10 +24,10 @@ function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "functio
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 
 // In Jest/CI/SSR, global CSS isn't always available and doesn't always have .supports method
-const cssSupports = function () {
+const cssSupports = (property, value) => {
   var _window$CSS;
 
-  return typeof window !== 'undefined' && typeof ((_window$CSS = window.CSS) === null || _window$CSS === void 0 ? void 0 : _window$CSS.supports) === 'function' && window.CSS.supports(...arguments);
+  return _Platform.default.OS === 'web' && typeof window !== 'undefined' && typeof ((_window$CSS = window.CSS) === null || _window$CSS === void 0 ? void 0 : _window$CSS.supports) === 'function' && window.CSS.supports(property, value);
 }; // CSS.supports needs an example of the type of value you intend to use.
 // Will be an integer appended `px` after hooks and JSX styles are resolved.
 
@@ -42,22 +44,24 @@ const exampleGapValue = '1px';
 const StackWrap = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
   var _props$gap;
 
+  const [canUseCSSGap, setCanUseCSSGap] = (0, _react.useState)(false);
   const {
     space
   } = props; // Don't apply separate gap if `null` or `undefined`, so can be unset in Storybook etc
 
   const gap = (_props$gap = props.gap) !== null && _props$gap !== void 0 ? _props$gap : space;
-  const canUseCSSGap = _Platform.default.OS === 'web' && gap === space && cssSupports('gap', exampleGapValue);
-  return canUseCSSGap ?
-  /*#__PURE__*/
-  // If possible, use the cleaner implementation that applies CSS `gap` styles to the container.
-  (0, _jsxRuntime.jsx)(_StackWrapGap.default, {
-    ref: ref,
-    ...props
-  }) :
-  /*#__PURE__*/
+  const gapEqualsSpace = gap === space; // If possible, use the cleaner implementation that applies CSS `gap` styles to the container,
+  // preserving direct parent-child relationships between the container and each item, which
+  // can result in clearer descriptions on some screen readers (e.g. radio "X of Y" on MacOS).
   // Else, use the fallback implementation which renders a `Box` component around each child.
-  (0, _jsxRuntime.jsx)(_StackWrapBox.default, {
+
+  const Component = canUseCSSGap ? _StackWrapGap.default : _StackWrapBox.default; // In SSR, the type of implementation must match the server during hydration, but
+  // the server can't know if gap is supported, so never use it until after hydration.
+
+  (0, _useSafeLayoutEffect.default)(() => {
+    setCanUseCSSGap(gapEqualsSpace && cssSupports('gap', exampleGapValue));
+  }, [gapEqualsSpace]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(Component, {
     ref: ref,
     ...props
   });