reshaped 1.0.1 → 2.1.0

package/components/DropdownMenu/tests/DropdownMenu.stories.js

@@ -0,0 +1,138 @@
+import React from "react";
+import { Example } from "../../../utilities/storybook/index.js";
+import Button from "../../Button/index.js";
+import DropdownMenu from "../index.js";
+import View from "../../View/index.js";
+import { useTheme } from "../../Theme/useTheme.js";
+import IconCheckmark from "../../../icons/Checkmark.js";
+export default { title: "Components/DropdownMenu" };
+export const position = () => (<Example>
+		<Example.Item title="position: default">
+			<DropdownMenu>
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 1</DropdownMenu.Item>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 2</DropdownMenu.Item>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+		</Example.Item>
+
+		<Example.Item title="position: end">
+			<DropdownMenu position="end">
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 1</DropdownMenu.Item>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 2</DropdownMenu.Item>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+		</Example.Item>
+
+		<Example.Item title={["position: top-start", "should change to top-start to fit viewport"]}>
+			<DropdownMenu position="top-end">
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 1</DropdownMenu.Item>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 2</DropdownMenu.Item>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+		</Example.Item>
+	</Example>);
+export const sections = () => (<Example>
+		<Example.Item title="2 sections">
+			<DropdownMenu>
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Section>
+						<DropdownMenu.Item>Item 1</DropdownMenu.Item>
+						<DropdownMenu.Item>Item 2</DropdownMenu.Item>
+					</DropdownMenu.Section>
+
+					<DropdownMenu.Section>
+						<DropdownMenu.Item>Item 3</DropdownMenu.Item>
+						<DropdownMenu.Item>Item 4</DropdownMenu.Item>
+					</DropdownMenu.Section>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+		</Example.Item>
+	</Example>);
+export const submenu = () => (<Example>
+		<Example.Item title="submenu">
+			<DropdownMenu>
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Item onClick={() => { }}>Item 1</DropdownMenu.Item>
+					<DropdownMenu.SubMenu>
+						<DropdownMenu.SubTrigger>Item 2</DropdownMenu.SubTrigger>
+						<DropdownMenu.Content>
+							<DropdownMenu.Item onClick={() => { }}>SubItem 1</DropdownMenu.Item>
+							<DropdownMenu.Item onClick={() => { }}>SubItem 2</DropdownMenu.Item>
+						</DropdownMenu.Content>
+					</DropdownMenu.SubMenu>
+					<DropdownMenu.SubMenu>
+						<DropdownMenu.SubTrigger>Item 3</DropdownMenu.SubTrigger>
+						<DropdownMenu.Content>
+							<DropdownMenu.Item onClick={() => { }}>SubItem 2-1</DropdownMenu.Item>
+							<DropdownMenu.Item onClick={() => { }}>SubItem 2-2</DropdownMenu.Item>
+						</DropdownMenu.Content>
+					</DropdownMenu.SubMenu>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+		</Example.Item>
+	</Example>);
+export const state = () => (<Example>
+		<Example.Item title="defaultActive">
+			<DropdownMenu defaultActive>
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 1</DropdownMenu.Item>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 2</DropdownMenu.Item>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+		</Example.Item>
+	</Example>);
+export const testScroll = () => (<Example>
+		<Example.Item title="Scrolls on page mount to the dropdown">
+			<div style={{ height: 1000 }}/>
+			<DropdownMenu position="end" key="scroll" defaultActive>
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Item>Item 1</DropdownMenu.Item>
+					<DropdownMenu.Item>Item 2</DropdownMenu.Item>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+		</Example.Item>
+	</Example>);
+const ThemeSwitching = () => {
+    const { invertColorMode } = useTheme();
+    return (<View gap={3} direction="row">
+			<DropdownMenu defaultActive>
+				<DropdownMenu.Trigger>
+					{(attributes) => <Button attributes={attributes}>Open</Button>}
+				</DropdownMenu.Trigger>
+				<DropdownMenu.Content>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 1</DropdownMenu.Item>
+					<DropdownMenu.Item icon={IconCheckmark}>Item 2</DropdownMenu.Item>
+				</DropdownMenu.Content>
+			</DropdownMenu>
+			<Button onClick={() => invertColorMode()}>Switch color mode</Button>
+		</View>);
+};
+export const testThemeSwitching = () => (<Example>
+		<Example.Item title="Switch color mode while dropdown is active and check that it still works">
+			<ThemeSwitching />
+		</Example.Item>
+	</Example>);

package/components/FormControl/FormControl.context.d.ts

@@ -0,0 +1,281 @@
+import React from "react";
+import type * as T from "./FormControl.types";
+export declare const Provider: React.Provider<T.Context>;
+export declare const useFormControlPrivate: () => T.Context;
+export declare const useFormControl: () => {
+    attributes: {
+        defaultChecked?: boolean | undefined;
+        defaultValue?: string | number | readonly string[] | undefined;
+        suppressContentEditableWarning?: boolean | undefined;
+        suppressHydrationWarning?: boolean | undefined;
+        accessKey?: string | undefined;
+        autoFocus?: boolean | undefined;
+        className?: string | undefined;
+        contentEditable?: (boolean | "true" | "false") | "inherit" | undefined;
+        contextMenu?: string | undefined;
+        dir?: string | undefined;
+        draggable?: (boolean | "true" | "false") | undefined;
+        hidden?: boolean | undefined;
+        id?: string | undefined;
+        lang?: string | undefined;
+        nonce?: string | undefined;
+        placeholder?: string | undefined;
+        slot?: string | undefined;
+        spellCheck?: (boolean | "true" | "false") | undefined;
+        style?: React.CSSProperties | undefined;
+        tabIndex?: number | undefined;
+        title?: string | undefined;
+        translate?: "yes" | "no" | undefined;
+        radioGroup?: string | undefined;
+        role?: React.AriaRole | undefined;
+        about?: string | undefined;
+        content?: string | undefined;
+        datatype?: string | undefined;
+        inlist?: any;
+        prefix?: string | undefined;
+        property?: string | undefined;
+        rel?: string | undefined;
+        resource?: string | undefined;
+        rev?: string | undefined;
+        typeof?: string | undefined;
+        vocab?: string | undefined;
+        autoCapitalize?: 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?: "on" | "off" | undefined;
+        inputMode?: "search" | "text" | "none" | "tel" | "url" | "email" | "numeric" | "decimal" | undefined;
+        is?: string | undefined;
+        'aria-activedescendant'?: string | undefined;
+        'aria-atomic'?: (boolean | "true" | "false") | undefined;
+        'aria-autocomplete'?: "list" | "none" | "both" | "inline" | undefined;
+        'aria-braillelabel'?: string | undefined;
+        'aria-brailleroledescription'?: string | 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 | "time" | "true" | "false" | "page" | "step" | "location" | "date" | undefined;
+        'aria-describedby'?: string | undefined;
+        'aria-description'?: string | undefined;
+        'aria-details'?: string | undefined;
+        'aria-disabled'?: (boolean | "true" | "false") | undefined;
+        'aria-dropeffect'?: "link" | "none" | "copy" | "move" | "execute" | "popup" | undefined;
+        'aria-errormessage'?: string | undefined;
+        'aria-expanded'?: (boolean | "true" | "false") | undefined;
+        'aria-flowto'?: string | undefined;
+        'aria-grabbed'?: (boolean | "true" | "false") | undefined;
+        'aria-haspopup'?: boolean | "dialog" | "menu" | "true" | "false" | "grid" | "listbox" | "tree" | 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-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-readonly'?: (boolean | "true" | "false") | undefined;
+        'aria-relevant'?: "text" | "all" | "additions" | "additions removals" | "additions text" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | 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-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;
+        dangerouslySetInnerHTML?: {
+            __html: string | TrustedHTML;
+        } | undefined;
+        onCopy?: React.ClipboardEventHandler<HTMLElement> | undefined;
+        onCopyCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+        onCut?: React.ClipboardEventHandler<HTMLElement> | undefined;
+        onCutCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+        onPaste?: React.ClipboardEventHandler<HTMLElement> | undefined;
+        onPasteCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+        onCompositionEnd?: React.CompositionEventHandler<HTMLElement> | undefined;
+        onCompositionEndCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+        onCompositionStart?: React.CompositionEventHandler<HTMLElement> | undefined;
+        onCompositionStartCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+        onCompositionUpdate?: React.CompositionEventHandler<HTMLElement> | undefined;
+        onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+        onFocus?: React.FocusEventHandler<HTMLElement> | undefined;
+        onFocusCapture?: React.FocusEventHandler<HTMLElement> | undefined;
+        onBlur?: React.FocusEventHandler<HTMLElement> | undefined;
+        onBlurCapture?: React.FocusEventHandler<HTMLElement> | undefined;
+        onChange?: React.FormEventHandler<HTMLElement> | undefined;
+        onChangeCapture?: React.FormEventHandler<HTMLElement> | undefined;
+        onBeforeInput?: React.FormEventHandler<HTMLElement> | undefined;
+        onBeforeInputCapture?: React.FormEventHandler<HTMLElement> | undefined;
+        onInput?: React.FormEventHandler<HTMLElement> | undefined;
+        onInputCapture?: React.FormEventHandler<HTMLElement> | undefined;
+        onReset?: React.FormEventHandler<HTMLElement> | undefined;
+        onResetCapture?: React.FormEventHandler<HTMLElement> | undefined;
+        onSubmit?: React.FormEventHandler<HTMLElement> | undefined;
+        onSubmitCapture?: React.FormEventHandler<HTMLElement> | undefined;
+        onInvalid?: React.FormEventHandler<HTMLElement> | undefined;
+        onInvalidCapture?: React.FormEventHandler<HTMLElement> | undefined;
+        onLoad?: React.ReactEventHandler<HTMLElement> | undefined;
+        onLoadCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onError?: React.ReactEventHandler<HTMLElement> | undefined;
+        onErrorCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onKeyDown?: React.KeyboardEventHandler<HTMLElement> | undefined;
+        onKeyDownCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+        onKeyPress?: React.KeyboardEventHandler<HTMLElement> | undefined;
+        onKeyPressCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+        onKeyUp?: React.KeyboardEventHandler<HTMLElement> | undefined;
+        onKeyUpCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+        onAbort?: React.ReactEventHandler<HTMLElement> | undefined;
+        onAbortCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onCanPlay?: React.ReactEventHandler<HTMLElement> | undefined;
+        onCanPlayCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onCanPlayThrough?: React.ReactEventHandler<HTMLElement> | undefined;
+        onCanPlayThroughCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onDurationChange?: React.ReactEventHandler<HTMLElement> | undefined;
+        onDurationChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onEmptied?: React.ReactEventHandler<HTMLElement> | undefined;
+        onEmptiedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onEncrypted?: React.ReactEventHandler<HTMLElement> | undefined;
+        onEncryptedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onEnded?: React.ReactEventHandler<HTMLElement> | undefined;
+        onEndedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onLoadedData?: React.ReactEventHandler<HTMLElement> | undefined;
+        onLoadedDataCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onLoadedMetadata?: React.ReactEventHandler<HTMLElement> | undefined;
+        onLoadedMetadataCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onLoadStart?: React.ReactEventHandler<HTMLElement> | undefined;
+        onLoadStartCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onPause?: React.ReactEventHandler<HTMLElement> | undefined;
+        onPauseCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onPlay?: React.ReactEventHandler<HTMLElement> | undefined;
+        onPlayCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onPlaying?: React.ReactEventHandler<HTMLElement> | undefined;
+        onPlayingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onProgress?: React.ReactEventHandler<HTMLElement> | undefined;
+        onProgressCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onRateChange?: React.ReactEventHandler<HTMLElement> | undefined;
+        onRateChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onResize?: React.ReactEventHandler<HTMLElement> | undefined;
+        onResizeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onSeeked?: React.ReactEventHandler<HTMLElement> | undefined;
+        onSeekedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onSeeking?: React.ReactEventHandler<HTMLElement> | undefined;
+        onSeekingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onStalled?: React.ReactEventHandler<HTMLElement> | undefined;
+        onStalledCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onSuspend?: React.ReactEventHandler<HTMLElement> | undefined;
+        onSuspendCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onTimeUpdate?: React.ReactEventHandler<HTMLElement> | undefined;
+        onTimeUpdateCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onVolumeChange?: React.ReactEventHandler<HTMLElement> | undefined;
+        onVolumeChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onWaiting?: React.ReactEventHandler<HTMLElement> | undefined;
+        onWaitingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onAuxClick?: React.MouseEventHandler<HTMLElement> | undefined;
+        onAuxClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onClick?: React.MouseEventHandler<HTMLElement> | undefined;
+        onClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onContextMenu?: React.MouseEventHandler<HTMLElement> | undefined;
+        onContextMenuCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onDoubleClick?: React.MouseEventHandler<HTMLElement> | undefined;
+        onDoubleClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onDrag?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragEnd?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragEndCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragEnter?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragEnterCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragExit?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragExitCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragLeave?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragLeaveCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragOver?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragOverCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragStart?: React.DragEventHandler<HTMLElement> | undefined;
+        onDragStartCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onDrop?: React.DragEventHandler<HTMLElement> | undefined;
+        onDropCapture?: React.DragEventHandler<HTMLElement> | undefined;
+        onMouseDown?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseDownCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseEnter?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseLeave?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseMove?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseMoveCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseOut?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseOutCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseOver?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseOverCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseUp?: React.MouseEventHandler<HTMLElement> | undefined;
+        onMouseUpCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+        onSelect?: React.ReactEventHandler<HTMLElement> | undefined;
+        onSelectCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+        onTouchCancel?: React.TouchEventHandler<HTMLElement> | undefined;
+        onTouchCancelCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+        onTouchEnd?: React.TouchEventHandler<HTMLElement> | undefined;
+        onTouchEndCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+        onTouchMove?: React.TouchEventHandler<HTMLElement> | undefined;
+        onTouchMoveCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+        onTouchStart?: React.TouchEventHandler<HTMLElement> | undefined;
+        onTouchStartCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+        onPointerDown?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerDownCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerMove?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerMoveCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerUp?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerUpCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerCancel?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerCancelCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerEnter?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerEnterCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerLeave?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerLeaveCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerOver?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerOverCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerOut?: React.PointerEventHandler<HTMLElement> | undefined;
+        onPointerOutCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onGotPointerCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onLostPointerCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+        onScroll?: React.UIEventHandler<HTMLElement> | undefined;
+        onScrollCapture?: React.UIEventHandler<HTMLElement> | undefined;
+        onWheel?: React.WheelEventHandler<HTMLElement> | undefined;
+        onWheelCapture?: React.WheelEventHandler<HTMLElement> | undefined;
+        onAnimationStart?: React.AnimationEventHandler<HTMLElement> | undefined;
+        onAnimationStartCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+        onAnimationEnd?: React.AnimationEventHandler<HTMLElement> | undefined;
+        onAnimationEndCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+        onAnimationIteration?: React.AnimationEventHandler<HTMLElement> | undefined;
+        onAnimationIterationCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+        onTransitionEnd?: React.TransitionEventHandler<HTMLElement> | undefined;
+        onTransitionEndCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+    } & {
+        id: string;
+    };
+    required: boolean | undefined;
+    hasError: boolean | undefined;
+    disabled: boolean | undefined;
+};

package/components/FormControl/FormControl.context.js

@@ -0,0 +1,18 @@
+"use client";
+import React from "react";
+const FormControlContext = React.createContext({
+    attributes: {
+        id: "",
+        "aria-describedby": "",
+    },
+    required: undefined,
+    hasError: false,
+    errorRef: () => { },
+    helperRef: () => { },
+});
+export const Provider = FormControlContext.Provider;
+export const useFormControlPrivate = () => React.useContext(FormControlContext);
+export const useFormControl = () => {
+    const { attributes, required, hasError, disabled } = useFormControlPrivate();
+    return { attributes, required, hasError, disabled };
+};

package/components/FormControl/FormControl.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import type * as T from "./FormControl.types";
+declare const FormControl: {
+    (props: T.Props): React.JSX.Element;
+    Label: (props: T.LabelProps) => React.JSX.Element;
+    Helper: (props: T.CaptionProps) => React.JSX.Element;
+    Error: (props: T.CaptionProps) => React.JSX.Element | null;
+};
+export default FormControl;

package/components/FormControl/FormControl.js

@@ -0,0 +1,68 @@
+"use client";
+import React from "react";
+import useElementId from "../../hooks/useElementId.js";
+import Text from "../Text/index.js";
+import { Provider, useFormControlPrivate } from "./FormControl.context.js";
+import s from "./FormControl.module.css";
+const getCaptionId = (id, variant) => `${id}-${variant || "caption"}`;
+const FormControl = (props) => {
+    const { children, id: passedId, required, hasError, group, disabled, size } = props;
+    const id = useElementId(passedId);
+    const WrapperTagName = group ? "fieldset" : "div";
+    const [helperRendered, setHelperRendered] = React.useState(false);
+    const [errorRendered, setErrorRendered] = React.useState(false);
+    const describedby = [
+        helperRendered && getCaptionId(id),
+        errorRendered && getCaptionId(id, "error"),
+    ]
+        .filter(Boolean)
+        .join(" ");
+    const attributes = { id, "aria-describedby": describedby };
+    const errorRef = () => {
+        setErrorRendered(true);
+    };
+    const helperRef = () => {
+        setHelperRendered(true);
+    };
+    return (React.createElement(WrapperTagName, null,
+        React.createElement(Provider, { value: { required, hasError, errorRef, helperRef, attributes, group, disabled, size } }, children)));
+};
+const FormControlLabel = (props) => {
+    const { children } = props;
+    const { attributes, required, group, disabled, size } = useFormControlPrivate();
+    const id = `${attributes.id}-label`;
+    const tagProps = group
+        ? { as: "legend", attributes: { id } }
+        : {
+            as: "label",
+            attributes: { id, htmlFor: attributes.id },
+        };
+    return (React.createElement(Text, Object.assign({}, tagProps, { variant: size === "large" ? "body-2" : "body-3", weight: "medium", className: s.label, color: disabled ? "disabled" : undefined }),
+        children,
+        required && (React.createElement(Text, { color: disabled ? "disabled" : "critical", as: "span" }, "*"))));
+};
+/* Private component */
+const FormControlCaption = (props) => {
+    const { children, variant, disabled } = props;
+    const { attributes, size, helperRef, errorRef } = useFormControlPrivate();
+    const id = getCaptionId(attributes.id, variant);
+    const color = variant === "error" ? "critical" : "neutral-faded";
+    const ref = variant === "error" ? errorRef : helperRef;
+    return (React.createElement(Text, { as: "span", variant: size === "large" ? "body-3" : "caption-1", color: disabled && !variant ? "disabled" : color, attributes: { id, role: color ? "alert" : undefined, ref }, className: s.caption }, children));
+};
+const FormControlHelper = (props) => {
+    const { children } = props;
+    const { disabled } = useFormControlPrivate();
+    return React.createElement(FormControlCaption, { disabled: disabled }, children);
+};
+const FormControlError = (props) => {
+    const { children } = props;
+    const { hasError } = useFormControlPrivate();
+    if (!hasError)
+        return null;
+    return React.createElement(FormControlCaption, { variant: "error" }, children);
+};
+FormControl.Label = FormControlLabel;
+FormControl.Helper = FormControlHelper;
+FormControl.Error = FormControlError;
+export default FormControl;

package/components/FormControl/FormControl.module.css

@@ -0,0 +1 @@
+.root{border:none}.label{display:block;margin-bottom:var(--rs-unit-x1)}.caption{display:block;margin-top:var(--rs-unit-x1)}.caption+.caption{margin-top:0}

package/components/FormControl/FormControl.types.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+export type Props = {
+    children: React.ReactNode;
+    size?: "medium" | "large";
+    hasError?: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    group?: boolean;
+    id?: string;
+};
+export type LabelProps = {
+    children: React.ReactNode;
+};
+export type CaptionProps = {
+    children: React.ReactNode;
+};
+export type PrivateCaptionProps = CaptionProps & {
+    variant?: "error";
+    disabled?: boolean;
+};
+type Attributes = {
+    [K in keyof React.HTMLAttributes<HTMLElement>]?: React.HTMLAttributes<HTMLElement>[K];
+};
+export type Context = {
+    required?: boolean;
+    group?: boolean;
+    attributes: Attributes & {
+        id: string;
+    };
+    helperRef: () => void;
+    errorRef: () => void;
+} & Pick<Props, "hasError" | "disabled" | "size">;
+export {};

package/components/FormControl/FormControl.types.js

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

package/components/FormControl/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from "./FormControl";
+export { useFormControl } from "./FormControl.context";
+export type { Props as FormControlProps } from "./FormControl.types";

package/components/FormControl/index.js

@@ -0,0 +1,2 @@
+export { default } from "./FormControl.js";
+export { useFormControl } from "./FormControl.context.js";

package/components/FormControl/tests/FormControl.stories.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+declare const _default: {
+    title: string;
+};
+export default _default;
+export declare const status: () => React.JSX.Element;
+export declare const size: () => React.JSX.Element;
+export declare const disabled: () => React.JSX.Element;
+export declare const required: () => React.JSX.Element;
+export declare const group: () => React.JSX.Element;

package/components/FormControl/tests/FormControl.stories.js

@@ -0,0 +1,78 @@
+import React from "react";
+import { Example } from "../../../utilities/storybook/index.js";
+import FormControl, { useFormControl } from "../index.js";
+import RadioGroup from "../../RadioGroup/index.js";
+import Radio from "../../Radio/index.js";
+import View from "../../View/index.js";
+export default { title: "Utilities/FormControl" };
+const Input = () => {
+    const { attributes } = useFormControl();
+    return <input {...attributes}/>;
+};
+export const status = () => (<Example>
+		<Example.Item title="status: default">
+			<FormControl>
+				<FormControl.Label>Label</FormControl.Label>
+				<Input />
+				<FormControl.Helper>Caption</FormControl.Helper>
+				<FormControl.Error>Error</FormControl.Error>
+			</FormControl>
+		</Example.Item>
+
+		<Example.Item title="status: error">
+			<FormControl hasError>
+				<FormControl.Label>Label</FormControl.Label>
+				<Input />
+				<FormControl.Helper>Caption</FormControl.Helper>
+				<FormControl.Error>Error</FormControl.Error>
+			</FormControl>
+		</Example.Item>
+	</Example>);
+export const size = () => (<Example>
+		<Example.Item title="size: medium">
+			<FormControl size="medium">
+				<FormControl.Label>Label</FormControl.Label>
+				<Input />
+				<FormControl.Helper>Caption</FormControl.Helper>
+			</FormControl>
+		</Example.Item>
+		<Example.Item title="size: large">
+			<FormControl size="large">
+				<FormControl.Label>Label</FormControl.Label>
+				<Input />
+				<FormControl.Helper>Caption</FormControl.Helper>
+			</FormControl>
+		</Example.Item>
+	</Example>);
+export const disabled = () => (<Example>
+		<Example.Item title="disabled">
+			<FormControl disabled>
+				<FormControl.Label>Label</FormControl.Label>
+				<Input />
+				<FormControl.Helper>Caption</FormControl.Helper>
+			</FormControl>
+		</Example.Item>
+	</Example>);
+export const required = () => (<Example>
+		<Example.Item title="required">
+			<FormControl required>
+				<FormControl.Label>Label</FormControl.Label>
+				<Input />
+				<FormControl.Helper>Caption</FormControl.Helper>
+			</FormControl>
+		</Example.Item>
+	</Example>);
+export const group = () => (<Example>
+		<Example.Item title="form group">
+			<FormControl group>
+				<FormControl.Label>Favorite animals:</FormControl.Label>
+
+				<RadioGroup name="animalGroup">
+					<View gap={2}>
+						<Radio value="dog">Dog</Radio>
+						<Radio value="cat">Cat</Radio>
+					</View>
+				</RadioGroup>
+			</FormControl>
+		</Example.Item>
+	</Example>);