@cube-dev/ui-kit 0.142.10 → 0.143.0

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

@@ -0,0 +1,99 @@
+
+import { _CollectionItem } from "../../CollectionItem.js";
+import { CubeTextInputBaseProps } from "../TextInput/TextInputBase.js";
+import { ListStateLike, TextFilterFn } from "../ListBoxPopover/listNavigation.js";
+import "../ListBoxPopover/index.js";
+import { ForwardedRef, ReactElement, ReactNode, RefObject } from "react";
+import { Section } from "react-stately";
+import { Key as Key$1 } from "@react-types/shared";
+
+//#region src/components/fields/CommandTextArea/CommandTextArea.d.ts
+/** A single trigger character with optional placement constraint. */
+interface CommandTrigger {
+  /** The character that opens the autocomplete (e.g. `/` or `@`). */
+  char: string;
+  /**
+   * When true, the trigger token must start at the beginning of the line the
+   * caret is on (right after a newline, or at the very start of the input) —
+   * i.e. line-scoped slash commands. When false, the token may appear after
+   * any whitespace, anywhere in the text (Slack/Notion-style).
+   */
+  atLineStart?: boolean;
+}
+/** Result of scanning the textarea for an active trigger token. */
+interface ActiveToken {
+  /** The matched trigger descriptor. */
+  trigger: CommandTrigger;
+  /** The active token text, INCLUDING the trigger char (e.g. `/cle`). */
+  token: string;
+  /** Inclusive start index of the token in the textarea value. */
+  start: number;
+  /** Exclusive end index of the token (caret position while typing). */
+  end: number;
+}
+type CommandTextAreaFilterFn = TextFilterFn;
+interface CubeCommandTextAreaProps<T> extends Omit<CubeTextInputBaseProps, 'children' | 'multiLine'> {
+  /** Whether the textarea should resize to fit its content. */
+  autoSize?: boolean;
+  /** Max visible rows when `autoSize` is true. Defaults to 10. */
+  maxRows?: number;
+  /** Number of visible rows. Defaults to 3. */
+  rows?: number;
+  /** Command/option source (alternative to JSX children). */
+  items?: Iterable<T>;
+  /** Static items or a render function (same shape as ComboBox/ListBox). */
+  children?: ReactNode | ((item: T) => ReactElement);
+  /**
+   * Triggers that open the autocomplete. Defaults to a single slash command
+   * that must start at the beginning of the input.
+   */
+  triggers?: CommandTrigger[];
+  /**
+   * Custom filter. Pass `false` to disable internal filtering (server-side).
+   */
+  filter?: CommandTextAreaFilterFn | false;
+  /**
+   * Fired when the user picks a command (Enter/Tab/click). The option's
+   * `textValue` is also inserted into the textarea regardless.
+   */
+  onCommand?: (key: Key$1, item: {
+    textValue: string;
+    [k: string]: any;
+  }) => void;
+  /** Insert a trailing space after the chosen command. Defaults to true. */
+  insertSpaceAfter?: boolean;
+  /** Keys of disabled options. */
+  disabledKeys?: Iterable<Key$1>;
+  /** Popover placement. Chat inputs usually want `top`. Defaults to `top`. */
+  direction?: 'bottom' | 'top';
+  /** Whether the popover should flip when overflowing. Defaults to true. */
+  shouldFlip?: boolean;
+  /** Offset between the textarea and the popover. */
+  overlayOffset?: number;
+  /** Padding between the popover and the viewport edge. */
+  containerPadding?: number;
+  /** Ref for the textarea element. */
+  inputRef?: RefObject<HTMLTextAreaElement>;
+  /** Ref for the wrapper element (popover anchor). */
+  wrapperRef?: RefObject<HTMLDivElement>;
+  /** Ref for the popover overlay element. */
+  popoverRef?: RefObject<HTMLDivElement>;
+  /** Ref for the listbox element. */
+  listBoxRef?: RefObject<HTMLDivElement>;
+  /** Ref through which the internal list state is exposed. */
+  listStateRef?: RefObject<ListStateLike | null>;
+  overlayStyles?: any;
+  listBoxStyles?: any;
+  optionStyles?: any;
+  sectionStyles?: any;
+  headingStyles?: any;
+}
+declare const _CommandTextArea: (<T>(props: CubeCommandTextAreaProps<T> & {
+  ref?: ForwardedRef<HTMLElement>;
+}) => ReactElement) & {
+  Item: typeof _CollectionItem;
+  Section: typeof Section;
+};
+//#endregion
+export { ActiveToken, CommandTextAreaFilterFn, CommandTrigger, CubeCommandTextAreaProps, _CommandTextArea };
+//# sourceMappingURL=CommandTextArea.d.ts.map

package/dist/components/fields/CommandTextArea/CommandTextArea.js

@@ -0,0 +1,402 @@
+/** @license MIT | @cube-dev/ui-kit v0.143.0 | Cube Dev Team */
+import { chain } from "../../../utils/react/chain.js";
+import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
+import { useCombinedRefs } from "../../../utils/react/useCombinedRefs.js";
+import { useEvent } from "../../../_internal/hooks/use-event.js";
+import { useProviderProps } from "../../../provider.js";
+import { _CollectionItem } from "../../CollectionItem.js";
+import { generateRandomId } from "../../../utils/random.js";
+import { useFormProps } from "../../form/Form/Form.js";
+import { useFieldProps } from "../../form/Form/use-field/use-field-props.js";
+import { castNullableStringValue } from "../../../utils/react/nullableValue.js";
+import { TextInputBase } from "../TextInput/TextInputBase.js";
+import { ListBoxPopover } from "../ListBoxPopover/ListBoxPopover.js";
+import { useCompositeFocus } from "../ListBoxPopover/useCompositeFocus.js";
+import { collectVisibleKeys, filterCollectionNodes, getEdgeVisibleKey, getNextVisibleKey, markKeyboardFocus } from "../ListBoxPopover/listNavigation.js";
+import { useCaretAnchor } from "./useCaretAnchor.js";
+import React, { forwardRef, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { useFilter, useTextField } from "react-aria";
+import { Section, useListState } from "react-stately";
+
+//#region src/components/fields/CommandTextArea/CommandTextArea.tsx
+const DEFAULT_TRIGGERS = [{
+	char: "/",
+	atLineStart: true
+}];
+/**
+* Inspect the textarea contents up to the caret and find the active trigger
+* token, if any. The token includes the trigger character and ends at the
+* caret (so it grows as the user types). A token ends at whitespace or the end
+* of the input.
+*/
+function parseActiveToken(value, caret, triggers) {
+	if (!triggers.length) return null;
+	const before = value.slice(0, caret);
+	value.slice(caret);
+	for (const trigger of triggers) {
+		const ch = trigger.char;
+		if (trigger.atLineStart) {
+			const lineStart = before.lastIndexOf("\n") + 1;
+			const linePrefix = before.slice(lineStart);
+			if (linePrefix[0] !== ch) continue;
+			if (linePrefix.slice(1).search(/\s/) !== -1) continue;
+			if (!linePrefix) continue;
+			return {
+				trigger,
+				token: linePrefix,
+				start: lineStart,
+				end: caret
+			};
+		}
+		const match = /(?:^|\s)([\S]+)$/.exec(before);
+		if (!match) continue;
+		const candidate = match[1];
+		if (candidate[0] !== ch) continue;
+		return {
+			trigger,
+			token: candidate,
+			start: caret - candidate.length,
+			end: caret
+		};
+	}
+	return null;
+}
+function CommandTextArea(props, ref) {
+	props = castNullableStringValue(props);
+	props = useProviderProps(props);
+	props = useFormProps(props);
+	props = useFieldProps(props, {
+		defaultValidationTrigger: "onBlur",
+		valuePropsMapper: ({ value, onChange }) => ({
+			onChange,
+			value: value?.toString() ?? ""
+		})
+	});
+	let { qa, autoSize = false, isDisabled = false, isReadOnly = false, isRequired = false, onChange, maxRows = 10, rows = 3, labelProps: userLabelProps, inputRef: propsInputRef, value, defaultValue, placeholder, items, children: renderChildren, triggers = DEFAULT_TRIGGERS, filter, onCommand, insertSpaceAfter = true, disabledKeys, direction = "top", shouldFlip = true, overlayOffset = 8, containerPadding = 8, overlayStyles, listBoxStyles, optionStyles, sectionStyles, headingStyles, wrapperRef: propsWrapperRef, popoverRef: propsPopoverRef, listBoxRef: propsListBoxRef, listStateRef: propsListStateRef, onKeyDown, onFocus, onBlur, ...otherProps } = props;
+	rows = Math.max(rows, 1);
+	maxRows = Math.max(maxRows, rows);
+	const localInputRef = useRef(null);
+	const inputRef = propsInputRef ?? localInputRef;
+	const wrapperRef = useCombinedRefs(propsWrapperRef);
+	const popoverRef = useCombinedRefs(propsPopoverRef);
+	const listBoxRef = useCombinedRefs(propsListBoxRef);
+	const localListStateRef = useRef(null);
+	const listStateRef = propsListStateRef ?? localListStateRef;
+	const commandTextAreaId = useMemo(() => generateRandomId(), []);
+	const isControlled = value !== void 0;
+	const [internalValue, setInternalValue] = useState(value ?? defaultValue ?? "");
+	const effectiveValue = isControlled ? value : internalValue;
+	const handleChange = useEvent((next) => {
+		if (!isControlled) setInternalValue(next);
+		onChange?.(next);
+	});
+	let children = renderChildren;
+	const renderFn = renderChildren;
+	if (items && typeof renderFn === "function") children = Array.from(items).map((item, idx) => {
+		const rendered = renderFn(item);
+		if (React.isValidElement(rendered) && rendered.key == null) return React.cloneElement(rendered, { key: rendered?.key ?? item?.key ?? idx });
+		return rendered;
+	});
+	const [caret, setCaret] = useState(() => effectiveValue.length);
+	const syncCaret = useEvent(() => {
+		const el = inputRef.current;
+		if (!el) return;
+		setCaret(el.selectionStart ?? el.value.length);
+	});
+	const activeToken = useMemo(() => parseActiveToken(effectiveValue, Math.min(caret, effectiveValue.length), triggers), [
+		effectiveValue,
+		caret,
+		triggers
+	]);
+	const term = useMemo(() => {
+		if (!activeToken) return "";
+		const { token, trigger } = activeToken;
+		return token.startsWith(trigger.char) ? token.slice(trigger.char.length) : token;
+	}, [activeToken]);
+	const { contains } = useFilter({ sensitivity: "base" });
+	const textFilterFn = useMemo(() => filter === false ? () => true : filter || contains, [filter, contains]);
+	const localCollectionState = useListState({
+		children,
+		items,
+		selectionMode: "none"
+	});
+	const filterFn = useCallback((nodes) => filterCollectionNodes(nodes, term, textFilterFn, { matchExtraFields: true }), [term, textFilterFn]);
+	const visibleFilteredKeys = useMemo(() => {
+		if (!activeToken) return [];
+		const keys = [];
+		const disabled = disabledKeys ? new Set(disabledKeys) : void 0;
+		collectVisibleKeys(filterFn(localCollectionState.collection), keys, disabled);
+		return keys;
+	}, [
+		activeToken,
+		filterFn,
+		localCollectionState.collection,
+		disabledKeys
+	]);
+	const filteredCount = visibleFilteredKeys.length;
+	const [dismissedToken, setDismissedToken] = useState(null);
+	const [, setFocusTick] = useState(0);
+	const bumpFocus = useEvent(() => setFocusTick((t) => t + 1));
+	useEffect(() => {
+		setDismissedToken((prev) => prev != null && activeToken?.token !== prev ? null : prev);
+	}, [activeToken?.token]);
+	const shouldShowPopover = !!activeToken && activeToken.token !== dismissedToken && filteredCount > 0;
+	const { anchorRef: caretAnchorRef, positionApiRef } = useCaretAnchor({
+		inputRef,
+		wrapperRef,
+		caret,
+		value: effectiveValue,
+		isActive: shouldShowPopover
+	});
+	const adjustHeight = useEvent(() => {
+		const textarea = inputRef.current;
+		if (!textarea || !autoSize) return;
+		textarea.style.height = "auto";
+		const computedStyle = getComputedStyle(textarea);
+		const paddingTop = parseFloat(computedStyle.paddingTop) || 0;
+		const paddingBottom = parseFloat(computedStyle.paddingBottom) || 0;
+		const borderTop = parseFloat(computedStyle.borderTopWidth) || 0;
+		const borderBottom = parseFloat(computedStyle.borderBottomWidth) || 0;
+		const lineHeight = parseInt(computedStyle.lineHeight) || 20;
+		const contentHeight = textarea.scrollHeight - paddingTop - paddingBottom;
+		const computedRows = Math.ceil(contentHeight / lineHeight);
+		const totalHeight = Math.max(Math.min(computedRows, maxRows), rows) * lineHeight + paddingTop + paddingBottom + borderTop + borderBottom;
+		textarea.style.height = `${totalHeight}px`;
+	});
+	let { labelProps, inputProps } = useTextField({
+		...otherProps,
+		value: effectiveValue,
+		placeholder,
+		isDisabled,
+		isReadOnly,
+		isRequired,
+		onChange: chain(handleChange, adjustHeight),
+		inputElementType: "textarea"
+	}, inputRef);
+	const mergedLabelProps = mergeProps$1(labelProps, userLabelProps);
+	const useEnvironmentalEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+	useEnvironmentalEffect(() => {
+		if (!autoSize || !inputRef.current) return;
+		adjustHeight();
+		const resizeObserver = new ResizeObserver(adjustHeight);
+		resizeObserver.observe(inputRef.current);
+		return () => resizeObserver.disconnect();
+	}, [autoSize, inputRef.current]);
+	useEnvironmentalEffect(() => {
+		if (autoSize && inputRef.current) adjustHeight();
+	}, [effectiveValue]);
+	const pendingCaretRef = useRef(null);
+	useEnvironmentalEffect(() => {
+		const el = inputRef.current;
+		if (!el) return;
+		if (pendingCaretRef.current != null) {
+			const pos = pendingCaretRef.current;
+			pendingCaretRef.current = null;
+			el.focus();
+			el.setSelectionRange(pos, pos);
+			setCaret(pos);
+			return;
+		}
+		const domCaret = el.selectionStart ?? el.value.length;
+		setCaret((prev) => prev === domCaret ? prev : domCaret);
+	}, [effectiveValue]);
+	const getItemTextValue = useCallback((key) => {
+		return (localCollectionState?.collection?.getItem(key))?.textValue || String(key);
+	}, [localCollectionState?.collection]);
+	const commit = useEvent((key) => {
+		const listState = listStateRef.current;
+		if (visibleFilteredKeys.length > 0 && !visibleFilteredKeys.includes(key)) key = visibleFilteredKeys[0];
+		const textValue = getItemTextValue(key);
+		const token = activeToken;
+		const el = inputRef.current;
+		if (token) {
+			const next = effectiveValue.slice(0, token.start) + textValue + (insertSpaceAfter ? " " : "") + effectiveValue.slice(token.end);
+			const caretPos = token.start + textValue.length + (insertSpaceAfter ? 1 : 0);
+			pendingCaretRef.current = caretPos;
+			handleChange(next);
+			if (el) {
+				el.focus();
+				try {
+					el.setSelectionRange(caretPos, caretPos);
+				} catch {}
+			}
+		} else if (el) {
+			const start = el.selectionStart ?? effectiveValue.length;
+			const end = el.selectionEnd ?? effectiveValue.length;
+			const next = effectiveValue.slice(0, start) + textValue + (insertSpaceAfter ? " " : "") + effectiveValue.slice(end);
+			pendingCaretRef.current = start + textValue.length + (insertSpaceAfter ? 1 : 0);
+			handleChange(next);
+		}
+		setDismissedToken(null);
+		onCommand?.(key, {
+			textValue,
+			...listState?.collection?.getItem(key)?.props ?? {}
+		});
+	});
+	const onKeyDownHandler = useCallback((e) => {
+		onKeyDown?.(e);
+		if (e.defaultPrevented) return;
+		if (!shouldShowPopover) return;
+		const listState = listStateRef.current;
+		if (e.key === "ArrowDown" || e.key === "ArrowUp") {
+			if (!listState) return;
+			e.preventDefault();
+			const nextKey = getNextVisibleKey(listState, e.key === "ArrowDown" ? 1 : -1);
+			if (nextKey != null) {
+				markKeyboardFocus(listState);
+				listState.selectionManager.setFocusedKey(nextKey);
+				bumpFocus();
+			}
+		} else if (e.key === "Home" || e.key === "End") {
+			if (!listState) return;
+			e.preventDefault();
+			const edgeKey = getEdgeVisibleKey(listState, e.key === "Home" ? "first" : "last");
+			if (edgeKey != null) {
+				markKeyboardFocus(listState);
+				listState.selectionManager.setFocusedKey(edgeKey);
+				bumpFocus();
+			}
+		} else if (e.key === "Enter" || e.key === "Tab") {
+			if (!listState) return;
+			const focused = listState.selectionManager.focusedKey;
+			if (focused != null) {
+				e.preventDefault();
+				commit(focused);
+			}
+		} else if (e.key === "Escape") {
+			e.preventDefault();
+			if (activeToken) setDismissedToken(activeToken.token);
+		}
+	}, [
+		shouldShowPopover,
+		activeToken,
+		commit,
+		onKeyDown,
+		listStateRef
+	]);
+	const focusInitAttemptsRef = useRef(0);
+	useLayoutEffect(() => {
+		if (!shouldShowPopover) return;
+		focusInitAttemptsRef.current = 0;
+		const tick = () => {
+			if (!shouldShowPopover) return;
+			const listState = listStateRef.current;
+			if (!listState) {
+				focusInitAttemptsRef.current += 1;
+				if (focusInitAttemptsRef.current < 8) requestAnimationFrame(tick);
+				return;
+			}
+			if (listState.selectionManager.focusedKey == null) {
+				const first = getEdgeVisibleKey(listState, "first");
+				if (first != null) {
+					markKeyboardFocus(listState);
+					listState.selectionManager.setFocusedKey(first);
+					bumpFocus();
+				}
+			}
+		};
+		requestAnimationFrame(() => requestAnimationFrame(tick));
+	}, [shouldShowPopover]);
+	useLayoutEffect(() => {
+		if (!shouldShowPopover) return;
+		const listState = listStateRef.current;
+		if (!listState) return;
+		if (visibleFilteredKeys.length === 0) return;
+		const focused = listState.selectionManager.focusedKey;
+		if (focused == null || !visibleFilteredKeys.includes(focused)) {
+			markKeyboardFocus(listState);
+			listState.selectionManager.setFocusedKey(visibleFilteredKeys[0]);
+			bumpFocus();
+		}
+	}, [visibleFilteredKeys, shouldShowPopover]);
+	const { compositeFocusProps } = useCompositeFocus({
+		wrapperRef,
+		popoverRef,
+		onFocus,
+		onBlur,
+		isDisabled
+	});
+	const focusedKey = listStateRef.current?.selectionManager.focusedKey ?? null;
+	const listBoxId = `CommandTextAreaListBox-${commandTextAreaId}`;
+	const popoverOverlayStyles = {
+		width: "30x max-content 50vw",
+		...overlayStyles
+	};
+	const commandInputProps = mergeProps$1(inputProps, {
+		role: "combobox",
+		"aria-autocomplete": "list",
+		"aria-expanded": shouldShowPopover,
+		"aria-haspopup": "listbox",
+		"aria-controls": shouldShowPopover ? listBoxId : void 0,
+		"aria-activedescendant": shouldShowPopover && focusedKey != null ? `ListBoxItem-${focusedKey}` : void 0,
+		onKeyDown: onKeyDownHandler,
+		onSelect: syncCaret,
+		onKeyUp: syncCaret,
+		onClick: syncCaret,
+		"data-input-type": "command-textarea"
+	});
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(TextInputBase, {
+		ref,
+		...otherProps,
+		multiLine: true,
+		qa,
+		inputRef,
+		wrapperRef,
+		wrapperProps: compositeFocusProps,
+		labelProps: mergedLabelProps,
+		inputProps: commandInputProps,
+		isDisabled,
+		isReadOnly,
+		isRequired,
+		rows
+	}), /* @__PURE__ */ jsx(ListBoxPopover, {
+		isOpen: shouldShowPopover,
+		triggerRef: wrapperRef,
+		positionTargetRef: caretAnchorRef,
+		positionApiRef,
+		popoverRef,
+		listBoxRef,
+		direction,
+		shouldFlip,
+		overlayOffset,
+		containerPadding,
+		listBoxId,
+		overlayStyles: popoverOverlayStyles,
+		listBoxStyles,
+		optionStyles,
+		optionHighlight: term,
+		sectionStyles,
+		headingStyles,
+		isDisabled,
+		disabledKeys,
+		items,
+		listStateRef,
+		ariaLabel: props["aria-label"] || (typeof otherProps.label === "string" ? otherProps.label : "Commands"),
+		compositeFocusProps,
+		filter: filterFn,
+		onClose: () => {
+			if (activeToken) setDismissedToken(activeToken.token);
+		},
+		onSelectionChange: (selection) => {
+			const key = Array.isArray(selection) ? selection[0] : selection;
+			if (key != null) commit(key);
+		},
+		children
+	})] });
+}
+const _CommandTextArea = forwardRef(CommandTextArea);
+Object.assign(_CommandTextArea, {
+	Item: _CollectionItem,
+	Section,
+	displayName: "CommandTextArea"
+});
+Object.defineProperty(_CommandTextArea, "cubeInputType", {
+	value: "CommandTextArea",
+	enumerable: false,
+	configurable: false
+});
+
+//#endregion
+export { _CommandTextArea };
+//# sourceMappingURL=CommandTextArea.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CommandTextArea.js","names":["mergeProps","BaseSection"],"sources":["../../../../src/components/fields/CommandTextArea/CommandTextArea.tsx"],"sourcesContent":["import { Key } from '@react-types/shared';\nimport { Styles } from '@tenphi/tasty';\nimport React, {\n  ForwardedRef,\n  forwardRef,\n  ReactElement,\n  ReactNode,\n  RefObject,\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { useFilter, useTextField } from 'react-aria';\nimport { Section as BaseSection, useListState } from 'react-stately';\n\nimport { useEvent } from '../../../_internal';\nimport { useProviderProps } from '../../../provider';\nimport { generateRandomId } from '../../../utils/random';\nimport { chain, mergeProps, useCombinedRefs } from '../../../utils/react';\nimport {\n  castNullableStringValue,\n  WithNullableValue,\n} from '../../../utils/react/nullableValue';\nimport { CollectionItem as Item } from '../../CollectionItem';\nimport { useFieldProps, useFormProps } from '../../form';\nimport {\n  collectVisibleKeys,\n  filterCollectionNodes,\n  getEdgeVisibleKey,\n  getNextVisibleKey,\n  ListBoxPopover,\n  ListStateLike,\n  markKeyboardFocus,\n  TextFilterFn,\n  useCompositeFocus,\n} from '../ListBoxPopover';\nimport {\n  CubeTextInputBaseProps,\n  TextInputBase,\n} from '../TextInput/TextInputBase';\n\nimport { useCaretAnchor } from './useCaretAnchor';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** A single trigger character with optional placement constraint. */\nexport interface CommandTrigger {\n  /** The character that opens the autocomplete (e.g. `/` or `@`). */\n  char: string;\n  /**\n   * When true, the trigger token must start at the beginning of the line the\n   * caret is on (right after a newline, or at the very start of the input) —\n   * i.e. line-scoped slash commands. When false, the token may appear after\n   * any whitespace, anywhere in the text (Slack/Notion-style).\n   */\n  atLineStart?: boolean;\n}\n\n/** Result of scanning the textarea for an active trigger token. */\nexport interface ActiveToken {\n  /** The matched trigger descriptor. */\n  trigger: CommandTrigger;\n  /** The active token text, INCLUDING the trigger char (e.g. `/cle`). */\n  token: string;\n  /** Inclusive start index of the token in the textarea value. */\n  start: number;\n  /** Exclusive end index of the token (caret position while typing). */\n  end: number;\n}\n\nexport type CommandTextAreaFilterFn = TextFilterFn;\n\nexport interface CubeCommandTextAreaProps<T>\n  extends Omit<CubeTextInputBaseProps, 'children' | 'multiLine'> {\n  /** Whether the textarea should resize to fit its content. */\n  autoSize?: boolean;\n  /** Max visible rows when `autoSize` is true. Defaults to 10. */\n  maxRows?: number;\n  /** Number of visible rows. Defaults to 3. */\n  rows?: number;\n\n  /** Command/option source (alternative to JSX children). */\n  items?: Iterable<T>;\n  /** Static items or a render function (same shape as ComboBox/ListBox). */\n  children?: ReactNode | ((item: T) => ReactElement);\n  /**\n   * Triggers that open the autocomplete. Defaults to a single slash command\n   * that must start at the beginning of the input.\n   */\n  triggers?: CommandTrigger[];\n  /**\n   * Custom filter. Pass `false` to disable internal filtering (server-side).\n   */\n  filter?: CommandTextAreaFilterFn | false;\n  /**\n   * Fired when the user picks a command (Enter/Tab/click). The option's\n   * `textValue` is also inserted into the textarea regardless.\n   */\n  onCommand?: (key: Key, item: { textValue: string; [k: string]: any }) => void;\n  /** Insert a trailing space after the chosen command. Defaults to true. */\n  insertSpaceAfter?: boolean;\n  /** Keys of disabled options. */\n  disabledKeys?: Iterable<Key>;\n  /** Popover placement. Chat inputs usually want `top`. Defaults to `top`. */\n  direction?: 'bottom' | 'top';\n  /** Whether the popover should flip when overflowing. Defaults to true. */\n  shouldFlip?: boolean;\n  /** Offset between the textarea and the popover. */\n  overlayOffset?: number;\n  /** Padding between the popover and the viewport edge. */\n  containerPadding?: number;\n\n  // Refs\n  /** Ref for the textarea element. */\n  inputRef?: RefObject<HTMLTextAreaElement>;\n  /** Ref for the wrapper element (popover anchor). */\n  wrapperRef?: RefObject<HTMLDivElement>;\n  /** Ref for the popover overlay element. */\n  popoverRef?: RefObject<HTMLDivElement>;\n  /** Ref for the listbox element. */\n  listBoxRef?: RefObject<HTMLDivElement>;\n  /** Ref through which the internal list state is exposed. */\n  listStateRef?: RefObject<ListStateLike | null>;\n\n  // Style props\n  overlayStyles?: any;\n  listBoxStyles?: any;\n  optionStyles?: any;\n  sectionStyles?: any;\n  headingStyles?: any;\n}\n\nconst DEFAULT_TRIGGERS: CommandTrigger[] = [{ char: '/', atLineStart: true }];\n\n// ---------------------------------------------------------------------------\n// Trigger parsing\n// ---------------------------------------------------------------------------\n\n/**\n * Inspect the textarea contents up to the caret and find the active trigger\n * token, if any. The token includes the trigger character and ends at the\n * caret (so it grows as the user types). A token ends at whitespace or the end\n * of the input.\n */\nexport function parseActiveToken(\n  value: string,\n  caret: number,\n  triggers: CommandTrigger[],\n): ActiveToken | null {\n  if (!triggers.length) return null;\n  const before = value.slice(0, caret);\n  const after = value.slice(caret);\n\n  for (const trigger of triggers) {\n    const ch = trigger.char;\n    if (trigger.atLineStart) {\n      // Line-start command: the trigger char must sit at the start of the line\n      // the caret is on (right after a newline, or at index 0), with no\n      // whitespace between it and the caret. On a single-line input with no\n      // newlines this is equivalent to \"index 0 of the whole input\".\n      const lineStart = before.lastIndexOf('\\n') + 1;\n      const linePrefix = before.slice(lineStart);\n      if (linePrefix[0] !== ch) continue;\n      // No whitespace allowed within the token (after the trigger char).\n      const wsIndex = linePrefix.slice(1).search(/\\s/);\n      if (wsIndex !== -1) continue;\n      if (!linePrefix) continue;\n      return { trigger, token: linePrefix, start: lineStart, end: caret };\n    }\n\n    // Caret-token mode: find the last trigger char that begins a token at or\n    // after a line start / whitespace boundary, with no whitespace between it\n    // and the caret.\n    const match = /(?:^|\\s)([\\S]+)$/.exec(before);\n    if (!match) continue;\n    const candidate = match[1];\n    if (candidate[0] !== ch) continue;\n    // Ensure the token hasn't already been closed by whitespace after caret.\n    // (If there's non-whitespace after the caret, the user is mid-token.)\n    const start = caret - candidate.length;\n    // If immediately after the caret there's whitespace (or end), the token is\n    // \"complete\" — still offer completions as long as the caret sits on the\n    // token. We accept it.\n    void after;\n    return { trigger, token: candidate, start, end: caret };\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Component\n// ---------------------------------------------------------------------------\n\nfunction CommandTextArea<T extends object>(\n  props: WithNullableValue<CubeCommandTextAreaProps<T>>,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  props = castNullableStringValue(props);\n  props = useProviderProps(props);\n  props = useFormProps(props);\n  props = useFieldProps(props, {\n    defaultValidationTrigger: 'onBlur',\n    valuePropsMapper: ({ value, onChange }) => ({\n      onChange,\n      value: value?.toString() ?? '',\n    }),\n  });\n\n  let {\n    qa,\n    autoSize = false,\n    isDisabled = false,\n    isReadOnly = false,\n    isRequired = false,\n    onChange,\n    maxRows = 10,\n    rows = 3,\n    labelProps: userLabelProps,\n    inputRef: propsInputRef,\n    value,\n    defaultValue,\n    placeholder,\n    // command props\n    items,\n    children: renderChildren,\n    triggers = DEFAULT_TRIGGERS,\n    filter,\n    onCommand,\n    insertSpaceAfter = true,\n    disabledKeys,\n    direction = 'top',\n    shouldFlip = true,\n    overlayOffset = 8,\n    containerPadding = 8,\n    overlayStyles,\n    listBoxStyles,\n    optionStyles,\n    sectionStyles,\n    headingStyles,\n    wrapperRef: propsWrapperRef,\n    popoverRef: propsPopoverRef,\n    listBoxRef: propsListBoxRef,\n    listStateRef: propsListStateRef,\n    onKeyDown,\n    onFocus,\n    onBlur,\n    ...otherProps\n  } = props;\n\n  rows = Math.max(rows, 1);\n  maxRows = Math.max(maxRows, rows);\n\n  // ---- refs -------------------------------------------------------------\n  const localInputRef = useRef<HTMLTextAreaElement>(null);\n  const inputRef = (propsInputRef ??\n    localInputRef) as RefObject<HTMLTextAreaElement>;\n  const wrapperRef = useCombinedRefs(propsWrapperRef);\n  const popoverRef = useCombinedRefs(propsPopoverRef);\n  const listBoxRef = useCombinedRefs(propsListBoxRef);\n  const localListStateRef = useRef<ListStateLike | null>(null);\n  const listStateRef = (propsListStateRef ??\n    localListStateRef) as RefObject<ListStateLike | null>;\n\n  const commandTextAreaId = useMemo(() => generateRandomId(), []);\n\n  // ---- controlled / uncontrolled value ----------------------------------\n  // When no `value` is provided (standalone, no form), track the text\n  // internally so trigger detection and commit still work.\n  const isControlled = value !== undefined;\n  const [internalValue, setInternalValue] = useState<string>(\n    (value as string) ?? (defaultValue as string) ?? '',\n  );\n  const effectiveValue: string = isControlled\n    ? (value as string)\n    : internalValue;\n  const handleChange = useEvent((next: string) => {\n    if (!isControlled) setInternalValue(next);\n    onChange?.(next);\n  });\n\n  // ---- children / items normalization -----------------------------------\n  let children: ReactNode = renderChildren as ReactNode;\n  const renderFn = renderChildren as unknown;\n  if (items && typeof renderFn === 'function') {\n    const itemsArray = Array.from(items as Iterable<any>);\n    children = itemsArray.map((item, idx) => {\n      const rendered = (renderFn as (it: any) => ReactNode)(item);\n      if (\n        React.isValidElement(rendered) &&\n        (rendered as ReactElement).key == null\n      ) {\n        return React.cloneElement(rendered as ReactElement, {\n          key: (rendered as any)?.key ?? item?.key ?? idx,\n        });\n      }\n      return rendered as ReactNode;\n    });\n  }\n\n  // ---- caret tracking ---------------------------------------------------\n  // The caret drives trigger detection. We keep it in state so a caret move\n  // (arrow keys without typing) re-renders and recomputes the active token.\n  const [caret, setCaret] = useState(() => effectiveValue.length);\n  const syncCaret = useEvent(() => {\n    const el = inputRef.current;\n    if (!el) return;\n    setCaret(el.selectionStart ?? el.value.length);\n  });\n\n  // ---- trigger detection ------------------------------------------------\n  const activeToken = useMemo(\n    () =>\n      parseActiveToken(\n        effectiveValue,\n        Math.min(caret, effectiveValue.length),\n        triggers,\n      ),\n    [effectiveValue, caret, triggers],\n  );\n\n  // The active token includes the trigger char (e.g. `/co`). Strip it before\n  // filtering so the query is matched against the meaningful text — this lets\n  // options match by their label/description (which don't contain the trigger\n  // char) as well as by their `textValue`.\n  const term = useMemo(() => {\n    if (!activeToken) return '';\n    const { token, trigger } = activeToken;\n    return token.startsWith(trigger.char)\n      ? token.slice(trigger.char.length)\n      : token;\n  }, [activeToken]);\n\n  // ---- filtering --------------------------------------------------------\n  const { contains } = useFilter({ sensitivity: 'base' });\n  const textFilterFn = useMemo<CommandTextAreaFilterFn>(\n    () => (filter === false ? () => true : filter || contains),\n    [filter, contains],\n  );\n\n  // Local collection used to read option textValues and to count matches.\n  const localCollectionState = useListState({\n    children: children as any,\n    items: items as any,\n    selectionMode: 'none',\n  });\n\n  const filterFn = useCallback(\n    (nodes: Iterable<any>) =>\n      filterCollectionNodes(nodes, term, textFilterFn, {\n        matchExtraFields: true,\n      }),\n    [term, textFilterFn],\n  );\n\n  // Keys of the currently visible (filtered) options, in display order.\n  // Derived from our own local collection + filter (rather than the ListBox's\n  // exposed state ref) so it is always in sync with the current token — the\n  // ListBox's `stateRef.collection` can momentarily lag by a render right after\n  // the token narrows, which would otherwise leave virtual focus on (and commit)\n  // an option that is no longer visible.\n  const visibleFilteredKeys = useMemo<Key[]>(() => {\n    if (!activeToken) return [];\n    const keys: Key[] = [];\n    const disabled = disabledKeys ? new Set<Key>(disabledKeys) : undefined;\n    collectVisibleKeys(\n      filterFn(localCollectionState.collection),\n      keys,\n      disabled,\n    );\n    return keys;\n  }, [activeToken, filterFn, localCollectionState.collection, disabledKeys]);\n\n  const filteredCount = visibleFilteredKeys.length;\n\n  // ---- dismiss handling (Escape keeps the text but hides the popover) ---\n  const [dismissedToken, setDismissedToken] = useState<string | null>(null);\n  // Bumped whenever we move the virtual focus so the textarea's\n  // `aria-activedescendant` (read from the ListBox's stateRef at render time)\n  // stays in sync — the ListBox's own state update does not re-render us.\n  const [, setFocusTick] = useState(0);\n  const bumpFocus = useEvent(() => setFocusTick((t) => t + 1));\n  // Reset dismissal whenever the active token changes (user typed/backspaced).\n  useEffect(() => {\n    setDismissedToken((prev) =>\n      prev != null && activeToken?.token !== prev ? null : prev,\n    );\n  }, [activeToken?.token]);\n\n  const isCommandMode = !!activeToken && activeToken.token !== dismissedToken;\n  const shouldShowPopover = isCommandMode && filteredCount > 0;\n\n  // ---- caret-anchored popover ------------------------------------------\n  // A zero-size element positioned at the caret (both axes) drives the\n  // popover's geometry; the wrapper remains the dismiss/outside-click trigger.\n  const { anchorRef: caretAnchorRef, positionApiRef } = useCaretAnchor({\n    inputRef: inputRef as RefObject<HTMLTextAreaElement>,\n    wrapperRef: wrapperRef as RefObject<HTMLElement>,\n    caret,\n    value: effectiveValue,\n    isActive: shouldShowPopover,\n  });\n\n  // ---- height autosize (mirrors TextArea) -------------------------------\n  const adjustHeight = useEvent(() => {\n    const textarea = inputRef.current;\n    if (!textarea || !autoSize) return;\n\n    textarea.style.height = 'auto';\n    const computedStyle = getComputedStyle(textarea);\n    const paddingTop = parseFloat(computedStyle.paddingTop) || 0;\n    const paddingBottom = parseFloat(computedStyle.paddingBottom) || 0;\n    const borderTop = parseFloat(computedStyle.borderTopWidth) || 0;\n    const borderBottom = parseFloat(computedStyle.borderBottomWidth) || 0;\n    const lineHeight = parseInt(computedStyle.lineHeight) || 20;\n    const contentHeight = textarea.scrollHeight - paddingTop - paddingBottom;\n    const computedRows = Math.ceil(contentHeight / lineHeight);\n    const targetRows = Math.max(Math.min(computedRows, maxRows), rows);\n    const totalHeight =\n      targetRows * lineHeight +\n      paddingTop +\n      paddingBottom +\n      borderTop +\n      borderBottom;\n    textarea.style.height = `${totalHeight}px`;\n  });\n\n  // ---- useTextField (ARIA wiring for the textarea) ----------------------\n  let { labelProps, inputProps } = useTextField(\n    {\n      ...otherProps,\n      value: effectiveValue,\n      placeholder,\n      isDisabled,\n      isReadOnly,\n      isRequired,\n      onChange: chain(handleChange, adjustHeight),\n      inputElementType: 'textarea',\n    } as any,\n    inputRef as any,\n  );\n\n  const mergedLabelProps = mergeProps(labelProps, userLabelProps);\n\n  const useEnvironmentalEffect =\n    typeof window !== 'undefined' ? useLayoutEffect : useEffect;\n\n  useEnvironmentalEffect(() => {\n    if (!autoSize || !inputRef.current) return;\n    adjustHeight();\n    const resizeObserver = new ResizeObserver(adjustHeight);\n    resizeObserver.observe(inputRef.current);\n    return () => resizeObserver.disconnect();\n  }, [autoSize, inputRef.current]);\n\n  useEnvironmentalEffect(() => {\n    if (autoSize && inputRef.current) {\n      adjustHeight();\n    }\n  }, [effectiveValue]);\n\n  // ---- caret restore after commit --------------------------------------\n  const pendingCaretRef = useRef<number | null>(null);\n  useEnvironmentalEffect(() => {\n    const el = inputRef.current;\n    if (!el) return;\n\n    if (pendingCaretRef.current != null) {\n      // Restore caret after we programmatically inserted a command.\n      const pos = pendingCaretRef.current;\n      pendingCaretRef.current = null;\n      el.focus();\n      el.setSelectionRange(pos, pos);\n      setCaret(pos);\n      return;\n    }\n\n    // The value changed without our own commit (controlled update from\n    // outside, form reset, or defaultValue seeding). Resync the caret from\n    // the DOM selection so trigger parsing works off a valid index instead of\n    // a stale one. We intentionally do not steal focus here.\n    const domCaret = el.selectionStart ?? el.value.length;\n    setCaret((prev) => (prev === domCaret ? prev : domCaret));\n  }, [effectiveValue]);\n\n  // ---- helpers ----------------------------------------------------------\n  const getItemTextValue = useCallback(\n    (key: Key): string => {\n      const item = localCollectionState?.collection?.getItem(key);\n      return item?.textValue || String(key);\n    },\n    [localCollectionState?.collection],\n  );\n\n  // ---- commit (insert the chosen option's literal value) ---------------\n  const commit = useEvent((key: Key) => {\n    const listState = listStateRef.current;\n    // Guard against committing a stale key that has been filtered out of the\n    // visible list (e.g. the token was narrowed after focus landed on it).\n    // Fall back to the first still-visible option so the inserted command\n    // always matches what the user can see.\n    if (visibleFilteredKeys.length > 0 && !visibleFilteredKeys.includes(key)) {\n      key = visibleFilteredKeys[0];\n    }\n    const textValue = getItemTextValue(key);\n    const token = activeToken;\n    const el = inputRef.current;\n\n    if (token) {\n      const next =\n        effectiveValue.slice(0, token.start) +\n        textValue +\n        (insertSpaceAfter ? ' ' : '') +\n        effectiveValue.slice(token.end);\n      const caretPos =\n        token.start + textValue.length + (insertSpaceAfter ? 1 : 0);\n      pendingCaretRef.current = caretPos;\n      handleChange(next);\n      // If controlled, caret is restored by the effect above; if not, set now.\n      if (el) {\n        el.focus();\n        try {\n          el.setSelectionRange(caretPos, caretPos);\n        } catch {\n          /* noop */\n        }\n      }\n    } else if (el) {\n      // Fallback: insert at caret.\n      const start = el.selectionStart ?? effectiveValue.length;\n      const end = el.selectionEnd ?? effectiveValue.length;\n      const next =\n        effectiveValue.slice(0, start) +\n        textValue +\n        (insertSpaceAfter ? ' ' : '') +\n        effectiveValue.slice(end);\n      const caretPos = start + textValue.length + (insertSpaceAfter ? 1 : 0);\n      pendingCaretRef.current = caretPos;\n      handleChange(next);\n    }\n\n    setDismissedToken(null);\n    onCommand?.(key, {\n      textValue,\n      ...(listState?.collection?.getItem(key)?.props ?? {}),\n    });\n  });\n\n  // ---- keyboard navigation (only while the popover is open) -------------\n  const onKeyDownHandler = useCallback(\n    (e: React.KeyboardEvent<HTMLTextAreaElement>) => {\n      onKeyDown?.(e);\n      if (e.defaultPrevented) return;\n\n      if (!shouldShowPopover) {\n        // While not in command mode, the textarea behaves normally; but clear\n        // any dismissal when the user edits.\n        return;\n      }\n\n      const listState = listStateRef.current;\n\n      if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {\n        if (!listState) return;\n        e.preventDefault();\n        const nextKey = getNextVisibleKey(\n          listState,\n          e.key === 'ArrowDown' ? 1 : -1,\n        );\n        if (nextKey != null) {\n          markKeyboardFocus(listState);\n          listState.selectionManager.setFocusedKey(nextKey);\n          bumpFocus();\n        }\n      } else if (e.key === 'Home' || e.key === 'End') {\n        if (!listState) return;\n        e.preventDefault();\n        const edgeKey = getEdgeVisibleKey(\n          listState,\n          e.key === 'Home' ? 'first' : 'last',\n        );\n        if (edgeKey != null) {\n          markKeyboardFocus(listState);\n          listState.selectionManager.setFocusedKey(edgeKey);\n          bumpFocus();\n        }\n      } else if (e.key === 'Enter' || e.key === 'Tab') {\n        if (!listState) return;\n        const focused = listState.selectionManager.focusedKey;\n        if (focused != null) {\n          e.preventDefault();\n          commit(focused);\n        }\n        // Otherwise pass through (newline / form submit / tab navigation).\n      } else if (e.key === 'Escape') {\n        e.preventDefault();\n        if (activeToken) {\n          setDismissedToken(activeToken.token);\n        }\n      }\n    },\n    [shouldShowPopover, activeToken, commit, onKeyDown, listStateRef],\n  );\n\n  // ---- initial focus on the first option when the popover opens ---------\n  const focusInitAttemptsRef = useRef(0);\n  useLayoutEffect(() => {\n    if (!shouldShowPopover) return;\n    focusInitAttemptsRef.current = 0;\n\n    const tick = () => {\n      if (!shouldShowPopover) return;\n      const listState = listStateRef.current;\n      if (!listState) {\n        focusInitAttemptsRef.current += 1;\n        if (focusInitAttemptsRef.current < 8) {\n          requestAnimationFrame(tick);\n        }\n        return;\n      }\n      if (listState.selectionManager.focusedKey == null) {\n        const first = getEdgeVisibleKey(listState, 'first');\n        if (first != null) {\n          markKeyboardFocus(listState);\n          listState.selectionManager.setFocusedKey(first);\n          bumpFocus();\n        }\n      }\n    };\n\n    requestAnimationFrame(() => requestAnimationFrame(tick));\n  }, [shouldShowPopover]);\n\n  // ---- keep virtual focus valid as the filtered list narrows -----------\n  // When the user narrows the token, the previously focused option may drop\n  // out of the filtered list. Move focus to the first still-visible option so\n  // the highlight and any Enter/Tab commit stay in sync with what's shown.\n  useLayoutEffect(() => {\n    if (!shouldShowPopover) return;\n    const listState = listStateRef.current;\n    if (!listState) return;\n\n    if (visibleFilteredKeys.length === 0) return;\n\n    const focused = listState.selectionManager.focusedKey;\n    if (focused == null || !visibleFilteredKeys.includes(focused)) {\n      markKeyboardFocus(listState);\n      listState.selectionManager.setFocusedKey(visibleFilteredKeys[0]);\n      bumpFocus();\n    }\n  }, [visibleFilteredKeys, shouldShowPopover]);\n\n  // ---- composite focus (wrapper + portaled popover) ---------------------\n  const { compositeFocusProps } = useCompositeFocus({\n    wrapperRef: wrapperRef as RefObject<HTMLElement>,\n    popoverRef: popoverRef as RefObject<HTMLElement>,\n    onFocus,\n    onBlur,\n    isDisabled,\n  });\n\n  // ---- aria-activedescendant -------------------------------------------\n  const focusedKey = listStateRef.current?.selectionManager.focusedKey ?? null;\n  const listBoxId = `CommandTextAreaListBox-${commandTextAreaId}`;\n\n  // ---- popover width ----------------------------------------------------\n  // The popover is anchored to the caret (a point), so it must not be sized to\n  // the textarea. We use the same default as the shared `ListBoxPopover` /\n  // `Picker` popovers: a `30x` floor (240px), `max-content` preferred, `50vw`\n  // cap. The concrete floor keeps the virtualized ListBox from collapsing to a\n  // sliver (it has no intrinsic width), and `max-content` lets short option\n  // lists size to their content. The user's `overlayStyles` still win on top.\n  const popoverOverlayStyles: Styles = {\n    width: '30x max-content 50vw',\n    ...overlayStyles,\n  };\n\n  // ---- assemble input props ---------------------------------------------\n  const commandInputProps = mergeProps(inputProps, {\n    role: 'combobox',\n    'aria-autocomplete': 'list',\n    'aria-expanded': shouldShowPopover,\n    'aria-haspopup': 'listbox',\n    'aria-controls': shouldShowPopover ? listBoxId : undefined,\n    'aria-activedescendant':\n      shouldShowPopover && focusedKey != null\n        ? `ListBoxItem-${focusedKey}`\n        : undefined,\n    onKeyDown: onKeyDownHandler,\n    onSelect: syncCaret,\n    onKeyUp: syncCaret,\n    onClick: syncCaret,\n    'data-input-type': 'command-textarea',\n  });\n\n  // ---- render -----------------------------------------------------------\n  const field = (\n    <TextInputBase\n      ref={ref as any}\n      {...otherProps}\n      multiLine\n      qa={qa}\n      inputRef={inputRef}\n      wrapperRef={wrapperRef}\n      wrapperProps={compositeFocusProps}\n      labelProps={mergedLabelProps}\n      inputProps={commandInputProps}\n      isDisabled={isDisabled}\n      isReadOnly={isReadOnly}\n      isRequired={isRequired}\n      rows={rows}\n    />\n  );\n\n  return (\n    <>\n      {field}\n      <ListBoxPopover\n        isOpen={shouldShowPopover}\n        triggerRef={wrapperRef as RefObject<HTMLElement>}\n        positionTargetRef={caretAnchorRef as RefObject<Element | null>}\n        positionApiRef={positionApiRef}\n        popoverRef={popoverRef}\n        listBoxRef={listBoxRef}\n        direction={direction}\n        shouldFlip={shouldFlip}\n        overlayOffset={overlayOffset}\n        containerPadding={containerPadding}\n        listBoxId={listBoxId}\n        overlayStyles={popoverOverlayStyles}\n        listBoxStyles={listBoxStyles}\n        optionStyles={optionStyles}\n        optionHighlight={term}\n        sectionStyles={sectionStyles}\n        headingStyles={headingStyles}\n        isDisabled={isDisabled}\n        disabledKeys={disabledKeys}\n        items={items as any}\n        listStateRef={listStateRef}\n        ariaLabel={\n          (props as any)['aria-label'] ||\n          (typeof otherProps.label === 'string' ? otherProps.label : 'Commands')\n        }\n        compositeFocusProps={compositeFocusProps}\n        filter={filterFn}\n        onClose={() => {\n          if (activeToken) setDismissedToken(activeToken.token);\n        }}\n        onSelectionChange={(selection) => {\n          const key = Array.isArray(selection) ? selection[0] : selection;\n          if (key != null) commit(key);\n        }}\n      >\n        {children as any}\n      </ListBoxPopover>\n    </>\n  );\n}\n\nconst _CommandTextArea = forwardRef(CommandTextArea) as unknown as (<T>(\n  props: CubeCommandTextAreaProps<T> & {\n    ref?: ForwardedRef<HTMLElement>;\n  },\n) => ReactElement) & {\n  Item: typeof Item;\n  Section: typeof BaseSection;\n};\n\nObject.assign(_CommandTextArea, {\n  Item,\n  Section: BaseSection,\n  displayName: 'CommandTextArea',\n});\n\nObject.defineProperty(_CommandTextArea, 'cubeInputType', {\n  value: 'CommandTextArea',\n  enumerable: false,\n  configurable: false,\n});\n\nexport { _CommandTextArea as CommandTextArea };\n"],"mappings":"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"}

package/dist/components/fields/CommandTextArea/caretPosition.js

@@ -0,0 +1,89 @@
+/** @license MIT | @cube-dev/ui-kit v0.143.0 | Cube Dev Team */
+//#region src/components/fields/CommandTextArea/caretPosition.ts
+const MIRROR_STYLES = [
+	"boxSizing",
+	"width",
+	"height",
+	"overflowX",
+	"overflowY",
+	"paddingTop",
+	"paddingRight",
+	"paddingBottom",
+	"paddingLeft",
+	"borderTopWidth",
+	"borderRightWidth",
+	"borderBottomWidth",
+	"borderLeftWidth",
+	"fontStyle",
+	"fontVariant",
+	"fontWeight",
+	"fontStretch",
+	"fontSize",
+	"fontSizeAdjust",
+	"lineHeight",
+	"fontFamily",
+	"textAlign",
+	"textTransform",
+	"textIndent",
+	"textDecoration",
+	"letterSpacing",
+	"wordSpacing",
+	"tabSize",
+	"whiteSpace",
+	"wordWrap",
+	"wordBreak",
+	"overflowWrap"
+];
+/**
+* Returns the viewport-space rect of the caret at `index` within `textarea`,
+* or `null` if it can't be measured (e.g. jsdom, no layout, detached node).
+*/
+function getCaretRect(textarea, index) {
+	if (typeof document === "undefined") return null;
+	const doc = textarea.ownerDocument;
+	const style = doc.defaultView?.getComputedStyle(textarea);
+	if (!style) return null;
+	const box = textarea.getBoundingClientRect();
+	if (box.width === 0 && box.height === 0) return null;
+	const mirror = doc.createElement("div");
+	mirror.setAttribute("data-caret-mirror", "");
+	mirror.style.position = "absolute";
+	mirror.style.visibility = "hidden";
+	mirror.style.whiteSpace = "pre-wrap";
+	mirror.style.wordWrap = "break-word";
+	mirror.style.top = "0";
+	mirror.style.left = "0";
+	mirror.style.overflow = "hidden";
+	for (const prop of MIRROR_STYLES) {
+		const value = style[prop];
+		if (value != null) mirror.style.setProperty(prop.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase()), value);
+	}
+	mirror.style.width = style.width;
+	const value = textarea.value;
+	const before = value.slice(0, index);
+	const after = value.slice(index) || ".";
+	mirror.textContent = before;
+	const marker = doc.createElement("span");
+	marker.textContent = after;
+	marker.style.display = "inline-block";
+	mirror.appendChild(marker);
+	doc.body.appendChild(mirror);
+	let rect = null;
+	try {
+		const mirrorRect = mirror.getBoundingClientRect();
+		const markerRect = marker.getBoundingClientRect();
+		const { scrollTop, scrollLeft } = textarea;
+		rect = {
+			left: box.left - scrollLeft + (markerRect.left - mirrorRect.left),
+			top: box.top - scrollTop + (markerRect.top - mirrorRect.top),
+			height: markerRect.height || parseFloat(style.lineHeight) || 0
+		};
+	} finally {
+		mirror.remove();
+	}
+	return rect.height > 0 ? rect : null;
+}
+
+//#endregion
+export { getCaretRect };
+//# sourceMappingURL=caretPosition.js.map