@dxc-technology/halstack-react 0.0.0-1da8813 → 0.0.0-1e19032

package/bleed/Bleed.stories.tsx

@@ -0,0 +1,342 @@
+import React from "react";
+import styled from "styled-components";
+import Title from "../../.storybook/components/Title";
+import DxcBleed from "./Bleed";
+import DxcStack from "../stack/Stack";
+
+export default {
+  title: "Bleed",
+  component: DxcBleed,
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="Space = none" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="none">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = xxxsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="xxxsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = xxsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="xxsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = xsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="xsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = small" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="small">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = medium" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="medium">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = large" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="large">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = xlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="xlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = xxlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="xxlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Space = xxxlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed space="xxxlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+
+    <Title title="Horizontal = none" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="none">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = xxxsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="xxxsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = xxsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="xxsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = xsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="xsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = small" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="small">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = medium" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="medium">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = large" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="large">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = xlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="xlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = xxlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="xxlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Horizontal = xxxlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="xxxlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+
+    <Title title="Vertical = none" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="none">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = xxxsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="xxxsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = xxsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="xxsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = xsmall" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="xsmall">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = small" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="small">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = medium" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="medium">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = large" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="large">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = xlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="xlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = xxlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="xxlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+    <Title title="Vertical = xxxlarge" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="xxxlarge">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+
+    <Title title="Top = xsmall, right = small, bottom = medium and left = large" theme="light" level={4} />
+    <Container>
+      <DxcStack gutter="medium">
+        <Placeholder></Placeholder>
+        <DxcBleed top="xsmall" right="small" bottom="medium" left="large">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcStack>
+    </Container>
+  </>
+);
+
+const Container = styled.div`
+  background: #f2eafa;
+  padding: 5rem;
+  margin: 2.5rem;
+`;
+
+const Placeholder = styled.div`
+  min-height: 40px;
+  min-width: 120px;
+  border: 1px solid #a46ede;
+  background-color: #e5d5f6;
+`;
+

package/bleed/types.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+declare type Spacing = "none" | "xxxsmall" | "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge" | "xxxlarge";
+declare type Props = {
+    space?: Spacing;
+    horizontal?: Spacing;
+    vertical?: Spacing;
+    top?: Spacing;
+    right?: Spacing;
+    bottom?: Spacing;
+    left?: Spacing;
+    children: React.ReactNode;
+};
+export default Props;

package/bleed/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/box/Box.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import BoxPropsType from "./types";
+declare const DxcBox: ({ shadowDepth, display, children, margin, padding, size, }: BoxPropsType) => JSX.Element;
+export default DxcBox;

package/box/Box.js

@@ -0,0 +1,126 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof3 = require("@babel/runtime/helpers/typeof");
+
+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 _react = _interopRequireDefault(require("react"));
+
+var _styledComponents = _interopRequireWildcard(require("styled-components"));
+
+var _variables = require("../common/variables.js");
+
+var _utils = require("../common/utils.js");
+
+var _useTheme = _interopRequireDefault(require("../useTheme"));
+
+var _BackgroundColorContext = require("../BackgroundColorContext");
+
+var _templateObject;
+
+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 || _typeof3(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 DxcBox = function DxcBox(_ref) {
+  var _ref$shadowDepth = _ref.shadowDepth,
+      shadowDepth = _ref$shadowDepth === void 0 ? 2 : _ref$shadowDepth,
+      _ref$display = _ref.display,
+      display = _ref$display === void 0 ? "inline-flex" : _ref$display,
+      children = _ref.children,
+      margin = _ref.margin,
+      padding = _ref.padding,
+      _ref$size = _ref.size,
+      size = _ref$size === void 0 ? "fitContent" : _ref$size;
+  var colorsTheme = (0, _useTheme["default"])();
+  return /*#__PURE__*/_react["default"].createElement(_styledComponents.ThemeProvider, {
+    theme: colorsTheme.box
+  }, /*#__PURE__*/_react["default"].createElement(StyledDxcBox, {
+    shadowDepth: shadowDepth,
+    display: display,
+    margin: margin,
+    padding: padding,
+    size: size
+  }, /*#__PURE__*/_react["default"].createElement(_BackgroundColorContext.BackgroundColorProvider, {
+    color: colorsTheme.box.backgroundColor
+  }, children)));
+};
+
+var sizes = {
+  small: "48px",
+  medium: "240px",
+  large: "480px",
+  fillParent: "100%",
+  fitContent: "unset"
+};
+
+var calculateWidth = function calculateWidth(margin, size, padding) {
+  if (size === "fillParent") {
+    return "calc(".concat(sizes[size], " - ").concat((0, _utils.getMargin)(margin, "left"), " - ").concat((0, _utils.getMargin)(margin, "right"), " -\n    ").concat((0, _utils.getMargin)(padding, "left"), " - ").concat((0, _utils.getMargin)(padding, "right"), ")");
+  }
+
+  return sizes[size];
+};
+
+var StyledDxcBox = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  display: ", ";\n  border-radius: ", ";\n  border-width: ", ";\n  border-style: ", ";\n  border-color: ", ";\n  letter-spacing: ", ";\n  overflow: hidden;\n  width: ", ";\n  background-color: ", ";\n  box-shadow: ", ";\n\n  margin: ", ";\n  margin-top: ", ";\n  margin-right: ", ";\n  margin-bottom: ", ";\n  margin-left: ", ";\n\n  padding: ", ";\n  padding-top: ", ";\n  padding-right: ", ";\n  padding-bottom: ", ";\n  padding-left: ", ";\n"])), function (_ref2) {
+  var display = _ref2.display;
+  return display;
+}, function (props) {
+  return props.theme.borderRadius;
+}, function (props) {
+  return props.theme.borderThickness;
+}, function (props) {
+  return props.theme.borderStyle;
+}, function (props) {
+  return props.theme.borderColor;
+}, function (props) {
+  return props.theme.letterSpacing;
+}, function (props) {
+  return calculateWidth(props.margin, props.size, props.padding);
+}, function (props) {
+  return props.theme.backgroundColor;
+}, function (props) {
+  return props.shadowDepth === 1 ? "".concat(props.theme.oneShadowDepthShadowOffsetX, " ").concat(props.theme.oneShadowDepthShadowOffsetY, " ").concat(props.theme.oneShadowDepthShadowBlur, "  ").concat(props.theme.oneShadowDepthShadowSpread, " ").concat(props.theme.oneShadowDepthShadowColor) : props.shadowDepth === 2 ? "".concat(props.theme.twoShadowDepthShadowOffsetX, " ").concat(props.theme.twoShadowDepthShadowOffsetY, " ").concat(props.theme.twoShadowDepthShadowBlur, "  ").concat(props.theme.twoShadowDepthShadowSpread, " ").concat(props.theme.twoShadowDepthShadowColor) : "".concat(props.theme.noneShadowDepthShadowOffsetX, " ").concat(props.theme.noneShadowDepthShadowOffsetY, " ").concat(props.theme.noneShadowDepthShadowBlur, "  ").concat(props.theme.noneShadowDepthShadowSpread, " ").concat(props.theme.noneShadowDepthShadowColor);
+}, function (_ref3) {
+  var margin = _ref3.margin;
+  return margin && (0, _typeof2["default"])(margin) !== "object" ? _variables.spaces[margin] : "0px";
+}, function (_ref4) {
+  var margin = _ref4.margin;
+  return margin && margin.top ? _variables.spaces[margin.top] : "";
+}, function (_ref5) {
+  var margin = _ref5.margin;
+  return margin && margin.right ? _variables.spaces[margin.right] : "";
+}, function (_ref6) {
+  var margin = _ref6.margin;
+  return margin && margin.bottom ? _variables.spaces[margin.bottom] : "";
+}, function (_ref7) {
+  var margin = _ref7.margin;
+  return margin && margin.left ? _variables.spaces[margin.left] : "";
+}, function (_ref8) {
+  var padding = _ref8.padding;
+  return padding && (0, _typeof2["default"])(padding) !== "object" ? _variables.spaces[padding] : "0px";
+}, function (_ref9) {
+  var padding = _ref9.padding;
+  return padding && padding.top ? _variables.spaces[padding.top] : "";
+}, function (_ref10) {
+  var padding = _ref10.padding;
+  return padding && padding.right ? _variables.spaces[padding.right] : "";
+}, function (_ref11) {
+  var padding = _ref11.padding;
+  return padding && padding.bottom ? _variables.spaces[padding.bottom] : "";
+}, function (_ref12) {
+  var padding = _ref12.padding;
+  return padding && padding.left ? _variables.spaces[padding.left] : "";
+});
+
+var _default = DxcBox;
+exports["default"] = _default;

package/box/Box.stories.tsx

@@ -0,0 +1,132 @@
+import React from "react";
+import Title from "../../.storybook/components/Title";
+import ExampleContainer from "../../.storybook/components/ExampleContainer";
+import DxcBox from "./Box";
+
+export default {
+  title: "Box ",
+  component: DxcBox,
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="Display flex" theme="light" level={2} />
+    <ExampleContainer>
+      <DxcBox display="flex" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <Title title="ShadowDepth" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="ShadowDepth 0" theme="light" level={4} />
+      <DxcBox shadowDepth={0} margin="medium" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="ShadowDepth 1" theme="light" level={4} />
+      <DxcBox shadowDepth={1} margin="medium" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="ShadowDepth 2" theme="light" level={4} />
+      <DxcBox shadowDepth={2} margin="medium" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <Title title="Paddings" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall padding" theme="light" level={4} />
+      <DxcBox padding="xxsmall">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xsmall padding" theme="light" level={4} />
+      <DxcBox padding="xsmall">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Small padding" theme="light" level={4} />
+      <DxcBox padding="small">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Medium padding" theme="light" level={4} />
+      <DxcBox padding="medium">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large padding" theme="light" level={4} />
+      <DxcBox padding="large">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xlarge padding" theme="light" level={4} />
+      <DxcBox padding="xlarge">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xxlarge padding" theme="light" level={4} />
+      <DxcBox padding="xxlarge">Box</DxcBox>
+    </ExampleContainer>
+    <Title title="Margins" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall margin" theme="light" level={4} />
+      <DxcBox margin="xxsmall" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xsmall margin" theme="light" level={4} />
+      <DxcBox margin="xsmall" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Small margin" theme="light" level={4} />
+      <DxcBox margin="small" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Medium margin" theme="light" level={4} />
+      <DxcBox margin="medium" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large margin" theme="light" level={4} />
+      <DxcBox margin="large" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xlarge margin" theme="light" level={4} />
+      <DxcBox margin="xlarge" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xxlarge margin" theme="light" level={4} />
+      <DxcBox margin="xxlarge" padding="medium">
+        Box
+      </DxcBox>
+    </ExampleContainer>
+    <Title title="Sizes" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Small size" theme="light" level={4} />
+      <DxcBox size="small">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Medium size" theme="light" level={4} />
+      <DxcBox size="medium">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large size" theme="light" level={4} />
+      <DxcBox size="large">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="FillParent size" theme="light" level={4} />
+      <DxcBox size="fillParent">Box</DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="FitContent" theme="light" level={4} />
+      <DxcBox size="fitContent">Box</DxcBox>
+    </ExampleContainer>
+  </>
+);

package/box/types.d.ts

@@ -0,0 +1,43 @@
+/// <reference types="react" />
+declare type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+declare type Margin = {
+    top?: Space;
+    bottom?: Space;
+    left?: Space;
+    right?: Space;
+};
+declare type Padding = {
+    top?: Space;
+    bottom?: Space;
+    left?: Space;
+    right?: Space;
+};
+declare type Props = {
+    /**
+     * The size of the shadow to be displayed around the box.
+     */
+    shadowDepth?: 0 | 1 | 2;
+    /**
+     * Changes the display CSS property of the box div.
+     */
+    display?: string;
+    /**
+     * Custom content that will be placed in the box component.
+     */
+    children: React.ReactNode;
+    /**
+     * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
+     * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
+     */
+    margin?: Space | Margin;
+    /**
+     * Size of the padding to be applied to the custom area ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
+     * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different padding sizes.
+     */
+    padding?: Space | Padding;
+    /**
+     * Size of the component.
+     */
+    size?: "small" | "medium" | "large" | "fillParent" | "fitContent";
+};
+export default Props;

package/box/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});