@cube-dev/ui-kit 0.156.0 → 0.157.1

package/dist/components/data/TableBase/use-table-storage.js

@@ -0,0 +1,58 @@
+/** @license MIT | @cube-dev/ui-kit v0.157.1 | Cube Dev Team */
+import { useCallback, useRef, useState } from "react";
+
+//#region src/components/data/TableBase/use-table-storage.ts
+/**
+* Namespaced so a `storageKey` cannot collide with whatever else the host app
+* keeps in `localStorage`, and so the kit's own stored shape can be migrated or
+* cleared as a group later.
+*/
+const PREFIX = "cube-ui-kit:table:";
+const DEFAULT_PERSIST_KEYS = ["pageSize", "columnWidths"];
+function read(storageKey) {
+	if (!storageKey || typeof window === "undefined") return {};
+	try {
+		const raw = window.localStorage.getItem(PREFIX + storageKey);
+		if (!raw) return {};
+		const parsed = JSON.parse(raw);
+		return parsed && typeof parsed === "object" ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+/**
+* Persists the parts of the table's own state that a user expects to survive a
+* reload. Only state the table *owns* is stored: a controlled `pageSize` or
+* `sort` belongs to the page, so restoring it would fight the page's own source
+* of truth.
+*
+* Returns the state read at mount — a one-shot snapshot, deliberately, so a
+* second table sharing the key cannot yank this one's page size mid-session.
+*/
+function useTableStorage(storageKey, persist = DEFAULT_PERSIST_KEYS) {
+	const [initial] = useState(() => read(storageKey));
+	const persistRef = useRef(persist);
+	persistRef.current = persist;
+	const write = useCallback((patch) => {
+		if (!storageKey || typeof window === "undefined") return;
+		const allowed = persistRef.current;
+		const entries = Object.entries(patch).filter(([key]) => allowed.includes(key));
+		if (!entries.length) return;
+		try {
+			const next = {
+				...read(storageKey),
+				...Object.fromEntries(entries)
+			};
+			window.localStorage.setItem(PREFIX + storageKey, JSON.stringify(next));
+		} catch {}
+	}, [storageKey]);
+	return {
+		initial: storageKey ? initial : {},
+		has: (key) => !!storageKey && persist.includes(key),
+		write
+	};
+}
+
+//#endregion
+export { useTableStorage };
+//# sourceMappingURL=use-table-storage.js.map

package/dist/components/data/TableBase/use-table-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-table-storage.js","names":[],"sources":["../../../../src/components/data/TableBase/use-table-storage.ts"],"sourcesContent":["import { useCallback, useRef, useState } from 'react';\n\nimport type { CubeTableSort } from './types';\n\n/**\n * Namespaced so a `storageKey` cannot collide with whatever else the host app\n * keeps in `localStorage`, and so the kit's own stored shape can be migrated or\n * cleared as a group later.\n */\nconst PREFIX = 'cube-ui-kit:table:';\n\nexport type CubeTablePersistKey = 'pageSize' | 'columnWidths' | 'sort';\n\nexport interface CubeTableStoredState {\n  pageSize?: number;\n  sort?: CubeTableSort | null;\n  columnWidths?: Record<string, number>;\n}\n\nexport const DEFAULT_PERSIST_KEYS: CubeTablePersistKey[] = [\n  'pageSize',\n  'columnWidths',\n];\n\nfunction read(storageKey: string | undefined): CubeTableStoredState {\n  // No `storageKey` means the feature is off; no `window` means SSR. Both are\n  // normal, not errors.\n  if (!storageKey || typeof window === 'undefined') return {};\n\n  try {\n    const raw = window.localStorage.getItem(PREFIX + storageKey);\n\n    if (!raw) return {};\n\n    const parsed = JSON.parse(raw);\n\n    // Anything could be under that key — a hand-edited value, a stale shape\n    // from an older version. A non-object is simply ignored.\n    return parsed && typeof parsed === 'object' ? parsed : {};\n  } catch {\n    // Private mode, a disabled store, or malformed JSON. Persistence is a\n    // convenience; losing it must never take the table down with it.\n    return {};\n  }\n}\n\n/**\n * Persists the parts of the table's own state that a user expects to survive a\n * reload. Only state the table *owns* is stored: a controlled `pageSize` or\n * `sort` belongs to the page, so restoring it would fight the page's own source\n * of truth.\n *\n * Returns the state read at mount — a one-shot snapshot, deliberately, so a\n * second table sharing the key cannot yank this one's page size mid-session.\n */\nexport function useTableStorage(\n  storageKey: string | undefined,\n  persist: CubeTablePersistKey[] = DEFAULT_PERSIST_KEYS,\n) {\n  const [initial] = useState(() => read(storageKey));\n  const persistRef = useRef(persist);\n\n  persistRef.current = persist;\n\n  const write = useCallback(\n    (patch: CubeTableStoredState) => {\n      if (!storageKey || typeof window === 'undefined') return;\n\n      const allowed = persistRef.current;\n      const entries = Object.entries(patch).filter(([key]) =>\n        allowed.includes(key as CubeTablePersistKey),\n      );\n\n      if (!entries.length) return;\n\n      try {\n        const next = {\n          ...read(storageKey),\n          ...Object.fromEntries(entries),\n        };\n\n        window.localStorage.setItem(PREFIX + storageKey, JSON.stringify(next));\n      } catch {\n        // Quota exceeded or a disabled store — nothing to do but carry on.\n      }\n    },\n    [storageKey],\n  );\n\n  return {\n    initial: storageKey ? initial : {},\n    /** `true` when this key is persisted, so callers can skip the work. */\n    has: (key: CubeTablePersistKey) => !!storageKey && persist.includes(key),\n    write,\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,SAAS;AAUf,MAAa,uBAA8C,CACzD,YACA,eACD;AAED,SAAS,KAAK,YAAsD;AAGlE,KAAI,CAAC,cAAc,OAAO,WAAW,YAAa,QAAO,EAAE;AAE3D,KAAI;EACF,MAAM,MAAM,OAAO,aAAa,QAAQ,SAAS,WAAW;AAE5D,MAAI,CAAC,IAAK,QAAO,EAAE;EAEnB,MAAM,SAAS,KAAK,MAAM,IAAI;AAI9B,SAAO,UAAU,OAAO,WAAW,WAAW,SAAS,EAAE;SACnD;AAGN,SAAO,EAAE;;;;;;;;;;;;AAab,SAAgB,gBACd,YACA,UAAiC,sBACjC;CACA,MAAM,CAAC,WAAW,eAAe,KAAK,WAAW,CAAC;CAClD,MAAM,aAAa,OAAO,QAAQ;AAElC,YAAW,UAAU;CAErB,MAAM,QAAQ,aACX,UAAgC;AAC/B,MAAI,CAAC,cAAc,OAAO,WAAW,YAAa;EAElD,MAAM,UAAU,WAAW;EAC3B,MAAM,UAAU,OAAO,QAAQ,MAAM,CAAC,QAAQ,CAAC,SAC7C,QAAQ,SAAS,IAA2B,CAC7C;AAED,MAAI,CAAC,QAAQ,OAAQ;AAErB,MAAI;GACF,MAAM,OAAO;IACX,GAAG,KAAK,WAAW;IACnB,GAAG,OAAO,YAAY,QAAQ;IAC/B;AAED,UAAO,aAAa,QAAQ,SAAS,YAAY,KAAK,UAAU,KAAK,CAAC;UAChE;IAIV,CAAC,WAAW,CACb;AAED,QAAO;EACL,SAAS,aAAa,UAAU,EAAE;EAElC,MAAM,QAA6B,CAAC,CAAC,cAAc,QAAQ,SAAS,IAAI;EACxE;EACD"}

package/dist/components/data/index.d.ts

@@ -0,0 +1,10 @@
+
+import { CubeTableAlign, CubeTableCellContext, CubeTableColumn, CubeTableColumnHeader, CubeTableHeaderContext, CubeTableRowContext, CubeTableRowSection, CubeTableSort, CubeTableSortDirection } from "./TableBase/types.js";
+import { CubeDataTableColumn, CubeDataTableProps } from "./DataTable/types.js";
+import { _DataTable } from "./DataTable/DataTable.js";
+import "./DataTable/index.js";
+import { CubeTableRowRenderProps } from "./TableBase/TableView.js";
+import { CubeItemTableColumn, CubeItemTableProps } from "./ItemTable/types.js";
+import { _ItemTable } from "./ItemTable/ItemTable.js";
+import "./ItemTable/index.js";
+import "./TableBase/index.js";

package/dist/components/fields/Checkbox/Checkbox.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.156.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.1 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { _Text } from "../../content/Text.js";

package/dist/components/fields/Checkbox/CheckboxGroup.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.156.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.1 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { FormContext } from "../../form/Form/Form.js";

package/dist/components/fields/Checkbox/context.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.156.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.1 | Cube Dev Team */
 import { createContext } from "react";
 
 //#region src/components/fields/Checkbox/context.ts

package/dist/components/fields/ColorInput/ColorInput.d.ts

@@ -0,0 +1,67 @@
+
+import { FieldBaseProps } from "../../../shared/form.js";
+import "../../../shared/index.js";
+import { ColorFormat } from "../color/color.js";
+import { ColorSpace } from "../color/channels.js";
+import { BaseProps, BaseStyleProps, BlockStyleProps, ColorStyleProps, OuterStyleProps, Styles } from "@tenphi/tasty";
+import * as react from "react";
+import { FocusEvent } from "react";
+
+//#region src/components/fields/ColorInput/ColorInput.d.ts
+/**
+ * How the text in the input relates to the committed value.
+ *
+ * - `forced` — the text is rewritten in `format` whenever it is not mid-edit,
+ *   and the value is always written in `format`.
+ * - `derive` — the user's own notation is left alone, and the value is
+ *   normalized in whichever notation the text is written in.
+ * - `free` — the text *is* the value, verbatim. It is still verified, so an
+ *   unparsable entry falls back to the last valid one.
+ */
+type ColorInputFormatMode = 'forced' | 'derive' | 'free';
+interface CubeColorInputProps extends BaseProps, BaseStyleProps, OuterStyleProps, BlockStyleProps, ColorStyleProps, FieldBaseProps {
+  /** The selected color, as a color string. */
+  value?: string | null;
+  /** The initial color of an uncontrolled picker. */
+  defaultValue?: string | null;
+  /** Called with the normalized color string, or `null` when the field is cleared. */
+  onChange?: (value: string | null) => void;
+  /** Notation the value is written in, and the one `forced` mode displays. */
+  format?: ColorFormat;
+  /** How strictly the input text is tied to `format`. */
+  formatMode?: ColorInputFormatMode;
+  /** Color concept the popover opens with. */
+  defaultSpace?: ColorSpace;
+  /** Whether the popover is open. Makes the disclosure controlled. */
+  isOpen?: boolean;
+  /** Whether the popover is open initially. */
+  defaultOpen?: boolean;
+  /** Called when the popover opens or closes. */
+  onOpenChange?: (isOpen: boolean) => void;
+  /** Whether the popover may flip to the other side of the input. */
+  shouldFlip?: boolean;
+  /** Text shown while the field is empty. */
+  placeholder?: string;
+  /** The size of the input. */
+  size?: 'small' | 'medium' | 'large' | (string & {});
+  onFocus?: (event: FocusEvent<HTMLInputElement>) => void;
+  onBlur?: (event: FocusEvent<HTMLInputElement>) => void;
+  'aria-label'?: string;
+  'aria-labelledby'?: string;
+  'aria-describedby'?: string;
+  styles?: Styles;
+  /** Styles of the text input element. */
+  inputStyles?: Styles;
+  /** Styles of the popover trigger button. */
+  triggerStyles?: Styles;
+  /** Styles of the color swatch shown inside the input. */
+  swatchStyles?: Styles;
+}
+/**
+ * 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.
+ */
+declare const ColorInput: react.ForwardRefExoticComponent<CubeColorInputProps & react.RefAttributes<HTMLElement>>;
+//#endregion
+export { ColorInput, ColorInputFormatMode, CubeColorInputProps };
+//# sourceMappingURL=ColorInput.d.ts.map

package/dist/components/fields/ColorInput/ColorInput.js

@@ -0,0 +1,230 @@
+/** @license MIT | @cube-dev/ui-kit v0.157.1 | 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 } from "../color/color.js";
+import { ColorSwatch } from "../color/ColorSwatch.js";
+import { ColorPanel } from "../color/ColorPanel.js";
+import { useIsInsideColorPopover } from "../color/context.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/ColorInput/ColorInput.tsx
+/**
+* A popover caps its height at half the viewport. The panel can exceed that on
+* a short screen, and would otherwise spill outside the popover's own border.
+*/
+const POPOVER_STYLES = { overflow: "auto" };
+/** What the popover starts from when there is no color to edit yet. */
+const FALLBACK_COLOR = {
+	h: 264,
+	s: .8,
+	l: .6
+};
+const ColorInputTrigger = tasty(ItemAction, {
+	qa: "ColorInputTrigger",
+	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 ColorInput = forwardRef(function ColorInput(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 isInsidePopover = useIsInsideColorPopover();
+	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 || "ColorInput",
+		size,
+		autocomplete: "off",
+		icon: /* @__PURE__ */ jsx(ColorSwatch, {
+			color,
+			styles: swatchStyles
+		}),
+		inputRef,
+		inputProps: {
+			...inputProps,
+			spellCheck: false,
+			onMouseDown: handleMouseDown
+		},
+		inputStyles,
+		labelProps: mergeProps$1(labelProps, userLabelProps),
+		wrapperRef: targetRef,
+		isDisabled,
+		isReadOnly,
+		isInvalid,
+		isValid,
+		isLoading,
+		suffixPosition: "after",
+		suffix: isInsidePopover ? null : /* @__PURE__ */ jsxs(DialogTrigger, {
+			hideArrow: true,
+			type: "popover",
+			mobileType: "tray",
+			placement: "bottom right",
+			targetRef,
+			isOpen: controlledOpen ?? isOpen,
+			shouldFlip,
+			onOpenChange: handleOpenChange,
+			children: [/* @__PURE__ */ jsx(ColorInputTrigger, {
+				size,
+				"aria-label": "Open the color picker",
+				isDisabled: isDisabled || isReadOnly,
+				styles: triggerStyles
+			}), /* @__PURE__ */ jsx(Dialog, {
+				"aria-label": "Color picker",
+				width: "max-content",
+				styles: POPOVER_STYLES,
+				children: /* @__PURE__ */ jsx(ColorPanel, {
+					color: color ?? FALLBACK_COLOR,
+					space,
+					isDisabled: isDisabled || isReadOnly,
+					previewFormat: outputFormat(text),
+					onChange: handleColorChange,
+					onSpaceChange: setSpace
+				})
+			})]
+		})
+	});
+});
+ColorInput.cubeInputType = "Text";
+
+//#endregion
+export { ColorInput };
+//# sourceMappingURL=ColorInput.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorInput.js","names":["mergeProps"],"sources":["../../../../src/components/fields/ColorInput/ColorInput.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 { ColorSpace } from '../color/channels';\nimport {\n  ColorFormat,\n  ColorValue,\n  detectFormat,\n  formatColor,\n  parseColor,\n} from '../color/color';\nimport { ColorPanel } from '../color/ColorPanel';\nimport { ColorSwatch } from '../color/ColorSwatch';\nimport { useIsInsideColorPopover } from '../color/context';\nimport { TextInputBase } from '../TextInput/TextInputBase';\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 ColorInputFormatMode = 'forced' | 'derive' | 'free';\n\n/**\n * A popover caps its height at half the viewport. The panel can exceed that on\n * a short screen, and would otherwise spill outside the popover's own border.\n */\nconst POPOVER_STYLES: Styles = { overflow: 'auto' };\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 ColorInputTrigger = tasty(ItemAction, {\n  qa: 'ColorInputTrigger',\n  icon: <PipetteIcon />,\n});\n\nexport interface CubeColorInputProps\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?: ColorInputFormatMode;\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 ColorInput = forwardRef(function ColorInput(\n  allProps: CubeColorInputProps,\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  // Already inside a color popover: this is the value field for that popover,\n  // so it must not offer a popover of its own.\n  const isInsidePopover = useIsInsideColorPopover();\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 || 'ColorInput'}\n      size={size}\n      autocomplete=\"off\"\n      icon={<ColorSwatch color={color} styles={swatchStyles} />}\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        isInsidePopover ? null : (\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            <ColorInputTrigger\n              size={size}\n              aria-label=\"Open the color picker\"\n              isDisabled={isDisabled || isReadOnly}\n              styles={triggerStyles}\n            />\n            <Dialog\n              aria-label=\"Color picker\"\n              width=\"max-content\"\n              styles={POPOVER_STYLES}\n            >\n              <ColorPanel\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\n(ColorInput as any).cubeInputType = 'Text';\n"],"mappings":"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"}

package/dist/components/fields/ColorInput/index.d.ts

@@ -0,0 +1,2 @@
+
+import { ColorInput, ColorInputFormatMode, CubeColorInputProps } from "./ColorInput.js";

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

@@ -1,35 +1,26 @@
 
 import { FieldBaseProps } from "../../../shared/form.js";
 import "../../../shared/index.js";
-import { ColorFormat } from "./color.js";
-import { ColorSpace } from "./channels.js";
-import { BaseProps, BaseStyleProps, BlockStyleProps, ColorStyleProps, OuterStyleProps, Styles } from "@tenphi/tasty";
+import "../../content/Item/index.js";
+import { CubeItemProps } from "../../content/Item/Item.js";
+import { ColorFormat } from "../color/color.js";
+import { ColorSpace } from "../color/channels.js";
+import { CubeColorSwatchItem } from "../ColorSwatchGroup/ColorSwatchGroup.js";
+import "../ColorSwatchGroup/index.js";
+import { BaseProps, BlockStyleProps, OuterStyleProps, Styles } from "@tenphi/tasty";
 import * as react from "react";
-import { FocusEvent } from "react";
+import { ReactNode } from "react";
 
 //#region src/components/fields/ColorPicker/ColorPicker.d.ts
-/**
- * How the text in the input relates to the committed value.
- *
- * - `forced` — the text is rewritten in `format` whenever it is not mid-edit,
- *   and the value is always written in `format`.
- * - `derive` — the user's own notation is left alone, and the value is
- *   normalized in whichever notation the text is written in.
- * - `free` — the text *is* the value, verbatim. It is still verified, so an
- *   unparsable entry falls back to the last valid one.
- */
-type ColorPickerFormatMode = 'forced' | 'derive' | 'free';
-interface CubeColorPickerProps extends BaseProps, BaseStyleProps, OuterStyleProps, BlockStyleProps, ColorStyleProps, FieldBaseProps {
+interface CubeColorPickerProps extends BaseProps, OuterStyleProps, BlockStyleProps, FieldBaseProps {
   /** The selected color, as a color string. */
   value?: string | null;
   /** The initial color of an uncontrolled picker. */
   defaultValue?: string | null;
-  /** Called with the normalized color string, or `null` when the field is cleared. */
+  /** Called with the color string, or `null` when there is no color. */
   onChange?: (value: string | null) => void;
-  /** Notation the value is written in, and the one `forced` mode displays. */
+  /** Notation the value is written in. */
   format?: ColorFormat;
-  /** How strictly the input text is tied to `format`. */
-  formatMode?: ColorPickerFormatMode;
   /** Color concept the popover opens with. */
   defaultSpace?: ColorSpace;
   /** Whether the popover is open. Makes the disclosure controlled. */
@@ -38,30 +29,36 @@ interface CubeColorPickerProps extends BaseProps, BaseStyleProps, OuterStyleProp
   defaultOpen?: boolean;
   /** Called when the popover opens or closes. */
   onOpenChange?: (isOpen: boolean) => void;
-  /** Whether the popover may flip to the other side of the input. */
+  /** Whether the popover may flip to the other side of the trigger. */
   shouldFlip?: boolean;
-  /** Text shown while the field is empty. */
-  placeholder?: string;
-  /** The size of the input. */
-  size?: 'small' | 'medium' | 'large' | (string & {});
-  onFocus?: (event: FocusEvent<HTMLInputElement>) => void;
-  onBlur?: (event: FocusEvent<HTMLInputElement>) => void;
-  'aria-label'?: string;
-  'aria-labelledby'?: string;
-  'aria-describedby'?: string;
+  /** Replaces the color shown on the trigger. Pass `null` for a swatch on its own. */
+  children?: ReactNode;
+  /** Shown on the trigger while there is no color. */
+  placeholder?: ReactNode;
+  /** The size of the trigger. */
+  size?: CubeItemProps['size'];
+  /** The visual type of the trigger. */
+  type?: CubeItemProps['type'];
+  theme?: CubeItemProps['theme'];
+  /** Tooltip for the trigger, separate from the field tooltip. */
+  triggerTooltip?: CubeItemProps['tooltip'];
+  /** Colors to offer under the editor, for picking without dialing one in. */
+  swatches?: CubeColorSwatchItem[];
+  /** How many swatches per row. Defaults to a single row. */
+  swatchColumns?: number;
   styles?: Styles;
-  /** Styles of the text input element. */
-  inputStyles?: Styles;
-  /** Styles of the popover trigger button. */
+  /** Styles of the trigger button. */
   triggerStyles?: Styles;
-  /** Styles of the color swatch shown inside the input. */
+  /** Styles of the color swatch. */
   swatchStyles?: Styles;
+  'aria-label'?: string;
 }
 /**
- * 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.
+ * A color swatch that opens the color popover — the same one `ColorInput`
+ * uses, without the text field. Reach for it when a color is chosen but never
+ * typed: a toolbar, a chart legend, a cell in a dense table.
  */
 declare const ColorPicker: react.ForwardRefExoticComponent<CubeColorPickerProps & react.RefAttributes<HTMLElement>>;
 //#endregion
-export { ColorPicker, ColorPickerFormatMode, CubeColorPickerProps };
+export { ColorPicker, CubeColorPickerProps };
 //# sourceMappingURL=ColorPicker.d.ts.map