@proyecto-viviana/solidaria-components 0.2.9 → 0.3.0

package/src/Color.tsx

@@ -13,9 +13,10 @@ import {
   createSignal,
   onCleanup,
   splitProps,
+  untrack,
   useContext,
   Show,
-} from 'solid-js';
+} from "solid-js";
 import {
   createColorSlider,
   createColorArea,
@@ -31,7 +32,7 @@ import {
   type AriaColorAreaOptions,
   type AriaColorWheelOptions,
   type AriaColorFieldOptions,
-} from '@proyecto-viviana/solidaria';
+} from "@proyecto-viviana/solidaria";
 import {
   createListState,
   createColorSliderState,
@@ -42,13 +43,14 @@ import {
   type Color,
   type ColorChannel,
   type ColorFormat,
+  type ColorSpace,
   type ColorSliderState,
   type ColorAreaState,
   type ColorWheelState,
   type ColorFieldState,
   type ListState,
   type Key,
-} from '@proyecto-viviana/solid-stately';
+} from "@proyecto-viviana/solid-stately";
 import {
   type RenderChildren,
   type ClassNameOrFunction,
@@ -56,7 +58,7 @@ import {
   type SlotProps,
   useRenderProps,
   filterDOMProps,
-} from './utils';
+} from "./utils";
 
 interface ColorPickerChannelContextValue {
   value?: Color | string;
@@ -86,10 +88,6 @@ const ColorPickerStateContextInternal = createContext<ColorPickerStateContextVal
 const ColorSwatchContextInternal = createContext<{ color?: Color | string } | null>(null);
 const ColorSwatchPickerContextInternal = createContext<ColorSwatchPickerContextValue | null>(null);
 
-// ============================================
-// COLOR SLIDER
-// ============================================
-
 export interface ColorSliderRenderProps {
   /** Whether the slider is disabled. */
   isDisabled: boolean;
@@ -97,13 +95,19 @@ export interface ColorSliderRenderProps {
   isDragging: boolean;
   /** The color channel being controlled. */
   channel: ColorChannel;
+  /** The slider orientation. */
+  orientation: "horizontal" | "vertical";
   /** The current value. */
   value: number;
+  /** The formatted current value. */
+  valueLabel: string;
   /** The current color. */
   color: Color;
+  /** The default inline styles applied by the color slider hook. */
+  defaultStyle: JSX.CSSProperties;
 }
 
-export interface ColorSliderProps extends Omit<AriaColorSliderOptions, 'channel'>, SlotProps {
+export interface ColorSliderProps extends Omit<AriaColorSliderOptions, "channel">, SlotProps {
   /** The current color value (controlled). */
   value?: Color | string;
   /** The default color value (uncontrolled). */
@@ -112,6 +116,8 @@ export interface ColorSliderProps extends Omit<AriaColorSliderOptions, 'channel'
   onChange?: (color: Color) => void;
   /** Handler called when dragging ends. */
   onChangeEnd?: (color: Color) => void;
+  /** Color space used for channel values. */
+  colorSpace?: ColorSpace;
   /** The color channel to control. */
   channel: ColorChannel;
   /** A visible label for the slider. */
@@ -129,6 +135,10 @@ export interface ColorSliderTrackRenderProps {
   isDisabled: boolean;
   /** Whether the slider is being dragged. */
   isDragging: boolean;
+  /** The slider orientation. */
+  orientation: "horizontal" | "vertical";
+  /** The default inline styles applied by the color slider hook. */
+  defaultStyle: JSX.CSSProperties;
 }
 
 export interface ColorSliderTrackProps extends SlotProps {
@@ -140,6 +150,24 @@ export interface ColorSliderTrackProps extends SlotProps {
   style?: StyleOrFunction<ColorSliderTrackRenderProps>;
 }
 
+export interface ColorSliderLabelProps extends SlotProps {
+  /** The label contents. */
+  children?: JSX.Element;
+  /** The CSS className for the element. */
+  class?: string;
+  /** The inline style for the element. */
+  style?: JSX.CSSProperties;
+}
+
+export interface ColorSliderOutputProps extends SlotProps {
+  /** The output contents. Defaults to the formatted slider value. */
+  children?: JSX.Element | ((renderProps: ColorSliderRenderProps) => JSX.Element);
+  /** The CSS className for the element. */
+  class?: string;
+  /** The inline style for the element. */
+  style?: JSX.CSSProperties;
+}
+
 export interface ColorSliderThumbRenderProps {
   /** Whether the slider is disabled. */
   isDisabled: boolean;
@@ -151,6 +179,10 @@ export interface ColorSliderThumbRenderProps {
   isFocusVisible: boolean;
   /** Whether the thumb is hovered. */
   isHovered: boolean;
+  /** The current display color. */
+  color: Color;
+  /** The default inline styles applied by the color slider hook. */
+  defaultStyle: JSX.CSSProperties;
 }
 
 export interface ColorSliderThumbProps extends SlotProps {
@@ -160,16 +192,20 @@ export interface ColorSliderThumbProps extends SlotProps {
   class?: ClassNameOrFunction<ColorSliderThumbRenderProps>;
   /** The inline style for the element. */
   style?: StyleOrFunction<ColorSliderThumbRenderProps>;
+  /** Ref callback for the thumb element. */
+  ref?: (element: HTMLDivElement) => void;
 }
 
-// Context
 interface ColorSliderContextValue {
   state: ColorSliderState;
   trackProps: JSX.HTMLAttributes<HTMLDivElement>;
   thumbProps: JSX.HTMLAttributes<HTMLDivElement>;
   inputProps: JSX.InputHTMLAttributes<HTMLInputElement>;
+  outputProps: JSX.HTMLAttributes<HTMLOutputElement>;
+  labelProps: JSX.LabelHTMLAttributes<HTMLLabelElement>;
   trackRef: HTMLDivElement | undefined;
   setTrackRef: (el: HTMLDivElement) => void;
+  setInputRef: (el: HTMLInputElement) => void;
 }
 
 export const ColorSliderContext = createContext<ColorSliderContextValue | null>(null);
@@ -181,9 +217,20 @@ export function ColorSlider(props: ColorSliderProps): JSX.Element {
   const pickerContext = useContext(ColorPickerContextInternal);
   const [local, stateProps, ariaProps, rest] = splitProps(
     props,
-    ['children', 'class', 'style', 'slot', 'label'],
-    ['value', 'defaultValue', 'onChange', 'onChangeEnd', 'channel'],
-    ['aria-label', 'aria-labelledby', 'aria-describedby', 'isDisabled', 'channelName']
+    ["children", "class", "style", "slot", "label"],
+    ["value", "defaultValue", "onChange", "onChangeEnd", "channel", "colorSpace"],
+    [
+      "id",
+      "aria-label",
+      "aria-labelledby",
+      "aria-describedby",
+      "aria-details",
+      "isDisabled",
+      "name",
+      "form",
+      "orientation",
+      "channelName",
+    ],
   );
 
   // Create color slider state
@@ -193,66 +240,90 @@ export function ColorSlider(props: ColorSliderProps): JSX.Element {
     onChange: stateProps.onChange ?? pickerContext?.onChange,
     onChangeEnd: stateProps.onChangeEnd,
     channel: stateProps.channel,
+    colorSpace: stateProps.colorSpace,
+    orientation: ariaProps.orientation,
     isDisabled: ariaProps.isDisabled,
   }));
 
-  // Track ref
   let trackRef: HTMLDivElement | undefined;
   const setTrackRef = (el: HTMLDivElement) => {
     trackRef = el;
   };
+  let inputRef: HTMLInputElement | undefined;
+  const setInputRef = (el: HTMLInputElement) => {
+    inputRef = el;
+  };
 
   // Create color slider aria props
-  const {
-    trackProps,
-    thumbProps,
-    inputProps,
-    labelProps,
-  } = createColorSlider(
+  const colorSliderAria = createColorSlider(
     () => ({
+      id: ariaProps.id,
       channel: stateProps.channel,
-      'aria-label': ariaProps['aria-label'],
-      'aria-labelledby': ariaProps['aria-labelledby'],
-      'aria-describedby': ariaProps['aria-describedby'],
+      label: local.label,
+      "aria-label": ariaProps["aria-label"],
+      "aria-labelledby": ariaProps["aria-labelledby"],
+      "aria-describedby": ariaProps["aria-describedby"],
+      "aria-details": ariaProps["aria-details"],
       isDisabled: ariaProps.isDisabled,
+      name: ariaProps.name,
+      form: ariaProps.form,
+      orientation: ariaProps.orientation,
       channelName: ariaProps.channelName,
     }),
     () => state,
-    () => trackRef ?? null
+    () => trackRef ?? null,
+    () => inputRef ?? null,
   );
 
-  // Render props values
   const renderValues = createMemo<ColorSliderRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
     channel: state.channel,
+    orientation: state.orientation,
     value: state.getThumbValue(),
+    valueLabel: state.getThumbValueLabel(),
     color: state.value,
+    defaultStyle: (colorSliderAria.trackProps as { style?: JSX.CSSProperties }).style ?? {},
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorSlider',
+      defaultClassName: "solidaria-ColorSlider",
     },
-    renderValues
+    renderValues,
   );
 
-  // Filter DOM props
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }));
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
 
   return (
     <ColorSliderContext.Provider
       value={{
         state,
-        trackProps,
-        thumbProps,
-        inputProps,
-        trackRef,
+        get trackProps() {
+          return colorSliderAria.trackProps;
+        },
+        get thumbProps() {
+          return colorSliderAria.thumbProps;
+        },
+        get inputProps() {
+          return colorSliderAria.inputProps;
+        },
+        get outputProps() {
+          return colorSliderAria.outputProps;
+        },
+        get labelProps() {
+          return colorSliderAria.labelProps;
+        },
+        get trackRef() {
+          return trackRef;
+        },
         setTrackRef,
+        setInputRef,
       }}
     >
       <div
@@ -261,58 +332,115 @@ export function ColorSlider(props: ColorSliderProps): JSX.Element {
         style={renderProps.style()}
         data-disabled={state.isDisabled || undefined}
         data-dragging={state.isDragging || undefined}
-        data-channel={state.channel}
+        data-orientation={state.orientation}
+        slot={local.slot || undefined}
       >
-        {/* Label */}
-        <Show when={local.label}>
-          <label {...labelProps}>{local.label}</label>
-        </Show>
-
         {renderProps.renderChildren()}
       </div>
     </ColorSliderContext.Provider>
   );
 }
 
+/**
+ * The label element of a color slider.
+ */
+export function ColorSliderLabel(props: ColorSliderLabelProps): JSX.Element {
+  const [local, domProps] = splitProps(props, ["class", "slot", "children"]);
+
+  const context = useContext(ColorSliderContext);
+  if (!context) {
+    throw new Error("ColorSliderLabel must be used within a ColorSlider");
+  }
+
+  const labelProps = () => {
+    const { ref: _ref, ...rest } = context.labelProps as Record<string, unknown>;
+    return rest;
+  };
+
+  return (
+    <label {...domProps} {...labelProps()} class={local.class}>
+      {local.children}
+    </label>
+  );
+}
+
+/**
+ * The output element of a color slider.
+ */
+export function ColorSliderOutput(props: ColorSliderOutputProps): JSX.Element {
+  const [local, domProps] = splitProps(props, ["class", "slot", "children"]);
+
+  const context = useContext(ColorSliderContext);
+  if (!context) {
+    throw new Error("ColorSliderOutput must be used within a ColorSlider");
+  }
+
+  const state = context.state;
+
+  const renderValues = createMemo<ColorSliderRenderProps>(() => ({
+    isDisabled: state.isDisabled,
+    isDragging: state.isDragging,
+    channel: state.channel,
+    orientation: state.orientation,
+    value: state.getThumbValue(),
+    valueLabel: state.getThumbValueLabel(),
+    color: state.value,
+    defaultStyle: (context.trackProps as { style?: JSX.CSSProperties }).style ?? {},
+  }));
+
+  const children = () =>
+    typeof local.children === "function"
+      ? local.children(renderValues())
+      : (local.children ?? renderValues().valueLabel);
+
+  return (
+    <output {...domProps} {...context.outputProps} class={local.class}>
+      {children()}
+    </output>
+  );
+}
+
 /**
  * The track element of a color slider.
  */
 export function ColorSliderTrack(props: ColorSliderTrackProps): JSX.Element {
-  const [local, domProps] = splitProps(props, ['class', 'style', 'slot', 'children']);
+  const [local, domProps] = splitProps(props, ["class", "style", "slot", "children"]);
 
   const context = useContext(ColorSliderContext);
   if (!context) {
-    throw new Error('ColorSliderTrack must be used within a ColorSlider');
+    throw new Error("ColorSliderTrack must be used within a ColorSlider");
   }
 
-  const { state, trackProps, setTrackRef } = context;
+  const state = context.state;
 
-  // Render props values
   const renderValues = createMemo<ColorSliderTrackRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
+    orientation: state.orientation,
+    defaultStyle: (context.trackProps as { style?: JSX.CSSProperties }).style ?? {},
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorSlider-track',
+      defaultClassName: "solidaria-ColorSlider-track",
     },
-    renderValues
+    renderValues,
   );
 
-  // Clean props
   const cleanTrackProps = () => {
-    const { ref: _ref, style: _trackStyle, ...rest } = trackProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _trackStyle,
+      ...rest
+    } = context.trackProps as Record<string, unknown>;
     return rest;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const trackStyle = (trackProps as { style?: Record<string, string> }).style || {};
+    const trackStyle = (context.trackProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...trackStyle, ...renderStyle };
   };
@@ -320,12 +448,13 @@ export function ColorSliderTrack(props: ColorSliderTrackProps): JSX.Element {
   return (
     <div
       {...domProps}
-      ref={setTrackRef}
+      ref={context.setTrackRef}
       {...cleanTrackProps()}
       class={renderProps.class()}
       style={mergedStyle()}
       data-disabled={state.isDisabled || undefined}
       data-dragging={state.isDragging || undefined}
+      data-orientation={state.orientation}
     >
       {renderProps.renderChildren()}
     </div>
@@ -336,48 +465,49 @@ export function ColorSliderTrack(props: ColorSliderTrackProps): JSX.Element {
  * The thumb element of a color slider.
  */
 export function ColorSliderThumb(props: ColorSliderThumbProps): JSX.Element {
-  const [local, domProps] = splitProps(props, ['class', 'style', 'slot', 'children']);
+  const [local, domProps] = splitProps(props, ["class", "style", "slot", "children", "ref"]);
 
   const context = useContext(ColorSliderContext);
   if (!context) {
-    throw new Error('ColorSliderThumb must be used within a ColorSlider');
+    throw new Error("ColorSliderThumb must be used within a ColorSlider");
   }
 
-  const { state, thumbProps, inputProps } = context;
+  const state = context.state;
 
-  // Create focus ring
   const { isFocused, isFocusVisible, focusProps } = createFocusRing();
 
-  // Create hover
   const { isHovered, hoverProps } = createHover({
     get isDisabled() {
       return state.isDisabled;
     },
   });
 
-  // Render props values
   const renderValues = createMemo<ColorSliderThumbRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
     isFocused: isFocused(),
     isFocusVisible: isFocusVisible(),
     isHovered: isHovered(),
+    color: state.getDisplayColor(),
+    defaultStyle: (context.thumbProps as { style?: JSX.CSSProperties }).style ?? {},
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorSlider-thumb',
+      defaultClassName: "solidaria-ColorSlider-thumb",
     },
-    renderValues
+    renderValues,
   );
 
-  // Clean props
   const cleanThumbProps = () => {
-    const { ref: _ref, style: _thumbStyle, ...rest } = thumbProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _thumbStyle,
+      ...rest
+    } = context.thumbProps as Record<string, unknown>;
     return rest;
   };
   const cleanFocusProps = () => {
@@ -390,14 +520,13 @@ export function ColorSliderThumb(props: ColorSliderThumbProps): JSX.Element {
   };
   const mergedInputProps = () => {
     return mergeProps(
-      inputProps as Record<string, unknown>,
-      cleanFocusProps()
+      context.inputProps as Record<string, unknown>,
+      cleanFocusProps(),
     ) as JSX.InputHTMLAttributes<HTMLInputElement>;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const thumbStyle = (thumbProps as { style?: Record<string, string> }).style || {};
+    const thumbStyle = (context.thumbProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...thumbStyle, ...renderStyle };
   };
@@ -407,6 +536,7 @@ export function ColorSliderThumb(props: ColorSliderThumbProps): JSX.Element {
       {...domProps}
       {...cleanThumbProps()}
       {...cleanHoverProps()}
+      ref={local.ref}
       class={renderProps.class()}
       style={mergedStyle()}
       data-disabled={state.isDisabled || undefined}
@@ -415,19 +545,16 @@ export function ColorSliderThumb(props: ColorSliderThumbProps): JSX.Element {
       data-focus-visible={isFocusVisible() || undefined}
       data-hovered={isHovered() || undefined}
     >
-      <input {...mergedInputProps()} />
+      <input ref={context.setInputRef} {...mergedInputProps()} />
       {renderProps.renderChildren()}
     </div>
   );
 }
 
-// Attach sub-components
 ColorSlider.Track = ColorSliderTrack;
 ColorSlider.Thumb = ColorSliderThumb;
-
-// ============================================
-// COLOR AREA
-// ============================================
+ColorSlider.Label = ColorSliderLabel;
+ColorSlider.Output = ColorSliderOutput;
 
 export interface ColorAreaRenderProps {
   /** Whether the area is disabled. */
@@ -440,6 +567,8 @@ export interface ColorAreaRenderProps {
   yChannel: ColorChannel;
   /** The current color. */
   color: Color;
+  /** The default inline styles applied by the color area hook. */
+  defaultStyle: JSX.CSSProperties;
 }
 
 export interface ColorAreaProps extends AriaColorAreaOptions, SlotProps {
@@ -482,6 +611,8 @@ export interface ColorAreaThumbRenderProps {
   isDisabled: boolean;
   /** Whether the thumb is being dragged. */
   isDragging: boolean;
+  /** The current display color. */
+  color: Color;
   /** Whether the thumb is focused. */
   isFocused: boolean;
   /** Whether the thumb has keyboard focus. */
@@ -497,9 +628,10 @@ export interface ColorAreaThumbProps extends SlotProps {
   class?: ClassNameOrFunction<ColorAreaThumbRenderProps>;
   /** The inline style for the element. */
   style?: StyleOrFunction<ColorAreaThumbRenderProps>;
+  /** Ref callback for the thumb element. */
+  ref?: (element: HTMLDivElement) => void;
 }
 
-// Context
 interface ColorAreaContextValue {
   state: ColorAreaState;
   colorAreaProps: JSX.HTMLAttributes<HTMLDivElement>;
@@ -520,9 +652,19 @@ export function ColorArea(props: ColorAreaProps): JSX.Element {
   const pickerContext = useContext(ColorPickerContextInternal);
   const [local, stateProps, ariaProps, rest] = splitProps(
     props,
-    ['children', 'class', 'style', 'slot'],
-    ['value', 'defaultValue', 'onChange', 'onChangeEnd', 'xChannel', 'yChannel'],
-    ['aria-label', 'aria-labelledby', 'aria-describedby', 'isDisabled']
+    ["children", "class", "style", "slot"],
+    ["value", "defaultValue", "onChange", "onChangeEnd", "xChannel", "yChannel", "colorSpace"],
+    [
+      "id",
+      "aria-label",
+      "aria-labelledby",
+      "aria-describedby",
+      "aria-details",
+      "isDisabled",
+      "xName",
+      "yName",
+      "form",
+    ],
   );
 
   // Create color area state
@@ -533,6 +675,7 @@ export function ColorArea(props: ColorAreaProps): JSX.Element {
     onChangeEnd: stateProps.onChangeEnd,
     xChannel: stateProps.xChannel,
     yChannel: stateProps.yChannel,
+    colorSpace: stateProps.colorSpace,
     isDisabled: ariaProps.isDisabled,
   }));
 
@@ -543,55 +686,83 @@ export function ColorArea(props: ColorAreaProps): JSX.Element {
   };
 
   // Create color area aria props
-  const {
-    colorAreaProps,
-    gradientProps,
-    thumbProps,
-    xInputProps,
-    yInputProps,
-  } = createColorArea(
+  const colorAreaAria = createColorArea(
     () => ({
-      'aria-label': ariaProps['aria-label'],
-      'aria-labelledby': ariaProps['aria-labelledby'],
-      'aria-describedby': ariaProps['aria-describedby'],
+      id: ariaProps.id,
+      "aria-label": ariaProps["aria-label"],
+      "aria-labelledby": ariaProps["aria-labelledby"],
+      "aria-describedby": ariaProps["aria-describedby"],
+      "aria-details": ariaProps["aria-details"],
       isDisabled: ariaProps.isDisabled,
+      xName: ariaProps.xName,
+      yName: ariaProps.yName,
+      form: ariaProps.form,
     }),
     () => state,
-    () => areaRef ?? null
+    () => areaRef ?? null,
   );
 
-  // Render props values
   const renderValues = createMemo<ColorAreaRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
     xChannel: state.xChannel,
     yChannel: state.yChannel,
     color: state.value,
+    defaultStyle: (colorAreaAria.colorAreaProps as { style?: JSX.CSSProperties }).style ?? {},
   }));
 
-  // Resolve render props
+  const childRenderValues: ColorAreaRenderProps = {
+    get isDisabled() {
+      return state.isDisabled;
+    },
+    get isDragging() {
+      return state.isDragging;
+    },
+    get xChannel() {
+      return state.xChannel;
+    },
+    get yChannel() {
+      return state.yChannel;
+    },
+    get color() {
+      return state.value;
+    },
+    get defaultStyle() {
+      return (colorAreaAria.colorAreaProps as { style?: JSX.CSSProperties }).style ?? {};
+    },
+  };
+
+  const colorAreaChildren = () => {
+    const children = props.children;
+    return typeof children === "function" ? children(childRenderValues) : children;
+  };
+
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorArea',
+      defaultClassName: "solidaria-ColorArea",
     },
-    renderValues
+    renderValues,
   );
 
-  // Filter DOM props
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }));
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
 
-  // Clean props
   const cleanColorAreaProps = () => {
-    const { ref: _ref, style: _areaStyle, ...rest } = colorAreaProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _areaStyle,
+      ...rest
+    } = colorAreaAria.colorAreaProps as Record<string, unknown>;
     return rest;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const areaStyle = (colorAreaProps as { style?: Record<string, string> }).style || {};
+    const areaStyle =
+      (colorAreaAria.colorAreaProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...areaStyle, ...renderStyle };
   };
@@ -600,11 +771,21 @@ export function ColorArea(props: ColorAreaProps): JSX.Element {
     <ColorAreaContext.Provider
       value={{
         state,
-        colorAreaProps,
-        gradientProps,
-        thumbProps,
-        xInputProps,
-        yInputProps,
+        get colorAreaProps() {
+          return colorAreaAria.colorAreaProps;
+        },
+        get gradientProps() {
+          return colorAreaAria.gradientProps;
+        },
+        get thumbProps() {
+          return colorAreaAria.thumbProps;
+        },
+        get xInputProps() {
+          return colorAreaAria.xInputProps;
+        },
+        get yInputProps() {
+          return colorAreaAria.yInputProps;
+        },
         areaRef,
         setAreaRef,
       }}
@@ -615,10 +796,11 @@ export function ColorArea(props: ColorAreaProps): JSX.Element {
         {...cleanColorAreaProps()}
         class={renderProps.class()}
         style={mergedStyle()}
+        slot={local.slot ?? undefined}
         data-disabled={state.isDisabled || undefined}
         data-dragging={state.isDragging || undefined}
       >
-        {renderProps.renderChildren()}
+        {colorAreaChildren()}
       </div>
     </ColorAreaContext.Provider>
   );
@@ -628,40 +810,40 @@ export function ColorArea(props: ColorAreaProps): JSX.Element {
  * The gradient background of a color area.
  */
 export function ColorAreaGradient(props: ColorAreaGradientProps): JSX.Element {
-  const [local, domProps] = splitProps(props, ['class', 'style', 'slot', 'children']);
+  const [local, domProps] = splitProps(props, ["class", "style", "slot", "children"]);
 
   const context = useContext(ColorAreaContext);
   if (!context) {
-    throw new Error('ColorAreaGradient must be used within a ColorArea');
+    throw new Error("ColorAreaGradient must be used within a ColorArea");
   }
 
-  const { state, gradientProps } = context;
+  const { state } = context;
 
-  // Render props values
   const renderValues = createMemo<ColorAreaGradientRenderProps>(() => ({
     isDisabled: state.isDisabled,
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorArea-gradient',
+      defaultClassName: "solidaria-ColorArea-gradient",
     },
-    renderValues
+    renderValues,
   );
 
-  // Clean props
   const cleanGradientProps = () => {
-    const { ref: _ref, style: _gradStyle, ...rest } = gradientProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _gradStyle,
+      ...rest
+    } = context.gradientProps as Record<string, unknown>;
     return rest;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const gradStyle = (gradientProps as { style?: Record<string, string> }).style || {};
+    const gradStyle = (context.gradientProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...gradStyle, ...renderStyle };
   };
@@ -683,48 +865,50 @@ export function ColorAreaGradient(props: ColorAreaGradientProps): JSX.Element {
  * The thumb element of a color area.
  */
 export function ColorAreaThumb(props: ColorAreaThumbProps): JSX.Element {
-  const [local, domProps] = splitProps(props, ['class', 'style', 'slot', 'children']);
+  const [local, domProps] = splitProps(props, ["class", "style", "slot", "children", "ref"]);
 
   const context = useContext(ColorAreaContext);
   if (!context) {
-    throw new Error('ColorAreaThumb must be used within a ColorArea');
+    throw new Error("ColorAreaThumb must be used within a ColorArea");
   }
 
-  const { state, thumbProps, xInputProps, yInputProps } = context;
+  const { state } = context;
 
-  // Create focus ring
   const { isFocused, isFocusVisible, focusProps } = createFocusRing();
+  let xInputRef: HTMLInputElement | undefined;
+  let yInputRef: HTMLInputElement | undefined;
 
-  // Create hover
   const { isHovered, hoverProps } = createHover({
     get isDisabled() {
       return state.isDisabled;
     },
   });
 
-  // Render props values
   const renderValues = createMemo<ColorAreaThumbRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
+    color: state.getDisplayColor(),
     isFocused: isFocused(),
     isFocusVisible: isFocusVisible(),
     isHovered: isHovered(),
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorArea-thumb',
+      defaultClassName: "solidaria-ColorArea-thumb",
     },
-    renderValues
+    renderValues,
   );
 
-  // Clean props
   const cleanThumbProps = () => {
-    const { ref: _ref, style: _thumbStyle, ...rest } = thumbProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _thumbStyle,
+      ...rest
+    } = context.thumbProps as Record<string, unknown>;
     return rest;
   };
   const cleanFocusProps = () => {
@@ -736,28 +920,44 @@ export function ColorAreaThumb(props: ColorAreaThumbProps): JSX.Element {
     return rest;
   };
   const mergedXInputProps = () => {
-    return mergeProps(
-      xInputProps as Record<string, unknown>,
-      cleanFocusProps()
-    ) as JSX.InputHTMLAttributes<HTMLInputElement>;
+    const { value: _value, ...inputProps } = context.xInputProps as Record<string, unknown>;
+    return mergeProps(inputProps, cleanFocusProps()) as JSX.InputHTMLAttributes<HTMLInputElement>;
   };
   const mergedYInputProps = () => {
-    return mergeProps(
-      yInputProps as Record<string, unknown>,
-      cleanFocusProps()
-    ) as JSX.InputHTMLAttributes<HTMLInputElement>;
+    const { value: _value, ...inputProps } = context.yInputProps as Record<string, unknown>;
+    return mergeProps(inputProps, cleanFocusProps()) as JSX.InputHTMLAttributes<HTMLInputElement>;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const thumbStyle = (thumbProps as { style?: Record<string, string> }).style || {};
+    const thumbStyle = (context.thumbProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...thumbStyle, ...renderStyle };
   };
 
+  const syncInputValue = (input: HTMLInputElement | undefined, value: number) => {
+    const nextValue = String(value);
+    const update = () => {
+      if (input && input.value !== nextValue) {
+        input.value = nextValue;
+      }
+    };
+
+    update();
+    queueMicrotask(update);
+  };
+
+  createEffect(() => {
+    syncInputValue(xInputRef, state.getXValue());
+  });
+
+  createEffect(() => {
+    syncInputValue(yInputRef, state.getYValue());
+  });
+
   return (
     <div
       {...domProps}
+      ref={local.ref}
       {...cleanThumbProps()}
       {...cleanHoverProps()}
       class={renderProps.class()}
@@ -768,21 +968,28 @@ export function ColorAreaThumb(props: ColorAreaThumbProps): JSX.Element {
       data-focus-visible={isFocusVisible() || undefined}
       data-hovered={isHovered() || undefined}
     >
-      <input {...mergedXInputProps()} />
-      <input {...mergedYInputProps()} />
+      <input
+        {...mergedXInputProps()}
+        ref={(el) => {
+          xInputRef = el;
+          syncInputValue(el, state.getXValue());
+        }}
+      />
+      <input
+        {...mergedYInputProps()}
+        ref={(el) => {
+          yInputRef = el;
+          syncInputValue(el, state.getYValue());
+        }}
+      />
       {renderProps.renderChildren()}
     </div>
   );
 }
 
-// Attach sub-components
 ColorArea.Gradient = ColorAreaGradient;
 ColorArea.Thumb = ColorAreaThumb;
 
-// ============================================
-// COLOR WHEEL
-// ============================================
-
 export interface ColorWheelRenderProps {
   /** Whether the wheel is disabled. */
   isDisabled: boolean;
@@ -792,6 +999,8 @@ export interface ColorWheelRenderProps {
   hue: number;
   /** The current color. */
   color: Color;
+  /** The default inline styles applied by the color wheel hook. */
+  defaultStyle: JSX.CSSProperties;
 }
 
 export interface ColorWheelProps extends AriaColorWheelOptions, SlotProps {
@@ -816,6 +1025,8 @@ export interface ColorWheelTrackRenderProps {
   isDisabled: boolean;
   /** Whether the wheel is being dragged. */
   isDragging: boolean;
+  /** The default inline styles applied by the color wheel hook. */
+  defaultStyle: JSX.CSSProperties;
 }
 
 export interface ColorWheelTrackProps extends SlotProps {
@@ -832,12 +1043,16 @@ export interface ColorWheelThumbRenderProps {
   isDisabled: boolean;
   /** Whether the thumb is being dragged. */
   isDragging: boolean;
+  /** The current display color. */
+  color: Color;
   /** Whether the thumb is focused. */
   isFocused: boolean;
   /** Whether the thumb has keyboard focus. */
   isFocusVisible: boolean;
   /** Whether the thumb is hovered. */
   isHovered: boolean;
+  /** The default inline styles applied by the color wheel hook. */
+  defaultStyle: JSX.CSSProperties;
 }
 
 export interface ColorWheelThumbProps extends SlotProps {
@@ -847,9 +1062,10 @@ export interface ColorWheelThumbProps extends SlotProps {
   class?: ClassNameOrFunction<ColorWheelThumbRenderProps>;
   /** The inline style for the element. */
   style?: StyleOrFunction<ColorWheelThumbRenderProps>;
+  /** Ref callback for the thumb element. */
+  ref?: (element: HTMLDivElement) => void;
 }
 
-// Context
 interface ColorWheelContextValue {
   state: ColorWheelState;
   trackProps: JSX.HTMLAttributes<HTMLDivElement>;
@@ -868,9 +1084,21 @@ export function ColorWheel(props: ColorWheelProps): JSX.Element {
   const pickerContext = useContext(ColorPickerContextInternal);
   const [local, stateProps, ariaProps, rest] = splitProps(
     props,
-    ['children', 'class', 'style', 'slot'],
-    ['value', 'defaultValue', 'onChange', 'onChangeEnd'],
-    ['aria-label', 'aria-labelledby', 'aria-describedby', 'isDisabled']
+    ["children", "class", "style", "slot"],
+    ["value", "defaultValue", "onChange", "onChangeEnd"],
+    [
+      "id",
+      "aria-label",
+      "aria-labelledby",
+      "aria-describedby",
+      "aria-details",
+      "aria-errormessage",
+      "isDisabled",
+      "name",
+      "form",
+      "outerRadius",
+      "innerRadius",
+    ],
   );
 
   // Create color wheel state
@@ -882,65 +1110,77 @@ export function ColorWheel(props: ColorWheelProps): JSX.Element {
     isDisabled: ariaProps.isDisabled,
   }));
 
-  // Wheel ref
   let wheelRef: HTMLDivElement | undefined;
   const setWheelRef = (el: HTMLDivElement) => {
     wheelRef = el;
   };
 
   // Create color wheel aria props
-  const {
-    trackProps,
-    thumbProps,
-    inputProps,
-  } = createColorWheel(
+  const colorWheelAria = createColorWheel(
     () => ({
-      'aria-label': ariaProps['aria-label'],
-      'aria-labelledby': ariaProps['aria-labelledby'],
-      'aria-describedby': ariaProps['aria-describedby'],
+      id: ariaProps.id,
+      "aria-label": ariaProps["aria-label"],
+      "aria-labelledby": ariaProps["aria-labelledby"],
+      "aria-describedby": ariaProps["aria-describedby"],
+      "aria-details": ariaProps["aria-details"],
+      "aria-errormessage": ariaProps["aria-errormessage"],
       isDisabled: ariaProps.isDisabled,
+      name: ariaProps.name,
+      form: ariaProps.form,
+      outerRadius: ariaProps.outerRadius,
+      innerRadius: ariaProps.innerRadius,
     }),
     () => state,
-    () => wheelRef ?? null
+    () => wheelRef ?? null,
   );
 
-  // Render props values
   const renderValues = createMemo<ColorWheelRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
     hue: state.getHue(),
     color: state.value,
+    defaultStyle: { position: "relative" },
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorWheel',
+      defaultClassName: "solidaria-ColorWheel",
     },
-    renderValues
+    renderValues,
   );
 
-  // Filter DOM props
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }));
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
 
   return (
     <ColorWheelContext.Provider
       value={{
         state,
-        trackProps,
-        thumbProps,
-        inputProps,
-        wheelRef,
+        get trackProps() {
+          return colorWheelAria.trackProps;
+        },
+        get thumbProps() {
+          return colorWheelAria.thumbProps;
+        },
+        get inputProps() {
+          return colorWheelAria.inputProps;
+        },
+        get wheelRef() {
+          return wheelRef;
+        },
         setWheelRef,
       }}
     >
       <div
+        ref={setWheelRef}
         {...domProps()}
         class={renderProps.class()}
         style={renderProps.style()}
+        slot={local.slot || undefined}
         data-disabled={state.isDisabled || undefined}
         data-dragging={state.isDragging || undefined}
       >
@@ -954,41 +1194,42 @@ export function ColorWheel(props: ColorWheelProps): JSX.Element {
  * The track element of a color wheel.
  */
 export function ColorWheelTrack(props: ColorWheelTrackProps): JSX.Element {
-  const [local, domProps] = splitProps(props, ['class', 'style', 'slot', 'children']);
+  const [local, domProps] = splitProps(props, ["class", "style", "slot", "children"]);
 
   const context = useContext(ColorWheelContext);
   if (!context) {
-    throw new Error('ColorWheelTrack must be used within a ColorWheel');
+    throw new Error("ColorWheelTrack must be used within a ColorWheel");
   }
 
-  const { state, trackProps, setWheelRef } = context;
+  const state = context.state;
 
-  // Render props values
   const renderValues = createMemo<ColorWheelTrackRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
+    defaultStyle: (context.trackProps as { style?: JSX.CSSProperties }).style ?? {},
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorWheel-track',
+      defaultClassName: "solidaria-ColorWheel-track",
     },
-    renderValues
+    renderValues,
   );
 
-  // Clean props
   const cleanTrackProps = () => {
-    const { ref: _ref, style: _trackStyle, ...rest } = trackProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _trackStyle,
+      ...rest
+    } = context.trackProps as Record<string, unknown>;
     return rest;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const trackStyle = (trackProps as { style?: Record<string, string> }).style || {};
+    const trackStyle = (context.trackProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...trackStyle, ...renderStyle };
   };
@@ -996,7 +1237,6 @@ export function ColorWheelTrack(props: ColorWheelTrackProps): JSX.Element {
   return (
     <div
       {...domProps}
-      ref={setWheelRef}
       {...cleanTrackProps()}
       class={renderProps.class()}
       style={mergedStyle()}
@@ -1012,48 +1252,49 @@ export function ColorWheelTrack(props: ColorWheelTrackProps): JSX.Element {
  * The thumb element of a color wheel.
  */
 export function ColorWheelThumb(props: ColorWheelThumbProps): JSX.Element {
-  const [local, domProps] = splitProps(props, ['class', 'style', 'slot', 'children']);
+  const [local, domProps] = splitProps(props, ["class", "style", "slot", "children", "ref"]);
 
   const context = useContext(ColorWheelContext);
   if (!context) {
-    throw new Error('ColorWheelThumb must be used within a ColorWheel');
+    throw new Error("ColorWheelThumb must be used within a ColorWheel");
   }
 
-  const { state, thumbProps, inputProps } = context;
+  const state = context.state;
 
-  // Create focus ring
   const { isFocused, isFocusVisible, focusProps } = createFocusRing();
 
-  // Create hover
   const { isHovered, hoverProps } = createHover({
     get isDisabled() {
       return state.isDisabled;
     },
   });
 
-  // Render props values
   const renderValues = createMemo<ColorWheelThumbRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isDragging: state.isDragging,
+    color: state.getDisplayColor(),
     isFocused: isFocused(),
     isFocusVisible: isFocusVisible(),
     isHovered: isHovered(),
+    defaultStyle: (context.thumbProps as { style?: JSX.CSSProperties }).style ?? {},
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorWheel-thumb',
+      defaultClassName: "solidaria-ColorWheel-thumb",
     },
-    renderValues
+    renderValues,
   );
 
-  // Clean props
   const cleanThumbProps = () => {
-    const { ref: _ref, style: _thumbStyle, ...rest } = thumbProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _thumbStyle,
+      ...rest
+    } = context.thumbProps as Record<string, unknown>;
     return rest;
   };
   const cleanFocusProps = () => {
@@ -1066,14 +1307,13 @@ export function ColorWheelThumb(props: ColorWheelThumbProps): JSX.Element {
   };
   const mergedInputProps = () => {
     return mergeProps(
-      inputProps as Record<string, unknown>,
-      cleanFocusProps()
+      context.inputProps as Record<string, unknown>,
+      cleanFocusProps(),
     ) as JSX.InputHTMLAttributes<HTMLInputElement>;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const thumbStyle = (thumbProps as { style?: Record<string, string> }).style || {};
+    const thumbStyle = (context.thumbProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...thumbStyle, ...renderStyle };
   };
@@ -1081,6 +1321,7 @@ export function ColorWheelThumb(props: ColorWheelThumbProps): JSX.Element {
   return (
     <div
       {...domProps}
+      ref={local.ref}
       {...cleanThumbProps()}
       {...cleanHoverProps()}
       class={renderProps.class()}
@@ -1097,25 +1338,22 @@ export function ColorWheelThumb(props: ColorWheelThumbProps): JSX.Element {
   );
 }
 
-// Attach sub-components
 ColorWheel.Track = ColorWheelTrack;
 ColorWheel.Thumb = ColorWheelThumb;
 
-// ============================================
-// COLOR FIELD
-// ============================================
-
 export interface ColorFieldRenderProps {
   /** Whether the field is disabled. */
   isDisabled: boolean;
   /** Whether the field is read-only. */
   isReadOnly: boolean;
+  /** Whether the field is required. */
+  isRequired: boolean;
   /** Whether the input value is invalid. */
   isInvalid: boolean;
   /** The current color value (null if invalid). */
   color: Color | null;
-  /** The color channel being edited (if single channel mode). */
-  channel: ColorChannel | undefined;
+  /** The color channel being edited, or "hex" for full color mode. */
+  channel: ColorChannel | "hex";
 }
 
 export interface ColorFieldProps extends AriaColorFieldOptions, SlotProps {
@@ -1127,10 +1365,16 @@ export interface ColorFieldProps extends AriaColorFieldOptions, SlotProps {
   onChange?: (color: Color | null) => void;
   /** The color channel to edit (for single channel mode). */
   channel?: ColorChannel;
+  /** The color space to use for channel mode. */
+  colorSpace?: ColorSpace;
   /** The color format for parsing/displaying. */
   colorFormat?: ColorFormat;
   /** A visible label for the field. */
   label?: JSX.Element;
+  /** Description text for the field. */
+  description?: JSX.Element;
+  /** Error message for the field. */
+  errorMessage?: JSX.Element;
   /** The children of the component. */
   children?: RenderChildren<ColorFieldRenderProps>;
   /** The CSS className for the element. */
@@ -1161,13 +1405,18 @@ export interface ColorFieldInputProps extends SlotProps {
   class?: ClassNameOrFunction<ColorFieldInputRenderProps>;
   /** The inline style for the element. */
   style?: StyleOrFunction<ColorFieldInputRenderProps>;
+  /** Ref callback for the input element. */
+  ref?: (element: HTMLInputElement) => void;
 }
 
-// Context
 interface ColorFieldContextValue {
   state: ColorFieldState;
   inputProps: JSX.InputHTMLAttributes<HTMLInputElement>;
   labelProps: JSX.LabelHTMLAttributes<HTMLLabelElement>;
+  descriptionProps: JSX.HTMLAttributes<HTMLElement>;
+  errorMessageProps: JSX.HTMLAttributes<HTMLElement>;
+  setInputRef: (el: HTMLInputElement) => void;
+  setLabelElement: (isPresent: boolean) => void;
 }
 
 export const ColorFieldContext = createContext<ColorFieldContextValue | null>(null);
@@ -1179,92 +1428,218 @@ export function ColorField(props: ColorFieldProps): JSX.Element {
   const pickerContext = useContext(ColorPickerContextInternal);
   const [local, stateProps, ariaProps, rest] = splitProps(
     props,
-    ['children', 'class', 'style', 'slot', 'label'],
-    ['value', 'defaultValue', 'onChange', 'channel', 'colorFormat'],
-    ['aria-label', 'aria-labelledby', 'aria-describedby', 'isDisabled', 'isReadOnly']
+    ["children", "class", "style", "slot", "label", "description", "errorMessage"],
+    ["value", "defaultValue", "onChange", "channel", "colorSpace", "colorFormat"],
+    [
+      "id",
+      "aria-label",
+      "aria-labelledby",
+      "aria-describedby",
+      "aria-details",
+      "aria-errormessage",
+      "name",
+      "form",
+      "isWheelDisabled",
+      "isDisabled",
+      "isReadOnly",
+      "isRequired",
+      "isInvalid",
+      "validationBehavior",
+      "autoFocus",
+      "excludeFromTabOrder",
+      "placeholder",
+    ],
   );
+  const [hasRegisteredLabelElement, setHasRegisteredLabelElement] = createSignal(false);
 
   // Create color field state
   const state = createColorFieldState(() => ({
     value: stateProps.value ?? pickerContext?.value,
     defaultValue: stateProps.defaultValue,
-    onChange: stateProps.onChange ?? ((color) => {
-      if (color) {
-        pickerContext?.onChange?.(color);
-      }
-    }),
+    onChange:
+      stateProps.onChange ??
+      ((color) => {
+        if (color) {
+          pickerContext?.onChange?.(color);
+        }
+      }),
     channel: stateProps.channel,
+    colorSpace: stateProps.colorSpace,
     colorFormat: stateProps.colorFormat,
     isDisabled: ariaProps.isDisabled,
     isReadOnly: ariaProps.isReadOnly,
+    isInvalid: ariaProps.isInvalid,
+    isRequired: ariaProps.isRequired,
   }));
 
   // Input ref
   let inputRef: HTMLInputElement | undefined;
+  const setInputRef = (el: HTMLInputElement) => {
+    inputRef = el;
+  };
 
   // Create color field aria props
-  const {
-    inputProps,
-    labelProps,
-  } = createColorField(
+  const colorFieldAria = createColorField(
     () => ({
-      'aria-label': ariaProps['aria-label'],
-      'aria-labelledby': ariaProps['aria-labelledby'],
-      'aria-describedby': ariaProps['aria-describedby'],
+      id: ariaProps.id,
+      "aria-label": ariaProps["aria-label"],
+      "aria-labelledby": ariaProps["aria-labelledby"],
+      "aria-describedby": ariaProps["aria-describedby"],
+      "aria-details": ariaProps["aria-details"],
+      "aria-errormessage": ariaProps["aria-errormessage"],
+      name: ariaProps.name,
+      form: ariaProps.form,
+      isWheelDisabled: ariaProps.isWheelDisabled,
       isDisabled: ariaProps.isDisabled,
       isReadOnly: ariaProps.isReadOnly,
+      isRequired: ariaProps.isRequired,
+      isInvalid: ariaProps.isInvalid,
+      validationBehavior: ariaProps.validationBehavior,
+      autoFocus: ariaProps.autoFocus,
+      excludeFromTabOrder: ariaProps.excludeFromTabOrder,
+      placeholder: ariaProps.placeholder,
       channel: stateProps.channel,
+      colorSpace: stateProps.colorSpace,
     }),
     () => state,
-    () => inputRef ?? null
+    () => inputRef ?? null,
+  );
+
+  const describedBy = () => {
+    const invalid = ariaProps.isInvalid || state.isInvalid;
+    const ids = [
+      ariaProps["aria-describedby"],
+      local.description && !invalid ? colorFieldAria.descriptionProps.id : undefined,
+      invalid && local.errorMessage ? colorFieldAria.errorMessageProps.id : undefined,
+    ];
+    return ids.filter(Boolean).join(" ") || undefined;
+  };
+
+  const fieldInputProps = () => {
+    const labelledBy =
+      ariaProps["aria-labelledby"] ??
+      (!ariaProps["aria-label"] && (local.label || hasRegisteredLabelElement())
+        ? colorFieldAria.labelProps.id
+        : undefined);
+    return {
+      ...colorFieldAria.inputProps,
+      "aria-label": labelledBy ? undefined : colorFieldAria.inputProps["aria-label"],
+      "aria-labelledby": labelledBy,
+      "aria-describedby": describedBy(),
+      "aria-errormessage":
+        (ariaProps.isInvalid || state.isInvalid) && local.errorMessage
+          ? colorFieldAria.errorMessageProps.id
+          : colorFieldAria.inputProps["aria-errormessage"],
+    } as JSX.InputHTMLAttributes<HTMLInputElement>;
+  };
+
+  const hiddenInputValue = createMemo(() =>
+    Number.isNaN(state.numberValue) ? "" : String(state.numberValue),
   );
 
-  // Render props values
   const renderValues = createMemo<ColorFieldRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isReadOnly: state.isReadOnly,
+    isRequired: state.isRequired,
     isInvalid: state.isInvalid,
     color: state.value,
-    channel: state.channel,
+    channel: state.channel ?? "hex",
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorField',
+      defaultClassName: "solidaria-ColorField",
     },
-    renderValues
+    renderValues,
   );
 
-  // Filter DOM props
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }));
+  const childRenderValues: ColorFieldRenderProps = {
+    get isDisabled() {
+      return state.isDisabled;
+    },
+    get isReadOnly() {
+      return state.isReadOnly;
+    },
+    get isRequired() {
+      return state.isRequired;
+    },
+    get isInvalid() {
+      return state.isInvalid;
+    },
+    get color() {
+      return state.value;
+    },
+    get channel() {
+      return state.channel ?? "hex";
+    },
+  };
+
+  let hasRenderedChildren = false;
+  let renderedChildren: JSX.Element;
+  const renderChildren = () => {
+    if (!hasRenderedChildren) {
+      const children = local.children;
+      renderedChildren =
+        typeof children === "function" ? untrack(() => children(childRenderValues)) : children;
+      hasRenderedChildren = true;
+    }
+    return renderedChildren;
+  };
+
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
 
   return (
     <ColorFieldContext.Provider
       value={{
         state,
-        inputProps,
-        labelProps,
+        get inputProps() {
+          return fieldInputProps();
+        },
+        get labelProps() {
+          return colorFieldAria.labelProps;
+        },
+        get descriptionProps() {
+          return colorFieldAria.descriptionProps;
+        },
+        get errorMessageProps() {
+          return colorFieldAria.errorMessageProps;
+        },
+        setInputRef,
+        setLabelElement: setHasRegisteredLabelElement,
       }}
     >
-      <div
-        {...domProps()}
-        class={renderProps.class()}
-        style={renderProps.style()}
-        data-disabled={state.isDisabled || undefined}
-        data-readonly={state.isReadOnly || undefined}
-        data-invalid={state.isInvalid || undefined}
-      >
-        {/* Label */}
-        <Show when={local.label}>
-          <label {...labelProps}>{local.label}</label>
+      <>
+        <div
+          {...domProps()}
+          class={renderProps.class()}
+          style={renderProps.style()}
+          slot={local.slot ?? undefined}
+          data-disabled={state.isDisabled || undefined}
+          data-readonly={state.isReadOnly || undefined}
+          data-invalid={state.isInvalid || undefined}
+          data-required={state.isRequired || undefined}
+          data-channel={state.channel ?? "hex"}
+        >
+          <Show when={local.label}>
+            <label {...colorFieldAria.labelProps}>{local.label}</label>
+          </Show>
+
+          {renderChildren()}
+        </div>
+        <Show when={state.channel && ariaProps.name}>
+          <input
+            type="hidden"
+            name={ariaProps.name}
+            form={ariaProps.form}
+            value={hiddenInputValue()}
+          />
         </Show>
-
-        {renderProps.renderChildren()}
-      </div>
+      </>
     </ColorFieldContext.Provider>
   );
 }
@@ -1273,26 +1648,24 @@ export function ColorField(props: ColorFieldProps): JSX.Element {
  * The input element of a color field.
  */
 export function ColorFieldInput(props: ColorFieldInputProps): JSX.Element {
-  const [local, domProps] = splitProps(props, ['class', 'style', 'slot', 'children']);
+  const [local, domProps] = splitProps(props, ["class", "style", "slot", "children", "ref"]);
 
   const context = useContext(ColorFieldContext);
   if (!context) {
-    throw new Error('ColorFieldInput must be used within a ColorField');
+    throw new Error("ColorFieldInput must be used within a ColorField");
   }
 
-  const { state, inputProps } = context;
+  const state = context.state;
+  const inputValue = createMemo(() => state.inputValue);
 
-  // Create focus ring
   const { isFocused, isFocusVisible, focusProps } = createFocusRing();
 
-  // Create hover
   const { isHovered, hoverProps } = createHover({
     get isDisabled() {
       return state.isDisabled;
     },
   });
 
-  // Render props values
   const renderValues = createMemo<ColorFieldInputRenderProps>(() => ({
     isDisabled: state.isDisabled,
     isReadOnly: state.isReadOnly,
@@ -1302,20 +1675,23 @@ export function ColorFieldInput(props: ColorFieldInputProps): JSX.Element {
     isHovered: isHovered(),
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorField-input',
+      defaultClassName: "solidaria-ColorField-input",
     },
-    renderValues
+    renderValues,
   );
 
-  // Clean props
   const cleanInputProps = () => {
-    const { ref: _ref, style: _inputStyle, ...rest } = inputProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _inputStyle,
+      value: _value,
+      ...rest
+    } = context.inputProps as Record<string, unknown>;
     return rest;
   };
   const cleanFocusProps = () => {
@@ -1333,8 +1709,13 @@ export function ColorFieldInput(props: ColorFieldInputProps): JSX.Element {
       {...cleanInputProps()}
       {...cleanFocusProps()}
       {...cleanHoverProps()}
+      ref={(el) => {
+        context.setInputRef(el);
+        local.ref?.(el);
+      }}
       class={renderProps.class()}
       style={renderProps.style()}
+      value={inputValue()}
       data-disabled={state.isDisabled || undefined}
       data-readonly={state.isReadOnly || undefined}
       data-invalid={state.isInvalid || undefined}
@@ -1345,13 +1726,8 @@ export function ColorFieldInput(props: ColorFieldInputProps): JSX.Element {
   );
 }
 
-// Attach sub-components
 ColorField.Input = ColorFieldInput;
 
-// ============================================
-// COLOR SWATCH
-// ============================================
-
 export interface ColorSwatchRenderProps {
   /** The color being displayed. */
   color: Color;
@@ -1362,8 +1738,16 @@ export interface ColorSwatchRenderProps {
 export interface ColorSwatchProps extends SlotProps {
   /** The color to display. */
   color?: Color | string;
+  /** Localized color name override. */
+  colorName?: string;
   /** Accessible label for the swatch. */
-  'aria-label'?: string;
+  "aria-label"?: string;
+  /** ID of element that labels the swatch. */
+  "aria-labelledby"?: string;
+  /** ID of element that describes the swatch. */
+  "aria-describedby"?: string;
+  /** ID of element that provides detailed information about the swatch. */
+  "aria-details"?: string;
   /** The children of the component. */
   children?: RenderChildren<ColorSwatchRenderProps>;
   /** The CSS className for the element. */
@@ -1380,63 +1764,61 @@ export function ColorSwatch(props: ColorSwatchProps): JSX.Element {
   const pickerContext = useContext(ColorPickerContextInternal);
   const [local, ariaProps, rest] = splitProps(
     props,
-    ['children', 'class', 'style', 'slot', 'color'],
-    ['aria-label']
+    ["children", "class", "style", "slot", "color", "colorName"],
+    ["aria-label", "aria-labelledby", "aria-describedby", "aria-details"],
   );
 
   const resolvedColor = createMemo<Color | string>(() => {
-    return local.color ?? swatchContext?.color ?? pickerContext?.value ?? '#0000';
+    return local.color ?? swatchContext?.color ?? pickerContext?.value ?? "#fff0";
   });
 
-  // Create color swatch aria props
-  const { swatchProps } = createColorSwatch(() => ({
+  const swatchAria = createColorSwatch(() => ({
+    id: (rest as Record<string, unknown>).id as string | undefined,
+    slot: local.slot,
     color: resolvedColor(),
-    'aria-label': ariaProps['aria-label'],
+    colorName: local.colorName,
+    "aria-label": ariaProps["aria-label"],
+    "aria-labelledby": ariaProps["aria-labelledby"],
+    "aria-describedby": ariaProps["aria-describedby"],
+    "aria-details": ariaProps["aria-details"],
   }));
 
-  // Normalize color
-  const color = createMemo(() => normalizeColor(resolvedColor()));
-
-  // Render props values
   const renderValues = createMemo<ColorSwatchRenderProps>(() => ({
-    color: color(),
-    colorValue: color().toString('css'),
+    color: swatchAria.color,
+    colorValue: swatchAria.color.toString("css"),
   }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorSwatch',
+      defaultClassName: "solidaria-ColorSwatch",
     },
-    renderValues
+    renderValues,
   );
 
-  // Filter DOM props
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }));
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
 
-  // Clean props
   const cleanSwatchProps = () => {
-    const { ref: _ref, style: _swatchStyle, ...rest } = swatchProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      style: _swatchStyle,
+      ...rest
+    } = swatchAria.swatchProps as Record<string, unknown>;
     return rest;
   };
 
-  // Merge styles
   const mergedStyle = () => {
-    const swatchStyle = (swatchProps as { style?: Record<string, string> }).style || {};
+    const swatchStyle = (swatchAria.swatchProps as { style?: Record<string, string> }).style || {};
     const renderStyle = renderProps.style() || {};
     return { ...swatchStyle, ...renderStyle };
   };
 
   return (
-    <div
-      {...domProps()}
-      {...cleanSwatchProps()}
-      class={renderProps.class()}
-      style={mergedStyle()}
-    >
+    <div {...domProps()} {...cleanSwatchProps()} class={renderProps.class()} style={mergedStyle()}>
       {renderProps.renderChildren()}
     </div>
   );
@@ -1481,10 +1863,12 @@ export interface ColorSwatchPickerRenderProps {
   /** The currently selected color. */
   selectedColor: Color;
   /** Item arrangement mode. */
-  layout: 'grid' | 'stack';
+  layout: "grid" | "stack";
 }
 
 export interface ColorSwatchPickerProps extends SlotProps {
+  /** The element's unique identifier. */
+  id?: string;
   /** The current color value (controlled). */
   value?: Color | string;
   /** The default color value (uncontrolled). */
@@ -1492,13 +1876,15 @@ export interface ColorSwatchPickerProps extends SlotProps {
   /** Handler called when the selected color changes. */
   onChange?: (color: Color) => void;
   /** Accessible label for the swatch picker. */
-  'aria-label'?: string;
+  "aria-label"?: string;
   /** ID of element that labels the swatch picker. */
-  'aria-labelledby'?: string;
+  "aria-labelledby"?: string;
   /** ID of element that describes the swatch picker. */
-  'aria-describedby'?: string;
+  "aria-describedby"?: string;
+  /** ID of element that provides detailed information about the swatch picker. */
+  "aria-details"?: string;
   /** Whether swatches are arranged as a grid or stack. */
-  layout?: 'grid' | 'stack';
+  layout?: "grid" | "stack";
   /** The children (ColorSwatchPickerItem elements). */
   children?: JSX.Element;
   /** The CSS className for the element. */
@@ -1528,7 +1914,7 @@ export interface ColorSwatchPickerItemProps extends SlotProps {
   /** Whether this item is disabled. */
   isDisabled?: boolean;
   /** Accessible label for this item. */
-  'aria-label'?: string;
+  "aria-label"?: string;
   /** The children of the swatch item. */
   children?: RenderChildren<ColorSwatchPickerItemRenderProps>;
   /** The CSS className for the element. */
@@ -1539,17 +1925,17 @@ export interface ColorSwatchPickerItemProps extends SlotProps {
 
 export function ColorPicker(props: ColorPickerProps): JSX.Element {
   const [local] = splitProps(props, [
-    'value',
-    'defaultValue',
-    'onChange',
-    'children',
-    'class',
-    'style',
-    'slot',
+    "value",
+    "defaultValue",
+    "onChange",
+    "children",
+    "class",
+    "style",
+    "slot",
   ]);
 
   const [internalColor, setInternalColor] = createSignal<Color>(
-    normalizeColor(local.defaultValue ?? '#ff0000')
+    normalizeColor(local.defaultValue ?? "#ff0000"),
   );
 
   const color = createMemo<Color>(() => {
@@ -1575,9 +1961,9 @@ export function ColorPicker(props: ColorPickerProps): JSX.Element {
       children: local.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorPicker',
+      defaultClassName: "solidaria-ColorPicker",
     },
-    renderValues
+    renderValues,
   );
 
   return (
@@ -1606,23 +1992,25 @@ export function ColorPicker(props: ColorPickerProps): JSX.Element {
 export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
   const pickerContext = useContext(ColorPickerContextInternal);
   const [local, rest] = splitProps(props, [
-    'value',
-    'defaultValue',
-    'onChange',
-    'aria-label',
-    'aria-labelledby',
-    'aria-describedby',
-    'layout',
-    'children',
-    'class',
-    'style',
-    'slot',
+    "value",
+    "defaultValue",
+    "onChange",
+    "id",
+    "aria-label",
+    "aria-labelledby",
+    "aria-describedby",
+    "aria-details",
+    "layout",
+    "children",
+    "class",
+    "style",
+    "slot",
   ]);
 
   const [itemMap, setItemMap] = createSignal<Map<string, ColorSwatchPickerItemData>>(new Map());
   const [itemOrder, setItemOrder] = createSignal<string[]>([]);
   const [internalColor, setInternalColor] = createSignal<Color>(
-    normalizeColor(local.defaultValue ?? pickerContext?.value ?? '#ff0000')
+    normalizeColor(local.defaultValue ?? pickerContext?.value ?? "#ff0000"),
   );
 
   const selectedColor = createMemo<Color>(() => {
@@ -1635,8 +2023,10 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
     return internalColor();
   });
 
-  const selectedKey = createMemo(() => selectedColor().toString('hexa'));
-  const isControlled = createMemo(() => local.value !== undefined || pickerContext?.value !== undefined);
+  const selectedKey = createMemo(() => selectedColor().toString("hexa"));
+  const isControlled = createMemo(
+    () => local.value !== undefined || pickerContext?.value !== undefined,
+  );
 
   const registerItem = (item: ColorSwatchPickerItemData) => {
     setItemMap((prev) => {
@@ -1677,13 +2067,13 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
     get getDisabled() {
       return (item: ColorSwatchPickerItemData) => !!item.isDisabled;
     },
-    selectionMode: 'single',
+    selectionMode: "single",
     disallowEmptySelection: true,
     get selectedKeys() {
       return [selectedKey()];
     },
     onSelectionChange(keys) {
-      if (keys === 'all') return;
+      if (keys === "all") return;
       const key = keys.values().next().value as string | undefined;
       if (!key) return;
       const item = itemMap().get(key);
@@ -1697,28 +2087,31 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
 
   const listBoxAria = createListBox(
     () => ({
-      'aria-label': local['aria-label'] ?? (!local['aria-labelledby'] ? 'Color swatch picker' : undefined),
-      'aria-labelledby': local['aria-labelledby'],
-      'aria-describedby': local['aria-describedby'],
+      id: local.id,
+      "aria-label":
+        local["aria-label"] ?? (!local["aria-labelledby"] ? "Color swatch picker" : undefined),
+      "aria-labelledby": local["aria-labelledby"],
+      "aria-describedby": local["aria-describedby"],
+      "aria-details": local["aria-details"],
       shouldFocusWrap: true,
     }),
-    state
+    state,
   );
 
-  const resolveDirection = (): 'ltr' | 'rtl' => {
-    if (typeof document === 'undefined') return 'ltr';
+  const resolveDirection = (): "ltr" | "rtl" => {
+    if (typeof document === "undefined") return "ltr";
     const rootDir = document.dir;
-    return rootDir === 'rtl' ? 'rtl' : 'ltr';
+    return rootDir === "rtl" ? "rtl" : "ltr";
   };
 
-  const findNextEnabledKey = (from: Key | null, direction: 'next' | 'prev') => {
+  const findNextEnabledKey = (from: Key | null, direction: "next" | "prev") => {
     const collection = state.collection();
-    const getAdjacent = direction === 'next'
-      ? (key: Key) => collection.getKeyAfter(key)
-      : (key: Key) => collection.getKeyBefore(key);
-    const getBoundary = direction === 'next'
-      ? () => collection.getFirstKey()
-      : () => collection.getLastKey();
+    const getAdjacent =
+      direction === "next"
+        ? (key: Key) => collection.getKeyAfter(key)
+        : (key: Key) => collection.getKeyBefore(key);
+    const getBoundary =
+      direction === "next" ? () => collection.getFirstKey() : () => collection.getLastKey();
 
     let key = from != null ? getAdjacent(from) : getBoundary();
     while (key != null && state.isDisabled(key)) {
@@ -1728,14 +2121,14 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
     return key;
   };
 
-  const getBoundaryEnabledKey = (direction: 'next' | 'prev') => {
+  const getBoundaryEnabledKey = (direction: "next" | "prev") => {
     const collection = state.collection();
-    const getAdjacent = direction === 'next'
-      ? (key: Key) => collection.getKeyAfter(key)
-      : (key: Key) => collection.getKeyBefore(key);
-    const getBoundary = direction === 'next'
-      ? () => collection.getFirstKey()
-      : () => collection.getLastKey();
+    const getAdjacent =
+      direction === "next"
+        ? (key: Key) => collection.getKeyAfter(key)
+        : (key: Key) => collection.getKeyBefore(key);
+    const getBoundary =
+      direction === "next" ? () => collection.getFirstKey() : () => collection.getLastKey();
 
     let key = getBoundary();
     while (key != null && state.isDisabled(key)) {
@@ -1745,7 +2138,10 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
     return key;
   };
 
-  const getOptionElementForKey = (listbox: HTMLElement | null, key: Key | null): HTMLElement | null => {
+  const getOptionElementForKey = (
+    listbox: HTMLElement | null,
+    key: Key | null,
+  ): HTMLElement | null => {
     if (!listbox || key == null) return null;
     const keyString = String(key);
     for (const optionElement of listbox.querySelectorAll<HTMLElement>('[role="option"]')) {
@@ -1760,7 +2156,7 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
     listbox: HTMLElement | null,
     key: Key,
     nextKey: (current: Key) => Key | null,
-    shouldSkip: (prevRect: DOMRect, itemRect: DOMRect) => boolean
+    shouldSkip: (prevRect: DOMRect, itemRect: DOMRect) => boolean,
   ): Key | null => {
     let candidate: Key | null = key;
     const previousRect = getOptionElementForKey(listbox, candidate)?.getBoundingClientRect();
@@ -1787,53 +2183,69 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
     return null;
   };
 
-  const isSameRow = (prevRect: DOMRect, itemRect: DOMRect) => prevRect.y === itemRect.y || prevRect.x !== itemRect.x;
+  const isSameRow = (prevRect: DOMRect, itemRect: DOMRect) =>
+    prevRect.y === itemRect.y || prevRect.x !== itemRect.x;
   const getGridKeyBelow = (listbox: HTMLElement | null, key: Key) =>
-    findGridKey(listbox, key, (current) => findNextEnabledKey(current, 'next'), isSameRow);
+    findGridKey(listbox, key, (current) => findNextEnabledKey(current, "next"), isSameRow);
   const getGridKeyAbove = (listbox: HTMLElement | null, key: Key) =>
-    findGridKey(listbox, key, (current) => findNextEnabledKey(current, 'prev'), isSameRow);
+    findGridKey(listbox, key, (current) => findNextEnabledKey(current, "prev"), isSameRow);
   const getGridKeyRightOf = (key: Key) =>
-    resolveDirection() === 'rtl' ? findNextEnabledKey(key, 'prev') : findNextEnabledKey(key, 'next');
+    resolveDirection() === "rtl"
+      ? findNextEnabledKey(key, "prev")
+      : findNextEnabledKey(key, "next");
   const getGridKeyLeftOf = (key: Key) =>
-    resolveDirection() === 'rtl' ? findNextEnabledKey(key, 'next') : findNextEnabledKey(key, 'prev');
+    resolveDirection() === "rtl"
+      ? findNextEnabledKey(key, "next")
+      : findNextEnabledKey(key, "prev");
 
   const handleGridKeyDown = (e: KeyboardEvent): boolean => {
-    if ((local.layout ?? 'grid') !== 'grid') return false;
-    if (e.key !== 'ArrowRight' && e.key !== 'ArrowLeft' && e.key !== 'ArrowDown' && e.key !== 'ArrowUp') {
+    if ((local.layout ?? "grid") !== "grid") return false;
+    if (
+      e.key !== "ArrowRight" &&
+      e.key !== "ArrowLeft" &&
+      e.key !== "ArrowDown" &&
+      e.key !== "ArrowUp"
+    ) {
       return false;
     }
 
     const listbox = e.currentTarget as HTMLElement | null;
     const focusedKey = state.focusedKey();
-    const initialKey = focusedKey ?? (e.key === 'ArrowUp' || e.key === 'ArrowLeft'
-      ? getBoundaryEnabledKey('prev')
-      : getBoundaryEnabledKey('next'));
+    const initialKey =
+      focusedKey ??
+      (e.key === "ArrowUp" || e.key === "ArrowLeft"
+        ? getBoundaryEnabledKey("prev")
+        : getBoundaryEnabledKey("next"));
     if (initialKey == null) return false;
 
     let nextKey: Key | null = null;
     switch (e.key) {
-      case 'ArrowDown':
-        nextKey = getGridKeyBelow(listbox, initialKey) ?? getBoundaryEnabledKey('next');
+      case "ArrowDown":
+        nextKey = getGridKeyBelow(listbox, initialKey) ?? getBoundaryEnabledKey("next");
         break;
-      case 'ArrowUp':
-        nextKey = getGridKeyAbove(listbox, initialKey) ?? getBoundaryEnabledKey('prev');
+      case "ArrowUp":
+        nextKey = getGridKeyAbove(listbox, initialKey) ?? getBoundaryEnabledKey("prev");
         break;
-      case 'ArrowRight':
-        nextKey = getGridKeyRightOf(initialKey) ?? (
-          resolveDirection() === 'rtl' ? getBoundaryEnabledKey('prev') : getBoundaryEnabledKey('next')
-        );
+      case "ArrowRight":
+        nextKey =
+          getGridKeyRightOf(initialKey) ??
+          (resolveDirection() === "rtl"
+            ? getBoundaryEnabledKey("prev")
+            : getBoundaryEnabledKey("next"));
         break;
-      case 'ArrowLeft':
-        nextKey = getGridKeyLeftOf(initialKey) ?? (
-          resolveDirection() === 'rtl' ? getBoundaryEnabledKey('next') : getBoundaryEnabledKey('prev')
-        );
+      case "ArrowLeft":
+        nextKey =
+          getGridKeyLeftOf(initialKey) ??
+          (resolveDirection() === "rtl"
+            ? getBoundaryEnabledKey("next")
+            : getBoundaryEnabledKey("prev"));
         break;
     }
 
     if (nextKey == null) return false;
 
     state.setFocusedKey(nextKey);
-    if (state.selectionMode() === 'single') {
+    if (state.selectionMode() === "single") {
       state.replaceSelection(nextKey);
     }
 
@@ -1862,25 +2274,31 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
   });
 
   const { isFocused, isFocusVisible, focusProps } = createFocusRing({ within: true });
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }));
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
   const renderValues = createMemo<ColorSwatchPickerRenderProps>(() => ({
     isFocused: state.isFocused() || isFocused(),
     isFocusVisible: isFocusVisible(),
     selectedColor: selectedColor(),
-    layout: local.layout ?? 'grid',
+    layout: local.layout ?? "grid",
   }));
 
   const renderProps = useRenderProps(
     {
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorSwatchPicker',
+      defaultClassName: "solidaria-ColorSwatchPicker",
     },
-    renderValues
+    renderValues,
   );
 
   const cleanListBoxProps = () => {
-    const { ref: _ref, onKeyDown: _onKeyDown, ...restListBoxProps } = listBoxAria.listBoxProps as Record<string, unknown>;
+    const {
+      ref: _ref,
+      onKeyDown: _onKeyDown,
+      ...restListBoxProps
+    } = listBoxAria.listBoxProps as Record<string, unknown>;
     return restListBoxProps;
   };
   const cleanFocusProps = () => {
@@ -1897,12 +2315,15 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
       }}
     >
       <div
-        {...mergeProps(domProps(), cleanListBoxProps(), cleanFocusProps(), { onKeyDown: onColorSwatchPickerKeyDown })}
+        {...mergeProps(domProps(), cleanListBoxProps(), cleanFocusProps(), {
+          onKeyDown: onColorSwatchPickerKeyDown,
+        })}
         class={renderProps.class()}
         style={renderProps.style()}
+        slot={local.slot ?? undefined}
         data-focused={state.isFocused() || undefined}
         data-focus-visible={isFocusVisible() || undefined}
-        data-layout={local.layout ?? 'grid'}
+        data-layout={local.layout ?? "grid"}
       >
         {local.children}
       </div>
@@ -1913,19 +2334,19 @@ export function ColorSwatchPicker(props: ColorSwatchPickerProps): JSX.Element {
 export function ColorSwatchPickerItem(props: ColorSwatchPickerItemProps): JSX.Element {
   const context = useContext(ColorSwatchPickerContextInternal);
   if (!context) {
-    throw new Error('ColorSwatchPickerItem must be used within a ColorSwatchPicker');
+    throw new Error("ColorSwatchPickerItem must be used within a ColorSwatchPicker");
   }
 
   const [local, ariaProps, rest] = splitProps(
     props,
-    ['children', 'class', 'style', 'slot', 'color'],
-    ['isDisabled', 'aria-label']
+    ["children", "class", "style", "slot", "color"],
+    ["isDisabled", "aria-label"],
   );
 
   const color = createMemo(() => normalizeColor(local.color));
-  const key = createMemo(() => color().toString('hexa'));
+  const key = createMemo(() => color().toString("hexa"));
   const textValue = createMemo(() => {
-    const locale = globalThis.navigator?.language ?? 'en-US';
+    const locale = globalThis.navigator?.language ?? "en-US";
     return color().getColorName(locale);
   });
 
@@ -1944,9 +2365,9 @@ export function ColorSwatchPickerItem(props: ColorSwatchPickerItemProps): JSX.El
     () => ({
       key: key(),
       isDisabled: ariaProps.isDisabled,
-      'aria-label': ariaProps['aria-label'] ?? textValue(),
+      "aria-label": ariaProps["aria-label"] ?? textValue(),
     }),
-    context.state
+    context.state,
   );
 
   const renderValues = createMemo<ColorSwatchPickerItemRenderProps>(() => ({
@@ -1963,12 +2384,14 @@ export function ColorSwatchPickerItem(props: ColorSwatchPickerItemProps): JSX.El
       children: local.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-ColorSwatchPickerItem',
+      defaultClassName: "solidaria-ColorSwatchPickerItem",
     },
-    renderValues
+    renderValues,
   );
 
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }));
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
   const cleanOptionProps = () => {
     const { ref: _ref, ...restOptionProps } = optionAria.optionProps as Record<string, unknown>;
     return restOptionProps;