@dxc-technology/halstack-react 0.0.0-3a698b0 → 0.0.0-3ac400c

package/container/Container.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import ContainerPropsType from "./types";
+declare const DxcContainer: ({ display, width, height, overflow, ...props }: ContainerPropsType) => React.JSX.Element;
+export default DxcContainer;

package/container/Container.js

@@ -0,0 +1,194 @@
+"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 _coreTokens = require("../common/coreTokens");
+var _templateObject;
+var _excluded = ["display", "width", "height", "overflow"];
+/**
+ * This values correspond to the spaces defined in the design system
+ * https://developer.dxc.com/halstack/next/principles/spacing/#component-spacing-tokens
+ */
+var spaces = {
+  xxsmall: "4px",
+  xsmall: "8px",
+  small: "12px",
+  medium: "16px",
+  large: "24px",
+  xlarge: "32px",
+  xxlarge: "48px"
+};
+var DxcContainer = function DxcContainer(_ref) {
+  var display = _ref.display,
+    width = _ref.width,
+    height = _ref.height,
+    overflow = _ref.overflow,
+    props = (0, _objectWithoutProperties2["default"])(_ref, _excluded);
+  return /*#__PURE__*/_react["default"].createElement(Container, (0, _extends2["default"])({
+    $display: display,
+    $width: width,
+    $height: height,
+    $overflow: overflow
+  }, props));
+};
+var getBorderStyles = function getBorderStyles(direction, borderProperties) {
+  var _borderProperties$wid, _borderProperties$sty, _getCoreColorToken;
+  return "border-".concat(direction, ": ").concat((_borderProperties$wid = borderProperties === null || borderProperties === void 0 ? void 0 : borderProperties.width) !== null && _borderProperties$wid !== void 0 ? _borderProperties$wid : "", " ").concat((_borderProperties$sty = borderProperties === null || borderProperties === void 0 ? void 0 : borderProperties.style) !== null && _borderProperties$sty !== void 0 ? _borderProperties$sty : "", " ").concat((_getCoreColorToken = (0, _coreTokens.getCoreColorToken)(borderProperties === null || borderProperties === void 0 ? void 0 : borderProperties.color)) !== null && _getCoreColorToken !== void 0 ? _getCoreColorToken : "", ";");
+};
+var Container = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n  box-sizing: ", ";\n  display: ", ";\n  width: ", ";\n  height: ", ";\n  max-width: ", ";\n  max-height: ", ";\n  min-width: ", ";\n  min-height: ", ";\n  position: ", ";\n  top: ", ";\n  right: ", ";\n  bottom: ", ";\n  left: ", ";\n  float: ", ";\n  z-index: ", ";\n  box-shadow: ", ";\n\n  background-attachment: ", ";\n  background-clip: ", ";\n  background-color: ", ";\n  background-image: ", ";\n  background-origin: ", ";\n  background-position: ", ";\n  background-repeat: ", ";\n  background-size: ", ";\n\n  border-radius: ", ";\n  border-width: ", ";\n  border-style: ", ";\n  border-width: ", ";\n\n  ", ";\n\n  margin: ", ";\n  margin-top: ", ";\n  margin-right: ", ";\n  margin-bottom: ", ";\n  margin-left: ", ";\n\n  outline: ", ";\n  outline-offset: ", ";\n\n  overflow: ", ";\n  overflow-x: ", ";\n  overflow-y: ", ";\n\n  padding: ", ";\n  padding-top: ", ";\n  padding-right: ", ";\n  padding-bottom: ", ";\n  padding-left: ", ";\n"])), function (_ref2) {
+  var boxSizing = _ref2.boxSizing;
+  return boxSizing;
+}, function (_ref3) {
+  var $display = _ref3.$display;
+  return $display;
+}, function (_ref4) {
+  var $width = _ref4.$width;
+  return $width;
+}, function (_ref5) {
+  var $height = _ref5.$height;
+  return $height;
+}, function (_ref6) {
+  var maxWidth = _ref6.maxWidth;
+  return maxWidth;
+}, function (_ref7) {
+  var maxHeight = _ref7.maxHeight;
+  return maxHeight;
+}, function (_ref8) {
+  var minWidth = _ref8.minWidth;
+  return minWidth;
+}, function (_ref9) {
+  var minHeight = _ref9.minHeight;
+  return minHeight;
+}, function (_ref10) {
+  var position = _ref10.position;
+  return position;
+}, function (_ref11) {
+  var inset = _ref11.inset;
+  return inset === null || inset === void 0 ? void 0 : inset.top;
+}, function (_ref12) {
+  var inset = _ref12.inset;
+  return inset === null || inset === void 0 ? void 0 : inset.right;
+}, function (_ref13) {
+  var inset = _ref13.inset;
+  return inset === null || inset === void 0 ? void 0 : inset.bottom;
+}, function (_ref14) {
+  var inset = _ref14.inset;
+  return inset === null || inset === void 0 ? void 0 : inset.left;
+}, function (_ref15) {
+  var _float = _ref15["float"];
+  return _float;
+}, function (_ref16) {
+  var zIndex = _ref16.zIndex;
+  return zIndex;
+}, function (_ref17) {
+  var boxShadow = _ref17.boxShadow;
+  return boxShadow;
+}, function (_ref18) {
+  var background = _ref18.background;
+  return background === null || background === void 0 ? void 0 : background.attachment;
+}, function (_ref19) {
+  var background = _ref19.background;
+  return background === null || background === void 0 ? void 0 : background.clip;
+}, function (_ref20) {
+  var background = _ref20.background;
+  return (0, _coreTokens.getCoreColorToken)(background === null || background === void 0 ? void 0 : background.color);
+}, function (_ref21) {
+  var background = _ref21.background;
+  return background === null || background === void 0 ? void 0 : background.image;
+}, function (_ref22) {
+  var background = _ref22.background;
+  return background === null || background === void 0 ? void 0 : background.origin;
+}, function (_ref23) {
+  var background = _ref23.background;
+  return background === null || background === void 0 ? void 0 : background.position;
+}, function (_ref24) {
+  var background = _ref24.background;
+  return background === null || background === void 0 ? void 0 : background.repeat;
+}, function (_ref25) {
+  var background = _ref25.background;
+  return background === null || background === void 0 ? void 0 : background.size;
+}, function (_ref26) {
+  var borderRadius = _ref26.borderRadius;
+  return borderRadius;
+}, function (_ref27) {
+  var border = _ref27.border;
+  return border && "width" in border ? "".concat(border === null || border === void 0 ? void 0 : border.width) : "";
+}, function (_ref28) {
+  var border = _ref28.border;
+  return border && "style" in border ? "".concat(border === null || border === void 0 ? void 0 : border.style) : "";
+}, function (_ref29) {
+  var border = _ref29.border;
+  return border && "color" in border ? "".concat((0, _coreTokens.getCoreColorToken)(border === null || border === void 0 ? void 0 : border.color)) : "";
+}, function (_ref30) {
+  var border = _ref30.border;
+  if (border != null) {
+    var styles = "";
+    switch (true) {
+      case "top" in border:
+        styles += getBorderStyles("top", border.top);
+      case "right" in border:
+        styles += getBorderStyles("right", border.right);
+      case "left" in border:
+        styles += getBorderStyles("left", border.left);
+      case "bottom" in border:
+        styles += getBorderStyles("bottom", border.bottom);
+    }
+    return styles;
+  }
+}, function (_ref31) {
+  var margin = _ref31.margin;
+  return typeof margin === "string" ? spaces[margin] : "";
+}, function (_ref32) {
+  var margin = _ref32.margin;
+  return (0, _typeof2["default"])(margin) === "object" ? spaces[margin.top] : "";
+}, function (_ref33) {
+  var margin = _ref33.margin;
+  return (0, _typeof2["default"])(margin) === "object" ? spaces[margin.right] : "";
+}, function (_ref34) {
+  var margin = _ref34.margin;
+  return (0, _typeof2["default"])(margin) === "object" ? spaces[margin.bottom] : "";
+}, function (_ref35) {
+  var margin = _ref35.margin;
+  return (0, _typeof2["default"])(margin) === "object" ? spaces[margin.left] : "";
+}, function (_ref36) {
+  var _outline$width, _outline$style, _getCoreColorToken2;
+  var outline = _ref36.outline;
+  return "".concat((_outline$width = outline === null || outline === void 0 ? void 0 : outline.width) !== null && _outline$width !== void 0 ? _outline$width : "", " ").concat((_outline$style = outline === null || outline === void 0 ? void 0 : outline.style) !== null && _outline$style !== void 0 ? _outline$style : "", " ").concat((_getCoreColorToken2 = (0, _coreTokens.getCoreColorToken)(outline === null || outline === void 0 ? void 0 : outline.color)) !== null && _getCoreColorToken2 !== void 0 ? _getCoreColorToken2 : "");
+}, function (_ref37) {
+  var outline = _ref37.outline;
+  return outline === null || outline === void 0 ? void 0 : outline.offset;
+}, function (_ref38) {
+  var $overflow = _ref38.$overflow;
+  return typeof $overflow === "string" ? $overflow : "";
+}, function (_ref39) {
+  var $overflow = _ref39.$overflow;
+  return (0, _typeof2["default"])($overflow) === "object" ? "".concat($overflow === null || $overflow === void 0 ? void 0 : $overflow.x) : "";
+}, function (_ref40) {
+  var $overflow = _ref40.$overflow;
+  return (0, _typeof2["default"])($overflow) === "object" ? "".concat($overflow === null || $overflow === void 0 ? void 0 : $overflow.y) : "";
+}, function (_ref41) {
+  var padding = _ref41.padding;
+  return typeof padding === "string" ? spaces[padding] : "";
+}, function (_ref42) {
+  var padding = _ref42.padding;
+  return (0, _typeof2["default"])(padding) === "object" ? spaces[padding.top] : "";
+}, function (_ref43) {
+  var padding = _ref43.padding;
+  return (0, _typeof2["default"])(padding) === "object" ? spaces[padding.right] : "";
+}, function (_ref44) {
+  var padding = _ref44.padding;
+  return (0, _typeof2["default"])(padding) === "object" ? spaces[padding.bottom] : "";
+}, function (_ref45) {
+  var padding = _ref45.padding;
+  return (0, _typeof2["default"])(padding) === "object" ? spaces[padding.left] : "";
+});
+var _default = exports["default"] = DxcContainer;

package/container/Container.stories.tsx

@@ -0,0 +1,214 @@
+import React from "react";
+import Title from "../../.storybook/components/Title";
+import ExampleContainer from "../../.storybook/components/ExampleContainer";
+import DxcContainer from "./Container";
+import DxcParagraph from "../paragraph/Paragraph";
+import DxcTypography from "../typography/Typography";
+
+export default {
+  title: "Container",
+  component: DxcContainer,
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="Box sizing border box" level={4} />
+    <ExampleContainer>
+      <DxcContainer
+        boxSizing="border-box"
+        width="200px"
+        height="200px"
+        background={{ color: "color_purple_400" }}
+        border={{
+          top: {
+            width: "2px",
+            color: "color_blue_600",
+            style: "solid",
+          },
+          bottom: {
+            width: "thick",
+            color: "color_purple_600",
+            style: "solid",
+          },
+        }}
+        borderRadius="0 0 0.25rem 0.25rem"
+        padding="medium"
+        margin="large"
+      >
+        <b>Example text</b>
+      </DxcContainer>
+    </ExampleContainer>
+    <Title title="Background image" level={4} />
+    <ExampleContainer>
+      <DxcContainer
+        background={{
+          image: "url(https://www.laecuaciondigital.com/wp-content/uploads/2023/10/DXC-Technology.png)",
+          position: "50%",
+        }}
+        width="500px"
+        height="500px"
+      >
+        <p>Example text</p>
+      </DxcContainer>
+    </ExampleContainer>
+    <Title title="Positioning of boxes" level={4} />
+    <ExampleContainer>
+      <DxcContainer
+        position="relative"
+        width="fit-content"
+        border={{ color: "color_purple_400", width: "2px", style: "dashed" }}
+        borderRadius="0.25rem"
+        margin={{ bottom: "xxlarge" }}
+      >
+        <DxcContainer display="inline-block" background={{ color: "color_purple_400" }} width="50px" height="50px">
+          <b>1</b>
+        </DxcContainer>
+        <DxcContainer display="inline-block" background={{ color: "color_purple_400" }} width="50px" height="50px">
+          <b>2</b>
+        </DxcContainer>
+        <DxcContainer
+          display="inline-block"
+          position="absolute"
+          inset={{ top: "25px", left: "0" }}
+          background={{ color: "color_blue_500" }}
+          width="50px"
+          height="50px"
+          zIndex={1}
+        >
+          <b>3</b>
+        </DxcContainer>
+      </DxcContainer>
+    </ExampleContainer>
+    <Title title="Margin collapse" level={4} />
+    <ExampleContainer>
+      <DxcContainer
+        width="fit-content"
+        border={{ color: "color_purple_400", width: "2px", style: "dashed" }}
+        borderRadius="0.25rem"
+      >
+        <DxcContainer
+          background={{ color: "color_purple_400" }}
+          width="50px"
+          height="50px"
+          margin={{ bottom: "medium" }}
+        >
+          <b>1</b>
+        </DxcContainer>
+        <DxcContainer background={{ color: "color_purple_400" }} width="50px" height="50px" margin={{ top: "large" }}>
+          <b>2</b>
+        </DxcContainer>
+      </DxcContainer>
+    </ExampleContainer>
+    <Title title="Overflow" level={4} />
+    <ExampleContainer>
+      <DxcContainer overflow={{ x: "auto" }} maxHeight="100px" width="fit-content">
+        <DxcContainer
+          border={{ width: "1px", style: "solid", color: "color_black" }}
+          background={{ color: "color_purple_400" }}
+          width="50px"
+          height="50px"
+        >
+          <b>1</b>
+        </DxcContainer>
+        <DxcContainer
+          border={{ width: "1px", style: "solid", color: "color_black" }}
+          background={{ color: "color_purple_400" }}
+          width="50px"
+          height="50px"
+        >
+          <b>2</b>
+        </DxcContainer>
+        <DxcContainer
+          border={{ width: "1px", style: "solid", color: "color_black" }}
+          background={{ color: "color_purple_400" }}
+          width="50px"
+          height="50px"
+        >
+          <b>3</b>
+        </DxcContainer>
+      </DxcContainer>
+    </ExampleContainer>
+    <Title title="Float" level={4} />
+    <ExampleContainer>
+      <DxcContainer padding="medium" border={{ width: "1px", style: "solid", color: "color_black" }}>
+        <DxcContainer float="right" background={{ color: "color_purple_400" }} width="100px" height="100px">
+          <b>Floating text</b>
+        </DxcContainer>
+        <p style={{ margin: 0 }}>
+          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla facilisis, sapien vitae aliquam lacinia, nisl
+          quam tincidunt ligula, eget aliquam eros quam quis nunc. Donec euismod, nisl eget ultricies aliquam, nisl
+          velit aliquam nunc, quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit
+          aliquam nunc, quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam
+          nunc, quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam nunc,
+          quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam nunc, quis
+          aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam nunc, quis aliquam
+          nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam nunc, quis aliquam nisl.
+        </p>
+      </DxcContainer>
+    </ExampleContainer>
+    <Title title="Box shadow and opacity" level={4} />
+    <ExampleContainer>
+      <DxcContainer
+        padding="medium"
+        outline={{ width: "1px", style: "solid", color: "color_black" }}
+        boxShadow="10px 5px 5px #fe0123"
+      >
+        <p style={{ margin: 0 }}>
+          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla facilisis, sapien vitae aliquam lacinia, nisl
+          quam tincidunt ligula, eget aliquam eros quam quis nunc. Donec euismod, nisl eget ultricies aliquam, nisl
+          velit aliquam nunc, quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit
+          aliquam nunc, quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam
+          nunc, quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam nunc,
+          quis aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam nunc, quis
+          aliquam nisl nunc vel nisl. Donec euismod, nisl eget ultricies aliquam, nisl velit aliquam nunc, quis aliquam
+          nisl.
+        </p>
+      </DxcContainer>
+    </ExampleContainer>
+    <Title title="Building a listbox component" level={4} />
+    <ExampleContainer>
+      <Listbox suggestions={["Option 1", "Option 2", "Option 3", "Option 4", "Option 5"]} />
+    </ExampleContainer>
+    <Title title="Border and outline" level={4} />
+    <ExampleContainer>
+      <DxcContainer
+        outline={{ color: "color_blue_400", style: "solid", offset: "2px" }}
+        border={{ top: { style: "solid" } }}
+      >
+        Example text
+      </DxcContainer>
+    </ExampleContainer>
+  </>
+);
+
+const Listbox = ({ suggestions = [] }: { suggestions: string[] }): JSX.Element => (
+  <DxcContainer
+    boxSizing="border-box"
+    boxShadow="0 4px 6px -1px rgba(0, 0, 0, 0.1)"
+    border={{ width: "1px", style: "solid", color: "color_grey_400" }}
+    borderRadius="0.25rem"
+    background={{ color: "color_white" }}
+    padding={{ top: "xxsmall", bottom: "xxsmall" }}
+    maxHeight="304px"
+    width="250px"
+    overflow={{ x: "hidden", y: "auto" }}
+  >
+    {suggestions.map((suggestion, index) => (
+      <DxcContainer padding={{ left: "xsmall", right: "xsmall" }}>
+        <DxcContainer
+          border={
+            index !== suggestions.length - 1
+              ? { bottom: { width: "1px", style: "solid", color: "color_grey_200" } }
+              : undefined
+          }
+          padding={{ top: "xxsmall", bottom: "xxsmall", left: "xxsmall", right: "xxsmall" }}
+          overflow="hidden"
+        >
+          <DxcTypography whiteSpace="nowrap" textOverflow="ellipsis" lineHeight="1.715em">
+            {suggestion}
+          </DxcTypography>
+        </DxcContainer>
+      </DxcContainer>
+    ))}
+  </DxcContainer>
+);

package/container/types.d.ts

@@ -0,0 +1,74 @@
+/// <reference types="react" />
+import { CoreColorTokens } from "../common/coreTokens";
+type SpacingValues = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Space = SpacingValues | {
+    top?: SpacingValues;
+    right?: SpacingValues;
+    bottom?: SpacingValues;
+    left?: SpacingValues;
+};
+type Inset = {
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+};
+type Background = {
+    attachment?: string;
+    clip?: string;
+    color?: CoreColorTokens;
+    image?: string;
+    origin?: string;
+    position?: string;
+    repeat?: string;
+    size?: string;
+};
+export type BorderProperties = {
+    width?: string;
+    style?: "none" | "dotted" | "dashed" | "solid" | "double" | "groove" | "ridge" | "inset" | "outset";
+    color?: CoreColorTokens;
+};
+type Border = BorderProperties | {
+    top?: BorderProperties;
+    right?: BorderProperties;
+    bottom?: BorderProperties;
+    left?: BorderProperties;
+};
+type Outline = BorderProperties & {
+    offset?: string;
+};
+type OverflowValues = "visible" | "hidden" | "clip" | "scroll" | "auto";
+type Overflow = OverflowValues | {
+    x?: OverflowValues;
+    y?: OverflowValues;
+};
+type Props = {
+    boxSizing?: "border-box" | "content-box";
+    display?: "block" | "inline-block" | "inline" | "none";
+    width?: string;
+    height?: string;
+    maxWidth?: string;
+    maxHeight?: string;
+    minWidth?: string;
+    minHeight?: string;
+    padding?: Space;
+    border?: Border;
+    borderRadius?: string;
+    margin?: Space;
+    overflow?: Overflow;
+    position?: "static" | "relative" | "absolute" | "fixed" | "sticky";
+    inset?: Inset;
+    float?: "left" | "right" | "none";
+    zIndex?: "auto" | number;
+    background?: Background;
+    boxShadow?: string;
+    outline?: Outline;
+    children: React.ReactNode;
+};
+export type StyledProps = Omit<Props, "display" | "width" | "height" | "opacity" | "overflow"> & {
+    $display?: "block" | "inline-block" | "inline" | "none";
+    $width?: string;
+    $height?: string;
+    $overflow?: Overflow;
+};
+export default Props;