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

package/components/Autocomplete/Autocomplete.js

@@ -1,314 +1,7 @@
-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;
-};
-import { jsx, jsxs, Fragment } from "react/jsx-runtime";
-import { createElement, useState, useRef, useMemo } from "react";
-import { Chip, Avatar, Box, CircularProgress, Typography, Autocomplete as Autocomplete$1, TextField } from "@mui/material";
-import { useTheme } from "@mui/material/styles";
-import { Controller } from "react-hook-form";
-import { b as buildFormFieldSx } from "../../formField.sx-DfVbMe0V.js";
-import { r as resolvePreset } from "../../resolvePreset-B-IB0ehH.js";
-import ClearIcon from "@mui/icons-material/Clear";
-const buildAutocompleteSx = (borderRadius, labelPosition) => 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__ */ 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__ */ jsxs(Fragment, { children: [
-    displayed.map((option, index) => {
-      const tagProps = getTagProps({ index });
-      return /* @__PURE__ */ createElement(
-        Chip,
-        __spreadProps(__spreadValues({}, tagProps), {
-          key: option.value,
-          size,
-          label: renderChipLabel ? renderChipLabel(option) : option.label,
-          avatar: option.img ? /* @__PURE__ */ jsx(Avatar, { src: option.img }) : void 0,
-          deleteIcon: /* @__PURE__ */ jsx(ClearIcon, {})
-        })
-      );
-    }),
-    hidden > 0 && /* @__PURE__ */ jsx(Chip, { size, label: `+${hidden} más` })
-  ] });
-};
-const AutocompleteLoader = ({
-  text = "Cargando..."
-}) => /* @__PURE__ */ jsxs(Box, { sx: { display: "flex", alignItems: "center", gap: 1 }, children: [
-  /* @__PURE__ */ jsx(CircularProgress, { size: 16 }),
-  /* @__PURE__ */ jsx(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] = useState(false);
-  const seenOptionsRef = useRef(
-    /* @__PURE__ */ new Map()
-  );
-  for (const opt of options) {
-    seenOptionsRef.current.set(opt.value, opt);
-  }
-  const resolvePool = 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 = useRef(
-    multiple ? [] : null
-  );
-  const stabilizeResolved = (newVal) => {
-    if (areResolvedValuesEqual(prevResolvedRef.current, newVal, multiple)) {
-      return prevResolvedRef.current;
-    }
-    prevResolvedRef.current = newVal;
-    return newVal;
-  };
-  const theme = useTheme();
-  const presetSx = 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__ */ jsx(
-      Autocomplete$1,
-      {
-        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__ */ jsx(
-          AutocompleteOption,
-          {
-            liProps,
-            option,
-            customRender: renderOptionItem
-          }
-        ),
-        renderTags: multiple ? (value, getTagProps) => /* @__PURE__ */ jsx(
-          AutocompleteChips,
-          {
-            value,
-            getTagProps,
-            size,
-            maxChipsToShow,
-            renderChipLabel
-          }
-        ) : void 0,
-        noOptionsText,
-        loadingText: loadingText != null ? loadingText : /* @__PURE__ */ jsx(AutocompleteLoader, {}),
-        renderInput: (params) => {
-          var _a;
-          return /* @__PURE__ */ jsx(
-            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__ */ jsx(
-      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;
+import { A, a, A as A2 } from "../../Autocomplete-C_lW1VER.js";
 export {
-  Autocomplete,
-  AutocompleteSelect,
-  Autocomplete as default
+  A as Autocomplete,
+  a as AutocompleteSelect,
+  A2 as default
 };
 //# sourceMappingURL=Autocomplete.js.map

package/components/Autocomplete/Autocomplete.js.map

@@ -1 +1 @@
-{"version":3,"file":"Autocomplete.js","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":["resolvedValue","MuiAutocomplete"],"mappings":"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"}
+{"version":3,"file":"Autocomplete.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/components/Autocomplete/_parts/AutocompleteOption.d.ts

@@ -1,19 +1,16 @@
 import { default as React } from 'react';
 import { SelectOption, RenderOptionItem } from '../Autocomplete';
 interface AutocompleteOptionProps {
-    liProps: React.HTMLAttributes<HTMLLIElement> & {
-        key?: React.Key;
-    };
+    liProps: React.HTMLAttributes<HTMLLIElement>;
     option: SelectOption;
     customRender?: RenderOptionItem;
 }
 /**
- * Render por defecto de un <li> del dropdown del Autocomplete.
- * Se expone como componente para testear y extender fácilmente, pero MUI
- * lo llama desde `renderOption={(props, option) => ...}` en el padre.
+ * Render por defecto de un `<li>` del dropdown del Autocomplete.
+ * MUI lo invoca desde `renderOption={(props, option) => ...}` en el padre.
  *
- * El `key` lo manejamos nosotros (no spreadeamos junto al resto) porque MUI
- * lo inyecta como parte de `propsLi` y React exige que sea prop directo.
+ * La `key` la maneja el padre (`renderOption` en Autocomplete.tsx). Este
+ * componente solo recibe los props restantes del `<li>` para spread.
  */
 export declare const AutocompleteOption: React.FC<AutocompleteOptionProps>;
 export default AutocompleteOption;

package/components/Autocomplete/index.d.ts

@@ -1,2 +1,2 @@
 export { Autocomplete, AutocompleteSelect, default } from './Autocomplete';
-export type { AutocompleteProps, SelectOption, BaseAutocompleteProps, ControlledAutocompleteProps, RHFAutocompleteProps, RenderOptionItem, RenderChipLabel, LabelPosition, AutocompleteSize, } from './Autocomplete.types';
+export type { AutocompleteProps, SelectOption, BaseAutocompleteProps, ControlledAutocompleteProps, RHFAutocompleteProps, RenderOptionItem, RenderChipLabel, LabelPosition, AutocompleteSize, } from './Autocomplete';

package/components/Avatar/Avatar.cjs

@@ -1,163 +1,5 @@
 "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));
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const jsxRuntime = require("react/jsx-runtime");
-const React = require("react");
-const material = require("@mui/material");
-const AccountCircleIcon = require("@mui/icons-material/AccountCircle");
-const sizeMap = {
-  sm: { px: 32, border: 2, font: 14, overlap: 8 },
-  md: { px: 40, border: 2, font: 16, overlap: 10 },
-  lg: { px: 56, border: 3, font: 22, overlap: 14 },
-  xl: { px: 96, border: 4, font: 36, overlap: 20 }
-};
-const resolveSize = (size) => {
-  if (typeof size === "number") {
-    return {
-      px: size,
-      border: Math.max(2, Math.round(size * 0.05)),
-      font: Math.round(size * 0.4),
-      overlap: Math.round(size * 0.25)
-    };
-  }
-  return sizeMap[size];
-};
-const mergeSx = (base, extra) => {
-  if (!extra) return base;
-  const baseArr = Array.isArray(base) ? base : [base];
-  const extraArr = Array.isArray(extra) ? extra : [extra];
-  return [...baseArr, ...extraArr];
-};
-const Avatar = ({
-  items,
-  type,
-  displayedAvatars = 4,
-  size = "sm",
-  showText = true,
-  showTooltip = false,
-  sx,
-  avatarSx,
-  className,
-  overlap
-}) => {
-  var _a;
-  const [errorIndex, setErrorIndex] = React.useState(/* @__PURE__ */ new Set());
-  const handleImageError = (index) => {
-    setErrorIndex((prev) => {
-      const next = new Set(prev);
-      next.add(index);
-      return next;
-    });
-  };
-  if (!items || items.length === 0) {
-    return null;
-  }
-  const s = resolveSize(size);
-  const effectiveOverlap = overlap != null ? overlap : s.overlap;
-  const visibleItems = items.slice(0, displayedAvatars);
-  const baseAvatarSx = {
-    width: s.px,
-    height: s.px,
-    fontSize: s.font,
-    fontWeight: 700,
-    border: (theme) => `${s.border}px solid ${theme.palette.background.paper}`,
-    boxSizing: "content-box"
-  };
-  const renderSingleAvatar = (item, i) => {
-    var _a2, _b;
-    const hasImage = !!item.imageUrl && !errorIndex.has(i);
-    const showBadgeFallback = !!item.badge;
-    const itemSx = __spreadProps(__spreadValues({
-      bgcolor: (_a2 = item.backgroundColor) != null ? _a2 : "action.selected",
-      color: (_b = item.color) != null ? _b : "text.secondary"
-    }, i > 0 && { marginLeft: `-${effectiveOverlap}px` }), {
-      zIndex: visibleItems.length - i
-    });
-    const finalSx = mergeSx(mergeSx(baseAvatarSx, itemSx), avatarSx);
-    const avatarEl = /* @__PURE__ */ jsxRuntime.jsx(
-      material.Avatar,
-      {
-        "data-testid": "avatar",
-        alt: item.text || "User avatar",
-        src: hasImage ? item.imageUrl : void 0,
-        imgProps: {
-          "data-testid": "image",
-          onError: () => handleImageError(i)
-        },
-        sx: finalSx,
-        children: !hasImage && showBadgeFallback ? /* @__PURE__ */ jsxRuntime.jsx("span", { "data-testid": "badge", "aria-label": item.text, children: item.badge }) : !hasImage ? /* @__PURE__ */ jsxRuntime.jsx(
-          AccountCircleIcon,
-          {
-            "data-testid": "icon",
-            "aria-label": item.text,
-            sx: { width: "100%", height: "100%" }
-          }
-        ) : null
-      }
-    );
-    if (showTooltip && item.text) {
-      return /* @__PURE__ */ jsxRuntime.jsx(material.Tooltip, { title: item.text, children: avatarEl }, i);
-    }
-    return /* @__PURE__ */ jsxRuntime.jsx(React.Fragment, { children: avatarEl }, i);
-  };
-  return /* @__PURE__ */ jsxRuntime.jsxs(
-    material.Box,
-    {
-      "data-testid": "avatar-container",
-      className,
-      sx: mergeSx(
-        {
-          display: "flex",
-          alignItems: "center",
-          lineHeight: 1,
-          width: "fit-content"
-        },
-        sx
-      ),
-      children: [
-        /* @__PURE__ */ jsxRuntime.jsx(material.Box, { sx: { display: "flex", alignItems: "center" }, children: visibleItems.map((item, i) => renderSingleAvatar(item, i)) }),
-        showText && ((_a = items[0]) == null ? void 0 : _a.text) && /* @__PURE__ */ jsxRuntime.jsxs(
-          material.Typography,
-          {
-            "data-testid": "text",
-            variant: "caption",
-            sx: {
-              ml: 1,
-              fontSize: "0.75rem",
-              fontWeight: 400,
-              color: "text.primary"
-            },
-            children: [
-              type && items.length === 1 && /* @__PURE__ */ jsxRuntime.jsxs(material.Box, { component: "span", "data-testid": "type", sx: { mr: 0.5 }, children: [
-                type,
-                ":"
-              ] }),
-              items[0].text,
-              items.length > 1 && ` +${items.length - 1}`
-            ]
-          }
-        )
-      ]
-    }
-  );
-};
-exports.Avatar = Avatar;
+const Avatar = require("../../Avatar-Dw5rzayR.cjs");
+exports.Avatar = Avatar.Avatar;
 //# sourceMappingURL=Avatar.cjs.map

package/components/Avatar/Avatar.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.cjs","sources":["../../../src/components/Avatar/Avatar.tsx"],"sourcesContent":["import React, { useState } from 'react';\nimport {\n  Avatar as MuiAvatar,\n  Box,\n  Tooltip,\n  Typography,\n  type SxProps,\n  type Theme,\n} from '@mui/material';\nimport AccountCircleIcon from '@mui/icons-material/AccountCircle';\n\nexport interface AvatarItem {\n  text?: string;\n  imageUrl?: string;\n  badge?: string;\n  color?: string;\n  backgroundColor?: string;\n}\n\nexport type AvatarSize = 'sm' | 'md' | 'lg' | 'xl' | number;\n\nexport interface AvatarProps {\n  type?: string;\n  items: AvatarItem[];\n  displayedAvatars?: number;\n  size?: AvatarSize;\n  showText?: boolean;\n  showTooltip?: boolean;\n  /**\n   * sx aplicado al contenedor raíz.\n   */\n  sx?: SxProps<Theme>;\n  /**\n   * sx aplicado a cada MuiAvatar individual (se mergea sobre los defaults).\n   */\n  avatarSx?: SxProps<Theme>;\n  className?: string;\n  /**\n   * Overlap (px) entre avatares cuando hay varios. Default depende del tamaño.\n   */\n  overlap?: number;\n}\n\n// Escala alineada con la escala de MUI (sm=32, md=40, lg=56, xl=96) con borde\n// proporcional para el efecto stacked.\nconst sizeMap: Record<\n  Exclude<AvatarSize, number>,\n  { px: number; border: number; font: number; overlap: number }\n> = {\n  sm: { px: 32, border: 2, font: 14, overlap: 8 },\n  md: { px: 40, border: 2, font: 16, overlap: 10 },\n  lg: { px: 56, border: 3, font: 22, overlap: 14 },\n  xl: { px: 96, border: 4, font: 36, overlap: 20 },\n};\n\nconst resolveSize = (size: AvatarSize) => {\n  if (typeof size === 'number') {\n    return {\n      px: size,\n      border: Math.max(2, Math.round(size * 0.05)),\n      font: Math.round(size * 0.4),\n      overlap: Math.round(size * 0.25),\n    };\n  }\n  return sizeMap[size];\n};\n\nconst mergeSx = (base: SxProps<Theme>, extra?: SxProps<Theme>): SxProps<Theme> => {\n  if (!extra) return base;\n  const baseArr = Array.isArray(base) ? base : [base];\n  const extraArr = Array.isArray(extra) ? extra : [extra];\n  return [...baseArr, ...extraArr] as SxProps<Theme>;\n};\n\nexport const Avatar: React.FC<AvatarProps> = ({\n  items,\n  type,\n  displayedAvatars = 4,\n  size = 'sm',\n  showText = true,\n  showTooltip = false,\n  sx,\n  avatarSx,\n  className,\n  overlap,\n}) => {\n  const [errorIndex, setErrorIndex] = useState<Set<number>>(new Set());\n\n  const handleImageError = (index: number) => {\n    setErrorIndex((prev) => {\n      const next = new Set(prev);\n      next.add(index);\n      return next;\n    });\n  };\n\n  if (!items || items.length === 0) {\n    return null;\n  }\n\n  const s = resolveSize(size);\n  const effectiveOverlap = overlap ?? s.overlap;\n  const visibleItems = items.slice(0, displayedAvatars);\n\n  const baseAvatarSx: SxProps<Theme> = {\n    width: s.px,\n    height: s.px,\n    fontSize: s.font,\n    fontWeight: 700,\n    border: (theme) => `${s.border}px solid ${theme.palette.background.paper}`,\n    boxSizing: 'content-box',\n  };\n\n  const renderSingleAvatar = (item: AvatarItem, i: number) => {\n    const hasImage = !!item.imageUrl && !errorIndex.has(i);\n    const showBadgeFallback = !!item.badge;\n\n    // Defaults tirando al theme; item.color / item.backgroundColor tienen prioridad.\n    const itemSx: SxProps<Theme> = {\n      bgcolor: item.backgroundColor ?? 'action.selected',\n      color: item.color ?? 'text.secondary',\n      // Stacking manual: margen negativo al segundo avatar en adelante.\n      ...(i > 0 && { marginLeft: `-${effectiveOverlap}px` }),\n      zIndex: visibleItems.length - i,\n    };\n\n    const finalSx = mergeSx(mergeSx(baseAvatarSx, itemSx), avatarSx);\n\n    const avatarEl = (\n      <MuiAvatar\n        data-testid=\"avatar\"\n        alt={item.text || 'User avatar'}\n        src={hasImage ? item.imageUrl : undefined}\n        imgProps={{\n          'data-testid': 'image',\n          onError: () => handleImageError(i),\n        } as React.ImgHTMLAttributes<HTMLImageElement>}\n        sx={finalSx}\n      >\n        {!hasImage && showBadgeFallback ? (\n          <span data-testid=\"badge\" aria-label={item.text}>\n            {item.badge}\n          </span>\n        ) : !hasImage ? (\n          <AccountCircleIcon\n            data-testid=\"icon\"\n            aria-label={item.text}\n            sx={{ width: '100%', height: '100%' }}\n          />\n        ) : null}\n      </MuiAvatar>\n    );\n\n    if (showTooltip && item.text) {\n      return (\n        <Tooltip key={i} title={item.text}>\n          {avatarEl}\n        </Tooltip>\n      );\n    }\n    return <React.Fragment key={i}>{avatarEl}</React.Fragment>;\n  };\n\n  return (\n    <Box\n      data-testid=\"avatar-container\"\n      className={className}\n      sx={mergeSx(\n        {\n          display: 'flex',\n          alignItems: 'center',\n          lineHeight: 1,\n          width: 'fit-content',\n        },\n        sx,\n      )}\n    >\n      <Box sx={{ display: 'flex', alignItems: 'center' }}>\n        {visibleItems.map((item, i) => renderSingleAvatar(item, i))}\n      </Box>\n\n      {showText && items[0]?.text && (\n        <Typography\n          data-testid=\"text\"\n          variant=\"caption\"\n          sx={{\n            ml: 1,\n            fontSize: '0.75rem',\n            fontWeight: 400,\n            color: 'text.primary',\n          }}\n        >\n          {type && items.length === 1 && (\n            <Box component=\"span\" data-testid=\"type\" sx={{ mr: 0.5 }}>\n              {type}:\n            </Box>\n          )}\n          {items[0].text}\n          {items.length > 1 && ` +${items.length - 1}`}\n        </Typography>\n      )}\n    </Box>\n  );\n};\n\nexport default Avatar;\n"],"names":["useState","_a","jsx","MuiAvatar","Tooltip","jsxs","Box","Typography"],"mappings":"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"}
+{"version":3,"file":"Avatar.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/components/Avatar/Avatar.d.ts

@@ -6,11 +6,26 @@ export interface AvatarItem {
     badge?: string;
     color?: string;
     backgroundColor?: string;
+    /** Contenido a renderizar como fallback cuando no hay imagen (ej. iniciales). */
+    content?: React.ReactNode;
 }
 export type AvatarSize = 'sm' | 'md' | 'lg' | 'xl' | number;
 export interface AvatarProps {
     type?: string;
-    items: AvatarItem[];
+    /**
+     * Lista de avatares (grupo apilado). Para un solo avatar puedes usar
+     * `src`/`alt` en su lugar.
+     */
+    items?: AvatarItem[];
+    /**
+     * Atajo para un único avatar por URL de imagen. Equivale a
+     * `items={[{ imageUrl: src, text: alt }]}`. Ignorado si `items` tiene elementos.
+     */
+    src?: string;
+    /** Texto alternativo de la imagen cuando se usa `src` (modo single). */
+    alt?: string;
+    /** Fallback (ej. iniciales) cuando no hay imagen, en modo single (`src`). */
+    fallback?: React.ReactNode;
     displayedAvatars?: number;
     size?: AvatarSize;
     showText?: boolean;