@soyfri/shared-library 4.0.4 → 4.1.0

package/components/_shared/formField.sx.d.mts

@@ -0,0 +1,62 @@
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
+export type LabelPosition = 'outside' | 'floating';
+export interface BuildFormFieldSxOptions {
+    borderRadius: number | string;
+    labelPosition: LabelPosition;
+    /**
+     * Si es `true`, los selectores incluyen también la API nueva de MUI X
+     * Pickers (v8): `MuiPickersInputBase-root`, `MuiPickersOutlinedInput-*`.
+     */
+    includePickersApi?: boolean;
+    /**
+     * Selectores/valores extra que se mergean SOLO cuando labelPosition === 'outside'.
+     * Usar para paddings específicos del componente (p.ej. MuiAutocomplete-input).
+     */
+    extraOutsideSx?: Record<string, any>;
+    /**
+     * Selectores/valores extra que se mergean SOLO cuando labelPosition === 'floating'.
+     */
+    extraFloatingSx?: Record<string, any>;
+}
+/**
+ * Versión en CSS real del builder compartido, para consumir desde `styled()`.
+ *
+ * La única diferencia con `buildFormFieldSx` es que los tres colores del label
+ * son atajos de paleta (`'text.secondary'`, …), que `sx` resuelve solo pero
+ * emotion no: acá se resuelven contra `theme.palette` explícitamente. El resto
+ * del builder ya era CSS plano.
+ *
+ * **Sobre la altura uniforme de los campos (medido, no supuesto).** Las reglas
+ * de acá salen como selector descendiente
+ * (`.FriInput-root .MuiInputBase-input`, especificidad 0-2-0):
+ *
+ * - vs `MuiOutlinedInput.styleOverrides.input` del consumidor (0-1-0) → **gana
+ *   el paquete**. Los campos mantienen su altura.
+ * - vs `MuiSelect.styleOverrides.select` (0-2-0, porque MUI lo serializa como
+ *   `.css-hash.MuiSelect-select`, dos clases) → **empata y gana el consumidor**
+ *   por orden de inyección: MUI monta el hijo después del padre.
+ *
+ * O sea que la garantía de altura uniforme es parcial y siempre lo fue. El
+ * comentario anterior decía que estar en `sx` era lo que la sostenía; no era
+ * cierto — con `sx` pasaba exactamente lo mismo. Está fijado en la story
+ * `Input/Tematizado`, que mide los dos casos.
+ *
+ * **Decisión del equipo (2026-09): se deja así.** El paquete no escala la
+ * especificidad para ganarle al theme del consumidor — hacerlo (subir estas
+ * reglas a `&&`) volvería la altura intematizable. Si una app necesita que sus
+ * campos midan lo mismo, lo resuelve en su propio theme.
+ */
+export declare const buildFormFieldStyles: (theme: Theme, options: BuildFormFieldSxOptions) => CSSObject;
+/**
+ * Builder del sx compartido por todos los campos de formulario
+ * (Input/Select/Autocomplete/DatePicker/DateTimePicker).
+ *
+ * Produce:
+ * - en modo "floating": sólo el border-radius del outlined input;
+ * - en modo "outside": todo el pack (margen superior, label flotante afuera,
+ *   input base, notched outline oculto, helper text sin margen izquierdo).
+ *
+ * Componentes con paddings o selectores propios pueden inyectarlos vía
+ * `extraOutsideSx` / `extraFloatingSx`.
+ */
+export declare const buildFormFieldSx: ({ borderRadius, labelPosition, includePickersApi, extraOutsideSx, extraFloatingSx, }: BuildFormFieldSxOptions) => SxProps<Theme>;

package/components/_shared/formField.sx.d.ts

@@ -1,4 +1,4 @@
-import { SxProps, Theme } from '@mui/material/styles';
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
 export type LabelPosition = 'outside' | 'floating';
 export interface BuildFormFieldSxOptions {
     borderRadius: number | string;
@@ -18,6 +18,35 @@ export interface BuildFormFieldSxOptions {
      */
     extraFloatingSx?: Record<string, any>;
 }
+/**
+ * Versión en CSS real del builder compartido, para consumir desde `styled()`.
+ *
+ * La única diferencia con `buildFormFieldSx` es que los tres colores del label
+ * son atajos de paleta (`'text.secondary'`, …), que `sx` resuelve solo pero
+ * emotion no: acá se resuelven contra `theme.palette` explícitamente. El resto
+ * del builder ya era CSS plano.
+ *
+ * **Sobre la altura uniforme de los campos (medido, no supuesto).** Las reglas
+ * de acá salen como selector descendiente
+ * (`.FriInput-root .MuiInputBase-input`, especificidad 0-2-0):
+ *
+ * - vs `MuiOutlinedInput.styleOverrides.input` del consumidor (0-1-0) → **gana
+ *   el paquete**. Los campos mantienen su altura.
+ * - vs `MuiSelect.styleOverrides.select` (0-2-0, porque MUI lo serializa como
+ *   `.css-hash.MuiSelect-select`, dos clases) → **empata y gana el consumidor**
+ *   por orden de inyección: MUI monta el hijo después del padre.
+ *
+ * O sea que la garantía de altura uniforme es parcial y siempre lo fue. El
+ * comentario anterior decía que estar en `sx` era lo que la sostenía; no era
+ * cierto — con `sx` pasaba exactamente lo mismo. Está fijado en la story
+ * `Input/Tematizado`, que mide los dos casos.
+ *
+ * **Decisión del equipo (2026-09): se deja así.** El paquete no escala la
+ * especificidad para ganarle al theme del consumidor — hacerlo (subir estas
+ * reglas a `&&`) volvería la altura intematizable. Si una app necesita que sus
+ * campos midan lo mismo, lo resuelve en su propio theme.
+ */
+export declare const buildFormFieldStyles: (theme: Theme, options: BuildFormFieldSxOptions) => CSSObject;
 /**
  * Builder del sx compartido por todos los campos de formulario
  * (Input/Select/Autocomplete/DatePicker/DateTimePicker).

package/components/_shared/mergeSlotProps.d.cts

@@ -0,0 +1,19 @@
+import { SxProps, Theme } from '@mui/material/styles';
+type SlotPropsBase = {
+    className?: string;
+    sx?: SxProps<Theme>;
+};
+/**
+ * Combina las props que el componente le pone a un slot interno con las que
+ * manda el consumidor por `slotProps`.
+ *
+ * No es un spread pelado: `className` y `sx` se ACUMULAN en vez de pisarse. Si
+ * el consumidor manda un `className`, el interno (`fri-DataRow-label`, del que
+ * dependen los `styleOverrides` y los presets) tiene que sobrevivir; y su `sx`
+ * va después del nuestro para que gane, igual que en el root.
+ *
+ * El resto de las props sí las pisa el consumidor — es lo que quiere quien
+ * pasa `slotProps={{ label: { variant: 'caption' } }}`.
+ */
+export declare function mergeSlotProps<T extends SlotPropsBase>(base: T, extra?: Partial<T>): T;
+export {};

package/components/_shared/mergeSlotProps.d.mts

@@ -0,0 +1,19 @@
+import { SxProps, Theme } from '@mui/material/styles';
+type SlotPropsBase = {
+    className?: string;
+    sx?: SxProps<Theme>;
+};
+/**
+ * Combina las props que el componente le pone a un slot interno con las que
+ * manda el consumidor por `slotProps`.
+ *
+ * No es un spread pelado: `className` y `sx` se ACUMULAN en vez de pisarse. Si
+ * el consumidor manda un `className`, el interno (`fri-DataRow-label`, del que
+ * dependen los `styleOverrides` y los presets) tiene que sobrevivir; y su `sx`
+ * va después del nuestro para que gane, igual que en el root.
+ *
+ * El resto de las props sí las pisa el consumidor — es lo que quiere quien
+ * pasa `slotProps={{ label: { variant: 'caption' } }}`.
+ */
+export declare function mergeSlotProps<T extends SlotPropsBase>(base: T, extra?: Partial<T>): T;
+export {};

package/components/_shared/mergeSlotProps.d.ts

@@ -0,0 +1,19 @@
+import { SxProps, Theme } from '@mui/material/styles';
+type SlotPropsBase = {
+    className?: string;
+    sx?: SxProps<Theme>;
+};
+/**
+ * Combina las props que el componente le pone a un slot interno con las que
+ * manda el consumidor por `slotProps`.
+ *
+ * No es un spread pelado: `className` y `sx` se ACUMULAN en vez de pisarse. Si
+ * el consumidor manda un `className`, el interno (`fri-DataRow-label`, del que
+ * dependen los `styleOverrides` y los presets) tiene que sobrevivir; y su `sx`
+ * va después del nuestro para que gane, igual que en el root.
+ *
+ * El resto de las props sí las pisa el consumidor — es lo que quiere quien
+ * pasa `slotProps={{ label: { variant: 'caption' } }}`.
+ */
+export declare function mergeSlotProps<T extends SlotPropsBase>(base: T, extra?: Partial<T>): T;
+export {};

package/components/_shared/mergeSx.d.cts

@@ -0,0 +1,7 @@
+import { SxProps, Theme } from '@mui/material/styles';
+/**
+ * Merge helper para props `sx` de MUI. Acepta formatos objeto o array y
+ * devuelve un array combinado. El `extra` se aplica después del `base` —
+ * el consumer puede pisar los defaults del componente.
+ */
+export declare const mergeSx: (base: SxProps<Theme>, extra?: SxProps<Theme>) => SxProps<Theme>;

package/components/_shared/mergeSx.d.mts

@@ -0,0 +1,7 @@
+import { SxProps, Theme } from '@mui/material/styles';
+/**
+ * Merge helper para props `sx` de MUI. Acepta formatos objeto o array y
+ * devuelve un array combinado. El `extra` se aplica después del `base` —
+ * el consumer puede pisar los defaults del componente.
+ */
+export declare const mergeSx: (base: SxProps<Theme>, extra?: SxProps<Theme>) => SxProps<Theme>;

package/components/_shared/resolvePreset.d.cts

@@ -0,0 +1,22 @@
+import { SxProps, Theme } from '@mui/material/styles';
+import { LibraryComponentName } from '../../theme/componentStyles';
+/**
+ * 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 `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/components/_shared/resolvePreset.d.mts

@@ -0,0 +1,22 @@
+import { SxProps, Theme } from '@mui/material/styles';
+import { LibraryComponentName } from '../../theme/componentStyles.mjs';
+/**
+ * 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 `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.d.cts

@@ -0,0 +1,30 @@
+import { default as React } from 'react';
+import { AlertProps } from '@mui/material/Alert';
+interface SnackbarOptions {
+    message?: string;
+    duration?: number;
+    severity?: AlertProps['severity'];
+    position?: {
+        vertical: 'top' | 'bottom';
+        horizontal: 'left' | 'center' | 'right';
+    };
+}
+/**
+ * Hook 'useClipboard'.
+ * Proporciona funcionalidad de copiado de texto y feedback visual (Snackbar).
+ * Permite dos modos de uso:
+ * 1. Uso por Referencia (ref): Se adjunta a un elemento, copia su innerText al hacer clic.
+ * 2. Uso por Función (copy): Recibe el texto a copiar directamente como argumento.
+ *
+ * @param options Opciones de configuración para el Snackbar de feedback.
+ * @returns Un objeto que contiene:
+ * - 'ref': Una React Ref para adjuntar a un elemento (Modo Ref).
+ * - 'copy': Una función (text: string) => void para copiar texto (Modo Función).
+ * - 'CopyMessage': El componente Snackbar para renderizar el feedback.
+ */
+export declare function useClipboard(options?: SnackbarOptions): {
+    ref: React.RefObject<HTMLElement | null>;
+    copy: (text: string) => Promise<boolean>;
+    CopyMessage: () => import("react/jsx-runtime").JSX.Element | null;
+};
+export default useClipboard;

package/hooks/ClipBoard/ClipBoard.d.mts

@@ -0,0 +1,30 @@
+import { default as React } from 'react';
+import { AlertProps } from '@mui/material/Alert';
+interface SnackbarOptions {
+    message?: string;
+    duration?: number;
+    severity?: AlertProps['severity'];
+    position?: {
+        vertical: 'top' | 'bottom';
+        horizontal: 'left' | 'center' | 'right';
+    };
+}
+/**
+ * Hook 'useClipboard'.
+ * Proporciona funcionalidad de copiado de texto y feedback visual (Snackbar).
+ * Permite dos modos de uso:
+ * 1. Uso por Referencia (ref): Se adjunta a un elemento, copia su innerText al hacer clic.
+ * 2. Uso por Función (copy): Recibe el texto a copiar directamente como argumento.
+ *
+ * @param options Opciones de configuración para el Snackbar de feedback.
+ * @returns Un objeto que contiene:
+ * - 'ref': Una React Ref para adjuntar a un elemento (Modo Ref).
+ * - 'copy': Una función (text: string) => void para copiar texto (Modo Función).
+ * - 'CopyMessage': El componente Snackbar para renderizar el feedback.
+ */
+export declare function useClipboard(options?: SnackbarOptions): {
+    ref: React.RefObject<HTMLElement | null>;
+    copy: (text: string) => Promise<boolean>;
+    CopyMessage: () => import("react/jsx-runtime").JSX.Element | null;
+};
+export default useClipboard;

package/hooks/ClipBoard/ClipboardUnifiedDemo.d.cts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+/**
+ * Componente Wrapper para demostrar ambos modos de uso del hook useClipboard unificado.
+ * @param {object} args - Propiedades del Snackbar que se pasan al hook.
+ */
+interface ClipboardDemoProps {
+    message: string;
+    severity: 'success' | 'info' | 'warning' | 'error';
+    duration: number;
+    vertical: 'top' | 'bottom';
+    horizontal: 'left' | 'center' | 'right';
+}
+declare const ClipboardUnifiedDemo: React.FC<ClipboardDemoProps>;
+export default ClipboardUnifiedDemo;

package/hooks/ClipBoard/ClipboardUnifiedDemo.d.mts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+/**
+ * Componente Wrapper para demostrar ambos modos de uso del hook useClipboard unificado.
+ * @param {object} args - Propiedades del Snackbar que se pasan al hook.
+ */
+interface ClipboardDemoProps {
+    message: string;
+    severity: 'success' | 'info' | 'warning' | 'error';
+    duration: number;
+    vertical: 'top' | 'bottom';
+    horizontal: 'left' | 'center' | 'right';
+}
+declare const ClipboardUnifiedDemo: React.FC<ClipboardDemoProps>;
+export default ClipboardUnifiedDemo;

package/hooks/ClipBoard/index.cjs

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const React = require("react");
+const material = require("@mui/material");
+function useClipboard(options) {
+  var _a;
+  const elementRef = React.useRef(null);
+  const [snackbarOpen, setSnackbarOpen] = React.useState(false);
+  const [snackbarMessage, setSnackbarMessage] = React.useState((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!");
+  const [snackbarSeverity, setSnackbarSeverity] = React.useState((options == null ? void 0 : options.severity) || "success");
+  const [snackbarPosition, setSnackbarPosition] = React.useState((options == null ? void 0 : options.position) || { vertical: "bottom", horizontal: "center" });
+  const [snackbarDuration, setSnackbarDuration] = React.useState((_a = options == null ? void 0 : options.duration) != null ? _a : 3e3);
+  const handleSnackbarClose = React.useCallback((event, reason) => {
+    if (reason === "clickaway") {
+      return;
+    }
+    setSnackbarOpen(false);
+  }, []);
+  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);
+    },
+    [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);
+    }
+  }, []);
+  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 || "";
+      void executeCopy(textToCopy);
+    }
+  }, [executeCopy]);
+  React.useEffect(() => {
+    const currentElement = elementRef.current;
+    if (currentElement) {
+      currentElement.style.cursor = "pointer";
+      currentElement.addEventListener("click", copyFromRef);
+    }
+    return () => {
+      if (currentElement) {
+        currentElement.removeEventListener("click", copyFromRef);
+      }
+    };
+  }, [copyFromRef]);
+  const CopyMessage = () => {
+    if (snackbarDuration <= 0) return null;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      material.Snackbar,
+      {
+        open: snackbarOpen,
+        autoHideDuration: snackbarDuration,
+        onClose: handleSnackbarClose,
+        anchorOrigin: snackbarPosition,
+        children: /* @__PURE__ */ jsxRuntime.jsx(material.Alert, { onClose: handleSnackbarClose, severity: snackbarSeverity, sx: { width: "100%" }, children: snackbarMessage })
+      }
+    );
+  };
+  return { ref: elementRef, copy: executeCopy, CopyMessage };
+}
+exports.useClipboard = useClipboard;
+//# sourceMappingURL=index.cjs.map

package/hooks/ClipBoard/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.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/index.d.cts

@@ -0,0 +1 @@
+export { default as useClipboard } from './ClipBoard';

package/hooks/ClipBoard/index.d.mts

@@ -0,0 +1 @@
+export { default as useClipboard } from './ClipBoard.mjs';

package/hooks/ClipBoard/index.mjs

@@ -0,0 +1,100 @@
+import { jsx } from "react/jsx-runtime";
+import { useRef, useState, useCallback, useEffect } from "react";
+import { Snackbar, Alert } from "@mui/material";
+function useClipboard(options) {
+  var _a;
+  const elementRef = useRef(null);
+  const [snackbarOpen, setSnackbarOpen] = useState(false);
+  const [snackbarMessage, setSnackbarMessage] = useState((options == null ? void 0 : options.message) || "¡Copiado al portapapeles!");
+  const [snackbarSeverity, setSnackbarSeverity] = useState((options == null ? void 0 : options.severity) || "success");
+  const [snackbarPosition, setSnackbarPosition] = useState((options == null ? void 0 : options.position) || { vertical: "bottom", horizontal: "center" });
+  const [snackbarDuration, setSnackbarDuration] = useState((_a = options == null ? void 0 : options.duration) != null ? _a : 3e3);
+  const handleSnackbarClose = useCallback((event, reason) => {
+    if (reason === "clickaway") {
+      return;
+    }
+    setSnackbarOpen(false);
+  }, []);
+  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);
+    },
+    [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);
+    }
+  }, []);
+  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 || "";
+      void executeCopy(textToCopy);
+    }
+  }, [executeCopy]);
+  useEffect(() => {
+    const currentElement = elementRef.current;
+    if (currentElement) {
+      currentElement.style.cursor = "pointer";
+      currentElement.addEventListener("click", copyFromRef);
+    }
+    return () => {
+      if (currentElement) {
+        currentElement.removeEventListener("click", copyFromRef);
+      }
+    };
+  }, [copyFromRef]);
+  const CopyMessage = () => {
+    if (snackbarDuration <= 0) return null;
+    return /* @__PURE__ */ jsx(
+      Snackbar,
+      {
+        open: snackbarOpen,
+        autoHideDuration: snackbarDuration,
+        onClose: handleSnackbarClose,
+        anchorOrigin: snackbarPosition,
+        children: /* @__PURE__ */ jsx(Alert, { onClose: handleSnackbarClose, severity: snackbarSeverity, sx: { width: "100%" }, children: snackbarMessage })
+      }
+    );
+  };
+  return { ref: elementRef, copy: executeCopy, CopyMessage };
+}
+export {
+  useClipboard
+};
+//# sourceMappingURL=index.mjs.map

package/hooks/ClipBoard/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","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":"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"}

package/hooks/ClipBoard.d.cts

@@ -0,0 +1,2 @@
+export * from './ClipBoard/index'
+export {}

package/hooks/ClipBoard.d.mts

@@ -0,0 +1,2 @@
+export * from './ClipBoard/index.mjs'
+export {}