@proyecto-viviana/solidaria 0.3.0 → 0.4.0

package/dist/_chunk/createToggle.jsx

@@ -0,0 +1,158 @@
+import { t as createPress } from "./createPress.jsx";
+import { i as access, o as mergeProps, t as isDevEnv } from "./env.jsx";
+import { t as filterDOMProps } from "./filterDOMProps.jsx";
+import { n as createFocusable } from "./createFocusable.jsx";
+import { createSlotId } from "../ssr/index.jsx";
+import { createEffect } from "solid-js";
+//#region src/toggle/createToggle.ts
+/**
+* Toggle hook for Solidaria
+*
+* Handles interactions for toggle elements, e.g. Checkboxes and Switches.
+*
+* This is a 1:1 port of @react-aria/toggle's useToggle hook.
+*/
+/**
+* Handles interactions for toggle elements, e.g. Checkboxes and Switches.
+*/
+function createToggle(props, state, ref) {
+	const getProps = () => access(props);
+	const isDisabled = () => getProps().isDisabled ?? false;
+	const isReadOnly = () => getProps().isReadOnly ?? false;
+	const isInvalid = () => {
+		return getProps().isInvalid ?? false;
+	};
+	const { pressProps, isPressed } = createPress({
+		get onPressStart() {
+			return getProps().onPressStart;
+		},
+		get onPressEnd() {
+			return getProps().onPressEnd;
+		},
+		get onPressChange() {
+			return getProps().onPressChange;
+		},
+		get onPress() {
+			return getProps().onPress;
+		},
+		get onPressUp() {
+			return getProps().onPressUp;
+		},
+		get onClick() {
+			return getProps().onClick;
+		},
+		get isDisabled() {
+			return isDisabled();
+		}
+	});
+	const { pressProps: labelPressProps, isPressed: isLabelPressed } = createPress({
+		get onPressStart() {
+			return getProps().onPressStart;
+		},
+		get onPressEnd() {
+			return getProps().onPressEnd;
+		},
+		get onPressChange() {
+			return getProps().onPressChange;
+		},
+		get onPressUp() {
+			return getProps().onPressUp;
+		},
+		get onClick() {
+			return getProps().onClick;
+		},
+		onPress(e) {
+			getProps().onPress?.(e);
+			state.toggle();
+			ref()?.focus();
+		},
+		get isDisabled() {
+			return isDisabled() || isReadOnly();
+		}
+	});
+	const { focusableProps } = createFocusable({
+		get isDisabled() {
+			return isDisabled();
+		},
+		get autoFocus() {
+			return getProps().autoFocus;
+		},
+		get onFocus() {
+			return getProps().onFocus;
+		},
+		get onBlur() {
+			return getProps().onBlur;
+		},
+		get onFocusChange() {
+			return getProps().onFocusChange;
+		},
+		get onKeyDown() {
+			return getProps().onKeyDown;
+		},
+		get onKeyUp() {
+			return getProps().onKeyUp;
+		},
+		get excludeFromTabOrder() {
+			return getProps().excludeFromTabOrder;
+		}
+	}, ref);
+	const interactions = mergeProps(pressProps, focusableProps);
+	const domProps = () => filterDOMProps(getProps(), { labelable: true });
+	const onChange = (e) => {
+		e.stopPropagation();
+		if (isReadOnly()) {
+			e.currentTarget.checked = state.isSelected();
+			return;
+		}
+		state.setSelected(e.currentTarget.checked);
+	};
+	createEffect(() => {
+		const p = getProps();
+		const hasChildren = p.children != null;
+		const hasAriaLabel = p["aria-label"] != null || p["aria-labelledby"] != null;
+		if (!hasChildren && !hasAriaLabel && isDevEnv()) console.warn("If you do not provide children, you must specify an aria-label for accessibility");
+	});
+	const combinedIsPressed = () => isPressed() || isLabelPressed();
+	const descriptionId = createSlotId();
+	const errorMessageId = createSlotId();
+	return {
+		labelProps: mergeProps(labelPressProps, { onClick: (e) => e.preventDefault() }),
+		get inputProps() {
+			const p = getProps();
+			return mergeProps(domProps(), {
+				"aria-invalid": isInvalid() || void 0,
+				"aria-errormessage": p["aria-errormessage"],
+				"aria-controls": p["aria-controls"],
+				"aria-readonly": isReadOnly() || void 0,
+				"aria-describedby": [
+					descriptionId(),
+					errorMessageId(),
+					p["aria-describedby"]
+				].filter(Boolean).join(" ") || void 0,
+				onChange,
+				disabled: isDisabled(),
+				...p.value == null ? {} : { value: p.value },
+				name: p.name,
+				form: p.form,
+				type: "checkbox",
+				...interactions,
+				onClick: (e) => e.stopPropagation()
+			});
+		},
+		get descriptionProps() {
+			return { id: descriptionId() };
+		},
+		get errorMessageProps() {
+			return { id: errorMessageId() };
+		},
+		isSelected: state.isSelected,
+		isPressed: combinedIsPressed,
+		isDisabled: isDisabled(),
+		isReadOnly: isReadOnly(),
+		isInvalid: isInvalid()
+	};
+}
+//#endregion
+export { createToggle as t };
+
+//# sourceMappingURL=createToggle.jsx.map

package/dist/_chunk/createToggle.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"createToggle.jsx","names":[],"sources":["../../src/toggle/createToggle.ts"],"sourcesContent":["/**\n * Toggle hook for Solidaria\n *\n * Handles interactions for toggle elements, e.g. Checkboxes and Switches.\n *\n * This is a 1:1 port of @react-aria/toggle's useToggle hook.\n */\n\nimport { JSX, Accessor, createEffect } from \"solid-js\";\nimport { createPress } from \"../interactions/createPress\";\nimport { createFocusable } from \"../interactions/createFocusable\";\nimport { mergeProps } from \"../utils/mergeProps\";\nimport { filterDOMProps } from \"../utils/filterDOMProps\";\nimport { type MaybeAccessor, access } from \"../utils/reactivity\";\nimport { isDevEnv } from \"../utils/env\";\nimport { createSlotId } from \"../ssr\";\nimport { type ToggleState } from \"@proyecto-viviana/solid-stately\";\nimport { type PressEvent } from \"../interactions/PressEvent\";\n\nexport interface AriaToggleProps {\n  /** Whether the element should be selected (controlled). */\n  isSelected?: boolean;\n  /** Whether the element should be selected by default (uncontrolled). */\n  defaultSelected?: boolean;\n  /** Handler that is called when the element's selection state changes. */\n  onChange?: (isSelected: boolean) => void;\n  /** The value of the input element, used when submitting an HTML form. */\n  value?: string;\n  /** The name of the input element, used when submitting an HTML form. */\n  name?: string;\n  /** The form to associate the input with. */\n  form?: string;\n  /** Whether the element is disabled. */\n  isDisabled?: boolean;\n  /** Whether the element is read only. */\n  isReadOnly?: boolean;\n  /** Whether the element is required. */\n  isRequired?: boolean;\n  /** Whether the element is invalid. */\n  isInvalid?: boolean;\n  /** The element's children. */\n  children?: JSX.Element;\n  /** Defines a string value that labels the current element. */\n  \"aria-label\"?: string;\n  /** Identifies the element (or elements) that labels the current element. */\n  \"aria-labelledby\"?: string;\n  /** Identifies the element (or elements) that describes the object. */\n  \"aria-describedby\"?: string;\n  /** Identifies the element (or elements) that provide an error message for the object. */\n  \"aria-errormessage\"?: string;\n  /** Identifies the element (or elements) whose contents or presence are controlled by the current element. */\n  \"aria-controls\"?: string;\n  /** The element's unique identifier. */\n  id?: string;\n  /** Handler that is called when the press is released over the target. */\n  onPress?: (e: PressEvent) => void;\n  /** Handler that is called when a press interaction starts. */\n  onPressStart?: (e: PressEvent) => void;\n  /** Handler that is called when a press interaction ends, either over the target or when the pointer leaves the target. */\n  onPressEnd?: (e: PressEvent) => void;\n  /** Handler that is called when the press state changes. */\n  onPressChange?: (isPressed: boolean) => void;\n  /** Handler that is called when a press is released over the target, regardless of whether it started on the target or not. */\n  onPressUp?: (e: PressEvent) => void;\n  /** Handler that is called when the element is clicked. */\n  onClick?: (e: MouseEvent) => void;\n  /** Handler that is called when the element receives focus. */\n  onFocus?: (e: FocusEvent) => void;\n  /** Handler that is called when the element loses focus. */\n  onBlur?: (e: FocusEvent) => void;\n  /** Handler that is called when the element's focus status changes. */\n  onFocusChange?: (isFocused: boolean) => void;\n  /** Handler that is called when a key is pressed. */\n  onKeyDown?: (e: KeyboardEvent) => void;\n  /** Handler that is called when a key is released. */\n  onKeyUp?: (e: KeyboardEvent) => void;\n  /** Whether to exclude the element from the tab order. */\n  excludeFromTabOrder?: boolean;\n  /** Whether to autofocus the element. */\n  autoFocus?: boolean;\n}\n\nexport interface ToggleAria {\n  /** Props to be spread on the label element. */\n  labelProps: JSX.LabelHTMLAttributes<HTMLLabelElement>;\n  /** Props to be spread on the input element. */\n  inputProps: JSX.InputHTMLAttributes<HTMLInputElement>;\n  /** Props for the description element, if any. */\n  descriptionProps: JSX.HTMLAttributes<HTMLElement>;\n  /** Props for the error message element, if any. */\n  errorMessageProps: JSX.HTMLAttributes<HTMLElement>;\n  /** Whether the toggle is selected. */\n  isSelected: Accessor<boolean>;\n  /** Whether the toggle is in a pressed state. */\n  isPressed: Accessor<boolean>;\n  /** Whether the toggle is disabled. */\n  isDisabled: boolean;\n  /** Whether the toggle is read only. */\n  isReadOnly: boolean;\n  /** Whether the toggle is invalid. */\n  isInvalid: boolean;\n}\n\n/**\n * Handles interactions for toggle elements, e.g. Checkboxes and Switches.\n */\nexport function createToggle(\n  props: MaybeAccessor<AriaToggleProps>,\n  state: ToggleState,\n  ref: () => HTMLInputElement | null,\n): ToggleAria {\n  const getProps = () => access(props);\n\n  const isDisabled = () => getProps().isDisabled ?? false;\n  const isReadOnly = () => getProps().isReadOnly ?? false;\n  const isInvalid = () => {\n    return getProps().isInvalid ?? false;\n  };\n\n  // Handle press state for keyboard interactions and cases where labelProps is not used.\n  const { pressProps, isPressed } = createPress({\n    get onPressStart() {\n      return getProps().onPressStart;\n    },\n    get onPressEnd() {\n      return getProps().onPressEnd;\n    },\n    get onPressChange() {\n      return getProps().onPressChange;\n    },\n    get onPress() {\n      return getProps().onPress;\n    },\n    get onPressUp() {\n      return getProps().onPressUp;\n    },\n    get onClick() {\n      return getProps().onClick;\n    },\n    get isDisabled() {\n      return isDisabled();\n    },\n  });\n\n  // Handle press state on the label.\n  const { pressProps: labelPressProps, isPressed: isLabelPressed } = createPress({\n    get onPressStart() {\n      return getProps().onPressStart;\n    },\n    get onPressEnd() {\n      return getProps().onPressEnd;\n    },\n    get onPressChange() {\n      return getProps().onPressChange;\n    },\n    get onPressUp() {\n      return getProps().onPressUp;\n    },\n    get onClick() {\n      return getProps().onClick;\n    },\n    onPress(e: PressEvent) {\n      getProps().onPress?.(e);\n      state.toggle();\n      ref()?.focus();\n    },\n    get isDisabled() {\n      return isDisabled() || isReadOnly();\n    },\n  });\n\n  // Handle focusable - extract the relevant props for createFocusable\n  const { focusableProps } = createFocusable(\n    {\n      get isDisabled() {\n        return isDisabled();\n      },\n      get autoFocus() {\n        return getProps().autoFocus;\n      },\n      get onFocus() {\n        return getProps().onFocus;\n      },\n      get onBlur() {\n        return getProps().onBlur;\n      },\n      get onFocusChange() {\n        return getProps().onFocusChange;\n      },\n      get onKeyDown() {\n        return getProps().onKeyDown;\n      },\n      get onKeyUp() {\n        return getProps().onKeyUp;\n      },\n      get excludeFromTabOrder() {\n        return getProps().excludeFromTabOrder;\n      },\n    },\n    ref as unknown as (el: HTMLElement) => void,\n  );\n\n  // Combine press and focusable props for input\n  const interactions = mergeProps(pressProps, focusableProps);\n\n  // Filter DOM props\n  const domProps = () =>\n    filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });\n\n  // Handle input change\n  const onChange: JSX.EventHandler<HTMLInputElement, Event> = (e) => {\n    // Since we spread props on label, onChange will end up there as well as in here.\n    // So we have to stop propagation at the lowest level that we care about\n    e.stopPropagation();\n\n    // Don't update state if readonly\n    if (isReadOnly()) {\n      // Reset the checkbox to its previous state since the browser already toggled it\n      e.currentTarget.checked = state.isSelected();\n      return;\n    }\n\n    state.setSelected(e.currentTarget.checked);\n  };\n\n  // Warn if no accessible label\n  createEffect(() => {\n    const p = getProps();\n    const hasChildren = p.children != null;\n    const hasAriaLabel = p[\"aria-label\"] != null || p[\"aria-labelledby\"] != null;\n    if (!hasChildren && !hasAriaLabel && isDevEnv()) {\n      console.warn(\n        \"If you do not provide children, you must specify an aria-label for accessibility\",\n      );\n    }\n  });\n\n  // Combined pressed state\n  const combinedIsPressed: Accessor<boolean> = () => isPressed() || isLabelPressed();\n\n  // Mint ids for the description and error message slots. Copied from createField\n  // because we don't want the label behavior that provides — the id resolves only\n  // once an element with that id is actually rendered (e.g. via TextContext slots).\n  const descriptionId = createSlotId();\n  const errorMessageId = createSlotId();\n\n  return {\n    labelProps: mergeProps(labelPressProps, {\n      onClick: (e: MouseEvent) => e.preventDefault(),\n    }) as JSX.LabelHTMLAttributes<HTMLLabelElement>,\n    get inputProps() {\n      const p = getProps();\n      return mergeProps(domProps(), {\n        \"aria-invalid\": isInvalid() || undefined,\n        \"aria-errormessage\": p[\"aria-errormessage\"],\n        \"aria-controls\": p[\"aria-controls\"],\n        \"aria-readonly\": isReadOnly() || undefined,\n        \"aria-describedby\":\n          [descriptionId(), errorMessageId(), p[\"aria-describedby\"]].filter(Boolean).join(\" \") ||\n          undefined,\n        onChange,\n        disabled: isDisabled(),\n        ...(p.value == null ? {} : { value: p.value }),\n        name: p.name,\n        form: p.form,\n        type: \"checkbox\" as const,\n        ...interactions,\n        // Stop click propagation to prevent labelProps.onClick from calling preventDefault\n        // which would prevent the checkbox from toggling in JSDOM/testing-library environments\n        onClick: (e: MouseEvent) => e.stopPropagation(),\n      }) as JSX.InputHTMLAttributes<HTMLInputElement>;\n    },\n    get descriptionProps() {\n      return { id: descriptionId() };\n    },\n    get errorMessageProps() {\n      return { id: errorMessageId() };\n    },\n    isSelected: state.isSelected,\n    isPressed: combinedIsPressed,\n    isDisabled: isDisabled(),\n    isReadOnly: isReadOnly(),\n    isInvalid: isInvalid(),\n  };\n}\n"],"mappings":"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"}

package/dist/_chunk/createTypeSelect.js

@@ -0,0 +1,125 @@
+import { t as createCollator } from "./createCollator.js";
+import { onCleanup } from "solid-js";
+//#region src/selection/createTypeSelect.ts
+/**
+* createTypeSelect - Handles typeahead interactions with collections.
+* Based on @react-aria/selection useTypeSelect.
+*
+* Allows users to navigate to items by typing characters that match
+* item text values. Supports multi-character search with debouncing.
+*/
+/**
+* Controls how long to wait before clearing the typeahead buffer.
+*/
+const TYPEAHEAD_DEBOUNCE_WAIT_MS = 1e3;
+/**
+* Get a printable character from a key event.
+* Returns the character if it's a single printable character,
+* or empty string for non-printable keys.
+*/
+function getStringForKey(key) {
+	if (key.length === 1 || !/^[A-Z]/i.test(key)) return key;
+	return "";
+}
+/**
+* Search for a key in the collection that matches the search string.
+* Starts *at* `fromKey` (inclusive) and scans to the end, with no internal
+* wrap; the caller retries from the top to cover earlier items. Matching is
+* locale-aware via the supplied `collator`.
+*/
+function getKeyForSearch(collection, search, fromKey, collator, isKeyDisabled) {
+	const items = [];
+	for (const item of collection) if (item.type === "item") items.push(item);
+	if (items.length === 0) return null;
+	let startIndex = 0;
+	if (fromKey != null) {
+		const fromIndex = items.findIndex((item) => item.key === fromKey);
+		if (fromIndex !== -1) startIndex = fromIndex;
+	}
+	for (let index = startIndex; index < items.length; index++) {
+		const item = items[index];
+		if (item.isDisabled || isKeyDisabled && isKeyDisabled(item.key)) continue;
+		const textValue = item.textValue || "";
+		const substring = textValue.slice(0, search.length);
+		if (textValue && collator.compare(substring, search) === 0) return item.key;
+	}
+	return null;
+}
+/**
+* Creates typeahead/type-to-select functionality for a collection.
+*
+* @example
+* ```tsx
+* const { typeSelectProps } = createTypeSelect({
+*   collection: () => state.collection(),
+*   focusedKey: () => state.focusedKey(),
+*   onFocusedKeyChange: (key) => state.setFocusedKey(key),
+* });
+*
+* return <ul {...mergeProps(listBoxProps, typeSelectProps)}>...</ul>;
+* ```
+*/
+function createTypeSelect(options) {
+	const state = {
+		search: "",
+		timeout: void 0
+	};
+	const collator = createCollator({
+		usage: "search",
+		sensitivity: "base"
+	});
+	const searchAndFocus = () => {
+		const collection = options.collection();
+		const currentKey = options.focusedKey();
+		let key = getKeyForSearch(collection, state.search, currentKey, collator(), options.isKeyDisabled);
+		if (key == null) key = getKeyForSearch(collection, state.search, null, collator(), options.isKeyDisabled);
+		if (key != null) {
+			options.onFocusedKeyChange(key);
+			options.onTypeSelect?.(key);
+		}
+		return key;
+	};
+	const restartDebounce = () => {
+		clearTimeout(state.timeout);
+		state.timeout = setTimeout(() => {
+			state.search = "";
+		}, TYPEAHEAD_DEBOUNCE_WAIT_MS);
+	};
+	const onKeyDownCapture = (e) => {
+		if (options.isDisabled) return;
+		if (state.search.length > 0 && e.key === " ") {
+			e.preventDefault();
+			e.stopPropagation();
+			state.search += " ";
+			searchAndFocus();
+			restartDebounce();
+		}
+	};
+	const onKeyDown = (e) => {
+		if (options.isDisabled) return;
+		const character = getStringForKey(e.key);
+		if (!character || e.ctrlKey || e.metaKey || e.altKey || !e.currentTarget.contains(e.target) || state.search.length === 0 && character === " ") return;
+		state.search += character;
+		if (searchAndFocus() != null) {
+			e.preventDefault();
+			e.stopPropagation();
+		} else {
+			state.search = "";
+			clearTimeout(state.timeout);
+			state.timeout = void 0;
+			return;
+		}
+		restartDebounce();
+	};
+	onCleanup(() => {
+		clearTimeout(state.timeout);
+	});
+	return { typeSelectProps: {
+		onKeyDownCapture,
+		onKeyDown
+	} };
+}
+//#endregion
+export { createTypeSelect as t };
+
+//# sourceMappingURL=createTypeSelect.js.map

package/dist/_chunk/createTypeSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTypeSelect.js","names":[],"sources":["../../src/selection/createTypeSelect.ts"],"sourcesContent":["/**\n * createTypeSelect - Handles typeahead interactions with collections.\n * Based on @react-aria/selection useTypeSelect.\n *\n * Allows users to navigate to items by typing characters that match\n * item text values. Supports multi-character search with debouncing.\n */\n\nimport { onCleanup } from \"solid-js\";\nimport type { JSX, Accessor } from \"solid-js\";\nimport type { Key, Collection, CollectionNode } from \"@proyecto-viviana/solid-stately\";\nimport { createCollator } from \"../i18n/createCollator\";\n\n/**\n * Controls how long to wait before clearing the typeahead buffer.\n */\nconst TYPEAHEAD_DEBOUNCE_WAIT_MS = 1000; // 1 second\n\nexport interface TypeSelectOptions<T> {\n  /** The collection to search through. */\n  collection: Accessor<Collection<T>>;\n  /** The currently focused key. */\n  focusedKey: Accessor<Key | null>;\n  /** Callback to set the focused key when a match is found. */\n  onFocusedKeyChange: (key: Key) => void;\n  /** Callback when an item is focused by typing. */\n  onTypeSelect?: (key: Key) => void;\n  /** Function to check if a key is disabled. */\n  isKeyDisabled?: (key: Key) => boolean;\n  /** Whether type-to-select is disabled. */\n  isDisabled?: boolean;\n}\n\nexport interface TypeSelectAria {\n  /** Props to spread on the collection element. */\n  typeSelectProps: JSX.HTMLAttributes<HTMLElement>;\n}\n\n// Internal state for tracking the search buffer\ninterface TypeSelectState {\n  search: string;\n  timeout: ReturnType<typeof setTimeout> | undefined;\n}\n\n/**\n * Get a printable character from a key event.\n * Returns the character if it's a single printable character,\n * or empty string for non-printable keys.\n */\nfunction getStringForKey(key: string): string {\n  // If the key is of length 1, it is an ASCII value.\n  // Otherwise, if there are no ASCII characters in the key name,\n  // it is a Unicode character.\n  // See https://www.w3.org/TR/uievents-key/\n  if (key.length === 1 || !/^[A-Z]/i.test(key)) {\n    return key;\n  }\n  return \"\";\n}\n\n/**\n * Search for a key in the collection that matches the search string.\n * Starts *at* `fromKey` (inclusive) and scans to the end, with no internal\n * wrap; the caller retries from the top to cover earlier items. Matching is\n * locale-aware via the supplied `collator`.\n */\nfunction getKeyForSearch<T>(\n  collection: Collection<T>,\n  search: string,\n  fromKey: Key | null,\n  collator: Intl.Collator,\n  isKeyDisabled?: (key: Key) => boolean,\n): Key | null {\n  // Collect all items in order\n  const items: CollectionNode<T>[] = [];\n  for (const item of collection) {\n    if (item.type === \"item\") {\n      items.push(item);\n    }\n  }\n\n  if (items.length === 0) return null;\n\n  // Find the starting index. Start *at* the currently focused item (inclusive),\n  // mirroring upstream ListKeyboardDelegate.getKeyForSearch (`key = fromKey ||\n  // getFirstKey()`): typing a prefix the focused item already matches keeps focus\n  // on it instead of advancing to the next match.\n  let startIndex = 0;\n  if (fromKey != null) {\n    const fromIndex = items.findIndex((item) => item.key === fromKey);\n    if (fromIndex !== -1) {\n      startIndex = fromIndex;\n    }\n  }\n\n  // Scan from startIndex to the end (no wrap). The caller retries from the top to\n  // cover items before the focused one, matching upstream useTypeSelect.\n  for (let index = startIndex; index < items.length; index++) {\n    const item = items[index];\n\n    // Skip disabled items\n    if (item.isDisabled || (isKeyDisabled && isKeyDisabled(item.key))) {\n      continue;\n    }\n\n    // Match the leading characters of the text value against the search string\n    // using locale-aware collation, mirroring upstream ListKeyboardDelegate\n    // (`collator.compare(textValue.slice(0, search.length), search) === 0`). The\n    // collator's `usage: 'search'` / `sensitivity: 'base'` makes this case- and\n    // diacritic-insensitive in a locale-aware way.\n    const textValue = item.textValue || \"\";\n    const substring = textValue.slice(0, search.length);\n    if (textValue && collator.compare(substring, search) === 0) {\n      return item.key;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Creates typeahead/type-to-select functionality for a collection.\n *\n * @example\n * ```tsx\n * const { typeSelectProps } = createTypeSelect({\n *   collection: () => state.collection(),\n *   focusedKey: () => state.focusedKey(),\n *   onFocusedKeyChange: (key) => state.setFocusedKey(key),\n * });\n *\n * return <ul {...mergeProps(listBoxProps, typeSelectProps)}>...</ul>;\n * ```\n */\nexport function createTypeSelect<T>(options: TypeSelectOptions<T>): TypeSelectAria {\n  // Create mutable state object to persist across keystrokes\n  const state: TypeSelectState = {\n    search: \"\",\n    timeout: undefined,\n  };\n\n  // Locale-aware search collator, mirroring upstream useSelectableList's\n  // `useCollator({ usage: 'search', sensitivity: 'base' })`.\n  const collator = createCollator({ usage: \"search\", sensitivity: \"base\" });\n\n  // Append the search buffer, find a matching key (from the focused item,\n  // falling back to the whole list), focus it, and (re)start the debounce timer.\n  // Shared by both phase handlers below, mirroring the duplicated body in\n  // upstream useTypeSelect.\n  const searchAndFocus = (): Key | null => {\n    const collection = options.collection();\n    const currentKey = options.focusedKey();\n\n    // Prioritize items at/after the focused item, then retry from the top to\n    // cover earlier ones (upstream's two getKeyForSearch calls).\n    let key = getKeyForSearch(\n      collection,\n      state.search,\n      currentKey,\n      collator(),\n      options.isKeyDisabled,\n    );\n    if (key == null) {\n      key = getKeyForSearch(collection, state.search, null, collator(), options.isKeyDisabled);\n    }\n\n    if (key != null) {\n      options.onFocusedKeyChange(key);\n      options.onTypeSelect?.(key);\n    }\n\n    return key;\n  };\n\n  const restartDebounce = () => {\n    clearTimeout(state.timeout);\n    state.timeout = setTimeout(() => {\n      state.search = \"\";\n    }, TYPEAHEAD_DEBOUNCE_WAIT_MS);\n  };\n\n  // Capture phase: mid-search a Spacebar is part of the query, not a selection\n  // action, so we consume it before the collection's own keydown handler can act\n  // on it. Mirrors upstream useTypeSelect's onKeyDownCapture.\n  const onKeyDownCapture: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {\n    if (options.isDisabled) return;\n\n    if (state.search.length > 0 && e.key === \" \") {\n      e.preventDefault();\n      // Upstream guards this with `!('continuePropagation' in e) ||\n      // !e.isPropagationStopped()`. Our raw DOM KeyboardEvents never carry\n      // `continuePropagation`, so the guard always holds — stop unconditionally.\n      e.stopPropagation();\n      state.search += \" \";\n      searchAndFocus();\n      restartDebounce();\n    }\n  };\n\n  // Bubble phase: handles ordinary characters (and, in environments where the\n  // capture listener above is inert, mid-search Spacebar via its non-bailing\n  // branch). Mirrors upstream useTypeSelect's onKeyDown.\n  const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {\n    if (options.isDisabled) return;\n\n    const character = getStringForKey(e.key);\n\n    // Ignore non-printable keys, Ctrl/Meta/Alt combos (Alt is excluded to match\n    // upstream — AltGr-only layouts shouldn't drive type-select), events from\n    // outside the element, and a leading Space (a common action key).\n    if (\n      !character ||\n      e.ctrlKey ||\n      e.metaKey ||\n      e.altKey ||\n      !e.currentTarget.contains(e.target as HTMLElement) ||\n      (state.search.length === 0 && character === \" \")\n    ) {\n      return;\n    }\n\n    state.search += character;\n\n    const key = searchAndFocus();\n\n    if (key != null) {\n      e.preventDefault();\n      // Our raw DOM events never carry `continuePropagation`, so upstream's\n      // `if (!('continuePropagation' in e)) e.stopPropagation()` is unconditional.\n      e.stopPropagation();\n    } else {\n      // Nothing matched even after retrying from the top: type-to-select is done,\n      // so reset the buffer and let the key propagate normally.\n      state.search = \"\";\n      clearTimeout(state.timeout);\n      state.timeout = undefined;\n      return;\n    }\n\n    restartDebounce();\n  };\n\n  // Mirror upstream's unmount cleanup (a useEffect teardown) so a pending\n  // debounce timer never fires after the consumer is disposed.\n  onCleanup(() => {\n    clearTimeout(state.timeout);\n  });\n\n  return {\n    typeSelectProps: {\n      // Upstream binds `onKeyDownCapture` so Spacebar is handled before the\n      // collection's own keydown handler. In Solid a capture handler delivered\n      // through a `{...typeSelectProps}` spread is inert (it never fires), so the\n      // bubble-phase `onKeyDown` is the live path — and it also covers mid-search\n      // Space because its bail check only rejects a *leading* Space. True capture\n      // would need a ref-based addEventListener threaded through every consumer;\n      // see the typeahead follow-up in upstream-sync.md.\n      onKeyDownCapture,\n      onKeyDown,\n    } as JSX.HTMLAttributes<HTMLElement>,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,6BAA6B;;;;;;AAiCnC,SAAS,gBAAgB,KAAqB;CAK5C,IAAI,IAAI,WAAW,KAAK,CAAC,UAAU,KAAK,GAAG,GACzC,OAAO;CAET,OAAO;AACT;;;;;;;AAQA,SAAS,gBACP,YACA,QACA,SACA,UACA,eACY;CAEZ,MAAM,QAA6B,CAAC;CACpC,KAAK,MAAM,QAAQ,YACjB,IAAI,KAAK,SAAS,QAChB,MAAM,KAAK,IAAI;CAInB,IAAI,MAAM,WAAW,GAAG,OAAO;CAM/B,IAAI,aAAa;CACjB,IAAI,WAAW,MAAM;EACnB,MAAM,YAAY,MAAM,WAAW,SAAS,KAAK,QAAQ,OAAO;EAChE,IAAI,cAAc,IAChB,aAAa;CAEjB;CAIA,KAAK,IAAI,QAAQ,YAAY,QAAQ,MAAM,QAAQ,SAAS;EAC1D,MAAM,OAAO,MAAM;EAGnB,IAAI,KAAK,cAAe,iBAAiB,cAAc,KAAK,GAAG,GAC7D;EAQF,MAAM,YAAY,KAAK,aAAa;EACpC,MAAM,YAAY,UAAU,MAAM,GAAG,OAAO,MAAM;EAClD,IAAI,aAAa,SAAS,QAAQ,WAAW,MAAM,MAAM,GACvD,OAAO,KAAK;CAEhB;CAEA,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,SAAgB,iBAAoB,SAA+C;CAEjF,MAAM,QAAyB;EAC7B,QAAQ;EACR,SAAS,KAAA;CACX;CAIA,MAAM,WAAW,eAAe;EAAE,OAAO;EAAU,aAAa;CAAO,CAAC;CAMxE,MAAM,uBAAmC;EACvC,MAAM,aAAa,QAAQ,WAAW;EACtC,MAAM,aAAa,QAAQ,WAAW;EAItC,IAAI,MAAM,gBACR,YACA,MAAM,QACN,YACA,SAAS,GACT,QAAQ,aACV;EACA,IAAI,OAAO,MACT,MAAM,gBAAgB,YAAY,MAAM,QAAQ,MAAM,SAAS,GAAG,QAAQ,aAAa;EAGzF,IAAI,OAAO,MAAM;GACf,QAAQ,mBAAmB,GAAG;GAC9B,QAAQ,eAAe,GAAG;EAC5B;EAEA,OAAO;CACT;CAEA,MAAM,wBAAwB;EAC5B,aAAa,MAAM,OAAO;EAC1B,MAAM,UAAU,iBAAiB;GAC/B,MAAM,SAAS;EACjB,GAAG,0BAA0B;CAC/B;CAKA,MAAM,oBAAkE,MAAM;EAC5E,IAAI,QAAQ,YAAY;EAExB,IAAI,MAAM,OAAO,SAAS,KAAK,EAAE,QAAQ,KAAK;GAC5C,EAAE,eAAe;GAIjB,EAAE,gBAAgB;GAClB,MAAM,UAAU;GAChB,eAAe;GACf,gBAAgB;EAClB;CACF;CAKA,MAAM,aAA2D,MAAM;EACrE,IAAI,QAAQ,YAAY;EAExB,MAAM,YAAY,gBAAgB,EAAE,GAAG;EAKvC,IACE,CAAC,aACD,EAAE,WACF,EAAE,WACF,EAAE,UACF,CAAC,EAAE,cAAc,SAAS,EAAE,MAAqB,KAChD,MAAM,OAAO,WAAW,KAAK,cAAc,KAE5C;EAGF,MAAM,UAAU;EAIhB,IAFY,eAEN,KAAK,MAAM;GACf,EAAE,eAAe;GAGjB,EAAE,gBAAgB;EACpB,OAAO;GAGL,MAAM,SAAS;GACf,aAAa,MAAM,OAAO;GAC1B,MAAM,UAAU,KAAA;GAChB;EACF;EAEA,gBAAgB;CAClB;CAIA,gBAAgB;EACd,aAAa,MAAM,OAAO;CAC5B,CAAC;CAED,OAAO,EACL,iBAAiB;EAQf;EACA;CACF,EACF;AACF"}

package/dist/_chunk/createTypeSelect.jsx

@@ -0,0 +1,125 @@
+import { t as createCollator } from "./createCollator.jsx";
+import { onCleanup } from "solid-js";
+//#region src/selection/createTypeSelect.ts
+/**
+* createTypeSelect - Handles typeahead interactions with collections.
+* Based on @react-aria/selection useTypeSelect.
+*
+* Allows users to navigate to items by typing characters that match
+* item text values. Supports multi-character search with debouncing.
+*/
+/**
+* Controls how long to wait before clearing the typeahead buffer.
+*/
+const TYPEAHEAD_DEBOUNCE_WAIT_MS = 1e3;
+/**
+* Get a printable character from a key event.
+* Returns the character if it's a single printable character,
+* or empty string for non-printable keys.
+*/
+function getStringForKey(key) {
+	if (key.length === 1 || !/^[A-Z]/i.test(key)) return key;
+	return "";
+}
+/**
+* Search for a key in the collection that matches the search string.
+* Starts *at* `fromKey` (inclusive) and scans to the end, with no internal
+* wrap; the caller retries from the top to cover earlier items. Matching is
+* locale-aware via the supplied `collator`.
+*/
+function getKeyForSearch(collection, search, fromKey, collator, isKeyDisabled) {
+	const items = [];
+	for (const item of collection) if (item.type === "item") items.push(item);
+	if (items.length === 0) return null;
+	let startIndex = 0;
+	if (fromKey != null) {
+		const fromIndex = items.findIndex((item) => item.key === fromKey);
+		if (fromIndex !== -1) startIndex = fromIndex;
+	}
+	for (let index = startIndex; index < items.length; index++) {
+		const item = items[index];
+		if (item.isDisabled || isKeyDisabled && isKeyDisabled(item.key)) continue;
+		const textValue = item.textValue || "";
+		const substring = textValue.slice(0, search.length);
+		if (textValue && collator.compare(substring, search) === 0) return item.key;
+	}
+	return null;
+}
+/**
+* Creates typeahead/type-to-select functionality for a collection.
+*
+* @example
+* ```tsx
+* const { typeSelectProps } = createTypeSelect({
+*   collection: () => state.collection(),
+*   focusedKey: () => state.focusedKey(),
+*   onFocusedKeyChange: (key) => state.setFocusedKey(key),
+* });
+*
+* return <ul {...mergeProps(listBoxProps, typeSelectProps)}>...</ul>;
+* ```
+*/
+function createTypeSelect(options) {
+	const state = {
+		search: "",
+		timeout: void 0
+	};
+	const collator = createCollator({
+		usage: "search",
+		sensitivity: "base"
+	});
+	const searchAndFocus = () => {
+		const collection = options.collection();
+		const currentKey = options.focusedKey();
+		let key = getKeyForSearch(collection, state.search, currentKey, collator(), options.isKeyDisabled);
+		if (key == null) key = getKeyForSearch(collection, state.search, null, collator(), options.isKeyDisabled);
+		if (key != null) {
+			options.onFocusedKeyChange(key);
+			options.onTypeSelect?.(key);
+		}
+		return key;
+	};
+	const restartDebounce = () => {
+		clearTimeout(state.timeout);
+		state.timeout = setTimeout(() => {
+			state.search = "";
+		}, TYPEAHEAD_DEBOUNCE_WAIT_MS);
+	};
+	const onKeyDownCapture = (e) => {
+		if (options.isDisabled) return;
+		if (state.search.length > 0 && e.key === " ") {
+			e.preventDefault();
+			e.stopPropagation();
+			state.search += " ";
+			searchAndFocus();
+			restartDebounce();
+		}
+	};
+	const onKeyDown = (e) => {
+		if (options.isDisabled) return;
+		const character = getStringForKey(e.key);
+		if (!character || e.ctrlKey || e.metaKey || e.altKey || !e.currentTarget.contains(e.target) || state.search.length === 0 && character === " ") return;
+		state.search += character;
+		if (searchAndFocus() != null) {
+			e.preventDefault();
+			e.stopPropagation();
+		} else {
+			state.search = "";
+			clearTimeout(state.timeout);
+			state.timeout = void 0;
+			return;
+		}
+		restartDebounce();
+	};
+	onCleanup(() => {
+		clearTimeout(state.timeout);
+	});
+	return { typeSelectProps: {
+		onKeyDownCapture,
+		onKeyDown
+	} };
+}
+//#endregion
+export { createTypeSelect as t };
+
+//# sourceMappingURL=createTypeSelect.jsx.map

package/dist/_chunk/createTypeSelect.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTypeSelect.jsx","names":[],"sources":["../../src/selection/createTypeSelect.ts"],"sourcesContent":["/**\n * createTypeSelect - Handles typeahead interactions with collections.\n * Based on @react-aria/selection useTypeSelect.\n *\n * Allows users to navigate to items by typing characters that match\n * item text values. Supports multi-character search with debouncing.\n */\n\nimport { onCleanup } from \"solid-js\";\nimport type { JSX, Accessor } from \"solid-js\";\nimport type { Key, Collection, CollectionNode } from \"@proyecto-viviana/solid-stately\";\nimport { createCollator } from \"../i18n/createCollator\";\n\n/**\n * Controls how long to wait before clearing the typeahead buffer.\n */\nconst TYPEAHEAD_DEBOUNCE_WAIT_MS = 1000; // 1 second\n\nexport interface TypeSelectOptions<T> {\n  /** The collection to search through. */\n  collection: Accessor<Collection<T>>;\n  /** The currently focused key. */\n  focusedKey: Accessor<Key | null>;\n  /** Callback to set the focused key when a match is found. */\n  onFocusedKeyChange: (key: Key) => void;\n  /** Callback when an item is focused by typing. */\n  onTypeSelect?: (key: Key) => void;\n  /** Function to check if a key is disabled. */\n  isKeyDisabled?: (key: Key) => boolean;\n  /** Whether type-to-select is disabled. */\n  isDisabled?: boolean;\n}\n\nexport interface TypeSelectAria {\n  /** Props to spread on the collection element. */\n  typeSelectProps: JSX.HTMLAttributes<HTMLElement>;\n}\n\n// Internal state for tracking the search buffer\ninterface TypeSelectState {\n  search: string;\n  timeout: ReturnType<typeof setTimeout> | undefined;\n}\n\n/**\n * Get a printable character from a key event.\n * Returns the character if it's a single printable character,\n * or empty string for non-printable keys.\n */\nfunction getStringForKey(key: string): string {\n  // If the key is of length 1, it is an ASCII value.\n  // Otherwise, if there are no ASCII characters in the key name,\n  // it is a Unicode character.\n  // See https://www.w3.org/TR/uievents-key/\n  if (key.length === 1 || !/^[A-Z]/i.test(key)) {\n    return key;\n  }\n  return \"\";\n}\n\n/**\n * Search for a key in the collection that matches the search string.\n * Starts *at* `fromKey` (inclusive) and scans to the end, with no internal\n * wrap; the caller retries from the top to cover earlier items. Matching is\n * locale-aware via the supplied `collator`.\n */\nfunction getKeyForSearch<T>(\n  collection: Collection<T>,\n  search: string,\n  fromKey: Key | null,\n  collator: Intl.Collator,\n  isKeyDisabled?: (key: Key) => boolean,\n): Key | null {\n  // Collect all items in order\n  const items: CollectionNode<T>[] = [];\n  for (const item of collection) {\n    if (item.type === \"item\") {\n      items.push(item);\n    }\n  }\n\n  if (items.length === 0) return null;\n\n  // Find the starting index. Start *at* the currently focused item (inclusive),\n  // mirroring upstream ListKeyboardDelegate.getKeyForSearch (`key = fromKey ||\n  // getFirstKey()`): typing a prefix the focused item already matches keeps focus\n  // on it instead of advancing to the next match.\n  let startIndex = 0;\n  if (fromKey != null) {\n    const fromIndex = items.findIndex((item) => item.key === fromKey);\n    if (fromIndex !== -1) {\n      startIndex = fromIndex;\n    }\n  }\n\n  // Scan from startIndex to the end (no wrap). The caller retries from the top to\n  // cover items before the focused one, matching upstream useTypeSelect.\n  for (let index = startIndex; index < items.length; index++) {\n    const item = items[index];\n\n    // Skip disabled items\n    if (item.isDisabled || (isKeyDisabled && isKeyDisabled(item.key))) {\n      continue;\n    }\n\n    // Match the leading characters of the text value against the search string\n    // using locale-aware collation, mirroring upstream ListKeyboardDelegate\n    // (`collator.compare(textValue.slice(0, search.length), search) === 0`). The\n    // collator's `usage: 'search'` / `sensitivity: 'base'` makes this case- and\n    // diacritic-insensitive in a locale-aware way.\n    const textValue = item.textValue || \"\";\n    const substring = textValue.slice(0, search.length);\n    if (textValue && collator.compare(substring, search) === 0) {\n      return item.key;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Creates typeahead/type-to-select functionality for a collection.\n *\n * @example\n * ```tsx\n * const { typeSelectProps } = createTypeSelect({\n *   collection: () => state.collection(),\n *   focusedKey: () => state.focusedKey(),\n *   onFocusedKeyChange: (key) => state.setFocusedKey(key),\n * });\n *\n * return <ul {...mergeProps(listBoxProps, typeSelectProps)}>...</ul>;\n * ```\n */\nexport function createTypeSelect<T>(options: TypeSelectOptions<T>): TypeSelectAria {\n  // Create mutable state object to persist across keystrokes\n  const state: TypeSelectState = {\n    search: \"\",\n    timeout: undefined,\n  };\n\n  // Locale-aware search collator, mirroring upstream useSelectableList's\n  // `useCollator({ usage: 'search', sensitivity: 'base' })`.\n  const collator = createCollator({ usage: \"search\", sensitivity: \"base\" });\n\n  // Append the search buffer, find a matching key (from the focused item,\n  // falling back to the whole list), focus it, and (re)start the debounce timer.\n  // Shared by both phase handlers below, mirroring the duplicated body in\n  // upstream useTypeSelect.\n  const searchAndFocus = (): Key | null => {\n    const collection = options.collection();\n    const currentKey = options.focusedKey();\n\n    // Prioritize items at/after the focused item, then retry from the top to\n    // cover earlier ones (upstream's two getKeyForSearch calls).\n    let key = getKeyForSearch(\n      collection,\n      state.search,\n      currentKey,\n      collator(),\n      options.isKeyDisabled,\n    );\n    if (key == null) {\n      key = getKeyForSearch(collection, state.search, null, collator(), options.isKeyDisabled);\n    }\n\n    if (key != null) {\n      options.onFocusedKeyChange(key);\n      options.onTypeSelect?.(key);\n    }\n\n    return key;\n  };\n\n  const restartDebounce = () => {\n    clearTimeout(state.timeout);\n    state.timeout = setTimeout(() => {\n      state.search = \"\";\n    }, TYPEAHEAD_DEBOUNCE_WAIT_MS);\n  };\n\n  // Capture phase: mid-search a Spacebar is part of the query, not a selection\n  // action, so we consume it before the collection's own keydown handler can act\n  // on it. Mirrors upstream useTypeSelect's onKeyDownCapture.\n  const onKeyDownCapture: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {\n    if (options.isDisabled) return;\n\n    if (state.search.length > 0 && e.key === \" \") {\n      e.preventDefault();\n      // Upstream guards this with `!('continuePropagation' in e) ||\n      // !e.isPropagationStopped()`. Our raw DOM KeyboardEvents never carry\n      // `continuePropagation`, so the guard always holds — stop unconditionally.\n      e.stopPropagation();\n      state.search += \" \";\n      searchAndFocus();\n      restartDebounce();\n    }\n  };\n\n  // Bubble phase: handles ordinary characters (and, in environments where the\n  // capture listener above is inert, mid-search Spacebar via its non-bailing\n  // branch). Mirrors upstream useTypeSelect's onKeyDown.\n  const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {\n    if (options.isDisabled) return;\n\n    const character = getStringForKey(e.key);\n\n    // Ignore non-printable keys, Ctrl/Meta/Alt combos (Alt is excluded to match\n    // upstream — AltGr-only layouts shouldn't drive type-select), events from\n    // outside the element, and a leading Space (a common action key).\n    if (\n      !character ||\n      e.ctrlKey ||\n      e.metaKey ||\n      e.altKey ||\n      !e.currentTarget.contains(e.target as HTMLElement) ||\n      (state.search.length === 0 && character === \" \")\n    ) {\n      return;\n    }\n\n    state.search += character;\n\n    const key = searchAndFocus();\n\n    if (key != null) {\n      e.preventDefault();\n      // Our raw DOM events never carry `continuePropagation`, so upstream's\n      // `if (!('continuePropagation' in e)) e.stopPropagation()` is unconditional.\n      e.stopPropagation();\n    } else {\n      // Nothing matched even after retrying from the top: type-to-select is done,\n      // so reset the buffer and let the key propagate normally.\n      state.search = \"\";\n      clearTimeout(state.timeout);\n      state.timeout = undefined;\n      return;\n    }\n\n    restartDebounce();\n  };\n\n  // Mirror upstream's unmount cleanup (a useEffect teardown) so a pending\n  // debounce timer never fires after the consumer is disposed.\n  onCleanup(() => {\n    clearTimeout(state.timeout);\n  });\n\n  return {\n    typeSelectProps: {\n      // Upstream binds `onKeyDownCapture` so Spacebar is handled before the\n      // collection's own keydown handler. In Solid a capture handler delivered\n      // through a `{...typeSelectProps}` spread is inert (it never fires), so the\n      // bubble-phase `onKeyDown` is the live path — and it also covers mid-search\n      // Space because its bail check only rejects a *leading* Space. True capture\n      // would need a ref-based addEventListener threaded through every consumer;\n      // see the typeahead follow-up in upstream-sync.md.\n      onKeyDownCapture,\n      onKeyDown,\n    } as JSX.HTMLAttributes<HTMLElement>,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,6BAA6B;;;;;;AAiCnC,SAAS,gBAAgB,KAAqB;CAK5C,IAAI,IAAI,WAAW,KAAK,CAAC,UAAU,KAAK,GAAG,GACzC,OAAO;CAET,OAAO;AACT;;;;;;;AAQA,SAAS,gBACP,YACA,QACA,SACA,UACA,eACY;CAEZ,MAAM,QAA6B,CAAC;CACpC,KAAK,MAAM,QAAQ,YACjB,IAAI,KAAK,SAAS,QAChB,MAAM,KAAK,IAAI;CAInB,IAAI,MAAM,WAAW,GAAG,OAAO;CAM/B,IAAI,aAAa;CACjB,IAAI,WAAW,MAAM;EACnB,MAAM,YAAY,MAAM,WAAW,SAAS,KAAK,QAAQ,OAAO;EAChE,IAAI,cAAc,IAChB,aAAa;CAEjB;CAIA,KAAK,IAAI,QAAQ,YAAY,QAAQ,MAAM,QAAQ,SAAS;EAC1D,MAAM,OAAO,MAAM;EAGnB,IAAI,KAAK,cAAe,iBAAiB,cAAc,KAAK,GAAG,GAC7D;EAQF,MAAM,YAAY,KAAK,aAAa;EACpC,MAAM,YAAY,UAAU,MAAM,GAAG,OAAO,MAAM;EAClD,IAAI,aAAa,SAAS,QAAQ,WAAW,MAAM,MAAM,GACvD,OAAO,KAAK;CAEhB;CAEA,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,SAAgB,iBAAoB,SAA+C;CAEjF,MAAM,QAAyB;EAC7B,QAAQ;EACR,SAAS,KAAA;CACX;CAIA,MAAM,WAAW,eAAe;EAAE,OAAO;EAAU,aAAa;CAAO,CAAC;CAMxE,MAAM,uBAAmC;EACvC,MAAM,aAAa,QAAQ,WAAW;EACtC,MAAM,aAAa,QAAQ,WAAW;EAItC,IAAI,MAAM,gBACR,YACA,MAAM,QACN,YACA,SAAS,GACT,QAAQ,aACV;EACA,IAAI,OAAO,MACT,MAAM,gBAAgB,YAAY,MAAM,QAAQ,MAAM,SAAS,GAAG,QAAQ,aAAa;EAGzF,IAAI,OAAO,MAAM;GACf,QAAQ,mBAAmB,GAAG;GAC9B,QAAQ,eAAe,GAAG;EAC5B;EAEA,OAAO;CACT;CAEA,MAAM,wBAAwB;EAC5B,aAAa,MAAM,OAAO;EAC1B,MAAM,UAAU,iBAAiB;GAC/B,MAAM,SAAS;EACjB,GAAG,0BAA0B;CAC/B;CAKA,MAAM,oBAAkE,MAAM;EAC5E,IAAI,QAAQ,YAAY;EAExB,IAAI,MAAM,OAAO,SAAS,KAAK,EAAE,QAAQ,KAAK;GAC5C,EAAE,eAAe;GAIjB,EAAE,gBAAgB;GAClB,MAAM,UAAU;GAChB,eAAe;GACf,gBAAgB;EAClB;CACF;CAKA,MAAM,aAA2D,MAAM;EACrE,IAAI,QAAQ,YAAY;EAExB,MAAM,YAAY,gBAAgB,EAAE,GAAG;EAKvC,IACE,CAAC,aACD,EAAE,WACF,EAAE,WACF,EAAE,UACF,CAAC,EAAE,cAAc,SAAS,EAAE,MAAqB,KAChD,MAAM,OAAO,WAAW,KAAK,cAAc,KAE5C;EAGF,MAAM,UAAU;EAIhB,IAFY,eAEN,KAAK,MAAM;GACf,EAAE,eAAe;GAGjB,EAAE,gBAAgB;EACpB,OAAO;GAGL,MAAM,SAAS;GACf,aAAa,MAAM,OAAO;GAC1B,MAAM,UAAU,KAAA;GAChB;EACF;EAEA,gBAAgB;CAClB;CAIA,gBAAgB;EACd,aAAa,MAAM,OAAO;CAC5B,CAAC;CAED,OAAO,EACL,iBAAiB;EAQf;EACA;CACF,EACF;AACF"}