@soyfri/shared-library 2.0.0-beta.4 → 2.0.0-beta.5

package/src/components/ActionMenu/ActionMenu.tsx

@@ -1,174 +0,0 @@
-import React, { useState, type ReactNode, type MouseEvent } from 'react';
-import {
-  IconButton,
-  Menu,
-  MenuItem,
-  ListItemIcon,
-  ListItemText,
-  Divider,
-  Tooltip,
-} from '@mui/material';
-import MoreVertIcon from '@mui/icons-material/MoreVert';
-import type { SxProps, Theme } from '@mui/material/styles';
-
-export interface ActionMenuItem {
-  /** Key única para React. Si no se provee, se usa el label. */
-  key?: string;
-  /** Texto del item. */
-  label: ReactNode;
-  /** Icono opcional a la izquierda. */
-  icon?: ReactNode;
-  /** Handler de click. Recibe el evento del MenuItem. */
-  onClick?: (event: MouseEvent<HTMLLIElement>) => void;
-  /** Deshabilita el item. */
-  disabled?: boolean;
-  /** Marca el item como destructivo (pinta color error). */
-  danger?: boolean;
-  /** Inserta un `<Divider />` ANTES de este item. */
-  dividerBefore?: boolean;
-}
-
-export interface ActionMenuProps {
-  /** Lista de items del menú. */
-  items: ActionMenuItem[];
-  /**
-   * Elemento trigger. Si no se provee, se renderiza un IconButton con icono
-   * de tres puntos (MoreVertIcon) — el patrón típico de celda de tabla.
-   */
-  trigger?: ReactNode;
-  /** Texto de tooltip sobre el trigger default. Default: "Acciones". */
-  triggerTooltip?: string;
-  /** Anchor origin del menu. Default: { vertical: 'bottom', horizontal: 'right' }. */
-  anchorOrigin?: {
-    vertical: 'top' | 'center' | 'bottom';
-    horizontal: 'left' | 'center' | 'right';
-  };
-  /** Transform origin del menu. Default: { vertical: 'top', horizontal: 'right' }. */
-  transformOrigin?: {
-    vertical: 'top' | 'center' | 'bottom';
-    horizontal: 'left' | 'center' | 'right';
-  };
-  /** sx del Menu (Paper interno). */
-  menuSx?: SxProps<Theme>;
-  /** Deshabilita el trigger entero. */
-  disabled?: boolean;
-  className?: string;
-}
-
-/**
- * Menú de acciones compacto, pensado para celdas de tabla y cabeceras.
- * Reemplaza los patrones `<Dropdown>` de react-bootstrap.
- *
- * ```tsx
- * <ActionMenu
- *   items={[
- *     { label: 'Editar', icon: <EditIcon />, onClick: handleEdit },
- *     { label: 'Duplicar', icon: <CopyIcon />, onClick: handleDup },
- *     { label: 'Eliminar', icon: <TrashIcon />, onClick: handleDel, danger: true, dividerBefore: true },
- *   ]}
- * />
- * ```
- */
-export function ActionMenu({
-  items,
-  trigger,
-  triggerTooltip = 'Acciones',
-  anchorOrigin = { vertical: 'bottom', horizontal: 'right' },
-  transformOrigin = { vertical: 'top', horizontal: 'right' },
-  menuSx,
-  disabled = false,
-  className,
-}: ActionMenuProps) {
-  const [anchorEl, setAnchorEl] = useState<HTMLElement | null>(null);
-  const open = Boolean(anchorEl);
-
-  const handleOpen = (event: MouseEvent<HTMLElement>) => {
-    if (disabled) return;
-    event.stopPropagation();
-    setAnchorEl(event.currentTarget);
-  };
-
-  const handleClose = () => setAnchorEl(null);
-
-  const handleItemClick = (
-    event: MouseEvent<HTMLLIElement>,
-    item: ActionMenuItem,
-  ) => {
-    event.stopPropagation();
-    item.onClick?.(event);
-    handleClose();
-  };
-
-  const triggerElement = trigger ? (
-    React.isValidElement(trigger) ? (
-      React.cloneElement(trigger as React.ReactElement<any>, {
-        onClick: handleOpen,
-        disabled,
-      })
-    ) : (
-      <span onClick={handleOpen}>{trigger}</span>
-    )
-  ) : (
-    <Tooltip title={triggerTooltip} arrow>
-      <span>
-        <IconButton
-          size="small"
-          onClick={handleOpen}
-          disabled={disabled}
-          aria-label={triggerTooltip}
-        >
-          <MoreVertIcon fontSize="small" />
-        </IconButton>
-      </span>
-    </Tooltip>
-  );
-
-  return (
-    <span className={className}>
-      {triggerElement}
-      <Menu
-        anchorEl={anchorEl}
-        open={open}
-        onClose={handleClose}
-        anchorOrigin={anchorOrigin}
-        transformOrigin={transformOrigin}
-        slotProps={{ paper: { sx: { minWidth: 180, ...(menuSx as any) } } }}
-      >
-        {items.map((item, idx) => {
-          const key = item.key ?? `${String(item.label)}-${idx}`;
-          const node = (
-            <MenuItem
-              key={key}
-              disabled={item.disabled}
-              onClick={(event) => handleItemClick(event, item)}
-              sx={(theme) => ({
-                color: item.danger ? theme.palette.error.main : 'inherit',
-                '& .MuiListItemIcon-root': {
-                  color: item.danger
-                    ? theme.palette.error.main
-                    : 'inherit',
-                  minWidth: 32,
-                },
-              })}
-            >
-              {item.icon && <ListItemIcon>{item.icon}</ListItemIcon>}
-              <ListItemText primary={item.label} />
-            </MenuItem>
-          );
-
-          if (item.dividerBefore && idx > 0) {
-            return (
-              <React.Fragment key={`${key}-frag`}>
-                <Divider />
-                {node}
-              </React.Fragment>
-            );
-          }
-          return node;
-        })}
-      </Menu>
-    </span>
-  );
-}
-
-export default ActionMenu;

package/src/components/ActionMenu/index.ts

@@ -1,2 +0,0 @@
-export { ActionMenu, default } from './ActionMenu';
-export type { ActionMenuProps, ActionMenuItem } from './ActionMenu';

package/src/components/AppBar/AppBar.stories.tsx

@@ -1,272 +0,0 @@
-import React, { useState } from 'react';
-import type { Meta, StoryObj } from '@storybook/react';
-import { Box, Typography, Button, IconButton, Tooltip } from '@mui/material';
-import NotificationsIcon from '@mui/icons-material/Notifications';
-import HelpOutlineIcon from '@mui/icons-material/HelpOutline';
-import PersonIcon from '@mui/icons-material/Person';
-import SettingsIcon from '@mui/icons-material/Settings';
-import LogoutIcon from '@mui/icons-material/Logout';
-import DashboardIcon from '@mui/icons-material/Dashboard';
-
-import { AppBar } from './AppBar';
-import { AppBarBrand } from './AppBarBrand';
-import { AppBarMenuToggle } from './AppBarMenuToggle';
-import { AppBarUserMenu } from './AppBarUserMenu';
-
-const meta: Meta<typeof AppBar> = {
-  title: 'Components/AppBar',
-  component: AppBar,
-  tags: ['autodocs'],
-  parameters: {
-    layout: 'fullscreen',
-    docs: {
-      description: {
-        component:
-          'AppBar (header superior) pensado como shell compositivo. El consumer arma su contenido con los sub-componentes `AppBarBrand`, `AppBarMenuToggle` y `AppBarUserMenu`, además de cualquier acción custom. Reemplaza el header de Metronic.',
-      },
-    },
-  },
-  argTypes: {
-    position: {
-      control: 'select',
-      options: ['fixed', 'sticky', 'static', 'absolute', 'relative'],
-    },
-    color: {
-      control: 'select',
-      options: ['default', 'primary', 'secondary', 'transparent', 'inherit'],
-    },
-    elevation: { control: { type: 'number', min: 0, max: 24, step: 1 } },
-    height: { control: { type: 'number', min: 48, max: 96, step: 4 } },
-  },
-};
-
-export default meta;
-type Story = StoryObj<typeof AppBar>;
-
-// ── Helpers ──────────────────────────────────────────────────────────────
-
-const SampleLogo = () => (
-  <Box
-    sx={{
-      width: 32,
-      height: 32,
-      borderRadius: 1,
-      display: 'flex',
-      alignItems: 'center',
-      justifyContent: 'center',
-      backgroundColor: 'primary.main',
-      color: 'primary.contrastText',
-      fontWeight: 700,
-      fontSize: 14,
-    }}
-  >
-    F
-  </Box>
-);
-
-const SampleBody = () => (
-  <Box sx={{ p: 3 }}>
-    <Typography variant="h5" gutterBottom>
-      Contenido de la página
-    </Typography>
-    <Typography variant="body2" color="text.secondary" sx={{ mb: 2 }}>
-      Este bloque sólo demuestra el layout bajo el AppBar.
-    </Typography>
-    {Array.from({ length: 20 }).map((_, idx) => (
-      <Typography key={idx} variant="body2" sx={{ mb: 1 }}>
-        Línea {idx + 1} — contenido de ejemplo para scroll sticky.
-      </Typography>
-    ))}
-  </Box>
-);
-
-const userMenuItems = [
-  {
-    label: 'Mi perfil',
-    icon: <PersonIcon fontSize="small" />,
-    onClick: () => console.log('profile'),
-  },
-  {
-    label: 'Configuración',
-    icon: <SettingsIcon fontSize="small" />,
-    onClick: () => console.log('settings'),
-  },
-  {
-    label: 'Cerrar sesión',
-    icon: <LogoutIcon fontSize="small" />,
-    onClick: () => console.log('logout'),
-    danger: true,
-    dividerBefore: true,
-  },
-];
-
-// ── Stories ──────────────────────────────────────────────────────────────
-
-export const BasicHeader: Story = {
-  args: {
-    position: 'sticky',
-    color: 'default',
-    elevation: 1,
-    height: 64,
-  },
-  render: (args) => (
-    <>
-      <AppBar {...args}>
-        <AppBarBrand
-          logo={<SampleLogo />}
-          title="Afiliaciones"
-          subtitle="Panel administrativo"
-        />
-      </AppBar>
-      <SampleBody />
-    </>
-  ),
-};
-
-export const WithMenuToggle: Story = {
-  render: (args) => {
-    const [open, setOpen] = useState(false);
-    return (
-      <>
-        <AppBar
-          {...args}
-          onMenuToggle={() => setOpen((value) => !value)}
-          menuOpen={open}
-        >
-          <AppBarMenuToggle />
-          <AppBarBrand logo={<SampleLogo />} title="Afiliaciones" />
-        </AppBar>
-        <Box sx={{ p: 3 }}>
-          <Typography variant="body2">
-            Drawer {open ? 'abierto' : 'cerrado'} — el icono cambia según el
-            estado. Click en el botón hamburguesa para alternar.
-          </Typography>
-        </Box>
-      </>
-    );
-  },
-};
-
-export const WithUserMenu: Story = {
-  render: (args) => (
-    <>
-      <AppBar {...args}>
-        <AppBarBrand logo={<SampleLogo />} title="Afiliaciones" />
-        <Box sx={{ flex: 1 }} />
-        <AppBarUserMenu
-          user={{
-            name: 'Andrea Pineda',
-            email: 'andrea@soyfri.com',
-          }}
-          items={userMenuItems}
-        />
-      </AppBar>
-      <SampleBody />
-    </>
-  ),
-};
-
-export const CompleteDashboardHeader: Story = {
-  render: (args) => {
-    const [open, setOpen] = useState(true);
-    return (
-      <>
-        <AppBar
-          {...args}
-          onMenuToggle={() => setOpen((value) => !value)}
-          menuOpen={open}
-        >
-          <AppBarMenuToggle />
-          <AppBarBrand
-            logo={<SampleLogo />}
-            title="Afiliaciones"
-            subtitle="Panel administrativo"
-            onClick={() => console.log('go home')}
-          />
-          <Box sx={{ flex: 1 }} />
-          <Tooltip title="Notificaciones" arrow>
-            <IconButton color="inherit">
-              <NotificationsIcon />
-            </IconButton>
-          </Tooltip>
-          <Tooltip title="Ayuda" arrow>
-            <IconButton color="inherit">
-              <HelpOutlineIcon />
-            </IconButton>
-          </Tooltip>
-          <AppBarUserMenu
-            user={{
-              name: 'Andrea Pineda',
-              email: 'andrea@soyfri.com',
-            }}
-            items={userMenuItems}
-          />
-        </AppBar>
-        <SampleBody />
-      </>
-    );
-  },
-};
-
-export const TransparentVariant: Story = {
-  args: {
-    color: 'transparent',
-    elevation: 0,
-  },
-  render: (args) => (
-    <Box
-      sx={{
-        minHeight: '100vh',
-        background:
-          'linear-gradient(135deg, #f0f4ff 0%, #e6f7ff 50%, #fff5f5 100%)',
-      }}
-    >
-      <AppBar {...args}>
-        <AppBarBrand logo={<SampleLogo />} title="Afiliaciones" />
-        <Box sx={{ flex: 1 }} />
-        <Button variant="contained" color="primary" size="small">
-          Iniciar sesión
-        </Button>
-      </AppBar>
-      <Box sx={{ p: 3 }}>
-        <Typography variant="h5">Landing page transparente</Typography>
-        <Typography variant="body2" color="text.secondary">
-          Sin sombra, con borde sutil — útil para headers sobre hero sections.
-        </Typography>
-      </Box>
-    </Box>
-  ),
-};
-
-export const PrimaryColorWithMenu: Story = {
-  args: {
-    color: 'primary',
-  },
-  render: (args) => {
-    const [open, setOpen] = useState(false);
-    return (
-      <>
-        <AppBar
-          {...args}
-          onMenuToggle={() => setOpen((value) => !value)}
-          menuOpen={open}
-        >
-          <AppBarMenuToggle />
-          <DashboardIcon sx={{ mr: 1 }} />
-          <Typography variant="h6" sx={{ fontWeight: 700 }}>
-            Dashboard
-          </Typography>
-          <Box sx={{ flex: 1 }} />
-          <AppBarUserMenu
-            user={{
-              name: 'Andrea Pineda',
-              email: 'andrea@soyfri.com',
-            }}
-            items={userMenuItems}
-          />
-        </AppBar>
-        <SampleBody />
-      </>
-    );
-  },
-};

package/src/components/AppBar/AppBar.sx.ts

@@ -1,32 +0,0 @@
-import type { SxProps, Theme } from '@mui/material/styles';
-
-export interface BuildAppBarSxArgs {
-  /** Altura en px. Default: 64. */
-  height?: number;
-  /** Color del AppBar (se pasa al MuiAppBar). */
-  transparent?: boolean;
-}
-
-/**
- * sx del root del MuiAppBar. Define altura fija y layout flex del Toolbar
- * interno. El color/elevación se dejan a las props nativas de MuiAppBar.
- */
-export function buildAppBarSx({
-  height = 64,
-  transparent = false,
-}: BuildAppBarSxArgs): SxProps<Theme> {
-  return (theme) => ({
-    minHeight: height,
-    justifyContent: 'center',
-    backgroundImage: 'none',
-    ...(transparent && {
-      backgroundColor: 'transparent',
-      boxShadow: 'none',
-      borderBottom: `1px solid ${theme.palette.divider}`,
-    }),
-    '& .MuiToolbar-root': {
-      minHeight: height,
-      gap: 1.5,
-    },
-  });
-}

package/src/components/AppBar/AppBar.tsx

@@ -1,123 +0,0 @@
-import React, { useMemo, type ReactNode } from 'react';
-import {
-  AppBar as MuiAppBar,
-  Toolbar,
-  type AppBarProps as MuiAppBarProps,
-} from '@mui/material';
-import {
-  useTheme,
-  type SxProps,
-  type Theme,
-} from '@mui/material/styles';
-
-import { AppBarContext } from './AppBarContext';
-import { buildAppBarSx } from './AppBar.sx';
-import { resolvePreset } from '../_shared/resolvePreset';
-
-export type AppBarPosition = 'fixed' | 'sticky' | 'static' | 'absolute' | 'relative';
-export type AppBarColor =
-  | 'default'
-  | 'primary'
-  | 'secondary'
-  | 'transparent'
-  | 'inherit';
-
-export interface AppBarProps {
-  /** Contenido del AppBar (típicamente sub-componentes + acciones custom). */
-  children?: ReactNode;
-  /** Posicionamiento. Default: `'sticky'`. */
-  position?: AppBarPosition;
-  /** Color. Default: `'default'`. */
-  color?: AppBarColor;
-  /** Nivel de sombra. Default: 1. */
-  elevation?: number;
-  /** Altura en px. Default: 64. */
-  height?: number;
-  /**
-   * Handler del botón hamburguesa. Se expone vía AppBarContext para que el
-   * sub-componente `<AppBarMenuToggle>` lo consuma sin prop drilling.
-   */
-  onMenuToggle?: () => void;
-  /** Estado del drawer asociado (para que el icono del toggle cambie). */
-  menuOpen?: boolean;
-  /**
-   * Nombre del preset de estilo registrado en `theme.styles.AppBar`.
-   * - `"default"` (o ausente) = estilo built-in del paquete.
-   */
-  preset?: string;
-  /** sx del root (se mergea después del preset). */
-  sx?: SxProps<Theme>;
-  /** sx del Toolbar interno. */
-  toolbarSx?: SxProps<Theme>;
-  className?: string;
-  /** Otras props nativas del MuiAppBar (ej. `enableColorOnDark`). */
-  appBarProps?: Omit<
-    MuiAppBarProps,
-    'position' | 'color' | 'elevation' | 'sx' | 'children' | 'className'
-  >;
-}
-
-/**
- * AppBar (header superior) del paquete. Se diseñó como un shell compositivo
- * — el consumer arma el contenido con los sub-componentes que exporta el
- * paquete (`AppBarBrand`, `AppBarMenuToggle`, `AppBarUserMenu`) + cualquier
- * otra cosa custom.
- *
- * Patrón recomendado para navegación en dashboards:
- *
- * ```tsx
- * <AppBar onMenuToggle={toggleDrawer}>
- *   <AppBarMenuToggle />
- *   <AppBarBrand logo={<Logo />} title="Afiliaciones" />
- *   <Box sx={{ flex: 1 }} />
- *   <AppBarUserMenu user={user} items={menuItems} />
- * </AppBar>
- * ```
- */
-export function AppBar({
-  children,
-  position = 'sticky',
-  color = 'default',
-  elevation = 1,
-  height = 64,
-  onMenuToggle,
-  menuOpen,
-  preset,
-  sx,
-  toolbarSx,
-  className,
-  appBarProps,
-}: AppBarProps) {
-  const theme = useTheme();
-  const presetSx = resolvePreset('AppBar', preset, theme);
-
-  const transparent = color === 'transparent';
-
-  const rootSx: SxProps<Theme> = [
-    buildAppBarSx({ height, transparent }),
-    ...(presetSx ? [presetSx] : []),
-    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),
-  ];
-
-  const contextValue = useMemo(
-    () => ({ onMenuToggle, menuOpen }),
-    [onMenuToggle, menuOpen],
-  );
-
-  return (
-    <AppBarContext.Provider value={contextValue}>
-      <MuiAppBar
-        position={position}
-        color={color === 'transparent' ? 'transparent' : color}
-        elevation={elevation}
-        className={className}
-        sx={rootSx}
-        {...appBarProps}
-      >
-        <Toolbar sx={toolbarSx}>{children}</Toolbar>
-      </MuiAppBar>
-    </AppBarContext.Provider>
-  );
-}
-
-export default AppBar;