@cube-dev/ui-kit 0.155.0 → 0.156.0

package/dist/components/fields/ColorPicker/ColorPicker.js

@@ -0,0 +1,240 @@
+/** @license MIT | @cube-dev/ui-kit v0.156.0 | Cube Dev Team */
+import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
+import { useEvent } from "../../../_internal/hooks/use-event.js";
+import { ItemAction } from "../../actions/ItemAction/ItemAction.js";
+import { PipetteIcon } from "../../../icons/PipetteIcon.js";
+import { useFieldProps } from "../../form/Form/use-field/use-field-props.js";
+import { Dialog } from "../../overlays/Dialog/Dialog.js";
+import { DialogTrigger } from "../../overlays/Dialog/DialogTrigger.js";
+import { TextInputBase } from "../TextInput/TextInputBase.js";
+import { detectFormat, formatColor, parseColor, toHex } from "./color.js";
+import { ColorPickerPanel } from "./ColorPickerPanel.js";
+import { tasty } from "@tenphi/tasty";
+import { forwardRef, useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useTextField } from "react-aria";
+
+//#region src/components/fields/ColorPicker/ColorPicker.tsx
+/** What the popover starts from when there is no color to edit yet. */
+const FALLBACK_COLOR = {
+	h: 264,
+	s: .8,
+	l: .6
+};
+const SwatchElement = tasty({
+	qa: "ColorSwatch",
+	styles: {
+		display: "block",
+		width: "2.5x",
+		height: "2.5x",
+		radius: "1r",
+		fill: {
+			"": "(#color-picker, #clear)",
+			empty: "#clear"
+		},
+		shadow: "inset 0 0 0 1bw #dark.15",
+		image: {
+			"": false,
+			empty: "linear-gradient(to bottom right, #clear 46%, #danger 46%, #danger 54%, #clear 54%)"
+		}
+	}
+});
+const ColorPickerButton = tasty(ItemAction, {
+	qa: "ColorPickerButton",
+	icon: /* @__PURE__ */ jsx(PipetteIcon, {})
+});
+/**
+* A color field: the color as text, a swatch of the current value, and a
+* popover to dial it in across OKHST, OKLCH and RGB.
+*/
+const ColorPicker = forwardRef(function ColorPicker(allProps, ref) {
+	const props = useFieldProps(allProps, {
+		defaultValidationTrigger: "onBlur",
+		valuePropsMapper: ({ value, onChange }) => ({
+			value,
+			onChange
+		})
+	});
+	const { qa, value, defaultValue, onChange, format = "hex", formatMode = "forced", defaultSpace = "hst", isOpen: controlledOpen, defaultOpen, onOpenChange, shouldFlip, placeholder = "Pick a color", size, isDisabled, isReadOnly, isInvalid, isValid, isLoading, autoFocus, inputStyles, triggerStyles, swatchStyles, labelProps: userLabelProps, onBlur: userOnBlur, onFocus, label, description, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "aria-describedby": ariaDescribedby, id } = props;
+	const initialText = (value ?? defaultValue ?? "").toString();
+	const [text, setText] = useState(() => {
+		const parsed = parseColor(initialText);
+		return parsed && formatMode === "forced" ? formatColor(parsed, format) : initialText;
+	});
+	const [color, setColor] = useState(() => parseColor(initialText));
+	const [space, setSpace] = useState(defaultSpace);
+	const [isOpen, setOpen] = useState(defaultOpen ?? false);
+	const targetRef = useRef(null);
+	const inputRef = useRef(null);
+	/** The last text that parsed, so an invalid entry has something to fall back to. */
+	const validText = useRef(parseColor(initialText) ? text : "");
+	/** What was last handed to `onChange`, to tell our own updates from outside ones. */
+	const emitted = useRef(value);
+	const emit = useEvent((next) => {
+		emitted.current = next;
+		onChange?.(next);
+	});
+	/** The notation a value should be written in, given the current text. */
+	const outputFormat = (source) => formatMode === "forced" ? format : detectFormat(source) ?? format;
+	useEffect(() => {
+		if (value === void 0 || value === emitted.current) return;
+		emitted.current = value;
+		const raw = (value ?? "").toString();
+		const parsed = parseColor(raw);
+		const nextText = parsed && formatMode === "forced" ? formatColor(parsed, format) : raw;
+		setColor(parsed);
+		setText(nextText);
+		validText.current = parsed ? nextText : "";
+	}, [
+		value,
+		format,
+		formatMode
+	]);
+	const handleTextChange = useEvent((nextText) => {
+		setText(nextText);
+		if (!nextText.trim()) {
+			setColor(null);
+			validText.current = "";
+			emit(null);
+			return;
+		}
+		const parsed = parseColor(nextText);
+		if (!parsed) return;
+		setColor(parsed);
+		validText.current = nextText;
+		emit(formatMode === "free" ? nextText.trim() : formatColor(parsed, outputFormat(nextText)));
+	});
+	/** Resolve whatever is in the input into a real color, or undo it. */
+	const settle = useEvent(() => {
+		if (!text.trim()) return;
+		const parsed = parseColor(text);
+		if (!parsed) {
+			setText(validText.current);
+			return;
+		}
+		if (formatMode === "forced") setText(formatColor(parsed, format));
+	});
+	/**
+	* Focusing offers the whole value up for replacement, the way a hex field
+	* does. The string is the unit of editing here: a single channel is tuned
+	* with the sliders, not by hand-editing one number inside `oklch(…)`.
+	*
+	* Read off the event rather than `inputRef`, which `TextInputBase` re-points
+	* through `useCombinedRefs`.
+	*/
+	const handleFocus = useEvent((event) => {
+		event.currentTarget.select();
+		onFocus?.(event);
+	});
+	/**
+	* A click would otherwise drop a caret and undo that selection — the browser
+	* applies it after the focus handler has run. Suppressing the default action
+	* of the focusing press means no caret is ever placed; focus is then moved
+	* here instead, which selects.
+	*
+	* Only the press that *takes* focus is suppressed, so clicking a field that
+	* already has focus still positions the caret, and dragging still selects a
+	* range.
+	*/
+	const handleMouseDown = useEvent((event) => {
+		if (document.activeElement === event.currentTarget) return;
+		event.preventDefault();
+		event.currentTarget.focus();
+	});
+	const handleBlur = useEvent((event) => {
+		settle();
+		userOnBlur?.(event);
+	});
+	const handleKeyDown = useEvent((event) => {
+		if (event.key === "Enter") settle();
+	});
+	const handleColorChange = useEvent((nextColor) => {
+		const nextText = formatColor(nextColor, outputFormat(text));
+		setColor(nextColor);
+		setText(nextText);
+		validText.current = nextText;
+		emit(nextText);
+	});
+	const handleOpenChange = useEvent((next) => {
+		setOpen(next);
+		onOpenChange?.(next);
+	});
+	const { labelProps, inputProps } = useTextField({
+		id,
+		label,
+		description,
+		"aria-label": ariaLabel,
+		"aria-labelledby": ariaLabelledby,
+		"aria-describedby": ariaDescribedby,
+		isDisabled,
+		isReadOnly,
+		isInvalid,
+		autoFocus,
+		placeholder,
+		value: text,
+		type: "text",
+		onChange: handleTextChange,
+		onFocus: handleFocus,
+		onBlur: handleBlur,
+		onKeyDown: handleKeyDown
+	}, inputRef);
+	return /* @__PURE__ */ jsx(TextInputBase, {
+		...props,
+		ref,
+		qa: qa || "ColorPicker",
+		size,
+		autocomplete: "off",
+		icon: /* @__PURE__ */ jsx(SwatchElement, {
+			mods: { empty: !color },
+			styles: swatchStyles,
+			style: color ? { "--color-picker-color": toHex(color) } : void 0
+		}),
+		inputRef,
+		inputProps: {
+			...inputProps,
+			spellCheck: false,
+			onMouseDown: handleMouseDown
+		},
+		inputStyles,
+		labelProps: mergeProps$1(labelProps, userLabelProps),
+		wrapperRef: targetRef,
+		isDisabled,
+		isReadOnly,
+		isInvalid,
+		isValid,
+		isLoading,
+		suffixPosition: "after",
+		suffix: /* @__PURE__ */ jsxs(DialogTrigger, {
+			hideArrow: true,
+			type: "popover",
+			mobileType: "tray",
+			placement: "bottom right",
+			targetRef,
+			isOpen: controlledOpen ?? isOpen,
+			shouldFlip,
+			onOpenChange: handleOpenChange,
+			children: [/* @__PURE__ */ jsx(ColorPickerButton, {
+				size,
+				"aria-label": "Open the color picker",
+				isDisabled: isDisabled || isReadOnly,
+				styles: triggerStyles
+			}), /* @__PURE__ */ jsx(Dialog, {
+				"aria-label": "Color picker",
+				width: "max-content",
+				children: /* @__PURE__ */ jsx(ColorPickerPanel, {
+					color: color ?? FALLBACK_COLOR,
+					space,
+					isDisabled: isDisabled || isReadOnly,
+					previewFormat: outputFormat(text),
+					onChange: handleColorChange,
+					onSpaceChange: setSpace
+				})
+			})]
+		})
+	});
+});
+ColorPicker.cubeInputType = "Text";
+
+//#endregion
+export { ColorPicker };
+//# sourceMappingURL=ColorPicker.js.map

package/dist/components/fields/ColorPicker/ColorPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorPicker.js","names":["mergeProps"],"sources":["../../../../src/components/fields/ColorPicker/ColorPicker.tsx"],"sourcesContent":["import {\n  BaseProps,\n  BaseStyleProps,\n  BlockStyleProps,\n  ColorStyleProps,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport {\n  FocusEvent,\n  ForwardedRef,\n  forwardRef,\n  KeyboardEvent,\n  MouseEvent,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport { useTextField } from 'react-aria';\n\nimport { useEvent } from '../../../_internal';\nimport { PipetteIcon } from '../../../icons';\nimport { FieldBaseProps } from '../../../shared';\nimport { mergeProps } from '../../../utils/react';\nimport { ItemAction } from '../../actions';\nimport { useFieldProps } from '../../form';\nimport { Dialog, DialogTrigger } from '../../overlays/Dialog';\nimport { TextInputBase } from '../TextInput/TextInputBase';\n\nimport { ColorSpace } from './channels';\nimport {\n  ColorFormat,\n  ColorValue,\n  detectFormat,\n  formatColor,\n  parseColor,\n  toHex,\n} from './color';\nimport { ColorPickerPanel } from './ColorPickerPanel';\n\n/**\n * How the text in the input relates to the committed value.\n *\n * - `forced` — the text is rewritten in `format` whenever it is not mid-edit,\n *   and the value is always written in `format`.\n * - `derive` — the user's own notation is left alone, and the value is\n *   normalized in whichever notation the text is written in.\n * - `free` — the text *is* the value, verbatim. It is still verified, so an\n *   unparsable entry falls back to the last valid one.\n */\nexport type ColorPickerFormatMode = 'forced' | 'derive' | 'free';\n\n/** What the popover starts from when there is no color to edit yet. */\nconst FALLBACK_COLOR: ColorValue = { h: 264, s: 0.8, l: 0.6 };\n\nconst SwatchElement = tasty({\n  qa: 'ColorSwatch',\n  styles: {\n    display: 'block',\n    width: '2.5x',\n    height: '2.5x',\n    radius: '1r',\n    fill: {\n      '': '(#color-picker, #clear)',\n      empty: '#clear',\n    },\n    shadow: 'inset 0 0 0 1bw #dark.15',\n    // A single diagonal stroke is the conventional \"no color\" swatch.\n    image: {\n      '': false,\n      empty:\n        'linear-gradient(to bottom right, #clear 46%, #danger 46%, #danger 54%, #clear 54%)',\n    },\n  },\n});\n\nconst ColorPickerButton = tasty(ItemAction, {\n  qa: 'ColorPickerButton',\n  icon: <PipetteIcon />,\n});\n\nexport interface CubeColorPickerProps\n  extends BaseProps,\n    BaseStyleProps,\n    OuterStyleProps,\n    BlockStyleProps,\n    ColorStyleProps,\n    FieldBaseProps {\n  /** The selected color, as a color string. */\n  value?: string | null;\n  /** The initial color of an uncontrolled picker. */\n  defaultValue?: string | null;\n  /** Called with the normalized color string, or `null` when the field is cleared. */\n  onChange?: (value: string | null) => void;\n  /** Notation the value is written in, and the one `forced` mode displays. */\n  format?: ColorFormat;\n  /** How strictly the input text is tied to `format`. */\n  formatMode?: ColorPickerFormatMode;\n  /** Color concept the popover opens with. */\n  defaultSpace?: ColorSpace;\n  /** Whether the popover is open. Makes the disclosure controlled. */\n  isOpen?: boolean;\n  /** Whether the popover is open initially. */\n  defaultOpen?: boolean;\n  /** Called when the popover opens or closes. */\n  onOpenChange?: (isOpen: boolean) => void;\n  /** Whether the popover may flip to the other side of the input. */\n  shouldFlip?: boolean;\n  /** Text shown while the field is empty. */\n  placeholder?: string;\n  /** The size of the input. */\n  size?: 'small' | 'medium' | 'large' | (string & {});\n  onFocus?: (event: FocusEvent<HTMLInputElement>) => void;\n  onBlur?: (event: FocusEvent<HTMLInputElement>) => void;\n  'aria-label'?: string;\n  'aria-labelledby'?: string;\n  'aria-describedby'?: string;\n  styles?: Styles;\n  /** Styles of the text input element. */\n  inputStyles?: Styles;\n  /** Styles of the popover trigger button. */\n  triggerStyles?: Styles;\n  /** Styles of the color swatch shown inside the input. */\n  swatchStyles?: Styles;\n}\n\n/**\n * A color field: the color as text, a swatch of the current value, and a\n * popover to dial it in across OKHST, OKLCH and RGB.\n */\nexport const ColorPicker = forwardRef(function ColorPicker(\n  allProps: CubeColorPickerProps,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  const props = useFieldProps(allProps, {\n    defaultValidationTrigger: 'onBlur',\n    valuePropsMapper: ({ value, onChange }) => ({\n      value: value as string | null | undefined,\n      onChange,\n    }),\n  });\n\n  const {\n    qa,\n    value,\n    defaultValue,\n    onChange,\n    format = 'hex',\n    formatMode = 'forced',\n    defaultSpace = 'hst',\n    isOpen: controlledOpen,\n    defaultOpen,\n    onOpenChange,\n    shouldFlip,\n    placeholder = 'Pick a color',\n    size,\n    isDisabled,\n    isReadOnly,\n    isInvalid,\n    isValid,\n    isLoading,\n    autoFocus,\n    inputStyles,\n    triggerStyles,\n    swatchStyles,\n    labelProps: userLabelProps,\n    onBlur: userOnBlur,\n    onFocus,\n    label,\n    description,\n    'aria-label': ariaLabel,\n    'aria-labelledby': ariaLabelledby,\n    'aria-describedby': ariaDescribedby,\n    id,\n  } = props;\n\n  const initialText = (value ?? defaultValue ?? '').toString();\n  const [text, setText] = useState(() => {\n    const parsed = parseColor(initialText);\n\n    return parsed && formatMode === 'forced'\n      ? formatColor(parsed, format)\n      : initialText;\n  });\n  const [color, setColor] = useState(() => parseColor(initialText));\n  const [space, setSpace] = useState<ColorSpace>(defaultSpace);\n  const [isOpen, setOpen] = useState(defaultOpen ?? false);\n\n  const targetRef = useRef<HTMLDivElement>(null);\n  const inputRef = useRef<HTMLInputElement>(null);\n  /** The last text that parsed, so an invalid entry has something to fall back to. */\n  const validText = useRef(parseColor(initialText) ? text : '');\n  /** What was last handed to `onChange`, to tell our own updates from outside ones. */\n  const emitted = useRef<string | null | undefined>(value);\n\n  const emit = useEvent((next: string | null) => {\n    emitted.current = next;\n    onChange?.(next);\n  });\n\n  /** The notation a value should be written in, given the current text. */\n  const outputFormat = (source: string): ColorFormat =>\n    formatMode === 'forced' ? format : detectFormat(source) ?? format;\n\n  // Adopt values that did not come from here — a form reset, or a parent that\n  // overrides what the user picked.\n  useEffect(() => {\n    if (value === undefined || value === emitted.current) return;\n\n    emitted.current = value;\n\n    const raw = (value ?? '').toString();\n    const parsed = parseColor(raw);\n    const nextText =\n      parsed && formatMode === 'forced' ? formatColor(parsed, format) : raw;\n\n    setColor(parsed);\n    setText(nextText);\n    validText.current = parsed ? nextText : '';\n  }, [value, format, formatMode]);\n\n  const handleTextChange = useEvent((nextText: string) => {\n    setText(nextText);\n\n    if (!nextText.trim()) {\n      setColor(null);\n      validText.current = '';\n      emit(null);\n\n      return;\n    }\n\n    const parsed = parseColor(nextText);\n\n    // Half-typed input keeps the last valid color, so the value stays a real\n    // color at every keystroke.\n    if (!parsed) return;\n\n    setColor(parsed);\n    validText.current = nextText;\n    emit(\n      formatMode === 'free'\n        ? nextText.trim()\n        : formatColor(parsed, outputFormat(nextText)),\n    );\n  });\n\n  /** Resolve whatever is in the input into a real color, or undo it. */\n  const settle = useEvent(() => {\n    if (!text.trim()) return;\n\n    const parsed = parseColor(text);\n\n    if (!parsed) {\n      setText(validText.current);\n\n      return;\n    }\n\n    if (formatMode === 'forced') setText(formatColor(parsed, format));\n  });\n\n  /**\n   * Focusing offers the whole value up for replacement, the way a hex field\n   * does. The string is the unit of editing here: a single channel is tuned\n   * with the sliders, not by hand-editing one number inside `oklch(…)`.\n   *\n   * Read off the event rather than `inputRef`, which `TextInputBase` re-points\n   * through `useCombinedRefs`.\n   */\n  const handleFocus = useEvent((event: FocusEvent<HTMLInputElement>) => {\n    event.currentTarget.select();\n    onFocus?.(event);\n  });\n\n  /**\n   * A click would otherwise drop a caret and undo that selection — the browser\n   * applies it after the focus handler has run. Suppressing the default action\n   * of the focusing press means no caret is ever placed; focus is then moved\n   * here instead, which selects.\n   *\n   * Only the press that *takes* focus is suppressed, so clicking a field that\n   * already has focus still positions the caret, and dragging still selects a\n   * range.\n   */\n  const handleMouseDown = useEvent((event: MouseEvent<HTMLInputElement>) => {\n    if (document.activeElement === event.currentTarget) return;\n\n    event.preventDefault();\n    event.currentTarget.focus();\n  });\n\n  const handleBlur = useEvent((event: FocusEvent<HTMLInputElement>) => {\n    settle();\n    userOnBlur?.(event);\n  });\n\n  const handleKeyDown = useEvent((event: KeyboardEvent<HTMLInputElement>) => {\n    if (event.key === 'Enter') settle();\n  });\n\n  const handleColorChange = useEvent((nextColor: ColorValue) => {\n    const nextText = formatColor(nextColor, outputFormat(text));\n\n    setColor(nextColor);\n    setText(nextText);\n    validText.current = nextText;\n    emit(nextText);\n  });\n\n  const handleOpenChange = useEvent((next: boolean) => {\n    setOpen(next);\n    onOpenChange?.(next);\n  });\n\n  const { labelProps, inputProps } = useTextField(\n    {\n      id,\n      label,\n      description,\n      'aria-label': ariaLabel,\n      'aria-labelledby': ariaLabelledby,\n      'aria-describedby': ariaDescribedby,\n      isDisabled,\n      isReadOnly,\n      isInvalid,\n      autoFocus,\n      placeholder,\n      value: text,\n      type: 'text',\n      onChange: handleTextChange,\n      onFocus: handleFocus,\n      onBlur: handleBlur,\n      onKeyDown: handleKeyDown,\n    },\n    inputRef,\n  );\n\n  return (\n    <TextInputBase\n      {...props}\n      ref={ref}\n      qa={qa || 'ColorPicker'}\n      size={size}\n      autocomplete=\"off\"\n      icon={\n        <SwatchElement\n          mods={{ empty: !color }}\n          styles={swatchStyles}\n          style={color ? { '--color-picker-color': toHex(color) } : undefined}\n        />\n      }\n      inputRef={inputRef}\n      inputProps={{\n        ...inputProps,\n        spellCheck: false,\n        onMouseDown: handleMouseDown,\n      }}\n      inputStyles={inputStyles}\n      labelProps={mergeProps(labelProps, userLabelProps)}\n      wrapperRef={targetRef}\n      isDisabled={isDisabled}\n      isReadOnly={isReadOnly}\n      isInvalid={isInvalid}\n      isValid={isValid}\n      isLoading={isLoading}\n      // The validation state reads left of the trigger, the way `DateInputBase`\n      // orders it for the date pickers.\n      suffixPosition=\"after\"\n      suffix={\n        <DialogTrigger\n          hideArrow\n          type=\"popover\"\n          mobileType=\"tray\"\n          placement=\"bottom right\"\n          targetRef={targetRef}\n          isOpen={controlledOpen ?? isOpen}\n          shouldFlip={shouldFlip}\n          onOpenChange={handleOpenChange}\n        >\n          <ColorPickerButton\n            size={size}\n            aria-label=\"Open the color picker\"\n            isDisabled={isDisabled || isReadOnly}\n            styles={triggerStyles}\n          />\n          <Dialog aria-label=\"Color picker\" width=\"max-content\">\n            <ColorPickerPanel\n              color={color ?? FALLBACK_COLOR}\n              space={space}\n              isDisabled={isDisabled || isReadOnly}\n              previewFormat={outputFormat(text)}\n              onChange={handleColorChange}\n              onSpaceChange={setSpace}\n            />\n          </Dialog>\n        </DialogTrigger>\n      }\n    />\n  );\n});\n\n(ColorPicker as any).cubeInputType = 'Text';\n"],"mappings":"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"}

package/dist/components/fields/ColorPicker/ColorPickerPanel.js

@@ -0,0 +1,149 @@
+/** @license MIT | @cube-dev/ui-kit v0.156.0 | Cube Dev Team */
+import { useEvent } from "../../../_internal/hooks/use-event.js";
+import { formatColor, getContrastingColor, toHex } from "./color.js";
+import { __Radio } from "../RadioGroup/Radio.js";
+import { __Slider } from "../Slider/Slider.js";
+import { CHANNELS, COLOR_SPACES, COLOR_SPACE_HINTS, COLOR_SPACE_LABELS } from "./channels.js";
+import { tasty } from "@tenphi/tasty";
+import { useMemo } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/fields/ColorPicker/ColorPickerPanel.tsx
+const PanelElement = tasty({
+	qa: "ColorPickerPanel",
+	styles: {
+		display: "grid",
+		flow: "row",
+		gap: "1x",
+		padding: "1x",
+		width: "34x"
+	}
+});
+const PreviewElement = tasty({
+	qa: "ColorPreview",
+	styles: {
+		display: "grid",
+		placeItems: "center",
+		height: "6x",
+		radius: true,
+		preset: "s4",
+		fill: "(#color-picker, #clear)",
+		color: "(#color-picker-contrast, #dark)",
+		shadow: "inset 0 0 0 1bw #dark.1"
+	}
+});
+const ChannelsElement = tasty({ styles: {
+	display: "grid",
+	gridColumns: "max-content 1sf max-content",
+	placeItems: "center stretch",
+	gap: "1x"
+} });
+const ChannelLabelElement = tasty({ styles: {
+	preset: "c2",
+	color: "#dark-03",
+	textAlign: "center",
+	width: "2x"
+} });
+const ChannelTrackElement = tasty({ styles: {
+	display: "grid",
+	placeItems: "center stretch"
+} });
+const ChannelValueElement = tasty({ styles: {
+	preset: "s4",
+	color: "#dark-02",
+	textAlign: "right",
+	whiteSpace: "nowrap",
+	width: "5.5x"
+} });
+/**
+* The gradient reaches the track through a plain custom property so the track
+* keeps a single cached style rule. A color picker moves its channels
+* continuously, and a fresh `styles` object per frame would emit a fresh CSS
+* rule per frame.
+*/
+const TRACK_STYLES = {
+	height: "1x",
+	top: ".5x",
+	radius: "1r",
+	fill: "#clear",
+	image: "$channel-gradient",
+	shadow: "inset 0 0 0 1bw #dark.1",
+	Fill: false
+};
+/** A ring keeps the thumb visible wherever it sits on its own gradient. */
+const THUMB_STYLES = { shadow: "0 0 0 2bw #surface, 0 0 0 3bw #dark.2" };
+const THUMB_TOKENS = { "#slider-thumb": "(#color-picker, #surface)" };
+const SPACE_STYLES = { width: "100%" };
+const TAB_STYLES = { flexGrow: 1 };
+function ChannelRow({ channel, color, isDisabled, onChange }) {
+	const max = channel.max(color);
+	const handleChange = useEvent((value) => {
+		onChange(channel.apply(color, value));
+	});
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		/* @__PURE__ */ jsx(ChannelLabelElement, {
+			"aria-hidden": "true",
+			children: channel.label
+		}),
+		/* @__PURE__ */ jsx(ChannelTrackElement, {
+			style: { "--channel-gradient": `linear-gradient(to right, ${channel.stops(color)})` },
+			children: /* @__PURE__ */ jsx(__Slider, {
+				"aria-label": channel.title,
+				value: Math.min(channel.value(color), max),
+				minValue: channel.min,
+				maxValue: max,
+				step: channel.step,
+				isDisabled,
+				trackStyles: TRACK_STYLES,
+				thumbStyles: THUMB_STYLES,
+				thumbTokens: THUMB_TOKENS,
+				onChange: handleChange
+			})
+		}),
+		/* @__PURE__ */ jsx(ChannelValueElement, { children: channel.display(color) })
+	] });
+}
+/**
+* The popover body of `ColorPicker`: a preview, a switch between the three
+* color concepts, and one gradient slider per channel of the active one.
+*/
+function ColorPickerPanel(props) {
+	const { color, space, isDisabled, previewFormat, onChange, onSpaceChange } = props;
+	const colorTokens = useMemo(() => ({
+		"--color-picker-color": toHex(color),
+		"--color-picker-contrast-color": getContrastingColor(color)
+	}), [color]);
+	const handleSpaceChange = useEvent((value) => {
+		onSpaceChange(value);
+	});
+	return /* @__PURE__ */ jsxs(PanelElement, {
+		style: colorTokens,
+		children: [
+			/* @__PURE__ */ jsx(PreviewElement, { children: formatColor(color, previewFormat) }),
+			/* @__PURE__ */ jsx(__Radio.Tabs, {
+				"aria-label": "Color space",
+				value: space,
+				isDisabled,
+				styles: SPACE_STYLES,
+				onChange: handleSpaceChange,
+				children: COLOR_SPACES.map((item) => /* @__PURE__ */ jsx(__Radio, {
+					value: item,
+					"aria-label": COLOR_SPACE_LABELS[item],
+					tooltip: COLOR_SPACE_HINTS[item],
+					styles: TAB_STYLES,
+					children: COLOR_SPACE_LABELS[item]
+				}, item))
+			}),
+			/* @__PURE__ */ jsx(ChannelsElement, { children: CHANNELS[space].map((channel) => /* @__PURE__ */ jsx(ChannelRow, {
+				channel,
+				color,
+				isDisabled,
+				onChange
+			}, `${space}-${channel.label}`)) })
+		]
+	});
+}
+
+//#endregion
+export { ColorPickerPanel };
+//# sourceMappingURL=ColorPickerPanel.js.map

package/dist/components/fields/ColorPicker/ColorPickerPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorPickerPanel.js","names":["Slider","Radio"],"sources":["../../../../src/components/fields/ColorPicker/ColorPickerPanel.tsx"],"sourcesContent":["import { Styles, tasty } from '@tenphi/tasty';\nimport { useMemo } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { Radio } from '../RadioGroup';\nimport { Slider } from '../Slider';\n\nimport {\n  CHANNELS,\n  COLOR_SPACE_HINTS,\n  COLOR_SPACE_LABELS,\n  COLOR_SPACES,\n  ColorChannel,\n  ColorSpace,\n} from './channels';\nimport {\n  ColorFormat,\n  ColorValue,\n  formatColor,\n  getContrastingColor,\n  toHex,\n} from './color';\n\nconst PanelElement = tasty({\n  qa: 'ColorPickerPanel',\n  styles: {\n    display: 'grid',\n    flow: 'row',\n    gap: '1x',\n    padding: '1x',\n    width: '34x',\n  },\n});\n\nconst PreviewElement = tasty({\n  qa: 'ColorPreview',\n  styles: {\n    display: 'grid',\n    placeItems: 'center',\n    height: '6x',\n    radius: true,\n    preset: 's4',\n    fill: '(#color-picker, #clear)',\n    color: '(#color-picker-contrast, #dark)',\n    shadow: 'inset 0 0 0 1bw #dark.1',\n  },\n});\n\nconst ChannelsElement = tasty({\n  styles: {\n    display: 'grid',\n    gridColumns: 'max-content 1sf max-content',\n    placeItems: 'center stretch',\n    gap: '1x',\n  },\n});\n\nconst ChannelLabelElement = tasty({\n  styles: {\n    preset: 'c2',\n    color: '#dark-03',\n    textAlign: 'center',\n    width: '2x',\n  },\n});\n\nconst ChannelTrackElement = tasty({\n  styles: {\n    display: 'grid',\n    placeItems: 'center stretch',\n  },\n});\n\nconst ChannelValueElement = tasty({\n  styles: {\n    preset: 's4',\n    color: '#dark-02',\n    textAlign: 'right',\n    whiteSpace: 'nowrap',\n    width: '5.5x',\n  },\n});\n\n/**\n * The gradient reaches the track through a plain custom property so the track\n * keeps a single cached style rule. A color picker moves its channels\n * continuously, and a fresh `styles` object per frame would emit a fresh CSS\n * rule per frame.\n */\nconst TRACK_STYLES: Styles = {\n  height: '1x',\n  top: '.5x',\n  radius: '1r',\n  fill: '#clear',\n  image: '$channel-gradient',\n  shadow: 'inset 0 0 0 1bw #dark.1',\n  Fill: false,\n};\n\n/** A ring keeps the thumb visible wherever it sits on its own gradient. */\nconst THUMB_STYLES: Styles = {\n  shadow: '0 0 0 2bw #surface, 0 0 0 3bw #dark.2',\n};\n\nconst THUMB_TOKENS = { '#slider-thumb': '(#color-picker, #surface)' };\n\nconst SPACE_STYLES: Styles = { width: '100%' };\nconst TAB_STYLES: Styles = { flexGrow: 1 };\n\nexport interface ColorPickerPanelProps {\n  color: ColorValue;\n  space: ColorSpace;\n  isDisabled?: boolean;\n  /** Notation used for the preview caption. */\n  previewFormat: ColorFormat;\n  onChange: (color: ColorValue) => void;\n  onSpaceChange: (space: ColorSpace) => void;\n}\n\ninterface ChannelRowProps {\n  channel: ColorChannel;\n  color: ColorValue;\n  isDisabled?: boolean;\n  onChange: (color: ColorValue) => void;\n}\n\nfunction ChannelRow({ channel, color, isDisabled, onChange }: ChannelRowProps) {\n  const max = channel.max(color);\n\n  const handleChange = useEvent((value: number) => {\n    onChange(channel.apply(color, value));\n  });\n\n  return (\n    <>\n      <ChannelLabelElement aria-hidden=\"true\">\n        {channel.label}\n      </ChannelLabelElement>\n      <ChannelTrackElement\n        style={{\n          '--channel-gradient': `linear-gradient(to right, ${channel.stops(\n            color,\n          )})`,\n        }}\n      >\n        <Slider\n          aria-label={channel.title}\n          value={Math.min(channel.value(color), max)}\n          minValue={channel.min}\n          maxValue={max}\n          step={channel.step}\n          isDisabled={isDisabled}\n          trackStyles={TRACK_STYLES}\n          thumbStyles={THUMB_STYLES}\n          thumbTokens={THUMB_TOKENS}\n          onChange={handleChange}\n        />\n      </ChannelTrackElement>\n      <ChannelValueElement>{channel.display(color)}</ChannelValueElement>\n    </>\n  );\n}\n\n/**\n * The popover body of `ColorPicker`: a preview, a switch between the three\n * color concepts, and one gradient slider per channel of the active one.\n */\nexport function ColorPickerPanel(props: ColorPickerPanelProps) {\n  const { color, space, isDisabled, previewFormat, onChange, onSpaceChange } =\n    props;\n\n  const colorTokens = useMemo(\n    () => ({\n      '--color-picker-color': toHex(color),\n      '--color-picker-contrast-color': getContrastingColor(color),\n    }),\n    [color],\n  );\n\n  const handleSpaceChange = useEvent((value: string) => {\n    onSpaceChange(value as ColorSpace);\n  });\n\n  return (\n    <PanelElement style={colorTokens}>\n      <PreviewElement>{formatColor(color, previewFormat)}</PreviewElement>\n      <Radio.Tabs\n        aria-label=\"Color space\"\n        value={space}\n        isDisabled={isDisabled}\n        styles={SPACE_STYLES}\n        onChange={handleSpaceChange}\n      >\n        {COLOR_SPACES.map((item) => (\n          <Radio\n            key={item}\n            value={item}\n            aria-label={COLOR_SPACE_LABELS[item]}\n            tooltip={COLOR_SPACE_HINTS[item]}\n            styles={TAB_STYLES}\n          >\n            {COLOR_SPACE_LABELS[item]}\n          </Radio>\n        ))}\n      </Radio.Tabs>\n      <ChannelsElement>\n        {CHANNELS[space].map((channel) => (\n          <ChannelRow\n            key={`${space}-${channel.label}`}\n            channel={channel}\n            color={color}\n            isDisabled={isDisabled}\n            onChange={onChange}\n          />\n        ))}\n      </ChannelsElement>\n    </PanelElement>\n  );\n}\n"],"mappings":";;;;;;;;;;;AAuBA,MAAM,eAAe,MAAM;CACzB,IAAI;CACJ,QAAQ;EACN,SAAS;EACT,MAAM;EACN,KAAK;EACL,SAAS;EACT,OAAO;EACR;CACF,CAAC;AAEF,MAAM,iBAAiB,MAAM;CAC3B,IAAI;CACJ,QAAQ;EACN,SAAS;EACT,YAAY;EACZ,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,MAAM;EACN,OAAO;EACP,QAAQ;EACT;CACF,CAAC;AAEF,MAAM,kBAAkB,MAAM,EAC5B,QAAQ;CACN,SAAS;CACT,aAAa;CACb,YAAY;CACZ,KAAK;CACN,EACF,CAAC;AAEF,MAAM,sBAAsB,MAAM,EAChC,QAAQ;CACN,QAAQ;CACR,OAAO;CACP,WAAW;CACX,OAAO;CACR,EACF,CAAC;AAEF,MAAM,sBAAsB,MAAM,EAChC,QAAQ;CACN,SAAS;CACT,YAAY;CACb,EACF,CAAC;AAEF,MAAM,sBAAsB,MAAM,EAChC,QAAQ;CACN,QAAQ;CACR,OAAO;CACP,WAAW;CACX,YAAY;CACZ,OAAO;CACR,EACF,CAAC;;;;;;;AAQF,MAAM,eAAuB;CAC3B,QAAQ;CACR,KAAK;CACL,QAAQ;CACR,MAAM;CACN,OAAO;CACP,QAAQ;CACR,MAAM;CACP;;AAGD,MAAM,eAAuB,EAC3B,QAAQ,yCACT;AAED,MAAM,eAAe,EAAE,iBAAiB,6BAA6B;AAErE,MAAM,eAAuB,EAAE,OAAO,QAAQ;AAC9C,MAAM,aAAqB,EAAE,UAAU,GAAG;AAmB1C,SAAS,WAAW,EAAE,SAAS,OAAO,YAAY,YAA6B;CAC7E,MAAM,MAAM,QAAQ,IAAI,MAAM;CAE9B,MAAM,eAAe,UAAU,UAAkB;AAC/C,WAAS,QAAQ,MAAM,OAAO,MAAM,CAAC;GACrC;AAEF,QACE;EACE,oBAAC;GAAoB,eAAY;aAC9B,QAAQ;IACW;EACtB,oBAAC;GACC,OAAO,EACL,sBAAsB,6BAA6B,QAAQ,MACzD,MACD,CAAC,IACH;aAED,oBAACA;IACC,cAAY,QAAQ;IACpB,OAAO,KAAK,IAAI,QAAQ,MAAM,MAAM,EAAE,IAAI;IAC1C,UAAU,QAAQ;IAClB,UAAU;IACV,MAAM,QAAQ;IACF;IACZ,aAAa;IACb,aAAa;IACb,aAAa;IACb,UAAU;KACV;IACkB;EACtB,oBAAC,iCAAqB,QAAQ,QAAQ,MAAM,GAAuB;KAClE;;;;;;AAQP,SAAgB,iBAAiB,OAA8B;CAC7D,MAAM,EAAE,OAAO,OAAO,YAAY,eAAe,UAAU,kBACzD;CAEF,MAAM,cAAc,eACX;EACL,wBAAwB,MAAM,MAAM;EACpC,iCAAiC,oBAAoB,MAAM;EAC5D,GACD,CAAC,MAAM,CACR;CAED,MAAM,oBAAoB,UAAU,UAAkB;AACpD,gBAAc,MAAoB;GAClC;AAEF,QACE,qBAAC;EAAa,OAAO;;GACnB,oBAAC,4BAAgB,YAAY,OAAO,cAAc,GAAkB;GACpE,oBAACC,QAAM;IACL,cAAW;IACX,OAAO;IACK;IACZ,QAAQ;IACR,UAAU;cAET,aAAa,KAAK,SACjB,oBAACA;KAEC,OAAO;KACP,cAAY,mBAAmB;KAC/B,SAAS,kBAAkB;KAC3B,QAAQ;eAEP,mBAAmB;OANf,KAOC,CACR;KACS;GACb,oBAAC,6BACE,SAAS,OAAO,KAAK,YACpB,oBAAC;IAEU;IACF;IACK;IACF;MAJL,GAAG,MAAM,GAAG,QAAQ,QAKzB,CACF,GACc;;GACL"}

package/dist/components/fields/ColorPicker/channels.d.ts

@@ -0,0 +1,13 @@
+
+import "./color.js";
+
+//#region src/components/fields/ColorPicker/channels.d.ts
+/**
+ * The three color concepts the popover can be driven by. They all edit the
+ * same canonical value — only the axes the user manipulates differ.
+ */
+declare const COLOR_SPACES: readonly ["hst", "lch", "rgb"];
+type ColorSpace = (typeof COLOR_SPACES)[number];
+//#endregion
+export { COLOR_SPACES, ColorSpace };
+//# sourceMappingURL=channels.d.ts.map

package/dist/components/fields/ColorPicker/channels.js

@@ -0,0 +1,194 @@
+/** @license MIT | @cube-dev/ui-kit v0.156.0 | Cube Dev Team */
+import { fromOkhst, fromOklch, fromRgb, isAchromatic, maxChroma, normalizeHue, toHex, toOkhst, toOklch, toRgb } from "./color.js";
+
+//#region src/components/fields/ColorPicker/channels.ts
+/**
+* The three color concepts the popover can be driven by. They all edit the
+* same canonical value — only the axes the user manipulates differ.
+*/
+const COLOR_SPACES = [
+	"hst",
+	"lch",
+	"rgb"
+];
+const COLOR_SPACE_LABELS = {
+	hst: "HST",
+	lch: "LCH",
+	rgb: "RGB"
+};
+const COLOR_SPACE_HINTS = {
+	hst: "OKHST — hue, saturation, tone",
+	lch: "OKLCH — lightness, chroma, hue",
+	rgb: "sRGB — red, green, blue"
+};
+const constant = (value) => () => value;
+function round(value, precision = 2) {
+	const factor = 10 ** precision;
+	return Math.round(value * factor) / factor;
+}
+/**
+* `count` evenly spaced gradient stops, always as hex. Perceptual channels are
+* not linear in sRGB, so a two-stop gradient would misrepresent them —
+* sampling the real conversion keeps the track honest. Hex (rather than an
+* `okhsl()` string) because the gradient reaches the DOM as a raw custom
+* property, without passing through Tasty's color functions.
+*/
+function ramp(count, at) {
+	return Array.from({ length: count }, (_, index) => toHex(at(index / (count - 1)))).join(", ");
+}
+/**
+* The hue strip is drawn at full saturation and a fixed OKHSL lightness, which
+* keeps it perceptually even instead of spiking at yellow the way a CSS-HSL
+* rainbow does. Its own saturation and tone stay fixed: the strip is the same
+* in HST and in LCH, where `H` means the same thing.
+*/
+const HUE_STOPS = ramp(25, (position) => ({
+	h: position * 360,
+	s: 1,
+	l: .6
+}));
+const hueChannel = {
+	label: "H",
+	title: "Hue",
+	min: 0,
+	max: constant(359),
+	step: 1,
+	value: (color) => round(color.h, 1),
+	apply: (color, value) => ({
+		...color,
+		h: normalizeHue(value)
+	}),
+	stops: () => HUE_STOPS,
+	display: (color) => `${Math.round(color.h)}°`
+};
+const saturationChannel = {
+	label: "S",
+	title: "Saturation",
+	min: 0,
+	max: constant(100),
+	step: 1,
+	value: (color) => round(color.s * 100, 1),
+	apply: (color, value) => ({
+		...color,
+		s: value / 100
+	}),
+	stops: (color) => ramp(7, (position) => ({
+		...color,
+		s: position
+	})),
+	display: (color) => `${Math.round(color.s * 100)}%`
+};
+const toneChannel = {
+	label: "T",
+	title: "Tone",
+	min: 0,
+	max: constant(100),
+	step: 1,
+	value: (color) => round(toOkhst(color).t * 100, 1),
+	apply: (color, value) => fromOkhst({
+		h: color.h,
+		s: color.s,
+		t: value / 100
+	}),
+	stops: (color) => ramp(7, (position) => fromOkhst({
+		h: color.h,
+		s: color.s,
+		t: position
+	})),
+	display: (color) => `${Math.round(toOkhst(color).t * 100)}%`
+};
+const lightnessChannel = {
+	label: "L",
+	title: "Lightness",
+	min: 0,
+	max: constant(100),
+	step: 1,
+	value: (color) => round(toOklch(color).l * 100, 1),
+	apply: (color, value) => {
+		const { c, h } = toOklch(color);
+		return fromOklch({
+			l: value / 100,
+			c,
+			h
+		});
+	},
+	stops: (color) => {
+		const { c, h } = toOklch(color);
+		return ramp(7, (position) => fromOklch({
+			l: position,
+			c,
+			h
+		}));
+	},
+	display: (color) => `${Math.round(toOklch(color).l * 100)}%`
+};
+const chromaChannel = {
+	label: "C",
+	title: "Chroma",
+	min: 0,
+	max: (color) => Math.max(round(maxChroma(color.h, color.l), 4), .001),
+	step: .001,
+	value: (color) => round(toOklch(color).c, 4),
+	apply: (color, value) => {
+		const { l, h } = toOklch(color);
+		return fromOklch({
+			l,
+			c: value,
+			h
+		});
+	},
+	stops: (color) => {
+		const { l, h } = toOklch(color);
+		const limit = maxChroma(color.h, color.l);
+		return ramp(7, (position) => fromOklch({
+			l,
+			c: position * limit,
+			h
+		}));
+	},
+	display: (color) => toOklch(color).c.toFixed(3)
+};
+function rgbChannel(key, label, title) {
+	const at = (color, value) => fromRgb({
+		...toRgb(color),
+		[key]: value
+	});
+	return {
+		label,
+		title,
+		min: 0,
+		max: constant(255),
+		step: 1,
+		value: (color) => toRgb(color)[key],
+		apply: (color, value) => {
+			const next = at(color, value);
+			return isAchromatic(next) ? {
+				...next,
+				h: color.h
+			} : next;
+		},
+		stops: (color) => ramp(2, (position) => at(color, position * 255)),
+		display: (color) => `${toRgb(color)[key]}`
+	};
+}
+const CHANNELS = {
+	hst: [
+		hueChannel,
+		saturationChannel,
+		toneChannel
+	],
+	lch: [
+		lightnessChannel,
+		chromaChannel,
+		hueChannel
+	],
+	rgb: [
+		rgbChannel("r", "R", "Red"),
+		rgbChannel("g", "G", "Green"),
+		rgbChannel("b", "B", "Blue")
+	]
+};
+
+//#endregion
+export { CHANNELS, COLOR_SPACES, COLOR_SPACE_HINTS, COLOR_SPACE_LABELS };
+//# sourceMappingURL=channels.js.map

package/dist/components/fields/ColorPicker/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","names":[],"sources":["../../../../src/components/fields/ColorPicker/channels.ts"],"sourcesContent":["import {\n  ColorValue,\n  fromOkhst,\n  fromOklch,\n  fromRgb,\n  isAchromatic,\n  maxChroma,\n  normalizeHue,\n  toHex,\n  toOkhst,\n  toOklch,\n  toRgb,\n} from './color';\n\n/**\n * The three color concepts the popover can be driven by. They all edit the\n * same canonical value — only the axes the user manipulates differ.\n */\nexport const COLOR_SPACES = ['hst', 'lch', 'rgb'] as const;\n\nexport type ColorSpace = (typeof COLOR_SPACES)[number];\n\nexport const COLOR_SPACE_LABELS: Record<ColorSpace, string> = {\n  hst: 'HST',\n  lch: 'LCH',\n  rgb: 'RGB',\n};\n\nexport const COLOR_SPACE_HINTS: Record<ColorSpace, string> = {\n  hst: 'OKHST — hue, saturation, tone',\n  lch: 'OKLCH — lightness, chroma, hue',\n  rgb: 'sRGB — red, green, blue',\n};\n\nexport interface ColorChannel {\n  /** Single-letter axis name shown next to the slider. */\n  label: string;\n  /** Accessible name for the slider. */\n  title: string;\n  min: number;\n  step: number;\n  /** The upper bound. Chroma is gamut-bound, so it depends on the color. */\n  max: (color: ColorValue) => number;\n  value: (color: ColorValue) => number;\n  /** The color this channel produces when moved to `value`. */\n  apply: (color: ColorValue, value: number) => ColorValue;\n  /** Comma-separated gradient stops describing the channel's whole range. */\n  stops: (color: ColorValue) => string;\n  /** Human-readable rendering of the current channel value. */\n  display: (color: ColorValue) => string;\n}\n\nconst constant = (value: number) => () => value;\n\nfunction round(value: number, precision = 2): number {\n  const factor = 10 ** precision;\n\n  return Math.round(value * factor) / factor;\n}\n\n/**\n * `count` evenly spaced gradient stops, always as hex. Perceptual channels are\n * not linear in sRGB, so a two-stop gradient would misrepresent them —\n * sampling the real conversion keeps the track honest. Hex (rather than an\n * `okhsl()` string) because the gradient reaches the DOM as a raw custom\n * property, without passing through Tasty's color functions.\n */\nfunction ramp(count: number, at: (position: number) => ColorValue): string {\n  return Array.from({ length: count }, (_, index) =>\n    toHex(at(index / (count - 1))),\n  ).join(', ');\n}\n\n/**\n * The hue strip is drawn at full saturation and a fixed OKHSL lightness, which\n * keeps it perceptually even instead of spiking at yellow the way a CSS-HSL\n * rainbow does. Its own saturation and tone stay fixed: the strip is the same\n * in HST and in LCH, where `H` means the same thing.\n */\nconst HUE_STOPS = ramp(25, (position) => ({\n  h: position * 360,\n  s: 1,\n  l: 0.6,\n}));\n\nconst hueChannel: ColorChannel = {\n  label: 'H',\n  title: 'Hue',\n  min: 0,\n  // 360° is the same angle as 0°, so the last usable stop is 359 — the range\n  // `HueSlider` exposes as well.\n  max: constant(359),\n  step: 1,\n  value: (color) => round(color.h, 1),\n  apply: (color, value) => ({ ...color, h: normalizeHue(value) }),\n  stops: () => HUE_STOPS,\n  display: (color) => `${Math.round(color.h)}°`,\n};\n\nconst saturationChannel: ColorChannel = {\n  label: 'S',\n  title: 'Saturation',\n  min: 0,\n  max: constant(100),\n  step: 1,\n  value: (color) => round(color.s * 100, 1),\n  apply: (color, value) => ({ ...color, s: value / 100 }),\n  stops: (color) => ramp(7, (position) => ({ ...color, s: position })),\n  display: (color) => `${Math.round(color.s * 100)}%`,\n};\n\nconst toneChannel: ColorChannel = {\n  label: 'T',\n  title: 'Tone',\n  min: 0,\n  max: constant(100),\n  step: 1,\n  value: (color) => round(toOkhst(color).t * 100, 1),\n  apply: (color, value) =>\n    fromOkhst({ h: color.h, s: color.s, t: value / 100 }),\n  stops: (color) =>\n    ramp(7, (position) => fromOkhst({ h: color.h, s: color.s, t: position })),\n  display: (color) => `${Math.round(toOkhst(color).t * 100)}%`,\n};\n\nconst lightnessChannel: ColorChannel = {\n  label: 'L',\n  title: 'Lightness',\n  min: 0,\n  max: constant(100),\n  step: 1,\n  value: (color) => round(toOklch(color).l * 100, 1),\n  apply: (color, value) => {\n    const { c, h } = toOklch(color);\n\n    return fromOklch({ l: value / 100, c, h });\n  },\n  stops: (color) => {\n    const { c, h } = toOklch(color);\n\n    return ramp(7, (position) => fromOklch({ l: position, c, h }));\n  },\n  display: (color) => `${Math.round(toOklch(color).l * 100)}%`,\n};\n\nconst chromaChannel: ColorChannel = {\n  label: 'C',\n  title: 'Chroma',\n  min: 0,\n  // Chroma has no fixed ceiling: how far it can go depends on how far the sRGB\n  // gamut reaches at the current lightness and hue. Never zero, so the slider\n  // always has a range to divide by.\n  max: (color) => Math.max(round(maxChroma(color.h, color.l), 4), 0.001),\n  step: 0.001,\n  value: (color) => round(toOklch(color).c, 4),\n  apply: (color, value) => {\n    const { l, h } = toOklch(color);\n\n    return fromOklch({ l, c: value, h });\n  },\n  stops: (color) => {\n    const { l, h } = toOklch(color);\n    const limit = maxChroma(color.h, color.l);\n\n    return ramp(7, (position) => fromOklch({ l, c: position * limit, h }));\n  },\n  display: (color) => toOklch(color).c.toFixed(3),\n};\n\nfunction rgbChannel(\n  key: 'r' | 'g' | 'b',\n  label: string,\n  title: string,\n): ColorChannel {\n  const at = (color: ColorValue, value: number) =>\n    fromRgb({ ...toRgb(color), [key]: value });\n\n  return {\n    label,\n    title,\n    min: 0,\n    max: constant(255),\n    step: 1,\n    value: (color) => toRgb(color)[key],\n    apply: (color, value) => {\n      const next = at(color, value);\n\n      // A gray has no hue of its own, and the conversion invents one. Keeping\n      // the authored hue means switching back to HST or LCH resumes where the\n      // user left off.\n      return isAchromatic(next) ? { ...next, h: color.h } : next;\n    },\n    // An sRGB channel is linear in the space CSS interpolates gradients in, so\n    // the two ends describe the whole ramp exactly.\n    stops: (color) => ramp(2, (position) => at(color, position * 255)),\n    display: (color) => `${toRgb(color)[key]}`,\n  };\n}\n\nexport const CHANNELS: Record<ColorSpace, ColorChannel[]> = {\n  hst: [hueChannel, saturationChannel, toneChannel],\n  lch: [lightnessChannel, chromaChannel, hueChannel],\n  rgb: [\n    rgbChannel('r', 'R', 'Red'),\n    rgbChannel('g', 'G', 'Green'),\n    rgbChannel('b', 'B', 'Blue'),\n  ],\n};\n"],"mappings":"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"}