@soyfri/shared-library 4.0.2 → 4.1.0

package/components/Drawer/Drawer.d.ts

@@ -54,5 +54,5 @@ export interface DrawerProps {
     paperSx?: SxProps<Theme>;
     className?: string;
 }
-export declare function Drawer({ children, variant, anchor, collapsed, onToggleCollapse, open, onClose, expandedWidth, collapsedWidth, showCollapseButton, header, logo, footer, preset, sx, paperSx, className, }: DrawerProps): import("react/jsx-runtime").JSX.Element;
+export declare const Drawer: import('react').ForwardRefExoticComponent<DrawerProps & import('react').RefAttributes<HTMLDivElement>>;
 export default Drawer;

package/components/Drawer/Drawer.sx.d.cts

@@ -0,0 +1,28 @@
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
+export interface BuildDrawerSxArgs {
+    /** Ancho actual del drawer (expanded o collapsed). */
+    width: number;
+    /** Duración de la transición de ancho en ms. */
+    transitionDuration?: number;
+}
+/**
+ * Estilo de fábrica del Drawer, en CSS real (para `styled()`). Controla el
+ * ancho animado y el paper interno; lo visual del paper (background, border)
+ * queda en manos del theme.
+ */
+export declare function buildDrawerStyles(theme: Theme, { width, transitionDuration }: BuildDrawerSxArgs): CSSObject;
+/**
+ * @deprecated El componente ya no lo usa: su estilo de fábrica vive en el
+ * `styled()`. Preferir `buildDrawerStyles`.
+ */
+export declare function buildDrawerSx({ width, transitionDuration, }: BuildDrawerSxArgs): SxProps<Theme>;
+export interface BuildDrawerItemSxArgs {
+    collapsed: boolean;
+    active?: boolean;
+    danger?: boolean;
+}
+/**
+ * sx para un item del drawer. Centra el icono cuando está colapsado y
+ * tiñe el fondo cuando el item está activo.
+ */
+export declare function buildDrawerItemSx({ collapsed, active, danger, }: BuildDrawerItemSxArgs): SxProps<Theme>;

package/components/Drawer/Drawer.sx.d.mts

@@ -0,0 +1,28 @@
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
+export interface BuildDrawerSxArgs {
+    /** Ancho actual del drawer (expanded o collapsed). */
+    width: number;
+    /** Duración de la transición de ancho en ms. */
+    transitionDuration?: number;
+}
+/**
+ * Estilo de fábrica del Drawer, en CSS real (para `styled()`). Controla el
+ * ancho animado y el paper interno; lo visual del paper (background, border)
+ * queda en manos del theme.
+ */
+export declare function buildDrawerStyles(theme: Theme, { width, transitionDuration }: BuildDrawerSxArgs): CSSObject;
+/**
+ * @deprecated El componente ya no lo usa: su estilo de fábrica vive en el
+ * `styled()`. Preferir `buildDrawerStyles`.
+ */
+export declare function buildDrawerSx({ width, transitionDuration, }: BuildDrawerSxArgs): SxProps<Theme>;
+export interface BuildDrawerItemSxArgs {
+    collapsed: boolean;
+    active?: boolean;
+    danger?: boolean;
+}
+/**
+ * sx para un item del drawer. Centra el icono cuando está colapsado y
+ * tiñe el fondo cuando el item está activo.
+ */
+export declare function buildDrawerItemSx({ collapsed, active, danger, }: BuildDrawerItemSxArgs): SxProps<Theme>;

package/components/Drawer/Drawer.sx.d.ts

@@ -1,4 +1,4 @@
-import { SxProps, Theme } from '@mui/material/styles';
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
 export interface BuildDrawerSxArgs {
     /** Ancho actual del drawer (expanded o collapsed). */
     width: number;
@@ -6,9 +6,14 @@ export interface BuildDrawerSxArgs {
     transitionDuration?: number;
 }
 /**
- * sx aplicado al root del MuiDrawer. Controla el ancho animado y el paper
- * interno. Los estilos visuales del paper (background, border) se dejan en
- * manos del theme / preset.
+ * Estilo de fábrica del Drawer, en CSS real (para `styled()`). Controla el
+ * ancho animado y el paper interno; lo visual del paper (background, border)
+ * queda en manos del theme.
+ */
+export declare function buildDrawerStyles(theme: Theme, { width, transitionDuration }: BuildDrawerSxArgs): CSSObject;
+/**
+ * @deprecated El componente ya no lo usa: su estilo de fábrica vive en el
+ * `styled()`. Preferir `buildDrawerStyles`.
  */
 export declare function buildDrawerSx({ width, transitionDuration, }: BuildDrawerSxArgs): SxProps<Theme>;
 export interface BuildDrawerItemSxArgs {

package/components/Drawer/DrawerContext.d.cts

@@ -0,0 +1,18 @@
+/**
+ * Context interno del Drawer. Permite que los sub-componentes (DrawerItem,
+ * DrawerSection, etc.) reaccionen al estado `collapsed` sin necesidad de
+ * recibirlo por props explícitas.
+ */
+export interface DrawerContextValue {
+    /** Si el drawer está en modo mini (solo iconos). */
+    collapsed: boolean;
+    /** Ancho actual del drawer (útil para sub-componentes que necesiten layout). */
+    width: number;
+}
+export declare const DrawerContext: import('react').Context<DrawerContextValue | null>;
+/**
+ * Hook para leer el estado del drawer desde cualquier sub-componente. Si se
+ * llama fuera de un `<Drawer>`, devuelve valores por defecto (collapsed=false)
+ * para que los items renderizados sueltos no exploten.
+ */
+export declare function useDrawerContext(): DrawerContextValue;

package/components/Drawer/DrawerContext.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Context interno del Drawer. Permite que los sub-componentes (DrawerItem,
+ * DrawerSection, etc.) reaccionen al estado `collapsed` sin necesidad de
+ * recibirlo por props explícitas.
+ */
+export interface DrawerContextValue {
+    /** Si el drawer está en modo mini (solo iconos). */
+    collapsed: boolean;
+    /** Ancho actual del drawer (útil para sub-componentes que necesiten layout). */
+    width: number;
+}
+export declare const DrawerContext: import('react').Context<DrawerContextValue | null>;
+/**
+ * Hook para leer el estado del drawer desde cualquier sub-componente. Si se
+ * llama fuera de un `<Drawer>`, devuelve valores por defecto (collapsed=false)
+ * para que los items renderizados sueltos no exploten.
+ */
+export declare function useDrawerContext(): DrawerContextValue;

package/components/Drawer/DrawerItem.d.cts

@@ -0,0 +1,40 @@
+import { ReactNode, MouseEvent } from 'react';
+import { SxProps, Theme } from '@mui/material/styles';
+export interface DrawerItemProps {
+    /** Icono del item. Se muestra siempre (expanded y collapsed). */
+    icon?: ReactNode;
+    /** Texto del item. Se oculta cuando el drawer está colapsado (muestra tooltip). */
+    label: ReactNode;
+    /**
+     * Texto del tooltip en modo collapsed. Si no se provee y `label` es string,
+     * se usa `label`. Necesario cuando `label` es un ReactNode complejo.
+     */
+    tooltipText?: string;
+    /** Handler de click. */
+    onClick?: (event: MouseEvent<HTMLDivElement>) => void;
+    /** Marca el item como activo (destaca color y fondo). */
+    active?: boolean;
+    /** Marca el item como "destructivo" (p.ej. cerrar sesión): color error. */
+    danger?: boolean;
+    /** Deshabilita click + bajo opacidad. */
+    disabled?: boolean;
+    /** Contenido adicional a la derecha del label (badge, count, chevron). */
+    endAdornment?: ReactNode;
+    /** sx override del consumer, se mergea al final. */
+    sx?: SxProps<Theme>;
+    className?: string;
+}
+/**
+ * Item de un Drawer de shared-library. Lee el estado `collapsed` del
+ * DrawerContext para adaptar layout y mostrar tooltip en modo mini.
+ *
+ * Uso típico:
+ * ```tsx
+ * <Drawer collapsed={collapsed} onToggleCollapse={toggle}>
+ *   <DrawerItem icon={<HomeIcon />} label="Inicio" active />
+ *   <DrawerItem icon={<UserIcon />} label="Perfil" />
+ * </Drawer>
+ * ```
+ */
+export declare function DrawerItem({ icon, label, tooltipText, onClick, active, danger, disabled, endAdornment, sx, className, }: DrawerItemProps): import("react/jsx-runtime").JSX.Element;
+export default DrawerItem;

package/components/Drawer/DrawerItem.d.mts

@@ -0,0 +1,40 @@
+import { ReactNode, MouseEvent } from 'react';
+import { SxProps, Theme } from '@mui/material/styles';
+export interface DrawerItemProps {
+    /** Icono del item. Se muestra siempre (expanded y collapsed). */
+    icon?: ReactNode;
+    /** Texto del item. Se oculta cuando el drawer está colapsado (muestra tooltip). */
+    label: ReactNode;
+    /**
+     * Texto del tooltip en modo collapsed. Si no se provee y `label` es string,
+     * se usa `label`. Necesario cuando `label` es un ReactNode complejo.
+     */
+    tooltipText?: string;
+    /** Handler de click. */
+    onClick?: (event: MouseEvent<HTMLDivElement>) => void;
+    /** Marca el item como activo (destaca color y fondo). */
+    active?: boolean;
+    /** Marca el item como "destructivo" (p.ej. cerrar sesión): color error. */
+    danger?: boolean;
+    /** Deshabilita click + bajo opacidad. */
+    disabled?: boolean;
+    /** Contenido adicional a la derecha del label (badge, count, chevron). */
+    endAdornment?: ReactNode;
+    /** sx override del consumer, se mergea al final. */
+    sx?: SxProps<Theme>;
+    className?: string;
+}
+/**
+ * Item de un Drawer de shared-library. Lee el estado `collapsed` del
+ * DrawerContext para adaptar layout y mostrar tooltip en modo mini.
+ *
+ * Uso típico:
+ * ```tsx
+ * <Drawer collapsed={collapsed} onToggleCollapse={toggle}>
+ *   <DrawerItem icon={<HomeIcon />} label="Inicio" active />
+ *   <DrawerItem icon={<UserIcon />} label="Perfil" />
+ * </Drawer>
+ * ```
+ */
+export declare function DrawerItem({ icon, label, tooltipText, onClick, active, danger, disabled, endAdornment, sx, className, }: DrawerItemProps): import("react/jsx-runtime").JSX.Element;
+export default DrawerItem;

package/components/Drawer/index.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const DrawerItem = require("../../chunks/DrawerItem-BX8llYa3.cjs");
+exports.Drawer = DrawerItem.Drawer;
+exports.DrawerItem = DrawerItem.DrawerItem;
+exports.default = DrawerItem.Drawer;
+exports.useDrawerContext = DrawerItem.useDrawerContext;
+//# sourceMappingURL=index.cjs.map

package/components/Drawer/index.cjs.map

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

package/components/Drawer/index.d.cts

@@ -0,0 +1,6 @@
+export { Drawer, default } from './Drawer';
+export { DrawerItem } from './DrawerItem';
+export { useDrawerContext } from './DrawerContext';
+export type { DrawerProps, DrawerVariant, DrawerAnchor, } from './Drawer';
+export type { DrawerItemProps } from './DrawerItem';
+export type { DrawerContextValue } from './DrawerContext';

package/components/Drawer/index.d.mts

@@ -0,0 +1,6 @@
+export { Drawer, default } from './Drawer.mjs';
+export { DrawerItem } from './DrawerItem.mjs';
+export { useDrawerContext } from './DrawerContext.mjs';
+export type { DrawerProps, DrawerVariant, DrawerAnchor, } from './Drawer.mjs';
+export type { DrawerItemProps } from './DrawerItem.mjs';
+export type { DrawerContextValue } from './DrawerContext.mjs';

package/components/Drawer/index.mjs

@@ -0,0 +1,8 @@
+import { D, a, D as D2, u } from "../../chunks/DrawerItem-BaLZe-DV.mjs";
+export {
+  D as Drawer,
+  a as DrawerItem,
+  D2 as default,
+  u as useDrawerContext
+};
+//# sourceMappingURL=index.mjs.map

package/components/Drawer/index.mjs.map

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

package/components/Drawer.d.cts

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

package/components/Drawer.d.mts

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

package/components/EmptyState/EmptyState.d.cts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+import { BoxProps, TypographyProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface EmptyStateSlotProps {
+    /** El `Typography` del título. */
+    title?: Partial<TypographyProps>;
+    /** El `Typography` del mensaje secundario. */
+    message?: Partial<TypographyProps>;
+    /** El `Box` que envuelve la acción. */
+    action?: Partial<BoxProps>;
+}
+export interface EmptyStateProps extends Omit<BoxProps, 'title' | 'children'> {
+    /** Qué falta, en positivo: "Sin dispositivos registrados". */
+    title: string;
+    /** Línea secundaria opcional: qué puede hacer el usuario. */
+    message?: string;
+    /** Icono o ilustración arriba del título. */
+    icon?: ReactNode;
+    /** Acción opcional (botón) debajo del mensaje. */
+    action?: ReactNode;
+    /**
+     * @deprecated Usar `theme.components.FriEmptyState.styleOverrides` /
+     * `variants` — la API nativa de MUI.
+     */
+    preset?: string;
+    /** Props para los nodos internos. `className` y `sx` se acumulan. */
+    slotProps?: EmptyStateSlotProps;
+    sx?: SxProps<Theme>;
+}
+/**
+ * Estado vacío centrado, para usar dentro de una card, un tab o una tabla sin
+ * resultados. Color y tipografía salen del theme del consumidor: no hay
+ * hex ni tamaños hardcodeados.
+ */
+export declare const EmptyState: import('react').ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default EmptyState;

package/components/EmptyState/EmptyState.d.mts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+import { BoxProps, TypographyProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface EmptyStateSlotProps {
+    /** El `Typography` del título. */
+    title?: Partial<TypographyProps>;
+    /** El `Typography` del mensaje secundario. */
+    message?: Partial<TypographyProps>;
+    /** El `Box` que envuelve la acción. */
+    action?: Partial<BoxProps>;
+}
+export interface EmptyStateProps extends Omit<BoxProps, 'title' | 'children'> {
+    /** Qué falta, en positivo: "Sin dispositivos registrados". */
+    title: string;
+    /** Línea secundaria opcional: qué puede hacer el usuario. */
+    message?: string;
+    /** Icono o ilustración arriba del título. */
+    icon?: ReactNode;
+    /** Acción opcional (botón) debajo del mensaje. */
+    action?: ReactNode;
+    /**
+     * @deprecated Usar `theme.components.FriEmptyState.styleOverrides` /
+     * `variants` — la API nativa de MUI.
+     */
+    preset?: string;
+    /** Props para los nodos internos. `className` y `sx` se acumulan. */
+    slotProps?: EmptyStateSlotProps;
+    sx?: SxProps<Theme>;
+}
+/**
+ * Estado vacío centrado, para usar dentro de una card, un tab o una tabla sin
+ * resultados. Color y tipografía salen del theme del consumidor: no hay
+ * hex ni tamaños hardcodeados.
+ */
+export declare const EmptyState: import('react').ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default EmptyState;

package/components/EmptyState/EmptyState.d.ts

@@ -1,6 +1,16 @@
 import { ReactNode } from 'react';
+import { BoxProps, TypographyProps } from '@mui/material';
 import { SxProps, Theme } from '@mui/material/styles';
-export interface EmptyStateProps {
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface EmptyStateSlotProps {
+    /** El `Typography` del título. */
+    title?: Partial<TypographyProps>;
+    /** El `Typography` del mensaje secundario. */
+    message?: Partial<TypographyProps>;
+    /** El `Box` que envuelve la acción. */
+    action?: Partial<BoxProps>;
+}
+export interface EmptyStateProps extends Omit<BoxProps, 'title' | 'children'> {
     /** Qué falta, en positivo: "Sin dispositivos registrados". */
     title: string;
     /** Línea secundaria opcional: qué puede hacer el usuario. */
@@ -9,16 +19,19 @@ export interface EmptyStateProps {
     icon?: ReactNode;
     /** Acción opcional (botón) debajo del mensaje. */
     action?: ReactNode;
-    /** Preset registrado en `theme.styles.EmptyState`. */
+    /**
+     * @deprecated Usar `theme.components.FriEmptyState.styleOverrides` /
+     * `variants` — la API nativa de MUI.
+     */
     preset?: string;
+    /** Props para los nodos internos. `className` y `sx` se acumulan. */
+    slotProps?: EmptyStateSlotProps;
     sx?: SxProps<Theme>;
-    className?: string;
-    'data-testid'?: string;
 }
 /**
  * Estado vacío centrado, para usar dentro de una card, un tab o una tabla sin
  * resultados. Color y tipografía salen del theme del consumidor: no hay
  * hex ni tamaños hardcodeados.
  */
-export declare function EmptyState({ title, message, icon, action, preset, sx, className, 'data-testid': dataTestId, }: EmptyStateProps): import("react/jsx-runtime").JSX.Element;
+export declare const EmptyState: import('react').ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export default EmptyState;

package/components/EmptyState/index.cjs

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

package/components/EmptyState/index.cjs.map

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

package/components/EmptyState/index.d.cts

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

package/components/EmptyState/index.d.mts

@@ -0,0 +1,2 @@
+export { EmptyState, default } from './EmptyState.mjs';
+export type { EmptyStateProps } from './EmptyState.mjs';

package/components/EmptyState/index.mjs

@@ -0,0 +1,6 @@
+import { E, E as E2 } from "../../chunks/EmptyState-CVaRjXkT.mjs";
+export {
+  E as EmptyState,
+  E2 as default
+};
+//# sourceMappingURL=index.mjs.map

package/components/EmptyState/index.mjs.map

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

package/components/EmptyState.d.cts

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

package/components/EmptyState.d.mts

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

package/components/Flyout/Flyout.d.cts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+type FlyoutSize = 'small' | 'medium' | 'large';
+export interface FlyoutProps {
+    open: boolean;
+    onClose: () => void;
+    title?: string;
+    anchor?: 'left' | 'top' | 'right' | 'bottom';
+    children: React.ReactNode;
+    size?: FlyoutSize;
+    height?: string | number;
+}
+declare const Flyout: React.ForwardRefExoticComponent<FlyoutProps & React.RefAttributes<HTMLDivElement>>;
+export default Flyout;

package/components/Flyout/Flyout.d.mts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+type FlyoutSize = 'small' | 'medium' | 'large';
+export interface FlyoutProps {
+    open: boolean;
+    onClose: () => void;
+    title?: string;
+    anchor?: 'left' | 'top' | 'right' | 'bottom';
+    children: React.ReactNode;
+    size?: FlyoutSize;
+    height?: string | number;
+}
+declare const Flyout: React.ForwardRefExoticComponent<FlyoutProps & React.RefAttributes<HTMLDivElement>>;
+export default Flyout;

package/components/Flyout/Flyout.d.ts

@@ -9,5 +9,5 @@ export interface FlyoutProps {
     size?: FlyoutSize;
     height?: string | number;
 }
-declare const Flyout: React.FC<FlyoutProps>;
+declare const Flyout: React.ForwardRefExoticComponent<FlyoutProps & React.RefAttributes<HTMLDivElement>>;
 export default Flyout;

package/components/Flyout/index.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const Flyout = require("../../chunks/Flyout-CVH3IASy.cjs");
+exports.Flyout = Flyout.Flyout;
+//# sourceMappingURL=index.cjs.map

package/components/Flyout/index.cjs.map

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

package/components/Flyout/index.d.cts

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

package/components/Flyout/index.d.mts

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

package/components/Flyout/index.mjs

@@ -0,0 +1,5 @@
+import { F } from "../../chunks/Flyout-BSaOisD7.mjs";
+export {
+  F as Flyout
+};
+//# sourceMappingURL=index.mjs.map

package/components/Flyout/index.mjs.map

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

package/components/Flyout.d.cts

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

package/components/Flyout.d.mts

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

package/components/Gallery/Gallery.d.cts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+import { SxProps, Theme } from '@mui/material/styles';
+export interface GalleryItem {
+    url: string;
+    /**
+     * Tipo del item. Los literales `"image"` / `"video"` activan el render
+     * específico; cualquier otro string se trata como imagen por default.
+     */
+    type: 'image' | 'video' | (string & {});
+    title: string;
+    /** Si no se provee, se usa `url` como thumbnail. */
+    thumbnail?: string;
+}
+export interface GalleryProps {
+    items: GalleryItem[];
+    /** Ancho máximo del contenedor. Default: `'600px'`. */
+    maxWidth?: string | number;
+    /**
+     * Nombre del preset de estilo registrado en `theme.styles.Gallery`.
+     * - `"default"` (o ausente) = estilo built-in del paquete.
+     */
+    preset?: string;
+    /** sx del contenedor raíz. Se mergea después del preset. */
+    sx?: SxProps<Theme>;
+    className?: string;
+}
+export declare const Gallery: React.ForwardRefExoticComponent<GalleryProps & React.RefAttributes<HTMLDivElement>>;
+export default Gallery;

package/components/Gallery/Gallery.d.mts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+import { SxProps, Theme } from '@mui/material/styles';
+export interface GalleryItem {
+    url: string;
+    /**
+     * Tipo del item. Los literales `"image"` / `"video"` activan el render
+     * específico; cualquier otro string se trata como imagen por default.
+     */
+    type: 'image' | 'video' | (string & {});
+    title: string;
+    /** Si no se provee, se usa `url` como thumbnail. */
+    thumbnail?: string;
+}
+export interface GalleryProps {
+    items: GalleryItem[];
+    /** Ancho máximo del contenedor. Default: `'600px'`. */
+    maxWidth?: string | number;
+    /**
+     * Nombre del preset de estilo registrado en `theme.styles.Gallery`.
+     * - `"default"` (o ausente) = estilo built-in del paquete.
+     */
+    preset?: string;
+    /** sx del contenedor raíz. Se mergea después del preset. */
+    sx?: SxProps<Theme>;
+    className?: string;
+}
+export declare const Gallery: React.ForwardRefExoticComponent<GalleryProps & React.RefAttributes<HTMLDivElement>>;
+export default Gallery;

package/components/Gallery/Gallery.d.ts

@@ -24,5 +24,5 @@ export interface GalleryProps {
     sx?: SxProps<Theme>;
     className?: string;
 }
-export declare const Gallery: React.FC<GalleryProps>;
+export declare const Gallery: React.ForwardRefExoticComponent<GalleryProps & React.RefAttributes<HTMLDivElement>>;
 export default Gallery;

package/components/Gallery/Gallery.definition.d.cts

@@ -0,0 +1 @@
+export declare const DefaultGalleryDefinition: string;

package/components/Gallery/Gallery.definition.d.mts

@@ -0,0 +1 @@
+export declare const DefaultGalleryDefinition: string;

package/components/Gallery/GalleryLightbox.d.cts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { GalleryItem } from './Gallery';
+interface Props {
+    open: boolean;
+    onClose: () => void;
+    item: GalleryItem;
+    onPrev: () => void;
+    onNext: () => void;
+    zoom: number;
+    setZoom: React.Dispatch<React.SetStateAction<number>>;
+    rotation: number;
+    setRotation: React.Dispatch<React.SetStateAction<number>>;
+    videoRef?: React.RefObject<HTMLVideoElement | null>;
+}
+export declare const GalleryLightbox: ({ open, onClose, item, onPrev, onNext, zoom, setZoom, rotation, setRotation, videoRef, }: Props) => import("react/jsx-runtime").JSX.Element;
+export default GalleryLightbox;

package/components/Gallery/GalleryLightbox.d.mts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { GalleryItem } from './Gallery.mjs';
+interface Props {
+    open: boolean;
+    onClose: () => void;
+    item: GalleryItem;
+    onPrev: () => void;
+    onNext: () => void;
+    zoom: number;
+    setZoom: React.Dispatch<React.SetStateAction<number>>;
+    rotation: number;
+    setRotation: React.Dispatch<React.SetStateAction<number>>;
+    videoRef?: React.RefObject<HTMLVideoElement | null>;
+}
+export declare const GalleryLightbox: ({ open, onClose, item, onPrev, onNext, zoom, setZoom, rotation, setRotation, videoRef, }: Props) => import("react/jsx-runtime").JSX.Element;
+export default GalleryLightbox;

package/components/Gallery/GalleryMain.d.cts

@@ -0,0 +1,8 @@
+import { GalleryItem } from './Gallery';
+interface Props {
+    item: GalleryItem;
+    onOpenLightbox: () => void;
+    isMobile: boolean;
+}
+export declare const GalleryMain: ({ item, onOpenLightbox, isMobile }: Props) => import("react/jsx-runtime").JSX.Element;
+export default GalleryMain;

package/components/Gallery/GalleryMain.d.mts

@@ -0,0 +1,8 @@
+import { GalleryItem } from './Gallery.mjs';
+interface Props {
+    item: GalleryItem;
+    onOpenLightbox: () => void;
+    isMobile: boolean;
+}
+export declare const GalleryMain: ({ item, onOpenLightbox, isMobile }: Props) => import("react/jsx-runtime").JSX.Element;
+export default GalleryMain;