@dxc-technology/halstack-react 0.0.0-f2bc144 → 0.0.0-f319e71

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 DxcFlex from "../flex/Flex";
+
+export default {
+  title: "Bleed",
+  component: DxcBleed,
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="Space = none" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="0rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = xxxsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="0.125rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = xxsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="0.25rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = xsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="0.5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = small" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="1rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = medium" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="1.5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = large" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="2rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = xlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="3rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = xxlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="4rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Space = xxxlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed space="5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+
+    <Title title="Horizontal = none" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="0rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = xxxsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="0.125rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = xxsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="0.25rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = xsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="0.5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = small" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="1rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = medium" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="1.5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = large" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="2rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = xlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="3rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = xxlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="4rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Horizontal = xxxlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed horizontal="5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+
+    <Title title="Vertical = none" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="0rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = xxxsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="0.125rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = xxsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="0.25rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = xsmall" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="0.5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = small" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="1rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = medium" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="1.5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = large" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="2rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = xlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="3rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = xxlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="4rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+    <Title title="Vertical = xxxlarge" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed vertical="5rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </Container>
+
+    <Title title="Top = xsmall, right = small, bottom = medium and left = large" theme="light" level={4} />
+    <Container>
+      <DxcFlex direction="column" gap="1.5rem">
+        <Placeholder></Placeholder>
+        <DxcBleed top="0.5rem" right="1rem" bottom="1.5rem" left="2rem">
+          <Placeholder></Placeholder>
+        </DxcBleed>
+        <Placeholder></Placeholder>
+      </DxcFlex>
+    </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;
+  border-radius: 0.5rem;
+  background-color: #e5d5f6;
+`;

package/bleed/types.d.ts

@@ -0,0 +1,37 @@
+/// <reference types="react" />
+type Spacing = "0rem" | "0.125rem" | "0.25rem" | "0.5rem" | "1rem" | "1.5rem" | "2rem" | "3rem" | "4rem" | "5rem";
+type Props = {
+    /**
+     * Applies the spacing scale to all sides.
+     */
+    space?: Spacing;
+    /**
+     * Applies the spacing scale to the left and right sides.
+     */
+    horizontal?: Spacing;
+    /**
+     * Applies the spacing scale to the top and bottom sides.
+     */
+    vertical?: Spacing;
+    /**
+     * Applies the spacing scale to the top side.
+     */
+    top?: Spacing;
+    /**
+     * Applies the spacing scale to the right side.
+     */
+    right?: Spacing;
+    /**
+     * Applies the spacing scale to the bottom side.
+     */
+    bottom?: Spacing;
+    /**
+     * Applies the spacing scale to the left side.
+     */
+    left?: Spacing;
+    /**
+     * Custom content inside the bleed.
+     */
+    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.accessibility.test.d.ts

@@ -0,0 +1 @@
+export {};

package/box/Box.accessibility.test.js

@@ -0,0 +1,33 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _react = _interopRequireDefault(require("react"));
+var _react2 = require("@testing-library/react");
+var _axeHelper = require("../../test/accessibility/axe-helper.js");
+var _Box = _interopRequireDefault(require("../box/Box"));
+describe("Box component accessibility tests", function () {
+  it("Should not have basic accessibility issues", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee() {
+    var _render, container, results;
+    return _regenerator["default"].wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Box["default"], {
+            shadowDepth: 0,
+            margin: "medium",
+            size: "small",
+            display: "flex"
+          }, "Box")), container = _render.container;
+          _context.next = 3;
+          return (0, _axeHelper.axe)(container);
+        case 3:
+          results = _context.sent;
+          expect(results).toHaveNoViolations();
+        case 5:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  })));
+});

package/box/Box.d.ts

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

package/box/Box.js

@@ -0,0 +1,75 @@
+"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");
+var _utils = require("../common/utils");
+var _useTheme = _interopRequireDefault(require("../useTheme"));
+var _templateObject;
+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" != _typeof3(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 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,
+    _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(Box, {
+    shadowDepth: shadowDepth,
+    display: display,
+    margin: margin,
+    size: size
+  }, children));
+};
+var sizes = {
+  small: "48px",
+  medium: "240px",
+  large: "480px",
+  fillParent: "100%",
+  fitContent: "fit-content"
+};
+var calculateWidth = function calculateWidth(margin, size) {
+  return size === "fillParent" ? "calc(".concat(sizes[size], " - ").concat((0, _utils.getMargin)(margin, "left"), " - ").concat((0, _utils.getMargin)(margin, "right"), ")") : sizes[size];
+};
+var Box = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  display: ", ";\n  border-radius: ", ";\n  border-width: ", ";\n  border-style: ", ";\n  border-color: ", ";\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"])), function (props) {
+  return props.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 calculateWidth(props.margin, props.size);
+}, 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 (props) {
+  return props.margin && (0, _typeof2["default"])(props.margin) !== "object" ? _variables.spaces[props.margin] : "0px";
+}, function (props) {
+  return props.margin && (0, _typeof2["default"])(props.margin) === "object" && props.margin.top ? _variables.spaces[props.margin.top] : "";
+}, function (props) {
+  return props.margin && (0, _typeof2["default"])(props.margin) === "object" && props.margin.right ? _variables.spaces[props.margin.right] : "";
+}, function (props) {
+  return props.margin && (0, _typeof2["default"])(props.margin) === "object" && props.margin.bottom ? _variables.spaces[props.margin.bottom] : "";
+}, function (props) {
+  return props.margin && (0, _typeof2["default"])(props.margin) === "object" && props.margin.left ? _variables.spaces[props.margin.left] : "";
+});
+var _default = exports["default"] = DxcBox;

package/box/Box.stories.tsx

@@ -0,0 +1,119 @@
+import React from "react";
+import Title from "../../.storybook/components/Title";
+import ExampleContainer from "../../.storybook/components/ExampleContainer";
+import DxcBox from "./Box";
+import DxcInset from "../inset/Inset";
+import { HalstackProvider } from "../HalstackContext";
+
+export default {
+  title: "Box ",
+  component: DxcBox,
+};
+
+const opinionatedTheme = {
+  box: {
+    baseColor: "#ffffff",
+  },
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="Display flex" theme="light" level={2} />
+    <ExampleContainer>
+      <DxcBox display="flex">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <Title title="ShadowDepth" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="ShadowDepth 0" theme="light" level={4} />
+      <DxcBox shadowDepth={0} margin="medium">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="ShadowDepth 1" theme="light" level={4} />
+      <DxcBox shadowDepth={1} margin="medium">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="ShadowDepth 2" theme="light" level={4} />
+      <DxcBox shadowDepth={2} margin="medium">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <Title title="Margins" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall margin" theme="light" level={4} />
+      <DxcBox margin="xxsmall">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xsmall margin" theme="light" level={4} />
+      <DxcBox margin="xsmall">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Small margin" theme="light" level={4} />
+      <DxcBox margin="small">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Medium margin" theme="light" level={4} />
+      <DxcBox margin="medium">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large margin" theme="light" level={4} />
+      <DxcBox margin="large">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xlarge margin" theme="light" level={4} />
+      <DxcBox margin="xlarge">
+        <DxcInset space="2rem">Box</DxcInset>
+      </DxcBox>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xxlarge margin" theme="light" level={4} />
+      <DxcBox margin="xxlarge">
+        <DxcInset space="2rem">Box</DxcInset>
+      </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>
+    <Title title="Opinionated theme" theme="light" level={2} />
+    <ExampleContainer>
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcBox display="flex">
+          <DxcInset space="2rem">Box</DxcInset>
+        </DxcBox>
+      </HalstackProvider>
+    </ExampleContainer>
+  </>
+);

package/box/Box.test.d.ts

@@ -0,0 +1 @@
+export {};

package/box/Box.test.js

@@ -0,0 +1,13 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _react = _interopRequireDefault(require("react"));
+var _react2 = require("@testing-library/react");
+var _Card = _interopRequireDefault(require("../card/Card"));
+describe("Box component tests", function () {
+  test("Box renders with correct text", function () {
+    var _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Card["default"], null, "test-box")),
+      getByText = _render.getByText;
+    expect(getByText("test-box")).toBeTruthy();
+  });
+});

package/box/types.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="react" />
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
+    top?: Space;
+    bottom?: Space;
+    left?: Space;
+    right?: Space;
+};
+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 component.
+     */
+    size?: "small" | "medium" | "large" | "fillParent" | "fitContent";
+};
+export default Props;