@nikala-ui/docs 0.12.0

package/dist/vendor/core-src/registry/components/ui/combobox.tsx

@@ -0,0 +1,299 @@
+import { splitProps, type JSX, type ValidComponent } from "solid-js";
+import { Check, ChevronDown, X } from "lucide-solid";
+import { ScrollArea } from "@/components/ui/scroll-area";
+import * as ComboboxPrimitive from "@kobalte/core/combobox";
+import { cn } from "@/lib/cn";
+
+export type ComboboxRootProps<Option = any, OptGroup = any, T extends ValidComponent = "div"> =
+  ComboboxPrimitive.ComboboxRootProps<Option, OptGroup, T> & {
+    class?: string;
+    children?: JSX.Element;
+    triggerMode?: "input" | "focus" | "both" | "manual";
+  };
+
+/**
+ * Root Combobox component providing search, single/multi-selection, and group support.
+ * `triggerMode="focus"` or `triggerMode="both"` enables opening dropdown on input click/focus.
+ */
+export const Combobox = <Option = any, OptGroup = any, T extends ValidComponent = "div">(
+  props: ComboboxRootProps<Option, OptGroup, T>
+) => {
+  const [local, rest] = splitProps(props as ComboboxRootProps, ["class", "children", "triggerMode"]);
+
+  return (
+    <ComboboxPrimitive.Root
+      triggerMode={local.triggerMode ?? "input"}
+      class={cn("relative w-full", local.class)}
+      {...(rest as any)}
+    >
+      {local.children}
+    </ComboboxPrimitive.Root>
+  );
+};
+
+export type ComboboxControlProps<Option = any, T extends ValidComponent = "div"> =
+  ComboboxPrimitive.ComboboxControlProps<Option, T> & {
+    class?: string;
+    children?: JSX.Element;
+    clearable?: boolean;
+    onClear?: () => void;
+  };
+
+/**
+ * Input container for Combobox supporting search input, selected tags, and clear button.
+ */
+export const ComboboxControl = <Option = any, T extends ValidComponent = "div">(
+  props: ComboboxControlProps<Option, T>
+) => {
+  const [local, rest] = splitProps(props as ComboboxControlProps, [
+    "class",
+    "children",
+    "clearable",
+    "onClear",
+  ]);
+
+  return (
+    <ComboboxPrimitive.Control
+      class={cn(
+        "flex min-h-9 w-full flex-wrap items-center justify-between rounded-md border border-input bg-muted px-3 py-1 text-sm shadow-sm transition-colors focus-within:ring-1 focus-within:ring-primary focus-within:border-primary disabled:cursor-not-allowed disabled:opacity-50 gap-1.5 text-foreground",
+        local.class
+      )}
+      {...(rest as any)}
+    >
+      <div class="flex flex-wrap items-center gap-1.5 flex-1 min-w-0">
+        {local.children}
+      </div>
+
+      <div class="flex items-center gap-1 shrink-0 self-center">
+        {local.clearable && (
+          <button
+            type="button"
+            tabIndex={-1}
+            onClick={(e) => {
+              e.stopPropagation();
+              if (local.onClear) local.onClear();
+            }}
+            class="rounded-sm p-0.5 opacity-60 hover:opacity-100 hover:bg-accent text-foreground transition-opacity focus:outline-none cursor-pointer"
+            aria-label="Clear selection"
+          >
+            <svg class="h-3.5 w-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+              <path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
+            </svg>
+          </button>
+        )}
+        <ComboboxTrigger />
+      </div>
+    </ComboboxPrimitive.Control>
+  );
+};
+
+export type ComboboxInputProps<T extends ValidComponent = "input"> =
+  ComboboxPrimitive.ComboboxInputProps<T> & {
+    class?: string;
+    openOnFocus?: boolean;
+  };
+
+/**
+ * Search input field embedded within ComboboxControl.
+ * Supports `openOnFocus` to automatically trigger the dropdown when focused or clicked.
+ */
+export const ComboboxInput = <T extends ValidComponent = "input">(
+  props: ComboboxInputProps<T>
+) => {
+  const [local, rest] = splitProps(props as ComboboxInputProps, ["class", "openOnFocus", "onFocus", "onClick"]);
+
+  return (
+    <ComboboxPrimitive.Input
+      class={cn(
+        "flex-1 bg-transparent py-1 text-sm outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed text-foreground min-w-16",
+        local.class
+      )}
+      onFocus={(e: FocusEvent) => {
+        if (typeof local.onFocus === "function") local.onFocus(e as any);
+      }}
+      onClick={(e: MouseEvent) => {
+        if (typeof local.onClick === "function") local.onClick(e as any);
+      }}
+      {...(rest as any)}
+    />
+  );
+};
+
+export type ComboboxTriggerProps<T extends ValidComponent = "button"> =
+  ComboboxPrimitive.ComboboxTriggerProps<T> & {
+    class?: string;
+  };
+
+/**
+ * Dropdown chevron trigger icon.
+ */
+export const ComboboxTrigger = <T extends ValidComponent = "button">(
+  props: ComboboxTriggerProps<T>
+) => {
+  const [local, rest] = splitProps(props as ComboboxTriggerProps, ["class"]);
+
+  return (
+    <ComboboxPrimitive.Trigger
+      class={cn(
+        "flex h-4 w-4 items-center justify-center opacity-50 hover:opacity-100 transition-opacity focus:outline-none cursor-pointer",
+        local.class
+      )}
+      {...(rest as any)}
+    >
+      <ComboboxPrimitive.Icon
+        as="svg"
+        class="h-4 w-4 stroke-current stroke-2 fill-none"
+        viewBox="0 0 24 24"
+      >
+        <path stroke-linecap="round" stroke-linejoin="round" d="M19 9l-7 7-7-7" />
+      </ComboboxPrimitive.Icon>
+    </ComboboxPrimitive.Trigger>
+  );
+};
+
+export type ComboboxTokenProps<Option = any> = {
+  class?: string;
+  children?: JSX.Element;
+  item?: Option;
+  onRemove?: () => void;
+};
+
+/**
+ * Selected item tag token pill rendered in multi-select mode.
+ */
+export const ComboboxToken = <Option = any>(props: ComboboxTokenProps<Option>) => {
+  const [local, rest] = splitProps(props, ["class", "children", "onRemove"]);
+
+  return (
+    <span
+      class={cn(
+        "inline-flex items-center gap-1.5 rounded-md bg-accent px-2 py-0.5 text-xs font-medium text-accent-foreground border border-border shadow-2xs animate-in fade-in-50",
+        local.class
+      )}
+      {...rest}
+    >
+      <span class="truncate">{local.children}</span>
+      <button
+        type="button"
+        tabIndex={-1}
+        onClick={(e) => {
+          e.stopPropagation();
+          if (local.onRemove) local.onRemove();
+        }}
+        class="rounded-xs p-0.5 hover:bg-muted-foreground/20 text-muted-foreground hover:text-foreground transition-colors focus:outline-none cursor-pointer"
+        aria-label="Remove tag"
+      >
+        <svg class="h-3 w-3" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
+        </svg>
+      </button>
+    </span>
+  );
+};
+
+export type ComboboxContentProps<T extends ValidComponent = "div"> =
+  ComboboxPrimitive.ComboboxContentProps<T> & {
+    class?: string;
+  };
+
+/**
+ * Portaled popover content listbox container.
+ */
+export const ComboboxContent = <T extends ValidComponent = "div">(
+  props: ComboboxContentProps<T>
+) => {
+  const [local, rest] = splitProps(props as ComboboxContentProps, ["class"]);
+
+  return (
+    <ComboboxPrimitive.Portal>
+      <ComboboxPrimitive.Content
+        class={cn(
+          "relative z-50 min-w-8rem overflow-hidden rounded-md border border-border bg-popover text-popover-foreground shadow-md animate-in fade-in-80 data-expanded:animate-in data-closed:animate-out data-[closed]:fade-out-0 data-[expanded]:fade-in-0 data-closed:zoom-out-95 data-expanded:zoom-in-95 max-h-60",
+          local.class
+        )}
+        {...(rest as any)}
+      >
+        <ScrollArea class="max-h-60 w-full">
+          <ComboboxPrimitive.Listbox class="p-1 outline-none" />
+        </ScrollArea>
+      </ComboboxPrimitive.Content>
+    </ComboboxPrimitive.Portal>
+  );
+};
+
+export type ComboboxItemProps<T extends ValidComponent = "li"> =
+  ComboboxPrimitive.ComboboxItemProps<T> & {
+    class?: string;
+    children?: JSX.Element;
+  };
+
+/**
+ * Individual option item inside listbox supporting custom avatars, icons, and titles.
+ */
+export const ComboboxItem = <T extends ValidComponent = "li">(
+  props: ComboboxItemProps<T>
+) => {
+  const [local, rest] = splitProps(props as ComboboxItemProps, ["class", "children"]);
+
+  return (
+    <ComboboxPrimitive.Item
+      class={cn(
+        "relative flex w-full cursor-pointer select-none items-center rounded-sm py-1.5 pl-8 pr-2 text-sm outline-none data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground text-popover-foreground transition-colors",
+        local.class
+      )}
+      {...rest}
+    >
+      <ComboboxPrimitive.ItemIndicator class="absolute left-2 flex h-4 w-4 items-center justify-center text-primary">
+        <svg class="h-4 w-4 fill-none stroke-current stroke-2" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" d="M5 13l4 4L19 7" />
+        </svg>
+      </ComboboxPrimitive.ItemIndicator>
+      <ComboboxPrimitive.ItemLabel class="flex items-center gap-2 w-full truncate">
+        {local.children}
+      </ComboboxPrimitive.ItemLabel>
+    </ComboboxPrimitive.Item>
+  );
+};
+
+export type ComboboxGroupProps<T extends ValidComponent = "li"> =
+  ComboboxPrimitive.ComboboxSectionProps<T> & {
+    class?: string;
+    children?: JSX.Element;
+    label?: JSX.Element;
+  };
+
+/**
+ * Group container for organizing related options.
+ */
+export const ComboboxGroup = <T extends ValidComponent = "li">(
+  props: ComboboxGroupProps<T>
+) => {
+  const [local, rest] = splitProps(props as ComboboxGroupProps, ["class", "children", "label"]);
+
+  return (
+    <ComboboxPrimitive.Section class={cn("px-1 py-1", local.class)} {...(rest as any)}>
+      {local.label && (
+        <span class="px-2 py-1.5 text-xs font-semibold text-muted-foreground uppercase tracking-wider block">
+          {local.label}
+        </span>
+      )}
+      {local.children}
+    </ComboboxPrimitive.Section>
+  );
+};
+
+/**
+ * Empty state notice when no matching search items exist.
+ */
+export const ComboboxEmpty = (props: { class?: string; children?: JSX.Element }) => {
+  return (
+    <div class={cn("py-6 text-center text-sm text-muted-foreground", props.class)}>
+      {props.children || "No matching items found."}
+    </div>
+  );
+};
+
+/**
+ * Hidden native select element for form integrations.
+ */
+export const ComboboxHiddenSelect = ComboboxPrimitive.HiddenSelect;

package/dist/vendor/core-src/registry/components/ui/command.tsx

@@ -0,0 +1,378 @@
+import {
+  createContext,
+  useContext,
+  createSignal,
+  onCleanup,
+  Show,
+  splitProps,
+  type Component,
+  type JSX,
+  type Accessor,
+} from "solid-js";
+import { createKeybindings } from "@/hooks/create-keybindings";
+import { Dialog } from "@kobalte/core/dialog";
+import { Search, ArrowUp, ArrowDown, CornerDownLeft } from "lucide-solid";
+import { cn } from "@/lib/cn";
+import { Kbd, KbdGroup } from "../ui/kbd";
+import { InputGroup, InputGroupInput, InputGroupAddon } from "../ui/input-group";
+import { List, ListGroup, ListHeader, ListItem, type ListItemProps } from "../ui/list";
+import { ScrollArea } from "@/components/ui/scroll-area";
+
+/* --- Command Context State --- */
+interface CommandContextValue {
+  search: Accessor<string>;
+  setSearch: (value: string) => void;
+  activeIndex: Accessor<number>;
+  setActiveIndex: (fn: (prev: number) => number) => void;
+  registerItemIndex: (element: HTMLElement) => number;
+  onItemSelect: (index: number, action?: () => void) => void;
+}
+
+const CommandContext = createContext<CommandContextValue>();
+
+export const useCommand = () => {
+  const ctx = useContext(CommandContext);
+  if (!ctx) {
+    throw new Error("useCommand must be used within a <Command />");
+  }
+  return ctx;
+};
+
+/* --- Root Command Container --- */
+export interface CommandProps extends Omit<JSX.HTMLAttributes<HTMLDivElement>, "children"> {
+  class?: string;
+  children?: JSX.Element | ((ctx: CommandContextValue) => JSX.Element);
+}
+
+export const Command: Component<CommandProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class", "children"]);
+  const [search, setSearch] = createSignal("");
+  const [activeIndex, setActiveIndex] = createSignal(0);
+
+  let containerRef: HTMLDivElement | undefined;
+  let itemsList: HTMLElement[] = [];
+
+  const registerItemIndex = (element: HTMLElement) => {
+    if (!itemsList.includes(element)) {
+      itemsList.push(element);
+    }
+    return itemsList.indexOf(element);
+  };
+
+  const onItemSelect = (index: number, action?: () => void) => {
+    setActiveIndex(index);
+    if (action) action();
+  };
+
+  const getVisibleItems = () => {
+    if (!containerRef) return [];
+    return Array.from(containerRef.querySelectorAll<HTMLElement>("[data-command-item]:not(.hidden)"));
+  };
+
+  const updateActiveAttribute = (index: number) => {
+    const visible = getVisibleItems();
+    visible.forEach((el, idx) => {
+      if (idx === index) {
+        el.setAttribute("aria-selected", "true");
+        el.scrollIntoView({ block: "nearest" });
+      } else {
+        el.removeAttribute("aria-selected");
+      }
+    });
+  };
+
+  const handleKeyDown = (e: KeyboardEvent) => {
+    const visible = getVisibleItems();
+    if (visible.length === 0) return;
+
+    if (e.key === "ArrowDown") {
+      e.preventDefault();
+      const next = (activeIndex() + 1) % visible.length;
+      setActiveIndex(next);
+      updateActiveAttribute(next);
+    } else if (e.key === "ArrowUp") {
+      e.preventDefault();
+      const prev = (activeIndex() - 1 + visible.length) % visible.length;
+      setActiveIndex(prev);
+      updateActiveAttribute(prev);
+    } else if (e.key === "Enter") {
+      e.preventDefault();
+      const current = visible[activeIndex()];
+      if (current) {
+        current.click();
+      }
+    }
+  };
+
+  const ctx: CommandContextValue = {
+    search,
+    setSearch: (val) => {
+      setSearch(val);
+      setActiveIndex(0);
+    },
+    activeIndex,
+    setActiveIndex: (fn) => setActiveIndex(fn),
+    registerItemIndex,
+    onItemSelect,
+  };
+
+  return (
+    <CommandContext.Provider value={ctx}>
+      <div
+        ref={containerRef}
+        onKeyDown={handleKeyDown}
+        class={cn(
+          "flex flex-col w-full h-full rounded-lg bg-popover text-popover-foreground overflow-hidden border border-border shadow-md outline-none",
+          local.class
+        )}
+        tabIndex={0}
+        {...rest}
+      >
+        {typeof local.children === "function" ? (local.children as any)(ctx) : local.children}
+      </div>
+    </CommandContext.Provider>
+  );
+};
+
+/* --- Command Dialog (Modal) --- */
+export interface CommandDialogProps {
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  enableHotkey?: boolean;
+  children?: JSX.Element | ((ctx: CommandContextValue) => JSX.Element);
+  class?: string;
+}
+
+export const CommandDialog: Component<CommandDialogProps> = (props) => {
+  const [internalOpen, setInternalOpen] = createSignal(false);
+
+  const isOpen = () => (props.open !== undefined ? props.open : internalOpen());
+  const setOpen = (val: boolean) => {
+    if (props.open === undefined) setInternalOpen(val);
+    if (typeof props.onOpenChange === "function") props.onOpenChange(val);
+  };
+
+  /* Listen for global Ctrl+K / Cmd+K hotkeys */
+  createKeybindings(
+    [
+      {
+        key: ["meta+k", "ctrl+k"],
+        handler: () => setOpen(!isOpen()),
+        preventDefault: true,
+      },
+    ],
+    {
+      enabled: () => props.enableHotkey !== false,
+    }
+  );
+
+  return (
+    <Dialog open={isOpen()} onOpenChange={setOpen}>
+      <Dialog.Portal>
+        <Dialog.Overlay class="fixed inset-0 z-50 bg-black/60 backdrop-blur-xs data-expanded:animate-in data-closed:animate-out data-[closed]:fade-out-0 data-[expanded]:fade-in-0" />
+        <div class="fixed inset-0 z-50 flex items-start justify-center pt-16 sm:pt-24 px-4">
+          <Dialog.Content class="w-full max-w-xl rounded-lg border border-border bg-popover text-popover-foreground shadow-2xl outline-none data-expanded:animate-in data-closed:animate-out data-[closed]:fade-out-0 data-[expanded]:fade-in-0 data-closed:zoom-out-95 data-expanded:zoom-in-95">
+            <Command class={props.class}>{props.children}</Command>
+          </Dialog.Content>
+        </div>
+      </Dialog.Portal>
+    </Dialog>
+  );
+};
+
+/* --- Command Input --- */
+export interface CommandInputProps
+  extends JSX.InputHTMLAttributes<HTMLInputElement> {
+  class?: string;
+}
+
+export const CommandInput: Component<CommandInputProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class", "value", "onInput"]);
+  const { search, setSearch } = useCommand();
+
+  return (
+    <InputGroup class="border-0 border-b border-border rounded-none bg-transparent px-3 py-1 shadow-none focus-within:ring-0 focus-within:border-border">
+      <InputGroupAddon align="inline-start">
+        <Search class="w-4 h-4 text-muted-foreground" />
+      </InputGroupAddon>
+
+      <InputGroupInput
+        value={search()}
+        onInput={(e) => {
+          setSearch(e.currentTarget.value);
+          if (typeof local.onInput === "function") {
+            local.onInput(e);
+          }
+        }}
+        placeholder="Type a command or search..."
+        class="h-11 text-base sm:text-sm font-medium"
+        {...rest}
+      />
+    </InputGroup>
+  );
+};
+
+/* --- Command List Container --- */
+export interface CommandListProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  class?: string;
+}
+
+export const CommandList: Component<CommandListProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class", "children"]);
+
+  return (
+    <ScrollArea
+      class={cn("max-h-82.5 p-1.5", local.class)}
+      {...rest}
+    >
+      <List>{local.children}</List>
+    </ScrollArea>
+  );
+};
+
+/* --- Command Empty Block --- */
+export interface CommandEmptyProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  class?: string;
+}
+
+export const CommandEmpty: Component<CommandEmptyProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class", "children"]);
+  const { search } = useCommand();
+
+  return (
+    <Show when={search().trim().length > 0}>
+      <div
+        class={cn(
+          "py-8 text-center text-sm text-muted-foreground font-medium select-none",
+          local.class
+        )}
+        {...rest}
+      >
+        {local.children || `No results found for "${search()}".`}
+      </div>
+    </Show>
+  );
+};
+
+/* --- Command Group --- */
+export interface CommandGroupProps {
+  heading: string;
+  children?: JSX.Element;
+  class?: string;
+}
+
+export const CommandGroup: Component<CommandGroupProps> = (props) => {
+  return (
+    <ListGroup class={props.class}>
+      <ListHeader title={props.heading} />
+      {props.children}
+    </ListGroup>
+  );
+};
+
+/* --- Command Item --- */
+export interface CommandItemProps extends ListItemProps {
+  keywords?: string[];
+  description?: string;
+  onSelect?: () => void;
+  shouldFilter?: boolean;
+}
+
+export const CommandItem: Component<CommandItemProps> = (props) => {
+  let itemRef: HTMLDivElement | undefined;
+  const [local, rest] = splitProps(props, [
+    "title",
+    "subtitle",
+    "description",
+    "keywords",
+    "onSelect",
+    "onClick",
+    "shouldFilter",
+    "class",
+  ]);
+  const { search } = useCommand();
+
+  /* Auto filter item based on search query */
+  const matchesSearch = () => {
+    if (local.shouldFilter === false) return true;
+    const query = search().toLowerCase().trim();
+    if (!query) return true;
+
+    const titleMatch = local.title?.toLowerCase().includes(query);
+    const subtitleMatch = local.subtitle?.toLowerCase().includes(query);
+    const descMatch = local.description?.toLowerCase().includes(query);
+    const keywordMatch = local.keywords?.some((k) =>
+      k.toLowerCase().includes(query)
+    );
+
+    return Boolean(titleMatch || subtitleMatch || descMatch || keywordMatch);
+  };
+
+  const handleClick = (e: MouseEvent) => {
+    if (typeof local.onSelect === "function") {
+      local.onSelect();
+    }
+    if (typeof local.onClick === "function") {
+      local.onClick(e as any);
+    }
+  };
+
+  return (
+    <Show when={matchesSearch()}>
+      <ListItem
+        ref={itemRef}
+        data-command-item="true"
+        title={local.title}
+        subtitle={local.subtitle || local.description}
+        onClick={handleClick}
+        class={cn(
+          "aria-selected:bg-accent aria-selected:text-accent-foreground cursor-pointer transition-colors hover:bg-accent hover:text-accent-foreground",
+          local.class
+        )}
+        {...rest}
+      />
+    </Show>
+  );
+};
+
+/* --- Command Footer --- */
+export interface CommandFooterProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  class?: string;
+  children?: JSX.Element;
+}
+
+export const CommandFooter: Component<CommandFooterProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class", "children"]);
+
+  return (
+    <div
+      class={cn(
+        "flex items-center justify-between border-t border-border bg-muted/30 px-3 py-2 text-xs text-muted-foreground select-none",
+        local.class
+      )}
+      {...rest}
+    >
+      <div class="flex items-center gap-3">
+        <span class="flex items-center gap-1">
+          <KbdGroup>
+            <Kbd size="sm"><ArrowUp class="w-2.5 h-2.5" /></Kbd>
+            <Kbd size="sm"><ArrowDown class="w-2.5 h-2.5" /></Kbd>
+          </KbdGroup>
+          <span>Navigate</span>
+        </span>
+
+        <span class="flex items-center gap-1">
+          <Kbd size="sm"><CornerDownLeft class="w-2.5 h-2.5" /></Kbd>
+          <span>Select</span>
+        </span>
+
+        <span class="flex items-center gap-1">
+          <Kbd size="sm">Esc</Kbd>
+          <span>Close</span>
+        </span>
+      </div>
+
+      {local.children}
+    </div>
+  );
+};