carbon-react 105.1.2 → 106.0.1

package/esm/components/button/button.d.ts

@@ -1,85 +0,0 @@
-import * as React from "react";
-import { SpaceProps } from "styled-system";
-import { IconType } from "components/icon/icon";
-
-export type ButtonTypes =
-  | "primary"
-  | "secondary"
-  | "tertiary"
-  | "dashed"
-  | "destructive"
-  | "darkBackground";
-
-export interface ButtonBaseProps extends SpaceProps {
-  /** Prop to specify the aria-label text.
-   *  Only to be used in Button when only an icon is rendered.
-   * This is required to comply with WCAG 4.1.2 - Buttons must have discernible text
-   */
-  "aria-label"?: string;
-  /** [Legacy] Button types for legacy theme: "primary" | "secondary" */
-  as?: ButtonTypes;
-  /** Color variants for new business themes: "primary" | "secondary" | "tertiary" | "darkBackground" */
-  buttonType?: ButtonTypes;
-  /** The text the button displays */
-  children?: React.ReactNode;
-  /** Apply disabled state to the button */
-  disabled?: boolean;
-  /** Apply destructive style to the button */
-  destructive?: boolean;
-  /** Ref to be forwarded */
-  forwardRef?: React.Ref<HTMLButtonElement>;
-  /** Apply fullWidth style to the button */
-  fullWidth?: boolean;
-  /** Used to transform button into anchor */
-  href?: string;
-  /** Defines an Icon position related to the children: "before" | "after" */
-  iconPosition?: "before" | "after";
-  /** Provides a tooltip message when the icon is hovered. */
-  iconTooltipMessage?: string;
-  /** Provides positioning when the tooltip is displayed. */
-  iconTooltipPosition?: string;
-  /** Defines an Icon type within the button */
-  iconType?: IconType;
-  /** If provided, the text inside a button will not wrap */
-  noWrap?: boolean;
-  /** Specify a callback triggered on blur */
-  onBlur?: (ev: React.FocusEvent<HTMLButtonElement>) => void;
-  /** Specify a callback triggered on change */
-  onChange?: (ev: React.ChangeEvent<HTMLButtonElement>) => void;
-  /** Specify a callback triggered on focus */
-  onFocus?: (ev: React.FocusEvent<HTMLButtonElement>) => void;
-  /** Specify a callback triggered on keyDown */
-  onKeyDown?: (ev: React.KeyboardEvent<HTMLButtonElement>) => void;
-  /** Assigns a size to the button: "small" | "medium" | "large" */
-  size?: "small" | "medium" | "large";
-  /** Second text child, renders under main text, only when size is "large" */
-  subtext?: string;
-  /** HTML button type property */
-  type?: string;
-  /** HTML target attribute */
-  target?: string;
-  /** HTML rel attribute */
-  rel?: string;
-}
-
-export interface ButtonLinkProps extends ButtonBaseProps {
-  /** onClick handler */
-  onClick?: (event: React.MouseEvent<HTMLAnchorElement>) => void;
-}
-
-export interface ButtonDefaultProps extends ButtonBaseProps {
-  /** onClick handler */
-  onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
-}
-
-export type ButtonProps = ButtonLinkProps | ButtonDefaultProps;
-
-declare function Button(props: ButtonProps): JSX.Element;
-declare function ButtonWithForwardRef(
-  props: ButtonProps &
-    React.RefAttributes<HTMLButtonElement> &
-    React.HTMLProps<HTMLButtonElement>
-): JSX.Element;
-
-export { ButtonWithForwardRef };
-export default Button;

package/esm/components/tooltip/tooltip.d.ts

@@ -1,40 +0,0 @@
-import * as React from "react";
-
-export interface TooltipProps {
-  /** The message to be displayed within the tooltip */
-  message: React.ReactNode;
-  /** The id attribute to use for the tooltip */
-  id?: string;
-  /** Whether to to show the Tooltip */
-  isVisible?: boolean;
-  /** Sets position of the tooltip */
-  position?: "top" | "bottom" | "left" | "right";
-  /** Defines the message type */
-  type?: string;
-  /** Children elements */
-  children: React.ReactNode;
-  /** Defines the size of the tooltip content */
-  size?: "small" | "large";
-  /** Override background color of the Tooltip, provide any color from palette or any valid css color value. */
-  bgColor?: string;
-  /** Override font color of the Tooltip, provide any color from palette or any valid css color value. */
-  fontColor?: string;
-  /**
-   * Overrides the default flip behaviour of the Tooltip,
-   * must be an array containing some or all of ["top", "bottom", "left", "right"]
-   * (see https://popper.js.org/docs/v2/modifiers/flip/#fallbackplacements)
-   */
-  flipOverrides?: ["top" | "bottom" | "left" | "right"];
-  target?: Element;
-}
-
-export interface TooltipInternalProps extends TooltipProps {
-  isPartOfInput?: boolean;
-  inputSize?: "small" | "medium" | "large";
-}
-
-declare function Tooltip(
-  props: TooltipProps & React.RefAttributes<HTMLDivElement>
-): JSX.Element;
-
-export default Tooltip;

package/lib/__internal__/utils/ether/ether.d.ts

@@ -1,19 +0,0 @@
-/**
- * Ether
- *
- * Ether provides functional-like helper methods for Carbon specific tasks.
- * As we are dealing with stateful values (user input, browser state) Ether
- * does not provide pure functions in all cases.
- */
-/**
- * Returns the props that were passed to a component but excludes the props listed in propTypes
- *
- * Optionally includes the safeProps which can be defined as a static property on a Class or passed as the second
- * argument.
- *
- * @method validProps
- * @param {Object} instance
- * @param {Array?} safeProps
- * @return {Object} props
- */
-export function validProps(instance: Object, safeProps: any[] | null): Object;

package/lib/__internal__/utils/ether/ether.js

@@ -1,33 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.validProps = validProps;
-
-var _lodash = require("lodash");
-
-/**
- * Ether
- *
- * Ether provides functional-like helper methods for Carbon specific tasks.
- * As we are dealing with stateful values (user input, browser state) Ether
- * does not provide pure functions in all cases.
- */
-
-/**
- * Returns the props that were passed to a component but excludes the props listed in propTypes
- *
- * Optionally includes the safeProps which can be defined as a static property on a Class or passed as the second
- * argument.
- *
- * @method validProps
- * @param {Object} instance
- * @param {Array?} safeProps
- * @return {Object} props
- */
-function validProps(instance, safeProps) {
-  const component = instance.isReactComponent ? instance.constructor : instance;
-  const unsafeProps = (0, _lodash.difference)(Object.keys(component.propTypes), safeProps || component.safeProps || []);
-  return (0, _lodash.omit)(instance.props, unsafeProps);
-} // eslint-disable-next-line import/prefer-default-export

package/lib/__internal__/utils/ether/index.d.ts

@@ -1 +0,0 @@
-export * from "./ether";

package/lib/__internal__/utils/ether/index.js

@@ -1,18 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-
-var _ether = require("./ether");
-
-Object.keys(_ether).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _ether[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function () {
-      return _ether[key];
-    }
-  });
-});

package/lib/__internal__/utils/helpers/browser/browser.d.ts

@@ -1,17 +0,0 @@
-export default Browser;
-declare namespace Browser {
-    function isDomAvailable(): boolean;
-    function getWindow(): any;
-    function getDocument(): Document;
-    function getActiveElement(): Element | null;
-    function redirectTo(url: any): void;
-    function redirectAfter(url: any, seconds: any): NodeJS.Timeout;
-    function reload(): void;
-    function editFocus(ref: any): void;
-    function setFocus(reactNode: any): void;
-    function setInputFocus(inputComponent: any): void;
-    function setCookie(name: any, value: any, options?: Object): void;
-    function getCookie(name: string): string | null;
-    function postToNewWindow(url: string, data: Object, target?: Object): void;
-    function submitForm(form: any): void;
-}

package/lib/__internal__/utils/helpers/browser/browser.js

@@ -1,213 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _reactDom = _interopRequireDefault(require("react-dom"));
-
-var _lodash = require("lodash");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-/**
-* Browser Helper
-
-*
-* Provides helper methods for working with Browser behavior.
-*
-*/
-const Browser = {
-  isDomAvailable: () => {
-    const _window = Browser.getWindow();
-
-    const _document = Browser.getDocument();
-
-    return !!(typeof _window !== "undefined" && _document && _document.createElement);
-  },
-
-  /**
-   * Get the current window
-   *
-   * @return window
-   */
-  getWindow: () => {
-    return global.window;
-  },
-
-  /**
-   * Get the current document
-   *
-   * @return window
-   */
-  getDocument: () => {
-    return document;
-  },
-
-  /**
-   * Get the current activeElement
-   *
-   * @return HTMLElement
-   */
-  getActiveElement: () => {
-    const doc = Browser.getDocument();
-    return doc.activeElement;
-  },
-
-  /**
-   * Redirect to URL
-   *
-   * @method redirectTo
-   * @param url => URL string format
-   */
-  redirectTo: url => {
-    Browser.getWindow().location = url;
-  },
-
-  /**
-   * Redirects to URL after the given number of seconds have elapsed
-   *
-   * @method redirectAfter
-   * @param url => URL string format
-   * @param seconds => the number of seconds to wait before redirecting
-   */
-  redirectAfter: (url, seconds) => {
-    return setTimeout(() => Browser.redirectTo(url), seconds * 1000);
-  },
-
-  /**
-   * Reload the current page
-   *
-   * @method reload
-   */
-  reload: () => {
-    Browser.getWindow().location.reload();
-  },
-
-  /**
-   * Focuses and sets cursor of input field
-   *
-   * @method editFocus
-   */
-  editFocus: ref => {
-    const node = _reactDom.default.findDOMNode(ref._input); // eslint-disable-line react/no-find-dom-node
-
-
-    node.focus();
-    node.select();
-  },
-
-  /**
-   * Focuses and sets cursor of react node
-   *
-   * @method setFocus
-   */
-  setFocus: reactNode => {
-    const node = _reactDom.default.findDOMNode(reactNode); // eslint-disable-line react/no-find-dom-node
-
-
-    node.focus();
-  },
-
-  /**
-   *  Focuses and sets cursor of input field but does not select text
-   *
-   * @method setInputFocus
-   */
-  setInputFocus: inputComponent => {
-    Browser.setFocus(inputComponent._input);
-  },
-
-  /**
-   * Sets a cookie where name=value
-   *
-   * @param {Object} options includes expires or max-age
-   * @method setCookie
-   */
-  setCookie: (name, value, options = {}) => {
-    let cookie = `${name}=${value}`;
-
-    if (options.expires) {
-      cookie += `; expires=${options.expires}`;
-    }
-
-    if (options["max-age"]) {
-      cookie += `; max-age=${options["max-age"]}`;
-    }
-
-    Browser.getDocument().cookie = cookie;
-  },
-
-  /**
-   * Returns a cookies value by passed name
-   *
-   * @param {String} name cookie name key
-   * @method getCookieValueByName
-   */
-  getCookie: name => {
-    const cookies = Browser.getDocument().cookie.split(";");
-
-    for (let i = 0; i < cookies.length; i++) {
-      const cookie = cookies[i].trim().split("=");
-
-      if (cookie[0] === name) {
-        return cookie[1];
-      }
-    }
-
-    return null;
-  },
-
-  /**
-   * Submits POST in new window
-   *
-   * @method  postToNewWindow
-   * @param   {String}  url     URL to POST to
-   * @param   {Object}  data    Data to POST
-   * @param   {Object}  target  Optional target window name
-   * @return  {Void}
-   */
-  postToNewWindow: (url, data, target = "_blank") => {
-    const doc = Browser.getDocument(),
-          containerId = "carbonPostFormContainer";
-    let container = doc.getElementById(containerId);
-
-    if (!container) {
-      container = doc.createElement("div");
-      container.setAttribute("id", containerId);
-      doc.body.appendChild(container);
-    }
-
-    _reactDom.default.render( /*#__PURE__*/_react.default.createElement("form", {
-      action: url,
-      method: "post",
-      target: target
-    }, (0, _lodash.keys)(data).map(key => {
-      return /*#__PURE__*/_react.default.createElement("input", {
-        type: "hidden",
-        key: key,
-        name: key,
-        value: data[key]
-      });
-    })), container, function () {
-      Browser.submitForm(this);
-    });
-
-    _reactDom.default.unmountComponentAtNode(container);
-  },
-
-  /**
-   * Submits a passed Form
-   *
-   * @method submitForm
-   * @param {HTML Form} form to submit
-   */
-  submitForm: form => {
-    form.submit();
-  }
-};
-var _default = Browser;
-exports.default = _default;

package/lib/__internal__/utils/helpers/browser-type-check/browser-type-check.d.ts

@@ -1,7 +0,0 @@
-export function isSafari(navigator: any): any;
-export function isEdge(navigator: any): any;
-export default browserTypeCheck;
-/**
- * Check for Chrome or Firefox.
- */
-declare function browserTypeCheck(_window: any): boolean;

package/lib/__internal__/utils/helpers/browser-type-check/browser-type-check.js

@@ -1,26 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isSafari = isSafari;
-exports.isEdge = isEdge;
-exports.default = void 0;
-
-/**
- * Check for Chrome or Firefox.
- */
-function browserTypeCheck(_window) {
-  return Boolean(_window.chrome || _window.sidebar);
-}
-
-function isSafari(navigator) {
-  return navigator.vendor.includes("Apple");
-}
-
-function isEdge(navigator) {
-  return navigator.userAgent.includes("Edge");
-}
-
-var _default = browserTypeCheck;
-exports.default = _default;

package/lib/__internal__/utils/helpers/guid/__spec__.d.ts

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

package/lib/__internal__/utils/helpers/guid/__spec__.js

@@ -1,15 +0,0 @@
-"use strict";
-
-var _guid = _interopRequireDefault(require("./guid"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-describe("guid", () => {
-  it("returns a 36 character id", () => {
-    expect((0, _guid.default)().length).toEqual(36);
-  });
-  it("returns a unique id", () => {
-    const id = (0, _guid.default)();
-    expect((0, _guid.default)()).not.toEqual(id);
-  });
-});

package/lib/__internal__/utils/helpers/guid/guid.d.ts

@@ -1,2 +0,0 @@
-declare function _default(): string;
-export default _default;

package/lib/__internal__/utils/helpers/immutable/__spec__.d.ts

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

package/lib/__internal__/utils/helpers/immutable/__spec__.js

@@ -1,135 +0,0 @@
-"use strict";
-
-var _immutable = _interopRequireDefault(require("immutable"));
-
-var _immutable2 = _interopRequireDefault(require("./immutable"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-describe("Immutable Helper", () => {
-  describe("parseJSON", () => {
-    describe("when the passed json is not an object", () => {
-      it("returns the json", () => {
-        expect(_immutable2.default.parseJSON("a")).toEqual("a");
-      });
-    });
-    describe("when the passed json is null", () => {
-      it("returns null", () => {
-        expect(_immutable2.default.parseJSON(null)).toBeNull();
-      });
-    });
-    describe("when the JSON is a simple array", () => {
-      let data, expectedData, result;
-      beforeEach(() => {
-        data = ["a", "b", "c"];
-        expectedData = _immutable.default.Seq(data).toList();
-        result = _immutable2.default.parseJSON(data);
-      });
-      it("returns a immutable object of that array", () => {
-        expect(result).toEqual(expectedData);
-        expect(result.get(0)).toEqual("a");
-        expect(result.get(1)).toEqual("b");
-        expect(result.get(2)).toEqual("c");
-      });
-    });
-    describe("when the JSON object is a array of objects", () => {
-      let data, result;
-      it("returns a immutable object of that array", () => {
-        data = [{
-          foo: "a"
-        }, {
-          bar: "b"
-        }, {
-          baz: "c"
-        }];
-        result = _immutable2.default.parseJSON(data);
-        expect(result.get(0).get("foo")).toEqual("a");
-        expect(result.get(1).get("bar")).toEqual("b");
-        expect(result.get(2).get("baz")).toEqual("c");
-      });
-    });
-    describe("when JSON is a object", () => {
-      let data, expectedData;
-      beforeEach(() => {
-        data = {
-          foo: "bar",
-          baz: "qux"
-        };
-        expectedData = _immutable.default.Seq(data).toMap();
-      });
-      it("returns a ordered immutable map", () => {
-        const result = _immutable2.default.parseJSON(data);
-
-        expect(result).toEqual(expectedData);
-        expect(result.get("foo")).toEqual("bar");
-        expect(result.get("baz")).toEqual("qux");
-      });
-    });
-    describe("when JSON is a complex value with nest arrays and objects", () => {
-      let data, expectedData;
-      beforeEach(() => {
-        data = [{
-          foo: "bar",
-          baz: "qux"
-        }, {
-          a: ["a", "b", "c"],
-          b: "b"
-        }];
-
-        const obj1 = _immutable.default.Seq({
-          foo: "bar",
-          baz: "qux"
-        }).toMap();
-
-        const array1 = _immutable.default.Seq(["a", "b", "c"]).toList();
-
-        const obj2 = _immutable.default.Seq({
-          a: array1,
-          b: "b"
-        }).toMap();
-
-        expectedData = _immutable.default.Seq([obj1, obj2]).toList();
-      });
-      it("creates a immutable object in the same format", () => {
-        const result = _immutable2.default.parseJSON(data);
-
-        expect(result.toJS()).toEqual(expectedData.toJS());
-      });
-    });
-    describe("when passed a number", () => {
-      it("casts it to a string", () => {
-        expect(_immutable2.default.parseJSON(1)).toEqual(_immutable.default.fromJS("1"));
-        expect(_immutable2.default.parseJSON(3.142)).toEqual(_immutable.default.fromJS("3.142"));
-      });
-      describe("as a nested element", () => {
-        it("casts all numbers to a string", () => {
-          const data = [{
-            foo: "bar",
-            baz: "qux"
-          }, {
-            a: [1, 2, "c"],
-            b: 2
-          }];
-
-          const obj1 = _immutable.default.Seq({
-            foo: "bar",
-            baz: "qux"
-          }).toMap();
-
-          const array1 = _immutable.default.Seq(["1", "2", "c"]).toList();
-
-          const obj2 = _immutable.default.Seq({
-            a: array1,
-            b: "2"
-          }).toMap();
-
-          const expectedData = _immutable.default.Seq([obj1, obj2]).toList();
-
-          const result = _immutable2.default.parseJSON(data);
-
-          expect(result.toJS()).toEqual(expectedData.toJS());
-        });
-      });
-    });
-  });
-});

package/lib/__internal__/utils/helpers/immutable/immutable.d.ts

@@ -1,4 +0,0 @@
-export default ImmutableHelper;
-declare namespace ImmutableHelper {
-    function parseJSON(js: Object): any;
-}

package/lib/__internal__/utils/helpers/immutable/immutable.js

@@ -1,46 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-var _immutable = _interopRequireDefault(require("immutable"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-/**
- * Immutable Helper
- *
- * Provides helper methods for working with immutable data.
- *
- * @object ImmutableHelper
- * @param {String} name
- * @param {Object} form
- */
-const ImmutableHelper = {
-  /**
-   * Parses a regular JSON object into an Immutable data object, mapping the data
-   * correctly and applying custom transforms to make the data easier to work with.
-   *
-   * @method parseJSON
-   * @param {Object} js
-   */
-  parseJSON: js => {
-    if (typeof js !== "object" || js === null) {
-      if (typeof js === "number") {
-        return String(js);
-      }
-
-      return js;
-    }
-
-    if (Array.isArray(js)) {
-      return _immutable.default.Seq(js).map(ImmutableHelper.parseJSON).toList();
-    }
-
-    return _immutable.default.Seq(js).map(ImmutableHelper.parseJSON).toMap();
-  }
-};
-var _default = ImmutableHelper;
-exports.default = _default;

package/lib/__internal__/utils/helpers/immutable/package.json

@@ -1,4 +0,0 @@
-{
-  "name": "immutable",
-  "main": "./immutable.js"
-}

package/lib/__internal__/utils/helpers/with-unique-id-props/index.d.ts

@@ -1 +0,0 @@
-export { default } from "./with-unique-id-props.hoc";