@soyfri/shared-library 4.0.1 → 4.0.4

package/components/Autocomplete/Autocomplete.d.ts

@@ -2,8 +2,10 @@ import { ReactNode, SyntheticEvent } from 'react';
 import { TextFieldProps } from '@mui/material';
 import { SxProps, Theme } from '@mui/material/styles';
 import { RegisterOptions } from 'react-hook-form';
-export interface SelectOption {
-    value: string | number;
+/** Key estable usada para comparar values, indexar caches y como React key. */
+export type AutocompleteValueKey = string | number;
+export interface SelectOption<TValue = AutocompleteValueKey> {
+    value: TValue;
     label: string;
     img?: string;
     disabled?: boolean;
@@ -12,11 +14,12 @@ export interface SelectOption {
 }
 export type LabelPosition = 'outside' | 'floating';
 export type AutocompleteSize = 'small' | 'medium';
-export type RenderOptionItem = (item: SelectOption) => ReactNode;
-export type RenderChipLabel = (item: SelectOption) => ReactNode;
-export type BaseAutocompleteProps<_TValue extends SelectOption['value'] = SelectOption['value']> = {
+export type RenderOptionItem<TValue = AutocompleteValueKey> = (item: SelectOption<TValue>) => ReactNode;
+export type RenderChipLabel<TValue = AutocompleteValueKey> = (item: SelectOption<TValue>) => ReactNode;
+export type RenderSingleValue<TValue = AutocompleteValueKey> = (item: SelectOption<TValue>) => ReactNode;
+export type BaseAutocompleteProps<TValue = AutocompleteValueKey> = {
     label?: string;
-    options: SelectOption[];
+    options: SelectOption<TValue>[];
     placeholder?: string;
     multiple?: boolean;
     disabled?: boolean;
@@ -25,8 +28,22 @@ export type BaseAutocompleteProps<_TValue extends SelectOption['value'] = Select
     error?: boolean;
     helperText?: string;
     maxChipsToShow?: number;
-    renderOptionItem?: RenderOptionItem;
-    renderChipLabel?: RenderChipLabel;
+    renderOptionItem?: RenderOptionItem<TValue>;
+    renderChipLabel?: RenderChipLabel<TValue>;
+    /**
+     * Renderiza JSX custom como `startAdornment` del input en single mode.
+     * Recibe la `SelectOption` seleccionada. Útil para mostrar avatars, iconos,
+     * etc. junto al texto del label. En `multiple` no aplica (se usa `renderChipLabel`).
+     */
+    renderSingleValue?: RenderSingleValue<TValue>;
+    /**
+     * Extrae una key estable (string | number) desde el `value`. Obligatorio
+     * cuando `TValue` es un objeto: se usa para comparar values (`isOptionEqualToValue`,
+     * resolución desde el value del form), indexar el cache interno de opciones
+     * vistas y como React key en chips/options del dropdown. Para primitivos se
+     * puede omitir (default: identidad, o sea `===`).
+     */
+    getOptionKey?: (value: TValue) => AutocompleteValueKey;
     /** Border radius del input. Default: 10. */
     borderRadius?: number | string;
     /** "outside" (default) = label arriba del input; "floating" = comportamiento nativo MUI. */
@@ -52,21 +69,21 @@ export type BaseAutocompleteProps<_TValue extends SelectOption['value'] = Select
     /** Valor controlado del texto de búsqueda. */
     inputValue?: string;
     /** Filtro custom. Para búsqueda remota pasar `(x) => x` y confiar sólo en el servicio. */
-    filterOptions?: (options: SelectOption[], state: any) => SelectOption[];
+    filterOptions?: (options: SelectOption<TValue>[], state: any) => SelectOption<TValue>[];
     /** Permite valores arbitrarios (no solo de la lista). */
     freeSolo?: boolean;
     open?: boolean;
     onOpen?: (event: SyntheticEvent) => void;
     onClose?: (event: SyntheticEvent, reason: string) => void;
 };
-export interface ControlledAutocompleteProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseAutocompleteProps<TValue> {
+export interface ControlledAutocompleteProps<TValue = AutocompleteValueKey> extends BaseAutocompleteProps<TValue> {
     value: TValue | TValue[] | null;
     onChange: (val: TValue | TValue[] | null) => void;
     name?: string;
     control?: never;
     validation?: never;
 }
-export interface RHFAutocompleteProps<TValue extends SelectOption['value'] = SelectOption['value']> extends BaseAutocompleteProps<TValue> {
+export interface RHFAutocompleteProps<TValue = AutocompleteValueKey> extends BaseAutocompleteProps<TValue> {
     name: string;
     control: any;
     validation?: RegisterOptions;
@@ -78,8 +95,8 @@ export interface RHFAutocompleteProps<TValue extends SelectOption['value'] = Sel
     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;
+export type AutocompleteProps<TValue = AutocompleteValueKey> = ControlledAutocompleteProps<TValue> | RHFAutocompleteProps<TValue>;
+export declare function Autocomplete<TValue = AutocompleteValueKey>(props: AutocompleteProps<TValue>): import("react/jsx-runtime").JSX.Element;
 /** Alias de `Autocomplete`. Ambos nombres son equivalentes. */
 export declare const AutocompleteSelect: typeof Autocomplete;
 export default Autocomplete;

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

@@ -1,9 +1,9 @@
 import { SxProps, Theme } from '@mui/material/styles';
-import { SelectOption } from './Autocomplete';
+import { AutocompleteValueKey, SelectOption } from './Autocomplete';
 /** Resuelve un value único a su SelectOption dentro del pool. */
-export declare const resolveSingleValue: (options: SelectOption[], value: SelectOption["value"] | null | undefined) => SelectOption | null;
+export declare const resolveSingleValue: <TValue>(options: SelectOption<TValue>[], value: TValue | null | undefined, getKey: (v: TValue) => AutocompleteValueKey) => SelectOption<TValue> | null;
 /** Resuelve un array de values a sus SelectOption dentro del pool. */
-export declare const resolveMultipleValue: (options: SelectOption[], value: SelectOption["value"][] | null | undefined) => SelectOption[];
+export declare const resolveMultipleValue: <TValue>(options: SelectOption<TValue>[], value: TValue[] | null | undefined, getKey: (v: TValue) => AutocompleteValueKey) => SelectOption<TValue>[];
 /** Merge de sx base + extra del consumer, respetando el contrato de MUI. */
 export declare const mergeSx: (base: SxProps<Theme>, extra?: SxProps<Theme>) => SxProps<Theme>;
 /**
@@ -17,6 +17,6 @@ export declare const mergeSx: (base: SxProps<Theme>, extra?: SxProps<Theme>) =>
  * 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;
+export declare const areResolvedValuesEqual: <TValue>(prev: SelectOption<TValue> | SelectOption<TValue>[] | null, next: SelectOption<TValue> | SelectOption<TValue>[] | null, multiple: boolean, getKey: (v: TValue) => AutocompleteValueKey) => boolean;
 /** Determina si un valor resuelto está vacío (para placeholder/shrink). */
 export declare const isResolvedValueEmpty: (resolvedValue: unknown, multiple: boolean) => boolean;

package/components/Autocomplete/Autocomplete.js

@@ -1,4 +1,4 @@
-import { A, a, A as A2 } from "../../Autocomplete-E5aSUGVK.js";
+import { A, a, A as A2 } from "../../Autocomplete-Cvf16lFk.js";
 export {
   A as Autocomplete,
   a as AutocompleteSelect,

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

@@ -1,13 +1,14 @@
-import { default as React } from 'react';
-import { SelectOption, RenderChipLabel, AutocompleteSize } from '../Autocomplete';
-interface AutocompleteChipsProps {
-    value: SelectOption[];
+import { AutocompleteValueKey, SelectOption, RenderChipLabel, AutocompleteSize } from '../Autocomplete';
+interface AutocompleteChipsProps<TValue = AutocompleteValueKey> {
+    value: SelectOption<TValue>[];
     getTagProps: (args: {
         index: number;
     }) => Record<string, any>;
     size: AutocompleteSize;
     maxChipsToShow: number;
-    renderChipLabel?: RenderChipLabel;
+    renderChipLabel?: RenderChipLabel<TValue>;
+    /** Key estable del value: React key del chip. Ver `getOptionKey`. */
+    getKey: (value: TValue) => AutocompleteValueKey;
 }
 /**
  * Render de los chips del Autocomplete en modo multiple.
@@ -15,5 +16,5 @@ interface AutocompleteChipsProps {
  * El `getTagProps({ index })` viene de MUI y contiene el handler de delete,
  * la key, etc. — se spreadea tal cual al Chip.
  */
-export declare const AutocompleteChips: React.FC<AutocompleteChipsProps>;
+export declare const AutocompleteChips: <TValue>({ value, getTagProps, size, maxChipsToShow, renderChipLabel, getKey, }: AutocompleteChipsProps<TValue>) => import("react/jsx-runtime").JSX.Element;
 export default AutocompleteChips;

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

@@ -1,9 +1,9 @@
 import { default as React } from 'react';
-import { SelectOption, RenderOptionItem } from '../Autocomplete';
-interface AutocompleteOptionProps {
+import { AutocompleteValueKey, SelectOption, RenderOptionItem } from '../Autocomplete';
+interface AutocompleteOptionProps<TValue = AutocompleteValueKey> {
     liProps: React.HTMLAttributes<HTMLLIElement>;
-    option: SelectOption;
-    customRender?: RenderOptionItem;
+    option: SelectOption<TValue>;
+    customRender?: RenderOptionItem<TValue>;
 }
 /**
  * Render por defecto de un `<li>` del dropdown del Autocomplete.
@@ -12,5 +12,5 @@ interface AutocompleteOptionProps {
  * 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 declare const AutocompleteOption: <TValue>({ liProps, option, customRender, }: AutocompleteOptionProps<TValue>) => import("react/jsx-runtime").JSX.Element;
 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';
+export type { AutocompleteProps, SelectOption, BaseAutocompleteProps, ControlledAutocompleteProps, RHFAutocompleteProps, RenderOptionItem, RenderChipLabel, RenderSingleValue, LabelPosition, AutocompleteSize, AutocompleteValueKey, } from './Autocomplete';

package/components/DatePicker/DatePicker.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const DatePicker = require("../../DatePicker-CMcQddi1.cjs");
+const DatePicker = require("../../DatePicker-mz7CYtVw.cjs");
 exports.DatePicker = DatePicker.DatePicker;
 exports.default = DatePicker.DatePicker;
 //# sourceMappingURL=DatePicker.cjs.map

package/components/DatePicker/DatePicker.js

@@ -1,4 +1,4 @@
-import { D, D as D2 } from "../../DatePicker-D__RSgs-.js";
+import { D, D as D2 } from "../../DatePicker-D5BH4v1p.js";
 export {
   D as DatePicker,
   D2 as default

package/components/DateTimePicker/DateTimePicker.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const DateTimePicker = require("../../DateTimePicker-BVJGq1A0.cjs");
+const DateTimePicker = require("../../DateTimePicker-ejQDpjgX.cjs");
 exports.DateTimePicker = DateTimePicker.DateTimePicker;
 exports.default = DateTimePicker.DateTimePicker;
 //# sourceMappingURL=DateTimePicker.cjs.map

package/components/DateTimePicker/DateTimePicker.d.ts

@@ -41,6 +41,15 @@ export interface BaseDateTimePickerProps extends Omit<MuiDateTimePickerProps, 'v
     ampm?: boolean;
     viewRenderers?: MuiDateTimePickerProps['viewRenderers'];
     timeSteps?: MuiDateTimePickerProps['timeSteps'];
+    /**
+     * Vistas a mostrar en el popover. Default: todas (year, month, day, hours, minutes).
+     * Ej: `['hours']` solo permite elegir la hora. `['hours','minutes']` oculta el calendar.
+     *
+     * Va declarado explícito (y no se hereda del `Omit<MuiDateTimePickerProps>`)
+     * porque se desestructura del `props` y se pasa a mano al picker: si sólo
+     * viviera en el tipo base caería en el `...rest` y quedaría duplicado.
+     */
+    views?: MuiDateTimePickerProps['views'];
     textFieldProps?: Record<string, any>;
     /** Passthrough completo a slotProps del MuiDateTimePicker. */
     slotProps?: MuiDateTimePickerProps['slotProps'];

package/components/DateTimePicker/DateTimePicker.js

@@ -1,4 +1,4 @@
-import { D, D as D2 } from "../../DateTimePicker-LeaE716a.js";
+import { D, D as D2 } from "../../DateTimePicker-ZCf0Wh4r.js";
 export {
   D as DateTimePicker,
   D2 as default

package/components/Input/Input.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const Input = require("../../Input-Bpjw7qwq.cjs");
+const Input = require("../../Input-hnQ7g6b7.cjs");
 exports.Input = Input.Input;
 exports.default = Input.Input;
 //# sourceMappingURL=Input.cjs.map

package/components/Input/Input.js

@@ -1,4 +1,4 @@
-import { I, I as I2 } from "../../Input-BibHlnGN.js";
+import { I, I as I2 } from "../../Input-CmvuMwXZ.js";
 export {
   I as Input,
   I2 as default

package/components/Select/Select.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const Select = require("../../Select-WpHNCHHz.cjs");
+const Select = require("../../Select-ZhFf4SBp.cjs");
 exports.Option = Select.Option;
 exports.Select = Select.Select;
 exports.default = Select.Select;

package/components/Select/Select.js

@@ -1,4 +1,4 @@
-import { O, S, S as S2 } from "../../Select-BaY3zJhq.js";
+import { O, S, S as S2 } from "../../Select-CZ0BiKVN.js";
 export {
   O as Option,
   S as Select,

package/components/StatusMessage/StatusMessage.cjs

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const StatusMessage = require("../../StatusMessage-B3nXpuRl.cjs");
-exports.StatusMessage = StatusMessage.StatusMessage;
-exports.default = StatusMessage.StatusMessage;
+const StatusMessageContext = require("../../StatusMessageContext-BMsbLKRq.cjs");
+exports.StatusMessage = StatusMessageContext.StatusMessage;
+exports.StatusMessageProvider = StatusMessageContext.StatusMessageProvider;
+exports.default = StatusMessageContext.StatusMessage;
+exports.useStatusMessageContext = StatusMessageContext.useStatusMessageContext;
 //# sourceMappingURL=StatusMessage.cjs.map

package/components/StatusMessage/StatusMessage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"StatusMessage.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"StatusMessage.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/components/StatusMessage/StatusMessage.js

@@ -1,6 +1,8 @@
-import { S, S as S2 } from "../../StatusMessage-D0WgSBx7.js";
+import { S, a, S as S2, u } from "../../StatusMessageContext-DgYiObYE.js";
 export {
   S as StatusMessage,
-  S2 as default
+  a as StatusMessageProvider,
+  S2 as default,
+  u as useStatusMessageContext
 };
 //# sourceMappingURL=StatusMessage.js.map

package/components/StatusMessage/StatusMessageContext.d.ts

@@ -0,0 +1,16 @@
+import { Dispatch, SetStateAction, ReactNode } from 'react';
+import { StatusMessageProps } from './StatusMessage';
+export type StatusMessageState = {
+    [K in 'title' | 'description' | 'messageType']: StatusMessageProps[K] | undefined;
+} & Pick<StatusMessageProps, 'displayType'>;
+interface StatusMessageContextValue {
+    state: StatusMessageState | undefined;
+    setMessage: Dispatch<SetStateAction<StatusMessageState | undefined>>;
+    cleanMessage: () => void;
+}
+export declare const useStatusMessageContext: () => StatusMessageContextValue;
+interface StatusMessageProviderProps {
+    children: ReactNode;
+}
+export declare const StatusMessageProvider: ({ children }: StatusMessageProviderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/components/StatusMessage/index.d.ts

@@ -1,2 +1,4 @@
 export { StatusMessage, default } from './StatusMessage';
 export type { StatusMessageProps } from './StatusMessage';
+export { StatusMessageProvider, useStatusMessageContext, } from './StatusMessageContext';
+export type { StatusMessageState } from './StatusMessageContext';

package/components/_shared/resolvePreset.d.ts

@@ -1,18 +1,22 @@
 import { SxProps, Theme } from '@mui/material/styles';
 import { LibraryComponentName } from '../../theme/componentStyles';
 /**
- * Nombre del preset built-in del paquete. No se registra en el theme: si un
- * componente recibe `preset="default"` (o no recibe preset), sólo aplica el
- * estilo base de fábrica.
+ * Nombre del preset que se resuelve cuando el componente no recibe `preset`.
+ * El paquete no lo registra: si el consumer no puso `theme.styles[X].default`,
+ * no hay preset y el componente queda con su estilo base de fábrica.
  */
 export declare const DEFAULT_PRESET_NAME = "default";
 /**
  * Resuelve el sx de un preset registrado en `theme.styles[componentName]`.
  *
- * - Si `presetName` es `"default"` o `undefined`, devuelve `undefined`
- *   (caller sólo aplicará el estilo base del paquete).
+ * - Si `presetName` es `undefined`, se busca la entrada `"default"` del theme.
+ *   Así el consumer registra estilos globales una vez y no pasa `preset` en
+ *   cada instancia (lo usa `sop` para el `DataRow`).
  * - Si la entrada en el theme es una función `(theme) => sx`, se ejecuta.
  * - Si la entrada no existe, devuelve `undefined` silenciosamente (no se
  *   rompe el componente — la responsabilidad de registrarlo es del consumer).
+ *
+ * El resultado es **aditivo**: el caller aplica siempre su sx built-in y mergea
+ * esto encima. Nunca es un reemplazo del estilo base.
  */
 export declare function resolvePreset(componentName: LibraryComponentName, presetName: string | undefined, theme: Theme): SxProps<Theme> | undefined;

package/hooks/ClipBoard/ClipBoard.cjs

@@ -17,37 +17,56 @@ function useClipboard(options) {
     }
     setSnackbarOpen(false);
   }, []);
-  const executeCopy = React.useCallback((text) => {
-    var _a2, _b;
-    try {
-      if (navigator.clipboard && window.isSecureContext) {
-        navigator.clipboard.writeText(text);
-      } else {
-        const textarea = document.createElement("textarea");
-        textarea.value = text;
-        document.body.appendChild(textarea);
-        textarea.select();
-        document.execCommand("copy");
-        document.body.removeChild(textarea);
-      }
-      setSnackbarMessage((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!");
-      setSnackbarSeverity((options == null ? void 0 : options.severity) || "success");
+  const mostrarSnackbar = React.useCallback(
+    (mensaje, severidad) => {
+      var _a2;
+      setSnackbarMessage(mensaje);
+      setSnackbarSeverity(severidad);
       setSnackbarPosition((options == null ? void 0 : options.position) || { vertical: "bottom", horizontal: "center" });
       setSnackbarDuration((_a2 = options == null ? void 0 : options.duration) != null ? _a2 : 3e3);
       setSnackbarOpen(true);
-    } catch (err) {
-      console.error("Error al copiar al portapapeles:", err);
-      setSnackbarMessage("Error al copiar.");
-      setSnackbarSeverity("error");
-      setSnackbarPosition((options == null ? void 0 : options.position) || { vertical: "bottom", horizontal: "center" });
-      setSnackbarDuration((_b = options == null ? void 0 : options.duration) != null ? _b : 3e3);
-      setSnackbarOpen(true);
+    },
+    [options]
+  );
+  const copiarConTextarea = React.useCallback((text) => {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.style.position = "fixed";
+    textarea.style.top = "0";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    try {
+      return document.execCommand("copy");
+    } catch (e) {
+      return false;
+    } finally {
+      document.body.removeChild(textarea);
     }
-  }, [options]);
+  }, []);
+  const executeCopy = React.useCallback(
+    async (text) => {
+      if (navigator.clipboard && window.isSecureContext) {
+        try {
+          await navigator.clipboard.writeText(text);
+          mostrarSnackbar((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!", (options == null ? void 0 : options.severity) || "success");
+          return true;
+        } catch (e) {
+        }
+      }
+      if (copiarConTextarea(text)) {
+        mostrarSnackbar((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!", (options == null ? void 0 : options.severity) || "success");
+        return true;
+      }
+      mostrarSnackbar("No se pudo copiar al portapapeles.", "error");
+      return false;
+    },
+    [copiarConTextarea, mostrarSnackbar, options]
+  );
   const copyFromRef = React.useCallback(() => {
     if (elementRef.current) {
       const textToCopy = elementRef.current.innerText || "";
-      executeCopy(textToCopy);
+      void executeCopy(textToCopy);
     }
   }, [executeCopy]);
   React.useEffect(() => {

package/hooks/ClipBoard/ClipBoard.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ClipBoard.cjs","sources":["../../../src/hooks/ClipBoard/ClipBoard.tsx"],"sourcesContent":["// useClipboard.tsx (Versión Unificada)\nimport React, { useRef, useEffect, useState, useCallback } from 'react';\nimport { Snackbar, Alert } from '@mui/material';\nimport { AlertProps } from '@mui/material/Alert';\n\n// Tipo para las opciones del Snackbar\ninterface SnackbarOptions {\n  message?: string;\n  duration?: number;\n  severity?: AlertProps['severity'];\n  position?: { vertical: 'top' | 'bottom'; horizontal: 'left' | 'center' | 'right' };\n}\n\n/**\n * Hook 'useClipboard'.\n * Proporciona funcionalidad de copiado de texto y feedback visual (Snackbar).\n * Permite dos modos de uso:\n * 1. Uso por Referencia (ref): Se adjunta a un elemento, copia su innerText al hacer clic.\n * 2. Uso por Función (copy): Recibe el texto a copiar directamente como argumento.\n *\n * @param options Opciones de configuración para el Snackbar de feedback.\n * @returns Un objeto que contiene:\n * - 'ref': Una React Ref para adjuntar a un elemento (Modo Ref).\n * - 'copy': Una función (text: string) => void para copiar texto (Modo Función).\n * - 'CopyMessage': El componente Snackbar para renderizar el feedback.\n */\nexport function useClipboard(options?: SnackbarOptions) {\n  // --- Elementos de Copiado por Referencia ---\n  const elementRef = useRef<HTMLElement>(null);\n\n  // --- Estados y Opciones del Snackbar ---\n  const [snackbarOpen, setSnackbarOpen] = useState(false);\n  const [snackbarMessage, setSnackbarMessage] = useState(options?.message || '¡Copiado al portapapeles!');\n  const [snackbarSeverity, setSnackbarSeverity] = useState<AlertProps['severity']>(options?.severity || 'success');\n  const [snackbarPosition, setSnackbarPosition] = useState<import('@mui/material').SnackbarOrigin>(options?.position || { vertical: 'bottom', horizontal: 'center' });\n  const [snackbarDuration, setSnackbarDuration] = useState(options?.duration ?? 3000);\n\n  // Función para cerrar el Snackbar\n  const handleSnackbarClose = useCallback((event?: React.SyntheticEvent | Event, reason?: string) => {\n    if (reason === 'clickaway') {\n      return;\n    }\n    setSnackbarOpen(false);\n  }, []);\n\n  /**\n   * FUNCIÓN PRINCIPAL DE COPIADO.\n   * Se usa internamente para 'ref' y se expone para 'copy(text)'.\n   * @param text El texto exacto a copiar.\n   */\n  const executeCopy = useCallback((text: string) => {\n    try {\n      if (navigator.clipboard && window.isSecureContext) {\n        // 1. API moderna\n        navigator.clipboard.writeText(text);\n      } else {\n        // 2. Fallback usando textarea\n        const textarea = document.createElement('textarea');\n        textarea.value = text;\n        document.body.appendChild(textarea);\n        textarea.select();\n        document.execCommand('copy');\n        document.body.removeChild(textarea);\n      }\n      \n      // Mostrar éxito\n      setSnackbarMessage(options?.message || '¡Copiado al portapapeles!');\n      setSnackbarSeverity(options?.severity || 'success');\n      setSnackbarPosition(options?.position || { vertical: 'bottom', horizontal: 'center' });\n      setSnackbarDuration(options?.duration ?? 3000);\n      setSnackbarOpen(true);\n\n    } catch (err) {\n      // Mostrar error\n      console.error('Error al copiar al portapapeles:', err);\n      setSnackbarMessage('Error al copiar.');\n      setSnackbarSeverity('error');\n      setSnackbarPosition(options?.position || { vertical: 'bottom', horizontal: 'center' });\n      setSnackbarDuration(options?.duration ?? 3000);\n      setSnackbarOpen(true);\n    }\n  }, [options]); \n\n  // --- Lógica del Modo Ref ---\n  const copyFromRef = useCallback(() => {\n    if (elementRef.current) {\n        const textToCopy = elementRef.current.innerText || '';\n        executeCopy(textToCopy);\n    }\n  }, [executeCopy]);\n\n  // Adjunta un event listener de clic al elemento referenciado (Modo Ref)\n  useEffect(() => {\n    const currentElement = elementRef.current;\n    if (currentElement) {\n      currentElement.style.cursor = 'pointer';\n      // Adjuntamos la función que copia el texto del ref\n      currentElement.addEventListener('click', copyFromRef);\n    }\n\n    return () => {\n      if (currentElement) {\n        currentElement.removeEventListener('click', copyFromRef);\n      }\n    };\n  }, [copyFromRef]);\n\n\n  // Componente Snackbar encapsulado. Solo se renderiza si duration es > 0.\n  const CopyMessage = () => {\n    if (snackbarDuration <= 0) return null; // No renderizar si la duración es 0\n\n    return (\n      <Snackbar\n        open={snackbarOpen}\n        autoHideDuration={snackbarDuration}\n        onClose={handleSnackbarClose}\n        anchorOrigin={snackbarPosition}\n      >\n        <Alert onClose={handleSnackbarClose} severity={snackbarSeverity} sx={{ width: '100%' }}>\n          {snackbarMessage}\n        </Alert>\n      </Snackbar>\n    );\n  };\n\n  // Retorna ambas funcionalidades para que el usuario elija\n  return { ref: elementRef, copy: executeCopy, CopyMessage };\n}\n\nexport default useClipboard;"],"names":["useRef","useState","useCallback","_a","useEffect","jsx","Snackbar","Alert"],"mappings":";;;;;AA0BO,SAAS,aAAa,SAA2B;;AAEtD,QAAM,aAAaA,MAAAA,OAAoB,IAAI;AAG3C,QAAM,CAAC,cAAc,eAAe,IAAIC,MAAAA,SAAS,KAAK;AACtD,QAAM,CAAC,iBAAiB,kBAAkB,IAAIA,MAAAA,UAAS,mCAAS,YAAW,2BAA2B;AACtG,QAAM,CAAC,kBAAkB,mBAAmB,IAAIA,MAAAA,UAAiC,mCAAS,aAAY,SAAS;AAC/G,QAAM,CAAC,kBAAkB,mBAAmB,IAAIA,MAAAA,UAAiD,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,SAAA,CAAU;AAClK,QAAM,CAAC,kBAAkB,mBAAmB,IAAIA,MAAAA,UAAS,wCAAS,aAAT,YAAqB,GAAI;AAGlF,QAAM,sBAAsBC,MAAAA,YAAY,CAAC,OAAsC,WAAoB;AACjG,QAAI,WAAW,aAAa;AAC1B;AAAA,IACF;AACA,oBAAgB,KAAK;AAAA,EACvB,GAAG,CAAA,CAAE;AAOL,QAAM,cAAcA,kBAAY,CAAC,SAAiB;;AAChD,QAAI;AACF,UAAI,UAAU,aAAa,OAAO,iBAAiB;AAEjD,kBAAU,UAAU,UAAU,IAAI;AAAA,MACpC,OAAO;AAEL,cAAM,WAAW,SAAS,cAAc,UAAU;AAClD,iBAAS,QAAQ;AACjB,iBAAS,KAAK,YAAY,QAAQ;AAClC,iBAAS,OAAA;AACT,iBAAS,YAAY,MAAM;AAC3B,iBAAS,KAAK,YAAY,QAAQ;AAAA,MACpC;AAGA,0BAAmB,mCAAS,YAAW,2BAA2B;AAClE,2BAAoB,mCAAS,aAAY,SAAS;AAClD,2BAAoB,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,UAAU;AACrF,2BAAoBC,MAAA,mCAAS,aAAT,OAAAA,MAAqB,GAAI;AAC7C,sBAAgB,IAAI;AAAA,IAEtB,SAAS,KAAK;AAEZ,cAAQ,MAAM,oCAAoC,GAAG;AACrD,yBAAmB,kBAAkB;AACrC,0BAAoB,OAAO;AAC3B,2BAAoB,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,UAAU;AACrF,2BAAoB,wCAAS,aAAT,YAAqB,GAAI;AAC7C,sBAAgB,IAAI;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AAGZ,QAAM,cAAcD,MAAAA,YAAY,MAAM;AACpC,QAAI,WAAW,SAAS;AACpB,YAAM,aAAa,WAAW,QAAQ,aAAa;AACnD,kBAAY,UAAU;AAAA,IAC1B;AAAA,EACF,GAAG,CAAC,WAAW,CAAC;AAGhBE,QAAAA,UAAU,MAAM;AACd,UAAM,iBAAiB,WAAW;AAClC,QAAI,gBAAgB;AAClB,qBAAe,MAAM,SAAS;AAE9B,qBAAe,iBAAiB,SAAS,WAAW;AAAA,IACtD;AAEA,WAAO,MAAM;AACX,UAAI,gBAAgB;AAClB,uBAAe,oBAAoB,SAAS,WAAW;AAAA,MACzD;AAAA,IACF;AAAA,EACF,GAAG,CAAC,WAAW,CAAC;AAIhB,QAAM,cAAc,MAAM;AACxB,QAAI,oBAAoB,EAAG,QAAO;AAElC,WACEC,2BAAAA;AAAAA,MAACC,SAAAA;AAAAA,MAAA;AAAA,QACC,MAAM;AAAA,QACN,kBAAkB;AAAA,QAClB,SAAS;AAAA,QACT,cAAc;AAAA,QAEd,UAAAD,2BAAAA,IAACE,SAAAA,OAAA,EAAM,SAAS,qBAAqB,UAAU,kBAAkB,IAAI,EAAE,OAAO,OAAA,GAC3E,UAAA,gBAAA,CACH;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AAGA,SAAO,EAAE,KAAK,YAAY,MAAM,aAAa,YAAA;AAC/C;;"}
+{"version":3,"file":"ClipBoard.cjs","sources":["../../../src/hooks/ClipBoard/ClipBoard.tsx"],"sourcesContent":["// useClipboard.tsx (Versión Unificada)\nimport React, { useRef, useEffect, useState, useCallback } from 'react';\nimport { Snackbar, Alert } from '@mui/material';\nimport { AlertProps } from '@mui/material/Alert';\n\n// Tipo para las opciones del Snackbar\ninterface SnackbarOptions {\n  message?: string;\n  duration?: number;\n  severity?: AlertProps['severity'];\n  position?: { vertical: 'top' | 'bottom'; horizontal: 'left' | 'center' | 'right' };\n}\n\n/**\n * Hook 'useClipboard'.\n * Proporciona funcionalidad de copiado de texto y feedback visual (Snackbar).\n * Permite dos modos de uso:\n * 1. Uso por Referencia (ref): Se adjunta a un elemento, copia su innerText al hacer clic.\n * 2. Uso por Función (copy): Recibe el texto a copiar directamente como argumento.\n *\n * @param options Opciones de configuración para el Snackbar de feedback.\n * @returns Un objeto que contiene:\n * - 'ref': Una React Ref para adjuntar a un elemento (Modo Ref).\n * - 'copy': Una función (text: string) => void para copiar texto (Modo Función).\n * - 'CopyMessage': El componente Snackbar para renderizar el feedback.\n */\nexport function useClipboard(options?: SnackbarOptions) {\n  // --- Elementos de Copiado por Referencia ---\n  const elementRef = useRef<HTMLElement>(null);\n\n  // --- Estados y Opciones del Snackbar ---\n  const [snackbarOpen, setSnackbarOpen] = useState(false);\n  const [snackbarMessage, setSnackbarMessage] = useState(options?.message || '¡Copiado al portapapeles!');\n  const [snackbarSeverity, setSnackbarSeverity] = useState<AlertProps['severity']>(options?.severity || 'success');\n  const [snackbarPosition, setSnackbarPosition] = useState<import('@mui/material').SnackbarOrigin>(options?.position || { vertical: 'bottom', horizontal: 'center' });\n  const [snackbarDuration, setSnackbarDuration] = useState(options?.duration ?? 3000);\n\n  // Función para cerrar el Snackbar\n  const handleSnackbarClose = useCallback((event?: React.SyntheticEvent | Event, reason?: string) => {\n    if (reason === 'clickaway') {\n      return;\n    }\n    setSnackbarOpen(false);\n  }, []);\n\n  /**\n   * FUNCIÓN PRINCIPAL DE COPIADO.\n   * Se usa internamente para 'ref' y se expone para 'copy(text)'.\n   * @param text El texto exacto a copiar.\n   */\n  const mostrarSnackbar = useCallback(\n    (mensaje: string, severidad: AlertProps['severity']) => {\n      setSnackbarMessage(mensaje);\n      setSnackbarSeverity(severidad);\n      setSnackbarPosition(options?.position || { vertical: 'bottom', horizontal: 'center' });\n      setSnackbarDuration(options?.duration ?? 3000);\n      setSnackbarOpen(true);\n    },\n    [options],\n  );\n\n  /** Fallback legacy. `execCommand` devuelve `false` en vez de tirar cuando falla. */\n  const copiarConTextarea = useCallback((text: string): boolean => {\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    // Fuera de la vista pero seleccionable: sin esto la página salta al final.\n    textarea.style.position = 'fixed';\n    textarea.style.top = '0';\n    textarea.style.opacity = '0';\n    document.body.appendChild(textarea);\n    textarea.select();\n    try {\n      return document.execCommand('copy');\n    } catch {\n      return false;\n    } finally {\n      document.body.removeChild(textarea);\n    }\n  }, []);\n\n  const executeCopy = useCallback(\n    async (text: string): Promise<boolean> => {\n      // `writeText` es ASÍNCRONA: llamarla sin await/catch dejaba la promesa\n      // suelta, y cuando el navegador la rechaza —documento sin foco, permiso\n      // denegado, contexto no seguro— la rejection escapaba al `window` de la\n      // app que consume la librería. El try/catch de antes sólo atrapaba\n      // errores síncronos, así que no cubría nada de eso.\n      if (navigator.clipboard && window.isSecureContext) {\n        try {\n          await navigator.clipboard.writeText(text);\n          mostrarSnackbar(options?.message || '¡Copiado al portapapeles!', options?.severity || 'success');\n          return true;\n        } catch {\n          // Puede ser sólo falta de foco: se intenta el fallback antes de rendirse.\n        }\n      }\n\n      if (copiarConTextarea(text)) {\n        mostrarSnackbar(options?.message || '¡Copiado al portapapeles!', options?.severity || 'success');\n        return true;\n      }\n\n      mostrarSnackbar('No se pudo copiar al portapapeles.', 'error');\n      return false;\n    },\n    [copiarConTextarea, mostrarSnackbar, options],\n  );\n\n  // --- Lógica del Modo Ref ---\n  const copyFromRef = useCallback(() => {\n    if (elementRef.current) {\n        const textToCopy = elementRef.current.innerText || '';\n        // `void`: el listener del DOM no puede esperar la promesa, y ésta ya\n        // maneja sus propios errores adentro.\n        void executeCopy(textToCopy);\n    }\n  }, [executeCopy]);\n\n  // Adjunta un event listener de clic al elemento referenciado (Modo Ref)\n  useEffect(() => {\n    const currentElement = elementRef.current;\n    if (currentElement) {\n      currentElement.style.cursor = 'pointer';\n      // Adjuntamos la función que copia el texto del ref\n      currentElement.addEventListener('click', copyFromRef);\n    }\n\n    return () => {\n      if (currentElement) {\n        currentElement.removeEventListener('click', copyFromRef);\n      }\n    };\n  }, [copyFromRef]);\n\n\n  // Componente Snackbar encapsulado. Solo se renderiza si duration es > 0.\n  const CopyMessage = () => {\n    if (snackbarDuration <= 0) return null; // No renderizar si la duración es 0\n\n    return (\n      <Snackbar\n        open={snackbarOpen}\n        autoHideDuration={snackbarDuration}\n        onClose={handleSnackbarClose}\n        anchorOrigin={snackbarPosition}\n      >\n        <Alert onClose={handleSnackbarClose} severity={snackbarSeverity} sx={{ width: '100%' }}>\n          {snackbarMessage}\n        </Alert>\n      </Snackbar>\n    );\n  };\n\n  // Retorna ambas funcionalidades para que el usuario elija\n  return { ref: elementRef, copy: executeCopy, CopyMessage };\n}\n\nexport default useClipboard;"],"names":["useRef","useState","useCallback","_a","useEffect","jsx","Snackbar","Alert"],"mappings":"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"}

package/hooks/ClipBoard/ClipBoard.d.ts

@@ -24,7 +24,7 @@ interface SnackbarOptions {
  */
 export declare function useClipboard(options?: SnackbarOptions): {
     ref: React.RefObject<HTMLElement | null>;
-    copy: (text: string) => void;
+    copy: (text: string) => Promise<boolean>;
     CopyMessage: () => import("react/jsx-runtime").JSX.Element | null;
 };
 export default useClipboard;

package/hooks/ClipBoard/ClipBoard.js

@@ -15,37 +15,56 @@ function useClipboard(options) {
     }
     setSnackbarOpen(false);
   }, []);
-  const executeCopy = useCallback((text) => {
-    var _a2, _b;
-    try {
-      if (navigator.clipboard && window.isSecureContext) {
-        navigator.clipboard.writeText(text);
-      } else {
-        const textarea = document.createElement("textarea");
-        textarea.value = text;
-        document.body.appendChild(textarea);
-        textarea.select();
-        document.execCommand("copy");
-        document.body.removeChild(textarea);
-      }
-      setSnackbarMessage((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!");
-      setSnackbarSeverity((options == null ? void 0 : options.severity) || "success");
+  const mostrarSnackbar = useCallback(
+    (mensaje, severidad) => {
+      var _a2;
+      setSnackbarMessage(mensaje);
+      setSnackbarSeverity(severidad);
       setSnackbarPosition((options == null ? void 0 : options.position) || { vertical: "bottom", horizontal: "center" });
       setSnackbarDuration((_a2 = options == null ? void 0 : options.duration) != null ? _a2 : 3e3);
       setSnackbarOpen(true);
-    } catch (err) {
-      console.error("Error al copiar al portapapeles:", err);
-      setSnackbarMessage("Error al copiar.");
-      setSnackbarSeverity("error");
-      setSnackbarPosition((options == null ? void 0 : options.position) || { vertical: "bottom", horizontal: "center" });
-      setSnackbarDuration((_b = options == null ? void 0 : options.duration) != null ? _b : 3e3);
-      setSnackbarOpen(true);
+    },
+    [options]
+  );
+  const copiarConTextarea = useCallback((text) => {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.style.position = "fixed";
+    textarea.style.top = "0";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    try {
+      return document.execCommand("copy");
+    } catch (e) {
+      return false;
+    } finally {
+      document.body.removeChild(textarea);
     }
-  }, [options]);
+  }, []);
+  const executeCopy = useCallback(
+    async (text) => {
+      if (navigator.clipboard && window.isSecureContext) {
+        try {
+          await navigator.clipboard.writeText(text);
+          mostrarSnackbar((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!", (options == null ? void 0 : options.severity) || "success");
+          return true;
+        } catch (e) {
+        }
+      }
+      if (copiarConTextarea(text)) {
+        mostrarSnackbar((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!", (options == null ? void 0 : options.severity) || "success");
+        return true;
+      }
+      mostrarSnackbar("No se pudo copiar al portapapeles.", "error");
+      return false;
+    },
+    [copiarConTextarea, mostrarSnackbar, options]
+  );
   const copyFromRef = useCallback(() => {
     if (elementRef.current) {
       const textToCopy = elementRef.current.innerText || "";
-      executeCopy(textToCopy);
+      void executeCopy(textToCopy);
     }
   }, [executeCopy]);
   useEffect(() => {

package/hooks/ClipBoard/ClipBoard.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClipBoard.js","sources":["../../../src/hooks/ClipBoard/ClipBoard.tsx"],"sourcesContent":["// useClipboard.tsx (Versión Unificada)\nimport React, { useRef, useEffect, useState, useCallback } from 'react';\nimport { Snackbar, Alert } from '@mui/material';\nimport { AlertProps } from '@mui/material/Alert';\n\n// Tipo para las opciones del Snackbar\ninterface SnackbarOptions {\n  message?: string;\n  duration?: number;\n  severity?: AlertProps['severity'];\n  position?: { vertical: 'top' | 'bottom'; horizontal: 'left' | 'center' | 'right' };\n}\n\n/**\n * Hook 'useClipboard'.\n * Proporciona funcionalidad de copiado de texto y feedback visual (Snackbar).\n * Permite dos modos de uso:\n * 1. Uso por Referencia (ref): Se adjunta a un elemento, copia su innerText al hacer clic.\n * 2. Uso por Función (copy): Recibe el texto a copiar directamente como argumento.\n *\n * @param options Opciones de configuración para el Snackbar de feedback.\n * @returns Un objeto que contiene:\n * - 'ref': Una React Ref para adjuntar a un elemento (Modo Ref).\n * - 'copy': Una función (text: string) => void para copiar texto (Modo Función).\n * - 'CopyMessage': El componente Snackbar para renderizar el feedback.\n */\nexport function useClipboard(options?: SnackbarOptions) {\n  // --- Elementos de Copiado por Referencia ---\n  const elementRef = useRef<HTMLElement>(null);\n\n  // --- Estados y Opciones del Snackbar ---\n  const [snackbarOpen, setSnackbarOpen] = useState(false);\n  const [snackbarMessage, setSnackbarMessage] = useState(options?.message || '¡Copiado al portapapeles!');\n  const [snackbarSeverity, setSnackbarSeverity] = useState<AlertProps['severity']>(options?.severity || 'success');\n  const [snackbarPosition, setSnackbarPosition] = useState<import('@mui/material').SnackbarOrigin>(options?.position || { vertical: 'bottom', horizontal: 'center' });\n  const [snackbarDuration, setSnackbarDuration] = useState(options?.duration ?? 3000);\n\n  // Función para cerrar el Snackbar\n  const handleSnackbarClose = useCallback((event?: React.SyntheticEvent | Event, reason?: string) => {\n    if (reason === 'clickaway') {\n      return;\n    }\n    setSnackbarOpen(false);\n  }, []);\n\n  /**\n   * FUNCIÓN PRINCIPAL DE COPIADO.\n   * Se usa internamente para 'ref' y se expone para 'copy(text)'.\n   * @param text El texto exacto a copiar.\n   */\n  const executeCopy = useCallback((text: string) => {\n    try {\n      if (navigator.clipboard && window.isSecureContext) {\n        // 1. API moderna\n        navigator.clipboard.writeText(text);\n      } else {\n        // 2. Fallback usando textarea\n        const textarea = document.createElement('textarea');\n        textarea.value = text;\n        document.body.appendChild(textarea);\n        textarea.select();\n        document.execCommand('copy');\n        document.body.removeChild(textarea);\n      }\n      \n      // Mostrar éxito\n      setSnackbarMessage(options?.message || '¡Copiado al portapapeles!');\n      setSnackbarSeverity(options?.severity || 'success');\n      setSnackbarPosition(options?.position || { vertical: 'bottom', horizontal: 'center' });\n      setSnackbarDuration(options?.duration ?? 3000);\n      setSnackbarOpen(true);\n\n    } catch (err) {\n      // Mostrar error\n      console.error('Error al copiar al portapapeles:', err);\n      setSnackbarMessage('Error al copiar.');\n      setSnackbarSeverity('error');\n      setSnackbarPosition(options?.position || { vertical: 'bottom', horizontal: 'center' });\n      setSnackbarDuration(options?.duration ?? 3000);\n      setSnackbarOpen(true);\n    }\n  }, [options]); \n\n  // --- Lógica del Modo Ref ---\n  const copyFromRef = useCallback(() => {\n    if (elementRef.current) {\n        const textToCopy = elementRef.current.innerText || '';\n        executeCopy(textToCopy);\n    }\n  }, [executeCopy]);\n\n  // Adjunta un event listener de clic al elemento referenciado (Modo Ref)\n  useEffect(() => {\n    const currentElement = elementRef.current;\n    if (currentElement) {\n      currentElement.style.cursor = 'pointer';\n      // Adjuntamos la función que copia el texto del ref\n      currentElement.addEventListener('click', copyFromRef);\n    }\n\n    return () => {\n      if (currentElement) {\n        currentElement.removeEventListener('click', copyFromRef);\n      }\n    };\n  }, [copyFromRef]);\n\n\n  // Componente Snackbar encapsulado. Solo se renderiza si duration es > 0.\n  const CopyMessage = () => {\n    if (snackbarDuration <= 0) return null; // No renderizar si la duración es 0\n\n    return (\n      <Snackbar\n        open={snackbarOpen}\n        autoHideDuration={snackbarDuration}\n        onClose={handleSnackbarClose}\n        anchorOrigin={snackbarPosition}\n      >\n        <Alert onClose={handleSnackbarClose} severity={snackbarSeverity} sx={{ width: '100%' }}>\n          {snackbarMessage}\n        </Alert>\n      </Snackbar>\n    );\n  };\n\n  // Retorna ambas funcionalidades para que el usuario elija\n  return { ref: elementRef, copy: executeCopy, CopyMessage };\n}\n\nexport default useClipboard;"],"names":["_a"],"mappings":";;;AA0BO,SAAS,aAAa,SAA2B;;AAEtD,QAAM,aAAa,OAAoB,IAAI;AAG3C,QAAM,CAAC,cAAc,eAAe,IAAI,SAAS,KAAK;AACtD,QAAM,CAAC,iBAAiB,kBAAkB,IAAI,UAAS,mCAAS,YAAW,2BAA2B;AACtG,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,UAAiC,mCAAS,aAAY,SAAS;AAC/G,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,UAAiD,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,SAAA,CAAU;AAClK,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,UAAS,wCAAS,aAAT,YAAqB,GAAI;AAGlF,QAAM,sBAAsB,YAAY,CAAC,OAAsC,WAAoB;AACjG,QAAI,WAAW,aAAa;AAC1B;AAAA,IACF;AACA,oBAAgB,KAAK;AAAA,EACvB,GAAG,CAAA,CAAE;AAOL,QAAM,cAAc,YAAY,CAAC,SAAiB;;AAChD,QAAI;AACF,UAAI,UAAU,aAAa,OAAO,iBAAiB;AAEjD,kBAAU,UAAU,UAAU,IAAI;AAAA,MACpC,OAAO;AAEL,cAAM,WAAW,SAAS,cAAc,UAAU;AAClD,iBAAS,QAAQ;AACjB,iBAAS,KAAK,YAAY,QAAQ;AAClC,iBAAS,OAAA;AACT,iBAAS,YAAY,MAAM;AAC3B,iBAAS,KAAK,YAAY,QAAQ;AAAA,MACpC;AAGA,0BAAmB,mCAAS,YAAW,2BAA2B;AAClE,2BAAoB,mCAAS,aAAY,SAAS;AAClD,2BAAoB,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,UAAU;AACrF,2BAAoBA,MAAA,mCAAS,aAAT,OAAAA,MAAqB,GAAI;AAC7C,sBAAgB,IAAI;AAAA,IAEtB,SAAS,KAAK;AAEZ,cAAQ,MAAM,oCAAoC,GAAG;AACrD,yBAAmB,kBAAkB;AACrC,0BAAoB,OAAO;AAC3B,2BAAoB,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,UAAU;AACrF,2BAAoB,wCAAS,aAAT,YAAqB,GAAI;AAC7C,sBAAgB,IAAI;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AAGZ,QAAM,cAAc,YAAY,MAAM;AACpC,QAAI,WAAW,SAAS;AACpB,YAAM,aAAa,WAAW,QAAQ,aAAa;AACnD,kBAAY,UAAU;AAAA,IAC1B;AAAA,EACF,GAAG,CAAC,WAAW,CAAC;AAGhB,YAAU,MAAM;AACd,UAAM,iBAAiB,WAAW;AAClC,QAAI,gBAAgB;AAClB,qBAAe,MAAM,SAAS;AAE9B,qBAAe,iBAAiB,SAAS,WAAW;AAAA,IACtD;AAEA,WAAO,MAAM;AACX,UAAI,gBAAgB;AAClB,uBAAe,oBAAoB,SAAS,WAAW;AAAA,MACzD;AAAA,IACF;AAAA,EACF,GAAG,CAAC,WAAW,CAAC;AAIhB,QAAM,cAAc,MAAM;AACxB,QAAI,oBAAoB,EAAG,QAAO;AAElC,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAM;AAAA,QACN,kBAAkB;AAAA,QAClB,SAAS;AAAA,QACT,cAAc;AAAA,QAEd,UAAA,oBAAC,OAAA,EAAM,SAAS,qBAAqB,UAAU,kBAAkB,IAAI,EAAE,OAAO,OAAA,GAC3E,UAAA,gBAAA,CACH;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AAGA,SAAO,EAAE,KAAK,YAAY,MAAM,aAAa,YAAA;AAC/C;"}
+{"version":3,"file":"ClipBoard.js","sources":["../../../src/hooks/ClipBoard/ClipBoard.tsx"],"sourcesContent":["// useClipboard.tsx (Versión Unificada)\nimport React, { useRef, useEffect, useState, useCallback } from 'react';\nimport { Snackbar, Alert } from '@mui/material';\nimport { AlertProps } from '@mui/material/Alert';\n\n// Tipo para las opciones del Snackbar\ninterface SnackbarOptions {\n  message?: string;\n  duration?: number;\n  severity?: AlertProps['severity'];\n  position?: { vertical: 'top' | 'bottom'; horizontal: 'left' | 'center' | 'right' };\n}\n\n/**\n * Hook 'useClipboard'.\n * Proporciona funcionalidad de copiado de texto y feedback visual (Snackbar).\n * Permite dos modos de uso:\n * 1. Uso por Referencia (ref): Se adjunta a un elemento, copia su innerText al hacer clic.\n * 2. Uso por Función (copy): Recibe el texto a copiar directamente como argumento.\n *\n * @param options Opciones de configuración para el Snackbar de feedback.\n * @returns Un objeto que contiene:\n * - 'ref': Una React Ref para adjuntar a un elemento (Modo Ref).\n * - 'copy': Una función (text: string) => void para copiar texto (Modo Función).\n * - 'CopyMessage': El componente Snackbar para renderizar el feedback.\n */\nexport function useClipboard(options?: SnackbarOptions) {\n  // --- Elementos de Copiado por Referencia ---\n  const elementRef = useRef<HTMLElement>(null);\n\n  // --- Estados y Opciones del Snackbar ---\n  const [snackbarOpen, setSnackbarOpen] = useState(false);\n  const [snackbarMessage, setSnackbarMessage] = useState(options?.message || '¡Copiado al portapapeles!');\n  const [snackbarSeverity, setSnackbarSeverity] = useState<AlertProps['severity']>(options?.severity || 'success');\n  const [snackbarPosition, setSnackbarPosition] = useState<import('@mui/material').SnackbarOrigin>(options?.position || { vertical: 'bottom', horizontal: 'center' });\n  const [snackbarDuration, setSnackbarDuration] = useState(options?.duration ?? 3000);\n\n  // Función para cerrar el Snackbar\n  const handleSnackbarClose = useCallback((event?: React.SyntheticEvent | Event, reason?: string) => {\n    if (reason === 'clickaway') {\n      return;\n    }\n    setSnackbarOpen(false);\n  }, []);\n\n  /**\n   * FUNCIÓN PRINCIPAL DE COPIADO.\n   * Se usa internamente para 'ref' y se expone para 'copy(text)'.\n   * @param text El texto exacto a copiar.\n   */\n  const mostrarSnackbar = useCallback(\n    (mensaje: string, severidad: AlertProps['severity']) => {\n      setSnackbarMessage(mensaje);\n      setSnackbarSeverity(severidad);\n      setSnackbarPosition(options?.position || { vertical: 'bottom', horizontal: 'center' });\n      setSnackbarDuration(options?.duration ?? 3000);\n      setSnackbarOpen(true);\n    },\n    [options],\n  );\n\n  /** Fallback legacy. `execCommand` devuelve `false` en vez de tirar cuando falla. */\n  const copiarConTextarea = useCallback((text: string): boolean => {\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    // Fuera de la vista pero seleccionable: sin esto la página salta al final.\n    textarea.style.position = 'fixed';\n    textarea.style.top = '0';\n    textarea.style.opacity = '0';\n    document.body.appendChild(textarea);\n    textarea.select();\n    try {\n      return document.execCommand('copy');\n    } catch {\n      return false;\n    } finally {\n      document.body.removeChild(textarea);\n    }\n  }, []);\n\n  const executeCopy = useCallback(\n    async (text: string): Promise<boolean> => {\n      // `writeText` es ASÍNCRONA: llamarla sin await/catch dejaba la promesa\n      // suelta, y cuando el navegador la rechaza —documento sin foco, permiso\n      // denegado, contexto no seguro— la rejection escapaba al `window` de la\n      // app que consume la librería. El try/catch de antes sólo atrapaba\n      // errores síncronos, así que no cubría nada de eso.\n      if (navigator.clipboard && window.isSecureContext) {\n        try {\n          await navigator.clipboard.writeText(text);\n          mostrarSnackbar(options?.message || '¡Copiado al portapapeles!', options?.severity || 'success');\n          return true;\n        } catch {\n          // Puede ser sólo falta de foco: se intenta el fallback antes de rendirse.\n        }\n      }\n\n      if (copiarConTextarea(text)) {\n        mostrarSnackbar(options?.message || '¡Copiado al portapapeles!', options?.severity || 'success');\n        return true;\n      }\n\n      mostrarSnackbar('No se pudo copiar al portapapeles.', 'error');\n      return false;\n    },\n    [copiarConTextarea, mostrarSnackbar, options],\n  );\n\n  // --- Lógica del Modo Ref ---\n  const copyFromRef = useCallback(() => {\n    if (elementRef.current) {\n        const textToCopy = elementRef.current.innerText || '';\n        // `void`: el listener del DOM no puede esperar la promesa, y ésta ya\n        // maneja sus propios errores adentro.\n        void executeCopy(textToCopy);\n    }\n  }, [executeCopy]);\n\n  // Adjunta un event listener de clic al elemento referenciado (Modo Ref)\n  useEffect(() => {\n    const currentElement = elementRef.current;\n    if (currentElement) {\n      currentElement.style.cursor = 'pointer';\n      // Adjuntamos la función que copia el texto del ref\n      currentElement.addEventListener('click', copyFromRef);\n    }\n\n    return () => {\n      if (currentElement) {\n        currentElement.removeEventListener('click', copyFromRef);\n      }\n    };\n  }, [copyFromRef]);\n\n\n  // Componente Snackbar encapsulado. Solo se renderiza si duration es > 0.\n  const CopyMessage = () => {\n    if (snackbarDuration <= 0) return null; // No renderizar si la duración es 0\n\n    return (\n      <Snackbar\n        open={snackbarOpen}\n        autoHideDuration={snackbarDuration}\n        onClose={handleSnackbarClose}\n        anchorOrigin={snackbarPosition}\n      >\n        <Alert onClose={handleSnackbarClose} severity={snackbarSeverity} sx={{ width: '100%' }}>\n          {snackbarMessage}\n        </Alert>\n      </Snackbar>\n    );\n  };\n\n  // Retorna ambas funcionalidades para que el usuario elija\n  return { ref: elementRef, copy: executeCopy, CopyMessage };\n}\n\nexport default useClipboard;"],"names":["_a"],"mappings":";;;AA0BO,SAAS,aAAa,SAA2B;;AAEtD,QAAM,aAAa,OAAoB,IAAI;AAG3C,QAAM,CAAC,cAAc,eAAe,IAAI,SAAS,KAAK;AACtD,QAAM,CAAC,iBAAiB,kBAAkB,IAAI,UAAS,mCAAS,YAAW,2BAA2B;AACtG,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,UAAiC,mCAAS,aAAY,SAAS;AAC/G,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,UAAiD,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,SAAA,CAAU;AAClK,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,UAAS,wCAAS,aAAT,YAAqB,GAAI;AAGlF,QAAM,sBAAsB,YAAY,CAAC,OAAsC,WAAoB;AACjG,QAAI,WAAW,aAAa;AAC1B;AAAA,IACF;AACA,oBAAgB,KAAK;AAAA,EACvB,GAAG,CAAA,CAAE;AAOL,QAAM,kBAAkB;AAAA,IACtB,CAAC,SAAiB,cAAsC;;AACtD,yBAAmB,OAAO;AAC1B,0BAAoB,SAAS;AAC7B,2BAAoB,mCAAS,aAAY,EAAE,UAAU,UAAU,YAAY,UAAU;AACrF,2BAAoBA,MAAA,mCAAS,aAAT,OAAAA,MAAqB,GAAI;AAC7C,sBAAgB,IAAI;AAAA,IACtB;AAAA,IACA,CAAC,OAAO;AAAA,EAAA;AAIV,QAAM,oBAAoB,YAAY,CAAC,SAA0B;AAC/D,UAAM,WAAW,SAAS,cAAc,UAAU;AAClD,aAAS,QAAQ;AAEjB,aAAS,MAAM,WAAW;AAC1B,aAAS,MAAM,MAAM;AACrB,aAAS,MAAM,UAAU;AACzB,aAAS,KAAK,YAAY,QAAQ;AAClC,aAAS,OAAA;AACT,QAAI;AACF,aAAO,SAAS,YAAY,MAAM;AAAA,IACpC,SAAQ;AACN,aAAO;AAAA,IACT,UAAA;AACE,eAAS,KAAK,YAAY,QAAQ;AAAA,IACpC;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,cAAc;AAAA,IAClB,OAAO,SAAmC;AAMxC,UAAI,UAAU,aAAa,OAAO,iBAAiB;AACjD,YAAI;AACF,gBAAM,UAAU,UAAU,UAAU,IAAI;AACxC,2BAAgB,mCAAS,YAAW,8BAA6B,mCAAS,aAAY,SAAS;AAC/F,iBAAO;AAAA,QACT,SAAQ;AAAA,QAER;AAAA,MACF;AAEA,UAAI,kBAAkB,IAAI,GAAG;AAC3B,yBAAgB,mCAAS,YAAW,8BAA6B,mCAAS,aAAY,SAAS;AAC/F,eAAO;AAAA,MACT;AAEA,sBAAgB,sCAAsC,OAAO;AAC7D,aAAO;AAAA,IACT;AAAA,IACA,CAAC,mBAAmB,iBAAiB,OAAO;AAAA,EAAA;AAI9C,QAAM,cAAc,YAAY,MAAM;AACpC,QAAI,WAAW,SAAS;AACpB,YAAM,aAAa,WAAW,QAAQ,aAAa;AAGnD,WAAK,YAAY,UAAU;AAAA,IAC/B;AAAA,EACF,GAAG,CAAC,WAAW,CAAC;AAGhB,YAAU,MAAM;AACd,UAAM,iBAAiB,WAAW;AAClC,QAAI,gBAAgB;AAClB,qBAAe,MAAM,SAAS;AAE9B,qBAAe,iBAAiB,SAAS,WAAW;AAAA,IACtD;AAEA,WAAO,MAAM;AACX,UAAI,gBAAgB;AAClB,uBAAe,oBAAoB,SAAS,WAAW;AAAA,MACzD;AAAA,IACF;AAAA,EACF,GAAG,CAAC,WAAW,CAAC;AAIhB,QAAM,cAAc,MAAM;AACxB,QAAI,oBAAoB,EAAG,QAAO;AAElC,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAM;AAAA,QACN,kBAAkB;AAAA,QAClB,SAAS;AAAA,QACT,cAAc;AAAA,QAEd,UAAA,oBAAC,OAAA,EAAM,SAAS,qBAAqB,UAAU,kBAAkB,IAAI,EAAE,OAAO,OAAA,GAC3E,UAAA,gBAAA,CACH;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AAGA,SAAO,EAAE,KAAK,YAAY,MAAM,aAAa,YAAA;AAC/C;"}