@timeax/form-palette 0.0.25 → 0.0.27

package/dist/index.d.mts

@@ -1916,6 +1916,11 @@ interface RadioItem<TValue> {
     description?: React.ReactNode;
     disabled?: boolean;
     key?: React.Key;
+    /**
+     * Option-level renderer (provided by the normaliser).
+     * If present, it overrides the variant-level `renderOption` for this item.
+     */
+    render?: (ctx: RadioRenderOptionContext<TValue>) => React.ReactNode;
 }
 /**
  * Mapping functions used when TItem is not `RadioItem<TValue>`.
@@ -1975,7 +1980,7 @@ interface ShadcnRadioUiProps<TItem, TValue> {
      *   items = [{ id: "free", title: "Free" }]
      *   optionValue = "id"
      */
-    optionValue?: (keyof TItem) | string;
+    optionValue?: keyof TItem | string;
     /**
      * Property name on TItem that holds the **label**.
      *
@@ -1983,7 +1988,7 @@ interface ShadcnRadioUiProps<TItem, TValue> {
      *   items = [{ id: "free", title: "Free" }]
      *   optionLabel = "title"
      */
-    optionLabel?: (keyof TItem) | string;
+    optionLabel?: keyof TItem | string;
     /**
      * Optional custom renderer for each option.
      *
@@ -2091,6 +2096,11 @@ interface CheckboxItem<TValue> {
     description?: React.ReactNode;
     disabled?: boolean;
     key?: React.Key;
+    /**
+     * Option-level renderer (provided by the normaliser).
+     * If present, it should override the variant-level `renderOption` for this item.
+     */
+    render?: (ctx: CheckboxRenderOptionContext<TValue>) => React.ReactNode;
     /**
      * Override tri-state behaviour for this item.
      * If undefined, variant-level `tristate` is used.
@@ -2287,6 +2297,8 @@ type NormalizedMultiItem = {
     description?: React.ReactNode;
     disabled?: boolean;
     icon?: React.ReactNode;
+    /** Option-level renderer (falls back to global renderOption) */
+    render?: (...args: any[]) => React.ReactNode;
     raw: MultiSelectOption;
 };
 type MultiSelectBaseProps = Pick<VariantBaseProps<SelectPrimitive$1[] | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
@@ -2735,22 +2747,22 @@ interface ShadcnCustomVariantProps<TValue = unknown> extends VariantBaseProps<TV
 type TreeKey = string | number;
 type TreeValue = TreeKey | TreeKey[] | undefined;
 type TreeSelectOption = TreeKey | {
-    label?: React.ReactNode;
+    label?: React__default.ReactNode;
     value?: TreeKey;
-    description?: React.ReactNode;
+    description?: React__default.ReactNode;
     disabled?: boolean;
-    icon?: React.ReactNode;
+    icon?: React__default.ReactNode;
     children?: TreeSelectOption[];
     [key: string]: any;
 };
 type NormalizedTreeItem = {
     key: string;
     value: TreeKey;
-    labelNode: React.ReactNode;
+    labelNode: React__default.ReactNode;
     labelText: string;
-    description?: React.ReactNode;
+    description?: React__default.ReactNode;
     disabled?: boolean;
-    icon?: React.ReactNode;
+    icon?: React__default.ReactNode;
     level: number;
     parentValue?: TreeKey;
     path: TreeKey[];
@@ -2758,6 +2770,7 @@ type NormalizedTreeItem = {
     children: NormalizedTreeItem[];
     raw: TreeSelectOption;
 };
+
 type BadgeVariant$1 = "default" | "secondary" | "destructive" | "outline";
 type TreeSelectBaseProps = Pick<VariantBaseProps<TreeValue>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
     options?: TreeSelectOption[];
@@ -2994,12 +3007,14 @@ type NormalizedSelectItem = {
     description?: React.ReactNode;
     disabled?: boolean;
     icon?: React.ReactNode;
+    /** Option-level renderer (falls back to global renderOption) */
+    render?: (...args: any[]) => React.ReactNode;
     raw: SelectOption;
 };
 /**
  * Shadcn-based Select variant.
  */
-interface ShadcnSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
+interface SelectBaseProps extends Pick<VariantBaseProps<SelectPrimitive | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
     /**
      * Options for the select.
      *
@@ -3104,13 +3119,6 @@ interface ShadcnSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive
         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.
@@ -3177,6 +3185,51 @@ interface ShadcnSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive
      */
     virtualScrollThreshold?: number;
 }
+type SelectDefaultModeProps = {
+    mode?: "default";
+    leadingIcons?: React.ReactNode[];
+    trailingIcons?: React.ReactNode[];
+    icon?: React.ReactNode;
+    iconGap?: number;
+    leadingIconSpacing?: number;
+    trailingIconSpacing?: number;
+    leadingControl?: React.ReactNode;
+    trailingControl?: React.ReactNode;
+    leadingControlClassName?: string;
+    trailingControlClassName?: string;
+    joinControls?: boolean;
+    extendBoxToControls?: boolean;
+    button?: never;
+    children?: never;
+};
+type SelectButtonModeButton = React.ReactNode | ((ctx: {
+    open: boolean;
+    selectedItem: NormalizedSelectItem | null;
+    selectedValue: SelectPrimitive | undefined;
+    placeholder?: React.ReactNode;
+}) => React.ReactNode);
+type SelectButtonModeProps = {
+    mode: "button";
+    /**
+     * Used when mode="button". If provided, this is the trigger.
+     * If not provided, `children` is used.
+     */
+    button?: SelectButtonModeButton;
+    children?: SelectButtonModeButton;
+    leadingIcons?: never;
+    trailingIcons?: never;
+    icon?: never;
+    iconGap?: never;
+    leadingIconSpacing?: never;
+    trailingIconSpacing?: never;
+    leadingControl?: never;
+    trailingControl?: never;
+    leadingControlClassName?: never;
+    trailingControlClassName?: never;
+    joinControls?: never;
+    extendBoxToControls?: never;
+};
+type ShadcnSelectVariantProps = SelectBaseProps & (SelectDefaultModeProps | SelectButtonModeProps);
 
 type SelectVariantProps = ShadcnSelectVariantProps;
 

package/dist/index.d.ts

@@ -1916,6 +1916,11 @@ interface RadioItem<TValue> {
     description?: React.ReactNode;
     disabled?: boolean;
     key?: React.Key;
+    /**
+     * Option-level renderer (provided by the normaliser).
+     * If present, it overrides the variant-level `renderOption` for this item.
+     */
+    render?: (ctx: RadioRenderOptionContext<TValue>) => React.ReactNode;
 }
 /**
  * Mapping functions used when TItem is not `RadioItem<TValue>`.
@@ -1975,7 +1980,7 @@ interface ShadcnRadioUiProps<TItem, TValue> {
      *   items = [{ id: "free", title: "Free" }]
      *   optionValue = "id"
      */
-    optionValue?: (keyof TItem) | string;
+    optionValue?: keyof TItem | string;
     /**
      * Property name on TItem that holds the **label**.
      *
@@ -1983,7 +1988,7 @@ interface ShadcnRadioUiProps<TItem, TValue> {
      *   items = [{ id: "free", title: "Free" }]
      *   optionLabel = "title"
      */
-    optionLabel?: (keyof TItem) | string;
+    optionLabel?: keyof TItem | string;
     /**
      * Optional custom renderer for each option.
      *
@@ -2091,6 +2096,11 @@ interface CheckboxItem<TValue> {
     description?: React.ReactNode;
     disabled?: boolean;
     key?: React.Key;
+    /**
+     * Option-level renderer (provided by the normaliser).
+     * If present, it should override the variant-level `renderOption` for this item.
+     */
+    render?: (ctx: CheckboxRenderOptionContext<TValue>) => React.ReactNode;
     /**
      * Override tri-state behaviour for this item.
      * If undefined, variant-level `tristate` is used.
@@ -2287,6 +2297,8 @@ type NormalizedMultiItem = {
     description?: React.ReactNode;
     disabled?: boolean;
     icon?: React.ReactNode;
+    /** Option-level renderer (falls back to global renderOption) */
+    render?: (...args: any[]) => React.ReactNode;
     raw: MultiSelectOption;
 };
 type MultiSelectBaseProps = Pick<VariantBaseProps<SelectPrimitive$1[] | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
@@ -2735,22 +2747,22 @@ interface ShadcnCustomVariantProps<TValue = unknown> extends VariantBaseProps<TV
 type TreeKey = string | number;
 type TreeValue = TreeKey | TreeKey[] | undefined;
 type TreeSelectOption = TreeKey | {
-    label?: React.ReactNode;
+    label?: React__default.ReactNode;
     value?: TreeKey;
-    description?: React.ReactNode;
+    description?: React__default.ReactNode;
     disabled?: boolean;
-    icon?: React.ReactNode;
+    icon?: React__default.ReactNode;
     children?: TreeSelectOption[];
     [key: string]: any;
 };
 type NormalizedTreeItem = {
     key: string;
     value: TreeKey;
-    labelNode: React.ReactNode;
+    labelNode: React__default.ReactNode;
     labelText: string;
-    description?: React.ReactNode;
+    description?: React__default.ReactNode;
     disabled?: boolean;
-    icon?: React.ReactNode;
+    icon?: React__default.ReactNode;
     level: number;
     parentValue?: TreeKey;
     path: TreeKey[];
@@ -2758,6 +2770,7 @@ type NormalizedTreeItem = {
     children: NormalizedTreeItem[];
     raw: TreeSelectOption;
 };
+
 type BadgeVariant$1 = "default" | "secondary" | "destructive" | "outline";
 type TreeSelectBaseProps = Pick<VariantBaseProps<TreeValue>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
     options?: TreeSelectOption[];
@@ -2994,12 +3007,14 @@ type NormalizedSelectItem = {
     description?: React.ReactNode;
     disabled?: boolean;
     icon?: React.ReactNode;
+    /** Option-level renderer (falls back to global renderOption) */
+    render?: (...args: any[]) => React.ReactNode;
     raw: SelectOption;
 };
 /**
  * Shadcn-based Select variant.
  */
-interface ShadcnSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
+interface SelectBaseProps extends Pick<VariantBaseProps<SelectPrimitive | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
     /**
      * Options for the select.
      *
@@ -3104,13 +3119,6 @@ interface ShadcnSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive
         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.
@@ -3177,6 +3185,51 @@ interface ShadcnSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive
      */
     virtualScrollThreshold?: number;
 }
+type SelectDefaultModeProps = {
+    mode?: "default";
+    leadingIcons?: React.ReactNode[];
+    trailingIcons?: React.ReactNode[];
+    icon?: React.ReactNode;
+    iconGap?: number;
+    leadingIconSpacing?: number;
+    trailingIconSpacing?: number;
+    leadingControl?: React.ReactNode;
+    trailingControl?: React.ReactNode;
+    leadingControlClassName?: string;
+    trailingControlClassName?: string;
+    joinControls?: boolean;
+    extendBoxToControls?: boolean;
+    button?: never;
+    children?: never;
+};
+type SelectButtonModeButton = React.ReactNode | ((ctx: {
+    open: boolean;
+    selectedItem: NormalizedSelectItem | null;
+    selectedValue: SelectPrimitive | undefined;
+    placeholder?: React.ReactNode;
+}) => React.ReactNode);
+type SelectButtonModeProps = {
+    mode: "button";
+    /**
+     * Used when mode="button". If provided, this is the trigger.
+     * If not provided, `children` is used.
+     */
+    button?: SelectButtonModeButton;
+    children?: SelectButtonModeButton;
+    leadingIcons?: never;
+    trailingIcons?: never;
+    icon?: never;
+    iconGap?: never;
+    leadingIconSpacing?: never;
+    trailingIconSpacing?: never;
+    leadingControl?: never;
+    trailingControl?: never;
+    leadingControlClassName?: never;
+    trailingControlClassName?: never;
+    joinControls?: never;
+    extendBoxToControls?: never;
+};
+type ShadcnSelectVariantProps = SelectBaseProps & (SelectDefaultModeProps | SelectButtonModeProps);
 
 type SelectVariantProps = ShadcnSelectVariantProps;