@soyfri/shared-library 1.5.0-beta.4 → 2.0.0-beta.0

package/dist/components/Select/Select.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.cjs","sources":["../../../src/components/Select/Select.sx.ts","../../../src/components/Select/Select.helpers.ts","../../../src/components/Select/_parts/SelectSearchHeader.tsx","../../../src/components/Select/_parts/SelectValue.tsx","../../../src/components/Select/_parts/SelectMenuItem.tsx","../../../src/components/Select/Select.tsx"],"sourcesContent":["import type { SelectProps as MuiSelectProps } from '@mui/material';\n\nimport { buildFormFieldSx } from '../_shared/formField.sx';\nimport type { LabelPosition } from './Select';\n\n/**\n * Builder de sx para el Select. Usa el builder compartido\n * `buildFormFieldSx`. El Select no necesita overrides específicos.\n */\nexport const buildSelectSx = (\n  borderRadius: number | string,\n  labelPosition: LabelPosition,\n): MuiSelectProps['sx'] =>\n  buildFormFieldSx({ borderRadius, labelPosition }) as MuiSelectProps['sx'];\n","import type { SelectOption } from './Select';\n\n/**\n * Filtra opciones por `label` (case-insensitive). Si `search` es vacío,\n * devuelve el array completo. Solo se usa en modo no-async.\n */\nexport const filterOptionsByLabel = (\n  options: SelectOption[],\n  search: string,\n): SelectOption[] => {\n  if (!search) return options;\n  const needle = search.toLowerCase();\n  return options.filter((opt) => opt.label.toLowerCase().includes(needle));\n};\n\n/**\n * Agrupa opciones por la propiedad `group`. Las opciones sin group caen\n * bajo la key especial `__default`. Devuelve un Record para iterar en orden\n * de inserción con Object.entries.\n */\nexport const groupOptions = (\n  options: SelectOption[],\n): Record<string, SelectOption[]> => {\n  const groups: Record<string, SelectOption[]> = {};\n  options.forEach((opt) => {\n    const group = opt.group || '__default';\n    if (!groups[group]) groups[group] = [];\n    groups[group].push(opt);\n  });\n  return groups;\n};\n\n/**\n * Determina si un conjunto de grupos está efectivamente vacío\n * (no hay grupos o solo existe `__default` sin items).\n */\nexport const isGroupedOptionsEmpty = (\n  groups: Record<string, SelectOption[]>,\n): boolean => {\n  const keys = Object.keys(groups);\n  if (keys.length === 0) return true;\n  if (keys.length === 1 && groups['__default'] && groups['__default'].length === 0) {\n    return true;\n  }\n  return false;\n};\n\n/**\n * Normaliza el valor actual al shape que espera el MUI Select:\n * - multiple: siempre array (aunque esté vacío).\n * - single:   string vacío si null/undefined.\n */\nexport const normalizeSelectValue = <T>(\n  value: T | T[] | null | undefined,\n  multiple: boolean,\n): T | T[] | '' => {\n  if (multiple) return (value ?? []) as T[];\n  return (value ?? '') as T | '';\n};\n\n/**\n * Evalúa si el valor actual está vacío (para decidir shrink del label\n * y visibilidad del placeholder).\n */\nexport const isSelectValueEmpty = (\n  normalizedValue: unknown,\n  multiple: boolean,\n): boolean => {\n  if (multiple) return Array.isArray(normalizedValue) && normalizedValue.length === 0;\n  return normalizedValue === '' || normalizedValue === null || normalizedValue === undefined;\n};\n","import React from 'react';\nimport { ListSubheader, TextField } from '@mui/material';\n\ninterface SelectSearchHeaderProps {\n  value: string;\n  onChange: (next: string) => void;\n  placeholder?: string;\n  inputRef?: React.Ref<HTMLInputElement>;\n}\n\n/**\n * Header sticky del menu del Select que contiene el input de búsqueda.\n * Se usa cuando `filterable` es true o cuando el Select opera en modo async.\n * Detiene la propagación de click/keydown para que el menu no se cierre ni\n * intercepte las teclas al tipear.\n */\nexport const SelectSearchHeader: React.FC<SelectSearchHeaderProps> = ({\n  value,\n  onChange,\n  placeholder = 'Buscar...',\n  inputRef,\n}) => {\n  return (\n    <ListSubheader\n      sx={{\n        px: 2,\n        pt: 1,\n        pb: 1,\n        backgroundColor: 'background.paper',\n        zIndex: 1,\n        position: 'sticky',\n        top: 0,\n      }}\n    >\n      <TextField\n        inputRef={inputRef}\n        placeholder={placeholder}\n        variant=\"standard\"\n        size=\"small\"\n        fullWidth\n        value={value}\n        onChange={(e) => onChange(e.target.value)}\n        slotProps={{ htmlInput: { autoFocus: true } }}\n        onClick={(e) => e.stopPropagation()}\n        onKeyDown={(e) => e.stopPropagation()}\n      />\n    </ListSubheader>\n  );\n};\n\nexport default SelectSearchHeader;\n","import React from 'react';\nimport { Avatar, Box, Chip, Typography } from '@mui/material';\nimport ClearIcon from '@mui/icons-material/Clear';\n\nimport type {\n  SelectOption,\n  RenderChipLabel,\n  ChipVariant,\n} from '../Select';\n\ninterface SelectValueProps<TValue extends SelectOption['value']> {\n  selected: TValue | TValue[] | null | undefined;\n  options: SelectOption[];\n  multiple: boolean;\n  placeholder?: string;\n  maxChipsToShow: number;\n  chipVariant: ChipVariant;\n  renderChipLabel?: RenderChipLabel;\n  /** Solo relevante en modo multiple. Recibe el nuevo array de valores. */\n  onDeleteChip?: (nextValues: TValue[]) => void;\n  /** Array de valores actuales (para componer el nuevo array al borrar chips). */\n  currentValues?: TValue[];\n}\n\n/**\n * Render del valor seleccionado del Select.\n * - single:   texto (label) o lo que devuelva `renderChipLabel`.\n * - multiple: chips con delete. Trunca después de `maxChipsToShow` mostrando \"+N más\".\n * - empty:    placeholder en color disabled.\n */\nexport function SelectValue<TValue extends SelectOption['value']>(\n  props: SelectValueProps<TValue>,\n) {\n  const {\n    selected,\n    options,\n    multiple,\n    placeholder,\n    maxChipsToShow,\n    chipVariant,\n    renderChipLabel,\n    onDeleteChip,\n    currentValues,\n  } = props;\n\n  const isEmpty =\n    !selected || (Array.isArray(selected) && selected.length === 0);\n\n  if (isEmpty) {\n    return (\n      <Typography sx={{ color: 'text.disabled' }}>{placeholder || ''}</Typography>\n    );\n  }\n\n  if (!multiple) {\n    const item = options.find((opt) => opt.value === selected);\n    if (renderChipLabel && item) return <>{renderChipLabel(item)}</>;\n    return <>{item?.label ?? String(selected)}</>;\n  }\n\n  const selectedValuesArray = selected as TValue[];\n  const displayedChips = selectedValuesArray.slice(0, maxChipsToShow);\n  const hiddenChipsCount = selectedValuesArray.length - maxChipsToShow;\n\n  const handleDelete = (chipValue: TValue) => {\n    if (!onDeleteChip || !currentValues) return;\n    onDeleteChip(currentValues.filter((v) => v !== chipValue));\n  };\n\n  return (\n    <Box sx={{ display: 'flex', flexWrap: 'wrap', gap: 0.5 }}>\n      {displayedChips.map((val) => {\n        const item = options.find((o) => o.value === val);\n        if (!item) return null;\n\n        return (\n          <Chip\n            variant={chipVariant}\n            color=\"primary\"\n            size=\"small\"\n            key={String(val)}\n            label={renderChipLabel ? renderChipLabel(item) : item.label}\n            avatar={item.img ? <Avatar src={item.img} /> : undefined}\n            onDelete={() => handleDelete(val)}\n            deleteIcon={<ClearIcon fontSize=\"small\" />}\n          />\n        );\n      })}\n      {hiddenChipsCount > 0 && (\n        <Chip size=\"small\" variant={chipVariant} label={`+${hiddenChipsCount} más`} />\n      )}\n    </Box>\n  );\n}\n\nexport default SelectValue;\n","import React from 'react';\nimport { ListItemIcon, MenuItem } from '@mui/material';\nimport CheckIcon from '@mui/icons-material/Check';\n\nimport type { SelectOption, RenderOptionItem } from '../Select';\n\ninterface RenderSelectMenuItemArgs {\n  option: SelectOption;\n  selected: boolean;\n  customRender?: RenderOptionItem | null;\n}\n\n/**\n * Render helper (no componente) que devuelve un <MenuItem> listo para\n * colocarse como hijo directo del <MuiSelect>. Se implementa como función\n * y no como componente porque MUI Select inspecciona `props.value` de sus\n * children para resolver la selección, y envolverlo en un componente extra\n * rompe esa detección.\n *\n * Incluye el icono de check a la izquierda cuando `selected` es true. Si el\n * consumer pasó un `<Option>{(opt) => ...}</Option>`, usa ese render para el\n * contenido principal; de lo contrario muestra `option.label`.\n */\nexport const renderSelectMenuItem = ({\n  option,\n  selected,\n  customRender,\n}: RenderSelectMenuItemArgs): React.ReactElement => (\n  <MenuItem\n    key={String(option.value)}\n    value={option.value}\n    disabled={option.disabled}\n    selected={selected}\n  >\n    <ListItemIcon sx={{ minWidth: 32 }}>\n      {selected && <CheckIcon color=\"success\" fontSize=\"small\" />}\n    </ListItemIcon>\n    {customRender ? customRender(option) : option.label}\n  </MenuItem>\n);\n","import React, {\n    isValidElement,\n    useEffect,\n    useMemo,\n    useRef,\n    useState,\n    type ReactElement,\n    type ReactNode,\n} from 'react';\nimport {\n    Box,\n    CircularProgress,\n    FormControl,\n    FormHelperText,\n    InputLabel,\n    ListSubheader,\n    MenuItem,\n    OutlinedInput,\n    Select as MuiSelect,\n    SelectChangeEvent,\n    Typography,\n    type SelectProps as MuiSelectProps,\n} from '@mui/material';\nimport { useTheme } from '@mui/material/styles';\nimport { Controller, type Control, type RegisterOptions } from 'react-hook-form';\n\nimport { buildSelectSx } from './Select.sx';\nimport { resolvePreset } from '../_shared/resolvePreset';\nimport {\n    filterOptionsByLabel,\n    groupOptions,\n    isGroupedOptionsEmpty,\n    isSelectValueEmpty,\n    normalizeSelectValue,\n} from './Select.helpers';\nimport { SelectSearchHeader } from './_parts/SelectSearchHeader';\nimport { SelectValue } from './_parts/SelectValue';\nimport { renderSelectMenuItem } from './_parts/SelectMenuItem';\n\n// ── Tipos de dominio ─────────────────────────────────────────────────────\nexport interface SelectOption {\n    value: string | number;\n    label: string;\n    img?: string;\n    disabled?: boolean;\n    group?: string;\n    [key: string]: any;\n}\n\nexport type LabelPosition = 'outside' | 'floating';\nexport type ChipVariant = 'outlined' | 'filled';\nexport type SelectSize = 'small' | 'medium';\n\n// ── Render slots ─────────────────────────────────────────────────────────\nexport type RenderOptionItem = (item: SelectOption) => ReactNode;\nexport type RenderChipLabel = (item: SelectOption) => ReactNode;\n\n// ── Sub-componente declarativo <Option> ──────────────────────────────────\nexport interface OptionProps {\n    children: RenderOptionItem;\n}\n\n// ── Props base ───────────────────────────────────────────────────────────\nexport interface BaseSelectProps<\n    TValue extends SelectOption['value'] = SelectOption['value'],\n> {\n    label?: string;\n    options?: SelectOption[];\n    defaultValue?: TValue | TValue[];\n    size?: SelectSize;\n    multiple?: boolean;\n    filterable?: boolean;\n    placeholder?: string;\n    children?: ReactElement<{ children: RenderOptionItem }>;\n    maxHeight?: number | string;\n    maxWidth?: number | string;\n    maxChipsToShow?: number;\n    renderChipLabel?: RenderChipLabel;\n    chipVariant?: ChipVariant;\n    loadOptions?: (inputValue: string) => Promise<SelectOption[]>;\n    loadingMessage?: ReactNode;\n    noOptionsMessage?: ReactNode;\n    debounceTimeout?: number;\n    disabled?: boolean;\n    error?: boolean;\n    helperText?: string;\n    /** Border radius del input (px o string CSS). Default: 10 */\n    borderRadius?: number | string;\n    /**\n     * Posición del label.\n     * - \"outside\" (default): label arriba del input, sin animación.\n     * - \"floating\": label clásico de MUI (flota dentro del notched outline).\n     */\n    labelPosition?: LabelPosition;\n    /**\n     * Nombre del preset de estilo registrado en `theme.styles.Select`.\n     * - `\"default\"` (o ausente) = estilo built-in del paquete.\n     * - Cualquier otro string = mergea el preset encima del estilo built-in.\n     */\n    preset?: string;\n    sx?: MuiSelectProps['sx'];\n    className?: string;\n}\n\n// ── Variantes discriminadas (RHF vs controlado) ──────────────────────────\nexport interface RHFSelectProps<\n    TValue extends SelectOption['value'] = SelectOption['value'],\n> extends BaseSelectProps<TValue> {\n    name: string;\n    control: Control<any>;\n    validation?: RegisterOptions;\n    value?: TValue | TValue[];\n    onChange?: (val: TValue | TValue[]) => void;\n}\n\nexport interface StandardSelectProps<\n    TValue extends SelectOption['value'] = SelectOption['value'],\n> extends BaseSelectProps<TValue> {\n    name?: string;\n    control?: never;\n    validation?: never;\n    value: TValue | TValue[];\n    onChange: (val: TValue | TValue[]) => void;\n}\n\n// ── API pública final ────────────────────────────────────────────────────\nexport type SelectProps<\n    TValue extends SelectOption['value'] = SelectOption['value'],\n> = RHFSelectProps<TValue> | StandardSelectProps<TValue>;\n\n// ── Sub-componente declarativo <Option> ──────────────────────────────────\nexport function Option(_props: OptionProps) {\n    return null;\n}\nOption.displayName = 'Option';\n\n// ── Componente ───────────────────────────────────────────────────────────\nexport function Select<TValue extends SelectOption['value'] = SelectOption['value']>(\n    props: SelectProps<TValue>,\n) {\n    const {\n        label,\n        options = [],\n        value,\n        onChange,\n        defaultValue,\n        size = 'small',\n        multiple = false,\n        filterable = false,\n        placeholder,\n        children,\n        maxHeight = 300,\n        maxWidth,\n        maxChipsToShow = 3,\n        renderChipLabel,\n        chipVariant = 'outlined',\n        loadOptions,\n        loadingMessage = 'Cargando opciones...',\n        noOptionsMessage = 'No hay opciones',\n        debounceTimeout = 300,\n        disabled = false,\n        error = false,\n        helperText,\n        borderRadius = 10,\n        labelPosition = 'outside',\n        preset,\n        sx,\n        className,\n        ...rest\n    } = props;\n\n    const theme = useTheme();\n    const presetSx = resolvePreset('Select', preset, theme);\n\n    const isRHFMode = 'control' in rest && (rest as any).control !== undefined;\n\n    // Custom render opcional vía <Option>{item => ...}</Option>\n    const customRender: RenderOptionItem | null = useMemo(() => {\n        if (React.Children.count(children) === 1) {\n            const child = React.Children.only(children);\n            if (isValidElement(child) && (child.type as any)?.displayName === 'Option') {\n                return (child.props as OptionProps).children;\n            }\n        }\n        return null;\n    }, [children]);\n\n    // Búsqueda / async\n    const [search, setSearch] = useState('');\n    const [asyncOptions, setAsyncOptions] = useState<SelectOption[]>([]);\n    const [loading, setLoading] = useState(false);\n    const debounceTimerRef = useRef<number | null>(null);\n    const searchInputRef = useRef<HTMLInputElement>(null);\n\n    // Focus/open tracking para el comportamiento del label \"outside\".\n    const [isOpen, setIsOpen] = useState(false);\n    const [isFocused, setIsFocused] = useState(false);\n\n    const isAsync = typeof loadOptions === 'function';\n    const currentOptions = isAsync ? asyncOptions : options;\n\n    useEffect(() => {\n        if (!isAsync) return;\n\n        if (debounceTimerRef.current) clearTimeout(debounceTimerRef.current);\n\n        if (search) {\n            setLoading(true);\n            debounceTimerRef.current = window.setTimeout(() => {\n                loadOptions!(search)\n                    .then(setAsyncOptions)\n                    .finally(() => {\n                        setLoading(false);\n                        searchInputRef.current?.focus();\n                    });\n            }, debounceTimeout);\n        } else {\n            setAsyncOptions([]);\n            setLoading(false);\n            searchInputRef.current?.focus();\n        }\n    }, [search, isAsync, loadOptions, debounceTimeout]);\n\n    const filteredOptions = useMemo(() => {\n        if (isAsync) return currentOptions;\n        if (!filterable) return currentOptions;\n        return filterOptionsByLabel(currentOptions, search);\n    }, [search, filterable, currentOptions, isAsync]);\n\n    const groupedOptions = useMemo(() => groupOptions(filteredOptions), [filteredOptions]);\n\n    // Items del menu (search header + loading/empty + grupos + opciones)\n    const menuItems = useMemo(() => {\n        const items: React.ReactNode[] = [];\n\n        if (filterable || isAsync) {\n            items.push(\n                <SelectSearchHeader\n                    key=\"search-header\"\n                    value={search}\n                    onChange={setSearch}\n                    inputRef={searchInputRef}\n                />,\n            );\n        }\n\n        const noOptions = isGroupedOptionsEmpty(groupedOptions);\n\n        if (loading) {\n            items.push(\n                <MenuItem key=\"loading-message\" disabled>\n                    <Box sx={{ display: 'flex', alignItems: 'center', gap: 1 }}>\n                        <CircularProgress size={20} />\n                        <Typography>{loadingMessage}</Typography>\n                    </Box>\n                </MenuItem>,\n            );\n        } else if (noOptions) {\n            items.push(\n                <MenuItem key=\"no-options-message\" disabled>\n                    <Typography>{noOptionsMessage}</Typography>\n                </MenuItem>,\n            );\n        } else {\n            Object.entries(groupedOptions).forEach(([group, opts]) => {\n                if (group !== '__default') {\n                    items.push(\n                        <ListSubheader key={group} disableSticky>\n                            {group}\n                        </ListSubheader>,\n                    );\n                }\n                opts.forEach((opt) => {\n                    const isSelected = multiple\n                        ? (value as TValue[] | undefined)?.includes(opt.value as TValue) ?? false\n                        : value === opt.value;\n\n                    items.push(\n                        renderSelectMenuItem({\n                            option: opt,\n                            selected: isSelected,\n                            customRender,\n                        }),\n                    );\n                });\n            });\n        }\n        return items;\n    }, [\n        groupedOptions,\n        customRender,\n        filterable,\n        isAsync,\n        search,\n        loading,\n        loadingMessage,\n        noOptionsMessage,\n        multiple,\n        value,\n    ]);\n\n    // Handler de cambio\n    const handleChangeInternal = (\n        event: SelectChangeEvent<any>,\n        rhfOnChange?: (...event: any[]) => void,\n    ) => {\n        const newValue = event.target.value;\n        if (isRHFMode) {\n            rhfOnChange?.(newValue);\n        } else {\n            (onChange as (val: TValue | TValue[]) => void)?.(newValue);\n        }\n    };\n\n    // Sx mergeado (defaults + consumer)\n    const mergedSx = [\n        buildSelectSx(borderRadius, labelPosition),\n        ...(presetSx ? [presetSx] : []),\n        ...(Array.isArray(sx) ? sx : [sx]),\n    ];\n\n    // Render base\n    const renderSelect = (\n        selectValue: any,\n        selectOnChange: any,\n        onBlur?: any,\n        inputRef?: any,\n        rhfError?: boolean,\n        rhfHelperText?: string,\n    ) => {\n        const finalError = rhfError ?? error;\n        const finalHelperText = rhfHelperText ?? helperText;\n\n        const inputElement =\n            labelPosition === 'floating' ? (\n                <OutlinedInput label={label} />\n            ) : (\n                <OutlinedInput />\n            );\n\n        const normalizedValue = normalizeSelectValue(selectValue, multiple);\n        const isEmpty = isSelectValueEmpty(normalizedValue, multiple);\n\n        // Shrink cuando hay valor, foco, o dropdown abierto.\n        const shouldShrink = !isEmpty || isFocused || isOpen;\n        // Placeholder solo cuando el label ya subió.\n        const shouldDisplayPlaceholder = isEmpty && (isFocused || isOpen) && !!placeholder;\n\n        return (\n            <FormControl\n                fullWidth\n                size={size}\n                error={finalError}\n                disabled={disabled}\n                className={className}\n                sx={mergedSx}\n            >\n                {label && <InputLabel shrink={shouldShrink}>{label}</InputLabel>}\n                <MuiSelect\n                    value={normalizedValue}\n                    defaultValue={defaultValue}\n                    multiple={multiple}\n                    onChange={selectOnChange}\n                    onBlur={(e) => {\n                        setIsFocused(false);\n                        onBlur?.(e);\n                    }}\n                    onFocus={() => setIsFocused(true)}\n                    onOpen={() => setIsOpen(true)}\n                    onClose={() => setIsOpen(false)}\n                    renderValue={(selected) => (\n                        <SelectValue<TValue>\n                            selected={selected as TValue | TValue[]}\n                            options={currentOptions}\n                            multiple={multiple}\n                            placeholder={placeholder}\n                            maxChipsToShow={maxChipsToShow}\n                            chipVariant={chipVariant}\n                            renderChipLabel={renderChipLabel}\n                            currentValues={(value as TValue[]) ?? []}\n                            onDeleteChip={(next) =>\n                                (onChange as (v: TValue | TValue[]) => void)?.(next)\n                            }\n                        />\n                    )}\n                    displayEmpty={shouldDisplayPlaceholder}\n                    input={inputElement}\n                    disabled={disabled}\n                    MenuProps={{\n                        PaperProps: {\n                            style: { maxHeight, maxWidth },\n                        },\n                    }}\n                    inputRef={inputRef}\n                    {...(rest as any)}\n                >\n                    {menuItems}\n                </MuiSelect>\n                {finalHelperText && <FormHelperText>{finalHelperText}</FormHelperText>}\n            </FormControl>\n        );\n    };\n\n    // Branch: RHF vs controlado\n    if (isRHFMode) {\n        const rhfProps = rest as RHFSelectProps<TValue>;\n        return (\n            <Controller\n                name={rhfProps.name}\n                control={rhfProps.control}\n                rules={rhfProps.validation}\n                render={({ field, fieldState: { error: fieldError } }) =>\n                    renderSelect(\n                        field.value,\n                        (e: SelectChangeEvent<any>) => handleChangeInternal(e, field.onChange),\n                        field.onBlur,\n                        field.ref,\n                        !!fieldError,\n                        fieldError?.message,\n                    )\n                }\n            />\n        );\n    }\n\n    return renderSelect(value, (e: SelectChangeEvent<any>) => handleChangeInternal(e));\n}\n\nexport default Select;\n"],"names":["buildFormFieldSx","jsx","ListSubheader","TextField","Typography","Fragment","jsxs","Box","Chip","Avatar","MenuItem","ListItemIcon","useTheme","resolvePreset","useMemo","isValidElement","_a","useState","useRef","useEffect","CircularProgress","OutlinedInput","FormControl","InputLabel","MuiSelect","FormHelperText","Controller"],"mappings":"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"}

package/{components → dist/components}/Select/Select.d.ts

@@ -1,4 +1,5 @@
-import { default as React, ReactElement } from 'react';
+import { ReactElement, ReactNode } from 'react';
+import { SelectProps as MuiSelectProps } from '@mui/material';
 import { Control, RegisterOptions } from 'react-hook-form';
 export interface SelectOption {
     value: string | number;
@@ -8,13 +9,19 @@ export interface SelectOption {
     group?: string;
     [key: string]: any;
 }
-type RenderOptionItem = (item: SelectOption) => React.ReactNode;
-type RenderChipLabel = (item: SelectOption) => React.ReactNode;
-interface BaseSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> {
+export type LabelPosition = 'outside' | 'floating';
+export type ChipVariant = 'outlined' | 'filled';
+export type SelectSize = 'small' | 'medium';
+export type RenderOptionItem = (item: SelectOption) => ReactNode;
+export type RenderChipLabel = (item: SelectOption) => ReactNode;
+export interface OptionProps {
+    children: RenderOptionItem;
+}
+export interface BaseSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> {
     label?: string;
     options?: SelectOption[];
     defaultValue?: TValue | TValue[];
-    size?: 'small' | 'medium';
+    size?: SelectSize;
     multiple?: boolean;
     filterable?: boolean;
     placeholder?: string;
@@ -25,23 +32,39 @@ interface BaseSelectProps<TValue extends SelectOption['value'] = SelectOption['v
     maxWidth?: number | string;
     maxChipsToShow?: number;
     renderChipLabel?: RenderChipLabel;
-    chipVariant?: 'outlined' | 'filled';
+    chipVariant?: ChipVariant;
     loadOptions?: (inputValue: string) => Promise<SelectOption[]>;
-    loadingMessage?: React.ReactNode;
-    noOptionsMessage?: React.ReactNode;
+    loadingMessage?: ReactNode;
+    noOptionsMessage?: ReactNode;
     debounceTimeout?: number;
     disabled?: boolean;
     error?: boolean;
     helperText?: string;
+    /** Border radius del input (px o string CSS). Default: 10 */
+    borderRadius?: number | string;
+    /**
+     * Posición del label.
+     * - "outside" (default): label arriba del input, sin animación.
+     * - "floating": label clásico de MUI (flota dentro del notched outline).
+     */
+    labelPosition?: LabelPosition;
+    /**
+     * Nombre del preset de estilo registrado en `theme.styles.Select`.
+     * - `"default"` (o ausente) = estilo built-in del paquete.
+     * - Cualquier otro string = mergea el preset encima del estilo built-in.
+     */
+    preset?: string;
+    sx?: MuiSelectProps['sx'];
+    className?: string;
 }
-interface RHFSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseSelectProps<TValue> {
+export interface RHFSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseSelectProps<TValue> {
     name: string;
     control: Control<any>;
     validation?: RegisterOptions;
     value?: TValue | TValue[];
     onChange?: (val: TValue | TValue[]) => void;
 }
-interface StandardSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseSelectProps<TValue> {
+export interface StandardSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseSelectProps<TValue> {
     name?: string;
     control?: never;
     validation?: never;
@@ -49,9 +72,6 @@ interface StandardSelectProps<TValue extends SelectOption['value'] = SelectOptio
     onChange: (val: TValue | TValue[]) => void;
 }
 export type SelectProps<TValue extends SelectOption['value'] = SelectOption['value']> = RHFSelectProps<TValue> | StandardSelectProps<TValue>;
-export interface OptionProps {
-    children: RenderOptionItem;
-}
 export declare function Option(_props: OptionProps): null;
 export declare namespace Option {
     var displayName: string;

package/{components → dist/components}/Select/Select.definitions.d.ts

@@ -11,4 +11,7 @@ export declare const ConstrainedWidthDefinition = "\nimport React, { useState }
 export declare const AllFeaturesCombinedDefinition = "\nimport React, { useState } from 'react';\nimport { Select, Option } from './Select'; // Asumiendo que Select.tsx est\u00E1 en el mismo directorio\nimport { Avatar, Box, Typography, Chip } from '@mui/material';\n\nconst allOptions = [\n    { value: 'gt', label: 'Guatemala', group: 'Centroam\u00E9rica' },\n    { value: 'admin', label: 'Administrador', img: 'https://placehold.co/40x40?text=A' },\n    { value: 'PENDING', label: 'Pendiente' },\n    { value: 'ca', label: 'Canad\u00E1', group: 'Norteam\u00E9rica' },\n    { value: 'user', label: 'Usuario', img: 'https://placehold.co/40x40?text=U' },\n    { value: 'COMPLETED', label: 'Completado' },\n];\n\nexport const AllFeaturesCombinedExample = () => {\n    const [value, setValue] = useState<string[]>(['gt', 'admin', 'PENDING', 'ca', 'user', 'COMPLETED']);\n    return (\n        <Box sx={{ width: 500 }}>\n            <Select\n                label=\"Selecci\u00F3n Completa\"\n                multiple\n                filterable\n                maxChipsToShow={3}\n                maxHeight={250}\n                maxWidth=\"400px\"\n                options={allOptions}\n                value={value}\n                onChange={(val) => setValue(val as string[])}\n                placeholder=\"Busca y selecciona todo tipo de elementos\"\n                renderChipLabel={(item) => (\n                    <Box sx={{ display: 'flex', alignItems: 'center', gap: 0.5 }}>\n                        {item.img && <Avatar src={item.img} sx={{ width: 16, height: 16 }} />}\n                        <Typography variant=\"caption\" sx={{ fontWeight: 'bold' }}>\n                            {item.label.length > 10 ? item.label.substring(0, 7) + '...' : item.label}\n                        </Typography>\n                    </Box>\n                )}\n            >\n                <Option>\n                    {(item) => (\n                        <Box sx={{ display: 'flex', alignItems: 'center', gap: 1, my: 0.5 }}>\n                            {item.img && <Avatar src={item.img} sx={{ width: 28, height: 28 }} />}\n                            <Box>\n                                <Typography variant=\"body2\" fontWeight=\"medium\">{item.label}</Typography>\n                                {item.group && (\n                                    <Typography variant=\"caption\" color=\"text.secondary\">\n                                        Grupo: {item.group}\n                                    </Typography>\n                                )}\n                                {item.disabled && <Chip label=\"No disponible\" size=\"small\" color=\"warning\" sx={{ ml: 1 }} />}\n                            </Box>\n                        </Box>\n                    )}\n                </Option>\n            </Select>\n            <Typography sx={{ mt: 2 }}>Valor seleccionado: {JSON.stringify(value)}</Typography>\n        </Box>\n    );\n};\n";
 export declare const EmptyOptionsDefinition = "\nimport React, { useState } from 'react';\nimport { Select } from './Select'; // Asumiendo que Select.tsx est\u00E1 en el mismo directorio\nimport { Box, Typography } from '@mui/material';\n\nexport const EmptyOptionsExample = () => {\n    const [value, setValue] = useState(null);\n    return (\n        <Box sx={{ width: 300 }}>\n            <Select\n                label=\"Seleccionar (Vac\u00EDo)\"\n                options={[]}\n                value={value}\n                onChange={setValue}\n                placeholder=\"No hay opciones disponibles\"\n            />\n            <Typography sx={{ mt: 2 }}>Valor seleccionado: {value || 'Ninguno'}</Typography>\n        </Box>\n    );\n};\n";
 export declare const SelectWithManyOptionsDefinition = "\nimport React, { useState } from 'react';\nimport { Select } from './Select'; // Asumiendo que Select.tsx est\u00E1 en el mismo directorio\nimport { Box, Typography } from '@mui/material';\n\nconst manyOptions = Array.from({ length: 50 }, (_, i) => ({\n    value: `option-${i}`,\n    label: `Opci\u00F3n ${i + 1}`,\n    group: i < 25 ? 'Grupo A' : 'Grupo B',\n}));\n\nexport const SelectWithManyOptionsExample = () => {\n    const [value, setValue] = useState('');\n    return (\n        <Box sx={{ width: 300 }}>\n            <Select\n                label=\"Muchas Opciones\"\n                options={manyOptions}\n                value={value}\n                onChange={(val) => setValue(val as string)}\n                filterable\n                maxHeight={200}\n            />\n            <Typography sx={{ mt: 2 }}>Valor seleccionado: {value}</Typography>\n        </Box>\n    );\n};\n";
+export declare const LabelPositionFloatingDefinition = "\nimport React, { useState } from 'react';\nimport { Select } from './Select';\nimport { Box, Typography } from '@mui/material';\n\nconst basicOptions = [\n    { value: '10', label: '10' },\n    { value: '25', label: '25' },\n    { value: '50', label: '50' },\n    { value: '100', label: '100' },\n];\n\nexport const LabelPositionFloatingExample = () => {\n    const [value, setValue] = useState('');\n    return (\n        <Box sx={{ width: 300 }}>\n            <Select\n                label=\"Label flotante (MUI nativo)\"\n                options={basicOptions}\n                value={value}\n                onChange={(val) => setValue(val as string)}\n                labelPosition=\"floating\"\n            />\n            <Typography sx={{ mt: 2 }}>Valor seleccionado: {value || 'Ninguno'}</Typography>\n        </Box>\n    );\n};\n";
+export declare const CustomBorderRadiusDefinition = "\nimport React, { useState } from 'react';\nimport { Select } from './Select';\nimport { Box } from '@mui/material';\n\nconst basicOptions = [\n    { value: '10', label: '10' },\n    { value: '25', label: '25' },\n    { value: '50', label: '50' },\n    { value: '100', label: '100' },\n];\n\nexport const CustomBorderRadiusExample = () => {\n    const [valueA, setValueA] = useState('25');\n    const [valueB, setValueB] = useState('25');\n    const [valueC, setValueC] = useState('25');\n    return (\n        <Box sx={{ width: 300, display: 'flex', flexDirection: 'column', gap: 2 }}>\n            <Select\n                label=\"Sin border radius\"\n                options={basicOptions}\n                value={valueA}\n                onChange={(val) => setValueA(val as string)}\n                borderRadius={0}\n            />\n            <Select\n                label=\"Border radius est\u00E1ndar\"\n                options={basicOptions}\n                value={valueB}\n                onChange={(val) => setValueB(val as string)}\n                borderRadius={10}\n            />\n            <Select\n                label=\"Pill-shaped\"\n                options={basicOptions}\n                value={valueC}\n                onChange={(val) => setValueC(val as string)}\n                borderRadius={999}\n            />\n        </Box>\n    );\n};\n";
+export declare const CustomStylingDefinition = "\nimport React, { useState } from 'react';\nimport { Select } from './Select';\nimport { Box, Typography } from '@mui/material';\n\nconst userOptions = [\n    { value: 'admin', label: 'Administrador', img: 'https://placehold.co/40x40?text=A' },\n    { value: 'user', label: 'Usuario', img: 'https://placehold.co/40x40?text=U' },\n    { value: 'moderator', label: 'Moderador', img: 'https://placehold.co/40x40?text=M' },\n];\n\nexport const CustomStylingExample = () => {\n    const [value, setValue] = useState<string[]>(['admin']);\n    return (\n        <Box sx={{ width: 360 }}>\n            <Select\n                label=\"Select con estilos personalizados\"\n                options={userOptions}\n                multiple\n                value={value}\n                onChange={(val) => setValue(val as string[])}\n                placeholder=\"Selecciona usuarios\"\n                sx={{\n                    '& .MuiInputBase-root': {\n                        backgroundColor: 'action.hover',\n                    },\n                    '& .MuiOutlinedInput-notchedOutline': {\n                        borderColor: 'primary.main',\n                        borderWidth: '2px',\n                    },\n                    '&:hover .MuiOutlinedInput-notchedOutline': {\n                        borderColor: 'primary.dark',\n                    },\n                }}\n            />\n            <Typography sx={{ mt: 2 }}>Valor seleccionado: {JSON.stringify(value)}</Typography>\n        </Box>\n    );\n};\n";
 export declare const AsyncSelectDefinition = "\nimport React, { useState } from 'react';\nimport { Select } from './Select';\nimport { Box, Typography } from '@mui/material';\n\nconst mockAsyncOptions = [\n    { value: 'apple', label: 'Apple' },\n    { value: 'banana', label: 'Banana' },\n    { value: 'orange', label: 'Orange' },\n    { value: 'grape', label: 'Grape' },\n    { value: 'strawberry', label: 'Strawberry' },\n    { value: 'blueberry', label: 'Blueberry' },\n    { value: 'pineapple', label: 'Pineapple' },\n];\n\n// Simulate an API call\nconst simulatedLoadOptions = (inputValue: string): Promise<any[]> => {\n    return new Promise((resolve) => {\n        setTimeout(() => {\n            const filtered = mockAsyncOptions.filter(option =>\n                option.label.toLowerCase().includes(inputValue.toLowerCase())\n            );\n            resolve(filtered);\n        }, 800); // Simulate network delay\n    });\n};\n\nexport const AsyncSelectExample = () => {\n    const [value, setValue] = useState('');\n    return (\n        <Box sx={{ width: 300 }}>\n            <Select\n                label=\"Buscar Frutas\"\n                loadOptions={simulatedLoadOptions}\n                value={value}\n                onChange={(val) => setValue(val as string)}\n                placeholder=\"Escribe para buscar...\"\n                loadingMessage=\"Buscando frutas...\"\n                noOptionsMessage=\"No se encontraron frutas.\"\n            />\n            <Typography sx={{ mt: 2 }}>Valor seleccionado: {value}</Typography>\n        </Box>\n    );\n};\n";

package/dist/components/Select/Select.helpers.d.ts

@@ -0,0 +1,28 @@
+import { SelectOption } from './Select';
+/**
+ * Filtra opciones por `label` (case-insensitive). Si `search` es vacío,
+ * devuelve el array completo. Solo se usa en modo no-async.
+ */
+export declare const filterOptionsByLabel: (options: SelectOption[], search: string) => SelectOption[];
+/**
+ * Agrupa opciones por la propiedad `group`. Las opciones sin group caen
+ * bajo la key especial `__default`. Devuelve un Record para iterar en orden
+ * de inserción con Object.entries.
+ */
+export declare const groupOptions: (options: SelectOption[]) => Record<string, SelectOption[]>;
+/**
+ * Determina si un conjunto de grupos está efectivamente vacío
+ * (no hay grupos o solo existe `__default` sin items).
+ */
+export declare const isGroupedOptionsEmpty: (groups: Record<string, SelectOption[]>) => boolean;
+/**
+ * Normaliza el valor actual al shape que espera el MUI Select:
+ * - multiple: siempre array (aunque esté vacío).
+ * - single:   string vacío si null/undefined.
+ */
+export declare const normalizeSelectValue: <T>(value: T | T[] | null | undefined, multiple: boolean) => T | T[] | "";
+/**
+ * Evalúa si el valor actual está vacío (para decidir shrink del label
+ * y visibilidad del placeholder).
+ */
+export declare const isSelectValueEmpty: (normalizedValue: unknown, multiple: boolean) => boolean;