@timeax/form-palette 0.0.2 → 0.0.4

package/dist/presets/shadcn-variants/radio.js

@@ -0,0 +1,192 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// src/presets/shadcn-variants/radio.tsx
+import * as React from "react";
+import { cn } from "@/lib/utils";
+// Adjust path if your radio group lives elsewhere
+import { RadioGroup, RadioGroupItem, } from "@/presets/ui/radio-group";
+// ─────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────
+function paddingForDensity(density) {
+    switch (density) {
+        case "compact":
+            return "py-1.5";
+        case "loose":
+            return "py-3";
+        case "comfortable":
+        default:
+            return "py-1";
+    }
+}
+function labelTextSize(size) {
+    switch (size) {
+        case "sm":
+            return "text-xs";
+        case "lg":
+            return "text-base";
+        case "md":
+        default:
+            return "text-sm";
+    }
+}
+function descriptionTextSize(size) {
+    switch (size) {
+        case "sm":
+            return "text-[0.7rem]";
+        case "lg":
+            return "text-sm";
+        case "md":
+        default:
+            return "text-xs";
+    }
+}
+/**
+ * Normalise TItem[] into RadioItem<TValue>[] using one of:
+ * - explicit mappers
+ * - optionValue/optionLabel keys
+ * - native RadioItem fields
+ */
+function normalizeItems(items, mappers, optionValueKey, optionLabelKey) {
+    // 1) Full mappers win – most explicit
+    if (mappers) {
+        return items.map((item, index) => ({
+            value: mappers.getValue(item, index),
+            label: mappers.getLabel(item, index),
+            description: mappers.getDescription
+                ? mappers.getDescription(item, index)
+                : undefined,
+            disabled: mappers.isDisabled
+                ? mappers.isDisabled(item, index)
+                : false,
+            key: mappers.getKey ? mappers.getKey(item, index) : index,
+        }));
+    }
+    // 2) optionValue / optionLabel keys
+    if (optionValueKey || optionLabelKey) {
+        return items.map((item, index) => {
+            const anyItem = item;
+            const rawValue = optionValueKey != null
+                ? anyItem[optionValueKey]
+                : anyItem.value;
+            const value = rawValue;
+            const rawLabel = optionLabelKey != null
+                ? anyItem[optionLabelKey]
+                : anyItem.label ?? String(rawValue ?? index);
+            const description = anyItem.description;
+            const disabled = !!anyItem.disabled;
+            const key = anyItem.key ?? index;
+            return {
+                value,
+                label: rawLabel,
+                description,
+                disabled,
+                key,
+            };
+        });
+    }
+    // 3) Fallback: assume TItem already matches RadioItem<TValue>
+    return items;
+}
+/**
+ * Shallow-ish equality for values.
+ */
+function isEqualValue(a, b) {
+    return Object.is(a, b);
+}
+// ─────────────────────────────────────────────
+// Component
+// ─────────────────────────────────────────────
+const InnerShadcnRadioVariant = (props, ref) => {
+    const { 
+    // variant base
+    value, onValue, error, disabled, required, 
+    // radio UI
+    items, mappers, optionValue, optionLabel, renderOption, layout = "list", columns = 2, itemGapPx, size = "md", density = "comfortable", "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, name, groupClassName, optionClassName, labelClassName, descriptionClassName, className, // alias for groupClassName
+    id, 
+    // passthrough to RadioGroup
+    ...restGroupProps } = props;
+    const hasError = !!error;
+    const normalized = React.useMemo(() => normalizeItems(items, mappers, optionValue, optionLabel), [items, mappers, optionValue, optionLabel]);
+    // Map TValue → string for RadioGroup
+    const selectedString = React.useMemo(() => {
+        if (value === undefined)
+            return undefined;
+        const found = normalized.find((item) => isEqualValue(item.value, value));
+        return found ? String(found.value) : undefined;
+    }, [normalized, value]);
+    const handleSelect = React.useCallback((next) => {
+        if (!onValue || disabled)
+            return;
+        const detail = {
+            source: "variant",
+            raw: next,
+            nativeEvent: undefined,
+            meta: undefined,
+        };
+        onValue(next, detail);
+    }, [onValue, disabled]);
+    const handleRadioChange = React.useCallback((raw) => {
+        const found = normalized.find((item) => String(item.value) === raw);
+        if (!found)
+            return;
+        handleSelect(found.value);
+    }, [normalized, handleSelect]);
+    const groupStyle = React.useMemo(() => {
+        if (!itemGapPx) {
+            if (layout === "grid") {
+                return {
+                    gridTemplateColumns: `repeat(${columns}, minmax(0, 1fr))`,
+                };
+            }
+            return undefined;
+        }
+        if (layout === "list") {
+            return { rowGap: itemGapPx };
+        }
+        return {
+            gridTemplateColumns: `repeat(${columns}, minmax(0, 1fr))`,
+            gap: itemGapPx,
+        };
+    }, [layout, columns, itemGapPx]);
+    const groupClasses = cn(layout === "grid" ? "grid" : "flex flex-col", groupClassName ?? className);
+    const baseOptionClass = cn(
+    // layout container for each option row
+    "relative flex items-start", 
+    // keep disabled styles
+    "data-[disabled=true]:opacity-60 data-[disabled=true]:cursor-not-allowed", 
+    // vertical padding from density
+    paddingForDensity(density), optionClassName);
+    const labelClassesBase = cn("font-medium text-foreground", labelTextSize(size), labelClassName);
+    const descriptionClassesBase = cn("mt-0.5 text-muted-foreground", descriptionTextSize(size), descriptionClassName);
+    return (_jsx(RadioGroup, { ref: ref, id: id, name: name, value: selectedString, onValueChange: handleRadioChange, disabled: disabled, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, "aria-invalid": hasError || undefined, "aria-required": required || undefined, className: groupClasses, style: groupStyle, "data-slot": "radio-group", ...restGroupProps, children: normalized.map((item, index) => {
+            const itemString = String(item.value);
+            const selected = selectedString === itemString;
+            const optionDisabled = !!disabled || !!item.disabled;
+            const optionKey = item.key ?? index;
+            const optionId = id ? `${id}-option-${optionKey}` : undefined;
+            const radioNode = (_jsx(RadioGroupItem, { id: optionId, value: itemString, disabled: optionDisabled, className: "mt-1" }));
+            // Custom renderer path
+            if (renderOption) {
+                return (_jsx("div", { "data-slot": "radio-option", "data-checked": selected ? "true" : "false", "data-disabled": optionDisabled ? "true" : "false", className: baseOptionClass, children: renderOption({
+                        item,
+                        index,
+                        selected,
+                        disabled: optionDisabled,
+                        size,
+                        density,
+                        optionId,
+                        radio: radioNode,
+                    }) }, optionKey));
+            }
+            // Default rendering
+            return (_jsx("div", { "data-slot": "radio-option", "data-checked": selected ? "true" : "false", "data-disabled": optionDisabled ? "true" : "false", className: baseOptionClass, children: _jsxs("label", { htmlFor: optionId, className: "flex cursor-pointer items-start gap-3 w-full", children: [radioNode, _jsxs("div", { className: "flex flex-col min-w-0", children: [_jsx("span", { className: labelClassesBase, children: item.label }), item.description != null && (_jsx("span", { className: descriptionClassesBase, children: item.description }))] })] }) }, optionKey));
+        }) }));
+};
+/**
+ * Concrete Shadcn radio variant component.
+ *
+ * Cast to a generic-friendly type so TS can still infer TValue/TItem.
+ */
+export const ShadcnRadioVariant = React.forwardRef(InnerShadcnRadioVariant);
+export default ShadcnRadioVariant;
+//# sourceMappingURL=radio.js.map

package/dist/presets/shadcn-variants/radio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.js","sourceRoot":"","sources":["../../../src/presets/shadcn-variants/radio.tsx"],"names":[],"mappings":"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"}

package/dist/presets/shadcn-variants/select.d.ts

@@ -0,0 +1,203 @@
+import * as React from "react";
+import type { VariantBaseProps } from "@/variants/shared";
+type SelectPrimitive = string | number;
+export type SelectOption = SelectPrimitive | {
+    label?: React.ReactNode;
+    value?: SelectPrimitive;
+    description?: React.ReactNode;
+    disabled?: boolean;
+    [key: string]: any;
+};
+type NormalizedSelectItem = {
+    key: string;
+    value: SelectPrimitive;
+    labelNode: React.ReactNode;
+    labelText: string;
+    description?: React.ReactNode;
+    disabled?: boolean;
+    icon?: React.ReactNode;
+    raw: SelectOption;
+};
+/**
+ * Shadcn-based Select variant.
+ */
+export interface ShadcnSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
+    /**
+     * Options for the select.
+     *
+     * You can pass:
+     * - primitives: ["ng", "gh", "ke"]
+     * - objects:    [{ label, value, ...extra }]
+     */
+    options?: SelectOption[];
+    /**
+     * Automatically capitalise the first letter of the label
+     * (when the resolved label is a string).
+     */
+    autoCap?: boolean;
+    /**
+     * How to read the label from each option.
+     *
+     * - string → key on the option object
+     * - function → custom mapper
+     * - omitted → tries `label`, else String(value)
+     */
+    optionLabel?: string | ((item: SelectOption) => React.ReactNode);
+    /**
+     * How to read the value from each option.
+     *
+     * - string → key on the option object
+     * - function → custom mapper
+     * - omitted → uses `value`, or `id`, or `key`, or index
+     */
+    optionValue?: string | ((item: SelectOption) => SelectPrimitive);
+    /**
+     * Optional description line under the label.
+     */
+    optionDescription?: string | ((item: SelectOption) => React.ReactNode);
+    /**
+     * How to determine if an option is disabled.
+     */
+    optionDisabled?: string | ((item: SelectOption) => boolean);
+    /**
+     * How to extract an icon for each option.
+     *
+     * - string → key on the option object (default "icon")
+     * - function → custom mapper
+     */
+    optionIcon?: string | ((item: SelectOption) => React.ReactNode);
+    /**
+     * How to compute the React key for each option.
+     */
+    optionKey?: string | ((item: SelectOption, index: number) => React.Key);
+    /**
+     * Enable inline search inside the dropdown.
+     */
+    searchable?: boolean;
+    /**
+     * Placeholder for the search input.
+     */
+    searchPlaceholder?: string;
+    /**
+     * Label shown when there are no options available at all.
+     *
+     * If omitted, falls back to `emptySearchText` or a default message.
+     */
+    emptyLabel?: React.ReactNode;
+    /**
+     * Text to show when search yields no results
+     * (but there *are* options in general).
+     */
+    emptySearchText?: React.ReactNode;
+    /**
+     * Show a small clear button in the trigger when a value is selected.
+     */
+    clearable?: boolean;
+    /**
+     * Placeholder when nothing is selected.
+     */
+    placeholder?: React.ReactNode;
+    /**
+     * Wrapper class for the whole variant.
+     */
+    className?: string;
+    /**
+     * Extra classes for the SelectTrigger.
+     */
+    triggerClassName?: string;
+    /**
+     * Extra classes for the SelectContent popover.
+     */
+    contentClassName?: string;
+    /**
+     * Custom renderer for each option row.
+     */
+    renderOption?: (ctx: {
+        item: NormalizedSelectItem;
+        selected: boolean;
+        index: number;
+        option: React.ReactNode;
+    }) => React.ReactNode;
+    /**
+     * Custom renderer for the trigger value.
+     */
+    renderValue?: (ctx: {
+        selectedItem: NormalizedSelectItem | null;
+        placeholder?: React.ReactNode;
+    }) => React.ReactNode;
+    /**
+     * One or more icons displayed inside the trigger, on the left.
+     *
+     * If not provided and `icon` is set, that single icon
+     * is treated as `leadingIcons[0]`.
+     */
+    leadingIcons?: React.ReactNode[];
+    /**
+     * Icons displayed on the right side of the trigger,
+     * near the clear button / chevron area.
+     */
+    trailingIcons?: React.ReactNode[];
+    /**
+     * Convenience single-icon prop for the left side.
+     */
+    icon?: React.ReactNode;
+    /**
+     * Base gap between icons and text.
+     * Defaults to 4px-ish via `gap-1`.
+     */
+    iconGap?: number;
+    /**
+     * Extra spacing to apply between leading icons and the text.
+     */
+    leadingIconSpacing?: number;
+    /**
+     * Extra spacing to apply between trailing icons and the clear button.
+     */
+    trailingIconSpacing?: number;
+    /**
+     * Arbitrary React node rendered before the select (e.g. a button).
+     */
+    leadingControl?: React.ReactNode;
+    /**
+     * Arbitrary React node rendered after the select (e.g. a button).
+     */
+    trailingControl?: React.ReactNode;
+    /**
+     * Extra classes for the leading control wrapper.
+     */
+    leadingControlClassName?: string;
+    /**
+     * Extra classes for the trailing control wrapper.
+     */
+    trailingControlClassName?: string;
+    /**
+     * If true and there are controls, the select trigger + controls share
+     * a single visual box (borders, radius, focus states).
+     */
+    joinControls?: boolean;
+    /**
+     * When joinControls is true, whether the box styling extends over controls
+     * (true) or controls are visually separate (false).
+     */
+    extendBoxToControls?: boolean;
+    /**
+     * Enable incremental rendering for large option lists.
+     *
+     * When true, only a page of options is rendered initially,
+     * and more are revealed as the user scrolls down.
+     */
+    virtualScroll?: boolean;
+    /**
+     * Number of options to render per "page" when virtualScroll is enabled.
+     * Default: 50.
+     */
+    virtualScrollPageSize?: number;
+    /**
+     * Distance from the bottom (in px) at which the next page loads.
+     * Default: 48px.
+     */
+    virtualScrollThreshold?: number;
+}
+export declare const ShadcnSelectVariant: React.ForwardRefExoticComponent<ShadcnSelectVariantProps & React.RefAttributes<HTMLButtonElement>>;
+export default ShadcnSelectVariant;
+//# sourceMappingURL=select.d.ts.map

package/dist/presets/shadcn-variants/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/presets/shadcn-variants/select.tsx"],"names":[],"mappings":"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"}