carbon-react 155.13.0 → 156.0.0

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),n=require("invariant");require("../../../style/utils/filter-styled-system-padding-props.js");var r=require("../../../style/utils/filter-styled-system-margin-props.js"),l=require("../../../style/utils/filter-out-styled-system-spacing-props.js"),o=require("../__internal__/select-textbox/select-textbox.component.js"),i=require("../../../__internal__/utils/helpers/guid/index.js"),a=require("../__internal__/utils/with-filter.hoc.js"),u=require("../select.style.js"),s=require("../__internal__/select-list/select-list.component.js"),c=require("../__internal__/utils/is-expected-option.js"),d=require("../__internal__/utils/are-objects-equal.js"),f=require("../__internal__/utils/is-navigation-key.js"),p=require("../../../__internal__/utils/logger/index.js"),b=require("../../../hooks/__internal__/useStableCallback/useStableCallback.js"),v=require("../../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js");function m(e){return e&&e.__esModule?e:{default:e}}var h=m(t),y=m(n);function g(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function O(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{},r=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(r=r.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),r.forEach((function(t){g(e,t,n[t])}))}return e}function C(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t.push.apply(t,n)}return t}(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))})),e}let _=!1;const j=a.default(s.default);let w=!1;const S=h.default.forwardRef(((n,a)=>{var{"aria-label":m,"aria-labelledby":g,value:S,defaultValue:x,id:k,name:q,label:L,children:P,onOpen:E,onChange:R,onFilterChange:D,onClick:F,onKeyDown:A,onFocus:B,onBlur:M,openOnFocus:I,noResultsMessage:V,listActionButton:T,listMaxHeight:H,onListAction:W,isLoading:K,disabled:U,readOnly:z,onListScrollBottom:G,tableHeader:J,multiColumn:N,"data-element":Q,"data-role":X,tooltipPosition:Y,listPlacement:Z="bottom",flipEnabled:$=!0,enableVirtualScroll:ee,virtualScrollOverscan:te,disableDefaultFiltering:ne=!1,isOptional:re,required:le,listWidth:oe}=n,ie=function(e,t){if(null==e)return{};var n,r,l=function(e,t){if(null==e)return{};var n,r,l={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(l[n]=e[n]);return l}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(l[n]=e[n])}return l}(n,["aria-label","aria-labelledby","value","defaultValue","id","name","label","children","onOpen","onChange","onFilterChange","onClick","onKeyDown","onFocus","onBlur","openOnFocus","noResultsMessage","listActionButton","listMaxHeight","onListAction","isLoading","disabled","readOnly","onListScrollBottom","tableHeader","multiColumn","data-element","data-role","tooltipPosition","listPlacement","flipEnabled","enableVirtualScroll","virtualScrollOverscan","disableDefaultFiltering","isOptional","required","listWidth"]);!w&&re&&(w=!0,p.default.deprecate("`isOptional` is deprecated in FilterableSelect and support will soon be removed. If the value of this component is not required, use the `required` prop and set it to false instead."));const[ae,ue]=t.useState(""),se=t.useRef(i.default()),ce=t.useRef(null),de=t.useRef(null),fe=t.useRef(void 0!==S),pe=t.useRef(!1),be=t.useRef(!1),ve=t.useRef(!1),[me,he]=t.useState(),[ye,ge]=t.useState(!1),[Oe,Ce]=t.useState(""),[_e,je]=t.useState(S||x||""),we=t.useRef(S),[Se,xe]=t.useState(""),[ke,qe]=t.useState(""),Le=t.useRef(k||i.default()),{labelId:Pe}=v.default({id:Le.current,label:L}),Ee=t.useRef(null),Re=t.useRef(!1);!_&&(!fe||!R&&x)&&(_=!0,p.default.deprecate("Uncontrolled behaviour in `Filterable Select` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const De=t.useCallback(((e,t)=>({target:C(O({},q&&{name:q},k&&{id:k}),{value:e}),selectionConfirmed:t})),[q,k]),Fe=t.useCallback(((e,t)=>{R&&R(De(e,t))}),[R,De]),Ae=t.useCallback(((e,t)=>{je((n=>{var r;const l=e.trimStart(),o=(i=l,a=P,h.default.Children.toArray(a).find((e=>{const{text:t}=e.props;return-1!==(null==t?void 0:t.toLowerCase().indexOf(null==i?void 0:i.toLowerCase()))})));var i,a;const u=t&&!e.length;return!o||u||o.props.disabled?(Ce(e),Fe("",!1),""):(l.length&&Fe(o.props.value,!1),t?(Ce(e),o.props.value):(l.length&&(null===(r=o.props.text)||void 0===r?void 0:r.toLowerCase().startsWith(l.toLowerCase()))?Ce(o.props.text):Ce(e),fe.current?n:(xe(o.props.value),o.props.value)))}))}),[P,Fe]),Be=t.useCallback(((e,t=!1)=>{var n;const r=h.default.Children.toArray(P).find((t=>h.default.isValidElement(t)&&c.default(t,e)));r&&void 0!==r.props.text?(t||(null===(n=r.props.text)||void 0===n?void 0:n.toLowerCase().startsWith(null==ke?void 0:ke.toLowerCase().trim())))&&Ce(r.props.text):Ce(ke||"")}),[P,ke]),Me=t.useCallback((e=>{const t=e.target.value,{inputType:n}=e.nativeEvent;Ae(t,"deleteContentBackward"===n||"deleteContentForward"===n||"delete"===n),qe(t),ge(!0)}),[Ae]),Ie=t.useCallback((e=>{qe((t=>(null==t?void 0:t.length)===(null==Oe?void 0:Oe.length)-1&&e===Oe.slice(-1)?Oe:t))}),[Oe]),Ve=t.useCallback((e=>{const{key:t}=e;A&&A(e),z||(!e.defaultPrevented&&f.default(t)&&(e.preventDefault(),ge(!0)),Ie(t))}),[Ie,A,z]),Te=fe.current?S:_e,He=t.useCallback((e=>{const t=ce.current&&!ce.current.contains(e.target),n=de.current&&!de.current.contains(e.target);pe.current=!1,t&&n&&(Be(Te,!0),ge(!1))}),[Be,Te]);t.useEffect((()=>{y.default(fe.current===(void 0!==S),"Input elements should not switch from uncontrolled to controlled (or vice versa). Decide between using a controlled or uncontrolled input element for the lifetime of the component"),y.default(!fe.current||fe.current&&R,"onChange prop required when using a controlled input element"),fe.current?(je((e=>(S&&e!==S&&Be(S),S))),xe(S)):(Oe!==_e&&Be(_e),Se!==_e&&xe(_e))}),[S,R,P]);const We=b.useStableCallback(E);t.useEffect((()=>{ye?We&&We():qe("")}),[We,ye]),t.useEffect((()=>{const e=void 0!==T;y.default(!e||e&&W,"onListAction prop required when using listActionButton prop")}),[T,W]);const Ke=t.useRef(!0);t.useEffect((()=>{Ke.current&&Be(_e),fe.current&&("object"==typeof S&&"object"==typeof we.current?d.default(S,we.current)||(Be(S),we.current=S):Be(S))}),[S,P]);const Ue=b.useStableCallback(D);t.useEffect((()=>{Ue&&!Ke.current&&Ue(ke)}),[Ue,ke]),t.useEffect((()=>{Ke.current=!1}),[]),t.useEffect((()=>{const e="click";return window.addEventListener(e,He),function(){window.removeEventListener(e,He)}}),[He]),t.useEffect((()=>{const e=null==ke?void 0:ke.trimStart(),t=null==Oe?void 0:Oe.toLowerCase().startsWith(e.toLowerCase());!U&&!z&&me&&e.length&&(null==Oe?void 0:Oe.length)>e.length&&t&&(me.selectionStart=e.length)}),[Oe,ke,me,U,z]);const ze=t.useCallback((e=>{const{id:t,text:n,value:r,selectionType:l,selectionConfirmed:o}=e;fe.current||(je(r),xe(r)),Ce(n),Fe(r,!!o),ue(t),"navigationKey"!==l&&(Re.current=!!I,ge(!1),null==me||me.focus(),null==me||me.select(),Re.current=!1)}),[me,Fe,I]),Ge=t.useCallback((()=>{ge(!1),Be(_e,!0)}),[_e,Be]);function Je(e){pe.current=!0,"input"===e.target.dataset.element&&(ve.current=!0)}t.useEffect((()=>()=>{Ee.current&&clearTimeout(Ee.current)}),[]);const Ne=t.useCallback((e=>{e&&(he(e),a&&("function"==typeof a?a(e):a.current=e))}),[a]);let Qe;switch(Z){case"top":Qe="top-end";break;case"bottom":Qe="bottom-end";break;default:Qe=Z}const Xe={ref:de,id:se.current,labelId:Pe,anchorElement:(null==me?void 0:me.parentElement)||void 0,onSelect:ze,onSelectListClose:Ge,onMouseDown:function(){pe.current=!0},filterText:ke.trim(),highlightedValue:Se,noResultsMessage:V,listActionButton:T,listMaxHeight:H,onListAction:function(){ge(!1),null==W||W()},isLoading:K,onListScrollBottom:G,tableHeader:J,multiColumn:N,listPlacement:void 0!==oe?Qe:Z,flipEnabled:$,isOpen:ye,enableVirtualScroll:ee,virtualScrollOverscan:te,listWidth:oe},Ye=ne?e.jsx(s.default,C(O({},Xe),{children:P})):e.jsx(j,C(O({},Xe),{children:P})),Ze=r.default(ie);return e.jsxs(u.default,C(O({hasTextCursor:!0,readOnly:z,disabled:U,"data-component":"filterable-select","data-role":X,"data-element":Q,isOpen:ye},Ze),{children:[e.jsx("div",{ref:ce,children:e.jsx(o.default,O({ref:Ne,activeDescendantId:ae,ariaLabel:m,ariaLabelledby:g,labelId:L?Pe:void 0,"aria-controls":se.current,isOpen:ye,hasTextCursor:!0},C(O({id:Le.current,name:q,label:L,disabled:U,readOnly:z,selectedValue:_e,formattedValue:Oe,onClick:function(e){pe.current=!1,F&&F(e),ge(!0)},iconOnClick:function(e){pe.current=!1,F&&F(e),ge((e=>!e))},iconOnMouseDown:Je,onFocus:function(e){const t=()=>null==B?void 0:B(e);if(I){if(Ee.current&&clearTimeout(Ee.current),Re.current)return;Ee.current=setTimeout((()=>{ge((e=>!(!e&&(B&&!be.current&&(t(),be.current=!0),pe.current&&!ve.current))))}))}else B&&!be.current&&(t(),be.current=!0)},onBlur:function(e){ve.current=!1,pe.current||(be.current=!1,M&&M(e))},onKeyDown:Ve,onChange:Me,onMouseDown:Je,tooltipPosition:Y,required:le,isOptional:re},l.default(ie)),{"data-component":void 0})))}),Ye]}))}));exports.FilterableSelect=S,exports.default=S;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),n=require("invariant");require("../../../style/utils/filter-styled-system-padding-props.js");var r=require("../../../style/utils/filter-styled-system-margin-props.js"),l=require("../../../style/utils/filter-out-styled-system-spacing-props.js"),o=require("../__internal__/select-textbox/select-textbox.component.js"),i=require("../../../__internal__/utils/helpers/guid/index.js"),u=require("../__internal__/utils/with-filter.hoc.js"),a=require("../select.style.js"),s=require("../__internal__/select-list/select-list.component.js"),c=require("../__internal__/utils/is-expected-option.js"),d=require("../__internal__/utils/are-objects-equal.js"),f=require("../__internal__/utils/is-navigation-key.js"),p=require("../../../__internal__/utils/logger/index.js"),b=require("../../../hooks/__internal__/useStableCallback/useStableCallback.js"),v=require("../../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js");function m(e){return e&&e.__esModule?e:{default:e}}var y=m(t),g=m(n);function h(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function O(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{},r=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(r=r.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),r.forEach((function(t){h(e,t,n[t])}))}return e}function C(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t.push.apply(t,n)}return t}(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))})),e}let _=!1;const j=u.default(s.default),w=y.default.forwardRef(((n,u)=>{var{"aria-label":m,"aria-labelledby":h,value:w,defaultValue:S,id:x,name:k,label:q,children:L,onOpen:P,onChange:E,onFilterChange:R,onClick:D,onKeyDown:A,onFocus:F,onBlur:B,openOnFocus:M,noResultsMessage:V,listActionButton:I,listMaxHeight:T,onListAction:H,isLoading:W,disabled:K,readOnly:U,onListScrollBottom:z,tableHeader:G,multiColumn:J,"data-element":N,"data-role":Q,tooltipPosition:X,listPlacement:Y="bottom",flipEnabled:Z=!0,enableVirtualScroll:$,virtualScrollOverscan:ee,disableDefaultFiltering:te=!1,required:ne,listWidth:re}=n,le=function(e,t){if(null==e)return{};var n,r,l=function(e,t){if(null==e)return{};var n,r,l={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(l[n]=e[n]);return l}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(l[n]=e[n])}return l}(n,["aria-label","aria-labelledby","value","defaultValue","id","name","label","children","onOpen","onChange","onFilterChange","onClick","onKeyDown","onFocus","onBlur","openOnFocus","noResultsMessage","listActionButton","listMaxHeight","onListAction","isLoading","disabled","readOnly","onListScrollBottom","tableHeader","multiColumn","data-element","data-role","tooltipPosition","listPlacement","flipEnabled","enableVirtualScroll","virtualScrollOverscan","disableDefaultFiltering","required","listWidth"]);const[oe,ie]=t.useState(""),ue=t.useRef(i.default()),ae=t.useRef(null),se=t.useRef(null),ce=t.useRef(void 0!==w),de=t.useRef(!1),fe=t.useRef(!1),pe=t.useRef(!1),[be,ve]=t.useState(),[me,ye]=t.useState(!1),[ge,he]=t.useState(""),[Oe,Ce]=t.useState(w||S||""),_e=t.useRef(w),[je,we]=t.useState(""),[Se,xe]=t.useState(""),ke=t.useRef(x||i.default()),{labelId:qe}=v.default({id:ke.current,label:q}),Le=t.useRef(null),Pe=t.useRef(!1);!_&&(!ce||!E&&S)&&(_=!0,p.default.deprecate("Uncontrolled behaviour in `Filterable Select` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const Ee=t.useCallback(((e,t)=>({target:C(O({},k&&{name:k},x&&{id:x}),{value:e}),selectionConfirmed:t})),[k,x]),Re=t.useCallback(((e,t)=>{E&&E(Ee(e,t))}),[E,Ee]),De=t.useCallback(((e,t)=>{Ce((n=>{var r;const l=e.trimStart(),o=(i=l,u=L,y.default.Children.toArray(u).find((e=>{const{text:t}=e.props;return-1!==(null==t?void 0:t.toLowerCase().indexOf(null==i?void 0:i.toLowerCase()))})));var i,u;const a=t&&!e.length;return!o||a||o.props.disabled?(he(e),Re("",!1),""):(l.length&&Re(o.props.value,!1),t?(he(e),o.props.value):(l.length&&(null===(r=o.props.text)||void 0===r?void 0:r.toLowerCase().startsWith(l.toLowerCase()))?he(o.props.text):he(e),ce.current?n:(we(o.props.value),o.props.value)))}))}),[L,Re]),Ae=t.useCallback(((e,t=!1)=>{var n;const r=y.default.Children.toArray(L).find((t=>y.default.isValidElement(t)&&c.default(t,e)));r&&void 0!==r.props.text?(t||(null===(n=r.props.text)||void 0===n?void 0:n.toLowerCase().startsWith(null==Se?void 0:Se.toLowerCase().trim())))&&he(r.props.text):he(Se||"")}),[L,Se]),Fe=t.useCallback((e=>{const t=e.target.value,{inputType:n}=e.nativeEvent;De(t,"deleteContentBackward"===n||"deleteContentForward"===n||"delete"===n),xe(t),ye(!0)}),[De]),Be=t.useCallback((e=>{xe((t=>(null==t?void 0:t.length)===(null==ge?void 0:ge.length)-1&&e===ge.slice(-1)?ge:t))}),[ge]),Me=t.useCallback((e=>{const{key:t}=e;A&&A(e),U||(!e.defaultPrevented&&f.default(t)&&(e.preventDefault(),ye(!0)),Be(t))}),[Be,A,U]),Ve=ce.current?w:Oe,Ie=t.useCallback((e=>{const t=ae.current&&!ae.current.contains(e.target),n=se.current&&!se.current.contains(e.target);de.current=!1,t&&n&&(Ae(Ve,!0),ye(!1))}),[Ae,Ve]);t.useEffect((()=>{g.default(ce.current===(void 0!==w),"Input elements should not switch from uncontrolled to controlled (or vice versa). Decide between using a controlled or uncontrolled input element for the lifetime of the component"),g.default(!ce.current||ce.current&&E,"onChange prop required when using a controlled input element"),ce.current?(Ce((e=>(w&&e!==w&&Ae(w),w))),we(w)):(ge!==Oe&&Ae(Oe),je!==Oe&&we(Oe))}),[w,E,L]);const Te=b.useStableCallback(P);t.useEffect((()=>{me?Te&&Te():xe("")}),[Te,me]),t.useEffect((()=>{const e=void 0!==I;g.default(!e||e&&H,"onListAction prop required when using listActionButton prop")}),[I,H]);const He=t.useRef(!0);t.useEffect((()=>{He.current&&Ae(Oe),ce.current&&("object"==typeof w&&"object"==typeof _e.current?d.default(w,_e.current)||(Ae(w),_e.current=w):Ae(w))}),[w,L]);const We=b.useStableCallback(R);t.useEffect((()=>{We&&!He.current&&We(Se)}),[We,Se]),t.useEffect((()=>{He.current=!1}),[]),t.useEffect((()=>{const e="click";return window.addEventListener(e,Ie),function(){window.removeEventListener(e,Ie)}}),[Ie]),t.useEffect((()=>{const e=null==Se?void 0:Se.trimStart(),t=null==ge?void 0:ge.toLowerCase().startsWith(e.toLowerCase());!K&&!U&&be&&e.length&&(null==ge?void 0:ge.length)>e.length&&t&&(be.selectionStart=e.length)}),[ge,Se,be,K,U]);const Ke=t.useCallback((e=>{const{id:t,text:n,value:r,selectionType:l,selectionConfirmed:o}=e;ce.current||(Ce(r),we(r)),he(n),Re(r,!!o),ie(t),"navigationKey"!==l&&(Pe.current=!!M,ye(!1),null==be||be.focus(),null==be||be.select(),Pe.current=!1)}),[be,Re,M]),Ue=t.useCallback((()=>{ye(!1),Ae(Oe,!0)}),[Oe,Ae]);function ze(e){de.current=!0,"input"===e.target.dataset.element&&(pe.current=!0)}t.useEffect((()=>()=>{Le.current&&clearTimeout(Le.current)}),[]);const Ge=t.useCallback((e=>{e&&(ve(e),u&&("function"==typeof u?u(e):u.current=e))}),[u]);let Je;switch(Y){case"top":Je="top-end";break;case"bottom":Je="bottom-end";break;default:Je=Y}const Ne={ref:se,id:ue.current,labelId:qe,anchorElement:(null==be?void 0:be.parentElement)||void 0,onSelect:Ke,onSelectListClose:Ue,onMouseDown:function(){de.current=!0},filterText:Se.trim(),highlightedValue:je,noResultsMessage:V,listActionButton:I,listMaxHeight:T,onListAction:function(){ye(!1),null==H||H()},isLoading:W,onListScrollBottom:z,tableHeader:G,multiColumn:J,listPlacement:void 0!==re?Je:Y,flipEnabled:Z,isOpen:me,enableVirtualScroll:$,virtualScrollOverscan:ee,listWidth:re},Qe=te?e.jsx(s.default,C(O({},Ne),{children:L})):e.jsx(j,C(O({},Ne),{children:L})),Xe=r.default(le);return e.jsxs(a.default,C(O({hasTextCursor:!0,readOnly:U,disabled:K,"data-component":"filterable-select","data-role":Q,"data-element":N,isOpen:me},Xe),{children:[e.jsx("div",{ref:ae,children:e.jsx(o.default,O({ref:Ge,activeDescendantId:oe,ariaLabel:m,ariaLabelledby:h,labelId:q?qe:void 0,"aria-controls":ue.current,isOpen:me,hasTextCursor:!0},C(O({id:ke.current,name:k,label:q,disabled:K,readOnly:U,selectedValue:Oe,formattedValue:ge,onClick:function(e){de.current=!1,D&&D(e),ye(!0)},iconOnClick:function(e){de.current=!1,D&&D(e),ye((e=>!e))},iconOnMouseDown:ze,onFocus:function(e){const t=()=>null==F?void 0:F(e);if(M){if(Le.current&&clearTimeout(Le.current),Pe.current)return;Le.current=setTimeout((()=>{ye((e=>!(!e&&(F&&!fe.current&&(t(),fe.current=!0),de.current&&!pe.current))))}))}else F&&!fe.current&&(t(),fe.current=!0)},onBlur:function(e){pe.current=!1,de.current||(fe.current=!1,B&&B(e))},onKeyDown:Me,onChange:Fe,onMouseDown:ze,tooltipPosition:X,required:ne},l.default(le)),{"data-component":void 0})))}),Qe]}))}));exports.FilterableSelect=w,exports.default=w;

package/lib/components/select/multi-select/multi-select.component.d.ts

@@ -52,11 +52,6 @@ export interface MultiSelectProps extends Omit<FormInputPropTypes, "defaultValue
      * Higher values make for smoother scrolling but may impact performance.
      * Only used if the `enableVirtualScroll` prop is set. */
     virtualScrollOverscan?: number;
-    /**
-     * [Legacy] Flag to configure component as optional.
-     * @deprecated If the value of this component is not required, use the `required` prop and set it to false instead.
-     */
-    isOptional?: boolean;
     /** Specify a callback triggered on change */
     onChange?: (ev: CustomSelectChangeEvent | React.ChangeEvent<HTMLInputElement>) => void;
     /** Override the default width of the list element. Number passed is converted into pixel value */

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),l=require("invariant");require("../../../style/utils/filter-styled-system-padding-props.js");var r=require("../../../style/utils/filter-styled-system-margin-props.js"),n=require("../../../style/utils/filter-out-styled-system-spacing-props.js"),i=require("../__internal__/select-textbox/select-textbox.component.js"),o=require("../../../__internal__/utils/helpers/guid/index.js"),u=require("../__internal__/utils/with-filter.hoc.js"),a=require("../__internal__/select-list/select-list.component.js"),s=require("./multi-select.style.js"),c=require("../../pill/pill.component.js"),d=require("../__internal__/utils/is-expected-option.js"),f=require("../__internal__/utils/is-expected-value.js"),p=require("../__internal__/utils/is-navigation-key.js"),b=require("../../../__internal__/utils/logger/index.js"),v=require("../../../hooks/__internal__/useStableCallback/useStableCallback.js"),m=require("../../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js");function y(e){return e&&e.__esModule?e:{default:e}}var h=y(t),g=y(l);function O(e,t,l){return t in e?Object.defineProperty(e,t,{value:l,enumerable:!0,configurable:!0,writable:!0}):e[t]=l,e}function _(e){for(var t=1;t<arguments.length;t++){var l=null!=arguments[t]?arguments[t]:{},r=Object.keys(l);"function"==typeof Object.getOwnPropertySymbols&&(r=r.concat(Object.getOwnPropertySymbols(l).filter((function(e){return Object.getOwnPropertyDescriptor(l,e).enumerable})))),r.forEach((function(t){O(e,t,l[t])}))}return e}function j(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);t.push.apply(t,l)}return t}(Object(t)).forEach((function(l){Object.defineProperty(e,l,Object.getOwnPropertyDescriptor(t,l))})),e}let C=!1;const S=u.default(a.default);let x=!1;const w=h.default.forwardRef(((l,u)=>{var{"aria-label":a,"aria-labelledby":y,value:O,defaultValue:w,id:k,label:P,name:q,disabled:E,readOnly:M,children:R,onOpen:D,onFilterChange:L,onChange:V,onClick:I,onFocus:T,onBlur:B,onKeyDown:F,openOnFocus:H=!1,noResultsMessage:A,placeholder:z,isLoading:K,onListScrollBottom:W,tableHeader:$,multiColumn:U,tooltipPosition:G,size:J="medium","data-element":N,"data-role":Q,listPlacement:X="bottom",listMaxHeight:Y,flipEnabled:Z=!0,wrapPillText:ee=!0,enableVirtualScroll:te,virtualScrollOverscan:le,isOptional:re,required:ne,listWidth:ie}=l,oe=function(e,t){if(null==e)return{};var l,r,n=function(e,t){if(null==e)return{};var l,r,n={},i=Object.keys(e);for(r=0;r<i.length;r++)l=i[r],t.indexOf(l)>=0||(n[l]=e[l]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)l=i[r],t.indexOf(l)>=0||Object.prototype.propertyIsEnumerable.call(e,l)&&(n[l]=e[l])}return n}(l,["aria-label","aria-labelledby","value","defaultValue","id","label","name","disabled","readOnly","children","onOpen","onFilterChange","onChange","onClick","onFocus","onBlur","onKeyDown","openOnFocus","noResultsMessage","placeholder","isLoading","onListScrollBottom","tableHeader","multiColumn","tooltipPosition","size","data-element","data-role","listPlacement","listMaxHeight","flipEnabled","wrapPillText","enableVirtualScroll","virtualScrollOverscan","isOptional","required","listWidth"]);!x&&re&&(x=!0,b.default.deprecate("`isOptional` is deprecated in MultiSelect and support will soon be removed. If the value of this component is not required, use the `required` prop and set it to false instead."));const[ue,ae]=t.useState(""),se=t.useRef(o.default()),ce=t.useRef(o.default()),de=t.useRef(null),fe=t.useRef(null),pe=t.useRef(!1),be=t.useRef(!1),ve=t.useRef(!1),me=t.useRef(!1),ye=t.useRef(!1),he=t.useRef(void 0!==O),[ge,Oe]=t.useState(),[_e,je]=t.useState(!1),[Ce,Se]=t.useState(""),[xe,we]=t.useState(O||w||[]),[ke,Pe]=t.useState(""),[qe,Ee]=t.useState(""),[Me,Re]=t.useState(),De=t.useRef(k||o.default()),{labelId:Le}=m.default({id:De.current,label:P}),Ve=t.useRef(null),Ie=he.current?O:xe;!C&&(!he||!V&&w)&&(C=!0,b.default.deprecate("Uncontrolled behaviour in `Multi Select` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const Te=t.useCallback((()=>{je((e=>(!e&&D&&D(),!0)))}),[D]),Be=t.useCallback(((e,t)=>({target:j(_({},q&&{name:q},k&&{id:k}),{value:e}),selectionConfirmed:t})),[q,k]),Fe=t.useCallback(((e,t)=>{const l=e(Ie);l.length!==(null==Ie?void 0:Ie.length)&&(null==V||V(Be(l,t))),he.current||we(e)}),[Be,V,Ie]),He=t.useCallback((e=>{const t=e.target.value,l=(r=t,n=R,h.default.Children.toArray(n).find((e=>{const{text:t}=e.props;return-1!==(null==t?void 0:t.toLowerCase().indexOf(null==r?void 0:r.toLowerCase()))})));var r,n;l&&Pe(l.props.value),Ee(t),Se(t),Te()}),[R,Te]),Ae=t.useCallback((e=>{be.current=!0,Fe((t=>{if(!t.length)return t;const l=t.slice();return l.splice(e,1),l}),!0)}),[Fe]),ze=t.useCallback((e=>{const{key:t}=e,l="Backspace"===t||"Delete"===t;F&&F(e),M||(!e.defaultPrevented&&p.default(t)&&(e.preventDefault(),Te()),!l||""!==qe&&""!==Ce||Ae(-1))}),[F,M,qe,Ce,Te,Ae]),Ke=t.useMemo((()=>{var e;return Ie&&Ie.length?null===(e=h.default.Children.map(R,(e=>!(!h.default.isValidElement(e)||!Ie.includes(e.props.value))&&e.props.text)))||void 0===e?void 0:e.filter((e=>e)).reduce(((e,t)=>e?`${e}, ${t}`:t),""):null}),[R,Ie]),We=t.useCallback((e=>{if(ve.current=!1,!_e)return;const t=de.current&&!de.current.contains(e.target),l=fe.current&&!fe.current.contains(e.target);t&&l&&!be.current&&(Se(""),Ee(""),Pe(""),je(!1)),be.current=!1}),[_e]),$e=t.useMemo((()=>{const t=!E&&!M;let l;return(null==Ie?void 0:Ie.length)?Ie.map(((r,n)=>{const i=h.default.Children.toArray(R).find((e=>h.default.isValidElement(e)&&d.default(e,r)));let o={};if(!i)return null;var u,a;h.default.isValidElement(i)&&(l=void 0!==(null==i||null===(u=i.props.value)||void 0===u?void 0:u.value)?null==i||null===(a=i.props.value)||void 0===a?void 0:a.value:null==i?void 0:i.props.value,o={title:i.props.text,fill:i.props.fill,borderColor:i.props.borderColor});const f=o.title||"",p=f+l||n;return e.jsx(s.StyledSelectPillContainer,{children:e.jsx(c.Pill,j(_({onDelete:t?()=>Ae(n):void 0,wrapText:ee},o),{children:f}))},p)})):""}),[R,E,M,Ie]);t.useEffect((()=>{g.default(he.current===(void 0!==O),"Input elements should not switch from uncontrolled to controlled (or vice versa). Decide between using a controlled or uncontrolled input element for the lifetime of the component"),g.default(!he.current||he.current&&V,"onChange prop required when using a controlled input element")}),[O,V]),t.useEffect((()=>{const e=null==O?void 0:O.length,t=null==Ie?void 0:Ie.length;Re(e||t?" ":z)}),[O,Ie,z]),t.useEffect((()=>{const e="click";return window.addEventListener(e,We),function(){window.removeEventListener(e,We)}}),[We]);const Ue=v.useStableCallback(L),Ge=t.useRef(!0);function Je(e){ve.current=!0,"input"===e.target.dataset.element&&(me.current=!0)}t.useEffect((()=>{Ue&&!Ge.current&&Ue(qe)}),[Ue,qe]),t.useEffect((()=>{Ge.current=!1}),[]);const Ne=t.useCallback((e=>{const{value:t,selectionType:l,id:r,selectionConfirmed:n}=e;if("navigationKey"===l)return Pe(t),void ae(r);"click"===l&&(be.current=!0),Se("");const i=-1!==(null==Ie?void 0:Ie.findIndex((e=>f.default(e,t))));null==ge||ge.focus(),ve.current=!1,Fe((e=>i?e:[...e,t]),n)}),[ge,Ie,Fe]),Qe=t.useCallback((()=>{je(!1),Ee("")}),[]),Xe=t.useCallback((e=>{e&&(Oe(e),u&&("function"==typeof u?u(e):u.current=e))}),[u]);let Ye;switch(X){case"top":Ye="top-end";break;case"bottom":Ye="bottom-end";break;default:Ye=X}const Ze=e.jsx(S,{ref:fe,id:se.current,labelId:Le,anchorElement:(null==ge?void 0:ge.parentElement)||void 0,onSelect:Ne,onSelectListClose:Qe,onMouseDown:function(){ve.current=!0},filterText:qe.trim(),highlightedValue:ke,noResultsMessage:A,isLoading:K,onListScrollBottom:W,tableHeader:$,multiColumn:U,listPlacement:void 0!==ie?Ye:X,listMaxHeight:Y,flipEnabled:Z,multiselectValues:Ie,isOpen:_e,enableVirtualScroll:te,virtualScrollOverscan:le,listWidth:ie,children:R}),et=r.default(oe);return e.jsxs(s.StyledSelectMultiSelect,j(_({disabled:E,readOnly:M,hasTextCursor:!0,size:J,"data-component":"multiselect","data-role":Q,"data-element":N,isOpen:_e},et),{children:[e.jsxs("div",{ref:de,children:[e.jsx(s.StyledAccessibilityLabelContainer,{"data-element":"accessibility-label",id:ce.current,children:Ke}),e.jsx(i.default,_({ref:Xe,accessibilityLabelId:ce.current,activeDescendantId:ue,"aria-controls":se.current,ariaLabel:a,ariaLabelledby:y,hasTextCursor:!0,isOpen:_e,labelId:Le},j(_({id:De.current,name:q,disabled:E,label:P,readOnly:M,placeholder:Me,leftChildren:$e,formattedValue:Ce,selectedValue:Ie,onClick:function(e){if(ve.current=!1,I&&I(e),!H||H&&!ye.current){if(_e)return Ee(""),void je(!1);null==D||D(),je(!0)}else ye.current=!1},onMouseDown:Je,onFocus:function(e){const t=()=>null==T?void 0:T(e);H?(Ve.current&&clearTimeout(Ve.current),Ve.current=setTimeout((()=>{je((e=>!!e||(D&&D(),T&&!pe.current&&(t(),pe.current=!0),ve.current&&!me.current?(ye.current=!1,!1):(me.current&&(ye.current=!0),!0))))}))):T&&!pe.current&&(t(),pe.current=!0)},onBlur:function(e){me.current=!1,ve.current||(pe.current=!1,B&&B(e))},iconOnClick:function(e){ve.current=!1,I&&I(e),je((e=>e?(Ee(""),!1):(D&&D(),!0)))},iconOnMouseDown:Je,onKeyDown:ze,onChange:He,tooltipPosition:G,size:J,required:ne,isOptional:re},n.default(oe)),{"data-component":void 0})))]}),Ze]}))}));exports.MultiSelect=w,exports.default=w;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),l=require("invariant");require("../../../style/utils/filter-styled-system-padding-props.js");var r=require("../../../style/utils/filter-styled-system-margin-props.js"),n=require("../../../style/utils/filter-out-styled-system-spacing-props.js"),i=require("../__internal__/select-textbox/select-textbox.component.js"),o=require("../../../__internal__/utils/helpers/guid/index.js"),u=require("../__internal__/utils/with-filter.hoc.js"),a=require("../__internal__/select-list/select-list.component.js"),s=require("./multi-select.style.js"),c=require("../../pill/pill.component.js"),d=require("../__internal__/utils/is-expected-option.js"),f=require("../__internal__/utils/is-expected-value.js"),p=require("../__internal__/utils/is-navigation-key.js"),b=require("../../../__internal__/utils/logger/index.js"),v=require("../../../hooks/__internal__/useStableCallback/useStableCallback.js"),m=require("../../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js");function y(e){return e&&e.__esModule?e:{default:e}}var h=y(t),g=y(l);function O(e,t,l){return t in e?Object.defineProperty(e,t,{value:l,enumerable:!0,configurable:!0,writable:!0}):e[t]=l,e}function _(e){for(var t=1;t<arguments.length;t++){var l=null!=arguments[t]?arguments[t]:{},r=Object.keys(l);"function"==typeof Object.getOwnPropertySymbols&&(r=r.concat(Object.getOwnPropertySymbols(l).filter((function(e){return Object.getOwnPropertyDescriptor(l,e).enumerable})))),r.forEach((function(t){O(e,t,l[t])}))}return e}function j(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);t.push.apply(t,l)}return t}(Object(t)).forEach((function(l){Object.defineProperty(e,l,Object.getOwnPropertyDescriptor(t,l))})),e}let C=!1;const S=u.default(a.default),x=h.default.forwardRef(((l,u)=>{var{"aria-label":a,"aria-labelledby":y,value:O,defaultValue:x,id:w,label:k,name:P,disabled:q,readOnly:E,children:R,onOpen:M,onFilterChange:D,onChange:L,onClick:V,onFocus:I,onBlur:T,onKeyDown:B,openOnFocus:F=!1,noResultsMessage:H,placeholder:A,isLoading:z,onListScrollBottom:K,tableHeader:W,multiColumn:$,tooltipPosition:U,size:G="medium","data-element":J,"data-role":N,listPlacement:Q="bottom",listMaxHeight:X,flipEnabled:Y=!0,wrapPillText:Z=!0,enableVirtualScroll:ee,virtualScrollOverscan:te,required:le,listWidth:re}=l,ne=function(e,t){if(null==e)return{};var l,r,n=function(e,t){if(null==e)return{};var l,r,n={},i=Object.keys(e);for(r=0;r<i.length;r++)l=i[r],t.indexOf(l)>=0||(n[l]=e[l]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)l=i[r],t.indexOf(l)>=0||Object.prototype.propertyIsEnumerable.call(e,l)&&(n[l]=e[l])}return n}(l,["aria-label","aria-labelledby","value","defaultValue","id","label","name","disabled","readOnly","children","onOpen","onFilterChange","onChange","onClick","onFocus","onBlur","onKeyDown","openOnFocus","noResultsMessage","placeholder","isLoading","onListScrollBottom","tableHeader","multiColumn","tooltipPosition","size","data-element","data-role","listPlacement","listMaxHeight","flipEnabled","wrapPillText","enableVirtualScroll","virtualScrollOverscan","required","listWidth"]);const[ie,oe]=t.useState(""),ue=t.useRef(o.default()),ae=t.useRef(o.default()),se=t.useRef(null),ce=t.useRef(null),de=t.useRef(!1),fe=t.useRef(!1),pe=t.useRef(!1),be=t.useRef(!1),ve=t.useRef(!1),me=t.useRef(void 0!==O),[ye,he]=t.useState(),[ge,Oe]=t.useState(!1),[_e,je]=t.useState(""),[Ce,Se]=t.useState(O||x||[]),[xe,we]=t.useState(""),[ke,Pe]=t.useState(""),[qe,Ee]=t.useState(),Re=t.useRef(w||o.default()),{labelId:Me}=m.default({id:Re.current,label:k}),De=t.useRef(null),Le=me.current?O:Ce;!C&&(!me||!L&&x)&&(C=!0,b.default.deprecate("Uncontrolled behaviour in `Multi Select` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const Ve=t.useCallback((()=>{Oe((e=>(!e&&M&&M(),!0)))}),[M]),Ie=t.useCallback(((e,t)=>({target:j(_({},P&&{name:P},w&&{id:w}),{value:e}),selectionConfirmed:t})),[P,w]),Te=t.useCallback(((e,t)=>{const l=e(Le);l.length!==(null==Le?void 0:Le.length)&&(null==L||L(Ie(l,t))),me.current||Se(e)}),[Ie,L,Le]),Be=t.useCallback((e=>{const t=e.target.value,l=(r=t,n=R,h.default.Children.toArray(n).find((e=>{const{text:t}=e.props;return-1!==(null==t?void 0:t.toLowerCase().indexOf(null==r?void 0:r.toLowerCase()))})));var r,n;l&&we(l.props.value),Pe(t),je(t),Ve()}),[R,Ve]),Fe=t.useCallback((e=>{fe.current=!0,Te((t=>{if(!t.length)return t;const l=t.slice();return l.splice(e,1),l}),!0)}),[Te]),He=t.useCallback((e=>{const{key:t}=e,l="Backspace"===t||"Delete"===t;B&&B(e),E||(!e.defaultPrevented&&p.default(t)&&(e.preventDefault(),Ve()),!l||""!==ke&&""!==_e||Fe(-1))}),[B,E,ke,_e,Ve,Fe]),Ae=t.useMemo((()=>{var e;return Le&&Le.length?null===(e=h.default.Children.map(R,(e=>!(!h.default.isValidElement(e)||!Le.includes(e.props.value))&&e.props.text)))||void 0===e?void 0:e.filter((e=>e)).reduce(((e,t)=>e?`${e}, ${t}`:t),""):null}),[R,Le]),ze=t.useCallback((e=>{if(pe.current=!1,!ge)return;const t=se.current&&!se.current.contains(e.target),l=ce.current&&!ce.current.contains(e.target);t&&l&&!fe.current&&(je(""),Pe(""),we(""),Oe(!1)),fe.current=!1}),[ge]),Ke=t.useMemo((()=>{const t=!q&&!E;let l;return(null==Le?void 0:Le.length)?Le.map(((r,n)=>{const i=h.default.Children.toArray(R).find((e=>h.default.isValidElement(e)&&d.default(e,r)));let o={};if(!i)return null;var u,a;h.default.isValidElement(i)&&(l=void 0!==(null==i||null===(u=i.props.value)||void 0===u?void 0:u.value)?null==i||null===(a=i.props.value)||void 0===a?void 0:a.value:null==i?void 0:i.props.value,o={title:i.props.text,fill:i.props.fill,borderColor:i.props.borderColor});const f=o.title||"",p=f+l||n;return e.jsx(s.StyledSelectPillContainer,{children:e.jsx(c.Pill,j(_({onDelete:t?()=>Fe(n):void 0,wrapText:Z},o),{children:f}))},p)})):""}),[R,q,E,Le]);t.useEffect((()=>{g.default(me.current===(void 0!==O),"Input elements should not switch from uncontrolled to controlled (or vice versa). Decide between using a controlled or uncontrolled input element for the lifetime of the component"),g.default(!me.current||me.current&&L,"onChange prop required when using a controlled input element")}),[O,L]),t.useEffect((()=>{const e=null==O?void 0:O.length,t=null==Le?void 0:Le.length;Ee(e||t?" ":A)}),[O,Le,A]),t.useEffect((()=>{const e="click";return window.addEventListener(e,ze),function(){window.removeEventListener(e,ze)}}),[ze]);const We=v.useStableCallback(D),$e=t.useRef(!0);function Ue(e){pe.current=!0,"input"===e.target.dataset.element&&(be.current=!0)}t.useEffect((()=>{We&&!$e.current&&We(ke)}),[We,ke]),t.useEffect((()=>{$e.current=!1}),[]);const Ge=t.useCallback((e=>{const{value:t,selectionType:l,id:r,selectionConfirmed:n}=e;if("navigationKey"===l)return we(t),void oe(r);"click"===l&&(fe.current=!0),je("");const i=-1!==(null==Le?void 0:Le.findIndex((e=>f.default(e,t))));null==ye||ye.focus(),pe.current=!1,Te((e=>i?e:[...e,t]),n)}),[ye,Le,Te]),Je=t.useCallback((()=>{Oe(!1),Pe("")}),[]),Ne=t.useCallback((e=>{e&&(he(e),u&&("function"==typeof u?u(e):u.current=e))}),[u]);let Qe;switch(Q){case"top":Qe="top-end";break;case"bottom":Qe="bottom-end";break;default:Qe=Q}const Xe=e.jsx(S,{ref:ce,id:ue.current,labelId:Me,anchorElement:(null==ye?void 0:ye.parentElement)||void 0,onSelect:Ge,onSelectListClose:Je,onMouseDown:function(){pe.current=!0},filterText:ke.trim(),highlightedValue:xe,noResultsMessage:H,isLoading:z,onListScrollBottom:K,tableHeader:W,multiColumn:$,listPlacement:void 0!==re?Qe:Q,listMaxHeight:X,flipEnabled:Y,multiselectValues:Le,isOpen:ge,enableVirtualScroll:ee,virtualScrollOverscan:te,listWidth:re,children:R}),Ye=r.default(ne);return e.jsxs(s.StyledSelectMultiSelect,j(_({disabled:q,readOnly:E,hasTextCursor:!0,size:G,"data-component":"multiselect","data-role":N,"data-element":J,isOpen:ge},Ye),{children:[e.jsxs("div",{ref:se,children:[e.jsx(s.StyledAccessibilityLabelContainer,{"data-element":"accessibility-label",id:ae.current,children:Ae}),e.jsx(i.default,_({ref:Ne,accessibilityLabelId:ae.current,activeDescendantId:ie,"aria-controls":ue.current,ariaLabel:a,ariaLabelledby:y,hasTextCursor:!0,isOpen:ge,labelId:Me},j(_({id:Re.current,name:P,disabled:q,label:k,readOnly:E,placeholder:qe,leftChildren:Ke,formattedValue:_e,selectedValue:Le,onClick:function(e){if(pe.current=!1,V&&V(e),!F||F&&!ve.current){if(ge)return Pe(""),void Oe(!1);null==M||M(),Oe(!0)}else ve.current=!1},onMouseDown:Ue,onFocus:function(e){const t=()=>null==I?void 0:I(e);F?(De.current&&clearTimeout(De.current),De.current=setTimeout((()=>{Oe((e=>!!e||(M&&M(),I&&!de.current&&(t(),de.current=!0),pe.current&&!be.current?(ve.current=!1,!1):(be.current&&(ve.current=!0),!0))))}))):I&&!de.current&&(t(),de.current=!0)},onBlur:function(e){be.current=!1,pe.current||(de.current=!1,T&&T(e))},iconOnClick:function(e){pe.current=!1,V&&V(e),Oe((e=>e?(Pe(""),!1):(M&&M(),!0)))},iconOnMouseDown:Ue,onKeyDown:He,onChange:Be,tooltipPosition:U,size:G,required:le},n.default(ne)),{"data-component":void 0})))]}),Xe]}))}));exports.MultiSelect=x,exports.default=x;

package/lib/components/select/simple-select/simple-select.component.d.ts

@@ -50,11 +50,6 @@ export interface SimpleSelectProps extends Omit<FormInputPropTypes, "defaultValu
      * Higher values make for smoother scrolling but may impact performance.
      * Only used if the `enableVirtualScroll` prop is set. */
     virtualScrollOverscan?: number;
-    /**
-     * [Legacy] Flag to configure component as optional.
-     * @deprecated If the value of this component is not required, use the `isRequired` prop and set it to false instead.
-     */
-    isOptional?: boolean;
     /** Flag to configure component as mandatory */
     isRequired?: boolean;
     /** Specify a callback triggered on change */

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),n=require("invariant");require("../../../style/utils/filter-styled-system-padding-props.js");var r=require("../../../style/utils/filter-styled-system-margin-props.js"),l=require("../../../style/utils/filter-out-styled-system-spacing-props.js"),i=require("../select.style.js"),o=require("../__internal__/select-textbox/select-textbox.component.js"),u=require("../__internal__/select-list/select-list.component.js"),a=require("../../../__internal__/utils/helpers/guid/index.js"),s=require("../__internal__/utils/get-next-child-by-text.js"),c=require("../__internal__/utils/is-expected-option.js"),d=require("../__internal__/utils/is-navigation-key.js"),f=require("../../../__internal__/utils/logger/index.js"),p=require("../../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js");function b(e){return e&&e.__esModule?e:{default:e}}var m=b(t),y=b(n);function O(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function v(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{},r=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(r=r.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),r.forEach((function(t){O(e,t,n[t])}))}return e}function w(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t.push.apply(t,n)}return t}(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))})),e}let g=!1,h=!1;const j=m.default.forwardRef(((n,b)=>{var{"aria-describedby":O,"aria-label":j,"aria-labelledby":_,value:S,defaultValue:x,id:k,label:q,name:C,disabled:P,readOnly:E,children:D,transparent:R,openOnFocus:L=!1,onOpen:I,onChange:V,onClick:M,onFocus:T,onKeyDown:B,onBlur:H,isLoading:K,listMaxHeight:F,onListScrollBottom:A,tableHeader:W,multiColumn:U,tooltipPosition:z,"data-element":G,"data-role":J,listPlacement:N="bottom",flipEnabled:Q=!0,enableVirtualScroll:X,virtualScrollOverscan:Y,isOptional:Z,required:$,listWidth:ee}=n,te=function(e,t){if(null==e)return{};var n,r,l=function(e,t){if(null==e)return{};var n,r,l={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(l[n]=e[n]);return l}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(l[n]=e[n])}return l}(n,["aria-describedby","aria-label","aria-labelledby","value","defaultValue","id","label","name","disabled","readOnly","children","transparent","openOnFocus","onOpen","onChange","onClick","onFocus","onKeyDown","onBlur","isLoading","listMaxHeight","onListScrollBottom","tableHeader","multiColumn","tooltipPosition","data-element","data-role","listPlacement","flipEnabled","enableVirtualScroll","virtualScrollOverscan","isOptional","required","listWidth"]);!h&&Z&&(h=!0,f.default.deprecate("`isOptional` is deprecated in SimpleSelect and support will soon be removed. If the value of this component is not required, use the `required` prop and set it to false instead."));const ne=t.useRef(a.default()),re=t.useRef(null),le=t.useRef(null),ie=t.useRef(void 0),oe=t.useRef(),ue=t.useRef(void 0!==S),ae=t.useRef(),se=t.useRef(),ce=t.useRef(),[de,fe]=t.useState(),[pe,be]=t.useState(!1),[me,ye]=t.useState(""),[Oe,ve]=t.useState(""),[we,ge]=t.useState(S||x||""),he=t.useRef(k||a.default()),{labelId:je}=p.default({id:he.current,label:q}),_e=t.useRef(void 0);!g&&(!ue||!V&&x)&&(g=!0,f.default.deprecate("Uncontrolled behaviour in `Simple Select` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const Se=t.useMemo((()=>m.default.Children.toArray(D)),[D]),xe=t.useCallback(((e,t=!1)=>({target:w(v({},C&&{name:C},k&&{id:k}),{value:e}),selectionConfirmed:t})),[C,k]),ke=t.useCallback((e=>{ge((t=>{const n=Se.findIndex((e=>m.default.isValidElement(e)&&c.default(e,t))),r=s.default(e,Se,n);return r?(null==V||V(xe(r.props.value)),ue.current?t:(ve(r.props.text),r.props.value)):t}))}),[Se,xe,V]),qe=t.useCallback((e=>{if(ae.current){const t=ce.current+e;ce.current=t,ke(t),window.clearTimeout(ie.current)}else ce.current=e,ke(e);ae.current=!0,window.clearTimeout(ie.current),ie.current=window.setTimeout((()=>{ae.current=!1,ce.current=""}),500)}),[ke]),Ce=t.useCallback((e=>{const{key:t}=e;null==B||B(e),E||(" "===t||d.default(t)?(e.preventDefault(),be((e=>(e||null==I||I(),!0)))):1!==t.length||e.metaKey||e.ctrlKey||qe(t))}),[qe,B,I,E]),Pe=t.useCallback((e=>{const t=re.current&&!re.current.contains(e.target),n=le.current&&!le.current.contains(e.target);oe.current=!1,t&&n&&!se.current&&be(!1),se.current=!1}),[]);function Ee(e){oe.current=!1,null==M||M(e),be((e=>!e&&(null==I||I(),!0)))}t.useEffect((()=>{y.default(ue.current===(void 0!==S),"Input elements should not switch from uncontrolled to controlled (or vice versa). Decide between using a controlled or uncontrolled input element for the lifetime of the component"),y.default(!ue.current||ue.current&&V,"onChange prop required when using a controlled input element"),ue.current&&ge(S)}),[S,V]),t.useEffect((()=>{const e=Se.find((e=>c.default(e,we)));let t="";e&&(t=e.props.text),ve(t)}),[we,Se]),t.useEffect((()=>{const e="click";return window.addEventListener(e,Pe),function(){window.removeEventListener(e,Pe)}}),[Pe]),t.useEffect((()=>function(){window.clearTimeout(ie.current),window.clearTimeout(_e.current)}),[]);const De=t.useCallback((()=>{be(!1)}),[]),Re=t.useCallback((e=>{e&&(fe(e),b&&("function"==typeof b?b(e):b.current=e))}),[b]);let Le;switch(N){case"top":Le="top-end";break;case"bottom":Le="bottom-end";break;default:Le=N}const Ie=e.jsx(u.default,{ref:le,id:ne.current,labelId:je,anchorElement:(null==de?void 0:de.parentElement)||void 0,onSelect:e=>{const{text:t,value:n,selectionType:r,id:l,selectionConfirmed:i}=e,o="click"===r;!function(e,t,n){ue.current||(ge(e),ve(t)),null==V||V(xe(e,n))}(n,t,i),ye(l),"navigationKey"!==r&&be(!1),o&&(se.current=!0,null==de||de.focus())},onMouseDown:function(){oe.current=!0},onSelectListClose:De,highlightedValue:we,listMaxHeight:F,isLoading:K,onListScrollBottom:A,tableHeader:W,multiColumn:U,listPlacement:void 0!==ee?Le:N,flipEnabled:Q,isOpen:pe,enableVirtualScroll:X,virtualScrollOverscan:Y,listWidth:ee,children:D}),Ve=r.default(te);return e.jsxs(i.default,w(v({transparent:R,disabled:P,readOnly:E,"data-component":"simple-select","data-role":J,"data-element":G,isOpen:pe},Ve),{children:[e.jsx("div",{ref:re,children:e.jsx(o.default,v({ref:Re,ariaLabel:j,"aria-controls":ne.current,activeDescendantId:me,ariaLabelledby:_,"aria-describedby":O,isOpen:pe},w(v({id:he.current,name:C,disabled:P,readOnly:E,selectedValue:we,formattedValue:Oe,onClick:Ee,iconOnClick:function(e){Ee(e)},label:q,labelId:je,onMouseDown:function(){oe.current=!0},onFocus:function(e){se.current||(null==T||T(e),oe.current?oe.current=!1:L&&(window.clearTimeout(_e.current),_e.current=window.setTimeout((()=>{be((e=>(e||null==I||I(),!0)))}))))},onKeyDown:Ce,onBlur:function(e){oe.current||null==H||H(e)},tooltipPosition:z,required:$,isOptional:Z,transparent:R},l.default(te)),{"data-component":void 0})))}),Ie]}))}));exports.SimpleSelect=j,exports.default=j;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),n=require("invariant");require("../../../style/utils/filter-styled-system-padding-props.js");var r=require("../../../style/utils/filter-styled-system-margin-props.js"),l=require("../../../style/utils/filter-out-styled-system-spacing-props.js"),o=require("../select.style.js"),i=require("../__internal__/select-textbox/select-textbox.component.js"),u=require("../__internal__/select-list/select-list.component.js"),a=require("../../../__internal__/utils/helpers/guid/index.js"),c=require("../__internal__/utils/get-next-child-by-text.js"),s=require("../__internal__/utils/is-expected-option.js"),d=require("../__internal__/utils/is-navigation-key.js"),f=require("../../../__internal__/utils/logger/index.js"),p=require("../../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js");function b(e){return e&&e.__esModule?e:{default:e}}var m=b(t),y=b(n);function v(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function O(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{},r=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(r=r.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),r.forEach((function(t){v(e,t,n[t])}))}return e}function g(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t.push.apply(t,n)}return t}(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))})),e}let w=!1;const h=m.default.forwardRef(((n,b)=>{var{"aria-describedby":v,"aria-label":h,"aria-labelledby":j,value:_,defaultValue:x,id:S,label:k,name:C,disabled:P,readOnly:q,children:E,transparent:D,openOnFocus:R=!1,onOpen:L,onChange:I,onClick:V,onFocus:M,onKeyDown:T,onBlur:B,isLoading:H,listMaxHeight:K,onListScrollBottom:F,tableHeader:A,multiColumn:W,tooltipPosition:U,"data-element":z,"data-role":G,listPlacement:J="bottom",flipEnabled:N=!0,enableVirtualScroll:Q,virtualScrollOverscan:X,required:Y,listWidth:Z}=n,$=function(e,t){if(null==e)return{};var n,r,l=function(e,t){if(null==e)return{};var n,r,l={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(l[n]=e[n]);return l}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(l[n]=e[n])}return l}(n,["aria-describedby","aria-label","aria-labelledby","value","defaultValue","id","label","name","disabled","readOnly","children","transparent","openOnFocus","onOpen","onChange","onClick","onFocus","onKeyDown","onBlur","isLoading","listMaxHeight","onListScrollBottom","tableHeader","multiColumn","tooltipPosition","data-element","data-role","listPlacement","flipEnabled","enableVirtualScroll","virtualScrollOverscan","required","listWidth"]);const ee=t.useRef(a.default()),te=t.useRef(null),ne=t.useRef(null),re=t.useRef(void 0),le=t.useRef(),oe=t.useRef(void 0!==_),ie=t.useRef(),ue=t.useRef(),ae=t.useRef(),[ce,se]=t.useState(),[de,fe]=t.useState(!1),[pe,be]=t.useState(""),[me,ye]=t.useState(""),[ve,Oe]=t.useState(_||x||""),ge=t.useRef(S||a.default()),{labelId:we}=p.default({id:ge.current,label:k}),he=t.useRef(void 0);!w&&(!oe||!I&&x)&&(w=!0,f.default.deprecate("Uncontrolled behaviour in `Simple Select` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const je=t.useMemo((()=>m.default.Children.toArray(E)),[E]),_e=t.useCallback(((e,t=!1)=>({target:g(O({},C&&{name:C},S&&{id:S}),{value:e}),selectionConfirmed:t})),[C,S]),xe=t.useCallback((e=>{Oe((t=>{const n=je.findIndex((e=>m.default.isValidElement(e)&&s.default(e,t))),r=c.default(e,je,n);return r?(null==I||I(_e(r.props.value)),oe.current?t:(ye(r.props.text),r.props.value)):t}))}),[je,_e,I]),Se=t.useCallback((e=>{if(ie.current){const t=ae.current+e;ae.current=t,xe(t),window.clearTimeout(re.current)}else ae.current=e,xe(e);ie.current=!0,window.clearTimeout(re.current),re.current=window.setTimeout((()=>{ie.current=!1,ae.current=""}),500)}),[xe]),ke=t.useCallback((e=>{const{key:t}=e;null==T||T(e),q||(" "===t||d.default(t)?(e.preventDefault(),fe((e=>(e||null==L||L(),!0)))):1!==t.length||e.metaKey||e.ctrlKey||Se(t))}),[Se,T,L,q]),Ce=t.useCallback((e=>{const t=te.current&&!te.current.contains(e.target),n=ne.current&&!ne.current.contains(e.target);le.current=!1,t&&n&&!ue.current&&fe(!1),ue.current=!1}),[]);function Pe(e){le.current=!1,null==V||V(e),fe((e=>!e&&(null==L||L(),!0)))}t.useEffect((()=>{y.default(oe.current===(void 0!==_),"Input elements should not switch from uncontrolled to controlled (or vice versa). Decide between using a controlled or uncontrolled input element for the lifetime of the component"),y.default(!oe.current||oe.current&&I,"onChange prop required when using a controlled input element"),oe.current&&Oe(_)}),[_,I]),t.useEffect((()=>{const e=je.find((e=>s.default(e,ve)));let t="";e&&(t=e.props.text),ye(t)}),[ve,je]),t.useEffect((()=>{const e="click";return window.addEventListener(e,Ce),function(){window.removeEventListener(e,Ce)}}),[Ce]),t.useEffect((()=>function(){window.clearTimeout(re.current),window.clearTimeout(he.current)}),[]);const qe=t.useCallback((()=>{fe(!1)}),[]),Ee=t.useCallback((e=>{e&&(se(e),b&&("function"==typeof b?b(e):b.current=e))}),[b]);let De;switch(J){case"top":De="top-end";break;case"bottom":De="bottom-end";break;default:De=J}const Re=e.jsx(u.default,{ref:ne,id:ee.current,labelId:we,anchorElement:(null==ce?void 0:ce.parentElement)||void 0,onSelect:e=>{const{text:t,value:n,selectionType:r,id:l,selectionConfirmed:o}=e,i="click"===r;!function(e,t,n){oe.current||(Oe(e),ye(t)),null==I||I(_e(e,n))}(n,t,o),be(l),"navigationKey"!==r&&fe(!1),i&&(ue.current=!0,null==ce||ce.focus())},onMouseDown:function(){le.current=!0},onSelectListClose:qe,highlightedValue:ve,listMaxHeight:K,isLoading:H,onListScrollBottom:F,tableHeader:A,multiColumn:W,listPlacement:void 0!==Z?De:J,flipEnabled:N,isOpen:de,enableVirtualScroll:Q,virtualScrollOverscan:X,listWidth:Z,children:E}),Le=r.default($);return e.jsxs(o.default,g(O({transparent:D,disabled:P,readOnly:q,"data-component":"simple-select","data-role":G,"data-element":z,isOpen:de},Le),{children:[e.jsx("div",{ref:te,children:e.jsx(i.default,O({ref:Ee,ariaLabel:h,"aria-controls":ee.current,activeDescendantId:pe,ariaLabelledby:j,"aria-describedby":v,isOpen:de},g(O({id:ge.current,name:C,disabled:P,readOnly:q,selectedValue:ve,formattedValue:me,onClick:Pe,iconOnClick:function(e){Pe(e)},label:k,labelId:we,onMouseDown:function(){le.current=!0},onFocus:function(e){ue.current||(null==M||M(e),le.current?le.current=!1:R&&(window.clearTimeout(he.current),he.current=window.setTimeout((()=>{fe((e=>(e||null==L||L(),!0)))}))))},onKeyDown:ke,onBlur:function(e){le.current||null==B||B(e)},tooltipPosition:U,required:Y,transparent:D},l.default($)),{"data-component":void 0})))}),Re]}))}));exports.SimpleSelect=h,exports.default=h;

package/lib/components/switch/switch.component.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("react"),n=require("../box/box.component.js"),a=require("../../__internal__/checkable-input/checkable-input.component.js"),t=require("../../__internal__/label/label.component.js"),i=require("../../__internal__/tooltip-provider/index.js"),l=require("../carbon-provider/__internal__/new-validation.context.js"),o=require("../../__internal__/utils/logger/index.js"),s=require("../../__internal__/validation-message/validation-message.component.js"),d=require("../../hooks/__internal__/useIsAboveBreakpoint/useIsAboveBreakpoint.js"),c=require("./switch.style.js"),u=require("./__internal__/switch-slider.component.js"),p=require("../../__internal__/utils/helpers/guid/index.js"),b=require("../../__internal__/hint-text/hint-text.component.js");require("../../style/utils/filter-styled-system-padding-props.js");var f=require("../../style/utils/filter-styled-system-margin-props.js");function g(e){return e&&e.__esModule?e:{default:e}}function h(e,r,n){return r in e?Object.defineProperty(e,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[r]=n,e}function v(e){for(var r=1;r<arguments.length;r++){var n=null!=arguments[r]?arguments[r]:{},a=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(a=a.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),a.forEach((function(r){h(e,r,n[r])}))}return e}function j(e,r){return r=null!=r?r:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);r.push.apply(r,n)}return r}(Object(r)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(r,n))})),e}let k=!1;const m=g(r).default.forwardRef(((g,h)=>{var{autoFocus:m,id:x,label:_,onChange:w,onBlur:y,onFocus:O,value:B,checked:P,defaultChecked:q,disabled:D,loading:I,reverse:S=!0,required:F,isOptional:H,validationOnLabel:L=!1,labelInline:C=!1,labelSpacing:R,labelHelp:T,labelWidth:z,fieldHelpInline:M,size:A="small",name:E,adaptiveLabelBreakpoint:$,tooltipPosition:W,error:U,warning:Y,info:N,"data-element":V,"data-role":G,helpAriaLabel:J,isDarkBackground:K=!1,validationMessagePositionTop:Q=!0}=g,X=function(e,r){if(null==e)return{};var n,a,t=function(e,r){if(null==e)return{};var n,a,t={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],r.indexOf(n)>=0||(t[n]=e[n]);return t}(e,r);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],r.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(t[n]=e[n])}return t}(g,["autoFocus","id","label","onChange","onBlur","onFocus","value","checked","defaultChecked","disabled","loading","reverse","required","isOptional","validationOnLabel","labelInline","labelSpacing","labelHelp","labelWidth","fieldHelpInline","size","name","adaptiveLabelBreakpoint","tooltipPosition","error","warning","info","data-element","data-role","helpAriaLabel","isDarkBackground","validationMessagePositionTop"]);const Z=void 0!==P,{validationRedesignOptIn:ee}=r.useContext(l.default),re=r.useRef(`${p.default()}-label`),ne=r.useRef(`${p.default()}-hint`),ae=r.useRef(`${p.default()}-message`),[te,ie]=r.useState(q||!1);k||w||(k=!0,o.default.deprecate("Uncontrolled behaviour in `Switch` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const le=r.useCallback((e=>{I?e.preventDefault():(ie(e.target.checked),null==w||w(e))}),[ie,w,I]),oe=d.default($);let se=C;$&&(se=oe);const de=!(!C||S)||L,ce=f.default(X),ue=v({"data-component":"switch","data-role":G,"data-element":V,checked:Z?P:te,isDarkBackground:K,fieldHelpInline:M,labelInline:se,labelSpacing:R,reverse:!S,size:A},ce),pe={checked:Z?P:te,disabled:D,loading:I,isDarkBackground:K,size:A,error:U,warning:Y,info:N,useValidationIcon:!ee&&!de&&!D},be=j(v({autoFocus:m,error:U,warning:Y,info:N,disabled:D,loading:I,checked:Z?P:te,label:_,labelHelp:T,labelWidth:z,fieldHelpInline:M,labelInline:se,labelSpacing:R,onBlur:y,isDarkBackground:K,onFocus:O,onChange:Z?w:le,id:x,name:E,value:B,type:"checkbox",role:"switch",reverse:!S,validationOnLabel:de&&!D,ref:h,required:F,isOptional:H},X),{"data-component":void 0}),fe=v({"data-component":"switch","data-role":G,"data-element":V,checked:Z?P:te,labelInline:se,isDarkBackground:K,size:A,reverse:!S,validationRedesignOptIn:ee},ce),ge={checked:Z?P:te,disabled:D,loading:I,isDarkBackground:K,size:A,error:U,warning:Y},he=v({autoFocus:m,error:!!U,warning:Y,disabled:D,loading:I,checked:Z?P:te,onBlur:y,isDarkBackground:K,onFocus:O,onChange:Z?w:le,id:x,name:E,value:B,type:"checkbox",role:"switch",ref:h,required:F,isOptional:H},X),ve=U||Y,je=[T&&ne.current,ve&&ae.current].filter(Boolean).join(" ");if(!ee)return e.jsx(e.Fragment,{children:e.jsx(i.TooltipProvider,{helpAriaLabel:J,tooltipPosition:W,children:e.jsx(c.default,j(v({},ue),{children:e.jsx(a.default,j(v({},be),{children:e.jsx(u.default,v({},pe))}))}))})});const ke=U||Y?C?3:0:C?1:0,me=C?"row":"column",xe=C?"row-reverse":"column",_e=!C||U||Y||N?"":"center";return e.jsxs(e.Fragment,{children:[e.jsx(c.default,j(v({},fe),{children:e.jsxs(n.Box,{"data-role":"field-reverse-wrapper",display:"flex",alignItems:U||Y?"flex-start":void 0,flexDirection:S?me:xe,width:C?"100%":"auto",children:[e.jsxs(n.Box,j(v({"data-role":"label-wrapper",alignSelf:_e},z&&{width:`${z}%`}),{children:[e.jsx(t.default,{isDarkBackground:K,labelId:re.current,disabled:D,isRequired:F,optional:H,children:_}),T&&e.jsx(n.Box,{"data-role":"hint-text-wrapper",mb:C?0:1,children:e.jsx(b.HintText,{"data-role":"hint-text",fontWeight:"400",id:ne.current,isDarkBackground:K,marginTop:"8px",children:T})})]})),e.jsxs(n.Box,{ml:S?ke:0,mr:S?0:ke,position:"relative",id:"input-wrapper","data-role":"input-wrapper",children:[Q&&e.jsxs(e.Fragment,{children:[e.jsx(s.default,{error:U,warning:Y,validationId:ae.current,isDarkBackground:K,validationMessagePositionTop:Q,"data-role":"validation-message-top"}),ve&&e.jsx(c.ErrorBorder,{"data-role":"error-border",warning:!(U||!Y),reverse:!S,isDarkBackground:K})]}),e.jsx(a.default,j(v({ariaLabelledBy:`${_&&re.current}`,ariaDescribedBy:je},he),{fieldHelp:C?void 0:X.fieldHelp,children:e.jsx(u.default,v({},ge))})),!Q&&e.jsxs(e.Fragment,{children:[e.jsx(s.default,{error:U,warning:Y,validationId:ae.current,isDarkBackground:K,validationMessagePositionTop:Q,"data-role":"validation-message-bottom"}),ve&&e.jsx(c.ErrorBorder,{"data-role":"error-border",warning:!(U||!Y),reverse:!S,isDarkBackground:K})]})]})]})})),C&&X.fieldHelp&&e.jsx(n.Box,{color:K?"var(--colorsUtilityYang100)":"var(--colorsUtilityYin090)",children:X.fieldHelp})]})}));m.displayName="Switch",exports.Switch=m,exports.default=m;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("react"),n=require("../box/box.component.js"),a=require("../../__internal__/checkable-input/checkable-input.component.js"),t=require("../../__internal__/label/label.component.js"),i=require("../../__internal__/tooltip-provider/index.js"),l=require("../carbon-provider/__internal__/new-validation.context.js"),o=require("../../__internal__/utils/logger/index.js"),s=require("../../__internal__/validation-message/validation-message.component.js"),d=require("../../hooks/__internal__/useIsAboveBreakpoint/useIsAboveBreakpoint.js"),c=require("./switch.style.js"),u=require("./__internal__/switch-slider.component.js"),p=require("../../__internal__/utils/helpers/guid/index.js"),b=require("../../__internal__/hint-text/hint-text.component.js");require("../../style/utils/filter-styled-system-padding-props.js");var f=require("../../style/utils/filter-styled-system-margin-props.js");function g(e){return e&&e.__esModule?e:{default:e}}function h(e,r,n){return r in e?Object.defineProperty(e,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[r]=n,e}function v(e){for(var r=1;r<arguments.length;r++){var n=null!=arguments[r]?arguments[r]:{},a=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(a=a.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),a.forEach((function(r){h(e,r,n[r])}))}return e}function j(e,r){return r=null!=r?r:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);r.push.apply(r,n)}return r}(Object(r)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(r,n))})),e}let k=!1;const m=g(r).default.forwardRef(((g,h)=>{var{autoFocus:m,id:x,label:_,onChange:w,onBlur:y,onFocus:O,value:B,checked:P,defaultChecked:q,disabled:D,loading:I,reverse:S=!0,required:F,validationOnLabel:H=!1,labelInline:L=!1,labelSpacing:C,labelHelp:R,labelWidth:T,fieldHelpInline:z,size:M="small",name:A,adaptiveLabelBreakpoint:E,tooltipPosition:$,error:W,warning:U,info:Y,"data-element":N,"data-role":V,helpAriaLabel:G,isDarkBackground:J=!1,validationMessagePositionTop:K=!0}=g,Q=function(e,r){if(null==e)return{};var n,a,t=function(e,r){if(null==e)return{};var n,a,t={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],r.indexOf(n)>=0||(t[n]=e[n]);return t}(e,r);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],r.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(t[n]=e[n])}return t}(g,["autoFocus","id","label","onChange","onBlur","onFocus","value","checked","defaultChecked","disabled","loading","reverse","required","validationOnLabel","labelInline","labelSpacing","labelHelp","labelWidth","fieldHelpInline","size","name","adaptiveLabelBreakpoint","tooltipPosition","error","warning","info","data-element","data-role","helpAriaLabel","isDarkBackground","validationMessagePositionTop"]);const X=void 0!==P,{validationRedesignOptIn:Z}=r.useContext(l.default),ee=r.useRef(`${p.default()}-label`),re=r.useRef(`${p.default()}-hint`),ne=r.useRef(`${p.default()}-message`),[ae,te]=r.useState(q||!1);k||w||(k=!0,o.default.deprecate("Uncontrolled behaviour in `Switch` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const ie=r.useCallback((e=>{I?e.preventDefault():(te(e.target.checked),null==w||w(e))}),[te,w,I]),le=d.default(E);let oe=L;E&&(oe=le);const se=!(!L||S)||H,de=f.default(Q),ce=v({"data-component":"switch","data-role":V,"data-element":N,checked:X?P:ae,isDarkBackground:J,fieldHelpInline:z,labelInline:oe,labelSpacing:C,reverse:!S,size:M},de),ue={checked:X?P:ae,disabled:D,loading:I,isDarkBackground:J,size:M,error:W,warning:U,info:Y,useValidationIcon:!Z&&!se&&!D},pe=j(v({autoFocus:m,error:W,warning:U,info:Y,disabled:D,loading:I,checked:X?P:ae,label:_,labelHelp:R,labelWidth:T,fieldHelpInline:z,labelInline:oe,labelSpacing:C,onBlur:y,isDarkBackground:J,onFocus:O,onChange:X?w:ie,id:x,name:A,value:B,type:"checkbox",role:"switch",reverse:!S,validationOnLabel:se&&!D,ref:h,required:F},Q),{"data-component":void 0}),be=v({"data-component":"switch","data-role":V,"data-element":N,checked:X?P:ae,labelInline:oe,isDarkBackground:J,size:M,reverse:!S,validationRedesignOptIn:Z},de),fe={checked:X?P:ae,disabled:D,loading:I,isDarkBackground:J,size:M,error:W,warning:U},ge=v({autoFocus:m,error:!!W,warning:U,disabled:D,loading:I,checked:X?P:ae,onBlur:y,isDarkBackground:J,onFocus:O,onChange:X?w:ie,id:x,name:A,value:B,type:"checkbox",role:"switch",ref:h,required:F},Q),he=W||U,ve=[R&&re.current,he&&ne.current].filter(Boolean).join(" ");if(!Z)return e.jsx(e.Fragment,{children:e.jsx(i.TooltipProvider,{helpAriaLabel:G,tooltipPosition:$,children:e.jsx(c.default,j(v({},ce),{children:e.jsx(a.default,j(v({},pe),{children:e.jsx(u.default,v({},ue))}))}))})});const je=W||U?L?3:0:L?1:0,ke=L?"row":"column",me=L?"row-reverse":"column",xe=!L||W||U||Y?"":"center";return e.jsxs(e.Fragment,{children:[e.jsx(c.default,j(v({},be),{children:e.jsxs(n.Box,{"data-role":"field-reverse-wrapper",display:"flex",alignItems:W||U?"flex-start":void 0,flexDirection:S?ke:me,width:L?"100%":"auto",children:[e.jsxs(n.Box,j(v({"data-role":"label-wrapper",alignSelf:xe},T&&{width:`${T}%`}),{children:[e.jsx(t.default,{isDarkBackground:J,labelId:ee.current,disabled:D,isRequired:F,children:_}),R&&e.jsx(n.Box,{"data-role":"hint-text-wrapper",mb:L?0:1,children:e.jsx(b.HintText,{"data-role":"hint-text",fontWeight:"400",id:re.current,isDarkBackground:J,marginTop:"8px",children:R})})]})),e.jsxs(n.Box,{ml:S?je:0,mr:S?0:je,position:"relative",id:"input-wrapper","data-role":"input-wrapper",children:[K&&e.jsxs(e.Fragment,{children:[e.jsx(s.default,{error:W,warning:U,validationId:ne.current,isDarkBackground:J,validationMessagePositionTop:K,"data-role":"validation-message-top"}),he&&e.jsx(c.ErrorBorder,{"data-role":"error-border",warning:!(W||!U),reverse:!S,isDarkBackground:J})]}),e.jsx(a.default,j(v({ariaLabelledBy:`${_&&ee.current}`,ariaDescribedBy:ve},ge),{fieldHelp:L?void 0:Q.fieldHelp,children:e.jsx(u.default,v({},fe))})),!K&&e.jsxs(e.Fragment,{children:[e.jsx(s.default,{error:W,warning:U,validationId:ne.current,isDarkBackground:J,validationMessagePositionTop:K,"data-role":"validation-message-bottom"}),he&&e.jsx(c.ErrorBorder,{"data-role":"error-border",warning:!(W||!U),reverse:!S,isDarkBackground:J})]})]})]})})),L&&Q.fieldHelp&&e.jsx(n.Box,{color:J?"var(--colorsUtilityYang100)":"var(--colorsUtilityYin090)",children:Q.fieldHelp})]})}));m.displayName="Switch",exports.Switch=m,exports.default=m;

package/lib/components/tabs/__internal__/tab-title/tab-title.component.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),r=require("./tab-title.style.js"),n=require("../../../../__internal__/utils/helpers/tags/tags.js"),i=require("../../../../__internal__/validations/validation-icon.component.js"),o=require("../../../icon/icon.component.js"),a=require("../../../../__internal__/utils/helpers/events/events.js"),l=require("../../../../__internal__/tooltip-provider/index.js"),s=require("./tab-title.context.js"),d=require("../../../typography/typography.component.js"),c=require("../../../carbon-provider/__internal__/new-validation.context.js");function u(e){return e&&e.__esModule?e:{default:e}}var p=u(t);function b(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function f(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},n=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(r).filter((function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})))),n.forEach((function(t){b(e,t,r[t])}))}return e}function y(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t.push.apply(t,r)}return t}(Object(t)).forEach((function(r){Object.defineProperty(e,r,Object.getOwnPropertyDescriptor(t,r))})),e}const g=p.default.forwardRef(((u,b)=>{var{isTabSelected:g,dataTabId:j,"data-role":O,title:h,position:v,error:m,warning:S,info:x,size:w="default",onClick:_,titlePosition:P="before",siblings:I,errorMessage:T="",warningMessage:L="",infoMessage:k="",borders:q,alternateStyling:R=!1,noLeftBorder:B=!1,noRightBorder:C=!1,customLayout:M,isInSidebar:D,href:E,onKeyDown:V,align:z,tabIndex:K,id:F}=u,W=function(e,t){if(null==e)return{};var r,n,i=function(e,t){if(null==e)return{};var r,n,i={},o=Object.keys(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}(u,["isTabSelected","dataTabId","data-role","title","position","error","warning","info","size","onClick","titlePosition","siblings","errorMessage","warningMessage","infoMessage","borders","alternateStyling","noLeftBorder","noRightBorder","customLayout","isInSidebar","href","onKeyDown","align","tabIndex","id"]);const $=!!E,A=R||D,H=m||S||x,[N,G]=t.useState(!1),J=t.useRef(!1),{validationRedesignOptIn:Q}=t.useContext(c.default);let U="";m?U=T:S&&(U=L);const X=()=>{G(!0)},Y=()=>{"object"!=typeof b||(null==b?void 0:b.current)===document.activeElement||J.current||G(!1)},Z=e=>{return e.preventDefault(),E?(_(e),window.open(E,"_blank")):("object"==typeof b&&(null==b||null===(t=b.current)||void 0===t||t.focus({preventScroll:!0})),_(e));var t},ee=e.jsxs(e.Fragment,{children:[e.jsxs(r.StyledTitleContent,{"data-role":"tab-title-content",error:m,warning:S,info:x,position:v,size:w,noLeftBorder:B,noRightBorder:C,borders:q,hasSiblings:!!I,isTabSelected:g,hasCustomLayout:!!M,alternateStyling:A,align:z,hasHref:!!E,validationRedesignOptIn:Q,children:[(()=>{if(M)return e.jsx(r.StyledLayoutWrapper,{hasCustomLayout:!0,children:M});if(!I)return h;const t=e.jsx(p.default.Fragment,{children:h},"title"),n=e.jsx(r.StyledLayoutWrapper,{titlePosition:P,children:p.default.Children.toArray(I).map((e=>p.default.isValidElement(e)?p.default.cloneElement(e,y(f({},e.props),{onClick:Z})):e))},"title-siblings");return"before"===P?[t,n]:[n,t]})(),$&&e.jsx(o.default,{type:"link"}),H&&e.jsxs(r.StyledLayoutWrapper,{position:v,hasCustomSibling:!!M,validationRedesignOptIn:Q,children:[m&&e.jsx(i.ValidationIcon,{tooltipPosition:"top",error:T}),!m&&S&&e.jsx(i.ValidationIcon,{tooltipPosition:"top",warning:L}),!S&&!m&&x&&e.jsx(i.ValidationIcon,{tooltipPosition:"top",info:k})]})]}),Q&&"left"===v&&e.jsx(r.StyledVerticalIndicator,{}),(!(H||A)||Q)&&g&&e.jsx(r.StyledSelectedIndicator,{warning:S,error:m,"data-element":"tab-selected-indicator","data-role":"tab-selected-indicator",position:v})]}),te=y(f(y(f({"aria-selected":g,"data-element":"select-tab","data-tabid":j,"data-role":O,role:"tab",position:v,isTabSelected:g,error:m,warning:S,info:x,noRightBorder:C,noLeftBorder:B,alternateStyling:R||D,borders:q,isInSidebar:D,tabIndex:K,id:F},W,n.default("tab-header",f({id:F},W))),{onKeyDown:e=>E&&a.default.isEnterOrSpaceKey(e)?window.open(E,"_blank"):V(e),onClick:Z,size:w,onMouseOver:()=>{J.current=!0,X()},onMouseLeave:()=>{J.current=!1,Y()},onFocus:X,onBlur:Y}),Q&&H&&{"aria-invalid":!0,"aria-errormessage":`${F}-message`,"aria-describedby":`${F}-message`}),{validationRedesignOptIn:Q}),re=$?e.jsx(r.StyledTabTitleLink,y(f({},te),{ref:b,href:E,target:"_blank",children:ee})):e.jsx(r.StyledTabTitleButton,y(f({},te),{type:"button",ref:b,children:ee}));return e.jsxs(l.TooltipProvider,{tooltipVisible:!Q&&N,children:[e.jsx(s.default.Provider,{value:{isInTab:!0},children:re}),Q&&H&&e.jsx(d.Typography,{screenReaderOnly:!0,id:`${F}-message`,children:U})]})}));g.displayName="TabTitle",exports.default=g;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),r=require("./tab-title.style.js"),n=require("../../../../__internal__/utils/helpers/tags/tags.js"),i=require("../../../../__internal__/validations/validation-icon.component.js"),o=require("../../../icon/icon.component.js"),a=require("../../../../__internal__/utils/helpers/events/events.js"),l=require("../../../../__internal__/tooltip-provider/index.js"),s=require("./tab-title.context.js"),d=require("../../../typography/typography.component.js"),c=require("../../../carbon-provider/__internal__/new-validation.context.js");function u(e){return e&&e.__esModule?e:{default:e}}var b=u(t);function p(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function f(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},n=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(r).filter((function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})))),n.forEach((function(t){p(e,t,r[t])}))}return e}function y(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t.push.apply(t,r)}return t}(Object(t)).forEach((function(r){Object.defineProperty(e,r,Object.getOwnPropertyDescriptor(t,r))})),e}const g=b.default.forwardRef(((u,p)=>{var{isTabSelected:g,dataTabId:j,"data-role":O,title:h,position:v,error:S,warning:m,info:x,size:w="default",onClick:_,titlePosition:P="before",siblings:I,errorMessage:T="",warningMessage:L="",infoMessage:k="",borders:q,alternateStyling:R=!1,noLeftBorder:B=!1,noRightBorder:M=!1,customLayout:C,isInSidebar:D,href:E,onKeyDown:V,align:z,tabIndex:K,id:F}=u,W=function(e,t){if(null==e)return{};var r,n,i=function(e,t){if(null==e)return{};var r,n,i={},o=Object.keys(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}(u,["isTabSelected","dataTabId","data-role","title","position","error","warning","info","size","onClick","titlePosition","siblings","errorMessage","warningMessage","infoMessage","borders","alternateStyling","noLeftBorder","noRightBorder","customLayout","isInSidebar","href","onKeyDown","align","tabIndex","id"]);const $=!!E,H=R||D,N=S||m||x,[A,G]=t.useState(!1),J=t.useRef(!1),{validationRedesignOptIn:Q}=t.useContext(c.default);let U="";S?U=T:m&&(U=L);const X=()=>{G(!0)},Y=()=>{"object"!=typeof p||(null==p?void 0:p.current)===document.activeElement||J.current||G(!1)},Z=e.jsxs(e.Fragment,{children:[e.jsxs(r.StyledTitleContent,{"data-role":"tab-title-content",error:S,warning:m,info:x,position:v,size:w,noLeftBorder:B,noRightBorder:M,borders:q,hasSiblings:!!I,isTabSelected:g,hasCustomLayout:!!C,alternateStyling:H,align:z,hasHref:!!E,validationRedesignOptIn:Q,children:[(()=>{if(C)return e.jsx(r.StyledLayoutWrapper,{hasCustomLayout:!0,children:C});if(!I)return h;const t=e.jsx(b.default.Fragment,{children:h},"title"),n=e.jsx(r.StyledLayoutWrapper,{titlePosition:P,children:I},"title-siblings");return"before"===P?[t,n]:[n,t]})(),$&&e.jsx(o.default,{type:"link"}),N&&e.jsxs(r.StyledLayoutWrapper,{position:v,hasCustomSibling:!!C,validationRedesignOptIn:Q,children:[S&&e.jsx(i.ValidationIcon,{tooltipPosition:"top",error:T}),!S&&m&&e.jsx(i.ValidationIcon,{tooltipPosition:"top",warning:L}),!m&&!S&&x&&e.jsx(i.ValidationIcon,{tooltipPosition:"top",info:k})]})]}),Q&&"left"===v&&e.jsx(r.StyledVerticalIndicator,{}),(!(N||H)||Q)&&g&&e.jsx(r.StyledSelectedIndicator,{warning:m,error:S,"data-element":"tab-selected-indicator","data-role":"tab-selected-indicator",position:v})]}),ee=y(f(y(f({"aria-selected":g,"data-element":"select-tab","data-tabid":j,"data-role":O,role:"tab",position:v,isTabSelected:g,error:S,warning:m,info:x,noRightBorder:M,noLeftBorder:B,alternateStyling:R||D,borders:q,isInSidebar:D,tabIndex:K,id:F},W,n.default("tab-header",f({id:F},W))),{onKeyDown:e=>E&&a.default.isEnterOrSpaceKey(e)?window.open(E,"_blank"):V(e),onClick:e=>{return e.preventDefault(),E?(_(e),window.open(E,"_blank")):("object"==typeof p&&(null==p||null===(t=p.current)||void 0===t||t.focus({preventScroll:!0})),_(e));var t},size:w,onMouseOver:()=>{J.current=!0,X()},onMouseLeave:()=>{J.current=!1,Y()},onFocus:X,onBlur:Y}),Q&&N&&{"aria-invalid":!0,"aria-errormessage":`${F}-message`,"aria-describedby":`${F}-message`}),{validationRedesignOptIn:Q}),te=$?e.jsx(r.StyledTabTitleLink,y(f({},ee),{ref:p,href:E,target:"_blank",children:Z})):e.jsx(r.StyledTabTitleButton,y(f({},ee),{type:"button",ref:p,children:Z}));return e.jsxs(l.TooltipProvider,{tooltipVisible:!Q&&A,children:[e.jsx(s.default.Provider,{value:{isInTab:!0},children:te}),Q&&N&&e.jsx(d.Typography,{screenReaderOnly:!0,id:`${F}-message`,children:U})]})}));g.displayName="TabTitle",exports.default=g;

package/lib/components/text-editor/text-editor.component.d.ts

@@ -18,11 +18,6 @@ export interface TextEditorProps extends MarginProps, TagProps {
     header?: React.ReactNode;
     /** A hint string rendered before the editor but after the label. Intended to describe the purpose or content of the input. */
     inputHint?: string;
-    /**
-     * [Legacy] Whether the content of the editor can be empty
-     * @deprecated If the value of this component is not required, use the `required` prop and set it to false instead.
-     */
-    isOptional?: boolean;
     /** The label to display above the editor */
     labelText: string;
     /** The identifier for the Text Editor. This allows for the using of multiple Text Editors on a screen */

package/lib/components/text-editor/text-editor.component.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("@lexical/react/LexicalComposer"),t=require("@lexical/react/LexicalClickableLinkPlugin"),n=require("@lexical/react/LexicalErrorBoundary"),i=require("@lexical/react/LexicalHistoryPlugin"),a=require("@lexical/react/LexicalMarkdownShortcutPlugin"),l=require("@lexical/react/LexicalRichTextPlugin"),o=require("@lexical/react/LexicalLinkPlugin"),s=require("@lexical/react/LexicalListPlugin"),u=require("@lexical/react/LexicalOnChangePlugin"),d=require("lexical"),c=require("react"),p=require("./__internal__/helpers.js"),g=require("../../__internal__/label/label.component.js"),x=require("../../hooks/__internal__/useLocale/useLocale.js"),j=require("../../__internal__/utils/logger/index.js"),f=require("./__internal__/constants.js"),_=require("./__internal__/plugins/AutoLinker/auto-link.component.js"),v=require("./__internal__/plugins/CharacterCounter/character-counter.component.js"),m=require("./__internal__/plugins/ContentEditor/content-editor.component.js"),h=require("./__internal__/plugins/LinkMonitor/link-monitor.plugin.js");require("./__internal__/plugins/LinkPreviewer/link-previewer.style.js");var b=require("./__internal__/plugins/Placeholder/placeholder.component.js"),y=require("./__internal__/plugins/Toolbar/toolbar.component.js");require("./__internal__/plugins/useCursorAtEnd/index.js");var O=require("./text-editor.context.js"),P=require("./text-editor.style.js"),q=require("./utils.js"),w=require("../../__internal__/hint-text/hint-text.component.js"),L=require("../../__internal__/validation-message/validation-message.component.js"),E=require("../textbox/textbox.style.js");require("../../style/utils/filter-styled-system-padding-props.js");var C=require("../../style/utils/filter-styled-system-margin-props.js"),T=require("../../__internal__/utils/helpers/tags/tags.js");function k(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function S(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},n=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),n.forEach((function(r){k(e,r,t[r])}))}return e}let M=!1,$=!1;const H=c.forwardRef(((k,H)=>{var B,R,{characterLimit:F=3e3,error:I,footer:A,header:W,inputHint:D,isOptional:N=!1,labelText:U,namespace:V=f.COMPONENT_PREFIX,onBlur:z,onCancel:X,onChange:G,onFocus:J,onLinkAdded:K,onSave:Q,placeholder:Y,previews:Z=[],readOnly:ee=!1,required:re=!1,rows:te,warning:ne,customPlugins:ie,validationMessagePositionTop:ae=!0}=k,le=function(e,r){if(null==e)return{};var t,n,i=function(e,r){if(null==e)return{};var t,n,i={},a=Object.keys(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||(i[t]=e[t]);return i}(e,r);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}(k,["characterLimit","error","footer","header","inputHint","isOptional","labelText","namespace","onBlur","onCancel","onChange","onFocus","onLinkAdded","onSave","placeholder","previews","readOnly","required","rows","warning","customPlugins","validationMessagePositionTop"]);!$&&N&&($=!0,j.default.deprecate("`isOptional` is deprecated in TextEditor and support will soon be removed. If the value of this component is not required, use the `required` prop and set it to false instead.")),!M&&le.value&&(M=!0,j.default.deprecate("`value` is deprecated in TextEditor and support will soon be removed. Please use `initialValue` instead."));const oe=c.useRef(null!==(R=null!==(B=le.initialValue)&&void 0!==B?B:le.value)&&void 0!==R?R:q.createEmpty()),se=x.default(),[ue,de]=c.useState(void 0),ce=c.useRef(null),[pe,ge]=c.useState(!1);c.useImperativeHandle(H,(()=>({focus(){var e;null===(e=ce.current)||void 0===e||e.focus()}})),[]),c.useEffect((()=>{const e=null==ce?void 0:ce.current,r=()=>{ge(!0)},t=()=>{ge(!1)};return null==e||e.addEventListener("focus",r),null==e||e.addEventListener("blur",t),()=>{null==e||e.removeEventListener("focus",r),null==e||e.removeEventListener("blur",t)}}),[ce]);const xe=c.useMemo((()=>({namespace:V,nodes:f.markdownNodes,onError:e=>j.default.error(e.message),theme:f.theme,editorState:oe.current,editable:!ee})),[V,ee]),je=c.useCallback(((e,r)=>{const t=e.read((()=>d.$getRoot().getChildren().map((e=>e.getTextContent())).join("\n\n")));if(G){const e=p.SerializeLexical(r);null==G||G(t,e)}if(F>0){const e=F-t.length;de(e<0?se.textEditor.characterLimit(Math.abs(e)):void 0)}}),[F,se.textEditor,G]),fe=c.useCallback((e=>{if(!e.isEditable())return;if(!X)return;const r=e.parseEditorState(oe.current);e.setEditorState(r),X()}),[X]),_e=c.useMemo((()=>({namespace:V,onCancel:X?fe:void 0,onSave:Q})),[fe,V,X,Q]),ve=ne||ue;return e.jsx(P.StyledTextEditorWrapper,(me=S({"data-role":`${V}-editor-wrapper`,onBlur:e=>{e.currentTarget.contains(e.relatedTarget)||null==z||z(e)},onFocus:e=>{e.currentTarget.contains(e.relatedTarget)||null==J||J(e)}},C.default(le),T.default("text-editor",le)),he=null!=(he={children:e.jsxs(O.default.Provider,{value:{onLinkAdded:K},children:[e.jsx(g.default,{isRequired:re,optional:N,labelId:`${V}-label`,children:U}),D&&e.jsx(w.HintText,{id:`${V}-input-hint`,marginBottom:"var(--spacing100)",children:D}),e.jsx(r.LexicalComposer,{initialConfig:xe,children:e.jsxs(P.StyledWrapper,{"data-role":`${V}-wrapper`,children:[ae&&e.jsxs(e.Fragment,{children:[e.jsx(L.default,{error:I,warning:ve,validationId:`${V}-validation-message`,"data-role":`${V}-validation-message`,validationMessagePositionTop:ae}),(I||ve)&&e.jsx(E.default,{warning:!(I||!ve)})]}),e.jsxs(P.StyledEditorToolbarWrapper,{"data-role":`${V}-editor-toolbar-wrapper`,id:`${V}-editor-toolbar-wrapper`,focused:pe,error:!!I,children:[W&&e.jsx(P.StyledHeaderWrapper,{"data-role":`${V}-header-wrapper`,children:W}),!ee&&e.jsx(y.default,S({hasHeader:Boolean(W)},_e)),e.jsxs(P.StyledTextEditor,{"data-role":`${V}-editor`,children:[e.jsx(l.RichTextPlugin,{contentEditable:e.jsx(m.default,{ref:ce,inputHint:D,namespace:V,previews:Z,rows:te,readOnly:ee,required:re,error:!!I,warning:!!ne||!!ue,validationMessagePositionTop:ae}),placeholder:e.jsx(b.default,{namespace:V,text:Y}),ErrorBoundary:n.LexicalErrorBoundary}),e.jsx(s.ListPlugin,{}),e.jsx(i.HistoryPlugin,{}),e.jsx(a.MarkdownShortcutPlugin,{}),e.jsx(u.OnChangePlugin,{onChange:je,ignoreHistoryMergeTagChange:!0,ignoreSelectionChange:!0}),e.jsx(o.LinkPlugin,{validateUrl:p.validateUrl}),e.jsx(t.ClickableLinkPlugin,{newTab:!0}),e.jsx(_.default,{}),ie]}),A&&e.jsx(P.StyledFooterWrapper,{"data-role":`${V}-footer-wrapper`,children:A}),e.jsx(h.default,{})]}),!ae&&e.jsxs(e.Fragment,{children:[e.jsx(L.default,{error:I,warning:ve,validationId:`${V}-validation-message`,"data-role":`${V}-validation-message`,validationMessagePositionTop:ae}),(I||ve)&&e.jsx(E.default,{warning:!(I||!ve)})]}),F>0&&!ee&&e.jsx(v.default,{maxChars:F,namespace:V})]})})]})})?he:{},Object.getOwnPropertyDescriptors?Object.defineProperties(me,Object.getOwnPropertyDescriptors(he)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r.push.apply(r,t)}return r}(Object(he)).forEach((function(e){Object.defineProperty(me,e,Object.getOwnPropertyDescriptor(he,e))})),me));var me,he}));exports.TextEditor=H,exports.default=H;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("@lexical/react/LexicalComposer"),t=require("@lexical/react/LexicalClickableLinkPlugin"),n=require("@lexical/react/LexicalErrorBoundary"),i=require("@lexical/react/LexicalHistoryPlugin"),a=require("@lexical/react/LexicalMarkdownShortcutPlugin"),l=require("@lexical/react/LexicalRichTextPlugin"),o=require("@lexical/react/LexicalLinkPlugin"),s=require("@lexical/react/LexicalListPlugin"),u=require("@lexical/react/LexicalOnChangePlugin"),c=require("lexical"),d=require("react"),p=require("./__internal__/helpers.js"),g=require("../../__internal__/label/label.component.js"),x=require("../../hooks/__internal__/useLocale/useLocale.js"),j=require("../../__internal__/utils/logger/index.js"),f=require("./__internal__/constants.js"),_=require("./__internal__/plugins/AutoLinker/auto-link.component.js"),v=require("./__internal__/plugins/CharacterCounter/character-counter.component.js"),m=require("./__internal__/plugins/ContentEditor/content-editor.component.js"),b=require("./__internal__/plugins/LinkMonitor/link-monitor.plugin.js");require("./__internal__/plugins/LinkPreviewer/link-previewer.style.js");var h=require("./__internal__/plugins/Placeholder/placeholder.component.js"),y=require("./__internal__/plugins/Toolbar/toolbar.component.js");require("./__internal__/plugins/useCursorAtEnd/index.js");var P=require("./text-editor.context.js"),q=require("./text-editor.style.js"),w=require("./utils.js"),O=require("../../__internal__/hint-text/hint-text.component.js"),L=require("../../__internal__/validation-message/validation-message.component.js"),E=require("../textbox/textbox.style.js");require("../../style/utils/filter-styled-system-padding-props.js");var C=require("../../style/utils/filter-styled-system-margin-props.js"),k=require("../../__internal__/utils/helpers/tags/tags.js");function S(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function T(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},n=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),n.forEach((function(r){S(e,r,t[r])}))}return e}let M=!1;const $=d.forwardRef(((S,$)=>{var H,B,{characterLimit:R=3e3,error:F,footer:I,header:A,inputHint:W,labelText:D,namespace:N=f.COMPONENT_PREFIX,onBlur:U,onCancel:V,onChange:z,onFocus:X,onLinkAdded:G,onSave:J,placeholder:K,previews:Q=[],readOnly:Y=!1,required:Z=!1,rows:ee,warning:re,customPlugins:te,validationMessagePositionTop:ne=!0}=S,ie=function(e,r){if(null==e)return{};var t,n,i=function(e,r){if(null==e)return{};var t,n,i={},a=Object.keys(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||(i[t]=e[t]);return i}(e,r);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}(S,["characterLimit","error","footer","header","inputHint","labelText","namespace","onBlur","onCancel","onChange","onFocus","onLinkAdded","onSave","placeholder","previews","readOnly","required","rows","warning","customPlugins","validationMessagePositionTop"]);!M&&ie.value&&(M=!0,j.default.deprecate("`value` is deprecated in TextEditor and support will soon be removed. Please use `initialValue` instead."));const ae=d.useRef(null!==(B=null!==(H=ie.initialValue)&&void 0!==H?H:ie.value)&&void 0!==B?B:w.createEmpty()),le=x.default(),[oe,se]=d.useState(void 0),ue=d.useRef(null),[ce,de]=d.useState(!1);d.useImperativeHandle($,(()=>({focus(){var e;null===(e=ue.current)||void 0===e||e.focus()}})),[]),d.useEffect((()=>{const e=null==ue?void 0:ue.current,r=()=>{de(!0)},t=()=>{de(!1)};return null==e||e.addEventListener("focus",r),null==e||e.addEventListener("blur",t),()=>{null==e||e.removeEventListener("focus",r),null==e||e.removeEventListener("blur",t)}}),[ue]);const pe=d.useMemo((()=>({namespace:N,nodes:f.markdownNodes,onError:e=>j.default.error(e.message),theme:f.theme,editorState:ae.current,editable:!Y})),[N,Y]),ge=d.useCallback(((e,r)=>{const t=e.read((()=>c.$getRoot().getChildren().map((e=>e.getTextContent())).join("\n\n")));if(z){const e=p.SerializeLexical(r);null==z||z(t,e)}if(R>0){const e=R-t.length;se(e<0?le.textEditor.characterLimit(Math.abs(e)):void 0)}}),[R,le.textEditor,z]),xe=d.useCallback((e=>{if(!e.isEditable())return;if(!V)return;const r=e.parseEditorState(ae.current);e.setEditorState(r),V()}),[V]),je=d.useMemo((()=>({namespace:N,onCancel:V?xe:void 0,onSave:J})),[xe,N,V,J]),fe=re||oe;return e.jsx(q.StyledTextEditorWrapper,(_e=T({"data-role":`${N}-editor-wrapper`,onBlur:e=>{e.currentTarget.contains(e.relatedTarget)||null==U||U(e)},onFocus:e=>{e.currentTarget.contains(e.relatedTarget)||null==X||X(e)}},C.default(ie),k.default("text-editor",ie)),ve=null!=(ve={children:e.jsxs(P.default.Provider,{value:{onLinkAdded:G},children:[e.jsx(g.default,{isRequired:Z,labelId:`${N}-label`,children:D}),W&&e.jsx(O.HintText,{id:`${N}-input-hint`,marginBottom:"var(--spacing100)",children:W}),e.jsx(r.LexicalComposer,{initialConfig:pe,children:e.jsxs(q.StyledWrapper,{"data-role":`${N}-wrapper`,children:[ne&&e.jsxs(e.Fragment,{children:[e.jsx(L.default,{error:F,warning:fe,validationId:`${N}-validation-message`,"data-role":`${N}-validation-message`,validationMessagePositionTop:ne}),(F||fe)&&e.jsx(E.default,{warning:!(F||!fe)})]}),e.jsxs(q.StyledEditorToolbarWrapper,{"data-role":`${N}-editor-toolbar-wrapper`,id:`${N}-editor-toolbar-wrapper`,focused:ce,error:!!F,children:[A&&e.jsx(q.StyledHeaderWrapper,{"data-role":`${N}-header-wrapper`,children:A}),!Y&&e.jsx(y.default,T({hasHeader:Boolean(A)},je)),e.jsxs(q.StyledTextEditor,{"data-role":`${N}-editor`,children:[e.jsx(l.RichTextPlugin,{contentEditable:e.jsx(m.default,{ref:ue,inputHint:W,namespace:N,previews:Q,rows:ee,readOnly:Y,required:Z,error:!!F,warning:!!re||!!oe,validationMessagePositionTop:ne}),placeholder:e.jsx(h.default,{namespace:N,text:K}),ErrorBoundary:n.LexicalErrorBoundary}),e.jsx(s.ListPlugin,{}),e.jsx(i.HistoryPlugin,{}),e.jsx(a.MarkdownShortcutPlugin,{}),e.jsx(u.OnChangePlugin,{onChange:ge,ignoreHistoryMergeTagChange:!0,ignoreSelectionChange:!0}),e.jsx(o.LinkPlugin,{validateUrl:p.validateUrl}),e.jsx(t.ClickableLinkPlugin,{newTab:!0}),e.jsx(_.default,{}),te]}),I&&e.jsx(q.StyledFooterWrapper,{"data-role":`${N}-footer-wrapper`,children:I}),e.jsx(b.default,{})]}),!ne&&e.jsxs(e.Fragment,{children:[e.jsx(L.default,{error:F,warning:fe,validationId:`${N}-validation-message`,"data-role":`${N}-validation-message`,validationMessagePositionTop:ne}),(F||fe)&&e.jsx(E.default,{warning:!(F||!fe)})]}),R>0&&!Y&&e.jsx(v.default,{maxChars:R,namespace:N})]})})]})})?ve:{},Object.getOwnPropertyDescriptors?Object.defineProperties(_e,Object.getOwnPropertyDescriptors(ve)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r.push.apply(r,t)}return r}(Object(ve)).forEach((function(e){Object.defineProperty(_e,e,Object.getOwnPropertyDescriptor(ve,e))})),_e));var _e,ve}));exports.TextEditor=$,exports.default=$;

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

@@ -77,11 +77,6 @@ export interface TextareaProps extends ValidationProps, MarginProps, Omit<Common
     placeholder?: string;
     /** Adds readOnly property */
     readOnly?: boolean;
-    /**
-     * [Legacy] Flag to configure component as optional.
-     * @deprecated If the value of this component is not required, use the `required` prop and set it to false instead.
-     */
-    isOptional?: boolean;
     /** The number of visible text lines for the control. When set, this determines the height of the textarea, and the minHeight property is ignored. */
     rows?: number;
     /** [Legacy] Overrides the default tooltip position */

package/lib/components/textarea/textarea.component.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("react"),i=require("../../__internal__/utils/helpers/tags/tags.js"),t=require("../../__internal__/input/input.component.js"),n=require("../../__internal__/input/input-presentation.component.js"),a=require("../../__internal__/form-field/form-field.component.js"),l=require("../../hooks/useCharacterCount/useCharacterCount.js"),o=require("../../__internal__/input-behaviour/input-behaviour.component.js"),d=require("../../__internal__/input-icon-toggle/input-icon-toggle.component.js"),s=require("../../__internal__/utils/helpers/guid/index.js"),u=require("./textarea.style.js"),p=require("../../__internal__/tooltip-provider/index.js"),c=require("../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js"),b=require("../carbon-provider/__internal__/new-validation.context.js"),f=require("../textbox/textbox.style.js"),v=require("../../__internal__/validation-message/validation-message.component.js"),h=require("../box/box.component.js"),g=require("../../__internal__/utils/logger/index.js"),_=require("../../__internal__/hint-text/hint-text.component.js");require("../../style/utils/filter-styled-system-padding-props.js");var y=require("../../style/utils/filter-styled-system-margin-props.js");function m(e){return e&&e.__esModule?e:{default:e}}function j(e,r,i){return r in e?Object.defineProperty(e,r,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[r]=i,e}function x(e){for(var r=1;r<arguments.length;r++){var i=null!=arguments[r]?arguments[r]:{},t=Object.keys(i);"function"==typeof Object.getOwnPropertySymbols&&(t=t.concat(Object.getOwnPropertySymbols(i).filter((function(e){return Object.getOwnPropertyDescriptor(i,e).enumerable})))),t.forEach((function(r){j(e,r,i[r])}))}return e}let O=!1,I=!1,w=!1,H=!1;const q=m(r).default.forwardRef(((m,j)=>{var{"aria-labelledby":q,"aria-describedby":T,ariaDescribedBy:P,autoFocus:E,inputHint:L,fieldHelp:B,label:A,children:R,characterLimit:D,onChange:F,onFocus:k,onBlur:M,disabled:S=!1,labelInline:C,labelAlign:W,labelHelp:N,labelSpacing:U,inputIcon:G,id:z,error:V,warning:$,info:J,name:K,readOnly:Q=!1,placeholder:X,expandable:Y=!1,rows:Z,validationOnLabel:ee=!1,adaptiveLabelBreakpoint:re,inputWidth:ie,maxWidth:te,labelWidth:ne=30,tooltipPosition:ae,value:le,"data-element":oe,"data-role":de,helpAriaLabel:se,borderRadius:ue,hideBorders:pe=!1,required:ce,isOptional:be,minHeight:fe=u.DEFAULT_MIN_HEIGHT,validationMessagePositionTop:ve=!0}=m,he=function(e,r){if(null==e)return{};var i,t,n=function(e,r){if(null==e)return{};var i,t,n={},a=Object.keys(e);for(t=0;t<a.length;t++)i=a[t],r.indexOf(i)>=0||(n[i]=e[i]);return n}(e,r);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(t=0;t<a.length;t++)i=a[t],r.indexOf(i)>=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}(m,["aria-labelledby","aria-describedby","ariaDescribedBy","autoFocus","inputHint","fieldHelp","label","children","characterLimit","onChange","onFocus","onBlur","disabled","labelInline","labelAlign","labelHelp","labelSpacing","inputIcon","id","error","warning","info","name","readOnly","placeholder","expandable","rows","validationOnLabel","adaptiveLabelBreakpoint","inputWidth","maxWidth","labelWidth","tooltipPosition","value","data-element","data-role","helpAriaLabel","borderRadius","hideBorders","required","isOptional","minHeight","validationMessagePositionTop"]);!I&&be&&(I=!0,g.default.deprecate("`isOptional` is deprecated in TextArea and support will soon be removed. If the value of this component is not required, use the `required` prop and set it to false instead."));const{validationRedesignOptIn:ge}=r.useContext(b.default),_e=!ge&&C,[ye,me]=r.useState(u.DEFAULT_MIN_HEIGHT),je=e=>ge?void 0:e,{current:xe}=r.useRef(z||s.default()),Oe=r.useRef(null),Ie=r.useCallback((e=>{Oe.current=e,j&&("current"in j?j.current=e:j(e))}),[j]),[we,He]=r.useState("off");w||F||(w=!0,g.default.deprecate("Uncontrolled behaviour in `Textarea` is deprecated and support will soon be removed. Please make sure all your inputs are controlled.")),!O&&P&&(O=!0,g.default.deprecate("The `ariaDescribedBy` prop in `Textarea` is deprecated and will soon be removed, please use `aria-describedby` instead.")),Array.isArray(ue)&&ue.length>4&&!H&&(g.default.warn("The `borderRadius` prop in `Textarea` component only supports up to 4 values."),H=!0);const qe=r.useCallback((()=>{const e=Oe.current;if((null==e?void 0:e.scrollHeight)&&(null==e?void 0:e.scrollHeight)>ye){let r=e;for(;r&&!(null==r?void 0:r.scrollTop);)r=(null==r?void 0:r.parentElement)||null;const i=null==r?void 0:r.scrollTop;e.style.height="auto",e.style.height=`${Math.max(e.scrollHeight,ye)}px`,r&&i&&(r.scrollTop=i)}}),[ye]),{labelId:Te,validationId:Pe,fieldHelpId:Ee,ariaDescribedBy:Le}=c.default({id:xe,validationRedesignOptIn:ge,error:V,warning:$,info:J,label:A,fieldHelp:B}),[Be,Ae]=l.default(le,D,we);r.useEffect((()=>{var e;me(Z?(null==Oe||null===(e=Oe.current)||void 0===e?void 0:e.scrollHeight)||0:fe>u.DEFAULT_MIN_HEIGHT?fe:u.DEFAULT_MIN_HEIGHT)}),[fe,Z]),r.useEffect((()=>{Y&&qe()})),r.useEffect((()=>{var e,r;return Y&&(window.addEventListener("resize",qe),me((null==Oe||null===(e=Oe.current)||void 0===e?void 0:e.clientHeight)||0),null===(r=document.fonts)||void 0===r||r.addEventListener("loadingdone",qe)),()=>{var e;Y&&(window.removeEventListener("resize",qe),null===(e=document.fonts)||void 0===e||e.removeEventListener("loadingdone",qe))}}),[qe,Y]);const Re=!!(G||Pe&&!ee),De=r.useRef(s.default()),Fe=L?De.current:void 0,ke=[...ge&&ve?[Le,Fe]:[Fe,Le],Ae,T||P].filter(Boolean).join(" "),Me=e.jsxs(n.default,{disabled:S,readOnly:Q,inputWidth:"number"==typeof ie?ie:100-ne,maxWidth:te,error:V,warning:$,info:J,borderRadius:ue,hideBorders:pe,children:[e.jsx(t.default,x({"aria-invalid":!!V,"aria-labelledby":q,"aria-describedby":ke,autoFocus:E,name:K,value:le,ref:Ie,onChange:F,onFocus:e=>{D&&He("polite"),null==k||k(e)},onBlur:e=>{D&&He("off"),null==M||M(e)},disabled:S,readOnly:Q,placeholder:S?"":X,rows:Z,id:xe,as:"textarea",validationIconId:ge?void 0:Pe,inputBorderRadius:ue,required:ce},he)),R,e.jsx(d.default,{disabled:S,readOnly:Q,inputIcon:G,error:V,warning:$,info:J,validationIconId:ge?void 0:Pe,useValidationIcon:!(ge||ee)})]}),Se=y.default(he);return e.jsx(p.TooltipProvider,{tooltipPosition:ae,helpAriaLabel:se,children:e.jsx(o.InputBehaviour,{children:e.jsxs(u.default,(Ce=x({labelInline:_e,hasIcon:Re,minHeight:ye},Se,i.default("textarea",{"data-element":oe,"data-role":de})),We={children:[e.jsxs(a.default,{fieldHelp:je(B),fieldHelpId:Ee,error:V,warning:$,info:J,label:A,labelId:Te,disabled:S,id:xe,labelInline:je(_e),labelAlign:W,labelWidth:je(ne),labelHelp:je(N),labelSpacing:U,isRequired:ce,isOptional:be,useValidationIcon:je(ee),adaptiveLabelBreakpoint:re,validationRedesignOptIn:ge,my:0,children:[(L||N&&ge)&&e.jsx(_.HintText,{align:W,id:Fe,"data-element":"input-hint",children:L||N}),ge?e.jsxs(h.Box,{position:"relative",children:[ve&&e.jsxs(e.Fragment,{children:[e.jsx(v.default,{error:V,validationId:Pe,warning:$,validationMessagePositionTop:ve}),(V||$)&&e.jsx(f.default,{warning:!(V||!$)})]}),Me,!ve&&e.jsxs(e.Fragment,{children:[e.jsx(v.default,{error:V,validationId:Pe,warning:$,validationMessagePositionTop:ve}),(V||$)&&e.jsx(f.default,{warning:!(V||!$)})]})]}):Me]}),Be]},We=null!=We?We:{},Object.getOwnPropertyDescriptors?Object.defineProperties(Ce,Object.getOwnPropertyDescriptors(We)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);r.push.apply(r,i)}return r}(Object(We)).forEach((function(e){Object.defineProperty(Ce,e,Object.getOwnPropertyDescriptor(We,e))})),Ce))})});var Ce,We}));q.displayName="Textarea",exports.OriginalTextarea=q,exports.Textarea=q,exports.default=q;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("react"),t=require("../../__internal__/utils/helpers/tags/tags.js"),n=require("../../__internal__/input/input.component.js"),i=require("../../__internal__/input/input-presentation.component.js"),l=require("../../__internal__/form-field/form-field.component.js"),a=require("../../hooks/useCharacterCount/useCharacterCount.js"),o=require("../../__internal__/input-behaviour/input-behaviour.component.js"),d=require("../../__internal__/input-icon-toggle/input-icon-toggle.component.js"),s=require("../../__internal__/utils/helpers/guid/index.js"),u=require("./textarea.style.js"),c=require("../../__internal__/tooltip-provider/index.js"),p=require("../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js"),b=require("../carbon-provider/__internal__/new-validation.context.js"),f=require("../textbox/textbox.style.js"),v=require("../../__internal__/validation-message/validation-message.component.js"),g=require("../box/box.component.js"),h=require("../../__internal__/utils/logger/index.js"),_=require("../../__internal__/hint-text/hint-text.component.js");require("../../style/utils/filter-styled-system-padding-props.js");var y=require("../../style/utils/filter-styled-system-margin-props.js");function j(e){return e&&e.__esModule?e:{default:e}}function m(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function x(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},n=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),n.forEach((function(r){m(e,r,t[r])}))}return e}let O=!1,I=!1;const w=j(r).default.forwardRef(((j,m)=>{var{"aria-labelledby":w,"aria-describedby":H,autoFocus:q,inputHint:P,fieldHelp:T,label:E,children:L,characterLimit:A,onChange:B,onFocus:R,onBlur:F,disabled:k=!1,labelInline:M,labelAlign:S,labelHelp:C,labelSpacing:D,inputIcon:W,id:N,error:U,warning:G,info:z,name:V,readOnly:$=!1,placeholder:J,expandable:K=!1,rows:Q,validationOnLabel:X=!1,adaptiveLabelBreakpoint:Y,inputWidth:Z,maxWidth:ee,labelWidth:re=30,tooltipPosition:te,value:ne,"data-element":ie,"data-role":le,helpAriaLabel:ae,borderRadius:oe,hideBorders:de=!1,required:se,minHeight:ue=u.DEFAULT_MIN_HEIGHT,validationMessagePositionTop:ce=!0}=j,pe=function(e,r){if(null==e)return{};var t,n,i=function(e,r){if(null==e)return{};var t,n,i={},l=Object.keys(e);for(n=0;n<l.length;n++)t=l[n],r.indexOf(t)>=0||(i[t]=e[t]);return i}(e,r);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(n=0;n<l.length;n++)t=l[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}(j,["aria-labelledby","aria-describedby","autoFocus","inputHint","fieldHelp","label","children","characterLimit","onChange","onFocus","onBlur","disabled","labelInline","labelAlign","labelHelp","labelSpacing","inputIcon","id","error","warning","info","name","readOnly","placeholder","expandable","rows","validationOnLabel","adaptiveLabelBreakpoint","inputWidth","maxWidth","labelWidth","tooltipPosition","value","data-element","data-role","helpAriaLabel","borderRadius","hideBorders","required","minHeight","validationMessagePositionTop"]);const{validationRedesignOptIn:be}=r.useContext(b.default),fe=!be&&M,[ve,ge]=r.useState(u.DEFAULT_MIN_HEIGHT),he=e=>be?void 0:e,{current:_e}=r.useRef(N||s.default()),ye=r.useRef(null),je=r.useCallback((e=>{ye.current=e,m&&("current"in m?m.current=e:m(e))}),[m]),[me,xe]=r.useState("off");O||B||(O=!0,h.default.deprecate("Uncontrolled behaviour in `Textarea` is deprecated and support will soon be removed. Please make sure all your inputs are controlled.")),Array.isArray(oe)&&oe.length>4&&!I&&(h.default.warn("The `borderRadius` prop in `Textarea` component only supports up to 4 values."),I=!0);const Oe=r.useCallback((()=>{const e=ye.current;if((null==e?void 0:e.scrollHeight)&&(null==e?void 0:e.scrollHeight)>ve){let r=e;for(;r&&!(null==r?void 0:r.scrollTop);)r=(null==r?void 0:r.parentElement)||null;const t=null==r?void 0:r.scrollTop;e.style.height="auto",e.style.height=`${Math.max(e.scrollHeight,ve)}px`,r&&t&&(r.scrollTop=t)}}),[ve]),{labelId:Ie,validationId:we,fieldHelpId:He,ariaDescribedBy:qe}=p.default({id:_e,validationRedesignOptIn:be,error:U,warning:G,info:z,label:E,fieldHelp:T}),[Pe,Te]=a.default(ne,A,me);r.useEffect((()=>{var e;ge(Q?(null==ye||null===(e=ye.current)||void 0===e?void 0:e.scrollHeight)||0:ue>u.DEFAULT_MIN_HEIGHT?ue:u.DEFAULT_MIN_HEIGHT)}),[ue,Q]),r.useEffect((()=>{K&&Oe()})),r.useEffect((()=>{var e,r;return K&&(window.addEventListener("resize",Oe),ge((null==ye||null===(e=ye.current)||void 0===e?void 0:e.clientHeight)||0),null===(r=document.fonts)||void 0===r||r.addEventListener("loadingdone",Oe)),()=>{var e;K&&(window.removeEventListener("resize",Oe),null===(e=document.fonts)||void 0===e||e.removeEventListener("loadingdone",Oe))}}),[Oe,K]);const Ee=!!(W||we&&!X),Le=r.useRef(s.default()),Ae=P?Le.current:void 0,Be=[...be&&ce?[qe,Ae]:[Ae,qe],Te,H].filter(Boolean).join(" "),Re=e.jsxs(i.default,{disabled:k,readOnly:$,inputWidth:"number"==typeof Z?Z:100-re,maxWidth:ee,error:U,warning:G,info:z,borderRadius:oe,hideBorders:de,children:[e.jsx(n.default,x({"aria-invalid":!!U,"aria-labelledby":w,"aria-describedby":Be,autoFocus:q,name:V,value:ne,ref:je,onChange:B,onFocus:e=>{A&&xe("polite"),null==R||R(e)},onBlur:e=>{A&&xe("off"),null==F||F(e)},disabled:k,readOnly:$,placeholder:k?"":J,rows:Q,id:_e,as:"textarea",validationIconId:be?void 0:we,inputBorderRadius:oe,required:se},pe)),L,e.jsx(d.default,{disabled:k,readOnly:$,inputIcon:W,error:U,warning:G,info:z,validationIconId:be?void 0:we,useValidationIcon:!(be||X)})]}),Fe=y.default(pe);return e.jsx(c.TooltipProvider,{tooltipPosition:te,helpAriaLabel:ae,children:e.jsx(o.InputBehaviour,{children:e.jsxs(u.default,(ke=x({labelInline:fe,hasIcon:Ee,minHeight:ve},Fe,t.default("textarea",{"data-element":ie,"data-role":le})),Me={children:[e.jsxs(l.default,{fieldHelp:he(T),fieldHelpId:He,error:U,warning:G,info:z,label:E,labelId:Ie,disabled:k,id:_e,labelInline:he(fe),labelAlign:S,labelWidth:he(re),labelHelp:he(C),labelSpacing:D,isRequired:se,useValidationIcon:he(X),adaptiveLabelBreakpoint:Y,validationRedesignOptIn:be,my:0,children:[(P||C&&be)&&e.jsx(_.HintText,{align:S,id:Ae,"data-element":"input-hint",children:P||C}),be?e.jsxs(g.Box,{position:"relative",children:[ce&&e.jsxs(e.Fragment,{children:[e.jsx(v.default,{error:U,validationId:we,warning:G,validationMessagePositionTop:ce}),(U||G)&&e.jsx(f.default,{warning:!(U||!G)})]}),Re,!ce&&e.jsxs(e.Fragment,{children:[e.jsx(v.default,{error:U,validationId:we,warning:G,validationMessagePositionTop:ce}),(U||G)&&e.jsx(f.default,{warning:!(U||!G)})]})]}):Re]}),Pe]},Me=null!=Me?Me:{},Object.getOwnPropertyDescriptors?Object.defineProperties(ke,Object.getOwnPropertyDescriptors(Me)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r.push.apply(r,t)}return r}(Object(Me)).forEach((function(e){Object.defineProperty(ke,e,Object.getOwnPropertyDescriptor(Me,e))})),ke))})});var ke,Me}));w.displayName="Textarea",exports.OriginalTextarea=w,exports.Textarea=w,exports.default=w;

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

@@ -87,11 +87,6 @@ export interface CommonTextboxProps extends ValidationProps, MarginProps, Omit<C
     tooltipPosition?: "top" | "bottom" | "left" | "right";
     /** [Legacy] Aria label for rendered help component. */
     helpAriaLabel?: string;
-    /**
-     * [Legacy] Flag to configure component as optional.
-     * @deprecated If the value of this component is not required, use the `required` prop and set it to false instead.
-     */
-    isOptional?: boolean;
     /** The id attribute for the validation tooltip */
     tooltipId?: string;
     /** @private @internal @ignore */

package/lib/components/textbox/textbox.component.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),i=require("react"),n=require("../box/box.component.js"),t=require("../../__internal__/form-field/form-field.component.js"),r=require("../../__internal__/hint-text/hint-text.component.js"),o=require("../../__internal__/input/input.component.js"),a=require("../../__internal__/input/input-presentation.component.js"),l=require("../../__internal__/input-behaviour/input-behaviour.component.js"),d=require("../../__internal__/input-icon-toggle/input-icon-toggle.component.js"),s=require("../../__internal__/tooltip-provider/index.js"),u=require("../../__internal__/validation-message/validation-message.component.js");require("../../style/utils/filter-styled-system-padding-props.js");var p=require("../../style/utils/filter-styled-system-margin-props.js"),c=require("../carbon-provider/__internal__/new-validation.context.js"),b=require("../numeral-date/__internal__/numeral-date.context.js"),f=require("../../__internal__/utils/logger/index.js"),_=require("../../hooks/useCharacterCount/useCharacterCount.js"),g=require("../../hooks/__internal__/useUniqueId/index.js"),h=require("../../__internal__/utils/helpers/guid/index.js"),x=require("../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js"),v=require("./textbox.style.js"),m=require("./__internal__/prefix.style.js");function j(e){return e&&e.__esModule?e:{default:e}}function y(e,i,n){return i in e?Object.defineProperty(e,i,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[i]=n,e}function O(e){for(var i=1;i<arguments.length;i++){var n=null!=arguments[i]?arguments[i]:{},t=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(t=t.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),t.forEach((function(i){y(e,i,n[i])}))}return e}function I(e,i){return i=null!=i?i:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(i)):function(e){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);i.push.apply(i,n)}return i}(Object(i)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(i,n))})),e}const w="left",q="medium",C=30,T=!1;let D=!1,P=!1,L=!1;const A=j(i).default.forwardRef(((j,y)=>{var{"aria-labelledby":A,"aria-describedby":k,ariaDescribedBy:B,align:H=w,autoFocus:F,children:M,disabled:E,inputIcon:S,leftChildren:W,label:R,labelAlign:U,labelHelp:z,labelInline:V,labelSpacing:N,id:G,formattedValue:Z,inputHint:J,fieldHelp:K,error:Q,warning:X,info:Y,name:$,reverse:ee,size:ie=q,value:ne,readOnly:te,placeholder:re,onBlur:oe,onClick:ae,onFocus:le,onChange:de,onMouseDown:se,onChangeDeferred:ue,deferTimeout:pe,isOptional:ce,iconOnClick:be,iconOnMouseDown:fe,iconTabIndex:_e,validationOnLabel:ge=T,labelWidth:he=C,inputWidth:xe,maxWidth:ve,prefix:me,adaptiveLabelBreakpoint:je,required:ye,positionedChildren:Oe,tooltipPosition:Ie,"data-component":we,"data-element":qe,"data-role":Ce,characterLimit:Te,helpAriaLabel:De,tooltipId:Pe,validationMessagePositionTop:Le=!0}=j,Ae=function(e,i){if(null==e)return{};var n,t,r=function(e,i){if(null==e)return{};var n,t,r={},o=Object.keys(e);for(t=0;t<o.length;t++)n=o[t],i.indexOf(n)>=0||(r[n]=e[n]);return r}(e,i);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(t=0;t<o.length;t++)n=o[t],i.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}(j,["aria-labelledby","aria-describedby","ariaDescribedBy","align","autoFocus","children","disabled","inputIcon","leftChildren","label","labelAlign","labelHelp","labelInline","labelSpacing","id","formattedValue","inputHint","fieldHelp","error","warning","info","name","reverse","size","value","readOnly","placeholder","onBlur","onClick","onFocus","onChange","onMouseDown","onChangeDeferred","deferTimeout","isOptional","iconOnClick","iconOnMouseDown","iconTabIndex","validationOnLabel","labelWidth","inputWidth","maxWidth","prefix","adaptiveLabelBreakpoint","required","positionedChildren","tooltipPosition","data-component","data-element","data-role","characterLimit","helpAriaLabel","tooltipId","validationMessagePositionTop"]);!P&&ce&&(P=!0,f.default.deprecate("`isOptional` is deprecated in Textbox and support will soon be removed. If the value of this component is not required, use the `required` prop and set it to false instead."));const ke="string"==typeof ne?ne:"",[Be,He]=g.default(G,$),[Fe,Me]=i.useState("off"),[Ee,Se]=_.default(ke,Te,Fe),{validationRedesignOptIn:We}=i.useContext(c.default),{disableErrorBorder:Re}=i.useContext(b.default),Ue=e=>We?void 0:e;L||de||(L=!0,f.default.deprecate("Uncontrolled behaviour in `Textbox` is deprecated and support will soon be removed. Please make sure all your inputs are controlled.")),!D&&B&&(D=!0,f.default.deprecate("The `ariaDescribedBy` prop in `Textbox` is deprecated and will soon be removed, please use `aria-describedby` instead."));const{labelId:ze,validationId:Ve,fieldHelpId:Ne,ariaDescribedBy:Ge}=x.default({id:Be,validationRedesignOptIn:We,error:Q,warning:X,info:Y,label:R,fieldHelp:K}),Ze=i.useRef(h.default()),Je=J?Ze.current:void 0,Ke=[...We&&Le?[Ge,Je]:[Je,Ge],Se,k||B].filter(Boolean).join(" "),Qe=!!(S||Ve&&!ge),Xe=e.jsxs(a.default,{align:H,disabled:E,readOnly:te,size:ie,error:Q,warning:X,info:Y,prefix:me,inputWidth:xe||100-he,maxWidth:V||"right"!==U?ve:void 0,positionedChildren:Oe,hasIcon:Qe,children:[W,me&&e.jsx(m.default,{"data-element":"textbox-prefix",size:ie,children:me}),e.jsx(o.default,O(I(O({},ye&&{required:ye}),{align:H,"aria-invalid":!!Q,"aria-labelledby":A,"aria-describedby":Ke,autoFocus:F,deferTimeout:pe,disabled:E,id:Be,ref:y,name:He,onBlur:e=>{Te&&Me("off"),null==oe||oe(e)},onChange:de,onChangeDeferred:ue,onClick:E||te?void 0:ae,onFocus:e=>{Te&&Me("polite"),null==le||le(e)},onMouseDown:E||te?void 0:se,placeholder:E||te?"":re,readOnly:te,value:"string"==typeof Z?Z:ne,validationIconId:We?void 0:Pe||Ve}),Ae)),M,e.jsx(d.default,{align:H,disabled:E,error:Q,iconTabIndex:_e,info:Y,inputIcon:S,onClick:E||te?void 0:be||ae,onMouseDown:E||te?void 0:fe||se,readOnly:te,size:ie,useValidationIcon:!(We||ge),warning:X,validationIconId:We?void 0:Pe||Ve})]});return e.jsx(s.TooltipProvider,{helpAriaLabel:De,tooltipPosition:Ie,children:e.jsx(l.InputBehaviour,{children:e.jsxs(t.default,I(O({maxWidth:V||"right"!==U?void 0:ve,disabled:E,fieldHelpId:Ne,fieldHelp:Ue(K),error:Q,warning:X,info:Y,label:R,labelId:ze,labelAlign:U,labelHelp:Ue(z),labelInline:Ue(V),labelSpacing:N,labelWidth:Ue(he),id:Be,reverse:Ue(ee),isOptional:ce,useValidationIcon:Ue(ge),adaptiveLabelBreakpoint:je,isRequired:ye,"data-component":we,"data-role":Ce,"data-element":qe,validationIconId:We?void 0:Ve,validationRedesignOptIn:We},p.default(Ae)),{children:[(J||z&&We)&&e.jsx(r.HintText,{align:U,"data-element":"input-hint",id:Je,isComponentInline:V,children:J||z}),We?e.jsxs(n.Box,{position:"relative",children:[Le&&e.jsxs(e.Fragment,{children:[e.jsx(u.default,{error:Q,validationId:Ve,warning:X,validationMessagePositionTop:Le}),!Re&&(Q||X)&&e.jsx(v.default,{warning:!(Q||!X)})]}),Xe,!Le&&e.jsxs(e.Fragment,{children:[e.jsx(u.default,{error:Q,validationId:Ve,warning:X,validationMessagePositionTop:Le}),!Re&&(Q||X)&&e.jsx(v.default,{warning:!(Q||!X)})]})]}):Xe,Ee]}))})})}));A.displayName="Textbox",exports.ALIGN_DEFAULT=w,exports.LABEL_VALIDATION_DEFAULT=T,exports.LABEL_WIDTH_DEFAULT=C,exports.SIZE_DEFAULT=q,exports.Textbox=A,exports.default=A;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),i=require("react"),n=require("../box/box.component.js"),t=require("../../__internal__/form-field/form-field.component.js"),r=require("../../__internal__/hint-text/hint-text.component.js"),o=require("../../__internal__/input/input.component.js"),a=require("../../__internal__/input/input-presentation.component.js"),l=require("../../__internal__/input-behaviour/input-behaviour.component.js"),d=require("../../__internal__/input-icon-toggle/input-icon-toggle.component.js"),s=require("../../__internal__/tooltip-provider/index.js"),u=require("../../__internal__/validation-message/validation-message.component.js");require("../../style/utils/filter-styled-system-padding-props.js");var p=require("../../style/utils/filter-styled-system-margin-props.js"),c=require("../carbon-provider/__internal__/new-validation.context.js"),b=require("../numeral-date/__internal__/numeral-date.context.js"),f=require("../../__internal__/utils/logger/index.js"),_=require("../../hooks/useCharacterCount/useCharacterCount.js"),g=require("../../hooks/__internal__/useUniqueId/index.js"),h=require("../../__internal__/utils/helpers/guid/index.js"),x=require("../../hooks/__internal__/useInputAccessibility/useInputAccessibility.js"),v=require("./textbox.style.js"),m=require("./__internal__/prefix.style.js");function j(e){return e&&e.__esModule?e:{default:e}}function y(e,i,n){return i in e?Object.defineProperty(e,i,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[i]=n,e}function O(e){for(var i=1;i<arguments.length;i++){var n=null!=arguments[i]?arguments[i]:{},t=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(t=t.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),t.forEach((function(i){y(e,i,n[i])}))}return e}function I(e,i){return i=null!=i?i:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(i)):function(e){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);i.push.apply(i,n)}return i}(Object(i)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(i,n))})),e}const w="left",q="medium",C=30,P=!1;let T=!1;const D=j(i).default.forwardRef(((j,y)=>{var{"aria-labelledby":D,"aria-describedby":L,align:A=w,autoFocus:k,children:B,disabled:H,inputIcon:F,leftChildren:M,label:E,labelAlign:S,labelHelp:W,labelInline:R,labelSpacing:U,id:z,formattedValue:V,inputHint:N,fieldHelp:G,error:Z,warning:J,info:K,name:Q,reverse:X,size:Y=q,value:$,readOnly:ee,placeholder:ie,onBlur:ne,onClick:te,onFocus:re,onChange:oe,onMouseDown:ae,onChangeDeferred:le,deferTimeout:de,iconOnClick:se,iconOnMouseDown:ue,iconTabIndex:pe,validationOnLabel:ce=P,labelWidth:be=C,inputWidth:fe,maxWidth:_e,prefix:ge,adaptiveLabelBreakpoint:he,required:xe,positionedChildren:ve,tooltipPosition:me,"data-component":je,"data-element":ye,"data-role":Oe,characterLimit:Ie,helpAriaLabel:we,tooltipId:qe,validationMessagePositionTop:Ce=!0}=j,Pe=function(e,i){if(null==e)return{};var n,t,r=function(e,i){if(null==e)return{};var n,t,r={},o=Object.keys(e);for(t=0;t<o.length;t++)n=o[t],i.indexOf(n)>=0||(r[n]=e[n]);return r}(e,i);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(t=0;t<o.length;t++)n=o[t],i.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}(j,["aria-labelledby","aria-describedby","align","autoFocus","children","disabled","inputIcon","leftChildren","label","labelAlign","labelHelp","labelInline","labelSpacing","id","formattedValue","inputHint","fieldHelp","error","warning","info","name","reverse","size","value","readOnly","placeholder","onBlur","onClick","onFocus","onChange","onMouseDown","onChangeDeferred","deferTimeout","iconOnClick","iconOnMouseDown","iconTabIndex","validationOnLabel","labelWidth","inputWidth","maxWidth","prefix","adaptiveLabelBreakpoint","required","positionedChildren","tooltipPosition","data-component","data-element","data-role","characterLimit","helpAriaLabel","tooltipId","validationMessagePositionTop"]);const Te="string"==typeof $?$:"",[De,Le]=g.default(z,Q),[Ae,ke]=i.useState("off"),[Be,He]=_.default(Te,Ie,Ae),{validationRedesignOptIn:Fe}=i.useContext(c.default),{disableErrorBorder:Me}=i.useContext(b.default),Ee=e=>Fe?void 0:e;T||oe||(T=!0,f.default.deprecate("Uncontrolled behaviour in `Textbox` is deprecated and support will soon be removed. Please make sure all your inputs are controlled."));const{labelId:Se,validationId:We,fieldHelpId:Re,ariaDescribedBy:Ue}=x.default({id:De,validationRedesignOptIn:Fe,error:Z,warning:J,info:K,label:E,fieldHelp:G}),ze=i.useRef(h.default()),Ve=N?ze.current:void 0,Ne=[...Fe&&Ce?[Ue,Ve]:[Ve,Ue],He,L].filter(Boolean).join(" "),Ge=!!(F||We&&!ce),Ze=e.jsxs(a.default,{align:A,disabled:H,readOnly:ee,size:Y,error:Z,warning:J,info:K,prefix:ge,inputWidth:fe||100-be,maxWidth:R||"right"!==S?_e:void 0,positionedChildren:ve,hasIcon:Ge,children:[M,ge&&e.jsx(m.default,{"data-element":"textbox-prefix",size:Y,children:ge}),e.jsx(o.default,O(I(O({},xe&&{required:xe}),{align:A,"aria-invalid":!!Z,"aria-labelledby":D,"aria-describedby":Ne,autoFocus:k,deferTimeout:de,disabled:H,id:De,ref:y,name:Le,onBlur:e=>{Ie&&ke("off"),null==ne||ne(e)},onChange:oe,onChangeDeferred:le,onClick:H||ee?void 0:te,onFocus:e=>{Ie&&ke("polite"),null==re||re(e)},onMouseDown:H||ee?void 0:ae,placeholder:H||ee?"":ie,readOnly:ee,value:"string"==typeof V?V:$,validationIconId:Fe?void 0:qe||We}),Pe)),B,e.jsx(d.default,{align:A,disabled:H,error:Z,iconTabIndex:pe,info:K,inputIcon:F,onClick:H||ee?void 0:se||te,onMouseDown:H||ee?void 0:ue||ae,readOnly:ee,size:Y,useValidationIcon:!(Fe||ce),warning:J,validationIconId:Fe?void 0:qe||We})]});return e.jsx(s.TooltipProvider,{helpAriaLabel:we,tooltipPosition:me,children:e.jsx(l.InputBehaviour,{children:e.jsxs(t.default,I(O({maxWidth:R||"right"!==S?void 0:_e,disabled:H,fieldHelpId:Re,fieldHelp:Ee(G),error:Z,warning:J,info:K,label:E,labelId:Se,labelAlign:S,labelHelp:Ee(W),labelInline:Ee(R),labelSpacing:U,labelWidth:Ee(be),id:De,reverse:Ee(X),useValidationIcon:Ee(ce),adaptiveLabelBreakpoint:he,isRequired:xe,"data-component":je,"data-role":Oe,"data-element":ye,validationIconId:Fe?void 0:We,validationRedesignOptIn:Fe},p.default(Pe)),{children:[(N||W&&Fe)&&e.jsx(r.HintText,{align:S,"data-element":"input-hint",id:Ve,isComponentInline:R,children:N||W}),Fe?e.jsxs(n.Box,{position:"relative",children:[Ce&&e.jsxs(e.Fragment,{children:[e.jsx(u.default,{error:Z,validationId:We,warning:J,validationMessagePositionTop:Ce}),!Me&&(Z||J)&&e.jsx(v.default,{warning:!(Z||!J)})]}),Ze,!Ce&&e.jsxs(e.Fragment,{children:[e.jsx(u.default,{error:Z,validationId:We,warning:J,validationMessagePositionTop:Ce}),!Me&&(Z||J)&&e.jsx(v.default,{warning:!(Z||!J)})]})]}):Ze,Be]}))})})}));D.displayName="Textbox",exports.ALIGN_DEFAULT=w,exports.LABEL_VALIDATION_DEFAULT=P,exports.LABEL_WIDTH_DEFAULT=C,exports.SIZE_DEFAULT=q,exports.Textbox=D,exports.default=D;

package/lib/components/tile-select/tile-select.style.d.ts

@@ -29,7 +29,7 @@ declare const StyledDeselectWrapper: import("styled-components").StyledComponent
     hasActionAdornment: boolean;
 }, never>;
 declare const StyledTileSelectFieldset: import("styled-components").StyledComponent<{
-    ({ children, legend, required, isOptional, ...rest }: import("../fieldset").FieldsetProps): import("react").JSX.Element;
+    ({ children, legend, required, ...rest }: import("../fieldset").FieldsetProps): import("react").JSX.Element;
     displayName: string;
 }, any, {
     theme: object;

package/lib/components/time/time.component.d.ts

@@ -60,11 +60,6 @@ export interface TimeProps extends TagProps, MarginProps {
     onBlur?: (ev?: React.FocusEvent<HTMLInputElement>, value?: TimeValue) => void;
     /** Flag to configure component as mandatory */
     required?: boolean;
-    /**
-     * [Legacy] Flag to configure component as optional.
-     * @deprecated If the value of this component is not required, use the `required` prop and set it to false instead.
-     */
-    isOptional?: boolean;
     /** If true, the component will be disabled */
     disabled?: boolean;
     /** If true, the component will be read-only */