@soyfri/shared-library 1.5.0 → 1.6.0-beta.1

package/components/Select/Select.cjs

@@ -0,0 +1,313 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const jsxRuntime = require("react/jsx-runtime");
+const React = require("react");
+const material = require("@mui/material");
+const styles = require("@mui/material/styles");
+const reactHookForm = require("react-hook-form");
+const formField_sx = require("../../formField.sx-BAX7KwMR.cjs");
+const resolvePreset = require("../../resolvePreset-CT3kU-K2.cjs");
+const CheckIcon = require("@mui/icons-material/Check");
+const buildSelectSx = (borderRadius, labelPosition) => formField_sx.buildFormFieldSx({ borderRadius, labelPosition });
+const groupOptions = (options) => {
+  const groups = {};
+  options.forEach((opt) => {
+    const group = opt.group || "__default";
+    if (!groups[group]) groups[group] = [];
+    groups[group].push(opt);
+  });
+  return groups;
+};
+const normalizeSelectValue = (value) => value != null ? value : "";
+const isSelectValueEmpty = (normalizedValue) => {
+  if (Array.isArray(normalizedValue)) return normalizedValue.length === 0;
+  return normalizedValue === "" || normalizedValue === null || normalizedValue === void 0;
+};
+const renderSelectMenuItem = ({
+  option,
+  selected,
+  customRender
+}) => /* @__PURE__ */ jsxRuntime.jsxs(
+  material.MenuItem,
+  {
+    value: option.value,
+    disabled: option.disabled,
+    selected,
+    children: [
+      /* @__PURE__ */ jsxRuntime.jsx(material.ListItemIcon, { sx: { minWidth: 32 }, children: selected && /* @__PURE__ */ jsxRuntime.jsx(CheckIcon, { color: "success", fontSize: "small" }) }),
+      customRender ? customRender(option) : option.label
+    ]
+  },
+  String(option.value)
+);
+function Option(_props) {
+  return null;
+}
+Option.displayName = "Option";
+function Select(props) {
+  const _a = props, {
+    label,
+    options = [],
+    defaultValue,
+    size = "small",
+    placeholder,
+    children,
+    maxHeight = 300,
+    maxWidth,
+    disabled = false,
+    error = false,
+    helperText,
+    borderRadius = 10,
+    labelPosition = "outside",
+    preset,
+    sx,
+    className,
+    multiple = false,
+    maxChipsToShow = 3,
+    renderChipLabel,
+    chipVariant = "outlined",
+    name: _nameIgnored,
+    control: _controlIgnored,
+    validation: _validationIgnored,
+    value: _valueIgnored,
+    onChange: _onChangeIgnored,
+    onValueChange: _onValueChangeIgnored
+  } = _a, rest = __objRest(_a, [
+    "label",
+    "options",
+    "defaultValue",
+    "size",
+    "placeholder",
+    "children",
+    "maxHeight",
+    "maxWidth",
+    "disabled",
+    "error",
+    "helperText",
+    "borderRadius",
+    "labelPosition",
+    "preset",
+    "sx",
+    "className",
+    "multiple",
+    "maxChipsToShow",
+    "renderChipLabel",
+    "chipVariant",
+    // Separamos estos aunque no se usen directamente acá — evita que lleguen
+    // al DOM del MuiSelect via `{...rest}` y generen warnings de React.
+    "name",
+    "control",
+    "validation",
+    "value",
+    "onChange",
+    "onValueChange"
+  ]);
+  const theme = styles.useTheme();
+  const presetSx = resolvePreset.resolvePreset("Select", preset, theme);
+  const isRHFMode = "control" in props && props.control !== void 0;
+  const customRender = React.useMemo(() => {
+    var _a2;
+    if (React.Children.count(children) === 1) {
+      const child = React.Children.only(children);
+      if (React.isValidElement(child) && ((_a2 = child.type) == null ? void 0 : _a2.displayName) === "Option") {
+        return child.props.children;
+      }
+    }
+    return null;
+  }, [children]);
+  const [isOpen, setIsOpen] = React.useState(false);
+  const [isFocused, setIsFocused] = React.useState(false);
+  const groupedOptions = React.useMemo(() => groupOptions(options), [options]);
+  const isSelected = (currentValue, val) => {
+    if (Array.isArray(currentValue)) return currentValue.includes(val);
+    return currentValue === val;
+  };
+  const buildMenuItems = (currentValue) => {
+    const items = [];
+    Object.entries(groupedOptions).forEach(([group, opts]) => {
+      if (group !== "__default") {
+        items.push(
+          /* @__PURE__ */ jsxRuntime.jsx(material.ListSubheader, { disableSticky: true, children: group }, group)
+        );
+      }
+      opts.forEach((opt) => {
+        items.push(
+          renderSelectMenuItem({
+            option: opt,
+            selected: isSelected(currentValue, opt.value),
+            customRender
+          })
+        );
+      });
+    });
+    return items;
+  };
+  const mergedSx = [
+    buildSelectSx(borderRadius, labelPosition),
+    ...presetSx ? [presetSx] : [],
+    ...Array.isArray(sx) ? sx : sx ? [sx] : []
+  ];
+  const renderSelect = (selectValue, commitValue, onBlur, inputRef, rhfError, rhfHelperText) => {
+    const finalError = !!rhfError || !!error;
+    const finalHelperText = rhfHelperText != null ? rhfHelperText : helperText;
+    const inputElement = labelPosition === "floating" ? /* @__PURE__ */ jsxRuntime.jsx(material.OutlinedInput, { label }) : /* @__PURE__ */ jsxRuntime.jsx(material.OutlinedInput, {});
+    const normalizedValue = multiple ? selectValue != null ? selectValue : [] : normalizeSelectValue(selectValue);
+    const isEmpty = isSelectValueEmpty(normalizedValue);
+    const shouldShrink = !isEmpty || isFocused || isOpen;
+    const shouldDisplayPlaceholder = isEmpty && (isFocused || isOpen) && !!placeholder;
+    const renderValueFn = (selected) => {
+      var _a2;
+      if (multiple) {
+        const arr = selected != null ? selected : [];
+        if (arr.length === 0) {
+          return /* @__PURE__ */ jsxRuntime.jsx(material.Typography, { sx: { color: "text.disabled" }, children: placeholder != null ? placeholder : "" });
+        }
+        const visible = arr.slice(0, maxChipsToShow);
+        const hidden = arr.length - visible.length;
+        return /* @__PURE__ */ jsxRuntime.jsxs(material.Box, { sx: { display: "flex", flexWrap: "wrap", gap: 0.5 }, children: [
+          visible.map((val) => {
+            const item2 = options.find((o) => o.value === val);
+            if (!item2) return null;
+            return /* @__PURE__ */ jsxRuntime.jsx(
+              material.Chip,
+              {
+                variant: chipVariant,
+                color: "primary",
+                size,
+                label: renderChipLabel ? renderChipLabel(item2) : item2.label,
+                avatar: item2.img ? /* @__PURE__ */ jsxRuntime.jsx(material.Avatar, { src: item2.img }) : void 0,
+                onMouseDown: (e) => e.stopPropagation(),
+                onDelete: () => {
+                  commitValue(arr.filter((v) => v !== val));
+                }
+              },
+              String(val)
+            );
+          }),
+          hidden > 0 && /* @__PURE__ */ jsxRuntime.jsx(
+            material.Chip,
+            {
+              variant: chipVariant,
+              size,
+              label: `+${hidden} más`,
+              onMouseDown: (e) => e.stopPropagation()
+            }
+          )
+        ] });
+      }
+      if (isSelectValueEmpty(selected)) {
+        return /* @__PURE__ */ jsxRuntime.jsx(material.Typography, { sx: { color: "text.disabled" }, children: placeholder != null ? placeholder : "" });
+      }
+      const item = options.find((opt) => opt.value === selected);
+      return (_a2 = item == null ? void 0 : item.label) != null ? _a2 : String(selected);
+    };
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      material.FormControl,
+      {
+        fullWidth: true,
+        size,
+        error: finalError,
+        disabled,
+        className,
+        sx: mergedSx,
+        children: [
+          label && /* @__PURE__ */ jsxRuntime.jsx(material.InputLabel, { shrink: shouldShrink, children: label }),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            material.Select,
+            __spreadProps(__spreadValues({
+              multiple,
+              value: normalizedValue,
+              onChange: (e) => commitValue(e.target.value),
+              onBlur: (e) => {
+                setIsFocused(false);
+                onBlur == null ? void 0 : onBlur(e);
+              },
+              onFocus: () => setIsFocused(true),
+              onOpen: () => setIsOpen(true),
+              onClose: () => setIsOpen(false),
+              renderValue: renderValueFn,
+              displayEmpty: shouldDisplayPlaceholder,
+              input: inputElement,
+              disabled,
+              MenuProps: {
+                PaperProps: {
+                  style: { maxHeight, maxWidth }
+                }
+              },
+              inputRef
+            }, rest), {
+              children: buildMenuItems(normalizedValue)
+            })
+          ),
+          finalHelperText && /* @__PURE__ */ jsxRuntime.jsx(material.FormHelperText, { children: finalHelperText })
+        ]
+      }
+    );
+  };
+  if (isRHFMode) {
+    const { name, control, validation, onValueChange } = props;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      reactHookForm.Controller,
+      {
+        name,
+        control,
+        rules: validation,
+        defaultValue,
+        render: ({ field, fieldState: { error: fieldError } }) => {
+          var _a2;
+          return renderSelect(
+            (_a2 = field.value) != null ? _a2 : multiple ? [] : null,
+            (next) => {
+              field.onChange(next);
+              onValueChange == null ? void 0 : onValueChange(next);
+            },
+            field.onBlur,
+            field.ref,
+            !!fieldError,
+            fieldError == null ? void 0 : fieldError.message
+          );
+        }
+      }
+    );
+  }
+  const standardProps = props;
+  return renderSelect(
+    standardProps.value,
+    (next) => standardProps.onChange(next)
+  );
+}
+exports.Option = Option;
+exports.Select = Select;
+exports.default = Select;
+//# sourceMappingURL=Select.cjs.map

package/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/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 * 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 * Normaliza el valor single al shape que espera MUI Select: string vacío si\n * el valor es `null`/`undefined`.\n */\nexport const normalizeSelectValue = <T>(value: T | null | undefined): T | '' =>\n  (value ?? '') as T | '';\n\n/** `true` si el valor está vacío (para shrink del label + placeholder). En\n *  multi se considera vacío cuando el array no tiene elementos. */\nexport const isSelectValueEmpty = (normalizedValue: unknown): boolean => {\n  if (Array.isArray(normalizedValue)) return normalizedValue.length === 0;\n  return (\n    normalizedValue === '' ||\n    normalizedValue === null ||\n    normalizedValue === undefined\n  );\n};\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 {\n  Children,\n  isValidElement,\n  useMemo,\n  useState,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport {\n  Avatar,\n  Box,\n  Chip,\n  FormControl,\n  FormHelperText,\n  InputLabel,\n  ListSubheader,\n  OutlinedInput,\n  Select as MuiSelect,\n  Typography,\n  type SelectChangeEvent,\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  groupOptions,\n  isSelectValueEmpty,\n  normalizeSelectValue,\n} from './Select.helpers';\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 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  placeholder?: string;\n  children?: ReactElement<{ children: RenderOptionItem }>;\n  maxHeight?: number | string;\n  maxWidth?: number | string;\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  // ── Props que solo aplican en modo `multiple` ──────────────────────────\n  /** Cantidad máxima de chips visibles antes de colapsar al \"+N más\". Default: 3. */\n  maxChipsToShow?: number;\n  /** Custom render del label de cada chip. Si no se pasa, usa `option.label`. */\n  renderChipLabel?: RenderChipLabel;\n  /** Variant de los chips. Default: 'outlined'. */\n  chipVariant?: 'outlined' | 'filled';\n}\n\n// ── Variantes discriminadas (single / multi / RHF) ──────────────────────\nexport interface SingleStandardSelectProps<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n> extends BaseSelectProps<TValue> {\n  multiple?: false;\n  name?: string;\n  control?: never;\n  validation?: never;\n  value: TValue;\n  onChange: (val: TValue) => void;\n}\n\nexport interface MultipleStandardSelectProps<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n> extends BaseSelectProps<TValue> {\n  multiple: true;\n  name?: string;\n  control?: never;\n  validation?: never;\n  value: TValue[];\n  onChange: (val: TValue[]) => void;\n}\n\nexport type StandardSelectProps<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n> =\n  | SingleStandardSelectProps<TValue>\n  | MultipleStandardSelectProps<TValue>;\n\nexport interface RHFSelectProps<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n> extends BaseSelectProps<TValue> {\n  /** En RHF se acepta como boolean dinámico — `field.value` se trata según\n   *  esto: array si `multiple`, valor único si no. */\n  multiple?: boolean;\n  name: string;\n  // `any` plano (no `Control<any>`): RHF tipa `Control<T>` con generics en\n  // posiciones tanto contravariantes como covariantes (ej. `_subjects.state`).\n  // Cuando el componente tiene generics propios (como `TValue` acá), TS se\n  // confunde narroweando el discriminated union y `Control<any>` no logra\n  // absorber `Control<MyForm>` en la comparación estructural profunda.\n  // El `any` plano elimina ese ruido. RHF adentro sigue teniendo sus tipos\n  // fuertes — solo degradamos la superficie del prop del Select.\n  control: any;\n  validation?: RegisterOptions;\n  /**\n   * Side-effect que corre después de que RHF actualiza el form state.\n   * Útil para cascadas entre campos (ej. reset de municipio al cambiar\n   * departamento). NO reemplaza al handler de RHF.\n   */\n  onValueChange?: (value: TValue | TValue[]) => void;\n  value?: never;\n  onChange?: never;\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<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n>(props: SelectProps<TValue>) {\n  const {\n    label,\n    options = [],\n    defaultValue,\n    size = 'small',\n    placeholder,\n    children,\n    maxHeight = 300,\n    maxWidth,\n    disabled = false,\n    error = false,\n    helperText,\n    borderRadius = 10,\n    labelPosition = 'outside',\n    preset,\n    sx,\n    className,\n    multiple = false,\n    maxChipsToShow = 3,\n    renderChipLabel,\n    chipVariant = 'outlined',\n    // Separamos estos aunque no se usen directamente acá — evita que lleguen\n    // al DOM del MuiSelect via `{...rest}` y generen warnings de React.\n    name: _nameIgnored,\n    control: _controlIgnored,\n    validation: _validationIgnored,\n    value: _valueIgnored,\n    onChange: _onChangeIgnored,\n    onValueChange: _onValueChangeIgnored,\n    ...rest\n  } = props as MultipleStandardSelectProps<TValue> & {\n    name?: string;\n    control?: Control<any>;\n    validation?: RegisterOptions;\n    onValueChange?: (val: TValue | TValue[]) => void;\n  };\n\n  const theme = useTheme();\n  const presetSx = resolvePreset('Select', preset, theme);\n\n  const isRHFMode =\n    'control' in props &&\n    (props as RHFSelectProps<TValue>).control !== undefined;\n\n  // Custom render opcional vía <Option>{item => ...}</Option>\n  const customRender: RenderOptionItem | null = useMemo(() => {\n    if (Children.count(children) === 1) {\n      const child = 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  // Focus/open tracking para el comportamiento del label \"outside\".\n  const [isOpen, setIsOpen] = useState(false);\n  const [isFocused, setIsFocused] = useState(false);\n\n  const groupedOptions = useMemo(() => groupOptions(options), [options]);\n\n  // Igualdad por valor, soportando single y multi de forma uniforme.\n  const isSelected = (\n    currentValue: TValue | TValue[] | '',\n    val: TValue,\n  ): boolean => {\n    if (Array.isArray(currentValue)) return currentValue.includes(val);\n    return currentValue === val;\n  };\n\n  const buildMenuItems = (currentValue: TValue | TValue[] | '') => {\n    const items: ReactNode[] = [];\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        items.push(\n          renderSelectMenuItem({\n            option: opt,\n            selected: isSelected(currentValue, opt.value as TValue),\n            customRender,\n          }),\n        );\n      });\n    });\n    return items;\n  };\n\n  const mergedSx = [\n    buildSelectSx(borderRadius, labelPosition),\n    ...(presetSx ? [presetSx] : []),\n    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\n  ];\n\n  // Render base (común a RHF y controlled). `commitValue` recibe el valor\n  // ya resuelto (sin event) — lo usamos también para el delete de chips.\n  const renderSelect = (\n    selectValue: TValue | TValue[] | null | undefined,\n    commitValue: (next: TValue | TValue[]) => void,\n    onBlur?: (event: React.FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void,\n    inputRef?: React.Ref<HTMLInputElement>,\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    // Normalizamos según modo: array vacío para multi, '' para single.\n    const normalizedValue: TValue | TValue[] | '' = multiple\n      ? ((selectValue as TValue[] | null | undefined) ?? [])\n      : normalizeSelectValue(selectValue as TValue | null | undefined);\n\n    const isEmpty = isSelectValueEmpty(normalizedValue);\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 =\n      isEmpty && (isFocused || isOpen) && !!placeholder;\n\n    const renderValueFn = (selected: any): ReactNode => {\n      // ── Multi: render de chips con delete ────────────────────────────\n      if (multiple) {\n        const arr = (selected ?? []) as TValue[];\n        if (arr.length === 0) {\n          return (\n            <Typography sx={{ color: 'text.disabled' }}>\n              {placeholder ?? ''}\n            </Typography>\n          );\n        }\n        const visible = arr.slice(0, maxChipsToShow);\n        const hidden = arr.length - visible.length;\n        return (\n          <Box sx={{ display: 'flex', flexWrap: 'wrap', gap: 0.5 }}>\n            {visible.map((val) => {\n              const item = options.find((o) => o.value === val);\n              if (!item) return null;\n              return (\n                <Chip\n                  key={String(val)}\n                  variant={chipVariant}\n                  color=\"primary\"\n                  size={size}\n                  label={\n                    renderChipLabel ? renderChipLabel(item) : item.label\n                  }\n                  avatar={item.img ? <Avatar src={item.img} /> : undefined}\n                  // Evita que el click sobre el chip dispare el open del menú.\n                  onMouseDown={(e) => e.stopPropagation()}\n                  onDelete={() => {\n                    commitValue(arr.filter((v) => v !== val));\n                  }}\n                />\n              );\n            })}\n            {hidden > 0 && (\n              <Chip\n                variant={chipVariant}\n                size={size}\n                label={`+${hidden} más`}\n                onMouseDown={(e) => e.stopPropagation()}\n              />\n            )}\n          </Box>\n        );\n      }\n      // ── Single: igual que el flujo previo ────────────────────────────\n      if (isSelectValueEmpty(selected)) {\n        return (\n          <Typography sx={{ color: 'text.disabled' }}>\n            {placeholder ?? ''}\n          </Typography>\n        );\n      }\n      const item = options.find((opt) => opt.value === selected);\n      return item?.label ?? String(selected);\n    };\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          multiple={multiple}\n          value={normalizedValue as any}\n          onChange={(e: SelectChangeEvent<TValue | TValue[]>) =>\n            commitValue(e.target.value as TValue | TValue[])\n          }\n          onBlur={(e) => {\n            setIsFocused(false);\n            onBlur?.(e);\n          }}\n          onFocus={() => setIsFocused(true)}\n          onOpen={() => setIsOpen(true)}\n          onClose={() => setIsOpen(false)}\n          renderValue={renderValueFn}\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          {buildMenuItems(normalizedValue)}\n        </MuiSelect>\n        {finalHelperText && <FormHelperText>{finalHelperText}</FormHelperText>}\n      </FormControl>\n    );\n  };\n\n  // ── RHF mode ──────────────────────────────────────────────────────────\n  if (isRHFMode) {\n    const { name, control, validation, onValueChange } = props as RHFSelectProps<TValue>;\n    return (\n      <Controller\n        name={name}\n        control={control}\n        rules={validation}\n        defaultValue={defaultValue}\n        render={({ field, fieldState: { error: fieldError } }) =>\n          renderSelect(\n            field.value ?? (multiple ? [] : null),\n            (next) => {\n              field.onChange(next);\n              onValueChange?.(next);\n            },\n            field.onBlur,\n            field.ref,\n            !!fieldError,\n            fieldError?.message,\n          )\n        }\n      />\n    );\n  }\n\n  // ── Controlled mode ───────────────────────────────────────────────────\n  const standardProps = props as StandardSelectProps<TValue>;\n  return renderSelect(\n    standardProps.value as TValue | TValue[] | null | undefined,\n    (next) =>\n      (standardProps.onChange as (v: TValue | TValue[]) => void)(next),\n  );\n}\n\nexport default Select;\n"],"names":["buildFormFieldSx","jsxs","MenuItem","jsx","ListItemIcon","useTheme","resolvePreset","useMemo","Children","isValidElement","_a","useState","ListSubheader","OutlinedInput","Typography","Box","item","Chip","Avatar","FormControl","InputLabel","MuiSelect","FormHelperText","Controller"],"mappings":"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"}

package/components/Select/Select.d.ts

@@ -0,0 +1,95 @@
+import { ReactElement, ReactNode } from 'react';
+import { SelectProps as MuiSelectProps } from '@mui/material';
+import { RegisterOptions } from 'react-hook-form';
+export interface SelectOption {
+    value: string | number;
+    label: string;
+    img?: string;
+    disabled?: boolean;
+    group?: string;
+    [key: string]: any;
+}
+export type LabelPosition = 'outside' | 'floating';
+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?: SelectSize;
+    placeholder?: string;
+    children?: ReactElement<{
+        children: RenderOptionItem;
+    }>;
+    maxHeight?: number | string;
+    maxWidth?: number | string;
+    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;
+    /** Cantidad máxima de chips visibles antes de colapsar al "+N más". Default: 3. */
+    maxChipsToShow?: number;
+    /** Custom render del label de cada chip. Si no se pasa, usa `option.label`. */
+    renderChipLabel?: RenderChipLabel;
+    /** Variant de los chips. Default: 'outlined'. */
+    chipVariant?: 'outlined' | 'filled';
+}
+export interface SingleStandardSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseSelectProps<TValue> {
+    multiple?: false;
+    name?: string;
+    control?: never;
+    validation?: never;
+    value: TValue;
+    onChange: (val: TValue) => void;
+}
+export interface MultipleStandardSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseSelectProps<TValue> {
+    multiple: true;
+    name?: string;
+    control?: never;
+    validation?: never;
+    value: TValue[];
+    onChange: (val: TValue[]) => void;
+}
+export type StandardSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> = SingleStandardSelectProps<TValue> | MultipleStandardSelectProps<TValue>;
+export interface RHFSelectProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseSelectProps<TValue> {
+    /** En RHF se acepta como boolean dinámico — `field.value` se trata según
+     *  esto: array si `multiple`, valor único si no. */
+    multiple?: boolean;
+    name: string;
+    control: any;
+    validation?: RegisterOptions;
+    /**
+     * Side-effect que corre después de que RHF actualiza el form state.
+     * Útil para cascadas entre campos (ej. reset de municipio al cambiar
+     * departamento). NO reemplaza al handler de RHF.
+     */
+    onValueChange?: (value: TValue | TValue[]) => void;
+    value?: never;
+    onChange?: never;
+}
+export type SelectProps<TValue extends SelectOption['value'] = SelectOption['value']> = RHFSelectProps<TValue> | StandardSelectProps<TValue>;
+export declare function Option(_props: OptionProps): null;
+export declare namespace Option {
+    var displayName: string;
+}
+export declare function Select<TValue extends SelectOption['value'] = SelectOption['value']>(props: SelectProps<TValue>): import("react/jsx-runtime").JSX.Element;
+export default Select;

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

@@ -0,0 +1,15 @@
+import { SelectOption } from './Select';
+/**
+ * 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[]>;
+/**
+ * Normaliza el valor single al shape que espera MUI Select: string vacío si
+ * el valor es `null`/`undefined`.
+ */
+export declare const normalizeSelectValue: <T>(value: T | null | undefined) => T | "";
+/** `true` si el valor está vacío (para shrink del label + placeholder). En
+ *  multi se considera vacío cuando el array no tiene elementos. */
+export declare const isSelectValueEmpty: (normalizedValue: unknown) => boolean;