@flanksource/clicky-ui 0.2.3 → 0.2.5

package/dist/components/Combobox.cjs

@@ -0,0 +1,291 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const utils = require("../lib/utils.cjs");
+const Icon = require("../data/Icon.cjs");
+const UiClose = require("../icons/components/UiClose.cjs");
+const UiChevronDown = require("../icons/components/UiChevronDown.cjs");
+const UiCheck = require("../icons/components/UiCheck.cjs");
+function Combobox(props) {
+  const {
+    options,
+    placeholder,
+    label,
+    disabled,
+    required,
+    allowCustomValue = true,
+    id,
+    className,
+    loading,
+    onSearch,
+    onKeyDown: onKeyDownProp
+  } = props;
+  const multiple = props.multiple === true;
+  const selectedValues = react.useMemo(
+    () => multiple ? props.value : props.value ? [props.value] : [],
+    [multiple, props.value]
+  );
+  const rootRef = react.useRef(null);
+  const inputRef = react.useRef(null);
+  const listRef = react.useRef(null);
+  const [open, setOpen] = react.useState(false);
+  const [query, setQuery] = react.useState("");
+  const [highlighted, setHighlighted] = react.useState(-1);
+  const isSelected = (optValue) => selectedValues.includes(optValue);
+  const closedLabel = react.useMemo(() => {
+    var _a;
+    if (multiple) {
+      const labels = options.filter((o) => selectedValues.includes(o.value)).map((o) => o.label);
+      if (labels.length === 0) return "";
+      if (labels.length <= 2) return labels.join(", ");
+      return `${labels.length} selected`;
+    }
+    const single = selectedValues[0] ?? "";
+    return ((_a = options.find((o) => o.value === single)) == null ? void 0 : _a.label) ?? single;
+  }, [multiple, options, selectedValues]);
+  const displayValue = open ? query : closedLabel;
+  const filtered = react.useMemo(() => {
+    if (onSearch) return withSelectedOptions(options, selectedValues);
+    const q = query.toLowerCase().trim();
+    if (!q) return options;
+    return options.filter(
+      (o) => o.label.toLowerCase().includes(q) || o.value.toLowerCase().includes(q)
+    );
+  }, [onSearch, options, query, selectedValues]);
+  react.useEffect(() => {
+    if (!onSearch || !open) return;
+    const handle = setTimeout(() => onSearch(query.trim()), 250);
+    return () => clearTimeout(handle);
+  }, [onSearch, open, query]);
+  react.useEffect(() => {
+    setHighlighted(-1);
+  }, [filtered.length]);
+  react.useEffect(() => {
+    if (!open) return;
+    const onPointerDown = (e) => {
+      var _a;
+      if (!((_a = rootRef.current) == null ? void 0 : _a.contains(e.target))) {
+        commitAndClose();
+      }
+    };
+    document.addEventListener("mousedown", onPointerDown);
+    return () => document.removeEventListener("mousedown", onPointerDown);
+  });
+  function emit(next) {
+    if (multiple) {
+      props.onChange(next);
+    } else {
+      props.onChange(next[0] ?? "");
+    }
+  }
+  function openMenu() {
+    setQuery("");
+    setHighlighted(-1);
+    setOpen(true);
+  }
+  function commitAndClose() {
+    const trimmed = query.trim();
+    if (!multiple && allowCustomValue && trimmed && trimmed !== selectedValues[0]) {
+      emit([trimmed]);
+    }
+    setQuery("");
+    setOpen(false);
+    setHighlighted(-1);
+  }
+  function selectOption(opt) {
+    var _a, _b;
+    if (multiple) {
+      const next = isSelected(opt.value) ? selectedValues.filter((v) => v !== opt.value) : [...selectedValues, opt.value];
+      emit(next);
+      setQuery("");
+      setHighlighted(-1);
+      (_a = inputRef.current) == null ? void 0 : _a.focus();
+      return;
+    }
+    emit([opt.value]);
+    setQuery("");
+    setOpen(false);
+    setHighlighted(-1);
+    (_b = inputRef.current) == null ? void 0 : _b.focus();
+  }
+  function clear() {
+    var _a;
+    if (selectedValues.length > 0) emit([]);
+    setQuery("");
+    setHighlighted(-1);
+    (_a = inputRef.current) == null ? void 0 : _a.focus();
+  }
+  function scrollToHighlighted(index) {
+    const list = listRef.current;
+    if (!list) return;
+    const item = list.children[index];
+    item == null ? void 0 : item.scrollIntoView({ block: "nearest" });
+  }
+  function onKeyDown(e) {
+    if (e.key === "ArrowDown") {
+      e.preventDefault();
+      if (!open) {
+        openMenu();
+        return;
+      }
+      const next = highlighted < filtered.length - 1 ? highlighted + 1 : 0;
+      setHighlighted(next);
+      scrollToHighlighted(next);
+    } else if (e.key === "ArrowUp") {
+      e.preventDefault();
+      if (!open) return;
+      const next = highlighted > 0 ? highlighted - 1 : filtered.length - 1;
+      setHighlighted(next);
+      scrollToHighlighted(next);
+    } else if (e.key === "Enter") {
+      if (open && highlighted >= 0 && filtered[highlighted] && !filtered[highlighted].disabled) {
+        e.preventDefault();
+        selectOption(filtered[highlighted]);
+        return;
+      }
+      commitAndClose();
+      onKeyDownProp == null ? void 0 : onKeyDownProp(e);
+    } else if (e.key === "Escape") {
+      if (open) {
+        e.preventDefault();
+        setQuery("");
+        setOpen(false);
+        setHighlighted(-1);
+      }
+    } else {
+      onKeyDownProp == null ? void 0 : onKeyDownProp(e);
+    }
+  }
+  const listId = id ? `${id}-listbox` : void 0;
+  const ariaLabel = typeof label === "string" ? label : void 0;
+  const showClear = !required && !loading && !disabled && selectedValues.length > 0;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { ref: rootRef, className: utils.cn("relative", className), children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative flex items-center", children: [
+      label != null && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "pointer-events-none absolute left-2 z-10 whitespace-nowrap font-medium uppercase tracking-wide text-muted-foreground text-[10px]", children: label }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          ref: inputRef,
+          id,
+          type: "text",
+          role: "combobox",
+          "aria-expanded": open,
+          "aria-controls": listId,
+          "aria-activedescendant": highlighted >= 0 ? `${listId}-${highlighted}` : void 0,
+          "aria-label": ariaLabel,
+          autoComplete: "off",
+          disabled,
+          placeholder,
+          value: displayValue,
+          onChange: (e) => {
+            setQuery(e.target.value);
+            if (!open) setOpen(true);
+          },
+          onFocus: openMenu,
+          onKeyDown,
+          className: utils.cn(
+            "h-control-h w-full rounded-md border border-input bg-background px-control-px text-sm text-foreground",
+            showClear ? "pr-14" : "pr-8",
+            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1",
+            "disabled:cursor-not-allowed disabled:opacity-50"
+          ),
+          style: label != null ? labelPadding(label) : void 0
+        }
+      ),
+      showClear && /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          tabIndex: -1,
+          "aria-label": "Clear",
+          onClick: clear,
+          className: "absolute right-7 flex h-full items-center px-1 text-muted-foreground hover:text-foreground",
+          children: /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiClose.UiClose, className: "text-xs" })
+        }
+      ),
+      loading ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "pointer-events-none absolute right-2 top-1/2 -translate-y-1/2", children: /* @__PURE__ */ jsxRuntime.jsxs("svg", { className: "h-3.5 w-3.5 animate-spin text-muted-foreground", viewBox: "0 0 16 16", fill: "none", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "8", cy: "8", r: "6.5", stroke: "currentColor", strokeWidth: "2", opacity: "0.25" }),
+        /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M14.5 8a6.5 6.5 0 0 0-6.5-6.5", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" })
+      ] }) }) : /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          tabIndex: -1,
+          disabled,
+          "aria-label": "Toggle options",
+          onClick: () => {
+            var _a;
+            if (open) {
+              commitAndClose();
+            } else {
+              openMenu();
+              (_a = inputRef.current) == null ? void 0 : _a.focus();
+            }
+          },
+          className: "pointer-events-auto absolute right-0 flex h-full items-center px-2 text-muted-foreground",
+          children: /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiChevronDown.UiChevronDown, className: "text-xs" })
+        }
+      )
+    ] }),
+    open && /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        id: listId,
+        ref: listRef,
+        role: "listbox",
+        "aria-multiselectable": multiple || void 0,
+        className: "absolute left-0 top-[calc(100%+0.25rem)] z-50 w-full min-w-[10rem] max-h-64 overflow-auto rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-lg shadow-black/5",
+        children: [
+          loading && filtered.length === 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-2 py-4 text-center text-sm text-muted-foreground", children: "Loading…" }),
+          !loading && filtered.length === 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-2 py-4 text-center text-sm text-muted-foreground", children: "No results" }),
+          filtered.map((opt, i) => {
+            const selected = isSelected(opt.value);
+            return /* @__PURE__ */ jsxRuntime.jsxs(
+              "div",
+              {
+                id: listId ? `${listId}-${i}` : void 0,
+                role: "option",
+                "aria-selected": selected,
+                "aria-disabled": opt.disabled,
+                onMouseDown: (e) => {
+                  e.preventDefault();
+                  if (!opt.disabled) selectOption(opt);
+                },
+                onMouseEnter: () => setHighlighted(i),
+                className: utils.cn(
+                  "flex cursor-pointer items-center gap-2 rounded-sm px-2 py-1.5 text-sm",
+                  i === highlighted && "bg-accent",
+                  selected && "font-medium",
+                  opt.disabled && "cursor-not-allowed opacity-50"
+                ),
+                children: [
+                  /* @__PURE__ */ jsxRuntime.jsx(
+                    Icon.Icon,
+                    {
+                      icon: UiCheck.UiCheck,
+                      className: utils.cn("text-xs shrink-0", selected ? "opacity-100" : "opacity-0")
+                    }
+                  ),
+                  /* @__PURE__ */ jsxRuntime.jsx("span", { className: "min-w-0 truncate", children: opt.label })
+                ]
+              },
+              opt.value
+            );
+          })
+        ]
+      }
+    )
+  ] });
+}
+function labelPadding(label) {
+  const length = typeof label === "string" ? label.length : 6;
+  return { paddingLeft: `${Math.min(length * 0.62 + 0.75, 9)}rem` };
+}
+function withSelectedOptions(options, selectedValues) {
+  const present = new Set(options.map((o) => o.value));
+  const pinned = selectedValues.filter((v) => !present.has(v)).map((v) => ({ value: v, label: v }));
+  return pinned.length === 0 ? options : [...pinned, ...options];
+}
+exports.Combobox = Combobox;
+//# sourceMappingURL=Combobox.cjs.map

package/dist/components/Combobox.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.cjs","sources":["../../src/components/Combobox.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef, useState, type KeyboardEvent, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon } from \"../data/Icon\";\nimport { UiChevronDown, UiClose, UiCheck } from \"../icons\";\n\nexport type ComboboxOption = {\n  value: string;\n  label: string;\n  disabled?: boolean;\n};\n\ntype ComboboxBaseProps = {\n  /** Available options, rendered in the order provided. */\n  options: ComboboxOption[];\n  /** Ghost text when no value is set. */\n  placeholder?: string;\n  /** Optional label rendered inline inside the control, before the input. */\n  label?: ReactNode;\n  /** Disables the input. */\n  disabled?: boolean;\n  /** When true, the value cannot be cleared (the clear button is hidden). */\n  required?: boolean;\n  /**\n   * When false, the value is restricted to the provided options — typed text\n   * that does not match an option is discarded instead of committed. Defaults\n   * to true (freeform entry allowed).\n   */\n  allowCustomValue?: boolean;\n  /** HTML id for the input element. */\n  id?: string;\n  /** Classes applied to the root wrapper. */\n  className?: string;\n  /** Shows a loading indicator when options are being fetched. */\n  loading?: boolean;\n  /**\n   * Optional async search invoked (debounced ~250ms) as the user types. The\n   * consumer fetches and feeds matching options back via the `options` prop\n   * (setting `loading` while in flight). When set, the component renders the\n   * provided `options` as-is instead of filtering them client-side — the\n   * server has already filtered. When absent, typing filters `options`\n   * client-side as before.\n   */\n  onSearch?: (query: string) => void;\n  /** Called when a key is pressed in the input. */\n  onKeyDown?: (e: KeyboardEvent<HTMLInputElement>) => void;\n};\n\nexport type ComboboxSingleProps = ComboboxBaseProps & {\n  multiple?: false;\n  /** Controlled selected value. */\n  value: string;\n  /** Called when the selected value changes (from list or freeform input). */\n  onChange: (value: string) => void;\n};\n\nexport type ComboboxMultiProps = ComboboxBaseProps & {\n  multiple: true;\n  /** Controlled selected values. */\n  value: string[];\n  /** Called with the complete next value array after each toggle. */\n  onChange: (value: string[]) => void;\n};\n\nexport type ComboboxProps = ComboboxSingleProps | ComboboxMultiProps;\n\nexport function Combobox(props: ComboboxProps) {\n  const {\n    options,\n    placeholder,\n    label,\n    disabled,\n    required,\n    allowCustomValue = true,\n    id,\n    className,\n    loading,\n    onSearch,\n    onKeyDown: onKeyDownProp,\n  } = props;\n  const multiple = props.multiple === true;\n  const selectedValues = useMemo<string[]>(\n    () => (multiple ? props.value : props.value ? [props.value] : []),\n    [multiple, props.value],\n  );\n\n  const rootRef = useRef<HTMLDivElement>(null);\n  const inputRef = useRef<HTMLInputElement>(null);\n  const listRef = useRef<HTMLDivElement>(null);\n  const [open, setOpen] = useState(false);\n  // `query` is the type-ahead filter text, kept separate from the committed\n  // value. It is empty unless the user is actively typing, so opening the\n  // dropdown shows every option rather than only the selected one.\n  const [query, setQuery] = useState(\"\");\n  const [highlighted, setHighlighted] = useState(-1);\n\n  const isSelected = (optValue: string) => selectedValues.includes(optValue);\n\n  // Closed-state input text. Single: the selected option's label (or its raw\n  // value as a fallback). Multi: a summary mirroring MultiSelect.\n  const closedLabel = useMemo(() => {\n    if (multiple) {\n      const labels = options\n        .filter((o) => selectedValues.includes(o.value))\n        .map((o) => o.label);\n      if (labels.length === 0) return \"\";\n      if (labels.length <= 2) return labels.join(\", \");\n      return `${labels.length} selected`;\n    }\n    const single = selectedValues[0] ?? \"\";\n    return options.find((o) => o.value === single)?.label ?? single;\n  }, [multiple, options, selectedValues]);\n\n  // While open the input mirrors the query; while closed it shows the\n  // committed selection's label/summary.\n  const displayValue = open ? query : closedLabel;\n\n  const filtered = useMemo(() => {\n    // With onSearch the server already filtered. The matches replace the list,\n    // but any already-selected value not in the matches is pinned so the user's\n    // selection stays visible and toggleable. Selected values carry no label\n    // object here, so synthesize {value, label: value} (the typeahead's value is\n    // its own human label).\n    if (onSearch) return withSelectedOptions(options, selectedValues);\n    const q = query.toLowerCase().trim();\n    if (!q) return options;\n    return options.filter(\n      (o) => o.label.toLowerCase().includes(q) || o.value.toLowerCase().includes(q),\n    );\n  }, [onSearch, options, query, selectedValues]);\n\n  // Debounced server-side search: fires onSearch ~250ms after the query settles\n  // while the menu is open. The empty-query call lets the consumer reset its\n  // result set. Only active when onSearch is provided.\n  useEffect(() => {\n    if (!onSearch || !open) return;\n    const handle = setTimeout(() => onSearch(query.trim()), 250);\n    return () => clearTimeout(handle);\n  }, [onSearch, open, query]);\n\n  useEffect(() => {\n    setHighlighted(-1);\n  }, [filtered.length]);\n\n  useEffect(() => {\n    if (!open) return;\n    const onPointerDown = (e: MouseEvent) => {\n      if (!rootRef.current?.contains(e.target as Node)) {\n        commitAndClose();\n      }\n    };\n    document.addEventListener(\"mousedown\", onPointerDown);\n    return () => document.removeEventListener(\"mousedown\", onPointerDown);\n  });\n\n  function emit(next: string[]) {\n    if (multiple) {\n      props.onChange(next);\n    } else {\n      props.onChange(next[0] ?? \"\");\n    }\n  }\n\n  function openMenu() {\n    setQuery(\"\");\n    setHighlighted(-1);\n    setOpen(true);\n  }\n\n  function commitAndClose() {\n    // Freeform commit (single, allowCustomValue only): a non-empty query that\n    // doesn't match an option becomes the value. An empty query keeps the\n    // existing selection. Multi and strict modes never commit freeform text.\n    const trimmed = query.trim();\n    if (!multiple && allowCustomValue && trimmed && trimmed !== selectedValues[0]) {\n      emit([trimmed]);\n    }\n    setQuery(\"\");\n    setOpen(false);\n    setHighlighted(-1);\n  }\n\n  function selectOption(opt: ComboboxOption) {\n    if (multiple) {\n      const next = isSelected(opt.value)\n        ? selectedValues.filter((v) => v !== opt.value)\n        : [...selectedValues, opt.value];\n      emit(next);\n      setQuery(\"\");\n      setHighlighted(-1);\n      inputRef.current?.focus();\n      return;\n    }\n    emit([opt.value]);\n    setQuery(\"\");\n    setOpen(false);\n    setHighlighted(-1);\n    inputRef.current?.focus();\n  }\n\n  function clear() {\n    if (selectedValues.length > 0) emit([]);\n    setQuery(\"\");\n    setHighlighted(-1);\n    inputRef.current?.focus();\n  }\n\n  function scrollToHighlighted(index: number) {\n    const list = listRef.current;\n    if (!list) return;\n    const item = list.children[index] as HTMLElement | undefined;\n    item?.scrollIntoView({ block: \"nearest\" });\n  }\n\n  function onKeyDown(e: KeyboardEvent<HTMLInputElement>) {\n    if (e.key === \"ArrowDown\") {\n      e.preventDefault();\n      if (!open) {\n        openMenu();\n        return;\n      }\n      const next = highlighted < filtered.length - 1 ? highlighted + 1 : 0;\n      setHighlighted(next);\n      scrollToHighlighted(next);\n    } else if (e.key === \"ArrowUp\") {\n      e.preventDefault();\n      if (!open) return;\n      const next = highlighted > 0 ? highlighted - 1 : filtered.length - 1;\n      setHighlighted(next);\n      scrollToHighlighted(next);\n    } else if (e.key === \"Enter\") {\n      if (open && highlighted >= 0 && filtered[highlighted] && !filtered[highlighted].disabled) {\n        e.preventDefault();\n        selectOption(filtered[highlighted]);\n        return;\n      }\n      commitAndClose();\n      onKeyDownProp?.(e);\n    } else if (e.key === \"Escape\") {\n      if (open) {\n        e.preventDefault();\n        setQuery(\"\");\n        setOpen(false);\n        setHighlighted(-1);\n      }\n    } else {\n      onKeyDownProp?.(e);\n    }\n  }\n\n  const listId = id ? `${id}-listbox` : undefined;\n  const ariaLabel = typeof label === \"string\" ? label : undefined;\n  const showClear = !required && !loading && !disabled && selectedValues.length > 0;\n\n  return (\n    <div ref={rootRef} className={cn(\"relative\", className)}>\n      <div className=\"relative flex items-center\">\n        {label != null && (\n          <span className=\"pointer-events-none absolute left-2 z-10 whitespace-nowrap font-medium uppercase tracking-wide text-muted-foreground text-[10px]\">\n            {label}\n          </span>\n        )}\n        <input\n          ref={inputRef}\n          id={id}\n          type=\"text\"\n          role=\"combobox\"\n          aria-expanded={open}\n          aria-controls={listId}\n          aria-activedescendant={highlighted >= 0 ? `${listId}-${highlighted}` : undefined}\n          aria-label={ariaLabel}\n          autoComplete=\"off\"\n          disabled={disabled}\n          placeholder={placeholder}\n          value={displayValue}\n          onChange={(e) => {\n            setQuery(e.target.value);\n            if (!open) setOpen(true);\n          }}\n          onFocus={openMenu}\n          onKeyDown={onKeyDown}\n          className={cn(\n            \"h-control-h w-full rounded-md border border-input bg-background px-control-px text-sm text-foreground\",\n            showClear ? \"pr-14\" : \"pr-8\",\n            \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1\",\n            \"disabled:cursor-not-allowed disabled:opacity-50\",\n          )}\n          style={label != null ? labelPadding(label) : undefined}\n        />\n        {showClear && (\n          <button\n            type=\"button\"\n            tabIndex={-1}\n            aria-label=\"Clear\"\n            onClick={clear}\n            className=\"absolute right-7 flex h-full items-center px-1 text-muted-foreground hover:text-foreground\"\n          >\n            <Icon icon={UiClose} className=\"text-xs\" />\n          </button>\n        )}\n        {loading ? (\n          <span className=\"pointer-events-none absolute right-2 top-1/2 -translate-y-1/2\">\n            <svg className=\"h-3.5 w-3.5 animate-spin text-muted-foreground\" viewBox=\"0 0 16 16\" fill=\"none\">\n              <circle cx=\"8\" cy=\"8\" r=\"6.5\" stroke=\"currentColor\" strokeWidth=\"2\" opacity=\"0.25\" />\n              <path d=\"M14.5 8a6.5 6.5 0 0 0-6.5-6.5\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" />\n            </svg>\n          </span>\n        ) : (\n          <button\n            type=\"button\"\n            tabIndex={-1}\n            disabled={disabled}\n            aria-label=\"Toggle options\"\n            onClick={() => {\n              if (open) {\n                commitAndClose();\n              } else {\n                openMenu();\n                inputRef.current?.focus();\n              }\n            }}\n            className=\"pointer-events-auto absolute right-0 flex h-full items-center px-2 text-muted-foreground\"\n          >\n            <Icon icon={UiChevronDown} className=\"text-xs\" />\n          </button>\n        )}\n      </div>\n      {open && (\n        <div\n          id={listId}\n          ref={listRef}\n          role=\"listbox\"\n          aria-multiselectable={multiple || undefined}\n          className=\"absolute left-0 top-[calc(100%+0.25rem)] z-50 w-full min-w-[10rem] max-h-64 overflow-auto rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-lg shadow-black/5\"\n        >\n          {loading && filtered.length === 0 && (\n            <div className=\"px-2 py-4 text-center text-sm text-muted-foreground\">Loading…</div>\n          )}\n          {!loading && filtered.length === 0 && (\n            <div className=\"px-2 py-4 text-center text-sm text-muted-foreground\">No results</div>\n          )}\n          {filtered.map((opt, i) => {\n            const selected = isSelected(opt.value);\n            return (\n              <div\n                key={opt.value}\n                id={listId ? `${listId}-${i}` : undefined}\n                role=\"option\"\n                aria-selected={selected}\n                aria-disabled={opt.disabled}\n                onMouseDown={(e) => {\n                  e.preventDefault();\n                  if (!opt.disabled) selectOption(opt);\n                }}\n                onMouseEnter={() => setHighlighted(i)}\n                className={cn(\n                  \"flex cursor-pointer items-center gap-2 rounded-sm px-2 py-1.5 text-sm\",\n                  i === highlighted && \"bg-accent\",\n                  selected && \"font-medium\",\n                  opt.disabled && \"cursor-not-allowed opacity-50\",\n                )}\n              >\n                <Icon\n                  icon={UiCheck}\n                  className={cn(\"text-xs shrink-0\", selected ? \"opacity-100\" : \"opacity-0\")}\n                />\n                <span className=\"min-w-0 truncate\">{opt.label}</span>\n              </div>\n            );\n          })}\n        </div>\n      )}\n    </div>\n  );\n}\n\n// Reserve room on the left of the input for the inline label so typed text\n// does not overlap it. Roughly 0.6rem per character plus padding.\nfunction labelPadding(label: ReactNode) {\n  const length = typeof label === \"string\" ? label.length : 6;\n  return { paddingLeft: `${Math.min(length * 0.62 + 0.75, 9)}rem` };\n}\n\n// withSelectedOptions returns the option list plus any selected value that isn't\n// already present, synthesized as {value, label: value}. Used by the server\n// (onSearch) typeahead so an already-selected value missing from the current\n// matches still renders as a checked row. Selected-but-absent values come first\n// so they don't get scrolled past by a long match list.\nfunction withSelectedOptions(\n  options: ComboboxOption[],\n  selectedValues: string[],\n): ComboboxOption[] {\n  const present = new Set(options.map((o) => o.value));\n  const pinned = selectedValues\n    .filter((v) => !present.has(v))\n    .map((v) => ({ value: v, label: v }));\n  return pinned.length === 0 ? options : [...pinned, ...options];\n}\n"],"names":["useMemo","useRef","useState","useEffect","jsxs","cn","jsx","Icon","UiClose","UiChevronDown","UiCheck"],"mappings":"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"}

package/dist/components/Combobox.d.ts

@@ -0,0 +1,59 @@
+import { KeyboardEvent, ReactNode } from 'react';
+export type ComboboxOption = {
+    value: string;
+    label: string;
+    disabled?: boolean;
+};
+type ComboboxBaseProps = {
+    /** Available options, rendered in the order provided. */
+    options: ComboboxOption[];
+    /** Ghost text when no value is set. */
+    placeholder?: string;
+    /** Optional label rendered inline inside the control, before the input. */
+    label?: ReactNode;
+    /** Disables the input. */
+    disabled?: boolean;
+    /** When true, the value cannot be cleared (the clear button is hidden). */
+    required?: boolean;
+    /**
+     * When false, the value is restricted to the provided options — typed text
+     * that does not match an option is discarded instead of committed. Defaults
+     * to true (freeform entry allowed).
+     */
+    allowCustomValue?: boolean;
+    /** HTML id for the input element. */
+    id?: string;
+    /** Classes applied to the root wrapper. */
+    className?: string;
+    /** Shows a loading indicator when options are being fetched. */
+    loading?: boolean;
+    /**
+     * Optional async search invoked (debounced ~250ms) as the user types. The
+     * consumer fetches and feeds matching options back via the `options` prop
+     * (setting `loading` while in flight). When set, the component renders the
+     * provided `options` as-is instead of filtering them client-side — the
+     * server has already filtered. When absent, typing filters `options`
+     * client-side as before.
+     */
+    onSearch?: (query: string) => void;
+    /** Called when a key is pressed in the input. */
+    onKeyDown?: (e: KeyboardEvent<HTMLInputElement>) => void;
+};
+export type ComboboxSingleProps = ComboboxBaseProps & {
+    multiple?: false;
+    /** Controlled selected value. */
+    value: string;
+    /** Called when the selected value changes (from list or freeform input). */
+    onChange: (value: string) => void;
+};
+export type ComboboxMultiProps = ComboboxBaseProps & {
+    multiple: true;
+    /** Controlled selected values. */
+    value: string[];
+    /** Called with the complete next value array after each toggle. */
+    onChange: (value: string[]) => void;
+};
+export type ComboboxProps = ComboboxSingleProps | ComboboxMultiProps;
+export declare function Combobox(props: ComboboxProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=Combobox.d.ts.map

package/dist/components/Combobox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../src/components/Combobox.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKjG,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,yDAAyD;IACzD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qCAAqC;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,iDAAiD;IACjD,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG;IACnD,QAAQ,EAAE,IAAI,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAErE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,2CAoT5C"}