@skdx/react 0.26.0 → 0.28.0

package/dist/color-picker/index.d.cts

@@ -1,13 +1,2 @@
 export { ColorPicker } from './ColorPicker.cjs';
-export { ColorPickerArea } from './ColorPickerArea.cjs';
-export { ColorPickerAreaThumb } from './ColorPickerAreaThumb.cjs';
-export { ColorPickerHueSlider } from './ColorPickerHueSlider.cjs';
-export { ColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.cjs';
-export { ColorPickerAlphaSlider } from './ColorPickerAlphaSlider.cjs';
-export { ColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.cjs';
-export { ColorPickerSwatchGroup } from './ColorPickerSwatchGroup.cjs';
-export { ColorPickerSwatch } from './ColorPickerSwatch.cjs';
-export { ColorPickerInput } from './ColorPickerInput.cjs';
-export { ColorPickerFormatSelect } from './ColorPickerFormatSelect.cjs';
-export { ColorPickerEyeDropper } from './ColorPickerEyeDropper.cjs';
-export type { ColorChannel, ColorPickerProps, ColorPickerAreaProps, ColorPickerAreaThumbProps, ColorPickerHueSliderProps, ColorPickerHueSliderThumbProps, ColorPickerAlphaSliderProps, ColorPickerAlphaSliderThumbProps, ColorPickerSwatchGroupProps, ColorPickerSwatchProps, ColorPickerInputProps, ColorPickerFormatSelectProps, ColorPickerEyeDropperProps, } from './types.cjs';
+export type { ColorChannel, ColorPickerProps } from './types.cjs';

package/dist/color-picker/index.d.ts

@@ -1,13 +1,2 @@
 export { ColorPicker } from './ColorPicker.js';
-export { ColorPickerArea } from './ColorPickerArea.js';
-export { ColorPickerAreaThumb } from './ColorPickerAreaThumb.js';
-export { ColorPickerHueSlider } from './ColorPickerHueSlider.js';
-export { ColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.js';
-export { ColorPickerAlphaSlider } from './ColorPickerAlphaSlider.js';
-export { ColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.js';
-export { ColorPickerSwatchGroup } from './ColorPickerSwatchGroup.js';
-export { ColorPickerSwatch } from './ColorPickerSwatch.js';
-export { ColorPickerInput } from './ColorPickerInput.js';
-export { ColorPickerFormatSelect } from './ColorPickerFormatSelect.js';
-export { ColorPickerEyeDropper } from './ColorPickerEyeDropper.js';
-export type { ColorChannel, ColorPickerProps, ColorPickerAreaProps, ColorPickerAreaThumbProps, ColorPickerHueSliderProps, ColorPickerHueSliderThumbProps, ColorPickerAlphaSliderProps, ColorPickerAlphaSliderThumbProps, ColorPickerSwatchGroupProps, ColorPickerSwatchProps, ColorPickerInputProps, ColorPickerFormatSelectProps, ColorPickerEyeDropperProps, } from './types.js';
+export type { ColorChannel, ColorPickerProps } from './types.js';

package/dist/color-picker/primitives.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Advanced primitives for `ColorPicker`.
+ *
+ * @example
+ * ```tsx
+ * import { ColorPicker, ColorPickerAlphaSlider, ColorPickerAlphaSliderThumb, ColorPickerArea, ColorPickerAreaThumb, ColorPickerEyeDropper, ColorPickerHueSlider, ColorPickerHueSliderThumb, ColorPickerInput } from '@skdx/react/primitives/color-picker';
+ *
+ * <ColorPicker defaultValue="#d94c4c">
+ *   <ColorPickerArea>
+ *     <ColorPickerAreaThumb />
+ *   </ColorPickerArea>
+ *   <ColorPickerHueSlider>
+ *     <ColorPickerHueSliderThumb />
+ *   </ColorPickerHueSlider>
+ *   <ColorPickerAlphaSlider>
+ *     <ColorPickerAlphaSliderThumb />
+ *   </ColorPickerAlphaSlider>
+ *   <ColorPickerInput />
+ *   <ColorPickerEyeDropper />
+ * </ColorPicker>
+ * ```
+ */
+export { ColorPicker } from './ColorPicker.cjs';
+export { ColorPickerArea } from './ColorPickerArea.cjs';
+export { ColorPickerAreaThumb } from './ColorPickerAreaThumb.cjs';
+export { ColorPickerHueSlider } from './ColorPickerHueSlider.cjs';
+export { ColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.cjs';
+export { ColorPickerAlphaSlider } from './ColorPickerAlphaSlider.cjs';
+export { ColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.cjs';
+export { ColorPickerSwatchGroup } from './ColorPickerSwatchGroup.cjs';
+export { ColorPickerSwatch } from './ColorPickerSwatch.cjs';
+export { ColorPickerInput } from './ColorPickerInput.cjs';
+export { ColorPickerFormatSelect } from './ColorPickerFormatSelect.cjs';
+export { ColorPickerEyeDropper } from './ColorPickerEyeDropper.cjs';
+export type { ColorChannel, ColorPickerProps, ColorPickerAreaProps, ColorPickerAreaThumbProps, ColorPickerHueSliderProps, ColorPickerHueSliderThumbProps, ColorPickerAlphaSliderProps, ColorPickerAlphaSliderThumbProps, ColorPickerSwatchGroupProps, ColorPickerSwatchProps, ColorPickerInputProps, ColorPickerFormatSelectProps, ColorPickerEyeDropperProps, } from './types.cjs';

package/dist/color-picker/primitives.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Advanced primitives for `ColorPicker`.
+ *
+ * @example
+ * ```tsx
+ * import { ColorPicker, ColorPickerAlphaSlider, ColorPickerAlphaSliderThumb, ColorPickerArea, ColorPickerAreaThumb, ColorPickerEyeDropper, ColorPickerHueSlider, ColorPickerHueSliderThumb, ColorPickerInput } from '@skdx/react/primitives/color-picker';
+ *
+ * <ColorPicker defaultValue="#d94c4c">
+ *   <ColorPickerArea>
+ *     <ColorPickerAreaThumb />
+ *   </ColorPickerArea>
+ *   <ColorPickerHueSlider>
+ *     <ColorPickerHueSliderThumb />
+ *   </ColorPickerHueSlider>
+ *   <ColorPickerAlphaSlider>
+ *     <ColorPickerAlphaSliderThumb />
+ *   </ColorPickerAlphaSlider>
+ *   <ColorPickerInput />
+ *   <ColorPickerEyeDropper />
+ * </ColorPicker>
+ * ```
+ */
+export { ColorPicker } from './ColorPicker.js';
+export { ColorPickerArea } from './ColorPickerArea.js';
+export { ColorPickerAreaThumb } from './ColorPickerAreaThumb.js';
+export { ColorPickerHueSlider } from './ColorPickerHueSlider.js';
+export { ColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.js';
+export { ColorPickerAlphaSlider } from './ColorPickerAlphaSlider.js';
+export { ColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.js';
+export { ColorPickerSwatchGroup } from './ColorPickerSwatchGroup.js';
+export { ColorPickerSwatch } from './ColorPickerSwatch.js';
+export { ColorPickerInput } from './ColorPickerInput.js';
+export { ColorPickerFormatSelect } from './ColorPickerFormatSelect.js';
+export { ColorPickerEyeDropper } from './ColorPickerEyeDropper.js';
+export type { ColorChannel, ColorPickerProps, ColorPickerAreaProps, ColorPickerAreaThumbProps, ColorPickerHueSliderProps, ColorPickerHueSliderThumbProps, ColorPickerAlphaSliderProps, ColorPickerAlphaSliderThumbProps, ColorPickerSwatchGroupProps, ColorPickerSwatchProps, ColorPickerInputProps, ColorPickerFormatSelectProps, ColorPickerEyeDropperProps, } from './types.js';

package/dist/color-picker/types.d.cts

@@ -29,11 +29,14 @@ export type ColorChannel = 'hex' | 'red' | 'green' | 'blue' | 'hue' | 'saturatio
 /** Props for the {@link ColorPicker} root. */
 export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Current colour as a string in the active `format`, for controlled usage.
-     * Pair with `onValueChange`. Anything {@link parseColor} understands is
-     * accepted regardless of `format`; an unparseable string is ignored and the
-     * last good colour is kept, because a half-typed `#ab` should not blank the
-     * picker.
+     * Composed parts for full control over anatomy. Omitted, the picker derives the area,
+     * tracks, input, and swatches from the show* and swatches props.
+     * @default undefined — the picker derives its anatomy.
+     */
+    children?: React.ReactNode;
+    /**
+     * Current colour for controlled usage. Pair with `onValueChange`. Accepts
+     * any {@link parseColor} notation; unparseable input keeps the last colour.
      * @default undefined — uncontrolled, tracks its own colour internally.
      */
     value?: string;
@@ -43,37 +46,21 @@ export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'on
      */
     defaultValue?: string;
     /**
-     * Fires with the new string on every change: each arrow key, each frame of a
-     * drag that moves the colour, each swatch click — and also on a `format`
-     * change, because the string genuinely changed even though the colour did not.
+     * Fires with the new string on every change: arrow keys, drag frames,
+     * swatch clicks, and format switches; suppressed when the string doesn't change.
      * @default undefined — no-op if omitted.
      */
     onValueChange?: (value: string) => void;
     /**
-     * Fires once with the final string when a pointer drag ends (release or
-     * cancel). This is the callback to hang an expensive effect on: a drag emits
-     * `onValueChange` per frame and this one exactly once, so a consumer can
-     * repaint continuously without also making a network call per frame.
-     *
-     * Keyboard and click changes do not fire it — each is already a discrete
-     * commit, reported by `onValueChange`.
+     * Fires once with the final string when a pointer drag ends. Use for
+     * expensive effects; `onValueChange` fires per frame but this fires once.
+     * Keyboard and click changes do not fire it.
      * @default undefined — no-op if omitted.
      */
     onValueCommit?: (value: string) => void;
-    /**
-     * Previous name for `onValueCommit`, kept so 0.20 code keeps working.
-     * @deprecated Renamed to `onValueCommit` in 0.21. The contract, Vue and Web
-     * Components have always called this `value-commit`, and React's own
-     * `Slider`/`Editable` already spelled it `onValueCommit` — only
-     * `AngleSlider` and `ColorPicker` used `onValueChangeEnd`. Still honoured
-     * when `onValueCommit` is not supplied; it will be removed in 0.22.
-     * @default undefined — no-op if omitted.
-     */
-    onValueChangeEnd?: (value: string) => void;
     /**
      * Notation `value` is written in, for controlled usage. Pair with
-     * `onFormatChange`. The colour itself is stored as HSB whatever this says;
-     * the format only decides how it is spelled on the way out.
+     * `onFormatChange`. Colour is stored as HSB; format only decides spelling.
      * @default undefined — uncontrolled, tracks its own format internally.
      */
     format?: ColorFormat;
@@ -90,15 +77,13 @@ export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'on
     onFormatChange?: (format: ColorFormat) => void;
     /**
      * Whether the picker has an alpha channel. When `false`, `ColorPickerAlphaSlider`
-     * renders nothing and every emitted string is fully opaque — so a consumer
-     * that cannot handle transparency never receives an `rgba()` it must strip.
+     * renders nothing and every emitted string is fully opaque.
      * @default true
      */
     alpha?: boolean;
     /**
-     * Keyboard increment, in the units of whichever channel is being stepped:
-     * percentage points for saturation/brightness/alpha, degrees for hue. Shift
-     * multiplies it by ten, so a 1-unit picker still has a coarse gear.
+     * Keyboard increment in channel units: percent for saturation/brightness/alpha,
+     * degrees for hue. Shift multiplies by ten.
      * @default 1 — every whole unit is reachable without a pointer.
      */
     step?: number;
@@ -115,6 +100,29 @@ export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'on
      * @default false
      */
     readOnly?: boolean;
+    /**
+     * Whether to render a {@link ColorPickerInput}. Ignored when `children` is given.
+     * @default true
+     */
+    showInput?: boolean;
+    /**
+     * Whether to render a {@link ColorPickerSwatchGroup}. Ignored when `children`
+     * is given or `swatches` is empty.
+     * @default true
+     */
+    showSwatches?: boolean;
+    /**
+     * Whether to render a {@link ColorPickerEyeDropper} trigger.
+     * Ignored when `children` is given.
+     * @default true
+     */
+    showEyeDropper?: boolean;
+    /**
+     * Preset colours the derived anatomy renders as {@link ColorPickerSwatch}
+     * parts, one per entry. Ignored when `children` is given or `showSwatches` is `false`.
+     * @default [] — no swatches rendered.
+     */
+    swatches?: string[];
 }
 /** Props for the {@link ColorPickerArea}, the 2D saturation/brightness surface. */
 export interface ColorPickerAreaProps extends PrimitivePropsWithRef<'div'> {
@@ -128,12 +136,12 @@ export interface ColorPickerAreaProps extends PrimitivePropsWithRef<'div'> {
  */
 export interface ColorPickerAreaThumbProps extends Omit<PrimitivePropsWithRef<'div'>, 'asChild'> {
     /**
-     * Accessible name of the horizontal axis, which is a `role="slider"` of its own.
+     * Accessible name of the horizontal saturation slider.
      * @default 'Saturation'
      */
     saturationLabel?: string;
     /**
-     * Accessible name of the vertical axis, which is a second `role="slider"`.
+     * Accessible name of the vertical brightness slider.
      * @default 'Brightness'
      */
     brightnessLabel?: string;
@@ -141,8 +149,13 @@ export interface ColorPickerAreaThumbProps extends Omit<PrimitivePropsWithRef<'d
 /** Props for the {@link ColorPickerHueSlider}, the 0–360° hue track. */
 export interface ColorPickerHueSliderProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Axis the track runs along, which decides whether pointer position is read
-     * from `clientX` or `clientY` and is published as `data-orientation`.
+     * Accessible name of the slider. A prop, not just `aria-label`, so a
+     * localised UI doesn't need to reach past the component's API to translate it.
+     * @default 'Hue'
+     */
+    label?: string;
+    /**
+     * Axis the track runs along: `clientX`/`clientY` for horizontal/vertical.
      * Vertical tracks run bottom-to-top, matching `Slider`.
      * @default 'horizontal'
      */
@@ -154,8 +167,13 @@ export interface ColorPickerHueSliderThumbProps extends PrimitivePropsWithRef<'d
 /** Props for the {@link ColorPickerAlphaSlider}, the 0–100% opacity track. */
 export interface ColorPickerAlphaSliderProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Axis the track runs along, which decides whether pointer position is read
-     * from `clientX` or `clientY` and is published as `data-orientation`.
+     * Accessible name of the slider. A prop, not just `aria-label`, so a
+     * localised UI doesn't need to reach past the component's API to translate it.
+     * @default 'Opacity'
+     */
+    label?: string;
+    /**
+     * Axis the track runs along: `clientX`/`clientY` for horizontal/vertical.
      * Vertical tracks run bottom-to-top, matching `Slider`.
      * @default 'horizontal'
      */
@@ -167,7 +185,7 @@ export interface ColorPickerAlphaSliderThumbProps extends PrimitivePropsWithRef<
 /** Props for the {@link ColorPickerSwatchGroup}, the container for preset swatches. */
 export interface ColorPickerSwatchGroupProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Whether arrow-key navigation wraps from the last swatch back to the first.
+     * Whether arrow-key navigation wraps from the last swatch to the first.
      * @default true
      */
     loop?: boolean;
@@ -175,18 +193,16 @@ export interface ColorPickerSwatchGroupProps extends PrimitivePropsWithRef<'div'
 /** Props for a single {@link ColorPickerSwatch} preset. */
 export interface ColorPickerSwatchProps extends PrimitivePropsWithRef<'button'> {
     /**
-     * The colour this swatch selects, in any notation {@link parseColor}
-     * understands. An unparseable value renders a disabled swatch rather than a
-     * button that silently does nothing when clicked.
+     * The colour this swatch selects. Unparseable values render disabled; valid
+     * colours are accepted in any {@link parseColor} notation.
      */
     value: string;
 }
 /** Props for a {@link ColorPickerInput} text field. */
 export interface ColorPickerInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue'> {
     /**
-     * Which single channel this input edits. Omit it and the input carries the
-     * whole colour as one string in the picker's current `format` — which is the
-     * hex box people expect, and which re-spells itself when the format changes.
+     * Which single channel this input edits. Omit to carry the whole colour
+     * in the picker's current `format`; it re-spells itself on format changes.
      * @default undefined — the whole colour, in the current format.
      */
     channel?: ColorChannel;
@@ -194,14 +210,13 @@ export interface ColorPickerInputProps extends Omit<PrimitivePropsWithRef<'input
 /** Props for the {@link ColorPickerFormatSelect}, a native `<select>` over the notations. */
 export interface ColorPickerFormatSelectProps extends Omit<React.ComponentPropsWithRef<'select'>, 'value' | 'defaultValue' | 'children'> {
     /**
-     * Which notations to offer, in the order they should appear.
+     * Which notations to offer, in display order.
      * @default ['hex', 'rgb', 'hsl', 'hsb'] — every format the picker can emit.
      */
     formats?: ColorFormat[];
     /**
-     * Replaces the generated `<option>` list wholesale, for a consumer who wants
-     * their own labels or grouping. Their `value` attributes must still be
-     * {@link ColorFormat} strings.
+     * Replaces the generated `<option>` list for custom labels or grouping.
+     * `value` attributes must still be {@link ColorFormat} strings.
      * @default undefined — one `<option>` per entry in `formats`.
      */
     children?: React.ReactNode;

package/dist/color-picker/types.d.ts

@@ -29,11 +29,14 @@ export type ColorChannel = 'hex' | 'red' | 'green' | 'blue' | 'hue' | 'saturatio
 /** Props for the {@link ColorPicker} root. */
 export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Current colour as a string in the active `format`, for controlled usage.
-     * Pair with `onValueChange`. Anything {@link parseColor} understands is
-     * accepted regardless of `format`; an unparseable string is ignored and the
-     * last good colour is kept, because a half-typed `#ab` should not blank the
-     * picker.
+     * Composed parts for full control over anatomy. Omitted, the picker derives the area,
+     * tracks, input, and swatches from the show* and swatches props.
+     * @default undefined — the picker derives its anatomy.
+     */
+    children?: React.ReactNode;
+    /**
+     * Current colour for controlled usage. Pair with `onValueChange`. Accepts
+     * any {@link parseColor} notation; unparseable input keeps the last colour.
      * @default undefined — uncontrolled, tracks its own colour internally.
      */
     value?: string;
@@ -43,37 +46,21 @@ export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'on
      */
     defaultValue?: string;
     /**
-     * Fires with the new string on every change: each arrow key, each frame of a
-     * drag that moves the colour, each swatch click — and also on a `format`
-     * change, because the string genuinely changed even though the colour did not.
+     * Fires with the new string on every change: arrow keys, drag frames,
+     * swatch clicks, and format switches; suppressed when the string doesn't change.
      * @default undefined — no-op if omitted.
      */
     onValueChange?: (value: string) => void;
     /**
-     * Fires once with the final string when a pointer drag ends (release or
-     * cancel). This is the callback to hang an expensive effect on: a drag emits
-     * `onValueChange` per frame and this one exactly once, so a consumer can
-     * repaint continuously without also making a network call per frame.
-     *
-     * Keyboard and click changes do not fire it — each is already a discrete
-     * commit, reported by `onValueChange`.
+     * Fires once with the final string when a pointer drag ends. Use for
+     * expensive effects; `onValueChange` fires per frame but this fires once.
+     * Keyboard and click changes do not fire it.
      * @default undefined — no-op if omitted.
      */
     onValueCommit?: (value: string) => void;
-    /**
-     * Previous name for `onValueCommit`, kept so 0.20 code keeps working.
-     * @deprecated Renamed to `onValueCommit` in 0.21. The contract, Vue and Web
-     * Components have always called this `value-commit`, and React's own
-     * `Slider`/`Editable` already spelled it `onValueCommit` — only
-     * `AngleSlider` and `ColorPicker` used `onValueChangeEnd`. Still honoured
-     * when `onValueCommit` is not supplied; it will be removed in 0.22.
-     * @default undefined — no-op if omitted.
-     */
-    onValueChangeEnd?: (value: string) => void;
     /**
      * Notation `value` is written in, for controlled usage. Pair with
-     * `onFormatChange`. The colour itself is stored as HSB whatever this says;
-     * the format only decides how it is spelled on the way out.
+     * `onFormatChange`. Colour is stored as HSB; format only decides spelling.
      * @default undefined — uncontrolled, tracks its own format internally.
      */
     format?: ColorFormat;
@@ -90,15 +77,13 @@ export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'on
     onFormatChange?: (format: ColorFormat) => void;
     /**
      * Whether the picker has an alpha channel. When `false`, `ColorPickerAlphaSlider`
-     * renders nothing and every emitted string is fully opaque — so a consumer
-     * that cannot handle transparency never receives an `rgba()` it must strip.
+     * renders nothing and every emitted string is fully opaque.
      * @default true
      */
     alpha?: boolean;
     /**
-     * Keyboard increment, in the units of whichever channel is being stepped:
-     * percentage points for saturation/brightness/alpha, degrees for hue. Shift
-     * multiplies it by ten, so a 1-unit picker still has a coarse gear.
+     * Keyboard increment in channel units: percent for saturation/brightness/alpha,
+     * degrees for hue. Shift multiplies by ten.
      * @default 1 — every whole unit is reachable without a pointer.
      */
     step?: number;
@@ -115,6 +100,29 @@ export interface ColorPickerProps extends Omit<PrimitivePropsWithRef<'div'>, 'on
      * @default false
      */
     readOnly?: boolean;
+    /**
+     * Whether to render a {@link ColorPickerInput}. Ignored when `children` is given.
+     * @default true
+     */
+    showInput?: boolean;
+    /**
+     * Whether to render a {@link ColorPickerSwatchGroup}. Ignored when `children`
+     * is given or `swatches` is empty.
+     * @default true
+     */
+    showSwatches?: boolean;
+    /**
+     * Whether to render a {@link ColorPickerEyeDropper} trigger.
+     * Ignored when `children` is given.
+     * @default true
+     */
+    showEyeDropper?: boolean;
+    /**
+     * Preset colours the derived anatomy renders as {@link ColorPickerSwatch}
+     * parts, one per entry. Ignored when `children` is given or `showSwatches` is `false`.
+     * @default [] — no swatches rendered.
+     */
+    swatches?: string[];
 }
 /** Props for the {@link ColorPickerArea}, the 2D saturation/brightness surface. */
 export interface ColorPickerAreaProps extends PrimitivePropsWithRef<'div'> {
@@ -128,12 +136,12 @@ export interface ColorPickerAreaProps extends PrimitivePropsWithRef<'div'> {
  */
 export interface ColorPickerAreaThumbProps extends Omit<PrimitivePropsWithRef<'div'>, 'asChild'> {
     /**
-     * Accessible name of the horizontal axis, which is a `role="slider"` of its own.
+     * Accessible name of the horizontal saturation slider.
      * @default 'Saturation'
      */
     saturationLabel?: string;
     /**
-     * Accessible name of the vertical axis, which is a second `role="slider"`.
+     * Accessible name of the vertical brightness slider.
      * @default 'Brightness'
      */
     brightnessLabel?: string;
@@ -141,8 +149,13 @@ export interface ColorPickerAreaThumbProps extends Omit<PrimitivePropsWithRef<'d
 /** Props for the {@link ColorPickerHueSlider}, the 0–360° hue track. */
 export interface ColorPickerHueSliderProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Axis the track runs along, which decides whether pointer position is read
-     * from `clientX` or `clientY` and is published as `data-orientation`.
+     * Accessible name of the slider. A prop, not just `aria-label`, so a
+     * localised UI doesn't need to reach past the component's API to translate it.
+     * @default 'Hue'
+     */
+    label?: string;
+    /**
+     * Axis the track runs along: `clientX`/`clientY` for horizontal/vertical.
      * Vertical tracks run bottom-to-top, matching `Slider`.
      * @default 'horizontal'
      */
@@ -154,8 +167,13 @@ export interface ColorPickerHueSliderThumbProps extends PrimitivePropsWithRef<'d
 /** Props for the {@link ColorPickerAlphaSlider}, the 0–100% opacity track. */
 export interface ColorPickerAlphaSliderProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Axis the track runs along, which decides whether pointer position is read
-     * from `clientX` or `clientY` and is published as `data-orientation`.
+     * Accessible name of the slider. A prop, not just `aria-label`, so a
+     * localised UI doesn't need to reach past the component's API to translate it.
+     * @default 'Opacity'
+     */
+    label?: string;
+    /**
+     * Axis the track runs along: `clientX`/`clientY` for horizontal/vertical.
      * Vertical tracks run bottom-to-top, matching `Slider`.
      * @default 'horizontal'
      */
@@ -167,7 +185,7 @@ export interface ColorPickerAlphaSliderThumbProps extends PrimitivePropsWithRef<
 /** Props for the {@link ColorPickerSwatchGroup}, the container for preset swatches. */
 export interface ColorPickerSwatchGroupProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Whether arrow-key navigation wraps from the last swatch back to the first.
+     * Whether arrow-key navigation wraps from the last swatch to the first.
      * @default true
      */
     loop?: boolean;
@@ -175,18 +193,16 @@ export interface ColorPickerSwatchGroupProps extends PrimitivePropsWithRef<'div'
 /** Props for a single {@link ColorPickerSwatch} preset. */
 export interface ColorPickerSwatchProps extends PrimitivePropsWithRef<'button'> {
     /**
-     * The colour this swatch selects, in any notation {@link parseColor}
-     * understands. An unparseable value renders a disabled swatch rather than a
-     * button that silently does nothing when clicked.
+     * The colour this swatch selects. Unparseable values render disabled; valid
+     * colours are accepted in any {@link parseColor} notation.
      */
     value: string;
 }
 /** Props for a {@link ColorPickerInput} text field. */
 export interface ColorPickerInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue'> {
     /**
-     * Which single channel this input edits. Omit it and the input carries the
-     * whole colour as one string in the picker's current `format` — which is the
-     * hex box people expect, and which re-spells itself when the format changes.
+     * Which single channel this input edits. Omit to carry the whole colour
+     * in the picker's current `format`; it re-spells itself on format changes.
      * @default undefined — the whole colour, in the current format.
      */
     channel?: ColorChannel;
@@ -194,14 +210,13 @@ export interface ColorPickerInputProps extends Omit<PrimitivePropsWithRef<'input
 /** Props for the {@link ColorPickerFormatSelect}, a native `<select>` over the notations. */
 export interface ColorPickerFormatSelectProps extends Omit<React.ComponentPropsWithRef<'select'>, 'value' | 'defaultValue' | 'children'> {
     /**
-     * Which notations to offer, in the order they should appear.
+     * Which notations to offer, in display order.
      * @default ['hex', 'rgb', 'hsl', 'hsb'] — every format the picker can emit.
      */
     formats?: ColorFormat[];
     /**
-     * Replaces the generated `<option>` list wholesale, for a consumer who wants
-     * their own labels or grouping. Their `value` attributes must still be
-     * {@link ColorFormat} strings.
+     * Replaces the generated `<option>` list for custom labels or grouping.
+     * `value` attributes must still be {@link ColorFormat} strings.
      * @default undefined — one `<option>` per entry in `formats`.
      */
     children?: React.ReactNode;

package/dist/color-picker/useChannelSlider.d.cts

@@ -60,24 +60,9 @@ export declare function snapChannel(raw: number, step: number, max: number): num
  */
 export declare function arrowStep(step: number): number;
 /**
- * The behaviour shared by `ColorPickerHueSlider` and
- * `ColorPickerAlphaSlider`: a linear `role="slider"` track over `0…max` with
- * pointer drag, click-to-seek and a full keyboard path.
- *
- * The two parts differ only in their range, their wording and which field of
- * the colour they write, so the alternative to this hook is one file copied
- * onto another with three identifiers changed — and a keyboard bug fixed in
- * one of them.
- *
- * **The track has ends; it does not wrap.** Hue is circular, but a linear
- * control reporting `aria-valuemin=0`/`aria-valuemax=360` that silently
- * teleported from one end to the other would be lying to assistive tech.
- * `AngleSlider` is the wrapping control.
- *
- * Pointer geometry is physical (left-to-right, bottom-to-top), matching
- * `Slider`; only the arrow **keys** are mirrored under `dir="rtl"`, via
- * `directionalKey`.
- *
+ * Shared behavior for `ColorPickerHueSlider` and `ColorPickerAlphaSlider`:
+ * linear `role="slider"` track with pointer drag, click-to-seek, full keyboard path.
+ * Track has ends; does not wrap. Pointer geometry physical; arrow keys mirror under `dir="rtl"`.
  * @internal
  */
 export declare function useChannelSlider(options: UseChannelSliderOptions): ChannelSlider;

package/dist/color-picker/useChannelSlider.d.ts

@@ -60,24 +60,9 @@ export declare function snapChannel(raw: number, step: number, max: number): num
  */
 export declare function arrowStep(step: number): number;
 /**
- * The behaviour shared by `ColorPickerHueSlider` and
- * `ColorPickerAlphaSlider`: a linear `role="slider"` track over `0…max` with
- * pointer drag, click-to-seek and a full keyboard path.
- *
- * The two parts differ only in their range, their wording and which field of
- * the colour they write, so the alternative to this hook is one file copied
- * onto another with three identifiers changed — and a keyboard bug fixed in
- * one of them.
- *
- * **The track has ends; it does not wrap.** Hue is circular, but a linear
- * control reporting `aria-valuemin=0`/`aria-valuemax=360` that silently
- * teleported from one end to the other would be lying to assistive tech.
- * `AngleSlider` is the wrapping control.
- *
- * Pointer geometry is physical (left-to-right, bottom-to-top), matching
- * `Slider`; only the arrow **keys** are mirrored under `dir="rtl"`, via
- * `directionalKey`.
- *
+ * Shared behavior for `ColorPickerHueSlider` and `ColorPickerAlphaSlider`:
+ * linear `role="slider"` track with pointer drag, click-to-seek, full keyboard path.
+ * Track has ends; does not wrap. Pointer geometry physical; arrow keys mirror under `dir="rtl"`.
  * @internal
  */
 export declare function useChannelSlider(options: UseChannelSliderOptions): ChannelSlider;

package/dist/color-picker/usePointerRatio.d.cts

@@ -19,21 +19,9 @@ export interface UsePointerRatioResult {
     dragging: boolean;
 }
 /**
- * The linear twin of `usePointerAngle`: turns a pointer position inside an
- * element into normalized `x`/`y` fractions in `[0, 1]`, for widgets whose
- * input is a *position* rather than a direction — the colour picker's 2D area
- * and its hue and alpha tracks.
- *
- * It exists rather than three copies of `Slider`'s pointer block because those
- * three parts each need a genuine drag-end signal (`onValueCommit` fires
- * once per drag) and each needs `data-dragging`, and because document-level
- * listeners keep a drag alive when the pointer leaves the window — which
- * element-level `pointermove` does not.
- *
- * Deliberately knows nothing about value ranges, channels, ARIA, RTL, or
- * `disabled`/`readOnly`: `x` is always measured left-to-right from the border
- * box, exactly as `Slider` measures it, and a part that must ignore pointer
- * input simply does not wire up `onPointerDown`.
+ * Turns pointer position inside an element into normalized `x`/`y` fractions
+ * in `[0, 1]` for 2D widgets (color picker area, hue/alpha tracks). Emits
+ * drag-end signals and `data-dragging`. Measures left-to-right from border box.
  *
  * @internal
  */

package/dist/color-picker/usePointerRatio.d.ts

@@ -19,21 +19,9 @@ export interface UsePointerRatioResult {
     dragging: boolean;
 }
 /**
- * The linear twin of `usePointerAngle`: turns a pointer position inside an
- * element into normalized `x`/`y` fractions in `[0, 1]`, for widgets whose
- * input is a *position* rather than a direction — the colour picker's 2D area
- * and its hue and alpha tracks.
- *
- * It exists rather than three copies of `Slider`'s pointer block because those
- * three parts each need a genuine drag-end signal (`onValueCommit` fires
- * once per drag) and each needs `data-dragging`, and because document-level
- * listeners keep a drag alive when the pointer leaves the window — which
- * element-level `pointermove` does not.
- *
- * Deliberately knows nothing about value ranges, channels, ARIA, RTL, or
- * `disabled`/`readOnly`: `x` is always measured left-to-right from the border
- * box, exactly as `Slider` measures it, and a part that must ignore pointer
- * input simply does not wire up `onPointerDown`.
+ * Turns pointer position inside an element into normalized `x`/`y` fractions
+ * in `[0, 1]` for 2D widgets (color picker area, hue/alpha tracks). Emits
+ * drag-end signals and `data-dragging`. Measures left-to-right from border box.
  *
  * @internal
  */