@dxc-technology/halstack-react 0.0.0-e1386cf → 0.0.0-e19ca5f

package/file-input/FileItem.js

@@ -1,73 +1,37 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
 var _typeof = require("@babel/runtime/helpers/typeof");
-
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
-
 var _react = _interopRequireDefault(require("react"));
-
 var _styledComponents = _interopRequireWildcard(require("styled-components"));
-
-var _main = require("../main");
-
+var _Flex = _interopRequireDefault(require("../flex/Flex"));
 var _useTheme = _interopRequireDefault(require("../useTheme"));
-
 var _useTranslatedLabels = _interopRequireDefault(require("../useTranslatedLabels"));
-
+var _Icon = _interopRequireDefault(require("../icon/Icon"));
 var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8;
-
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(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; }
-
-var deleteIcon = /*#__PURE__*/_react["default"].createElement("svg", {
-  xmlns: "http://www.w3.org/2000/svg",
-  width: "24",
-  height: "24",
-  viewBox: "0 0 24 24",
-  fill: "currentColor"
-}, /*#__PURE__*/_react["default"].createElement("path", {
-  d: "M0 0h24v24H0V0z",
-  fill: "none"
-}), /*#__PURE__*/_react["default"].createElement("path", {
-  d: "M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"
-}));
-
-var errorIcon = /*#__PURE__*/_react["default"].createElement("svg", {
-  xmlns: "http://www.w3.org/2000/svg",
-  height: "24px",
-  viewBox: "0 0 24 24",
-  width: "24px",
-  fill: "currentColor"
-}, /*#__PURE__*/_react["default"].createElement("path", {
-  d: "M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-2h2v2zm0-4h-2V7h2v6z"
-}));
-
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(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; }
 var FileItem = function FileItem(_ref) {
   var _ref$fileName = _ref.fileName,
-      fileName = _ref$fileName === void 0 ? "" : _ref$fileName,
-      _ref$error = _ref.error,
-      error = _ref$error === void 0 ? "" : _ref$error,
-      singleFileMode = _ref.singleFileMode,
-      showPreview = _ref.showPreview,
-      preview = _ref.preview,
-      type = _ref.type,
-      onDelete = _ref.onDelete,
-      tabIndex = _ref.tabIndex;
+    fileName = _ref$fileName === void 0 ? "" : _ref$fileName,
+    _ref$error = _ref.error,
+    error = _ref$error === void 0 ? "" : _ref$error,
+    singleFileMode = _ref.singleFileMode,
+    showPreview = _ref.showPreview,
+    preview = _ref.preview,
+    type = _ref.type,
+    onDelete = _ref.onDelete,
+    tabIndex = _ref.tabIndex;
   var colorsTheme = (0, _useTheme["default"])();
   var translatedLabels = (0, _useTranslatedLabels["default"])();
-
   var getIconAriaLabel = function getIconAriaLabel() {
     if (type.includes("video")) return "video";else if (type.includes("audio")) return "audio";else return "file";
   };
-
   return /*#__PURE__*/_react["default"].createElement(_styledComponents.ThemeProvider, {
     theme: colorsTheme.fileInput
   }, /*#__PURE__*/_react["default"].createElement(MainContainer, {
@@ -79,19 +43,29 @@ var FileItem = function FileItem(_ref) {
     alt: fileName
   }) : /*#__PURE__*/_react["default"].createElement(IconPreview, {
     error: error,
+    role: "document",
     "aria-label": getIconAriaLabel()
-  }, preview)), /*#__PURE__*/_react["default"].createElement(FileItemContent, null, /*#__PURE__*/_react["default"].createElement(FileName, null, fileName), /*#__PURE__*/_react["default"].createElement(_main.DxcFlex, {
+  }, /*#__PURE__*/_react["default"].createElement(_Icon["default"], {
+    icon: preview
+  }))), /*#__PURE__*/_react["default"].createElement(FileItemContent, null, /*#__PURE__*/_react["default"].createElement(FileName, null, fileName), /*#__PURE__*/_react["default"].createElement(_Flex["default"], {
     gap: "0.25rem"
-  }, error && /*#__PURE__*/_react["default"].createElement(ErrorIcon, null, errorIcon), /*#__PURE__*/_react["default"].createElement(DeleteFileAction, {
+  }, error && /*#__PURE__*/_react["default"].createElement(ErrorIcon, null, /*#__PURE__*/_react["default"].createElement(_Icon["default"], {
+    icon: "filled_error"
+  })), /*#__PURE__*/_react["default"].createElement(DeleteFileAction, {
     onClick: function onClick() {
       onDelete(fileName);
     },
+    type: "button",
     title: translatedLabels.fileInput.deleteFileActionTitle,
     "aria-label": translatedLabels.fileInput.deleteFileActionTitle,
     tabIndex: tabIndex
-  }, deleteIcon)), error && !singleFileMode && /*#__PURE__*/_react["default"].createElement(ErrorMessage, null, error))));
+  }, /*#__PURE__*/_react["default"].createElement(_Icon["default"], {
+    icon: "close"
+  }))), error && !singleFileMode && /*#__PURE__*/_react["default"].createElement(ErrorMessage, {
+    role: "alert",
+    "aria-live": "assertive"
+  }, error))));
 };
-
 var MainContainer = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  box-sizing: border-box;\n  display: flex;\n  justify-content: center;\n  gap: 0.75rem;\n  width: ", ";\n  padding: ", ";\n  ", ";\n  border-color: ", ";\n  border-width: ", ";\n  border-style: ", ";\n  border-radius: ", ";\n"])), function (props) {
   return props.singleFileMode ? "230px" : "320px";
 }, function (props) {
@@ -107,17 +81,13 @@ var MainContainer = _styledComponents["default"].div(_templateObject || (_templa
 }, function (props) {
   return props.theme.fileItemBorderRadius;
 });
-
 var ImagePreview = _styledComponents["default"].img(_templateObject2 || (_templateObject2 = (0, _taggedTemplateLiteral2["default"])(["\n  width: 48px;\n  height: 48px;\n  border-radius: 2px;\n  object-fit: contain;\n"])));
-
-var IconPreview = _styledComponents["default"].span(_templateObject3 || (_templateObject3 = (0, _taggedTemplateLiteral2["default"])(["\n  box-sizing: border-box;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  background-color: ", ";\n  width: 48px;\n  height: 48px;\n  padding: 15px;\n  border-radius: 2px;\n  color: ", ";\n\n  svg {\n    height: 18px;\n    width: 18px;\n  }\n"])), function (props) {
+var IconPreview = _styledComponents["default"].span(_templateObject3 || (_templateObject3 = (0, _taggedTemplateLiteral2["default"])(["\n  box-sizing: border-box;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  background-color: ", ";\n  width: 48px;\n  height: 48px;\n  padding: 15px;\n  border-radius: 2px;\n  color: ", ";\n  font-size: 18px;\n  svg {\n    height: 18px;\n    width: 18px;\n  }\n"])), function (props) {
   return props.error ? props.theme.errorFilePreviewBackgroundColor : props.theme.filePreviewBackgroundColor;
 }, function (props) {
   return props.error ? props.theme.errorFilePreviewIconColor : props.theme.filePreviewIconColor;
 });
-
 var FileItemContent = _styledComponents["default"].div(_templateObject4 || (_templateObject4 = (0, _taggedTemplateLiteral2["default"])(["\n  flex-grow: 1;\n  display: grid;\n  grid-template-columns: auto min-content;\n  grid-template-rows: min-content auto;\n  column-gap: 0.25rem;\n"])));
-
 var FileName = _styledComponents["default"].span(_templateObject5 || (_templateObject5 = (0, _taggedTemplateLiteral2["default"])(["\n  align-self: center;\n  color: ", ";\n  font-family: ", ";\n  font-size: ", ";\n  font-weight: ", ";\n  line-height: ", ";\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n"])), function (props) {
   return props.theme.fileNameFontColor;
 }, function (props) {
@@ -129,10 +99,8 @@ var FileName = _styledComponents["default"].span(_templateObject5 || (_templateO
 }, function (props) {
   return props.theme.fileItemLineHeight;
 });
-
-var ErrorIcon = _styledComponents["default"].span(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  padding: 3px;\n  height: 18px;\n  width: 18px;\n  color: #d0011b;\n"])));
-
-var DeleteFileAction = _styledComponents["default"].button(_templateObject7 || (_templateObject7 = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  height: 24px;\n  width: 24px;\n  font-size: 1rem;\n  font-family: ", ";\n  border: 1px solid transparent;\n  border-radius: 2px;\n  background-color: transparent;\n  box-shadow: 0 0 0 2px transparent;\n  padding: 3px;\n  cursor: pointer;\n  color: ", ";\n\n  svg {\n    line-height: 18px;\n  }\n  &:hover {\n    background-color: ", ";\n  }\n  &:focus,\n  &:focus-visible {\n    outline: none;\n    box-shadow: 0 0 0 2px ", ";\n  }\n  &:active {\n    background-color: ", ";\n  }\n"])), function (props) {
+var ErrorIcon = _styledComponents["default"].span(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  padding: 3px;\n  height: 18px;\n  width: 18px;\n  font-size: 18px;\n  color: #d0011b;\n"])));
+var DeleteFileAction = _styledComponents["default"].button(_templateObject7 || (_templateObject7 = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  flex-wrap: wrap;\n  align-content: center;\n  height: 24px;\n  width: 24px;\n  font-size: 1rem;\n  font-family: ", ";\n  border: 1px solid transparent;\n  border-radius: 2px;\n  background-color: transparent;\n  box-shadow: 0 0 0 2px transparent;\n  padding: 3px;\n  cursor: pointer;\n  color: ", ";\n  font-size: 18px;\n  &:hover {\n    background-color: ", ";\n  }\n  &:focus,\n  &:focus-visible {\n    outline: none;\n    box-shadow: 0 0 0 2px ", ";\n  }\n  &:active {\n    background-color: ", ";\n  }\n"])), function (props) {
   return props.theme.fontFamily;
 }, function (props) {
   return props.theme.deleteFileItemColor;
@@ -143,7 +111,6 @@ var DeleteFileAction = _styledComponents["default"].button(_templateObject7 || (
 }, function (props) {
   return props.theme.activeDeleteFileItemBackgroundColor;
 });
-
 var ErrorMessage = _styledComponents["default"].span(_templateObject8 || (_templateObject8 = (0, _taggedTemplateLiteral2["default"])(["\n  color: ", ";\n  font-family: ", ";\n  font-size: ", ";\n  font-weight: ", ";\n  line-height: ", ";\n"])), function (props) {
   return props.theme.errorMessageFontColor;
 }, function (props) {
@@ -155,7 +122,4 @@ var ErrorMessage = _styledComponents["default"].span(_templateObject8 || (_templ
 }, function (props) {
   return props.theme.errorMessageLineHeight;
 });
-
-var _default = /*#__PURE__*/_react["default"].memo(FileItem);
-
-exports["default"] = _default;
+var _default = exports["default"] = /*#__PURE__*/_react["default"].memo(FileItem);

package/file-input/types.d.ts

@@ -1,11 +1,11 @@
-declare type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
-declare type Margin = {
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
     top?: Space;
     bottom?: Space;
     left?: Space;
     right?: Space;
 };
-declare type FileData = {
+export type FileData = {
     /**
      * Selected file.
      */
@@ -19,9 +19,9 @@ declare type FileData = {
      */
     preview?: string;
 };
-declare type CommonProps = {
+type CommonProps = {
     /**
-     * Name attribute.
+     * @deprecated Name attribute.
      */
     name?: string;
     /**
@@ -80,7 +80,7 @@ declare type CommonProps = {
      */
     tabIndex?: number;
 };
-declare type DropModeProps = CommonProps & {
+type DropModeProps = CommonProps & {
     /**
      * Uses one of the available file input modes:
      *    'file': Files are selected by clicking the button and selecting it through the file explorer.
@@ -94,7 +94,7 @@ declare type DropModeProps = CommonProps & {
      */
     dropAreaLabel?: string;
 };
-declare type FileModeProps = CommonProps & {
+type FileModeProps = CommonProps & {
     /**
      * Uses one of the available file input modes:
      *    'file': Files are selected by clicking the button and selecting it through the file explorer.
@@ -111,12 +111,12 @@ declare type FileModeProps = CommonProps & {
 /**
  * Reference to the component.
  */
-export declare type RefType = HTMLDivElement;
-declare type Props = DropModeProps | FileModeProps;
+export type RefType = HTMLDivElement;
+type Props = DropModeProps | FileModeProps;
 /**
  * Single file item preview.
  */
-export declare type FileItemProps = {
+export type FileItemProps = {
     fileName?: string;
     error?: string;
     showPreview: boolean;

package/flex/Flex.js

@@ -1,46 +1,36 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
-
 var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
-
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
-
 var _react = _interopRequireDefault(require("react"));
-
 var _styledComponents = _interopRequireDefault(require("styled-components"));
-
 var _templateObject;
-
 var _excluded = ["direction", "wrap", "gap", "order", "grow", "shrink", "basis", "children"],
-    _excluded2 = ["justifyContent", "alignItems", "alignContent", "alignSelf"];
-
+  _excluded2 = ["justifyContent", "alignItems", "alignContent", "alignSelf"];
 var DxcFlex = function DxcFlex(_ref) {
   var _ref$direction = _ref.direction,
-      direction = _ref$direction === void 0 ? "row" : _ref$direction,
-      _ref$wrap = _ref.wrap,
-      wrap = _ref$wrap === void 0 ? "nowrap" : _ref$wrap,
-      _ref$gap = _ref.gap,
-      gap = _ref$gap === void 0 ? "0" : _ref$gap,
-      _ref$order = _ref.order,
-      order = _ref$order === void 0 ? 0 : _ref$order,
-      _ref$grow = _ref.grow,
-      grow = _ref$grow === void 0 ? 0 : _ref$grow,
-      _ref$shrink = _ref.shrink,
-      shrink = _ref$shrink === void 0 ? 1 : _ref$shrink,
-      _ref$basis = _ref.basis,
-      basis = _ref$basis === void 0 ? "auto" : _ref$basis,
-      children = _ref.children,
-      props = (0, _objectWithoutProperties2["default"])(_ref, _excluded);
+    direction = _ref$direction === void 0 ? "row" : _ref$direction,
+    _ref$wrap = _ref.wrap,
+    wrap = _ref$wrap === void 0 ? "nowrap" : _ref$wrap,
+    _ref$gap = _ref.gap,
+    gap = _ref$gap === void 0 ? "0rem" : _ref$gap,
+    _ref$order = _ref.order,
+    order = _ref$order === void 0 ? 0 : _ref$order,
+    _ref$grow = _ref.grow,
+    grow = _ref$grow === void 0 ? 0 : _ref$grow,
+    _ref$shrink = _ref.shrink,
+    shrink = _ref$shrink === void 0 ? 1 : _ref$shrink,
+    _ref$basis = _ref.basis,
+    basis = _ref$basis === void 0 ? "auto" : _ref$basis,
+    children = _ref.children,
+    props = (0, _objectWithoutProperties2["default"])(_ref, _excluded);
   return /*#__PURE__*/_react["default"].createElement(Flex, (0, _extends2["default"])({
     $direction: direction,
     $wrap: wrap,
@@ -51,19 +41,17 @@ var DxcFlex = function DxcFlex(_ref) {
     $gap: gap
   }, props), children);
 };
-
 var Flex = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  display: flex;\n  ", "\n"])), function (_ref2) {
+  var _props$$gap, _props$$gap$rowGap, _props$$gap$columnGap;
   var _ref2$justifyContent = _ref2.justifyContent,
-      justifyContent = _ref2$justifyContent === void 0 ? "flex-start" : _ref2$justifyContent,
-      _ref2$alignItems = _ref2.alignItems,
-      alignItems = _ref2$alignItems === void 0 ? "stretch" : _ref2$alignItems,
-      _ref2$alignContent = _ref2.alignContent,
-      alignContent = _ref2$alignContent === void 0 ? "normal" : _ref2$alignContent,
-      _ref2$alignSelf = _ref2.alignSelf,
-      alignSelf = _ref2$alignSelf === void 0 ? "auto" : _ref2$alignSelf,
-      props = (0, _objectWithoutProperties2["default"])(_ref2, _excluded2);
-  return "\n    flex-direction: ".concat(props.$direction, "; \n    flex-wrap: ").concat(props.$wrap, "; \n    justify-content: ").concat(justifyContent, "; \n    align-items: ").concat(alignItems, ";\n    align-content: ").concat(alignContent, ";\n    align-self: ").concat(alignSelf, ";\n    gap: ").concat((0, _typeof2["default"])(props.$gap) === "object" ? "".concat(props.$gap.rowGap, " ").concat(props.$gap.columnGap) : props.$gap, ";\n    order: ").concat(props.$order, ";\n    flex-grow: ").concat(props.$grow, ";\n    flex-shrink: ").concat(props.$shrink, ";\n    flex-basis: ").concat(props.$basis, ";\n  ");
+    justifyContent = _ref2$justifyContent === void 0 ? "flex-start" : _ref2$justifyContent,
+    _ref2$alignItems = _ref2.alignItems,
+    alignItems = _ref2$alignItems === void 0 ? "stretch" : _ref2$alignItems,
+    _ref2$alignContent = _ref2.alignContent,
+    alignContent = _ref2$alignContent === void 0 ? "normal" : _ref2$alignContent,
+    _ref2$alignSelf = _ref2.alignSelf,
+    alignSelf = _ref2$alignSelf === void 0 ? "auto" : _ref2$alignSelf,
+    props = (0, _objectWithoutProperties2["default"])(_ref2, _excluded2);
+  return "\n    flex-direction: ".concat(props.$direction, "; \n    flex-wrap: ").concat(props.$wrap, "; \n    justify-content: ").concat(justifyContent, "; \n    align-items: ").concat(alignItems, ";\n    align-content: ").concat(alignContent, ";\n    align-self: ").concat(alignSelf, ";\n    gap: ").concat(props.$gap != null && typeof props.$gap === "string" ? (_props$$gap = props.$gap) !== null && _props$$gap !== void 0 ? _props$$gap : "" : "", "}\n    row-gap: ").concat(props.$gap != null && (0, _typeof2["default"])(props.$gap) === "object" ? (_props$$gap$rowGap = props.$gap.rowGap) !== null && _props$$gap$rowGap !== void 0 ? _props$$gap$rowGap : "" : "", "}\n    column-gap: ").concat(props.$gap != null && (0, _typeof2["default"])(props.$gap) === "object" ? (_props$$gap$columnGap = props.$gap.columnGap) !== null && _props$$gap$columnGap !== void 0 ? _props$$gap$columnGap : "" : "", "}\n    order: ").concat(props.$order, ";\n    flex-grow: ").concat(props.$grow, ";\n    flex-shrink: ").concat(props.$shrink, ";\n    flex-basis: ").concat(props.$basis, ";\n  ");
 });
-
-var _default = DxcFlex;
-exports["default"] = _default;
+var _default = exports["default"] = DxcFlex;

package/flex/Flex.stories.tsx

@@ -14,36 +14,36 @@ export const Chromatic = () => (
     <Container>
       <DxcFlex>
         <Placeholder />
-        <Placeholder width="50px" />
+        <Placeholder minWidth="50px" />
         <Placeholder />
-        <Placeholder width="50px" />
-        <Placeholder width="50px" />
+        <Placeholder minWidth="50px" />
+        <Placeholder minWidth="50px" />
       </DxcFlex>
     </Container>
     <Title title="Direction column, wrap, justify content end, align items center and gap" level={4} />
     <Container>
-      <DxcFlex direction="column" wrap="wrap" justifyContent="end" alignItems="center" gap="20px">
+      <DxcFlex direction="column" wrap="wrap" justifyContent="end" alignItems="center" gap="1.5rem">
         <Placeholder />
-        <Placeholder width="100px" />
+        <Placeholder minWidth="100px" />
         <Placeholder />
-        <Placeholder width="100px" />
+        <Placeholder minWidth="100px" />
         <Placeholder />
       </DxcFlex>
     </Container>
     <Title title="Wrap with align content space between, row and column gaps, and as a span" level={4} />
     <Container height="250px">
-      <DxcFlex wrap="wrap" alignContent="space-between" as="span" gap={{ rowGap: "10px", columnGap: "20px" }}>
+      <DxcFlex wrap="wrap" alignContent="space-between" as="span" gap={{ rowGap: "0.5rem", columnGap: "1.5rem" }}>
         <Placeholder />
         <Placeholder />
         <Placeholder />
         <Placeholder />
-        <Placeholder width="100px" />
+        <Placeholder minWidth="100px" />
         <Placeholder />
         <Placeholder />
-        <Placeholder width="100px" />
+        <Placeholder minWidth="100px" />
         <Placeholder />
         <Placeholder />
-        <Placeholder width="100px" />
+        <Placeholder minWidth="100px" />
         <Placeholder />
       </DxcFlex>
     </Container>
@@ -51,16 +51,24 @@ export const Chromatic = () => (
     <Container height="75px">
       <DxcFlex basis="100%">
         <DxcFlex order={3} grow={1} alignSelf="flex-end">
-          <PlaceholderGrowAndShrink>order 3, grow 1, align self end</PlaceholderGrowAndShrink>
+          <Placeholder width="100%" minWidth="0">
+            order 3, grow 1, align self end
+          </Placeholder>
         </DxcFlex>
         <DxcFlex order={-1} grow={4}>
-          <PlaceholderGrowAndShrink>order -1, grow 4</PlaceholderGrowAndShrink>
+          <Placeholder width="100%" minWidth="0">
+            order -1, grow 4
+          </Placeholder>
         </DxcFlex>
         <DxcFlex order={5} grow={1}>
-          <PlaceholderGrowAndShrink>order 5, grow 1</PlaceholderGrowAndShrink>
+          <Placeholder width="100%" minWidth="0">
+            order 5, grow 1
+          </Placeholder>
         </DxcFlex>
         <DxcFlex order={2} grow={2}>
-          <PlaceholderGrowAndShrink>order 2. grow 2</PlaceholderGrowAndShrink>
+          <Placeholder width="100%" minWidth="0">
+            order 2. grow 2
+          </Placeholder>
         </DxcFlex>
       </DxcFlex>
     </Container>
@@ -68,13 +76,19 @@ export const Chromatic = () => (
     <Container>
       <DxcFlex basis="600px">
         <DxcFlex shrink={4} basis="400px">
-          <PlaceholderGrowAndShrink>shrink 4</PlaceholderGrowAndShrink>
+          <Placeholder width="100%" minWidth="0">
+            shrink 4
+          </Placeholder>
         </DxcFlex>
         <DxcFlex shrink={2} basis="400px">
-          <PlaceholderGrowAndShrink>shrink 2</PlaceholderGrowAndShrink>
+          <Placeholder width="100%" minWidth="0">
+            shrink 2
+          </Placeholder>
         </DxcFlex>
         <DxcFlex shrink={1} basis="400px">
-          <PlaceholderGrowAndShrink>shrink 1</PlaceholderGrowAndShrink>
+          <Placeholder width="100%" minWidth="0">
+            shrink 1
+          </Placeholder>
         </DxcFlex>
       </DxcFlex>
     </Container>
@@ -88,16 +102,11 @@ const Container = styled.div<{ height?: string }>`
   ${({ height }) => (height ? `height: ${height}` : "max-height: 150px")};
 `;
 
-const Placeholder = styled.div<{ width?: string }>`
+const Placeholder = styled.div<{ minWidth?: string; width?: string }>`
   height: 40px;
-  min-width: ${({ width }) => width || "200px"};
-  border: 1px solid #a46ede;
-  background-color: #e5d5f6;
-`;
-
-const PlaceholderGrowAndShrink = styled.div`
-  height: 40px;
-  width: 100%;
+  min-width: ${({ minWidth }) => minWidth ?? "200px"};
+  width: ${({ width }) => width};
   border: 1px solid #a46ede;
+  border-radius: 0.5rem;
   background-color: #e5d5f6;
 `;

package/flex/types.d.ts

@@ -1,29 +1,94 @@
 /// <reference types="react" />
-declare type Gap = {
-    rowGap: string;
-    columnGap: string;
-};
-declare type CommonProps = {
+type Spaces = "0rem" | "0.125rem" | "0.25rem" | "0.5rem" | "1rem" | "1.5rem" | "2rem" | "3rem" | "4rem" | "5rem";
+type Gap = {
+    rowGap: Spaces;
+    columnGap?: Spaces;
+} | {
+    rowGap?: Spaces;
+    columnGap: Spaces;
+} | Spaces;
+type CommonProps = {
+    /**
+     * Sets the justify-content CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content
+     */
     justifyContent?: "flex-start" | "flex-end" | "start" | "end" | "left" | "right" | "center" | "space-between" | "space-around" | "space-evenly";
+    /**
+     * Sets the align-items CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/align-items
+     */
     alignItems?: "stretch" | "flex-start" | "flex-end" | "start" | "end" | "self-start" | "self-end" | "center" | "baseline";
+    /**
+     * Sets the align-content CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/align-content
+     */
     alignContent?: "normal" | "flex-start" | "flex-end" | "start" | "end" | "center" | "space-between" | "space-around" | "space-evenly" | "stretch";
+    /**
+     * Sets the align-self CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/align-self
+     */
     alignSelf?: "auto" | "flex-start" | "flex-end" | "center" | "baseline" | "stretch";
 };
-declare type Props = CommonProps & {
+type Props = CommonProps & {
+    /**
+     * Sets the flex-direction CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/flex-direction
+     */
     direction?: "row" | "row-reverse" | "column" | "column-reverse";
+    /**
+     * Sets the flex-wrap CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/flex-wrap
+     */
     wrap?: "nowrap" | "wrap" | "wrap-reverse";
-    gap?: string | Gap;
+    /**
+     * Sets the gap CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/gap
+     */
+    gap?: Gap;
+    /**
+     * Sets the order CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/order
+     */
     order?: number;
+    /**
+     * Sets the flex-grow CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/flex-grow
+     */
     grow?: number;
+    /**
+     * Sets the flex-shrink CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/flex-shrink
+     */
     shrink?: number;
+    /**
+     * Sets the flex-basis CSS property.
+     *
+     * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/flex-basis
+     */
     basis?: string;
+    /**
+     * Sets a custom HTML tag.
+     */
     as?: keyof HTMLElementTagNameMap;
+    /**
+     * Custom content inside the flex container.
+     */
     children: React.ReactNode;
 };
-export declare type StyledProps = CommonProps & {
+export type StyledProps = CommonProps & {
     $direction?: "row" | "row-reverse" | "column" | "column-reverse";
     $wrap?: "nowrap" | "wrap" | "wrap-reverse";
-    $gap?: string | Gap;
+    $gap?: Spaces | Gap;
     $order?: number;
     $grow?: number;
     $shrink?: number;