@carbon/react 1.23.1 → 1.24.0

package/es/components/Tag/Tag.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Tag/Tag.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/Text.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2018
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/Text.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/TextDirection.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2018
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/TextDirection.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/TextDirectionContext.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/createTextComponent.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2018
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/createTextComponent.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2018
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Text/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TextArea/TextArea.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TextArea/TextArea.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { ReactNodeLike } from 'prop-types';
+import React from 'react';
+type ExcludedAttributes = '';
+export interface TextAreaProps extends Omit<React.InputHTMLAttributes<HTMLTextAreaElement>, ExcludedAttributes> {
+    /**
+     * Provide a custom className that is applied directly to the underlying
+     * `<textarea>` node
+     */
+    className?: string;
+    /**
+     * Specify the `cols` attribute for the underlying `<textarea>` node
+     */
+    cols?: number;
+    /**
+     * Optionally provide the default value of the `<textarea>`
+     */
+    defaultValue?: string | number;
+    /**
+     * Specify whether the control is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify whether to display the character counter
+     */
+    enableCounter?: boolean;
+    /**
+     * Provide text that is used alongside the control label for additional help
+     */
+    helperText?: ReactNodeLike;
+    /**
+     * Specify whether you want the underlying label to be visually hidden
+     */
+    hideLabel?: boolean;
+    /**
+     * Provide a unique identifier for the control
+     */
+    id?: string;
+    /**
+     * Specify whether the control is currently invalid
+     */
+    invalid?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in an invalid state
+     */
+    invalidText?: ReactNodeLike;
+    /**
+     * Provide the text that will be read by a screen reader when visiting this
+     * control
+     */
+    labelText: ReactNodeLike;
+    /**
+     * @deprecated
+     * `true` to use the light version. For use on $ui-01 backgrounds only.
+     * Don't use this to make tile background color same as container background color.
+     */
+    light?: boolean;
+    /**
+     * Max character count allowed for the textarea. This is needed in order for enableCounter to display
+     */
+    maxCount?: number;
+    /**
+     * Optionally provide an `onChange` handler that is called whenever `<textarea>`
+     * is updated
+     */
+    onChange?: (evt: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    /**
+     * Optionally provide an `onClick` handler that is called whenever the
+     * `<textarea>` is clicked
+     */
+    onClick?: (evt: React.MouseEvent<HTMLTextAreaElement>) => void;
+    /**
+     * Specify the placeholder attribute for the `<textarea>`
+     */
+    placeholder?: string;
+    /**
+     * Whether the textarea should be read-only
+     */
+    readOnly?: boolean;
+    /**
+     * Specify the rows attribute for the `<textarea>`
+     */
+    rows?: number;
+    /**
+     * Provide the current value of the `<textarea>`
+     */
+    value?: string | number;
+}
+declare const TextArea: React.ForwardRefExoticComponent<TextAreaProps & React.RefAttributes<unknown>>;
+export default TextArea;

package/es/components/TextArea/TextArea.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -20,23 +20,23 @@ import useIsomorphicEffect from '../../internal/useIsomorphicEffect.js';
 import { useMergedRefs } from '../../internal/useMergedRefs.js';
 
 var _excluded = ["className", "id", "labelText", "hideLabel", "onChange", "onClick", "invalid", "invalidText", "helperText", "light", "placeholder", "enableCounter", "maxCount"];
-var TextArea = /*#__PURE__*/React__default.forwardRef(function TextArea(_ref, forwardRef) {
+var TextArea = /*#__PURE__*/React__default.forwardRef(function (props, forwardRef) {
   var _classNames, _classNames4;
 
-  var className = _ref.className,
-      id = _ref.id,
-      labelText = _ref.labelText,
-      hideLabel = _ref.hideLabel,
-      _onChange = _ref.onChange,
-      _onClick = _ref.onClick,
-      invalid = _ref.invalid,
-      invalidText = _ref.invalidText,
-      helperText = _ref.helperText,
-      light = _ref.light,
-      placeholder = _ref.placeholder,
-      enableCounter = _ref.enableCounter,
-      maxCount = _ref.maxCount,
-      other = _objectWithoutProperties(_ref, _excluded);
+  var className = props.className,
+      id = props.id,
+      labelText = props.labelText,
+      hideLabel = props.hideLabel,
+      _onChange = props.onChange,
+      _onClick = props.onClick,
+      invalid = props.invalid,
+      invalidText = props.invalidText,
+      helperText = props.helperText,
+      light = props.light,
+      placeholder = props.placeholder,
+      enableCounter = props.enableCounter,
+      maxCount = props.maxCount,
+      other = _objectWithoutProperties(props, _excluded);
 
   var prefix = usePrefix();
 
@@ -48,7 +48,7 @@ var TextArea = /*#__PURE__*/React__default.forwardRef(function TextArea(_ref, fo
       value = other.value,
       disabled = other.disabled;
 
-  var _useState = useState((defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.length) || (value === null || value === void 0 ? void 0 : value.length) || 0),
+  var _useState = useState((defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.toString().length) || (value === null || value === void 0 ? void 0 : value.toString().length) || 0),
       _useState2 = _slicedToArray(_useState, 2),
       textCount = _useState2[0],
       setTextCount = _useState2[1];
@@ -56,7 +56,7 @@ var TextArea = /*#__PURE__*/React__default.forwardRef(function TextArea(_ref, fo
   var textareaProps = {
     id: id,
     onChange: function onChange(evt) {
-      if (!other.disabled) {
+      if (!other.disabled && _onChange) {
         var _evt$target$value;
 
         setTextCount((_evt$target$value = evt.target.value) === null || _evt$target$value === void 0 ? void 0 : _evt$target$value.length);
@@ -65,11 +65,10 @@ var TextArea = /*#__PURE__*/React__default.forwardRef(function TextArea(_ref, fo
       }
     },
     onClick: function onClick(evt) {
-      if (!other.disabled) {
+      if (!other.disabled && _onClick) {
         _onClick(evt);
       }
-    },
-    ref: ref
+    }
   };
 
   if (enableCounter) {
@@ -99,21 +98,21 @@ var TextArea = /*#__PURE__*/React__default.forwardRef(function TextArea(_ref, fo
     className: "".concat(prefix, "--text-area__invalid-icon")
   })) : null;
   var textareaClasses = cx("".concat(prefix, "--text-area"), [enabled ? null : className], (_classNames4 = {}, _defineProperty(_classNames4, "".concat(prefix, "--text-area--light"), light), _defineProperty(_classNames4, "".concat(prefix, "--text-area--invalid"), invalid), _classNames4));
-  var textareaRef = useRef();
+  var textareaRef = useRef(null);
   var ref = useMergedRefs([forwardRef, textareaRef]);
   useIsomorphicEffect(function () {
-    if (other.cols) {
-      textareaRef.current.style.width = null;
+    if (other.cols && textareaRef.current) {
+      textareaRef.current.style.width = '';
       textareaRef.current.style.resize = 'none';
-    } else {
+    } else if (textareaRef.current) {
       textareaRef.current.style.width = "100%";
     }
   }, [other.cols]);
   var input = /*#__PURE__*/React__default.createElement("textarea", _extends({}, other, textareaProps, {
-    placeholder: placeholder || null,
+    placeholder: placeholder,
     className: textareaClasses,
-    "aria-invalid": invalid || null,
-    "aria-describedby": invalid ? errorId : null,
+    "aria-invalid": invalid,
+    "aria-describedby": invalid ? errorId : undefined,
     disabled: other.disabled,
     readOnly: other.readOnly,
     ref: ref

package/es/components/TextArea/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TextInput/ControlledPasswordInput.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TextInput/PasswordInput.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TextInput/TextInput.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TextInput/TextInput.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { ReactNode } from 'react';
+type ExcludedAttributes = 'defaultValue' | 'id' | 'size' | 'value';
+export interface TextInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, ExcludedAttributes> {
+    /**
+     * Specify an optional className to be applied to the `<input>` node
+     */
+    className?: string;
+    /**
+     * Optionally provide the default value of the `<input>`
+     */
+    defaultValue?: string | number;
+    /**
+     * Specify whether the `<input>` should be disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify whether to display the character counter
+     */
+    enableCounter?: boolean;
+    /**
+     * Provide text that is used alongside the control label for additional help
+     */
+    helperText?: ReactNode;
+    /**
+     * Specify whether you want the underlying label to be visually hidden
+     */
+    hideLabel?: boolean;
+    /**
+     * Specify a custom `id` for the `<input>`
+     */
+    id: string;
+    /**
+     * `true` to use the inline version.
+     */
+    inline?: boolean;
+    /**
+     * Specify whether the control is currently invalid
+     */
+    invalid?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in an invalid state
+     */
+    invalidText?: ReactNode;
+    /**
+     * Provide the text that will be read by a screen reader when visiting this
+     * control
+     */
+    labelText: ReactNode;
+    /**
+     * `true` to use the light version. For use on $ui-01 backgrounds only.
+     * Don't use this to make tile background color same as container background color.
+     * 'The `light` prop for `TextInput` has ' +
+        'been deprecated in favor of the new `Layer` component. It will be removed in the next major release.'
+     */
+    light?: boolean;
+    /**
+     * Max character count allowed for the input. This is needed in order for enableCounter to display
+     */
+    maxCount?: number;
+    /**
+     * Optionally provide an `onChange` handler that is called whenever `<input>`
+     * is updated
+     */
+    onChange?: (event: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /**
+     * Optionally provide an `onClick` handler that is called whenever the
+     * `<input>` is clicked
+     */
+    onClick?: (event: React.MouseEvent<HTMLElement>) => void;
+    /**
+     * Specify the placeholder attribute for the `<input>`
+     */
+    placeholder?: string;
+    /**
+     * Whether the input should be read-only
+     */
+    readOnly?: boolean;
+    /**
+     * Specify the size of the Text Input. Currently supports the following:
+     */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Specify the type of the `<input>`
+     */
+    type?: string;
+    /**
+     * Specify the value of the `<input>`
+     */
+    value?: string | number | undefined;
+    /**
+     * Specify whether the control is currently in warning state
+     */
+    warn?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in warning state
+     */
+    warnText?: ReactNode;
+}
+declare const TextInput: React.ForwardRefExoticComponent<TextInputProps & React.RefAttributes<unknown>>;
+export default TextInput;

package/es/components/TextInput/TextInput.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -61,7 +61,7 @@ var TextInput = /*#__PURE__*/React__default.forwardRef(function TextInput(_ref,
   var defaultValue = rest.defaultValue,
       value = rest.value;
 
-  var _useState = useState((defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.length) || (value === null || value === void 0 ? void 0 : value.length) || 0),
+  var _useState = useState((defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.toString().length) || (value === null || value === void 0 ? void 0 : value.toString().length) || 0),
       _useState2 = _slicedToArray(_useState, 2),
       textCount = _useState2[0],
       setTextCount = _useState2[1];
@@ -139,6 +139,7 @@ var TextInput = /*#__PURE__*/React__default.forwardRef(function TextInput(_ref,
       isFluid = _useContext.isFluid;
 
   var ariaAnnouncement = useAnnouncer(textCount, maxCount);
+  var Icon = normalizedProps.icon;
   return /*#__PURE__*/React__default.createElement("div", {
     className: inputWrapperClasses
   }, !inline ? labelWrapper : /*#__PURE__*/React__default.createElement("div", {
@@ -148,7 +149,7 @@ var TextInput = /*#__PURE__*/React__default.forwardRef(function TextInput(_ref,
   }, /*#__PURE__*/React__default.createElement("div", {
     className: fieldWrapperClasses,
     "data-invalid": normalizedProps.invalid || null
-  }, normalizedProps.icon && /*#__PURE__*/React__default.createElement(normalizedProps.icon, {
+  }, Icon && /*#__PURE__*/React__default.createElement(Icon, {
     className: iconClasses
   }), input, /*#__PURE__*/React__default.createElement("span", {
     className: "".concat(prefix, "--text-input__counter-alert"),

package/es/components/TextInput/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TextInput/util.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Theme/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/Tile/Tile.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TileGroup/TileGroup.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TileGroup/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es/components/TimePicker/TimePicker.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+import { ForwardRefReturn, ReactAttr } from '../../types/common';
+type ExcludedAttributes = 'id' | 'value';
+export interface TimePickerProps extends Omit<ReactAttr<HTMLInputElement>, ExcludedAttributes> {
+    /**
+     * Pass in the children that will be rendered next to the form control
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * Specify whether the `<input>` should be disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify whether you want the underlying label to be visually hidden
+     */
+    hideLabel?: boolean;
+    /**
+     * Specify a custom `id` for the `<input>`
+     */
+    id: string;
+    /**
+     * Specify whether the control is currently invalid
+     */
+    invalid?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in an invalid state
+     */
+    invalidText?: React.ReactNode;
+    /**
+     * Provide the text that will be read by a screen reader when visiting this
+     * control
+     */
+    labelText?: React.ReactNode;
+    /**
+     * The `light` prop for `TimePicker` has been deprecated. It will be removed in v12. Use the `Layer` component instead.
+     *
+     * @deprecated The `light` prop for `TimePicker` is no longer needed and has been deprecated. It will be removed in the next major release. Use the `Layer` component instead.
+     */
+    light?: boolean;
+    /**
+     * Specify the maximum length of the time string in `<input>`
+     */
+    maxLength?: number;
+    /**
+     * Optionally provide an `onBlur` handler that is called whenever the
+     * `<input>` loses focus
+     */
+    onBlur?: React.FocusEventHandler<HTMLInputElement>;
+    /**
+     * Optionally provide an `onChange` handler that is called whenever `<input>`
+     * is updated
+     */
+    onChange?: React.ChangeEventHandler<HTMLInputElement>;
+    /**
+     * Optionally provide an `onClick` handler that is called whenever the
+     * `<input>` is clicked
+     */
+    onClick?: React.MouseEventHandler<HTMLInputElement>;
+    /**
+     * Specify the regular expression working as the pattern of the time string in `<input>`
+     */
+    pattern?: string;
+    /**
+     * Specify the placeholder attribute for the `<input>`
+     */
+    placeholder?: string;
+    /**
+     * Specify whether the TimePicker should be read-only
+     */
+    readOnly?: boolean;
+    /**
+     * Specify the size of the Time Picker.
+     */
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * Specify the type of the `<input>`
+     */
+    type?: string;
+    /**
+     * Specify the value of the `<input>`
+     */
+    value?: string;
+}
+export type TimePickerComponent = ForwardRefReturn<HTMLInputElement, TimePickerProps>;
+declare const TimePicker: TimePickerComponent;
+export default TimePicker;