@soyfri/shared-library 2.0.0-beta.3 → 2.0.0-beta.31

package/components/Autocomplete/Autocomplete.cjs

@@ -1,314 +1,7 @@
 "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-CQ1mbk9M.cjs");
-const resolvePreset = require("../../resolvePreset-CT3kU-K2.cjs");
-const ClearIcon = require("@mui/icons-material/Clear");
-const buildAutocompleteSx = (borderRadius, labelPosition) => formField_sx.buildFormFieldSx({
-  borderRadius,
-  labelPosition,
-  extraOutsideSx: {
-    // El input interno del Autocomplete.
-    "& .MuiAutocomplete-input": {
-      paddingTop: "4px",
-      paddingBottom: "4px"
-    },
-    // Contenedor del input (donde viven los chips en modo multiple).
-    "& .MuiAutocomplete-inputRoot": {
-      paddingTop: "4px",
-      paddingBottom: "4px"
-    }
-  }
-});
-const resolveSingleValue = (options, value) => {
-  var _a;
-  return (_a = options.find((o) => o.value === value)) != null ? _a : null;
-};
-const resolveMultipleValue = (options, value) => {
-  if (!Array.isArray(value)) return [];
-  return options.filter((o) => value.includes(o.value));
-};
-const areResolvedValuesEqual = (prev, next, multiple) => {
-  if (multiple) {
-    if (!Array.isArray(prev) || !Array.isArray(next)) return false;
-    if (prev.length !== next.length) return false;
-    return prev.every((o, i) => {
-      var _a;
-      return o.value === ((_a = next[i]) == null ? void 0 : _a.value);
-    });
-  }
-  return (prev == null ? void 0 : prev.value) === (next == null ? void 0 : next.value);
-};
-const isResolvedValueEmpty = (resolvedValue, multiple) => {
-  if (multiple) {
-    return !Array.isArray(resolvedValue) || resolvedValue.length === 0;
-  }
-  return !resolvedValue;
-};
-const AutocompleteOption = ({
-  liProps,
-  option,
-  customRender
-}) => {
-  const _a = liProps, { key: _ignored } = _a, liRest = __objRest(_a, ["key"]);
-  return /* @__PURE__ */ jsxRuntime.jsx("li", __spreadProps(__spreadValues({}, liRest), { children: customRender ? customRender(option) : option.label }), option.value);
-};
-const AutocompleteChips = ({
-  value,
-  getTagProps,
-  size,
-  maxChipsToShow,
-  renderChipLabel
-}) => {
-  const displayed = value.slice(0, maxChipsToShow);
-  const hidden = value.length - maxChipsToShow;
-  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    displayed.map((option, index) => {
-      const tagProps = getTagProps({ index });
-      return /* @__PURE__ */ React.createElement(
-        material.Chip,
-        __spreadProps(__spreadValues({}, tagProps), {
-          key: option.value,
-          size,
-          label: renderChipLabel ? renderChipLabel(option) : option.label,
-          avatar: option.img ? /* @__PURE__ */ jsxRuntime.jsx(material.Avatar, { src: option.img }) : void 0,
-          deleteIcon: /* @__PURE__ */ jsxRuntime.jsx(ClearIcon, {})
-        })
-      );
-    }),
-    hidden > 0 && /* @__PURE__ */ jsxRuntime.jsx(material.Chip, { size, label: `+${hidden} más` })
-  ] });
-};
-const AutocompleteLoader = ({
-  text = "Cargando..."
-}) => /* @__PURE__ */ jsxRuntime.jsxs(material.Box, { sx: { display: "flex", alignItems: "center", gap: 1 }, children: [
-  /* @__PURE__ */ jsxRuntime.jsx(material.CircularProgress, { size: 16 }),
-  /* @__PURE__ */ jsxRuntime.jsx(material.Typography, { variant: "body2", children: text })
-] });
-function Autocomplete(props) {
-  const {
-    label,
-    options,
-    placeholder,
-    multiple = false,
-    disabled = false,
-    readOnly = false,
-    loading = false,
-    error: errorProp = false,
-    helperText,
-    maxChipsToShow = 3,
-    renderOptionItem,
-    renderChipLabel,
-    borderRadius = 10,
-    labelPosition = "outside",
-    size = "small",
-    noOptionsText = "No hay opciones",
-    loadingText,
-    sx,
-    className,
-    preset,
-    textFieldProps,
-    onInputChange,
-    inputValue,
-    filterOptions,
-    freeSolo,
-    open,
-    onOpen,
-    onClose
-  } = props;
-  const [isFocused, setIsFocused] = React.useState(false);
-  const seenOptionsRef = React.useRef(
-    /* @__PURE__ */ new Map()
-  );
-  for (const opt of options) {
-    seenOptionsRef.current.set(opt.value, opt);
-  }
-  const resolvePool = React.useMemo(() => {
-    const merged = new Map(seenOptionsRef.current);
-    for (const opt of options) merged.set(opt.value, opt);
-    return Array.from(merged.values());
-  }, [options]);
-  const prevResolvedRef = React.useRef(
-    multiple ? [] : null
-  );
-  const stabilizeResolved = (newVal) => {
-    if (areResolvedValuesEqual(prevResolvedRef.current, newVal, multiple)) {
-      return prevResolvedRef.current;
-    }
-    prevResolvedRef.current = newVal;
-    return newVal;
-  };
-  const theme = styles.useTheme();
-  const presetSx = resolvePreset.resolvePreset("Autocomplete", preset, theme);
-  const mergedSx = [
-    buildAutocompleteSx(borderRadius, labelPosition),
-    ...presetSx ? [presetSx] : [],
-    ...Array.isArray(sx) ? sx : sx ? [sx] : []
-  ];
-  const renderAutocomplete = (resolvedValue2, handleChange, onBlur, inputRef, rhfError, rhfHelperText) => {
-    const finalError = !!rhfError || !!errorProp;
-    const finalHelperText = rhfHelperText || helperText;
-    const isEmpty = isResolvedValueEmpty(resolvedValue2, multiple);
-    const showPlaceholder = isEmpty && isFocused && !!placeholder;
-    return /* @__PURE__ */ jsxRuntime.jsx(
-      material.Autocomplete,
-      {
-        multiple,
-        options,
-        value: resolvedValue2,
-        disabled,
-        readOnly,
-        loading,
-        className,
-        sx: mergedSx,
-        freeSolo,
-        open,
-        onOpen,
-        onClose,
-        inputValue,
-        onInputChange,
-        filterOptions,
-        getOptionLabel: (opt) => {
-          var _a;
-          return typeof opt === "string" ? opt : (_a = opt == null ? void 0 : opt.label) != null ? _a : "";
-        },
-        isOptionEqualToValue: (a, b) => (a == null ? void 0 : a.value) === (b == null ? void 0 : b.value),
-        getOptionDisabled: (opt) => !!(opt == null ? void 0 : opt.disabled),
-        onChange: handleChange,
-        onFocus: () => setIsFocused(true),
-        onBlur: () => {
-          setIsFocused(false);
-          onBlur == null ? void 0 : onBlur();
-        },
-        renderOption: (liProps, option) => /* @__PURE__ */ jsxRuntime.jsx(
-          AutocompleteOption,
-          {
-            liProps,
-            option,
-            customRender: renderOptionItem
-          }
-        ),
-        renderTags: multiple ? (value, getTagProps) => /* @__PURE__ */ jsxRuntime.jsx(
-          AutocompleteChips,
-          {
-            value,
-            getTagProps,
-            size,
-            maxChipsToShow,
-            renderChipLabel
-          }
-        ) : void 0,
-        noOptionsText,
-        loadingText: loadingText != null ? loadingText : /* @__PURE__ */ jsxRuntime.jsx(AutocompleteLoader, {}),
-        renderInput: (params) => {
-          var _a;
-          return /* @__PURE__ */ jsxRuntime.jsx(
-            material.TextField,
-            __spreadProps(__spreadValues(__spreadProps(__spreadValues({}, params), {
-              label,
-              size,
-              variant: "outlined",
-              placeholder: showPlaceholder ? placeholder : void 0,
-              error: finalError,
-              helperText: finalHelperText,
-              inputRef
-            }), textFieldProps), {
-              InputLabelProps: __spreadProps(__spreadValues(__spreadValues({}, params.InputLabelProps), textFieldProps == null ? void 0 : textFieldProps.InputLabelProps), {
-                shrink: labelPosition === "outside" ? !isEmpty || isFocused : (_a = params.InputLabelProps) == null ? void 0 : _a.shrink
-              })
-            })
-          );
-        }
-      }
-    );
-  };
-  const handleControlledChange = (_event, newValue) => {
-    var _a;
-    const onChange = props.onChange;
-    if (multiple) {
-      const values = (newValue != null ? newValue : []).map((opt) => opt.value);
-      onChange(values);
-    } else {
-      onChange((_a = newValue == null ? void 0 : newValue.value) != null ? _a : null);
-    }
-  };
-  if ("control" in props && props.control) {
-    const { name, control, validation } = props;
-    return /* @__PURE__ */ jsxRuntime.jsx(
-      reactHookForm.Controller,
-      {
-        name,
-        control,
-        rules: validation,
-        render: ({ field, fieldState: { error: fieldError } }) => {
-          const resolvedValue2 = stabilizeResolved(
-            multiple ? resolveMultipleValue(resolvePool, field.value) : resolveSingleValue(resolvePool, field.value)
-          );
-          const handleChange = (_event, newValue) => {
-            var _a;
-            if (multiple) {
-              field.onChange(
-                (newValue != null ? newValue : []).map((opt) => opt.value)
-              );
-            } else {
-              field.onChange((_a = newValue == null ? void 0 : newValue.value) != null ? _a : null);
-            }
-          };
-          return renderAutocomplete(
-            resolvedValue2,
-            handleChange,
-            field.onBlur,
-            field.ref,
-            !!fieldError,
-            fieldError == null ? void 0 : fieldError.message
-          );
-        }
-      }
-    );
-  }
-  const controlledValue = props.value;
-  const resolvedValue = stabilizeResolved(
-    multiple ? resolveMultipleValue(resolvePool, controlledValue) : resolveSingleValue(resolvePool, controlledValue)
-  );
-  return renderAutocomplete(resolvedValue, handleControlledChange);
-}
-const AutocompleteSelect = Autocomplete;
-exports.Autocomplete = Autocomplete;
-exports.AutocompleteSelect = AutocompleteSelect;
-exports.default = Autocomplete;
+const Autocomplete = require("../../Autocomplete-CejWztBY.cjs");
+exports.Autocomplete = Autocomplete.Autocomplete;
+exports.AutocompleteSelect = Autocomplete.AutocompleteSelect;
+exports.default = Autocomplete.Autocomplete;
 //# sourceMappingURL=Autocomplete.cjs.map

package/components/Autocomplete/Autocomplete.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Autocomplete.cjs","sources":["../../../src/components/Autocomplete/Autocomplete.sx.ts","../../../src/components/Autocomplete/Autocomplete.helpers.ts","../../../src/components/Autocomplete/_parts/AutocompleteOption.tsx","../../../src/components/Autocomplete/_parts/AutocompleteChips.tsx","../../../src/components/Autocomplete/_parts/AutocompleteLoader.tsx","../../../src/components/Autocomplete/Autocomplete.tsx"],"sourcesContent":["import type { SxProps, Theme } from '@mui/material/styles';\n\nimport { buildFormFieldSx } from '../_shared/formField.sx';\nimport type { LabelPosition } from './Autocomplete';\n\n/**\n * Builder del sx del Autocomplete. Reutiliza `buildFormFieldSx` y añade\n * los paddings propios del Autocomplete (chips + input interno).\n */\nexport const buildAutocompleteSx = (\n  borderRadius: number | string,\n  labelPosition: LabelPosition,\n): SxProps<Theme> =>\n  buildFormFieldSx({\n    borderRadius,\n    labelPosition,\n    extraOutsideSx: {\n      // El input interno del Autocomplete.\n      '& .MuiAutocomplete-input': {\n        paddingTop: '4px',\n        paddingBottom: '4px',\n      },\n\n      // Contenedor del input (donde viven los chips en modo multiple).\n      '& .MuiAutocomplete-inputRoot': {\n        paddingTop: '4px',\n        paddingBottom: '4px',\n      },\n    },\n  });\n","import type { SxProps, Theme } from '@mui/material/styles';\nimport type { SelectOption } from './Autocomplete';\n\n/** Resuelve un value único a su SelectOption dentro del pool. */\nexport const resolveSingleValue = (\n  options: SelectOption[],\n  value: SelectOption['value'] | null | undefined,\n): SelectOption | null => options.find((o) => o.value === value) ?? null;\n\n/** Resuelve un array de values a sus SelectOption dentro del pool. */\nexport const resolveMultipleValue = (\n  options: SelectOption[],\n  value: SelectOption['value'][] | null | undefined,\n): SelectOption[] => {\n  if (!Array.isArray(value)) return [];\n  return options.filter((o) => value.includes(o.value));\n};\n\n/** Merge de sx base + extra del consumer, respetando el contrato de MUI. */\nexport const mergeSx = (\n  base: SxProps<Theme>,\n  extra?: SxProps<Theme>,\n): SxProps<Theme> => {\n  if (!extra) return base;\n  return [base, ...(Array.isArray(extra) ? extra : [extra])] as SxProps<Theme>;\n};\n\n/**\n * Compara dos valores resueltos (single o multiple) por value para decidir\n * si son estructuralmente iguales. Se usa para estabilizar la referencia que\n * se pasa a MUI Autocomplete (MUI compara value por referencia con `!==`,\n * y una nueva referencia — aunque el contenido sea igual — dispara\n * `resetInputValue` y borra el texto mientras el usuario tipea).\n */\nexport const areResolvedValuesEqual = (\n  prev: SelectOption | SelectOption[] | null,\n  next: SelectOption | SelectOption[] | null,\n  multiple: boolean,\n): boolean => {\n  if (multiple) {\n    if (!Array.isArray(prev) || !Array.isArray(next)) return false;\n    if (prev.length !== next.length) return false;\n    return prev.every((o, i) => o.value === next[i]?.value);\n  }\n  return (\n    (prev as SelectOption | null)?.value ===\n    (next as SelectOption | null)?.value\n  );\n};\n\n/** Determina si un valor resuelto está vacío (para placeholder/shrink). */\nexport const isResolvedValueEmpty = (\n  resolvedValue: unknown,\n  multiple: boolean,\n): boolean => {\n  if (multiple) {\n    return !Array.isArray(resolvedValue) || resolvedValue.length === 0;\n  }\n  return !resolvedValue;\n};\n","import React from 'react';\nimport type { SelectOption, RenderOptionItem } from '../Autocomplete';\n\ninterface AutocompleteOptionProps {\n  liProps: React.HTMLAttributes<HTMLLIElement> & { key?: React.Key };\n  option: SelectOption;\n  customRender?: RenderOptionItem;\n}\n\n/**\n * Render por defecto de un <li> del dropdown del Autocomplete.\n * Se expone como componente para testear y extender fácilmente, pero MUI\n * lo llama desde `renderOption={(props, option) => ...}` en el padre.\n *\n * El `key` lo manejamos nosotros (no spreadeamos junto al resto) porque MUI\n * lo inyecta como parte de `propsLi` y React exige que sea prop directo.\n */\nexport const AutocompleteOption: React.FC<AutocompleteOptionProps> = ({\n  liProps,\n  option,\n  customRender,\n}) => {\n  const { key: _ignored, ...liRest } = liProps;\n  return (\n    <li key={option.value} {...liRest}>\n      {customRender ? customRender(option) : option.label}\n    </li>\n  );\n};\n\nexport default AutocompleteOption;\n","import React from 'react';\nimport { Avatar, Chip } from '@mui/material';\nimport ClearIcon from '@mui/icons-material/Clear';\n\nimport type {\n  SelectOption,\n  RenderChipLabel,\n  AutocompleteSize,\n} from '../Autocomplete';\n\ninterface AutocompleteChipsProps {\n  value: SelectOption[];\n  getTagProps: (args: { index: number }) => Record<string, any>;\n  size: AutocompleteSize;\n  maxChipsToShow: number;\n  renderChipLabel?: RenderChipLabel;\n}\n\n/**\n * Render de los chips del Autocomplete en modo multiple.\n * Trunca después de `maxChipsToShow` con un chip \"+N más\".\n * El `getTagProps({ index })` viene de MUI y contiene el handler de delete,\n * la key, etc. — se spreadea tal cual al Chip.\n */\nexport const AutocompleteChips: React.FC<AutocompleteChipsProps> = ({\n  value,\n  getTagProps,\n  size,\n  maxChipsToShow,\n  renderChipLabel,\n}) => {\n  const displayed = value.slice(0, maxChipsToShow);\n  const hidden = value.length - maxChipsToShow;\n\n  return (\n    <>\n      {displayed.map((option, index) => {\n        const tagProps = getTagProps({ index });\n        return (\n          <Chip\n            {...tagProps}\n            key={option.value}\n            size={size}\n            label={renderChipLabel ? renderChipLabel(option) : option.label}\n            avatar={option.img ? <Avatar src={option.img} /> : undefined}\n            deleteIcon={<ClearIcon />}\n          />\n        );\n      })}\n      {hidden > 0 && <Chip size={size} label={`+${hidden} más`} />}\n    </>\n  );\n};\n\nexport default AutocompleteChips;\n","import React from 'react';\nimport { Box, CircularProgress, Typography } from '@mui/material';\n\n/**\n * Loader por defecto para el `loadingText` del Autocomplete.\n * El consumer puede sobrescribirlo pasando `loadingText` al componente padre.\n */\nexport const AutocompleteLoader: React.FC<{ text?: string }> = ({\n  text = 'Cargando...',\n}) => (\n  <Box sx={{ display: 'flex', alignItems: 'center', gap: 1 }}>\n    <CircularProgress size={16} />\n    <Typography variant=\"body2\">{text}</Typography>\n  </Box>\n);\n\nexport default AutocompleteLoader;\n","import React, {\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n  type SyntheticEvent,\n} from 'react';\nimport {\n  Autocomplete as MuiAutocomplete,\n  TextField,\n  type TextFieldProps,\n} from '@mui/material';\nimport { useTheme, type SxProps, type Theme } from '@mui/material/styles';\nimport { Controller, type Control, type RegisterOptions } from 'react-hook-form';\n\nimport { buildAutocompleteSx } from './Autocomplete.sx';\nimport {\n  areResolvedValuesEqual,\n  isResolvedValueEmpty,\n  resolveMultipleValue,\n  resolveSingleValue,\n} from './Autocomplete.helpers';\nimport { resolvePreset } from '../_shared/resolvePreset';\nimport { AutocompleteOption } from './_parts/AutocompleteOption';\nimport { AutocompleteChips } from './_parts/AutocompleteChips';\nimport { AutocompleteLoader } from './_parts/AutocompleteLoader';\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 AutocompleteSize = 'small' | 'medium';\n\n// ── Render slots ─────────────────────────────────────────────────────────\nexport type RenderOptionItem = (item: SelectOption) => ReactNode;\nexport type RenderChipLabel = (item: SelectOption) => ReactNode;\n\n// ── Props base ───────────────────────────────────────────────────────────\nexport type BaseAutocompleteProps<\n  _TValue extends SelectOption['value'] = SelectOption['value'],\n> = {\n  label?: string;\n  options: SelectOption[];\n  placeholder?: string;\n  multiple?: boolean;\n  disabled?: boolean;\n  readOnly?: boolean;\n  loading?: boolean;\n  error?: boolean;\n  helperText?: string;\n  maxChipsToShow?: number;\n  renderOptionItem?: RenderOptionItem;\n  renderChipLabel?: RenderChipLabel;\n  /** Border radius del input. Default: 10. */\n  borderRadius?: number | string;\n  /** \"outside\" (default) = label arriba del input; \"floating\" = comportamiento nativo MUI. */\n  labelPosition?: LabelPosition;\n  /** Tamaño del TextField. Default: 'small'. */\n  size?: AutocompleteSize;\n  /** Texto cuando no hay coincidencias. */\n  noOptionsText?: ReactNode;\n  /** Texto cuando está cargando. */\n  loadingText?: ReactNode;\n  sx?: SxProps<Theme>;\n  className?: string;\n  /**\n   * Nombre del preset de estilo registrado en `theme.styles.Autocomplete`.\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  /** Props para el TextField subyacente. */\n  textFieldProps?: Partial<TextFieldProps>;\n\n  // ── Búsqueda asíncrona / remota ──────────────────────────────────────\n  /** Se dispara cada vez que el usuario escribe. Útil para llamadas a servicios\n   *  (debounce recomendado en el consumer). */\n  onInputChange?: (\n    event: SyntheticEvent,\n    value: string,\n    reason: 'input' | 'reset' | 'clear' | 'blur' | 'selectOption' | 'removeOption',\n  ) => void;\n  /** Valor controlado del texto de búsqueda. */\n  inputValue?: string;\n  /** Filtro custom. Para búsqueda remota pasar `(x) => x` y confiar sólo en el servicio. */\n  filterOptions?: (options: SelectOption[], state: any) => SelectOption[];\n  /** Permite valores arbitrarios (no solo de la lista). */\n  freeSolo?: boolean;\n  open?: boolean;\n  onOpen?: (event: SyntheticEvent) => void;\n  onClose?: (event: SyntheticEvent, reason: string) => void;\n};\n\n// ── Variantes discriminadas (RHF vs controlado) ──────────────────────────\nexport interface ControlledAutocompleteProps<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n> extends BaseAutocompleteProps<TValue> {\n  value: TValue | TValue[] | null;\n  onChange: (val: TValue | TValue[] | null) => void;\n  name?: string;\n  control?: never;\n  validation?: never;\n}\n\nexport interface RHFAutocompleteProps<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n> extends BaseAutocompleteProps<TValue> {\n  name: string;\n  control: Control<any>;\n  validation?: RegisterOptions;\n  value?: never;\n  onChange?: never;\n}\n\n// ── API pública final ────────────────────────────────────────────────────\nexport type AutocompleteProps<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n> = ControlledAutocompleteProps<TValue> | RHFAutocompleteProps<TValue>;\n\nexport function Autocomplete<\n  TValue extends SelectOption['value'] = SelectOption['value'],\n>(props: AutocompleteProps<TValue>) {\n  const {\n    label,\n    options,\n    placeholder,\n    multiple = false,\n    disabled = false,\n    readOnly = false,\n    loading = false,\n    error: errorProp = false,\n    helperText,\n    maxChipsToShow = 3,\n    renderOptionItem,\n    renderChipLabel,\n    borderRadius = 10,\n    labelPosition = 'outside',\n    size = 'small',\n    noOptionsText = 'No hay opciones',\n    loadingText,\n    sx,\n    className,\n    preset,\n    textFieldProps,\n    onInputChange,\n    inputValue,\n    filterOptions,\n    freeSolo,\n    open,\n    onOpen,\n    onClose,\n  } = props as BaseAutocompleteProps<TValue>;\n\n  // Focus tracking para mostrar placeholder solo cuando el label sube.\n  const [isFocused, setIsFocused] = useState(false);\n\n  // Cache interno de opciones vistas (indexado por value). Crítico para async\n  // multiple: cuando `options` cambian por un nuevo search, los items ya\n  // seleccionados no desaparecen de los chips porque los recordamos acá.\n  const seenOptionsRef = useRef<Map<SelectOption['value'], SelectOption>>(\n    new Map(),\n  );\n  for (const opt of options) {\n    seenOptionsRef.current.set(opt.value, opt);\n  }\n\n  // Pool de opciones para resolver values (merge de options + vistas).\n  const resolvePool = useMemo<SelectOption[]>(() => {\n    const merged = new Map(seenOptionsRef.current);\n    for (const opt of options) merged.set(opt.value, opt);\n    return Array.from(merged.values());\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [options]);\n\n  // Estabiliza la referencia del resolvedValue que pasamos a MUI Autocomplete.\n  // MUI compara value con `!==`: una referencia nueva con mismo contenido\n  // dispara resetInputValue() y borra el texto que el usuario está escribiendo.\n  const prevResolvedRef = useRef<SelectOption[] | SelectOption | null>(\n    multiple ? [] : null,\n  );\n\n  const stabilizeResolved = (\n    newVal: SelectOption[] | SelectOption | null,\n  ): any => {\n    if (areResolvedValuesEqual(prevResolvedRef.current, newVal, multiple)) {\n      return prevResolvedRef.current;\n    }\n    prevResolvedRef.current = newVal;\n    return newVal;\n  };\n\n  const theme = useTheme();\n  const presetSx = resolvePreset('Autocomplete', preset, theme);\n\n  const mergedSx = [\n    buildAutocompleteSx(borderRadius, labelPosition),\n    ...(presetSx ? [presetSx] : []),\n    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\n  ];\n\n  const renderAutocomplete = (\n    resolvedValue: any,\n    handleChange: (event: any, newValue: any) => void,\n    onBlur?: () => void,\n    inputRef?: React.Ref<any>,\n    rhfError?: boolean,\n    rhfHelperText?: string,\n  ) => {\n    const finalError = !!rhfError || !!errorProp;\n    const finalHelperText = rhfHelperText || helperText;\n\n    const isEmpty = isResolvedValueEmpty(resolvedValue, multiple);\n    const showPlaceholder = isEmpty && isFocused && !!placeholder;\n\n    return (\n      <MuiAutocomplete\n        multiple={multiple}\n        options={options}\n        value={resolvedValue}\n        disabled={disabled}\n        readOnly={readOnly}\n        loading={loading}\n        className={className}\n        sx={mergedSx}\n        freeSolo={freeSolo as any}\n        open={open}\n        onOpen={onOpen}\n        onClose={onClose}\n        inputValue={inputValue}\n        onInputChange={onInputChange}\n        filterOptions={filterOptions as any}\n        getOptionLabel={(opt) =>\n          typeof opt === 'string' ? opt : (opt?.label ?? '')\n        }\n        isOptionEqualToValue={(a, b) => a?.value === b?.value}\n        getOptionDisabled={(opt) => !!opt?.disabled}\n        onChange={handleChange}\n        onFocus={() => setIsFocused(true)}\n        onBlur={() => {\n          setIsFocused(false);\n          onBlur?.();\n        }}\n        renderOption={(liProps, option) => (\n          <AutocompleteOption\n            liProps={liProps as any}\n            option={option}\n            customRender={renderOptionItem}\n          />\n        )}\n        renderTags={\n          multiple\n            ? (value, getTagProps) => (\n                <AutocompleteChips\n                  value={value}\n                  getTagProps={getTagProps}\n                  size={size}\n                  maxChipsToShow={maxChipsToShow}\n                  renderChipLabel={renderChipLabel}\n                />\n              )\n            : undefined\n        }\n        noOptionsText={noOptionsText}\n        loadingText={loadingText ?? <AutocompleteLoader />}\n        renderInput={(params) => (\n          <TextField\n            {...params}\n            label={label}\n            size={size}\n            variant=\"outlined\"\n            placeholder={showPlaceholder ? placeholder : undefined}\n            error={finalError}\n            helperText={finalHelperText}\n            inputRef={inputRef}\n            {...textFieldProps}\n            InputLabelProps={{\n              ...(params.InputLabelProps as Record<string, any>),\n              ...(textFieldProps?.InputLabelProps as Record<string, any> | undefined),\n              shrink:\n                labelPosition === 'outside'\n                  ? !isEmpty || isFocused\n                  : (params.InputLabelProps as any)?.shrink,\n            }}\n          />\n        )}\n      />\n    );\n  };\n\n  const handleControlledChange = (_event: any, newValue: any) => {\n    const onChange = (props as ControlledAutocompleteProps<TValue>).onChange;\n    if (multiple) {\n      const values = (newValue ?? []).map((opt: SelectOption) => opt.value as TValue);\n      onChange(values);\n    } else {\n      onChange((newValue?.value ?? null) as TValue | null);\n    }\n  };\n\n  // --- RHF mode ---\n  if ('control' in props && props.control) {\n    const { name, control, validation } = props as RHFAutocompleteProps<TValue>;\n    return (\n      <Controller\n        name={name}\n        control={control}\n        rules={validation}\n        render={({ field, fieldState: { error: fieldError } }) => {\n          const resolvedValue = stabilizeResolved(\n            multiple\n              ? resolveMultipleValue(resolvePool, field.value)\n              : resolveSingleValue(resolvePool, field.value),\n          );\n\n          const handleChange = (_event: any, newValue: any) => {\n            if (multiple) {\n              field.onChange(\n                (newValue ?? []).map((opt: SelectOption) => opt.value),\n              );\n            } else {\n              field.onChange(newValue?.value ?? null);\n            }\n          };\n\n          return renderAutocomplete(\n            resolvedValue,\n            handleChange,\n            field.onBlur,\n            field.ref,\n            !!fieldError,\n            fieldError?.message,\n          );\n        }}\n      />\n    );\n  }\n\n  // --- Controlled mode ---\n  const controlledValue = (props as ControlledAutocompleteProps<TValue>).value;\n  const resolvedValue = stabilizeResolved(\n    multiple\n      ? resolveMultipleValue(resolvePool, controlledValue as SelectOption['value'][])\n      : resolveSingleValue(resolvePool, controlledValue as SelectOption['value']),\n  );\n\n  return renderAutocomplete(resolvedValue, handleControlledChange);\n}\n\n/**\n * @deprecated Usar `Autocomplete` en su lugar. Alias mantenido para retro-compatibilidad.\n */\nexport const AutocompleteSelect = Autocomplete;\n\nexport default Autocomplete;\n"],"names":["buildFormFieldSx","jsx","jsxs","Fragment","createElement","Chip","Avatar","Box","CircularProgress","Typography","useState","useRef","useMemo","useTheme","resolvePreset","resolvedValue","MuiAutocomplete","TextField","Controller"],"mappings":"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"}
+{"version":3,"file":"Autocomplete.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/components/Autocomplete/Autocomplete.d.ts

@@ -1,7 +1,7 @@
 import { ReactNode, SyntheticEvent } from 'react';
 import { TextFieldProps } from '@mui/material';
 import { SxProps, Theme } from '@mui/material/styles';
-import { Control, RegisterOptions } from 'react-hook-form';
+import { RegisterOptions } from 'react-hook-form';
 export interface SelectOption {
     value: string | number;
     label: string;
@@ -38,7 +38,6 @@ export type BaseAutocompleteProps<_TValue extends SelectOption['value'] = Select
     /** Texto cuando está cargando. */
     loadingText?: ReactNode;
     sx?: SxProps<Theme>;
-    className?: string;
     /**
      * Nombre del preset de estilo registrado en `theme.styles.Autocomplete`.
      * - `"default"` (o ausente) = estilo built-in del paquete.
@@ -69,15 +68,18 @@ export interface ControlledAutocompleteProps<TValue extends SelectOption['value'
 }
 export interface RHFAutocompleteProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseAutocompleteProps<TValue> {
     name: string;
-    control: Control<any>;
+    control: any;
     validation?: RegisterOptions;
+    /**
+     * Side-effect que corre después de que RHF actualiza el form state.
+     * Útil para cascadas entre campos. NO reemplaza al handler de RHF.
+     */
+    onValueChange?: (val: TValue | TValue[] | null) => void;
     value?: never;
     onChange?: never;
 }
 export type AutocompleteProps<TValue extends SelectOption['value'] = SelectOption['value']> = ControlledAutocompleteProps<TValue> | RHFAutocompleteProps<TValue>;
 export declare function Autocomplete<TValue extends SelectOption['value'] = SelectOption['value']>(props: AutocompleteProps<TValue>): import("react/jsx-runtime").JSX.Element;
-/**
- * @deprecated Usar `Autocomplete` en su lugar. Alias mantenido para retro-compatibilidad.
- */
+/** Alias de `Autocomplete`. Ambos nombres son equivalentes. */
 export declare const AutocompleteSelect: typeof Autocomplete;
 export default Autocomplete;

package/components/Autocomplete/Autocomplete.helpers.d.ts

@@ -7,11 +7,15 @@ export declare const resolveMultipleValue: (options: SelectOption[], value: Sele
 /** Merge de sx base + extra del consumer, respetando el contrato de MUI. */
 export declare const mergeSx: (base: SxProps<Theme>, extra?: SxProps<Theme>) => SxProps<Theme>;
 /**
- * Compara dos valores resueltos (single o multiple) por value para decidir
- * si son estructuralmente iguales. Se usa para estabilizar la referencia que
- * se pasa a MUI Autocomplete (MUI compara value por referencia con `!==`,
- * y una nueva referencia — aunque el contenido sea igual — dispara
+ * Compara dos valores resueltos (single o multiple) estructuralmente para
+ * decidir si se puede reusar la referencia previa. Se usa para estabilizar la
+ * referencia que se pasa a MUI Autocomplete (MUI compara value por referencia
+ * con `!==`, y una nueva referencia — aunque el contenido sea igual — dispara
  * `resetInputValue` y borra el texto mientras el usuario tipea).
+ *
+ * Comparamos todas las props del SelectOption, no solo `value`, para que un
+ * refresh de metadata (label/img/etc.) invalide la referencia estabilizada
+ * y la UI muestre los datos actualizados.
  */
 export declare const areResolvedValuesEqual: (prev: SelectOption | SelectOption[] | null, next: SelectOption | SelectOption[] | null, multiple: boolean) => boolean;
 /** Determina si un valor resuelto está vacío (para placeholder/shrink). */