carbon-react 116.2.2 → 117.1.0

package/esm/__internal__/character-count/character-count.component.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 interface CharacterCountProps {
-    value: string;
-    limit: string;
+    value: number;
+    limit: number;
     isOverLimit: boolean;
     "data-element"?: string;
 }

package/esm/__internal__/character-count/character-count.component.js

@@ -1,22 +1,31 @@
 import React from "react";
 import PropTypes from "prop-types";
 import StyledCharacterCount from "./character-count.style";
+import useLocale from "../../hooks/__internal__/useLocale";
 
 const CharacterCount = ({
   value,
   limit,
   isOverLimit,
   "data-element": dataElement
-}) => /*#__PURE__*/React.createElement(StyledCharacterCount, {
-  "aria-live": "polite",
-  isOverLimit: isOverLimit,
-  "data-element": dataElement
-}, `${value}/${limit}`);
+}) => {
+  const limitMinusValue = +limit - +value;
+  const valueMinusLimit = +value - +limit;
+  const l = useLocale();
+
+  const getFormatNumber = (rawValue, locale) => new Intl.NumberFormat(locale).format(rawValue);
+
+  return /*#__PURE__*/React.createElement(StyledCharacterCount, {
+    "aria-live": "polite",
+    isOverLimit: isOverLimit,
+    "data-element": dataElement
+  }, !isOverLimit ? l.characterCount.charactersLeft(limitMinusValue, getFormatNumber(limitMinusValue, l.locale())) : l.characterCount.tooManyCharacters(valueMinusLimit, getFormatNumber(valueMinusLimit, l.locale())));
+};
 
 CharacterCount.propTypes = {
   "data-element": PropTypes.string,
   "isOverLimit": PropTypes.bool.isRequired,
-  "limit": PropTypes.string.isRequired,
-  "value": PropTypes.string.isRequired
+  "limit": PropTypes.number.isRequired,
+  "value": PropTypes.number.isRequired
 };
 export default CharacterCount;

package/esm/components/date/date.d.ts

@@ -27,7 +27,6 @@ export interface DateInputProps
     | "iconOnMouseDown"
     | "enforceCharacterLimit"
     | "characterLimit"
-    | "warnOverLimit"
     | "iconTabIndex"
   > {
   /** Boolean to allow the input to have an empty value */

package/esm/components/decimal/decimal.component.js

@@ -317,6 +317,7 @@ Decimal.propTypes = {
   "id": PropTypes.string,
   "info": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
   "inlist": PropTypes.any,
+  "inputHint": PropTypes.string,
   "inputIcon": PropTypes.oneOf(["add", "admin", "alert_on", "alert", "analysis", "arrow_bottom_right_circle", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_top_left_circle", "arrow_up", "arrow", "arrows_left_right", "attach", "bank_with_card", "bank", "basket_with_squares", "basket", "bed", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "box_arrow_left", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "car_lock", "car_money", "car_repair", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "cash", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "construction", "contacts", "copy", "create", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "dashboard", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "drill", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "entry", "envelope_dollar", "envelope_euro", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "form_refresh", "gift", "go", "graduation_hat", "graph", "grid", "hand_cash_coins", "hand_cash_note", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "laptop", "ledger_arrow_left", "ledger_arrow_right", "ledger", "lightbulb_off", "lightbulb_on", "link", "list_view", "location", "locked", "logout", "lookup", "marker", "message", "minus_large", "minus", "mobile", "money_bag", "none", "old_warning", "palm_tree", "pause_circle", "pause", "pdf", "people_switch", "people", "percentage_boxed", "person_info", "person_tick", "person", "petrol_pump", "phone", "piggy_bank", "plane", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question_hollow", "question_mark", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings_old", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "sync", "tag", "talk", "theatre_masks", "three_boxes", "tick_circle", "tick_thick", "tick", "true_tick", "u_turn_left", "u_turn_right", "undo", "unlocked", "upload", "uploaded", "video", "view", "warning"]),
   "inputMode": PropTypes.oneOf(["decimal", "email", "none", "numeric", "search", "tel", "text", "url"]),
   "inputRef": PropTypes.func,

package/esm/components/grouped-character/grouped-character.component.js

@@ -190,7 +190,7 @@ GroupedCharacter.propTypes = {
   "autoFocus": PropTypes.bool,
   "autoSave": PropTypes.string,
   "capture": PropTypes.oneOfType([PropTypes.oneOf(["environment", "user"]), PropTypes.bool]),
-  "characterLimit": PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+  "characterLimit": PropTypes.number,
   "checked": PropTypes.bool,
   "children": PropTypes.node,
   "className": PropTypes.string,
@@ -235,6 +235,7 @@ GroupedCharacter.propTypes = {
   "id": PropTypes.string,
   "info": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
   "inlist": PropTypes.any,
+  "inputHint": PropTypes.string,
   "inputIcon": PropTypes.oneOf(["add", "admin", "alert_on", "alert", "analysis", "arrow_bottom_right_circle", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_top_left_circle", "arrow_up", "arrow", "arrows_left_right", "attach", "bank_with_card", "bank", "basket_with_squares", "basket", "bed", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "box_arrow_left", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "car_lock", "car_money", "car_repair", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "cash", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "construction", "contacts", "copy", "create", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "dashboard", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "drill", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "entry", "envelope_dollar", "envelope_euro", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "form_refresh", "gift", "go", "graduation_hat", "graph", "grid", "hand_cash_coins", "hand_cash_note", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "laptop", "ledger_arrow_left", "ledger_arrow_right", "ledger", "lightbulb_off", "lightbulb_on", "link", "list_view", "location", "locked", "logout", "lookup", "marker", "message", "minus_large", "minus", "mobile", "money_bag", "none", "old_warning", "palm_tree", "pause_circle", "pause", "pdf", "people_switch", "people", "percentage_boxed", "person_info", "person_tick", "person", "petrol_pump", "phone", "piggy_bank", "plane", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question_hollow", "question_mark", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings_old", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "sync", "tag", "talk", "theatre_masks", "three_boxes", "tick_circle", "tick_thick", "tick", "true_tick", "u_turn_left", "u_turn_right", "undo", "unlocked", "upload", "uploaded", "video", "view", "warning"]),
   "inputMode": PropTypes.oneOf(["decimal", "email", "none", "numeric", "search", "tel", "text", "url"]),
   "inputRef": PropTypes.func,
@@ -659,7 +660,6 @@ GroupedCharacter.propTypes = {
   "value": PropTypes.string,
   "vocab": PropTypes.string,
   "warning": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
-  "warnOverLimit": PropTypes.bool,
   "width": PropTypes.oneOfType([PropTypes.number, PropTypes.string])
 };
 export { GroupedCharacter };

package/esm/components/i18n-provider/i18n-provider.component.js

@@ -24,6 +24,11 @@ I18nProvider.propTypes = {
     "batchSelection": PropTypes.shape({
       "selected": PropTypes.func.isRequired
     }),
+    "characterCount": PropTypes.shape({
+      "charactersLeft": PropTypes.func.isRequired,
+      "hintString": PropTypes.func.isRequired,
+      "tooManyCharacters": PropTypes.func.isRequired
+    }),
     "confirm": PropTypes.shape({
       "no": PropTypes.func.isRequired,
       "yes": PropTypes.func.isRequired

package/esm/components/number/number.component.js

@@ -115,7 +115,7 @@ Number.propTypes = {
   "autoFocus": PropTypes.bool,
   "autoSave": PropTypes.string,
   "capture": PropTypes.oneOfType([PropTypes.oneOf(["environment", "user"]), PropTypes.bool]),
-  "characterLimit": PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+  "characterLimit": PropTypes.number,
   "checked": PropTypes.bool,
   "children": PropTypes.node,
   "className": PropTypes.string,
@@ -159,6 +159,7 @@ Number.propTypes = {
   "id": PropTypes.string,
   "info": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
   "inlist": PropTypes.any,
+  "inputHint": PropTypes.string,
   "inputIcon": PropTypes.oneOf(["add", "admin", "alert_on", "alert", "analysis", "arrow_bottom_right_circle", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_top_left_circle", "arrow_up", "arrow", "arrows_left_right", "attach", "bank_with_card", "bank", "basket_with_squares", "basket", "bed", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "box_arrow_left", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "car_lock", "car_money", "car_repair", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "cash", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "construction", "contacts", "copy", "create", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "dashboard", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "drill", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "entry", "envelope_dollar", "envelope_euro", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "form_refresh", "gift", "go", "graduation_hat", "graph", "grid", "hand_cash_coins", "hand_cash_note", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "laptop", "ledger_arrow_left", "ledger_arrow_right", "ledger", "lightbulb_off", "lightbulb_on", "link", "list_view", "location", "locked", "logout", "lookup", "marker", "message", "minus_large", "minus", "mobile", "money_bag", "none", "old_warning", "palm_tree", "pause_circle", "pause", "pdf", "people_switch", "people", "percentage_boxed", "person_info", "person_tick", "person", "petrol_pump", "phone", "piggy_bank", "plane", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question_hollow", "question_mark", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings_old", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "sync", "tag", "talk", "theatre_masks", "three_boxes", "tick_circle", "tick_thick", "tick", "true_tick", "u_turn_left", "u_turn_right", "undo", "unlocked", "upload", "uploaded", "video", "view", "warning"]),
   "inputMode": PropTypes.oneOf(["decimal", "email", "none", "numeric", "search", "tel", "text", "url"]),
   "inputRef": PropTypes.func,
@@ -582,7 +583,6 @@ Number.propTypes = {
   "value": PropTypes.string,
   "vocab": PropTypes.string,
   "warning": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
-  "warnOverLimit": PropTypes.bool,
   "width": PropTypes.oneOfType([PropTypes.number, PropTypes.string])
 };
 export { Number };

package/esm/components/select/filterable-select/filterable-select.component.js

@@ -18,6 +18,8 @@ import useInputAccessibility from "../../../hooks/__internal__/useInputAccessibi
 let deprecateInputRefWarnTriggered = false;
 const FilterableSelectList = withFilter(SelectList);
 const FilterableSelect = /*#__PURE__*/React.forwardRef(({
+  "aria-label": ariaLabel,
+  "aria-labelledby": ariaLabelledby,
   value,
   defaultValue,
   id,
@@ -458,7 +460,9 @@ const FilterableSelect = /*#__PURE__*/React.forwardRef(({
     ref: containerRef
   }, /*#__PURE__*/React.createElement(SelectTextbox, _extends({
     activeDescendantId: activeDescendantId,
-    labelId: labelId,
+    ariaLabel: ariaLabel,
+    ariaLabelledby: ariaLabelledby,
+    labelId: label ? labelId : undefined,
     "aria-controls": selectListId.current,
     isOpen: isOpen,
     hasTextCursor: true,
@@ -467,6 +471,12 @@ const FilterableSelect = /*#__PURE__*/React.forwardRef(({
 });
 FilterableSelect.propTypes = { ...formInputPropTypes,
 
+  /** Prop to specify the aria-label attribute of the component input */
+  "aria-label": PropTypes.string,
+
+  /** Prop to specify the aria-labeledby property of the component input */
+  "aria-labelledby": PropTypes.string,
+
   /** Identifier used for testing purposes, applied to the root element of the component. */
   "data-component": PropTypes.string,
 

package/esm/components/select/filterable-select/filterable-select.d.ts

@@ -5,6 +5,10 @@ import { FormInputPropTypes } from "../select-textbox/select-textbox";
 
 export interface FilterableSelectProps
   extends Omit<FormInputPropTypes, "defaultValue" | "value"> {
+  /** Prop to specify the aria-label attribute of the component input */
+  "aria-label"?: string;
+  /** Prop to specify the aria-labeledby property of the component input */
+  "aria-labelledby"?: string;
   /** Identifier used for testing purposes, applied to the root element of the component. */
   "data-component"?: string;
   /** Identifier used for testing purposes, applied to the root element of the component. */

package/esm/components/select/multi-select/multi-select.component.js

@@ -20,6 +20,8 @@ import useInputAccessibility from "../../../hooks/__internal__/useInputAccessibi
 let deprecateInputRefWarnTriggered = false;
 const FilterableSelectList = withFilter(SelectList);
 const MultiSelect = /*#__PURE__*/React.forwardRef(({
+  "aria-label": ariaLabel,
+  "aria-labelledby": ariaLabelledby,
   value,
   defaultValue,
   id,
@@ -478,6 +480,8 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
     accessibilityLabelId: accessibilityLabelId.current,
     activeDescendantId: activeDescendantId,
     "aria-controls": selectListId.current,
+    ariaLabel: ariaLabel,
+    ariaLabelledby: ariaLabelledby,
     hasTextCursor: true,
     isOpen: isOpen,
     labelId: labelId,
@@ -486,6 +490,12 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
 });
 MultiSelect.propTypes = { ...formInputPropTypes,
 
+  /** Prop to specify the aria-label attribute of the component input */
+  "aria-label": PropTypes.string,
+
+  /** Prop to specify the aria-labeledby property of the component input */
+  "aria-labelledby": PropTypes.string,
+
   /** Identifier used for testing purposes, applied to the root element of the component. */
   "data-component": PropTypes.string,
 

package/esm/components/select/multi-select/multi-select.d.ts

@@ -4,6 +4,10 @@ import { FormInputPropTypes } from "../select-textbox/select-textbox";
 
 export interface MultiSelectProps
   extends Omit<FormInputPropTypes, "defaultValue" | "value"> {
+  /** Prop to specify the aria-label attribute of the component input */
+  "aria-label"?: string;
+  /** Prop to specify the aria-labeledby property of the component input */
+  "aria-labelledby"?: string;
   /** Identifier used for testing purposes, applied to the root element of the component. */
   "data-component"?: string;
   /** Identifier used for testing purposes, applied to the root element of the component. */

package/esm/components/select/select-textbox/select-textbox.component.js

@@ -23,6 +23,8 @@ const floatingMiddleware = [offset(({
 
 })];
 const SelectTextbox = /*#__PURE__*/React.forwardRef(({
+  ariaLabel,
+  ariaLabelledBy,
   accessibilityLabelId,
   labelId,
   "aria-controls": ariaControls,
@@ -105,10 +107,10 @@ const SelectTextbox = /*#__PURE__*/React.forwardRef(({
   function getInputAriaAttributes() {
     const joinIds = (...ids) => ids.filter(item => item !== undefined).join(" ");
 
-    const ariaLabelledby = hasTextCursor ? joinIds(labelId, accessibilityLabelId) : joinIds(labelId, textId.current);
+    const combinedAriaLabelledBy = hasTextCursor ? joinIds(ariaLabelledBy || labelId, accessibilityLabelId || textId.current) : joinIds(ariaLabelledBy || labelId, textId.current);
     return {
       "aria-expanded": readOnly ? undefined : isOpen,
-      "aria-labelledby": ariaLabelledby || undefined,
+      "aria-labelledby": ariaLabel && !ariaLabelledBy ? undefined : combinedAriaLabelledBy,
       "aria-activedescendant": activeDescendantId,
       "aria-controls": ariaControls,
       "aria-autocomplete": hasTextCursor ? "both" : undefined,
@@ -140,6 +142,7 @@ const SelectTextbox = /*#__PURE__*/React.forwardRef(({
   }
 
   return /*#__PURE__*/React.createElement(Textbox, _extends({
+    "aria-label": ariaLabel,
     "data-element": "select-input",
     inputIcon: "dropdown",
     autoComplete: "off",
@@ -161,6 +164,12 @@ const formInputPropTypes = {
    */
   accessibilityLabelId: PropTypes.string,
 
+  /** Prop to specify the aria-label attribute of the component input */
+  ariaLabel: PropTypes.string,
+
+  /** Prop to specify the aria-labeledby property of the component input */
+  ariaLabelledBy: PropTypes.string,
+
   /** Id attribute of the input element */
   id: PropTypes.string,
 

package/esm/components/select/select-textbox/select-textbox.d.ts

@@ -8,6 +8,10 @@ export interface FormInputPropTypes
     Omit<CommonTextboxProps, "onClick"> {
   /** Breakpoint for adaptive label (inline labels change to top aligned). Enables the adaptive behaviour when set */
   adaptiveLabelBreakpoint?: number;
+  /** Prop to specify the aria-label attribute of the component input */
+  ariaLabel?: string;
+  /** Prop to specify the aria-labeledby property of the component input */
+  ariaLabelledBy?: string;
   /** If true the Component will be focused when rendered */
   autoFocus?: boolean;
   /** If true, the component will be disabled */

package/esm/components/select/simple-select/simple-select.component.js

@@ -17,6 +17,8 @@ import useFormSpacing from "../../../hooks/__internal__/useFormSpacing";
 import useInputAccessibility from "../../../hooks/__internal__/useInputAccessibility/useInputAccessibility";
 let deprecateInputRefWarnTriggered = false;
 const SimpleSelect = /*#__PURE__*/React.forwardRef(({
+  "aria-label": ariaLabel,
+  "aria-labelledby": ariaLabelledby,
   value,
   defaultValue,
   id,
@@ -378,8 +380,10 @@ const SimpleSelect = /*#__PURE__*/React.forwardRef(({
   }, marginProps), /*#__PURE__*/React.createElement("div", {
     ref: containerRef
   }, /*#__PURE__*/React.createElement(SelectTextbox, _extends({
+    ariaLabel: ariaLabel,
     "aria-controls": selectListId.current,
     activeDescendantId: activeDescendantId,
+    ariaLabelledby: ariaLabelledby,
     isOpen: isOpen,
     textboxRef: textboxRef
   }, getTextboxProps()))), selectList);
@@ -389,6 +393,12 @@ SimpleSelect.propTypes = {
   ...propTypes.space,
   ...formInputPropTypes,
 
+  /** Prop to specify the aria-label attribute of the component input */
+  "aria-label": PropTypes.string,
+
+  /** Prop to specify the aria-labeledby property of the component input */
+  "aria-labelledby": PropTypes.string,
+
   /** Identifier used for testing purposes, applied to the root element of the component. */
   "data-component": PropTypes.string,
 

package/esm/components/select/simple-select/simple-select.d.ts

@@ -4,6 +4,10 @@ import { FormInputPropTypes } from "../select-textbox/select-textbox";
 
 export interface SimpleSelectProps
   extends Omit<FormInputPropTypes, "defaultValue" | "value"> {
+  /** Prop to specify the aria-label attribute of the component input */
+  "aria-label"?: string;
+  /** Prop to specify the aria-labeledby property of the component input */
+  "aria-labelledby"?: string;
   /** Identifier used for testing purposes, applied to the root element of the component. */
   "data-component"?: string;
   /** Identifier used for testing purposes, applied to the root element of the component. */

package/esm/components/textarea/textarea.component.d.ts

@@ -19,7 +19,7 @@ export interface TextareaProps extends ValidationProps, MarginProps, Omit<Common
     /** Automatically focus the input on component mount */
     autoFocus?: boolean;
     /** Character limit of the textarea */
-    characterLimit?: string | number;
+    characterLimit?: number;
     /** Type of the icon that will be rendered next to the input */
     children?: React.ReactNode;
     /** The visible width of the text control, in average character widths */
@@ -34,6 +34,8 @@ export interface TextareaProps extends ValidationProps, MarginProps, Omit<Common
     error?: boolean | string;
     /** Allows the Textareas Height to change based on user input */
     expandable?: boolean;
+    /** A hint string rendered before the input but after the label. Intended to describe the purpose or content of the input. */
+    inputHint?: string;
     /** Help content to be displayed under an input */
     fieldHelp?: React.ReactNode;
     /** Aria label for rendered help component */
@@ -89,8 +91,6 @@ export interface TextareaProps extends ValidationProps, MarginProps, Omit<Common
     validationOnLabel?: boolean;
     /** The value of the Textbox */
     value?: string;
-    /** Whether to display the character count message in red */
-    warnOverLimit?: boolean;
     /** Indicate that warning has occurred
     Pass string to display icon, tooltip and orange border
     Pass true boolean to only display orange border */

package/esm/components/textarea/textarea.component.js

@@ -13,23 +13,22 @@ import StyledTextarea, { MIN_HEIGHT } from "./textarea.style";
 import { TooltipProvider } from "../../__internal__/tooltip-provider";
 import useInputAccessibility from "../../hooks/__internal__/useInputAccessibility";
 import { NewValidationContext } from "../carbon-provider/carbon-provider.component";
-import { ErrorBorder, StyledHintText } from "../textbox/textbox.style";
+import { ErrorBorder, StyledHintText, StyledInputHint } from "../textbox/textbox.style";
 import ValidationMessage from "../../__internal__/validation-message";
 import Box from "../box";
 import Logger from "../../__internal__/utils/logger";
-import useFormSpacing from "../../hooks/__internal__/useFormSpacing"; // TODO: Change characterLimit type to number - batch with other breaking changes
-
+import useFormSpacing from "../../hooks/__internal__/useFormSpacing";
 let deprecateInputRefWarnTriggered = false;
 const Textarea = /*#__PURE__*/React.forwardRef(({
   "aria-labelledby": ariaLabelledBy,
   autoFocus,
+  inputHint,
   fieldHelp,
   label,
   size,
   children,
   characterLimit,
   enforceCharacterLimit = true,
-  warnOverLimit = false,
   onChange,
   disabled = false,
   labelInline,
@@ -115,8 +114,7 @@ const Textarea = /*#__PURE__*/React.forwardRef(({
     label,
     fieldHelp
   });
-  const [maxLength, characterCount] = useCharacterCount(value, // TODO: Can be removed after the characterLimit type is changed to number
-  typeof characterLimit === "string" ? parseInt(characterLimit, 10) : characterLimit, warnOverLimit, enforceCharacterLimit);
+  const [maxLength, characterCount, characterCountHintId, characterCountHint] = useCharacterCount(value, characterLimit, enforceCharacterLimit);
   useEffect(() => {
     if (rows) {
       var _internalRef$current;
@@ -144,6 +142,12 @@ const Textarea = /*#__PURE__*/React.forwardRef(({
     };
   }, [expandable]);
   const hasIconInside = !!(inputIcon || validationIconId && !validationOnLabel);
+  const hintId = useRef(guid());
+  const characterCountHintIdValue = characterCount ? characterCountHintId : undefined;
+  const inputHintIdValue = inputHint ? hintId.current : undefined;
+  const hintIdValue = characterLimit ? characterCountHintIdValue : inputHintIdValue;
+  const ariaDescribedByValues = [validationRedesignOptIn ? undefined : ariaDescribedBy, hintIdValue];
+  const ariaDescribedByValue = ariaDescribedByValues.filter(Boolean).join(" ");
   const input = /*#__PURE__*/React.createElement(InputPresentation, {
     size: size,
     disabled: disabled,
@@ -156,7 +160,7 @@ const Textarea = /*#__PURE__*/React.forwardRef(({
   }, /*#__PURE__*/React.createElement(Input, _extends({
     "aria-invalid": !!error,
     "aria-labelledby": ariaLabelledBy,
-    "aria-describedby": validationRedesignOptIn ? undefined : ariaDescribedBy,
+    "aria-describedby": ariaDescribedByValue,
     autoFocus: autoFocus,
     name: name,
     value: value,
@@ -211,7 +215,10 @@ const Textarea = /*#__PURE__*/React.forwardRef(({
     useValidationIcon: computeLabelPropValues(validationOnLabel),
     adaptiveLabelBreakpoint: adaptiveLabelBreakpoint,
     validationRedesignOptIn: validationRedesignOptIn
-  }, validationRedesignOptIn && labelHelp && /*#__PURE__*/React.createElement(StyledHintText, null, labelHelp), validationRedesignOptIn ? /*#__PURE__*/React.createElement(Box, {
+  }, characterLimit || inputHint ? /*#__PURE__*/React.createElement(StyledInputHint, {
+    id: hintIdValue,
+    "data-element": "input-hint"
+  }, characterCountHint || inputHint) : null, validationRedesignOptIn && labelHelp && /*#__PURE__*/React.createElement(StyledHintText, null, labelHelp), validationRedesignOptIn ? /*#__PURE__*/React.createElement(Box, {
     position: "relative"
   }, /*#__PURE__*/React.createElement(ValidationMessage, {
     error: error,
@@ -282,7 +289,7 @@ Textarea.propTypes = {
   "autoFocus": PropTypes.bool,
   "autoSave": PropTypes.string,
   "capture": PropTypes.oneOfType([PropTypes.oneOf(["environment", "user"]), PropTypes.bool]),
-  "characterLimit": PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+  "characterLimit": PropTypes.number,
   "checked": PropTypes.bool,
   "children": PropTypes.node,
   "className": PropTypes.string,
@@ -323,6 +330,7 @@ Textarea.propTypes = {
   "id": PropTypes.string,
   "info": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
   "inlist": PropTypes.any,
+  "inputHint": PropTypes.string,
   "inputIcon": PropTypes.oneOf(["add", "admin", "alert_on", "alert", "analysis", "arrow_bottom_right_circle", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_top_left_circle", "arrow_up", "arrow", "arrows_left_right", "attach", "bank_with_card", "bank", "basket_with_squares", "basket", "bed", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "box_arrow_left", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "car_lock", "car_money", "car_repair", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "cash", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "construction", "contacts", "copy", "create", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "dashboard", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "drill", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "entry", "envelope_dollar", "envelope_euro", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "form_refresh", "gift", "go", "graduation_hat", "graph", "grid", "hand_cash_coins", "hand_cash_note", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "laptop", "ledger_arrow_left", "ledger_arrow_right", "ledger", "lightbulb_off", "lightbulb_on", "link", "list_view", "location", "locked", "logout", "lookup", "marker", "message", "minus_large", "minus", "mobile", "money_bag", "none", "old_warning", "palm_tree", "pause_circle", "pause", "pdf", "people_switch", "people", "percentage_boxed", "person_info", "person_tick", "person", "petrol_pump", "phone", "piggy_bank", "plane", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question_hollow", "question_mark", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings_old", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "sync", "tag", "talk", "theatre_masks", "three_boxes", "tick_circle", "tick_thick", "tick", "true_tick", "u_turn_left", "u_turn_right", "undo", "unlocked", "upload", "uploaded", "video", "view", "warning"]),
   "inputMode": PropTypes.oneOf(["decimal", "email", "none", "numeric", "search", "tel", "text", "url"]),
   "inputRef": PropTypes.func,
@@ -743,7 +751,6 @@ Textarea.propTypes = {
   "value": PropTypes.string,
   "vocab": PropTypes.string,
   "warning": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
-  "warnOverLimit": PropTypes.bool,
   "width": PropTypes.oneOfType([PropTypes.number, PropTypes.string])
 };
 export { Textarea };

package/esm/components/textbox/textbox.component.d.ts

@@ -16,6 +16,8 @@ export interface CommonTextboxProps extends ValidationProps, MarginProps, Omit<C
     adaptiveLabelBreakpoint?: number;
     /** Integer to determine a timeout for the deferred callback */
     deferTimeout?: number;
+    /** A hint string rendered before the input but after the label. Intended to describe the purpose or content of the input. */
+    inputHint?: string;
     /** Help content to be displayed under an input */
     fieldHelp?: React.ReactNode;
     /**
@@ -91,11 +93,9 @@ export interface TextboxProps extends CommonTextboxProps {
     /** Container for DatePicker or SelectList components */
     positionedChildren?: React.ReactNode;
     /** Character limit of the textarea */
-    characterLimit?: string | number;
+    characterLimit?: number;
     /** Stop the user typing over the characterLimit */
     enforceCharacterLimit?: boolean;
-    /** Whether to display the character count message in red */
-    warnOverLimit?: boolean;
 }
 export declare const Textbox: React.ForwardRefExoticComponent<TextboxProps & React.RefAttributes<HTMLInputElement>>;
 export default Textbox;

package/esm/components/textbox/textbox.component.js

@@ -1,6 +1,6 @@
 function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 
-import React, { useContext } from "react";
+import React, { useContext, useRef } from "react";
 import PropTypes from "prop-types";
 import { filterStyledSystemMarginProps } from "../../style/utils";
 import { Input, InputPresentation } from "../../__internal__/input";
@@ -12,12 +12,13 @@ import StyledPrefix from "./__internal__/prefix.style";
 import { TooltipProvider } from "../../__internal__/tooltip-provider";
 import useCharacterCount from "../../hooks/__internal__/useCharacterCount";
 import useInputAccessibility from "../../hooks/__internal__/useInputAccessibility/useInputAccessibility";
-import { ErrorBorder, StyledHintText } from "./textbox.style";
+import { ErrorBorder, StyledInputHint, StyledHintText } from "./textbox.style";
 import ValidationMessage from "../../__internal__/validation-message";
 import { NewValidationContext } from "../carbon-provider/carbon-provider.component";
 import NumeralDateContext from "../numeral-date/numeral-date-context";
 import Box from "../box";
 import Logger from "../../__internal__/utils/logger";
+import guid from "../../__internal__/utils/helpers/guid";
 let deprecateInputRefWarnTriggered = false;
 const Textbox = /*#__PURE__*/React.forwardRef(({
   "aria-labelledby": ariaLabelledBy,
@@ -34,6 +35,7 @@ const Textbox = /*#__PURE__*/React.forwardRef(({
   labelSpacing,
   id,
   formattedValue,
+  inputHint,
   fieldHelp,
   error,
   warning,
@@ -70,13 +72,11 @@ const Textbox = /*#__PURE__*/React.forwardRef(({
   "data-role": dataRole,
   enforceCharacterLimit = true,
   characterLimit,
-  warnOverLimit = false,
   helpAriaLabel,
   ...props
 }, ref) => {
   const characterCountValue = typeof value === "string" ? value : "";
-  const [maxLength, characterCount] = useCharacterCount(characterCountValue, // TODO: Can be removed after the characterLimit type is changed to number
-  typeof characterLimit === "string" ? parseInt(characterLimit, 10) : characterLimit, warnOverLimit, enforceCharacterLimit);
+  const [maxLength, characterCount, characterCountHintId, characterCountHint] = useCharacterCount(characterCountValue, characterLimit, enforceCharacterLimit);
   const {
     validationRedesignOptIn
   } = useContext(NewValidationContext);
@@ -106,6 +106,12 @@ const Textbox = /*#__PURE__*/React.forwardRef(({
     label,
     fieldHelp
   });
+  const hintId = useRef(guid());
+  const characterCountHintIdValue = characterCount ? characterCountHintId : undefined;
+  const inputHintIdValue = inputHint ? hintId.current : undefined;
+  const hintIdValue = characterLimit ? characterCountHintIdValue : inputHintIdValue;
+  const ariaDescribedByValues = [validationRedesignOptIn ? undefined : ariaDescribedBy, hintIdValue];
+  const ariaDescribedByValue = ariaDescribedByValues.filter(Boolean).join(" ");
   const hasIconInside = !!(inputIcon || validationIconId && !validationOnLabel);
   const input = /*#__PURE__*/React.createElement(InputPresentation, {
     align: align,
@@ -128,7 +134,7 @@ const Textbox = /*#__PURE__*/React.forwardRef(({
     align: align,
     "aria-invalid": !!error,
     "aria-labelledby": ariaLabelledBy,
-    "aria-describedby": validationRedesignOptIn ? undefined : ariaDescribedBy,
+    "aria-describedby": ariaDescribedByValue,
     autoFocus: autoFocus,
     deferTimeout: deferTimeout,
     disabled: disabled,
@@ -189,7 +195,10 @@ const Textbox = /*#__PURE__*/React.forwardRef(({
     "data-element": dataElement,
     validationIconId: validationRedesignOptIn ? undefined : validationIconId,
     validationRedesignOptIn: validationRedesignOptIn
-  }, filterStyledSystemMarginProps(props)), validationRedesignOptIn && labelHelp && /*#__PURE__*/React.createElement(StyledHintText, null, labelHelp), validationRedesignOptIn ? /*#__PURE__*/React.createElement(Box, {
+  }, filterStyledSystemMarginProps(props)), characterLimit || inputHint ? /*#__PURE__*/React.createElement(StyledInputHint, {
+    id: hintIdValue,
+    "data-element": "input-hint"
+  }, characterCountHint || inputHint) : null, validationRedesignOptIn && labelHelp && /*#__PURE__*/React.createElement(StyledHintText, null, labelHelp), validationRedesignOptIn ? /*#__PURE__*/React.createElement(Box, {
     position: "relative"
   }, /*#__PURE__*/React.createElement(ValidationMessage, {
     error: error,
@@ -260,7 +269,7 @@ Textbox.propTypes = {
   "autoFocus": PropTypes.bool,
   "autoSave": PropTypes.string,
   "capture": PropTypes.oneOfType([PropTypes.oneOf(["environment", "user"]), PropTypes.bool]),
-  "characterLimit": PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+  "characterLimit": PropTypes.number,
   "checked": PropTypes.bool,
   "children": PropTypes.node,
   "className": PropTypes.string,
@@ -304,6 +313,7 @@ Textbox.propTypes = {
   "id": PropTypes.string,
   "info": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
   "inlist": PropTypes.any,
+  "inputHint": PropTypes.string,
   "inputIcon": PropTypes.oneOf(["add", "admin", "alert_on", "alert", "analysis", "arrow_bottom_right_circle", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_top_left_circle", "arrow_up", "arrow", "arrows_left_right", "attach", "bank_with_card", "bank", "basket_with_squares", "basket", "bed", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "box_arrow_left", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "car_lock", "car_money", "car_repair", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "cash", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "construction", "contacts", "copy", "create", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "dashboard", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "drill", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "entry", "envelope_dollar", "envelope_euro", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "form_refresh", "gift", "go", "graduation_hat", "graph", "grid", "hand_cash_coins", "hand_cash_note", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "laptop", "ledger_arrow_left", "ledger_arrow_right", "ledger", "lightbulb_off", "lightbulb_on", "link", "list_view", "location", "locked", "logout", "lookup", "marker", "message", "minus_large", "minus", "mobile", "money_bag", "none", "old_warning", "palm_tree", "pause_circle", "pause", "pdf", "people_switch", "people", "percentage_boxed", "person_info", "person_tick", "person", "petrol_pump", "phone", "piggy_bank", "plane", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question_hollow", "question_mark", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings_old", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "sync", "tag", "talk", "theatre_masks", "three_boxes", "tick_circle", "tick_thick", "tick", "true_tick", "u_turn_left", "u_turn_right", "undo", "unlocked", "upload", "uploaded", "video", "view", "warning"]),
   "inputMode": PropTypes.oneOf(["decimal", "email", "none", "numeric", "search", "tel", "text", "url"]),
   "inputRef": PropTypes.func,
@@ -727,7 +737,6 @@ Textbox.propTypes = {
   "value": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.string), PropTypes.number, PropTypes.string]),
   "vocab": PropTypes.string,
   "warning": PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
-  "warnOverLimit": PropTypes.bool,
   "width": PropTypes.oneOfType([PropTypes.number, PropTypes.string])
 };
 export { Textbox };

package/esm/components/textbox/textbox.style.d.ts

@@ -1,5 +1,6 @@
 declare const ErrorBorder: import("styled-components").StyledComponent<"span", any, {
     warning: boolean;
 }, never>;
-declare const StyledHintText: import("styled-components").StyledComponent<"p", any, {}, never>;
-export { StyledHintText, ErrorBorder };
+declare const StyledInputHint: import("styled-components").StyledComponent<"p", any, {}, never>;
+declare const StyledHintText: import("styled-components").StyledComponent<"div", any, {}, never>;
+export { StyledHintText, ErrorBorder, StyledInputHint };