@soyfri/shared-library 1.5.0 → 2.0.0-beta.0

package/dist/components/PageLoader/PageLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageLoader.js","sources":["../../../src/components/PageLoader/PageLoader.tsx"],"sourcesContent":["import React, { type ReactNode } from 'react';\nimport { Box, CircularProgress, Typography, Fade } from '@mui/material';\nimport type { SxProps, Theme } from '@mui/material/styles';\n\nexport interface PageLoaderProps {\n  /**\n   * Si es true, muestra el loader ocupando toda la ventana (fixed, 100vh/vw)\n   * con backdrop. Default: true.\n   */\n  fullscreen?: boolean;\n  /** Texto bajo el spinner. */\n  message?: ReactNode;\n  /** Logo/imagen opcional arriba del spinner. */\n  logo?: ReactNode;\n  /** Tamaño del spinner en px. Default: 48. */\n  size?: number;\n  /**\n   * Control explícito. Si es undefined, el loader se muestra apenas se monta.\n   * Útil para fades.\n   */\n  open?: boolean;\n  /** Color del backdrop (solo fullscreen). Default: usa theme.palette.background.default. */\n  backdropColor?: string;\n  /** sx del root. */\n  sx?: SxProps<Theme>;\n  className?: string;\n}\n\n/**\n * Loader full-page o inline. Reemplaza el `LayoutSplashScreen` de Metronic.\n *\n * ```tsx\n * // Splash de arranque\n * <PageLoader logo={<img src={logo} />} message=\"Cargando...\" />\n *\n * // Loader local dentro de una card\n * <PageLoader fullscreen={false} size={32} />\n * ```\n */\nexport function PageLoader({\n  fullscreen = true,\n  message,\n  logo,\n  size = 48,\n  open = true,\n  backdropColor,\n  sx,\n  className,\n}: PageLoaderProps) {\n  const rootSx: SxProps<Theme> = [\n    (theme) => ({\n      display: 'flex',\n      flexDirection: 'column',\n      alignItems: 'center',\n      justifyContent: 'center',\n      gap: 2,\n      ...(fullscreen\n        ? {\n            position: 'fixed',\n            inset: 0,\n            zIndex: theme.zIndex.modal + 10,\n            backgroundColor:\n              backdropColor ?? theme.palette.background.default,\n          }\n        : {\n            width: '100%',\n            minHeight: 160,\n          }),\n    }),\n    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\n  ];\n\n  const content = (\n    <Box className={className} sx={rootSx} role=\"status\" aria-live=\"polite\">\n      {logo && <Box sx={{ mb: 1 }}>{logo}</Box>}\n      <CircularProgress size={size} thickness={4} />\n      {message && (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {message}\n        </Typography>\n      )}\n    </Box>\n  );\n\n  if (!fullscreen) {\n    return open ? content : null;\n  }\n\n  return (\n    <Fade in={open} timeout={{ enter: 0, exit: 200 }} unmountOnExit>\n      {content}\n    </Fade>\n  );\n}\n\nexport default PageLoader;\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAuCO,SAAS,WAAW;AAAA,EACzB,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AACF,GAAoB;AAClB,QAAM,SAAyB;AAAA,IAC7B,CAAC,UAAW;AAAA,MACV,SAAS;AAAA,MACT,eAAe;AAAA,MACf,YAAY;AAAA,MACZ,gBAAgB;AAAA,MAChB,KAAK;AAAA,OACD,aACA;AAAA,MACE,UAAU;AAAA,MACV,OAAO;AAAA,MACP,QAAQ,MAAM,OAAO,QAAQ;AAAA,MAC7B,iBACE,wCAAiB,MAAM,QAAQ,WAAW;AAAA,IAAA,IAE9C;AAAA,MACE,OAAO;AAAA,MACP,WAAW;AAAA,IAAA;AAAA,IAGnB,GAAI,MAAM,QAAQ,EAAE,IAAI,KAAK,KAAK,CAAC,EAAE,IAAI,CAAA;AAAA,EAAC;AAG5C,QAAM,+BACH,KAAA,EAAI,WAAsB,IAAI,QAAQ,MAAK,UAAS,aAAU,UAC5D,UAAA;AAAA,IAAA,4BAAS,KAAA,EAAI,IAAI,EAAE,IAAI,EAAA,GAAM,UAAA,MAAK;AAAA,IACnC,oBAAC,kBAAA,EAAiB,MAAY,WAAW,EAAA,CAAG;AAAA,IAC3C,WACC,oBAAC,YAAA,EAAW,SAAQ,SAAQ,OAAM,kBAC/B,UAAA,QAAA,CACH;AAAA,EAAA,GAEJ;AAGF,MAAI,CAAC,YAAY;AACf,WAAO,OAAO,UAAU;AAAA,EAC1B;AAEA,SACE,oBAAC,MAAA,EAAK,IAAI,MAAM,SAAS,EAAE,OAAO,GAAG,MAAM,IAAA,GAAO,eAAa,MAC5D,UAAA,SACH;AAEJ;"}

package/dist/components/PageLoader/index.d.ts

@@ -0,0 +1,2 @@
+export { PageLoader, default } from './PageLoader';
+export type { PageLoaderProps } from './PageLoader';

package/dist/components/PageLoader.d.ts

@@ -0,0 +1,6 @@
+export * from './PageLoader/index'
+export {}
+import _default from './PageLoader/index'
+export default _default
+export * from './PageLoader/index'
+export {}

package/dist/components/ScrollTopButton/ScrollTopButton.cjs

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const jsxRuntime = require("react/jsx-runtime");
+const React = require("react");
+const material = require("@mui/material");
+const KeyboardArrowUpIcon = require("@mui/icons-material/KeyboardArrowUp");
+const resolvePreset = require("../../resolvePreset-CT3kU-K2.cjs");
+function scrollToTop({
+  behavior = "smooth",
+  target = typeof window !== "undefined" ? window : void 0,
+  top = 0
+} = {}) {
+  if (!target) return;
+  target.scrollTo({ top, left: 0, behavior });
+}
+const positionSx = {
+  "bottom-right": { position: "fixed", bottom: 24, right: 24 },
+  "bottom-left": { position: "fixed", bottom: 24, left: 24 },
+  "bottom-center": {
+    position: "fixed",
+    bottom: 24,
+    left: "50%",
+    transform: "translateX(-50%)"
+  }
+};
+function ScrollTopButton({
+  threshold = 300,
+  position = "bottom-right",
+  scrollTarget,
+  size = "medium",
+  color = "default",
+  icon,
+  ariaLabel = "Subir al inicio",
+  preset,
+  sx,
+  className
+}) {
+  const theme = material.useTheme();
+  const [visible, setVisible] = React.useState(false);
+  React.useEffect(() => {
+    const target = scrollTarget != null ? scrollTarget : typeof window !== "undefined" ? window : null;
+    if (!target) return;
+    const readScrollTop = () => target === window ? window.scrollY || document.documentElement.scrollTop : target.scrollTop;
+    const handleScroll = () => {
+      setVisible(readScrollTop() > threshold);
+    };
+    handleScroll();
+    target.addEventListener("scroll", handleScroll, { passive: true });
+    return () => target.removeEventListener("scroll", handleScroll);
+  }, [threshold, scrollTarget]);
+  const handleClick = () => {
+    scrollToTop({
+      target: scrollTarget != null ? scrollTarget : typeof window !== "undefined" ? window : void 0
+    });
+  };
+  const presetSx = resolvePreset.resolvePreset("ScrollTopButton", preset, theme);
+  const mergedSx = [
+    positionSx[position],
+    { zIndex: theme.zIndex.speedDial },
+    ...presetSx ? [presetSx] : [],
+    ...Array.isArray(sx) ? sx : sx ? [sx] : []
+  ];
+  return /* @__PURE__ */ jsxRuntime.jsx(material.Zoom, { in: visible, unmountOnExit: true, children: /* @__PURE__ */ jsxRuntime.jsx(
+    material.Fab,
+    {
+      size,
+      color,
+      "aria-label": ariaLabel,
+      onClick: handleClick,
+      className,
+      sx: mergedSx,
+      children: icon != null ? icon : /* @__PURE__ */ jsxRuntime.jsx(KeyboardArrowUpIcon, {})
+    }
+  ) });
+}
+exports.ScrollTopButton = ScrollTopButton;
+exports.default = ScrollTopButton;
+exports.scrollToTop = scrollToTop;
+//# sourceMappingURL=ScrollTopButton.cjs.map

package/dist/components/ScrollTopButton/ScrollTopButton.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollTopButton.cjs","sources":["../../../src/components/ScrollTopButton/scrollToTop.ts","../../../src/components/ScrollTopButton/ScrollTopButton.tsx"],"sourcesContent":["export interface ScrollToTopOptions {\n  /** Comportamiento del scroll. Default: `'smooth'`. */\n  behavior?: ScrollBehavior;\n  /**\n   * Elemento target del scroll. Default: `window`. Útil cuando el contenedor\n   * scrolleable NO es `window` (p.ej. un `<Box>` con `overflow: auto`).\n   */\n  target?: Window | HTMLElement;\n  /** Offset desde el top. Default: `0`. */\n  top?: number;\n}\n\n/**\n * Reemplaza imperativamente a `ScrollTopComponent.goTop()` de Metronic.\n *\n * Llamar tras mutaciones / cambios de filtros / apertura de modales para\n * asegurar que el usuario vea el mensaje de confirmación en la parte\n * superior de la página.\n *\n * ```ts\n * // Reemplazo directo del legacy:\n * // Antes: ScrollTopComponent.goTop()\n * scrollToTop();\n *\n * // Con opciones:\n * scrollToTop({ behavior: 'auto' });\n * scrollToTop({ target: myScrollableRef.current });\n * ```\n */\nexport function scrollToTop({\n  behavior = 'smooth',\n  target = typeof window !== 'undefined' ? window : undefined,\n  top = 0,\n}: ScrollToTopOptions = {}): void {\n  if (!target) return;\n  target.scrollTo({ top, left: 0, behavior });\n}\n","import React, { useEffect, useState, type ReactNode } from 'react';\nimport { Fab, Zoom, useTheme } from '@mui/material';\nimport KeyboardArrowUpIcon from '@mui/icons-material/KeyboardArrowUp';\nimport type { SxProps, Theme } from '@mui/material/styles';\n\nimport { resolvePreset } from '../_shared/resolvePreset';\nimport { scrollToTop } from './scrollToTop';\n\nexport type ScrollTopButtonPosition =\n  | 'bottom-right'\n  | 'bottom-left'\n  | 'bottom-center';\n\nexport interface ScrollTopButtonProps {\n  /**\n   * Distancia en px que hay que scrollear antes de mostrar el botón.\n   * Default: `300`.\n   */\n  threshold?: number;\n  /**\n   * Posición del botón en la pantalla. Default: `'bottom-right'`.\n   */\n  position?: ScrollTopButtonPosition;\n  /**\n   * Elemento scrolleable a observar y al que se hace scrollTop. Si se omite,\n   * se usa `window` (caso más común).\n   */\n  scrollTarget?: Window | HTMLElement | null;\n  /** Tamaño del FAB. Default: `'medium'`. */\n  size?: 'small' | 'medium' | 'large';\n  /**\n   * Color del FAB. Default: `'default'`.\n   */\n  color?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'error';\n  /** Icono custom. Default: `<KeyboardArrowUpIcon />`. */\n  icon?: ReactNode;\n  /** Texto accesible (aria-label). Default: `\"Subir al inicio\"`. */\n  ariaLabel?: string;\n  /** Preset registrado en `theme.styles.ScrollTopButton`. */\n  preset?: string;\n  /** sx del Fab. Se compone sobre la posición + preset. */\n  sx?: SxProps<Theme>;\n  className?: string;\n}\n\nconst positionSx: Record<ScrollTopButtonPosition, SxProps<Theme>> = {\n  'bottom-right': { position: 'fixed', bottom: 24, right: 24 },\n  'bottom-left': { position: 'fixed', bottom: 24, left: 24 },\n  'bottom-center': {\n    position: 'fixed',\n    bottom: 24,\n    left: '50%',\n    transform: 'translateX(-50%)',\n  },\n};\n\n/**\n * Botón flotante que aparece tras scrollear más de `threshold` px y, al\n * clickearse, hace scroll suave hasta el tope. Reemplaza al componente\n * visible de `ScrollTopComponent` de Metronic.\n *\n * Para el caso imperativo (llamar `goTop()` tras una mutación), usar el\n * helper `scrollToTop()` directamente.\n *\n * ```tsx\n * <ScrollTopButton threshold={400} position=\"bottom-right\" />\n * ```\n */\nexport function ScrollTopButton({\n  threshold = 300,\n  position = 'bottom-right',\n  scrollTarget,\n  size = 'medium',\n  color = 'default',\n  icon,\n  ariaLabel = 'Subir al inicio',\n  preset,\n  sx,\n  className,\n}: ScrollTopButtonProps) {\n  const theme = useTheme();\n  const [visible, setVisible] = useState(false);\n\n  useEffect(() => {\n    // Si viene scrollTarget explícito, usarlo; si no, window.\n    const target: Window | HTMLElement | null =\n      scrollTarget ?? (typeof window !== 'undefined' ? window : null);\n    if (!target) return;\n\n    const readScrollTop = () =>\n      target === window\n        ? window.scrollY || document.documentElement.scrollTop\n        : (target as HTMLElement).scrollTop;\n\n    const handleScroll = () => {\n      setVisible(readScrollTop() > threshold);\n    };\n\n    handleScroll(); // check inicial por si ya estamos scrolleados\n    target.addEventListener('scroll', handleScroll, { passive: true });\n    return () => target.removeEventListener('scroll', handleScroll);\n  }, [threshold, scrollTarget]);\n\n  const handleClick = () => {\n    scrollToTop({\n      target: scrollTarget ?? (typeof window !== 'undefined' ? window : undefined),\n    });\n  };\n\n  const presetSx = resolvePreset('ScrollTopButton', preset, theme);\n\n  const mergedSx: SxProps<Theme> = [\n    positionSx[position],\n    { zIndex: theme.zIndex.speedDial },\n    ...(presetSx ? [presetSx] : []),\n    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\n  ];\n\n  return (\n    <Zoom in={visible} unmountOnExit>\n      <Fab\n        size={size}\n        color={color}\n        aria-label={ariaLabel}\n        onClick={handleClick}\n        className={className}\n        sx={mergedSx}\n      >\n        {icon ?? <KeyboardArrowUpIcon />}\n      </Fab>\n    </Zoom>\n  );\n}\n\nexport default ScrollTopButton;\n"],"names":["useTheme","useState","useEffect","resolvePreset","jsx","Zoom","Fab"],"mappings":";;;;;;;AA6BO,SAAS,YAAY;AAAA,EAC1B,WAAW;AAAA,EACX,SAAS,OAAO,WAAW,cAAc,SAAS;AAAA,EAClD,MAAM;AACR,IAAwB,IAAU;AAChC,MAAI,CAAC,OAAQ;AACb,SAAO,SAAS,EAAE,KAAK,MAAM,GAAG,UAAU;AAC5C;ACSA,MAAM,aAA8D;AAAA,EAClE,gBAAgB,EAAE,UAAU,SAAS,QAAQ,IAAI,OAAO,GAAA;AAAA,EACxD,eAAe,EAAE,UAAU,SAAS,QAAQ,IAAI,MAAM,GAAA;AAAA,EACtD,iBAAiB;AAAA,IACf,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,WAAW;AAAA,EAAA;AAEf;AAcO,SAAS,gBAAgB;AAAA,EAC9B,YAAY;AAAA,EACZ,WAAW;AAAA,EACX;AAAA,EACA,OAAO;AAAA,EACP,QAAQ;AAAA,EACR;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AACF,GAAyB;AACvB,QAAM,QAAQA,SAAAA,SAAA;AACd,QAAM,CAAC,SAAS,UAAU,IAAIC,MAAAA,SAAS,KAAK;AAE5CC,QAAAA,UAAU,MAAM;AAEd,UAAM,SACJ,sCAAiB,OAAO,WAAW,cAAc,SAAS;AAC5D,QAAI,CAAC,OAAQ;AAEb,UAAM,gBAAgB,MACpB,WAAW,SACP,OAAO,WAAW,SAAS,gBAAgB,YAC1C,OAAuB;AAE9B,UAAM,eAAe,MAAM;AACzB,iBAAW,cAAA,IAAkB,SAAS;AAAA,IACxC;AAEA,iBAAA;AACA,WAAO,iBAAiB,UAAU,cAAc,EAAE,SAAS,MAAM;AACjE,WAAO,MAAM,OAAO,oBAAoB,UAAU,YAAY;AAAA,EAChE,GAAG,CAAC,WAAW,YAAY,CAAC;AAE5B,QAAM,cAAc,MAAM;AACxB,gBAAY;AAAA,MACV,QAAQ,sCAAiB,OAAO,WAAW,cAAc,SAAS;AAAA,IAAA,CACnE;AAAA,EACH;AAEA,QAAM,WAAWC,cAAAA,cAAc,mBAAmB,QAAQ,KAAK;AAE/D,QAAM,WAA2B;AAAA,IAC/B,WAAW,QAAQ;AAAA,IACnB,EAAE,QAAQ,MAAM,OAAO,UAAA;AAAA,IACvB,GAAI,WAAW,CAAC,QAAQ,IAAI,CAAA;AAAA,IAC5B,GAAI,MAAM,QAAQ,EAAE,IAAI,KAAK,KAAK,CAAC,EAAE,IAAI,CAAA;AAAA,EAAC;AAG5C,SACEC,2BAAAA,IAACC,SAAAA,MAAA,EAAK,IAAI,SAAS,eAAa,MAC9B,UAAAD,2BAAAA;AAAAA,IAACE,SAAAA;AAAAA,IAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA,cAAY;AAAA,MACZ,SAAS;AAAA,MACT;AAAA,MACA,IAAI;AAAA,MAEH,UAAA,qDAAS,qBAAA,CAAA,CAAoB;AAAA,IAAA;AAAA,EAAA,GAElC;AAEJ;;;;"}

package/dist/components/ScrollTopButton/ScrollTopButton.d.ts

@@ -0,0 +1,48 @@
+import { ReactNode } from 'react';
+import { SxProps, Theme } from '@mui/material/styles';
+export type ScrollTopButtonPosition = 'bottom-right' | 'bottom-left' | 'bottom-center';
+export interface ScrollTopButtonProps {
+    /**
+     * Distancia en px que hay que scrollear antes de mostrar el botón.
+     * Default: `300`.
+     */
+    threshold?: number;
+    /**
+     * Posición del botón en la pantalla. Default: `'bottom-right'`.
+     */
+    position?: ScrollTopButtonPosition;
+    /**
+     * Elemento scrolleable a observar y al que se hace scrollTop. Si se omite,
+     * se usa `window` (caso más común).
+     */
+    scrollTarget?: Window | HTMLElement | null;
+    /** Tamaño del FAB. Default: `'medium'`. */
+    size?: 'small' | 'medium' | 'large';
+    /**
+     * Color del FAB. Default: `'default'`.
+     */
+    color?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'error';
+    /** Icono custom. Default: `<KeyboardArrowUpIcon />`. */
+    icon?: ReactNode;
+    /** Texto accesible (aria-label). Default: `"Subir al inicio"`. */
+    ariaLabel?: string;
+    /** Preset registrado en `theme.styles.ScrollTopButton`. */
+    preset?: string;
+    /** sx del Fab. Se compone sobre la posición + preset. */
+    sx?: SxProps<Theme>;
+    className?: string;
+}
+/**
+ * Botón flotante que aparece tras scrollear más de `threshold` px y, al
+ * clickearse, hace scroll suave hasta el tope. Reemplaza al componente
+ * visible de `ScrollTopComponent` de Metronic.
+ *
+ * Para el caso imperativo (llamar `goTop()` tras una mutación), usar el
+ * helper `scrollToTop()` directamente.
+ *
+ * ```tsx
+ * <ScrollTopButton threshold={400} position="bottom-right" />
+ * ```
+ */
+export declare function ScrollTopButton({ threshold, position, scrollTarget, size, color, icon, ariaLabel, preset, sx, className, }: ScrollTopButtonProps): import("react/jsx-runtime").JSX.Element;
+export default ScrollTopButton;

package/dist/components/ScrollTopButton/ScrollTopButton.js

@@ -0,0 +1,79 @@
+import { jsx } from "react/jsx-runtime";
+import { useState, useEffect } from "react";
+import { useTheme, Zoom, Fab } from "@mui/material";
+import KeyboardArrowUpIcon from "@mui/icons-material/KeyboardArrowUp";
+import { r as resolvePreset } from "../../resolvePreset-B-IB0ehH.js";
+function scrollToTop({
+  behavior = "smooth",
+  target = typeof window !== "undefined" ? window : void 0,
+  top = 0
+} = {}) {
+  if (!target) return;
+  target.scrollTo({ top, left: 0, behavior });
+}
+const positionSx = {
+  "bottom-right": { position: "fixed", bottom: 24, right: 24 },
+  "bottom-left": { position: "fixed", bottom: 24, left: 24 },
+  "bottom-center": {
+    position: "fixed",
+    bottom: 24,
+    left: "50%",
+    transform: "translateX(-50%)"
+  }
+};
+function ScrollTopButton({
+  threshold = 300,
+  position = "bottom-right",
+  scrollTarget,
+  size = "medium",
+  color = "default",
+  icon,
+  ariaLabel = "Subir al inicio",
+  preset,
+  sx,
+  className
+}) {
+  const theme = useTheme();
+  const [visible, setVisible] = useState(false);
+  useEffect(() => {
+    const target = scrollTarget != null ? scrollTarget : typeof window !== "undefined" ? window : null;
+    if (!target) return;
+    const readScrollTop = () => target === window ? window.scrollY || document.documentElement.scrollTop : target.scrollTop;
+    const handleScroll = () => {
+      setVisible(readScrollTop() > threshold);
+    };
+    handleScroll();
+    target.addEventListener("scroll", handleScroll, { passive: true });
+    return () => target.removeEventListener("scroll", handleScroll);
+  }, [threshold, scrollTarget]);
+  const handleClick = () => {
+    scrollToTop({
+      target: scrollTarget != null ? scrollTarget : typeof window !== "undefined" ? window : void 0
+    });
+  };
+  const presetSx = resolvePreset("ScrollTopButton", preset, theme);
+  const mergedSx = [
+    positionSx[position],
+    { zIndex: theme.zIndex.speedDial },
+    ...presetSx ? [presetSx] : [],
+    ...Array.isArray(sx) ? sx : sx ? [sx] : []
+  ];
+  return /* @__PURE__ */ jsx(Zoom, { in: visible, unmountOnExit: true, children: /* @__PURE__ */ jsx(
+    Fab,
+    {
+      size,
+      color,
+      "aria-label": ariaLabel,
+      onClick: handleClick,
+      className,
+      sx: mergedSx,
+      children: icon != null ? icon : /* @__PURE__ */ jsx(KeyboardArrowUpIcon, {})
+    }
+  ) });
+}
+export {
+  ScrollTopButton,
+  ScrollTopButton as default,
+  scrollToTop
+};
+//# sourceMappingURL=ScrollTopButton.js.map

package/dist/components/ScrollTopButton/ScrollTopButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollTopButton.js","sources":["../../../src/components/ScrollTopButton/scrollToTop.ts","../../../src/components/ScrollTopButton/ScrollTopButton.tsx"],"sourcesContent":["export interface ScrollToTopOptions {\n  /** Comportamiento del scroll. Default: `'smooth'`. */\n  behavior?: ScrollBehavior;\n  /**\n   * Elemento target del scroll. Default: `window`. Útil cuando el contenedor\n   * scrolleable NO es `window` (p.ej. un `<Box>` con `overflow: auto`).\n   */\n  target?: Window | HTMLElement;\n  /** Offset desde el top. Default: `0`. */\n  top?: number;\n}\n\n/**\n * Reemplaza imperativamente a `ScrollTopComponent.goTop()` de Metronic.\n *\n * Llamar tras mutaciones / cambios de filtros / apertura de modales para\n * asegurar que el usuario vea el mensaje de confirmación en la parte\n * superior de la página.\n *\n * ```ts\n * // Reemplazo directo del legacy:\n * // Antes: ScrollTopComponent.goTop()\n * scrollToTop();\n *\n * // Con opciones:\n * scrollToTop({ behavior: 'auto' });\n * scrollToTop({ target: myScrollableRef.current });\n * ```\n */\nexport function scrollToTop({\n  behavior = 'smooth',\n  target = typeof window !== 'undefined' ? window : undefined,\n  top = 0,\n}: ScrollToTopOptions = {}): void {\n  if (!target) return;\n  target.scrollTo({ top, left: 0, behavior });\n}\n","import React, { useEffect, useState, type ReactNode } from 'react';\nimport { Fab, Zoom, useTheme } from '@mui/material';\nimport KeyboardArrowUpIcon from '@mui/icons-material/KeyboardArrowUp';\nimport type { SxProps, Theme } from '@mui/material/styles';\n\nimport { resolvePreset } from '../_shared/resolvePreset';\nimport { scrollToTop } from './scrollToTop';\n\nexport type ScrollTopButtonPosition =\n  | 'bottom-right'\n  | 'bottom-left'\n  | 'bottom-center';\n\nexport interface ScrollTopButtonProps {\n  /**\n   * Distancia en px que hay que scrollear antes de mostrar el botón.\n   * Default: `300`.\n   */\n  threshold?: number;\n  /**\n   * Posición del botón en la pantalla. Default: `'bottom-right'`.\n   */\n  position?: ScrollTopButtonPosition;\n  /**\n   * Elemento scrolleable a observar y al que se hace scrollTop. Si se omite,\n   * se usa `window` (caso más común).\n   */\n  scrollTarget?: Window | HTMLElement | null;\n  /** Tamaño del FAB. Default: `'medium'`. */\n  size?: 'small' | 'medium' | 'large';\n  /**\n   * Color del FAB. Default: `'default'`.\n   */\n  color?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'error';\n  /** Icono custom. Default: `<KeyboardArrowUpIcon />`. */\n  icon?: ReactNode;\n  /** Texto accesible (aria-label). Default: `\"Subir al inicio\"`. */\n  ariaLabel?: string;\n  /** Preset registrado en `theme.styles.ScrollTopButton`. */\n  preset?: string;\n  /** sx del Fab. Se compone sobre la posición + preset. */\n  sx?: SxProps<Theme>;\n  className?: string;\n}\n\nconst positionSx: Record<ScrollTopButtonPosition, SxProps<Theme>> = {\n  'bottom-right': { position: 'fixed', bottom: 24, right: 24 },\n  'bottom-left': { position: 'fixed', bottom: 24, left: 24 },\n  'bottom-center': {\n    position: 'fixed',\n    bottom: 24,\n    left: '50%',\n    transform: 'translateX(-50%)',\n  },\n};\n\n/**\n * Botón flotante que aparece tras scrollear más de `threshold` px y, al\n * clickearse, hace scroll suave hasta el tope. Reemplaza al componente\n * visible de `ScrollTopComponent` de Metronic.\n *\n * Para el caso imperativo (llamar `goTop()` tras una mutación), usar el\n * helper `scrollToTop()` directamente.\n *\n * ```tsx\n * <ScrollTopButton threshold={400} position=\"bottom-right\" />\n * ```\n */\nexport function ScrollTopButton({\n  threshold = 300,\n  position = 'bottom-right',\n  scrollTarget,\n  size = 'medium',\n  color = 'default',\n  icon,\n  ariaLabel = 'Subir al inicio',\n  preset,\n  sx,\n  className,\n}: ScrollTopButtonProps) {\n  const theme = useTheme();\n  const [visible, setVisible] = useState(false);\n\n  useEffect(() => {\n    // Si viene scrollTarget explícito, usarlo; si no, window.\n    const target: Window | HTMLElement | null =\n      scrollTarget ?? (typeof window !== 'undefined' ? window : null);\n    if (!target) return;\n\n    const readScrollTop = () =>\n      target === window\n        ? window.scrollY || document.documentElement.scrollTop\n        : (target as HTMLElement).scrollTop;\n\n    const handleScroll = () => {\n      setVisible(readScrollTop() > threshold);\n    };\n\n    handleScroll(); // check inicial por si ya estamos scrolleados\n    target.addEventListener('scroll', handleScroll, { passive: true });\n    return () => target.removeEventListener('scroll', handleScroll);\n  }, [threshold, scrollTarget]);\n\n  const handleClick = () => {\n    scrollToTop({\n      target: scrollTarget ?? (typeof window !== 'undefined' ? window : undefined),\n    });\n  };\n\n  const presetSx = resolvePreset('ScrollTopButton', preset, theme);\n\n  const mergedSx: SxProps<Theme> = [\n    positionSx[position],\n    { zIndex: theme.zIndex.speedDial },\n    ...(presetSx ? [presetSx] : []),\n    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\n  ];\n\n  return (\n    <Zoom in={visible} unmountOnExit>\n      <Fab\n        size={size}\n        color={color}\n        aria-label={ariaLabel}\n        onClick={handleClick}\n        className={className}\n        sx={mergedSx}\n      >\n        {icon ?? <KeyboardArrowUpIcon />}\n      </Fab>\n    </Zoom>\n  );\n}\n\nexport default ScrollTopButton;\n"],"names":[],"mappings":";;;;;AA6BO,SAAS,YAAY;AAAA,EAC1B,WAAW;AAAA,EACX,SAAS,OAAO,WAAW,cAAc,SAAS;AAAA,EAClD,MAAM;AACR,IAAwB,IAAU;AAChC,MAAI,CAAC,OAAQ;AACb,SAAO,SAAS,EAAE,KAAK,MAAM,GAAG,UAAU;AAC5C;ACSA,MAAM,aAA8D;AAAA,EAClE,gBAAgB,EAAE,UAAU,SAAS,QAAQ,IAAI,OAAO,GAAA;AAAA,EACxD,eAAe,EAAE,UAAU,SAAS,QAAQ,IAAI,MAAM,GAAA;AAAA,EACtD,iBAAiB;AAAA,IACf,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,WAAW;AAAA,EAAA;AAEf;AAcO,SAAS,gBAAgB;AAAA,EAC9B,YAAY;AAAA,EACZ,WAAW;AAAA,EACX;AAAA,EACA,OAAO;AAAA,EACP,QAAQ;AAAA,EACR;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AACF,GAAyB;AACvB,QAAM,QAAQ,SAAA;AACd,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAE5C,YAAU,MAAM;AAEd,UAAM,SACJ,sCAAiB,OAAO,WAAW,cAAc,SAAS;AAC5D,QAAI,CAAC,OAAQ;AAEb,UAAM,gBAAgB,MACpB,WAAW,SACP,OAAO,WAAW,SAAS,gBAAgB,YAC1C,OAAuB;AAE9B,UAAM,eAAe,MAAM;AACzB,iBAAW,cAAA,IAAkB,SAAS;AAAA,IACxC;AAEA,iBAAA;AACA,WAAO,iBAAiB,UAAU,cAAc,EAAE,SAAS,MAAM;AACjE,WAAO,MAAM,OAAO,oBAAoB,UAAU,YAAY;AAAA,EAChE,GAAG,CAAC,WAAW,YAAY,CAAC;AAE5B,QAAM,cAAc,MAAM;AACxB,gBAAY;AAAA,MACV,QAAQ,sCAAiB,OAAO,WAAW,cAAc,SAAS;AAAA,IAAA,CACnE;AAAA,EACH;AAEA,QAAM,WAAW,cAAc,mBAAmB,QAAQ,KAAK;AAE/D,QAAM,WAA2B;AAAA,IAC/B,WAAW,QAAQ;AAAA,IACnB,EAAE,QAAQ,MAAM,OAAO,UAAA;AAAA,IACvB,GAAI,WAAW,CAAC,QAAQ,IAAI,CAAA;AAAA,IAC5B,GAAI,MAAM,QAAQ,EAAE,IAAI,KAAK,KAAK,CAAC,EAAE,IAAI,CAAA;AAAA,EAAC;AAG5C,SACE,oBAAC,MAAA,EAAK,IAAI,SAAS,eAAa,MAC9B,UAAA;AAAA,IAAC;AAAA,IAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA,cAAY;AAAA,MACZ,SAAS;AAAA,MACT;AAAA,MACA,IAAI;AAAA,MAEH,UAAA,0CAAS,qBAAA,CAAA,CAAoB;AAAA,IAAA;AAAA,EAAA,GAElC;AAEJ;"}

package/dist/components/ScrollTopButton/index.d.ts

@@ -0,0 +1,4 @@
+export { ScrollTopButton, default } from './ScrollTopButton';
+export type { ScrollTopButtonProps, ScrollTopButtonPosition, } from './ScrollTopButton';
+export { scrollToTop } from './scrollToTop';
+export type { ScrollToTopOptions } from './scrollToTop';

package/dist/components/ScrollTopButton/scrollToTop.d.ts

@@ -0,0 +1,29 @@
+export interface ScrollToTopOptions {
+    /** Comportamiento del scroll. Default: `'smooth'`. */
+    behavior?: ScrollBehavior;
+    /**
+     * Elemento target del scroll. Default: `window`. Útil cuando el contenedor
+     * scrolleable NO es `window` (p.ej. un `<Box>` con `overflow: auto`).
+     */
+    target?: Window | HTMLElement;
+    /** Offset desde el top. Default: `0`. */
+    top?: number;
+}
+/**
+ * Reemplaza imperativamente a `ScrollTopComponent.goTop()` de Metronic.
+ *
+ * Llamar tras mutaciones / cambios de filtros / apertura de modales para
+ * asegurar que el usuario vea el mensaje de confirmación en la parte
+ * superior de la página.
+ *
+ * ```ts
+ * // Reemplazo directo del legacy:
+ * // Antes: ScrollTopComponent.goTop()
+ * scrollToTop();
+ *
+ * // Con opciones:
+ * scrollToTop({ behavior: 'auto' });
+ * scrollToTop({ target: myScrollableRef.current });
+ * ```
+ */
+export declare function scrollToTop({ behavior, target, top, }?: ScrollToTopOptions): void;

package/dist/components/ScrollTopButton.d.ts

@@ -0,0 +1,6 @@
+export * from './ScrollTopButton/index'
+export {}
+import _default from './ScrollTopButton/index'
+export default _default
+export * from './ScrollTopButton/index'
+export {}