@facter/ds-core 1.33.10 → 1.34.0

package/dist/index.d.mts

@@ -80,6 +80,8 @@ interface InputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>,
     label?: string;
     error?: boolean;
     icon?: React$1.ComponentType<any>;
+    /** Extra ReactNode rendered after label text (used by Form.Input for tooltip icon) */
+    labelSuffix?: React$1.ReactNode;
     containerClassName?: string;
     labelClassName?: string;
 }
@@ -858,25 +860,6 @@ interface TextareaProps extends Omit<React$1.TextareaHTMLAttributes<HTMLTextArea
 }
 declare const Textarea: React$1.NamedExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
 
-interface FormLabelProps extends React$1.LabelHTMLAttributes<HTMLLabelElement> {
-    required?: boolean;
-}
-declare const FormLabel: React$1.ForwardRefExoticComponent<FormLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
-interface FormDescriptionProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
-}
-declare const FormDescription: React$1.ForwardRefExoticComponent<FormDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>>;
-interface FormErrorProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
-    message?: string;
-}
-declare const FormError: React$1.ForwardRefExoticComponent<FormErrorProps & React$1.RefAttributes<HTMLParagraphElement>>;
-interface FormFieldWrapperProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    label?: string;
-    description?: string;
-    required?: boolean;
-    error?: string;
-}
-declare const FormFieldWrapper: React$1.ForwardRefExoticComponent<FormFieldWrapperProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface FormContextValue<T extends FieldValues = FieldValues> {
     form: UseFormReturn<T>;
 }
@@ -886,10 +869,17 @@ interface FormFieldContextValue {
     error?: string;
     isRequired?: boolean;
 }
+interface FieldTooltipConfig {
+    title: string;
+    description: string;
+}
+type FieldTooltip = string | FieldTooltipConfig;
 interface BaseFieldProps<T extends FieldValues = FieldValues> {
     name: FieldPath<T>;
     label?: string;
     description?: string;
+    /** Tooltip shown via info icon next to the label. String or { title, description } */
+    tooltip?: FieldTooltip;
     required?: boolean;
     disabled?: boolean;
     className?: string;
@@ -916,18 +906,11 @@ interface SelectOption {
 interface FormSelectProps<T extends FieldValues = FieldValues> extends BaseFieldProps<T> {
     options: SelectOption[];
     placeholder?: string;
-    multiple?: boolean;
-    searchable?: boolean;
-    clearable?: boolean;
     loading?: boolean;
     emptyText?: string;
-    icon?: React$1.ComponentType<{
-        className?: string;
-    }>;
     hideError?: boolean;
-    selectSize?: 'sm' | 'default' | 'lg';
-    /** Render as dropdown (default) or visual card grid */
-    variant?: 'default' | 'card';
+    /** Enable search input in dropdown */
+    searchable?: boolean;
     /** Server-side search callback. If not provided, filters locally */
     onSearch?: (query: string) => void;
     /** Infinite scroll: callback to load more items */
@@ -936,6 +919,25 @@ interface FormSelectProps<T extends FieldValues = FieldValues> extends BaseField
     hasMore?: boolean;
     /** Placeholder for the search input */
     searchPlaceholder?: string;
+    /** Dropdown position: 'bottom' (default), 'top', or 'auto' */
+    dropdownPosition?: 'bottom' | 'top' | 'auto';
+}
+interface FormMultiSelectProps<T extends FieldValues = FieldValues> extends BaseFieldProps<T> {
+    options: SelectOption[];
+    placeholder?: string;
+    loading?: boolean;
+    emptyText?: string;
+    hideError?: boolean;
+    /** Enable search input in dropdown */
+    searchable?: boolean;
+    /** Placeholder for the search input */
+    searchPlaceholder?: string;
+    /** Allow clearing all selected values */
+    clearable?: boolean;
+    /** Max visible chips before showing "+N" badge (default: 3) */
+    maxVisibleChips?: number;
+    /** Dropdown position: 'bottom' (default), 'top', or 'auto' */
+    dropdownPosition?: 'bottom' | 'top' | 'auto';
 }
 interface FormTextareaProps<T extends FieldValues = FieldValues> extends BaseFieldProps<T>, Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, 'name'> {
     hideError?: boolean;
@@ -962,16 +964,40 @@ interface FormRadioGroupProps<T extends FieldValues = FieldValues> extends BaseF
     hideError?: boolean;
 }
 
-declare function FormInput<T extends FieldValues = FieldValues>({ name, label, description, required, disabled, className, mask, icon, showPasswordToggle, inputSize, hideError, type, maxLength, ...inputProps }: FormInputProps<T>): react_jsx_runtime.JSX.Element;
+interface FormLabelProps extends React$1.LabelHTMLAttributes<HTMLLabelElement> {
+    required?: boolean;
+}
+declare const FormLabel: React$1.ForwardRefExoticComponent<FormLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+interface FormDescriptionProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
+}
+declare const FormDescription: React$1.ForwardRefExoticComponent<FormDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>>;
+interface FormErrorProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
+    message?: string;
+}
+declare const FormError: React$1.ForwardRefExoticComponent<FormErrorProps & React$1.RefAttributes<HTMLParagraphElement>>;
+interface FormFieldWrapperProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    label?: string;
+    description?: string;
+    required?: boolean;
+    error?: string;
+}
+declare const FormFieldWrapper: React$1.ForwardRefExoticComponent<FormFieldWrapperProps & React$1.RefAttributes<HTMLDivElement>>;
+
+declare function FormInput<T extends FieldValues = FieldValues>({ name, label, description, tooltip, required, disabled, className, mask, icon, showPasswordToggle, inputSize, hideError, type, maxLength, ...inputProps }: FormInputProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace FormInput {
     var displayName: string;
 }
 
-declare function FormSelect<T extends FieldValues = FieldValues>({ name, label, description, required, disabled, className, options, placeholder, icon, hideError, selectSize, emptyText, loading, variant, searchable, onSearch, onLoadMore, hasMore, searchPlaceholder, }: FormSelectProps<T>): react_jsx_runtime.JSX.Element;
+declare function FormSelect<T extends FieldValues = FieldValues>({ name, label, description, tooltip, required, disabled, className, options, placeholder, hideError, emptyText, loading, searchable, onSearch, onLoadMore, hasMore, searchPlaceholder, dropdownPosition, }: FormSelectProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace FormSelect {
     var displayName: string;
 }
 
+declare function FormMultiSelect<T extends FieldValues = FieldValues>({ name, label, description, tooltip, required, disabled, className, options, placeholder, hideError, emptyText, loading, searchable, searchPlaceholder, clearable, maxVisibleChips, dropdownPosition, }: FormMultiSelectProps<T>): react_jsx_runtime.JSX.Element;
+declare namespace FormMultiSelect {
+    var displayName: string;
+}
+
 declare function FormTextarea<T extends FieldValues = FieldValues>({ name, label, description, required, disabled, className, hideError, showCount, maxLength, ...textareaProps }: FormTextareaProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace FormTextarea {
     var displayName: string;
@@ -1012,6 +1038,7 @@ declare namespace FormRoot {
 declare const Form: typeof FormRoot & {
     Input: typeof FormInput;
     Select: typeof FormSelect;
+    MultiSelect: typeof FormMultiSelect;
     Textarea: typeof FormTextarea;
     Checkbox: typeof FormCheckbox;
     Switch: typeof FormSwitch;

package/dist/index.d.ts

@@ -80,6 +80,8 @@ interface InputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>,
     label?: string;
     error?: boolean;
     icon?: React$1.ComponentType<any>;
+    /** Extra ReactNode rendered after label text (used by Form.Input for tooltip icon) */
+    labelSuffix?: React$1.ReactNode;
     containerClassName?: string;
     labelClassName?: string;
 }
@@ -858,25 +860,6 @@ interface TextareaProps extends Omit<React$1.TextareaHTMLAttributes<HTMLTextArea
 }
 declare const Textarea: React$1.NamedExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
 
-interface FormLabelProps extends React$1.LabelHTMLAttributes<HTMLLabelElement> {
-    required?: boolean;
-}
-declare const FormLabel: React$1.ForwardRefExoticComponent<FormLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
-interface FormDescriptionProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
-}
-declare const FormDescription: React$1.ForwardRefExoticComponent<FormDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>>;
-interface FormErrorProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
-    message?: string;
-}
-declare const FormError: React$1.ForwardRefExoticComponent<FormErrorProps & React$1.RefAttributes<HTMLParagraphElement>>;
-interface FormFieldWrapperProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    label?: string;
-    description?: string;
-    required?: boolean;
-    error?: string;
-}
-declare const FormFieldWrapper: React$1.ForwardRefExoticComponent<FormFieldWrapperProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface FormContextValue<T extends FieldValues = FieldValues> {
     form: UseFormReturn<T>;
 }
@@ -886,10 +869,17 @@ interface FormFieldContextValue {
     error?: string;
     isRequired?: boolean;
 }
+interface FieldTooltipConfig {
+    title: string;
+    description: string;
+}
+type FieldTooltip = string | FieldTooltipConfig;
 interface BaseFieldProps<T extends FieldValues = FieldValues> {
     name: FieldPath<T>;
     label?: string;
     description?: string;
+    /** Tooltip shown via info icon next to the label. String or { title, description } */
+    tooltip?: FieldTooltip;
     required?: boolean;
     disabled?: boolean;
     className?: string;
@@ -916,18 +906,11 @@ interface SelectOption {
 interface FormSelectProps<T extends FieldValues = FieldValues> extends BaseFieldProps<T> {
     options: SelectOption[];
     placeholder?: string;
-    multiple?: boolean;
-    searchable?: boolean;
-    clearable?: boolean;
     loading?: boolean;
     emptyText?: string;
-    icon?: React$1.ComponentType<{
-        className?: string;
-    }>;
     hideError?: boolean;
-    selectSize?: 'sm' | 'default' | 'lg';
-    /** Render as dropdown (default) or visual card grid */
-    variant?: 'default' | 'card';
+    /** Enable search input in dropdown */
+    searchable?: boolean;
     /** Server-side search callback. If not provided, filters locally */
     onSearch?: (query: string) => void;
     /** Infinite scroll: callback to load more items */
@@ -936,6 +919,25 @@ interface FormSelectProps<T extends FieldValues = FieldValues> extends BaseField
     hasMore?: boolean;
     /** Placeholder for the search input */
     searchPlaceholder?: string;
+    /** Dropdown position: 'bottom' (default), 'top', or 'auto' */
+    dropdownPosition?: 'bottom' | 'top' | 'auto';
+}
+interface FormMultiSelectProps<T extends FieldValues = FieldValues> extends BaseFieldProps<T> {
+    options: SelectOption[];
+    placeholder?: string;
+    loading?: boolean;
+    emptyText?: string;
+    hideError?: boolean;
+    /** Enable search input in dropdown */
+    searchable?: boolean;
+    /** Placeholder for the search input */
+    searchPlaceholder?: string;
+    /** Allow clearing all selected values */
+    clearable?: boolean;
+    /** Max visible chips before showing "+N" badge (default: 3) */
+    maxVisibleChips?: number;
+    /** Dropdown position: 'bottom' (default), 'top', or 'auto' */
+    dropdownPosition?: 'bottom' | 'top' | 'auto';
 }
 interface FormTextareaProps<T extends FieldValues = FieldValues> extends BaseFieldProps<T>, Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, 'name'> {
     hideError?: boolean;
@@ -962,16 +964,40 @@ interface FormRadioGroupProps<T extends FieldValues = FieldValues> extends BaseF
     hideError?: boolean;
 }
 
-declare function FormInput<T extends FieldValues = FieldValues>({ name, label, description, required, disabled, className, mask, icon, showPasswordToggle, inputSize, hideError, type, maxLength, ...inputProps }: FormInputProps<T>): react_jsx_runtime.JSX.Element;
+interface FormLabelProps extends React$1.LabelHTMLAttributes<HTMLLabelElement> {
+    required?: boolean;
+}
+declare const FormLabel: React$1.ForwardRefExoticComponent<FormLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+interface FormDescriptionProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
+}
+declare const FormDescription: React$1.ForwardRefExoticComponent<FormDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>>;
+interface FormErrorProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
+    message?: string;
+}
+declare const FormError: React$1.ForwardRefExoticComponent<FormErrorProps & React$1.RefAttributes<HTMLParagraphElement>>;
+interface FormFieldWrapperProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    label?: string;
+    description?: string;
+    required?: boolean;
+    error?: string;
+}
+declare const FormFieldWrapper: React$1.ForwardRefExoticComponent<FormFieldWrapperProps & React$1.RefAttributes<HTMLDivElement>>;
+
+declare function FormInput<T extends FieldValues = FieldValues>({ name, label, description, tooltip, required, disabled, className, mask, icon, showPasswordToggle, inputSize, hideError, type, maxLength, ...inputProps }: FormInputProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace FormInput {
     var displayName: string;
 }
 
-declare function FormSelect<T extends FieldValues = FieldValues>({ name, label, description, required, disabled, className, options, placeholder, icon, hideError, selectSize, emptyText, loading, variant, searchable, onSearch, onLoadMore, hasMore, searchPlaceholder, }: FormSelectProps<T>): react_jsx_runtime.JSX.Element;
+declare function FormSelect<T extends FieldValues = FieldValues>({ name, label, description, tooltip, required, disabled, className, options, placeholder, hideError, emptyText, loading, searchable, onSearch, onLoadMore, hasMore, searchPlaceholder, dropdownPosition, }: FormSelectProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace FormSelect {
     var displayName: string;
 }
 
+declare function FormMultiSelect<T extends FieldValues = FieldValues>({ name, label, description, tooltip, required, disabled, className, options, placeholder, hideError, emptyText, loading, searchable, searchPlaceholder, clearable, maxVisibleChips, dropdownPosition, }: FormMultiSelectProps<T>): react_jsx_runtime.JSX.Element;
+declare namespace FormMultiSelect {
+    var displayName: string;
+}
+
 declare function FormTextarea<T extends FieldValues = FieldValues>({ name, label, description, required, disabled, className, hideError, showCount, maxLength, ...textareaProps }: FormTextareaProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace FormTextarea {
     var displayName: string;
@@ -1012,6 +1038,7 @@ declare namespace FormRoot {
 declare const Form: typeof FormRoot & {
     Input: typeof FormInput;
     Select: typeof FormSelect;
+    MultiSelect: typeof FormMultiSelect;
     Textarea: typeof FormTextarea;
     Checkbox: typeof FormCheckbox;
     Switch: typeof FormSwitch;