@firecms/ui 3.1.0-canary.24c8270 → 3.1.0-canary.501d471

package/src/components/SearchableSelect.tsx

@@ -0,0 +1,335 @@
+"use client";
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+import * as React from "react";
+import { useEffect, useRef, useState } from "react";
+import { Command as CommandPrimitive } from "cmdk";
+import { cls } from "../util";
+import { CheckIcon, KeyboardArrowDownIcon } from "../icons";
+import { Separator } from "./Separator";
+import {
+    defaultBorderMixin,
+    fieldBackgroundDisabledMixin,
+    fieldBackgroundHoverMixin,
+    fieldBackgroundInvisibleMixin,
+    fieldBackgroundMixin,
+    focusedDisabled
+} from "../styles";
+import { useInjectStyles } from "../hooks";
+import { usePortalContainer } from "../hooks/PortalContainerContext";
+
+// ─── Types ──────────────────────────────────────────────────────────────────
+
+export interface SearchableSelectProps {
+    /** Currently selected value. Can be one of the items or a custom string. */
+    value?: string;
+    /** Callback when the value changes (from selection or custom input). */
+    onValueChange?: (value: string) => void;
+    /** Placeholder shown when no value is selected. */
+    placeholder?: string;
+    /** Label above the field. */
+    label?: React.ReactNode | string;
+    /** Size variant. */
+    size?: "smallest" | "small" | "medium" | "large";
+    /** Whether the field is disabled. */
+    disabled?: boolean;
+    /** Whether to show an error state. */
+    error?: boolean;
+    /** Whether to use the invisible (borderless) style. */
+    invisible?: boolean;
+    /** CSS class for the trigger button. */
+    className?: string;
+    /** CSS class for the trigger input area. */
+    inputClassName?: string;
+    /** Render the selected value in a custom way in the trigger. */
+    renderValue?: (value: string) => React.ReactNode;
+    /** Whether the popover should trap focus. */
+    modalPopover?: boolean;
+    /** If true, allow accepting the typed text as the value even if it doesn't match an item. */
+    allowCustomValues?: boolean;
+    /** Portal container element. */
+    portalContainer?: HTMLElement | null;
+    /** If true, auto-open the popover on mount so the user can start typing immediately. */
+    autoFocus?: boolean;
+    /** The option items — use SearchableSelectItem. */
+    children: React.ReactNode;
+}
+
+export interface SearchableSelectItemProps {
+    value: string;
+    children?: React.ReactNode;
+    className?: string;
+}
+
+// ─── Component ──────────────────────────────────────────────────────────────
+
+export const SearchableSelect = React.forwardRef<
+    HTMLButtonElement,
+    SearchableSelectProps
+>(
+    (
+        {
+            value,
+            onValueChange,
+            placeholder = "Select...",
+            label,
+            size = "large",
+            disabled,
+            error,
+            invisible,
+            className,
+            inputClassName,
+            renderValue,
+            modalPopover = false,
+            allowCustomValues = true,
+            portalContainer,
+            autoFocus,
+            children,
+        },
+        ref
+    ) => {
+        const [isMounted, setIsMounted] = useState(false);
+        const [isPopoverOpen, setIsPopoverOpen] = useState(false);
+        const [search, setSearch] = useState("");
+        const inputRef = useRef<HTMLInputElement>(null);
+
+        const contextContainer = usePortalContainer();
+        const finalContainer = (portalContainer ?? contextContainer ?? undefined) as HTMLElement | undefined;
+
+        useEffect(() => {
+            setIsMounted(true);
+        }, []);
+
+        // Auto-open popover on mount when autoFocus is true
+        useEffect(() => {
+            if (autoFocus && isMounted) {
+                onPopoverOpenChange(true);
+            }
+        }, [autoFocus, isMounted]);
+
+        // Collect all item values + labels from children
+        const itemsMap = React.useMemo(() => {
+            const map = new Map<string, React.ReactNode>();
+            React.Children.forEach(children, (child) => {
+                if (React.isValidElement<SearchableSelectItemProps>(child) && child.props.value != null) {
+                    map.set(String(child.props.value), child.props.children ?? child.props.value);
+                }
+            });
+            return map;
+        }, [children]);
+
+        const onPopoverOpenChange = (open: boolean) => {
+            setIsPopoverOpen(open);
+            if (open) {
+                // Pre-fill search with current value for easy editing
+                setSearch(value ?? "");
+                // Focus the input after popover opens
+                setTimeout(() => inputRef.current?.focus(), 0);
+            }
+        };
+
+        const handleSelect = (selectedValue: string) => {
+            onValueChange?.(selectedValue);
+            setIsPopoverOpen(false);
+            setSearch("");
+        };
+
+        const handleInputKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
+            if (e.key === "Enter" && allowCustomValues) {
+                const trimmed = search.trim();
+                if (trimmed) {
+                    // If cmdk found no match, accept custom value
+                    // If there are matches, cmdk will handle selecting the highlighted one
+                    // We check if the current search is NOT one of the items
+                    const isExistingItem = itemsMap.has(trimmed);
+                    if (!isExistingItem) {
+                        e.preventDefault();
+                        handleSelect(trimmed);
+                    }
+                }
+            } else if (e.key === "Escape") {
+                setIsPopoverOpen(false);
+            }
+        };
+
+        // Resolve display label for the trigger
+        const displayLabel = React.useMemo(() => {
+            if (!value) return null;
+            if (renderValue) return renderValue(value);
+            const itemLabel = itemsMap.get(value);
+            if (itemLabel) return itemLabel;
+            return <span className="text-sm">{value}</span>;
+        }, [value, renderValue, itemsMap]);
+
+        useInjectStyles("SearchableSelect", `
+[cmdk-group] {
+  max-height: 45vh;
+  overflow-y: auto;
+}`);
+
+        return (
+            <div>
+                {label && (
+                    typeof label === "string"
+                        ? <div className={cls("text-sm font-medium ml-3.5 mb-1",
+                            error ? "text-red-500 dark:text-red-600" : "text-surface-accent-500 dark:text-surface-accent-300",
+                        )}>{label}</div>
+                        : label
+                )}
+
+                <PopoverPrimitive.Root
+                    open={isMounted && isPopoverOpen}
+                    onOpenChange={onPopoverOpenChange}
+                    modal={modalPopover}
+                >
+                    <PopoverPrimitive.Trigger asChild>
+                        <button
+                            ref={ref}
+                            disabled={disabled}
+                            onClick={() => !disabled && onPopoverOpenChange(!isPopoverOpen)}
+                            className={cls(
+                                {
+                                    "min-h-[28px]": size === "smallest",
+                                    "min-h-[32px]": size === "small",
+                                    "min-h-[44px]": size === "medium",
+                                    "min-h-[64px]": size === "large",
+                                },
+                                {
+                                    "py-0.5": size === "smallest",
+                                    "py-1": size === "small",
+                                    "py-2": size === "medium" || size === "large",
+                                },
+                                {
+                                    "px-2": size === "small" || size === "smallest",
+                                    "px-4": size === "medium" || size === "large",
+                                },
+                                "select-none rounded-md text-sm w-full text-start",
+                                "focus:ring-0 focus-visible:ring-0 outline-none focus:outline-none focus-visible:outline-none",
+                                invisible ? fieldBackgroundInvisibleMixin : fieldBackgroundMixin,
+                                disabled ? fieldBackgroundDisabledMixin : fieldBackgroundHoverMixin,
+                                "relative flex items-center",
+                                className,
+                                inputClassName
+                            )}
+                        >
+                            <div className="flex items-center justify-between w-full gap-1">
+                                <div className="flex-grow min-w-0 truncate">
+                                    {displayLabel ?? (
+                                        <span className="text-sm text-surface-accent-500 dark:text-surface-accent-400">
+                                            {placeholder}
+                                        </span>
+                                    )}
+                                </div>
+                                <div className={cls("flex-shrink-0 flex items-center")}>
+                                    <KeyboardArrowDownIcon
+                                        size={size === "large" ? "medium" : "small"}
+                                        className={cls("transition", isPopoverOpen ? "rotate-180" : "")}
+                                    />
+                                </div>
+                            </div>
+                        </button>
+                    </PopoverPrimitive.Trigger>
+                    <PopoverPrimitive.Portal container={finalContainer}>
+                        <PopoverPrimitive.Content
+                            className={cls(
+                                "z-50 overflow-hidden border bg-white dark:bg-surface-900 rounded-lg",
+                                defaultBorderMixin
+                            )}
+                            align="start"
+                            sideOffset={4}
+                            style={{ width: "var(--radix-popover-trigger-width)", minWidth: 180 }}
+                            onEscapeKeyDown={() => onPopoverOpenChange(false)}
+                        >
+                            <CommandPrimitive shouldFilter={true}>
+                                <div className="flex flex-row items-center">
+                                    <CommandPrimitive.Input
+                                        ref={inputRef}
+                                        value={search}
+                                        onValueChange={setSearch}
+                                        className={cls(
+                                            focusedDisabled,
+                                            "bg-transparent outline-none flex-1 h-full w-full text-surface-accent-900 dark:text-white",
+                                            {
+                                                "m-2 text-xs": size === "smallest" || size === "small",
+                                                "m-3 text-sm": size === "medium" || size === "large",
+                                            },
+                                        )}
+                                        placeholder="Search..."
+                                        onKeyDown={handleInputKeyDown}
+                                    />
+                                </div>
+                                <Separator orientation="horizontal" className="my-0" />
+                                <CommandPrimitive.List>
+                                    {allowCustomValues && search.trim() && !itemsMap.has(search.trim()) ? (
+                                        <CommandPrimitive.Empty
+                                            className="px-3 py-2 text-xs cursor-pointer text-primary hover:bg-surface-accent-100 dark:hover:bg-surface-accent-800"
+                                            onClick={() => handleSelect(search.trim())}
+                                        >
+                                            Use &ldquo;{search.trim()}&rdquo;
+                                        </CommandPrimitive.Empty>
+                                    ) : (
+                                        <CommandPrimitive.Empty className="px-3 py-2 text-xs text-text-secondary dark:text-text-secondary-dark">
+                                            No results found.
+                                        </CommandPrimitive.Empty>
+                                    )}
+                                    <CommandPrimitive.Group>
+                                        {React.Children.map(children, (child) => {
+                                            if (!React.isValidElement<SearchableSelectItemProps>(child)) return child;
+                                            const itemValue = child.props.value;
+                                            const isSelected = String(value) === String(itemValue);
+                                            return (
+                                                <CommandPrimitive.Item
+                                                    key={String(itemValue)}
+                                                    value={String(itemValue)}
+                                                    onMouseDown={(e) => {
+                                                        e.preventDefault();
+                                                        e.stopPropagation();
+                                                    }}
+                                                    onSelect={() => handleSelect(String(itemValue))}
+                                                    className={cls(
+                                                        "flex flex-row items-center gap-1.5",
+                                                        isSelected ? "bg-surface-accent-200 dark:bg-surface-accent-950" : "",
+                                                        "cursor-pointer",
+                                                        "m-0.5",
+                                                        "ring-offset-transparent",
+                                                        "p-1.5 rounded",
+                                                        "aria-[selected=true]:outline-none",
+                                                        "aria-[selected=true]:bg-surface-accent-100 aria-[selected=true]:dark:bg-surface-accent-900",
+                                                        "text-surface-accent-700 dark:text-surface-accent-300",
+                                                        child.props.className
+                                                    )}
+                                                >
+                                                    <div className={cls(
+                                                        "w-4 h-4 flex items-center justify-center flex-shrink-0",
+                                                        isSelected ? "text-primary" : "text-transparent",
+                                                    )}>
+                                                        {isSelected && <CheckIcon size={14} />}
+                                                    </div>
+                                                    {child.props.children ?? child.props.value}
+                                                </CommandPrimitive.Item>
+                                            );
+                                        })}
+                                    </CommandPrimitive.Group>
+                                </CommandPrimitive.List>
+                            </CommandPrimitive>
+                        </PopoverPrimitive.Content>
+                    </PopoverPrimitive.Portal>
+                </PopoverPrimitive.Root>
+            </div>
+        );
+    }
+);
+
+SearchableSelect.displayName = "SearchableSelect";
+
+// ─── Item ───────────────────────────────────────────────────────────────────
+
+/**
+ * A single option inside a SearchableSelect.
+ * The `value` prop is the string value that gets selected.
+ * The `children` is what's displayed in the dropdown.
+ * This component is not rendered directly — SearchableSelect reads its props.
+ */
+export function SearchableSelectItem(_props: SearchableSelectItemProps) {
+    // Rendered by SearchableSelect, not by React
+    return null;
+}

package/src/components/Skeleton.tsx

@@ -14,8 +14,8 @@ export function Skeleton({
                          }: SkeletonProps) {
     return <span
         style={{
-            width: width ? `${width}px` : "100%",
-            height: height ? `${height}px` : "12px"
+            width: width !== undefined ? `${width}px` : undefined,
+            height: height !== undefined ? `${height}px` : undefined
         }}
         className={
         cls(
@@ -23,6 +23,8 @@ export function Skeleton({
             "bg-surface-accent-200 dark:bg-surface-accent-800 rounded-md",
             "animate-pulse",
             "max-w-full max-h-full",
+            width === undefined ? "w-full" : "",
+            height === undefined ? "h-3" : "",
             className)
     }/>;
 }

package/src/components/Tabs.tsx

@@ -1,16 +1,24 @@
-import React, { useRef, useState, useEffect } from "react";
+import React, { createContext, useContext, useRef, useState, useEffect } from "react";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 import { cls } from "../util";
 import { defaultBorderMixin } from "../styles";
 import { IconButton } from "./IconButton";
 import { ChevronLeftIcon, ChevronRightIcon } from "../icons";
 
+type TabsMode = "primary" | "secondary";
+const TabsModeContext = createContext<TabsMode>("primary");
+
 export type TabsProps = {
     value: string,
     children: React.ReactNode,
     innerClassName?: string,
     className?: string,
-    onValueChange: (value: string) => void
+    onValueChange: (value: string) => void,
+    /**
+     * "primary" renders the default pill-style tabs.
+     * "secondary" renders underline-style tabs suitable for inner/nested panels.
+     */
+    mode?: TabsMode
 };
 
 export function Tabs({
@@ -18,7 +26,8 @@ export function Tabs({
     onValueChange,
     className,
     innerClassName,
-    children
+    children,
+    mode = "primary"
 }: TabsProps) {
     const scrollContainerRef = useRef<HTMLDivElement>(null);
     const [showLeftScroll, setShowLeftScroll] = useState(false);
@@ -67,7 +76,8 @@ export function Tabs({
         }
     };
 
-    return <TabsPrimitive.Root value={value} onValueChange={onValueChange} className={cls("flex flex-row items-center min-w-0", className)}>
+    return <TabsModeContext.Provider value={mode}>
+        <TabsPrimitive.Root value={value} onValueChange={onValueChange} className={cls("flex flex-row items-center min-w-0", className)}>
         {isScrollable && (
             <button
                 type="button"
@@ -78,7 +88,9 @@ export function Tabs({
                     "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-surface-400",
                     "disabled:pointer-events-none disabled:opacity-0",
                     "text-surface-600 dark:text-surface-400 hover:bg-surface-200 dark:hover:bg-surface-800",
-                    "mr-1 bg-surface-50 dark:bg-surface-900 border", defaultBorderMixin
+                    mode === "primary" && "mr-1 bg-surface-50 dark:bg-surface-900 border",
+                    mode === "primary" && defaultBorderMixin,
+                    mode === "secondary" && "mr-1"
                 )}
             >
                 <ChevronLeftIcon size="small" />
@@ -91,10 +103,10 @@ export function Tabs({
             style={{ scrollbarWidth: "none", msOverflowStyle: "none" }}
         >
             <TabsPrimitive.List className={cls(
-                "border",
-                defaultBorderMixin,
-                "gap-2",
-                "inline-flex h-10 items-center justify-center rounded-md bg-surface-50 p-1 text-surface-600 dark:bg-surface-900 dark:text-surface-400",
+                mode === "primary" && "border",
+                mode === "primary" && defaultBorderMixin,
+                mode === "primary" && "gap-2 inline-flex h-10 items-center justify-center rounded-md bg-surface-50 p-1 text-surface-600 dark:bg-surface-900 dark:text-surface-400",
+                mode === "secondary" && "gap-1 inline-flex h-9 items-center text-surface-500 dark:text-surface-400",
                 innerClassName)
             }>
                 {children}
@@ -110,13 +122,16 @@ export function Tabs({
                     "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-surface-400",
                     "disabled:pointer-events-none disabled:opacity-0",
                     "text-surface-600 dark:text-surface-400 hover:bg-surface-200 dark:hover:bg-surface-800",
-                    "ml-1 bg-surface-50 dark:bg-surface-900 border", defaultBorderMixin
+                    mode === "primary" && "ml-1 bg-surface-50 dark:bg-surface-900 border",
+                    mode === "primary" && defaultBorderMixin,
+                    mode === "secondary" && "ml-1"
                 )}
             >
                 <ChevronRightIcon size="small" />
             </button>
         )}
     </TabsPrimitive.Root>
+    </TabsModeContext.Provider>
 }
 
 export type TabProps = {
@@ -134,15 +149,28 @@ export function Tab({
     children,
     disabled
 }: TabProps) {
+    const mode = useContext(TabsModeContext);
+
+    const primaryClasses = cls(
+        "inline-flex items-center justify-center whitespace-nowrap rounded-sm px-3 py-1.5 text-sm font-medium ring-offset-white transition-all",
+        "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-surface-400 focus-visible:ring-offset-2",
+        "disabled:pointer-events-none disabled:opacity-50",
+        "data-[state=active]:bg-white data-[state=active]:text-surface-900 dark:data-[state=active]:bg-surface-950 dark:data-[state=active]:text-surface-50",
+    );
+
+    const secondaryClasses = cls(
+        "inline-flex items-center justify-center whitespace-nowrap px-3 py-1.5 text-sm font-medium transition-all",
+        "border-b-2 border-transparent -mb-px",
+        "focus-visible:outline-none",
+        "disabled:pointer-events-none disabled:opacity-50",
+        "hover:text-surface-700 dark:hover:text-surface-300",
+        "data-[state=active]:border-b-primary data-[state=active]:text-primary dark:data-[state=active]:border-b-primary dark:data-[state=active]:text-primary-dark",
+    );
+
     return <TabsPrimitive.Trigger value={value}
         disabled={disabled}
         className={cls(
-            "inline-flex items-center justify-center whitespace-nowrap rounded-sm px-3 py-1.5 text-sm font-medium ring-offset-white transition-all",
-            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-surface-400 focus-visible:ring-offset-2",
-            "disabled:pointer-events-none disabled:opacity-50",
-            "data-[state=active]:bg-white data-[state=active]:text-surface-900 dark:data-[state=active]:bg-surface-950 dark:data-[state=active]:text-surface-50",
-            // "data-[state=active]:border",
-            // defaultBorderMixin,
+            mode === "secondary" ? secondaryClasses : primaryClasses,
             className,
             innerClassName)}>
         {children}