@elliemae/ds-form-toggle 3.52.1 → 3.53.0-alpha.2

package/dist/types/config/useDSControlledToggle.d.ts

@@ -1,78 +1,72 @@
 import React from 'react';
-import { useGetGlobalAttributes, useGetXstyledProps } from '@elliemae/ds-props-helpers';
 import { type DSControlledToggleT } from '../react-desc-prop-types.js';
-export interface DSControlledToggleCTX {
-    propsWithDefault: DSControlledToggleT.InternalProps;
-    globalProps: ReturnType<typeof useGetGlobalAttributes>;
-    xstyledProps: ReturnType<typeof useGetXstyledProps>;
-    instanceUid: string;
-}
 export declare const useDSControlledToggle: (propsFromUser: DSControlledToggleT.Props) => {
     propsWithDefault: DSControlledToggleT.InternalProps;
-    globalProps: Partial<Pick<object, "name" | "value" | "checked" | "onChange" | "size" | "readOnly" | "disabled" | "form" | "list" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "id" | "lang" | "nonce" | "slot" | "spellCheck" | "style" | "tabIndex" | "title" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "accept" | "acceptCharset" | "action" | "allowFullScreen" | "allowTransparency" | "alt" | "async" | "autoComplete" | "autoPlay" | "capture" | "cellPadding" | "cellSpacing" | "charSet" | "challenge" | "cite" | "classID" | "cols" | "colSpan" | "controls" | "coords" | "crossOrigin" | "data" | "dateTime" | "default" | "defer" | "download" | "encType" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "frameBorder" | "headers" | "height" | "high" | "href" | "hrefLang" | "htmlFor" | "httpEquiv" | "integrity" | "keyParams" | "keyType" | "kind" | "label" | "loop" | "low" | "manifest" | "marginHeight" | "marginWidth" | "max" | "maxLength" | "media" | "mediaGroup" | "method" | "min" | "minLength" | "multiple" | "muted" | "noValidate" | "open" | "optimum" | "pattern" | "placeholder" | "playsInline" | "poster" | "preload" | "required" | "reversed" | "rows" | "rowSpan" | "sandbox" | "scope" | "scoped" | "scrolling" | "seamless" | "selected" | "shape" | "sizes" | "span" | "src" | "srcDoc" | "srcLang" | "srcSet" | "start" | "step" | "summary" | "target" | "type" | "useMap" | "width" | "wmode" | "wrap"> & Omit<{
-        name?: string | undefined;
-        value?: string | number | readonly string[] | undefined;
-        checked?: boolean | undefined;
-        onChange?: React.FormEventHandler<Element> | undefined;
-        size?: number | undefined;
-        readOnly?: boolean | undefined;
-        disabled?: boolean | undefined;
-        form?: string | undefined;
-        list?: string | undefined;
-        "aria-activedescendant"?: string | undefined;
+    width: number;
+    handleRefOnLabelWidth: (instance: HTMLDivElement | null) => void | React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES];
+    handleRefOffLabelWidth: (instance: HTMLDivElement | null) => void | React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES];
+    globalProps: Partial<Pick<object, "shape" | "content" | "size" | "children" | "type" | "onClick" | "form" | "list" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "id" | "lang" | "nonce" | "slot" | "spellCheck" | "style" | "tabIndex" | "title" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "accept" | "acceptCharset" | "action" | "allowFullScreen" | "allowTransparency" | "alt" | "async" | "autoComplete" | "autoPlay" | "capture" | "cellPadding" | "cellSpacing" | "charSet" | "challenge" | "checked" | "cite" | "classID" | "cols" | "colSpan" | "controls" | "coords" | "crossOrigin" | "data" | "dateTime" | "default" | "defer" | "disabled" | "download" | "encType" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "frameBorder" | "headers" | "height" | "high" | "href" | "hrefLang" | "htmlFor" | "httpEquiv" | "integrity" | "keyParams" | "keyType" | "kind" | "label" | "loop" | "low" | "manifest" | "marginHeight" | "marginWidth" | "max" | "maxLength" | "media" | "mediaGroup" | "method" | "min" | "minLength" | "multiple" | "muted" | "name" | "noValidate" | "open" | "optimum" | "pattern" | "placeholder" | "playsInline" | "poster" | "preload" | "readOnly" | "required" | "reversed" | "rows" | "rowSpan" | "sandbox" | "scope" | "scoped" | "scrolling" | "seamless" | "selected" | "sizes" | "span" | "src" | "srcDoc" | "srcLang" | "srcSet" | "start" | "step" | "summary" | "target" | "useMap" | "value" | "width" | "wmode" | "wrap"> & Omit<{
+        shape?: string | undefined | undefined;
+        content?: string | undefined | undefined;
+        size?: number | undefined | undefined;
+        children?: React.ReactNode;
+        type?: string | undefined | undefined;
+        onClick?: React.MouseEventHandler<Element> | undefined;
+        form?: string | undefined | undefined;
+        list?: string | undefined | undefined;
+        "aria-activedescendant"?: string | undefined | undefined;
         "aria-atomic"?: (boolean | "true" | "false") | undefined;
-        "aria-autocomplete"?: "none" | "list" | "inline" | "both" | undefined;
-        "aria-braillelabel"?: string | undefined;
-        "aria-brailleroledescription"?: string | undefined;
+        "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
+        "aria-braillelabel"?: string | undefined | undefined;
+        "aria-brailleroledescription"?: string | undefined | undefined;
         "aria-busy"?: (boolean | "true" | "false") | undefined;
-        "aria-checked"?: boolean | "true" | "false" | "mixed" | undefined;
-        "aria-colcount"?: number | undefined;
-        "aria-colindex"?: number | undefined;
-        "aria-colindextext"?: string | undefined;
-        "aria-colspan"?: number | undefined;
-        "aria-controls"?: string | undefined;
-        "aria-current"?: boolean | "true" | "false" | "step" | "page" | "location" | "date" | "time" | undefined;
-        "aria-describedby"?: string | undefined;
-        "aria-description"?: string | undefined;
-        "aria-details"?: string | undefined;
+        "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+        "aria-colcount"?: number | undefined | undefined;
+        "aria-colindex"?: number | undefined | undefined;
+        "aria-colindextext"?: string | undefined | undefined;
+        "aria-colspan"?: number | undefined | undefined;
+        "aria-controls"?: string | undefined | undefined;
+        "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+        "aria-describedby"?: string | undefined | undefined;
+        "aria-description"?: string | undefined | undefined;
+        "aria-details"?: string | undefined | undefined;
         "aria-disabled"?: (boolean | "true" | "false") | undefined;
-        "aria-dropeffect"?: "none" | "link" | "copy" | "execute" | "move" | "popup" | undefined;
-        "aria-errormessage"?: string | undefined;
+        "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+        "aria-errormessage"?: string | undefined | undefined;
         "aria-expanded"?: (boolean | "true" | "false") | undefined;
-        "aria-flowto"?: string | undefined;
+        "aria-flowto"?: string | undefined | undefined;
         "aria-grabbed"?: (boolean | "true" | "false") | undefined;
-        "aria-haspopup"?: boolean | "true" | "false" | "dialog" | "grid" | "listbox" | "menu" | "tree" | undefined;
+        "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
         "aria-hidden"?: (boolean | "true" | "false") | undefined;
-        "aria-invalid"?: boolean | "true" | "false" | "grammar" | "spelling" | undefined;
-        "aria-keyshortcuts"?: string | undefined;
-        "aria-label"?: string | undefined;
-        "aria-labelledby"?: string | undefined;
-        "aria-level"?: number | undefined;
-        "aria-live"?: "off" | "assertive" | "polite" | undefined;
+        "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+        "aria-keyshortcuts"?: string | undefined | undefined;
+        "aria-label"?: string | undefined | undefined;
+        "aria-labelledby"?: string | undefined | undefined;
+        "aria-level"?: number | undefined | undefined;
+        "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
         "aria-modal"?: (boolean | "true" | "false") | undefined;
         "aria-multiline"?: (boolean | "true" | "false") | undefined;
         "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
-        "aria-orientation"?: "horizontal" | "vertical" | undefined;
-        "aria-owns"?: string | undefined;
-        "aria-placeholder"?: string | undefined;
-        "aria-posinset"?: number | undefined;
-        "aria-pressed"?: boolean | "true" | "false" | "mixed" | undefined;
+        "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+        "aria-owns"?: string | undefined | undefined;
+        "aria-placeholder"?: string | undefined | undefined;
+        "aria-posinset"?: number | undefined | undefined;
+        "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
         "aria-readonly"?: (boolean | "true" | "false") | undefined;
-        "aria-relevant"?: "text" | "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | undefined;
+        "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
         "aria-required"?: (boolean | "true" | "false") | undefined;
-        "aria-roledescription"?: string | undefined;
-        "aria-rowcount"?: number | undefined;
-        "aria-rowindex"?: number | undefined;
-        "aria-rowindextext"?: string | undefined;
-        "aria-rowspan"?: number | undefined;
+        "aria-roledescription"?: string | undefined | undefined;
+        "aria-rowcount"?: number | undefined | undefined;
+        "aria-rowindex"?: number | undefined | undefined;
+        "aria-rowindextext"?: string | undefined | undefined;
+        "aria-rowspan"?: number | undefined | undefined;
         "aria-selected"?: (boolean | "true" | "false") | undefined;
-        "aria-setsize"?: number | undefined;
-        "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
-        "aria-valuemax"?: number | undefined;
-        "aria-valuemin"?: number | undefined;
-        "aria-valuenow"?: number | undefined;
-        "aria-valuetext"?: string | undefined;
-        children?: React.ReactNode;
+        "aria-setsize"?: number | undefined | undefined;
+        "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+        "aria-valuemax"?: number | undefined | undefined;
+        "aria-valuemin"?: number | undefined | undefined;
+        "aria-valuenow"?: number | undefined | undefined;
+        "aria-valuetext"?: string | undefined | undefined;
         onCopy?: React.ClipboardEventHandler<Element> | undefined;
         onCopyCapture?: React.ClipboardEventHandler<Element> | undefined;
         onCut?: React.ClipboardEventHandler<Element> | undefined;
@@ -89,8 +83,9 @@ export declare const useDSControlledToggle: (propsFromUser: DSControlledToggleT.
         onFocusCapture?: React.FocusEventHandler<Element> | undefined;
         onBlur?: React.FocusEventHandler<Element> | undefined;
         onBlurCapture?: React.FocusEventHandler<Element> | undefined;
+        onChange?: React.FormEventHandler<Element> | undefined;
         onChangeCapture?: React.FormEventHandler<Element> | undefined;
-        onBeforeInput?: React.FormEventHandler<Element> | undefined;
+        onBeforeInput?: React.InputEventHandler<Element> | undefined;
         onBeforeInputCapture?: React.FormEventHandler<Element> | undefined;
         onInput?: React.FormEventHandler<Element> | undefined;
         onInputCapture?: React.FormEventHandler<Element> | undefined;
@@ -156,7 +151,6 @@ export declare const useDSControlledToggle: (propsFromUser: DSControlledToggleT.
         onWaitingCapture?: React.ReactEventHandler<Element> | undefined;
         onAuxClick?: React.MouseEventHandler<Element> | undefined;
         onAuxClickCapture?: React.MouseEventHandler<Element> | undefined;
-        onClick?: React.MouseEventHandler<Element> | undefined;
         onClickCapture?: React.MouseEventHandler<Element> | undefined;
         onContextMenu?: React.MouseEventHandler<Element> | undefined;
         onContextMenuCapture?: React.MouseEventHandler<Element> | undefined;
@@ -230,151 +224,154 @@ export declare const useDSControlledToggle: (propsFromUser: DSControlledToggleT.
         onAnimationIterationCapture?: React.AnimationEventHandler<Element> | undefined;
         onTransitionEnd?: React.TransitionEventHandler<Element> | undefined;
         onTransitionEndCapture?: React.TransitionEventHandler<Element> | undefined;
-        defaultChecked?: boolean | undefined;
+        defaultChecked?: boolean | undefined | undefined;
         defaultValue?: string | number | readonly string[] | undefined;
-        suppressContentEditableWarning?: boolean | undefined;
-        suppressHydrationWarning?: boolean | undefined;
-        accessKey?: string | undefined;
-        autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | (string & {}) | undefined;
-        autoFocus?: boolean | undefined;
-        className?: string | undefined;
+        suppressContentEditableWarning?: boolean | undefined | undefined;
+        suppressHydrationWarning?: boolean | undefined | undefined;
+        accessKey?: string | undefined | undefined;
+        autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+        autoFocus?: boolean | undefined | undefined;
+        className?: string | undefined | undefined;
         contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
-        contextMenu?: string | undefined;
-        dir?: string | undefined;
+        contextMenu?: string | undefined | undefined;
+        dir?: string | undefined | undefined;
         draggable?: (boolean | "true" | "false") | undefined;
-        enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
-        hidden?: boolean | undefined;
-        id?: string | undefined;
-        lang?: string | undefined;
-        nonce?: string | undefined;
-        slot?: string | undefined;
+        enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+        hidden?: boolean | undefined | undefined;
+        id?: string | undefined | undefined;
+        lang?: string | undefined | undefined;
+        nonce?: string | undefined | undefined;
+        slot?: string | undefined | undefined;
         spellCheck?: (boolean | "true" | "false") | undefined;
         style?: React.CSSProperties | undefined;
         tabIndex?: 0 | -1 | undefined;
-        title?: string | undefined;
-        translate?: "yes" | "no" | undefined;
-        radioGroup?: string | undefined;
+        title?: string | undefined | undefined;
+        translate?: "yes" | "no" | undefined | undefined;
+        radioGroup?: string | undefined | undefined;
         role?: React.AriaRole | undefined;
-        about?: string | undefined;
-        content?: string | undefined;
-        datatype?: string | undefined;
+        about?: string | undefined | undefined;
+        datatype?: string | undefined | undefined;
         inlist?: any;
-        prefix?: string | undefined;
-        property?: string | undefined;
-        rel?: string | undefined;
-        resource?: string | undefined;
-        rev?: string | undefined;
-        typeof?: string | undefined;
-        vocab?: string | undefined;
-        autoCorrect?: string | undefined;
-        autoSave?: string | undefined;
-        color?: string | undefined;
-        itemProp?: string | undefined;
-        itemScope?: boolean | undefined;
-        itemType?: string | undefined;
-        itemID?: string | undefined;
-        itemRef?: string | undefined;
-        results?: number | undefined;
-        security?: string | undefined;
-        unselectable?: "off" | "on" | undefined;
-        inputMode?: "none" | "search" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | undefined;
-        is?: string | undefined;
-        exportparts?: string | undefined;
-        part?: string | undefined;
-        accept?: string | undefined;
-        acceptCharset?: string | undefined;
+        prefix?: string | undefined | undefined;
+        property?: string | undefined | undefined;
+        rel?: string | undefined | undefined;
+        resource?: string | undefined | undefined;
+        rev?: string | undefined | undefined;
+        typeof?: string | undefined | undefined;
+        vocab?: string | undefined | undefined;
+        autoCorrect?: string | undefined | undefined;
+        autoSave?: string | undefined | undefined;
+        color?: string | undefined | undefined;
+        itemProp?: string | undefined | undefined;
+        itemScope?: boolean | undefined | undefined;
+        itemType?: string | undefined | undefined;
+        itemID?: string | undefined | undefined;
+        itemRef?: string | undefined | undefined;
+        results?: number | undefined | undefined;
+        security?: string | undefined | undefined;
+        unselectable?: "on" | "off" | undefined | undefined;
+        inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+        is?: string | undefined | undefined;
+        exportparts?: string | undefined | undefined;
+        part?: string | undefined | undefined;
+        accept?: string | undefined | undefined;
+        acceptCharset?: string | undefined | undefined;
         action?: string | undefined;
-        allowFullScreen?: boolean | undefined;
-        allowTransparency?: boolean | undefined;
-        alt?: string | undefined;
-        async?: boolean | undefined;
-        autoComplete?: string | undefined;
-        autoPlay?: boolean | undefined;
-        capture?: boolean | "user" | "environment" | undefined;
-        cellPadding?: string | number | undefined;
-        cellSpacing?: string | number | undefined;
-        charSet?: string | undefined;
-        challenge?: string | undefined;
-        cite?: string | undefined;
-        classID?: string | undefined;
-        cols?: number | undefined;
-        colSpan?: number | undefined;
-        controls?: boolean | undefined;
-        coords?: string | undefined;
+        allowFullScreen?: boolean | undefined | undefined;
+        allowTransparency?: boolean | undefined | undefined;
+        alt?: string | undefined | undefined;
+        async?: boolean | undefined | undefined;
+        autoComplete?: string | undefined | undefined;
+        autoPlay?: boolean | undefined | undefined;
+        capture?: boolean | "user" | "environment" | undefined | undefined;
+        cellPadding?: number | string | undefined | undefined;
+        cellSpacing?: number | string | undefined | undefined;
+        charSet?: string | undefined | undefined;
+        challenge?: string | undefined | undefined;
+        checked?: boolean | undefined | undefined;
+        cite?: string | undefined | undefined;
+        classID?: string | undefined | undefined;
+        cols?: number | undefined | undefined;
+        colSpan?: number | undefined | undefined;
+        controls?: boolean | undefined | undefined;
+        coords?: string | undefined | undefined;
         crossOrigin?: "" | "anonymous" | "use-credentials" | undefined;
-        data?: string | undefined;
-        dateTime?: string | undefined;
-        default?: boolean | undefined;
-        defer?: boolean | undefined;
+        data?: string | undefined | undefined;
+        dateTime?: string | undefined | undefined;
+        default?: boolean | undefined | undefined;
+        defer?: boolean | undefined | undefined;
+        disabled?: boolean | undefined | undefined;
         download?: any;
-        encType?: string | undefined;
+        encType?: string | undefined | undefined;
         formAction?: string | undefined;
-        formEncType?: string | undefined;
-        formMethod?: string | undefined;
-        formNoValidate?: boolean | undefined;
-        formTarget?: string | undefined;
-        frameBorder?: string | number | undefined;
-        headers?: string | undefined;
-        height?: string | number | undefined;
-        high?: number | undefined;
-        href?: string | undefined;
-        hrefLang?: string | undefined;
-        htmlFor?: string | undefined;
-        httpEquiv?: string | undefined;
-        integrity?: string | undefined;
-        keyParams?: string | undefined;
-        keyType?: string | undefined;
-        kind?: string | undefined;
-        label?: string | undefined;
-        loop?: boolean | undefined;
-        low?: number | undefined;
-        manifest?: string | undefined;
-        marginHeight?: number | undefined;
-        marginWidth?: number | undefined;
-        max?: string | number | undefined;
-        maxLength?: number | undefined;
-        media?: string | undefined;
-        mediaGroup?: string | undefined;
-        method?: string | undefined;
-        min?: string | number | undefined;
-        minLength?: number | undefined;
-        multiple?: boolean | undefined;
-        muted?: boolean | undefined;
-        noValidate?: boolean | undefined;
-        open?: boolean | undefined;
-        optimum?: number | undefined;
-        pattern?: string | undefined;
-        placeholder?: string | undefined;
-        playsInline?: boolean | undefined;
-        poster?: string | undefined;
-        preload?: string | undefined;
-        required?: boolean | undefined;
-        reversed?: boolean | undefined;
-        rows?: number | undefined;
-        rowSpan?: number | undefined;
-        sandbox?: string | undefined;
-        scope?: string | undefined;
-        scoped?: boolean | undefined;
-        scrolling?: string | undefined;
-        seamless?: boolean | undefined;
-        selected?: boolean | undefined;
-        shape?: string | undefined;
-        sizes?: string | undefined;
-        span?: number | undefined;
-        src?: string | undefined;
-        srcDoc?: string | undefined;
-        srcLang?: string | undefined;
-        srcSet?: string | undefined;
-        start?: number | undefined;
-        step?: string | number | undefined;
-        summary?: string | undefined;
-        target?: string | undefined;
-        type?: string | undefined;
-        useMap?: string | undefined;
-        width?: string | number | undefined;
-        wmode?: string | undefined;
-        wrap?: string | undefined;
+        formEncType?: string | undefined | undefined;
+        formMethod?: string | undefined | undefined;
+        formNoValidate?: boolean | undefined | undefined;
+        formTarget?: string | undefined | undefined;
+        frameBorder?: number | string | undefined | undefined;
+        headers?: string | undefined | undefined;
+        height?: number | string | undefined | undefined;
+        high?: number | undefined | undefined;
+        href?: string | undefined | undefined;
+        hrefLang?: string | undefined | undefined;
+        htmlFor?: string | undefined | undefined;
+        httpEquiv?: string | undefined | undefined;
+        integrity?: string | undefined | undefined;
+        keyParams?: string | undefined | undefined;
+        keyType?: string | undefined | undefined;
+        kind?: string | undefined | undefined;
+        label?: string | undefined | undefined;
+        loop?: boolean | undefined | undefined;
+        low?: number | undefined | undefined;
+        manifest?: string | undefined | undefined;
+        marginHeight?: number | undefined | undefined;
+        marginWidth?: number | undefined | undefined;
+        max?: number | string | undefined | undefined;
+        maxLength?: number | undefined | undefined;
+        media?: string | undefined | undefined;
+        mediaGroup?: string | undefined | undefined;
+        method?: string | undefined | undefined;
+        min?: number | string | undefined | undefined;
+        minLength?: number | undefined | undefined;
+        multiple?: boolean | undefined | undefined;
+        muted?: boolean | undefined | undefined;
+        name?: string | undefined | undefined;
+        noValidate?: boolean | undefined | undefined;
+        open?: boolean | undefined | undefined;
+        optimum?: number | undefined | undefined;
+        pattern?: string | undefined | undefined;
+        placeholder?: string | undefined | undefined;
+        playsInline?: boolean | undefined | undefined;
+        poster?: string | undefined | undefined;
+        preload?: string | undefined | undefined;
+        readOnly?: boolean | undefined | undefined;
+        required?: boolean | undefined | undefined;
+        reversed?: boolean | undefined | undefined;
+        rows?: number | undefined | undefined;
+        rowSpan?: number | undefined | undefined;
+        sandbox?: string | undefined | undefined;
+        scope?: string | undefined | undefined;
+        scoped?: boolean | undefined | undefined;
+        scrolling?: string | undefined | undefined;
+        seamless?: boolean | undefined | undefined;
+        selected?: boolean | undefined | undefined;
+        sizes?: string | undefined | undefined;
+        span?: number | undefined | undefined;
+        src?: string | undefined | undefined;
+        srcDoc?: string | undefined | undefined;
+        srcLang?: string | undefined | undefined;
+        srcSet?: string | undefined | undefined;
+        start?: number | undefined | undefined;
+        step?: number | string | undefined | undefined;
+        summary?: string | undefined | undefined;
+        target?: string | undefined | undefined;
+        useMap?: string | undefined | undefined;
+        value?: string | number | readonly string[] | undefined;
+        width?: number | string | undefined | undefined;
+        wmode?: string | undefined | undefined;
+        wrap?: string | undefined | undefined;
     }, never>>;
+    buttonProps: DSControlledToggleT.ButtonV3InherithedProps;
     xstyledProps: import("@elliemae/ds-props-helpers").XstyledProps;
     instanceUid: string;
     handleOnClick: (e: React.KeyboardEvent<HTMLButtonElement> | React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;

package/dist/types/config/useGetButtonProps.d.ts

@@ -0,0 +1,10 @@
+import type { GlobalAttributesT } from '@elliemae/ds-props-helpers';
+import { type DSControlledToggleT } from '../react-desc-prop-types.js';
+interface UseGetButtonPropsConfigT {
+    handleOnClick: (e: React.MouseEvent<HTMLButtonElement> | React.KeyboardEvent<HTMLButtonElement>) => void;
+    globalProps: GlobalAttributesT<HTMLButtonElement>;
+    propsWithDefault: DSControlledToggleT.InternalProps;
+    instanceUid: string;
+}
+export declare const useGetButtonProps: (config: UseGetButtonPropsConfigT) => DSControlledToggleT.ButtonV3InherithedProps;
+export {};

package/dist/types/config/useGetWidestLabelWidth.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+/**
+ * This should not be required, we are doing this to keep the wcagViolationLabelOn/wcagViolationLabelOff working
+ *   this calculates the width of the widest custom label and sets the width of both labels to that width to avoid layout shift on toggle
+ *
+ * ---
+ *
+ * this can be safely removed in favor of a sensible default min-width for the accessible ON/OFF labels when we can actually kill the wcagViolationLabelOn/wcagViolationLabelOff props
+ */
+export declare const useGetWidestLabelWidth: () => {
+    width: number;
+    handleRefOnLabelWidth: (instance: HTMLDivElement | null) => void | React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES];
+    handleRefOffLabelWidth: (instance: HTMLDivElement | null) => void | React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES];
+};

package/dist/types/constants/index.d.ts

@@ -1,9 +1,22 @@
-export declare const DSControlledToggleName = "DSControlledtoggle";
+export declare const DSControlledToggleName = "DSFormtoggle";
 export declare const CONTROLLED_TOGGLE_SLOTS: {
-    readonly CONTROLLED_CONTAINER: "container";
+    readonly CONTAINER_WITH_RADIUS_SHAPE: "container-with-radius-shape";
+    readonly BUTTON_CONTENT_WRAPPER: "button-content-wrapper";
+    readonly CIRCLE: "circle";
+    readonly TEXT_WRAPPER: "text-wrapper";
+    readonly CONTROLLED_CONTAINER: "controlled-container";
     readonly TOGGLE_CHECKBOX: "toggle-checkbox";
 };
 export declare const CONTROLLED_TOGGLE_DATA_TESTID: {
     CONTROLLED_CONTAINER: string;
     TOGGLE_CHECKBOX: string;
+    CONTAINER_WITH_RADIUS_SHAPE: "ds-formtoggle-container-with-radius-shape";
+    BUTTON_CONTENT_WRAPPER: "ds-formtoggle-button-content-wrapper";
+    CIRCLE: "ds-formtoggle-circle";
+    TEXT_WRAPPER: "ds-formtoggle-text-wrapper";
+};
+export declare const TOGGLE_SIZES: {
+    readonly SMALL: "s";
+    readonly MEDIUM: "m";
+    readonly LARGE: "l";
 };

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
-export * from './ControlledToggle.js';
+export { DSControlledToggle, DSControlledToggleWithSchema } from './ControlledToggle.js';
+export { TOGGLE_SIZES } from './constants/index.js';
 export type { DSControlledToggleT } from './react-desc-prop-types.js';

package/dist/types/react-desc-prop-types.d.ts

@@ -1,17 +1,9 @@
-/// <reference types="react" />
-/// <reference types="prop-types" />
-import type { GlobalAttributesT, XstyledProps, DSPropTypesSchema, ValidationMap } from '@elliemae/ds-props-helpers';
+import type { DSButtonV3T } from '@elliemae/ds-button-v2';
+import type { DSPropTypesSchema, GlobalAttributesT, ValidationMap, XstyledProps } from '@elliemae/ds-props-helpers';
+import { TOGGLE_SIZES } from './constants/index.js';
 export declare namespace DSControlledToggleT {
-    type ToggleSize = 's' | 'm' | 'l';
-    interface OptionalProps {
-        containerProps: Record<string, unknown>;
-        id: string;
-    }
+    type ToggleSize = ObjectValues<typeof TOGGLE_SIZES>;
     interface DefaultProps {
-        labelOn: string;
-        labelOff: string;
-        name: string;
-        value: string;
         checked: boolean;
         onChange: (e: React.MouseEvent<HTMLButtonElement> | React.KeyboardEvent<HTMLButtonElement>) => void;
         size: ToggleSize;
@@ -19,11 +11,43 @@ export declare namespace DSControlledToggleT {
         disabled: boolean;
         applyAriaDisabled: boolean;
     }
-    interface Props extends Partial<DefaultProps>, OptionalProps, Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof XstyledProps>, XstyledProps {
+    interface RequiredProps {
+    }
+    interface OptionalProps {
+        containerProps?: Record<string, unknown>;
+        id?: string;
+    }
+    interface PostDeprecationETAPropsFallback {
+        /**
+         * @deprecated a custom wcagViolationLabelOn violates the role='switch' by design and it's impossible to make it WCAG compliant.
+         * Do not use it, if you need a custom label, you don't need a toggle, use a checkbox instead.
+         */
+        wcagViolationLabelOn?: string;
+        /**
+         * @deprecated a custom wcagViolationLabelOff violates the role='switch' by design and it's impossible to make it WCAG compliant.
+         * Do not use it, if you need a custom label, you don't need a toggle, use a checkbox instead.
+         */
+        wcagViolationLabelOff?: string;
+    }
+    interface PostDeprecationETAProps {
+        /**
+         * @deprecated a custom wcagViolationLabelOn violates the role='switch' by design and it's impossible to make it WCAG compliant.
+         * Do not use it, if you need a custom label, you don't need a toggle, use a checkbox instead.
+         */
+        labelOn?: string;
+        /**
+         * @deprecated a custom wcagViolationLabelOff violates the role='switch' by design and it's impossible to make it WCAG compliant.
+         * Do not use it, if you need a custom label, you don't need a toggle, use a checkbox instead.
+         */
+        labelOff?: string;
+    }
+    interface ButtonV3InherithedProps extends Omit<DSButtonV3T.Props, 'size' | 'children'> {
+    }
+    interface Props extends Partial<DefaultProps>, OptionalProps, Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof XstyledProps>, XstyledProps, RequiredProps, PostDeprecationETAProps, PostDeprecationETAPropsFallback {
     }
-    interface InternalProps extends DefaultProps, OptionalProps, Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof XstyledProps>, XstyledProps {
+    interface InternalProps extends DefaultProps, OptionalProps, Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof XstyledProps>, XstyledProps, RequiredProps, PostDeprecationETAProps, PostDeprecationETAPropsFallback {
     }
 }
 export declare const defaultProps: DSControlledToggleT.DefaultProps;
-export declare const DSControlledTogglePropTypes: DSPropTypesSchema<DSControlledToggleT.Props>;
+export declare const DSControlledTogglePropTypes: DSPropTypesSchema<Omit<DSControlledToggleT.Props, keyof DSControlledToggleT.PostDeprecationETAPropsFallback> & DSControlledToggleT.PostDeprecationETAProps>;
 export declare const DSControlledTogglePropTypesSchema: ValidationMap<DSControlledToggleT.Props>;