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

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

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

package/dist/components/ActionMenu.d.ts

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

package/dist/components/AppBar/AppBar.cjs

@@ -0,0 +1,346 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+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 styles = require("@mui/material/styles");
+const resolvePreset = require("../../resolvePreset-CT3kU-K2.cjs");
+const MenuIcon = require("@mui/icons-material/Menu");
+const MenuOpenIcon = require("@mui/icons-material/MenuOpen");
+const AppBarContext = React.createContext(null);
+function useAppBarContext() {
+  const ctx = React.useContext(AppBarContext);
+  return ctx != null ? ctx : {};
+}
+function buildAppBarSx({
+  height = 64,
+  transparent = false
+}) {
+  return (theme) => __spreadProps(__spreadValues({
+    minHeight: height,
+    justifyContent: "center",
+    backgroundImage: "none"
+  }, transparent && {
+    backgroundColor: "transparent",
+    boxShadow: "none",
+    borderBottom: `1px solid ${theme.palette.divider}`
+  }), {
+    "& .MuiToolbar-root": {
+      minHeight: height,
+      gap: 1.5
+    }
+  });
+}
+function AppBar({
+  children,
+  position = "sticky",
+  color = "default",
+  elevation = 1,
+  height = 64,
+  onMenuToggle,
+  menuOpen,
+  preset,
+  sx,
+  toolbarSx,
+  className,
+  appBarProps
+}) {
+  const theme = styles.useTheme();
+  const presetSx = resolvePreset.resolvePreset("AppBar", preset, theme);
+  const transparent = color === "transparent";
+  const rootSx = [
+    buildAppBarSx({ height, transparent }),
+    ...presetSx ? [presetSx] : [],
+    ...Array.isArray(sx) ? sx : sx ? [sx] : []
+  ];
+  const contextValue = React.useMemo(
+    () => ({ onMenuToggle, menuOpen }),
+    [onMenuToggle, menuOpen]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(AppBarContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsxRuntime.jsx(
+    material.AppBar,
+    __spreadProps(__spreadValues({
+      position,
+      color: color === "transparent" ? "transparent" : color,
+      elevation,
+      className,
+      sx: rootSx
+    }, appBarProps), {
+      children: /* @__PURE__ */ jsxRuntime.jsx(material.Toolbar, { sx: toolbarSx, children })
+    })
+  ) });
+}
+function AppBarBrand({
+  logo,
+  title,
+  subtitle,
+  onClick,
+  hideTitleOnMobile = true,
+  sx,
+  className
+}) {
+  const clickable = !!onClick;
+  const rootSx = [
+    {
+      display: "flex",
+      alignItems: "center",
+      gap: 1.25,
+      cursor: clickable ? "pointer" : "default",
+      userSelect: "none",
+      minWidth: 0
+    },
+    ...Array.isArray(sx) ? sx : sx ? [sx] : []
+  ];
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    material.Box,
+    {
+      role: clickable ? "button" : void 0,
+      tabIndex: clickable ? 0 : void 0,
+      onClick,
+      onKeyDown: (event) => {
+        if (!clickable) return;
+        if (event.key === "Enter" || event.key === " ") {
+          event.preventDefault();
+          onClick == null ? void 0 : onClick(event);
+        }
+      },
+      className,
+      sx: rootSx,
+      children: [
+        logo && /* @__PURE__ */ jsxRuntime.jsx(
+          material.Box,
+          {
+            component: "span",
+            sx: {
+              display: "flex",
+              alignItems: "center",
+              flexShrink: 0
+            },
+            children: logo
+          }
+        ),
+        (title || subtitle) && /* @__PURE__ */ jsxRuntime.jsxs(
+          material.Box,
+          {
+            sx: {
+              display: hideTitleOnMobile ? { xs: "none", sm: "flex" } : "flex",
+              flexDirection: "column",
+              minWidth: 0,
+              lineHeight: 1.2
+            },
+            children: [
+              title && /* @__PURE__ */ jsxRuntime.jsx(
+                material.Typography,
+                {
+                  component: "span",
+                  variant: "subtitle1",
+                  noWrap: true,
+                  sx: { fontWeight: 700 },
+                  children: title
+                }
+              ),
+              subtitle && /* @__PURE__ */ jsxRuntime.jsx(
+                material.Typography,
+                {
+                  component: "span",
+                  variant: "caption",
+                  color: "text.secondary",
+                  noWrap: true,
+                  children: subtitle
+                }
+              )
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+function AppBarMenuToggle({
+  onClick,
+  menuOpen,
+  closedIcon,
+  openIcon,
+  tooltip = "Menú",
+  ariaLabel,
+  size = "medium",
+  hideIfNoHandler = true,
+  sx,
+  className
+}) {
+  var _a;
+  const ctx = useAppBarContext();
+  const handler = onClick != null ? onClick : ctx.onMenuToggle;
+  const open = (_a = menuOpen != null ? menuOpen : ctx.menuOpen) != null ? _a : false;
+  if (!handler && hideIfNoHandler) {
+    return null;
+  }
+  const icon = open ? openIcon != null ? openIcon : /* @__PURE__ */ jsxRuntime.jsx(MenuOpenIcon, {}) : closedIcon != null ? closedIcon : /* @__PURE__ */ jsxRuntime.jsx(MenuIcon, {});
+  return /* @__PURE__ */ jsxRuntime.jsx(material.Tooltip, { title: tooltip, arrow: true, children: /* @__PURE__ */ jsxRuntime.jsx("span", { children: /* @__PURE__ */ jsxRuntime.jsx(
+    material.IconButton,
+    {
+      size,
+      edge: "start",
+      color: "inherit",
+      "aria-label": ariaLabel != null ? ariaLabel : tooltip,
+      onClick: handler,
+      disabled: !handler,
+      className,
+      sx,
+      children: icon
+    }
+  ) }) });
+}
+function computeInitials(name) {
+  var _a, _b, _c, _d;
+  if (typeof name !== "string") return "?";
+  const parts = name.trim().split(/\s+/).filter(Boolean);
+  if (parts.length === 0) return "?";
+  const first = (_b = (_a = parts[0]) == null ? void 0 : _a.charAt(0)) != null ? _b : "";
+  const last = parts.length > 1 ? (_d = (_c = parts[parts.length - 1]) == null ? void 0 : _c.charAt(0)) != null ? _d : "" : "";
+  return (first + last).toUpperCase();
+}
+function AppBarUserMenu({
+  user,
+  items,
+  hideUserHeader = false,
+  triggerTooltip = "Cuenta",
+  avatarSize = 36,
+  menuSx,
+  triggerSx,
+  className
+}) {
+  var _a;
+  const [anchorEl, setAnchorEl] = React.useState(null);
+  const open = Boolean(anchorEl);
+  const handleOpen = (event) => {
+    setAnchorEl(event.currentTarget);
+  };
+  const handleClose = () => setAnchorEl(null);
+  const handleItemClick = (event, item) => {
+    var _a2;
+    event.stopPropagation();
+    (_a2 = item.onClick) == null ? void 0 : _a2.call(item, event);
+    handleClose();
+  };
+  const initials = (_a = user == null ? void 0 : user.initials) != null ? _a : computeInitials(user == null ? void 0 : user.name);
+  const showUserHeader = !hideUserHeader && ((user == null ? void 0 : user.name) || (user == null ? void 0 : user.email));
+  return /* @__PURE__ */ jsxRuntime.jsxs(material.Box, { component: "span", className, children: [
+    /* @__PURE__ */ jsxRuntime.jsx(material.Tooltip, { title: triggerTooltip, arrow: true, children: /* @__PURE__ */ jsxRuntime.jsx(
+      material.IconButton,
+      {
+        onClick: handleOpen,
+        size: "small",
+        "aria-label": triggerTooltip,
+        "aria-haspopup": "menu",
+        "aria-expanded": open || void 0,
+        sx: [{ p: 0.5 }, ...Array.isArray(triggerSx) ? triggerSx : triggerSx ? [triggerSx] : []],
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          material.Avatar,
+          {
+            src: user == null ? void 0 : user.avatarUrl,
+            sx: {
+              width: avatarSize,
+              height: avatarSize,
+              fontSize: avatarSize * 0.4,
+              fontWeight: 600
+            },
+            children: !(user == null ? void 0 : user.avatarUrl) && initials
+          }
+        )
+      }
+    ) }),
+    /* @__PURE__ */ jsxRuntime.jsxs(
+      material.Menu,
+      {
+        anchorEl,
+        open,
+        onClose: handleClose,
+        anchorOrigin: { vertical: "bottom", horizontal: "right" },
+        transformOrigin: { vertical: "top", horizontal: "right" },
+        slotProps: {
+          paper: {
+            sx: __spreadValues({ minWidth: 240 }, menuSx)
+          }
+        },
+        children: [
+          showUserHeader && /* @__PURE__ */ jsxRuntime.jsxs(
+            material.Box,
+            {
+              sx: {
+                px: 2,
+                py: 1.25,
+                display: "flex",
+                flexDirection: "column",
+                gap: 0.25
+              },
+              children: [
+                (user == null ? void 0 : user.name) && /* @__PURE__ */ jsxRuntime.jsx(material.Typography, { variant: "subtitle2", noWrap: true, sx: { fontWeight: 700 }, children: user.name }),
+                (user == null ? void 0 : user.email) && /* @__PURE__ */ jsxRuntime.jsx(material.Typography, { variant: "caption", color: "text.secondary", noWrap: true, children: user.email })
+              ]
+            }
+          ),
+          showUserHeader && /* @__PURE__ */ jsxRuntime.jsx(material.Divider, {}),
+          items.map((item, idx) => {
+            var _a2;
+            const key = (_a2 = item.key) != null ? _a2 : `${String(item.label)}-${idx}`;
+            const node = /* @__PURE__ */ jsxRuntime.jsxs(
+              material.MenuItem,
+              {
+                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
+                  }
+                }),
+                children: [
+                  item.icon && /* @__PURE__ */ jsxRuntime.jsx(material.ListItemIcon, { children: item.icon }),
+                  /* @__PURE__ */ jsxRuntime.jsx(material.ListItemText, { primary: item.label })
+                ]
+              },
+              key
+            );
+            if (item.dividerBefore && idx > 0) {
+              return /* @__PURE__ */ jsxRuntime.jsxs(React.Fragment, { children: [
+                /* @__PURE__ */ jsxRuntime.jsx(material.Divider, {}),
+                node
+              ] }, `${key}-frag`);
+            }
+            return node;
+          })
+        ]
+      }
+    )
+  ] });
+}
+exports.AppBar = AppBar;
+exports.AppBarBrand = AppBarBrand;
+exports.AppBarContext = AppBarContext;
+exports.AppBarMenuToggle = AppBarMenuToggle;
+exports.AppBarUserMenu = AppBarUserMenu;
+exports.buildAppBarSx = buildAppBarSx;
+exports.default = AppBar;
+exports.useAppBarContext = useAppBarContext;
+//# sourceMappingURL=AppBar.cjs.map

package/dist/components/AppBar/AppBar.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppBar.cjs","sources":["../../../src/components/AppBar/AppBarContext.ts","../../../src/components/AppBar/AppBar.sx.ts","../../../src/components/AppBar/AppBar.tsx","../../../src/components/AppBar/AppBarBrand.tsx","../../../src/components/AppBar/AppBarMenuToggle.tsx","../../../src/components/AppBar/AppBarUserMenu.tsx"],"sourcesContent":["import { createContext, useContext } from 'react';\n\n/**\n * Context interno del AppBar. Permite que sub-componentes (MenuToggle, etc.)\n * consuman callbacks registrados en el AppBar padre sin tener que pasarlos\n * por props explícitas.\n */\nexport interface AppBarContextValue {\n  /** Handler del botón hamburguesa. Si es undefined, el toggle se oculta. */\n  onMenuToggle?: () => void;\n  /** Estado actual del drawer asociado (usado por el icono del toggle). */\n  menuOpen?: boolean;\n}\n\nexport const AppBarContext = createContext<AppBarContextValue | null>(null);\n\n/**\n * Hook para leer el contexto del AppBar. Si se llama fuera de un `<AppBar>`,\n * devuelve un objeto vacío — los sub-componentes caen en modo \"standalone\"\n * con sus defaults en lugar de romper.\n */\nexport function useAppBarContext(): AppBarContextValue {\n  const ctx = useContext(AppBarContext);\n  return ctx ?? {};\n}\n","import type { SxProps, Theme } from '@mui/material/styles';\n\nexport interface BuildAppBarSxArgs {\n  /** Altura en px. Default: 64. */\n  height?: number;\n  /** Color del AppBar (se pasa al MuiAppBar). */\n  transparent?: boolean;\n}\n\n/**\n * sx del root del MuiAppBar. Define altura fija y layout flex del Toolbar\n * interno. El color/elevación se dejan a las props nativas de MuiAppBar.\n */\nexport function buildAppBarSx({\n  height = 64,\n  transparent = false,\n}: BuildAppBarSxArgs): SxProps<Theme> {\n  return (theme) => ({\n    minHeight: height,\n    justifyContent: 'center',\n    backgroundImage: 'none',\n    ...(transparent && {\n      backgroundColor: 'transparent',\n      boxShadow: 'none',\n      borderBottom: `1px solid ${theme.palette.divider}`,\n    }),\n    '& .MuiToolbar-root': {\n      minHeight: height,\n      gap: 1.5,\n    },\n  });\n}\n","import React, { useMemo, type ReactNode } from 'react';\nimport {\n  AppBar as MuiAppBar,\n  Toolbar,\n  type AppBarProps as MuiAppBarProps,\n} from '@mui/material';\nimport {\n  useTheme,\n  type SxProps,\n  type Theme,\n} from '@mui/material/styles';\n\nimport { AppBarContext } from './AppBarContext';\nimport { buildAppBarSx } from './AppBar.sx';\nimport { resolvePreset } from '../_shared/resolvePreset';\n\nexport type AppBarPosition = 'fixed' | 'sticky' | 'static' | 'absolute' | 'relative';\nexport type AppBarColor =\n  | 'default'\n  | 'primary'\n  | 'secondary'\n  | 'transparent'\n  | 'inherit';\n\nexport interface AppBarProps {\n  /** Contenido del AppBar (típicamente sub-componentes + acciones custom). */\n  children?: ReactNode;\n  /** Posicionamiento. Default: `'sticky'`. */\n  position?: AppBarPosition;\n  /** Color. Default: `'default'`. */\n  color?: AppBarColor;\n  /** Nivel de sombra. Default: 1. */\n  elevation?: number;\n  /** Altura en px. Default: 64. */\n  height?: number;\n  /**\n   * Handler del botón hamburguesa. Se expone vía AppBarContext para que el\n   * sub-componente `<AppBarMenuToggle>` lo consuma sin prop drilling.\n   */\n  onMenuToggle?: () => void;\n  /** Estado del drawer asociado (para que el icono del toggle cambie). */\n  menuOpen?: boolean;\n  /**\n   * Nombre del preset de estilo registrado en `theme.styles.AppBar`.\n   * - `\"default\"` (o ausente) = estilo built-in del paquete.\n   */\n  preset?: string;\n  /** sx del root (se mergea después del preset). */\n  sx?: SxProps<Theme>;\n  /** sx del Toolbar interno. */\n  toolbarSx?: SxProps<Theme>;\n  className?: string;\n  /** Otras props nativas del MuiAppBar (ej. `enableColorOnDark`). */\n  appBarProps?: Omit<\n    MuiAppBarProps,\n    'position' | 'color' | 'elevation' | 'sx' | 'children' | 'className'\n  >;\n}\n\n/**\n * AppBar (header superior) del paquete. Se diseñó como un shell compositivo\n * — el consumer arma el contenido con los sub-componentes que exporta el\n * paquete (`AppBarBrand`, `AppBarMenuToggle`, `AppBarUserMenu`) + cualquier\n * otra cosa custom.\n *\n * Patrón recomendado para navegación en dashboards:\n *\n * ```tsx\n * <AppBar onMenuToggle={toggleDrawer}>\n *   <AppBarMenuToggle />\n *   <AppBarBrand logo={<Logo />} title=\"Afiliaciones\" />\n *   <Box sx={{ flex: 1 }} />\n *   <AppBarUserMenu user={user} items={menuItems} />\n * </AppBar>\n * ```\n */\nexport function AppBar({\n  children,\n  position = 'sticky',\n  color = 'default',\n  elevation = 1,\n  height = 64,\n  onMenuToggle,\n  menuOpen,\n  preset,\n  sx,\n  toolbarSx,\n  className,\n  appBarProps,\n}: AppBarProps) {\n  const theme = useTheme();\n  const presetSx = resolvePreset('AppBar', preset, theme);\n\n  const transparent = color === 'transparent';\n\n  const rootSx: SxProps<Theme> = [\n    buildAppBarSx({ height, transparent }),\n    ...(presetSx ? [presetSx] : []),\n    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\n  ];\n\n  const contextValue = useMemo(\n    () => ({ onMenuToggle, menuOpen }),\n    [onMenuToggle, menuOpen],\n  );\n\n  return (\n    <AppBarContext.Provider value={contextValue}>\n      <MuiAppBar\n        position={position}\n        color={color === 'transparent' ? 'transparent' : color}\n        elevation={elevation}\n        className={className}\n        sx={rootSx}\n        {...appBarProps}\n      >\n        <Toolbar sx={toolbarSx}>{children}</Toolbar>\n      </MuiAppBar>\n    </AppBarContext.Provider>\n  );\n}\n\nexport default AppBar;\n","import React, { type ReactNode, type MouseEvent } from 'react';\nimport { Box, Typography } from '@mui/material';\nimport type { SxProps, Theme } from '@mui/material/styles';\n\nexport interface AppBarBrandProps {\n  /** Logo (img, svg, componente). Se muestra a la izquierda del título. */\n  logo?: ReactNode;\n  /** Título del sistema. */\n  title?: ReactNode;\n  /** Subtítulo opcional (p.ej. nombre de módulo actual). */\n  subtitle?: ReactNode;\n  /** Handler de click sobre todo el brand (típicamente navega al home). */\n  onClick?: (event: MouseEvent<HTMLDivElement>) => void;\n  /** Oculta solo el título en viewports pequeños (mantiene el logo). Default: true. */\n  hideTitleOnMobile?: boolean;\n  sx?: SxProps<Theme>;\n  className?: string;\n}\n\n/**\n * Brand del AppBar: combina logo + título + subtítulo opcional con un\n * click handler global (típicamente para navegar al home).\n *\n * ```tsx\n * <AppBarBrand\n *   logo={<img src={logo} alt=\"\" height={32} />}\n *   title=\"Afiliaciones\"\n *   subtitle=\"Panel administrativo\"\n *   onClick={() => navigate('/')}\n * />\n * ```\n */\nexport function AppBarBrand({\n  logo,\n  title,\n  subtitle,\n  onClick,\n  hideTitleOnMobile = true,\n  sx,\n  className,\n}: AppBarBrandProps) {\n  const clickable = !!onClick;\n\n  const rootSx: SxProps<Theme> = [\n    {\n      display: 'flex',\n      alignItems: 'center',\n      gap: 1.25,\n      cursor: clickable ? 'pointer' : 'default',\n      userSelect: 'none',\n      minWidth: 0,\n    },\n    ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\n  ];\n\n  return (\n    <Box\n      role={clickable ? 'button' : undefined}\n      tabIndex={clickable ? 0 : undefined}\n      onClick={onClick}\n      onKeyDown={(event) => {\n        if (!clickable) return;\n        if (event.key === 'Enter' || event.key === ' ') {\n          event.preventDefault();\n          onClick?.(event as unknown as MouseEvent<HTMLDivElement>);\n        }\n      }}\n      className={className}\n      sx={rootSx}\n    >\n      {logo && (\n        <Box\n          component=\"span\"\n          sx={{\n            display: 'flex',\n            alignItems: 'center',\n            flexShrink: 0,\n          }}\n        >\n          {logo}\n        </Box>\n      )}\n      {(title || subtitle) && (\n        <Box\n          sx={{\n            display: hideTitleOnMobile\n              ? { xs: 'none', sm: 'flex' }\n              : 'flex',\n            flexDirection: 'column',\n            minWidth: 0,\n            lineHeight: 1.2,\n          }}\n        >\n          {title && (\n            <Typography\n              component=\"span\"\n              variant=\"subtitle1\"\n              noWrap\n              sx={{ fontWeight: 700 }}\n            >\n              {title}\n            </Typography>\n          )}\n          {subtitle && (\n            <Typography\n              component=\"span\"\n              variant=\"caption\"\n              color=\"text.secondary\"\n              noWrap\n            >\n              {subtitle}\n            </Typography>\n          )}\n        </Box>\n      )}\n    </Box>\n  );\n}\n\nexport default AppBarBrand;\n","import React, { type ReactNode } from 'react';\nimport { IconButton, Tooltip } from '@mui/material';\nimport MenuIcon from '@mui/icons-material/Menu';\nimport MenuOpenIcon from '@mui/icons-material/MenuOpen';\nimport type { SxProps, Theme } from '@mui/material/styles';\n\nimport { useAppBarContext } from './AppBarContext';\n\nexport interface AppBarMenuToggleProps {\n  /**\n   * Callback explícito. Si se omite, se consume del `AppBarContext`. Útil para\n   * usar el toggle fuera de un `<AppBar>` (p.ej. en un header custom).\n   */\n  onClick?: () => void;\n  /** Estado del drawer asociado. Si se omite, se lee del `AppBarContext`. */\n  menuOpen?: boolean;\n  /** Icono custom cuando el drawer está cerrado. Default: `<MenuIcon />`. */\n  closedIcon?: ReactNode;\n  /** Icono custom cuando el drawer está abierto. Default: `<MenuOpenIcon />`. */\n  openIcon?: ReactNode;\n  /** Texto de tooltip. Default: \"Menú\". */\n  tooltip?: string;\n  /** aria-label del botón. Default: el mismo tooltip. */\n  ariaLabel?: string;\n  /** Tamaño del IconButton. Default: `'medium'`. */\n  size?: 'small' | 'medium' | 'large';\n  /** Oculta el botón cuando no hay handler disponible. Default: true. */\n  hideIfNoHandler?: boolean;\n  sx?: SxProps<Theme>;\n  className?: string;\n}\n\n/**\n * Botón hamburguesa del AppBar. Por default consume `onMenuToggle` y\n * `menuOpen` del `AppBarContext` (pattern composicional), pero permite\n * overrides explícitos si se usa fuera de un `<AppBar>`.\n *\n * ```tsx\n * <AppBar onMenuToggle={toggleDrawer} menuOpen={open}>\n *   <AppBarMenuToggle />\n *   ...\n * </AppBar>\n * ```\n */\nexport function AppBarMenuToggle({\n  onClick,\n  menuOpen,\n  closedIcon,\n  openIcon,\n  tooltip = 'Menú',\n  ariaLabel,\n  size = 'medium',\n  hideIfNoHandler = true,\n  sx,\n  className,\n}: AppBarMenuToggleProps) {\n  const ctx = useAppBarContext();\n\n  const handler = onClick ?? ctx.onMenuToggle;\n  const open = menuOpen ?? ctx.menuOpen ?? false;\n\n  if (!handler && hideIfNoHandler) {\n    return null;\n  }\n\n  const icon = open\n    ? (openIcon ?? <MenuOpenIcon />)\n    : (closedIcon ?? <MenuIcon />);\n\n  return (\n    <Tooltip title={tooltip} arrow>\n      <span>\n        <IconButton\n          size={size}\n          edge=\"start\"\n          color=\"inherit\"\n          aria-label={ariaLabel ?? tooltip}\n          onClick={handler}\n          disabled={!handler}\n          className={className}\n          sx={sx}\n        >\n          {icon}\n        </IconButton>\n      </span>\n    </Tooltip>\n  );\n}\n\nexport default AppBarMenuToggle;\n","import React, { useState, type ReactNode, type MouseEvent } from 'react';\nimport {\n  Avatar,\n  Box,\n  Divider,\n  IconButton,\n  ListItemIcon,\n  ListItemText,\n  Menu,\n  MenuItem,\n  Tooltip,\n  Typography,\n} from '@mui/material';\nimport type { SxProps, Theme } from '@mui/material/styles';\n\nexport interface AppBarUserMenuItem {\n  /** Key única. Si no se provee, se usa el label. */\n  key?: string;\n  /** Texto del item. */\n  label: ReactNode;\n  /** Icono opcional a la izquierda. */\n  icon?: ReactNode;\n  /** Handler de click. */\n  onClick?: (event: MouseEvent<HTMLLIElement>) => void;\n  /** Deshabilita el item. */\n  disabled?: boolean;\n  /** Pinta el item en color error (típico para \"Cerrar sesión\"). */\n  danger?: boolean;\n  /** Inserta un `<Divider />` ANTES de este item. */\n  dividerBefore?: boolean;\n}\n\nexport interface AppBarUserMenuUser {\n  /** Nombre a mostrar en el header del menú. */\n  name?: ReactNode;\n  /** Email / subtítulo secundario. */\n  email?: ReactNode;\n  /** URL del avatar. Si se omite, se muestran iniciales del `name`. */\n  avatarUrl?: string;\n  /** Iniciales custom. Si se omite, se calculan del `name`. */\n  initials?: string;\n}\n\nexport interface AppBarUserMenuProps {\n  /** Datos del usuario a mostrar. */\n  user?: AppBarUserMenuUser;\n  /** Items del menú. */\n  items: AppBarUserMenuItem[];\n  /**\n   * Si `true`, oculta la fila con nombre + email en el tope del menú.\n   * Default: `false`.\n   */\n  hideUserHeader?: boolean;\n  /** Tooltip del trigger. Default: \"Cuenta\". */\n  triggerTooltip?: string;\n  /** Tamaño del Avatar en px. Default: 36. */\n  avatarSize?: number;\n  /** sx del Paper del Menu. */\n  menuSx?: SxProps<Theme>;\n  /** sx del trigger (IconButton). */\n  triggerSx?: SxProps<Theme>;\n  className?: string;\n}\n\nfunction computeInitials(name?: ReactNode): string {\n  if (typeof name !== 'string') return '?';\n  const parts = name.trim().split(/\\s+/).filter(Boolean);\n  if (parts.length === 0) return '?';\n  const first = parts[0]?.charAt(0) ?? '';\n  const last = parts.length > 1 ? (parts[parts.length - 1]?.charAt(0) ?? '') : '';\n  return (first + last).toUpperCase();\n}\n\n/**\n * Menú de usuario del AppBar: avatar clickable que despliega un menú con la\n * info del usuario (nombre + email) y una lista de acciones (perfil, cerrar\n * sesión, etc).\n *\n * ```tsx\n * <AppBarUserMenu\n *   user={{ name: 'Andrea', email: 'a@soyfri.com' }}\n *   items={[\n *     { label: 'Perfil', icon: <PersonIcon />, onClick: goToProfile },\n *     { label: 'Cerrar sesión', icon: <LogoutIcon />, onClick: logout, danger: true, dividerBefore: true },\n *   ]}\n * />\n * ```\n */\nexport function AppBarUserMenu({\n  user,\n  items,\n  hideUserHeader = false,\n  triggerTooltip = 'Cuenta',\n  avatarSize = 36,\n  menuSx,\n  triggerSx,\n  className,\n}: AppBarUserMenuProps) {\n  const [anchorEl, setAnchorEl] = useState<HTMLElement | null>(null);\n  const open = Boolean(anchorEl);\n\n  const handleOpen = (event: MouseEvent<HTMLElement>) => {\n    setAnchorEl(event.currentTarget);\n  };\n  const handleClose = () => setAnchorEl(null);\n\n  const handleItemClick = (\n    event: MouseEvent<HTMLLIElement>,\n    item: AppBarUserMenuItem,\n  ) => {\n    event.stopPropagation();\n    item.onClick?.(event);\n    handleClose();\n  };\n\n  const initials = user?.initials ?? computeInitials(user?.name);\n  const showUserHeader = !hideUserHeader && (user?.name || user?.email);\n\n  return (\n    <Box component=\"span\" className={className}>\n      <Tooltip title={triggerTooltip} arrow>\n        <IconButton\n          onClick={handleOpen}\n          size=\"small\"\n          aria-label={triggerTooltip}\n          aria-haspopup=\"menu\"\n          aria-expanded={open || undefined}\n          sx={[{ p: 0.5 }, ...(Array.isArray(triggerSx) ? triggerSx : triggerSx ? [triggerSx] : [])]}\n        >\n          <Avatar\n            src={user?.avatarUrl}\n            sx={{\n              width: avatarSize,\n              height: avatarSize,\n              fontSize: avatarSize * 0.4,\n              fontWeight: 600,\n            }}\n          >\n            {!user?.avatarUrl && initials}\n          </Avatar>\n        </IconButton>\n      </Tooltip>\n\n      <Menu\n        anchorEl={anchorEl}\n        open={open}\n        onClose={handleClose}\n        anchorOrigin={{ vertical: 'bottom', horizontal: 'right' }}\n        transformOrigin={{ vertical: 'top', horizontal: 'right' }}\n        slotProps={{\n          paper: {\n            sx: { minWidth: 240, ...(menuSx as any) },\n          },\n        }}\n      >\n        {showUserHeader && (\n          <Box\n            sx={{\n              px: 2,\n              py: 1.25,\n              display: 'flex',\n              flexDirection: 'column',\n              gap: 0.25,\n            }}\n          >\n            {user?.name && (\n              <Typography variant=\"subtitle2\" noWrap sx={{ fontWeight: 700 }}>\n                {user.name}\n              </Typography>\n            )}\n            {user?.email && (\n              <Typography variant=\"caption\" color=\"text.secondary\" noWrap>\n                {user.email}\n              </Typography>\n            )}\n          </Box>\n        )}\n        {showUserHeader && <Divider />}\n\n        {items.map((item, idx) => {\n          const key = item.key ?? `${String(item.label)}-${idx}`;\n          const node = (\n            <MenuItem\n              key={key}\n              disabled={item.disabled}\n              onClick={(event) => handleItemClick(event, item)}\n              sx={(theme) => ({\n                color: item.danger ? theme.palette.error.main : 'inherit',\n                '& .MuiListItemIcon-root': {\n                  color: item.danger\n                    ? theme.palette.error.main\n                    : 'inherit',\n                  minWidth: 32,\n                },\n              })}\n            >\n              {item.icon && <ListItemIcon>{item.icon}</ListItemIcon>}\n              <ListItemText primary={item.label} />\n            </MenuItem>\n          );\n\n          if (item.dividerBefore && idx > 0) {\n            return (\n              <React.Fragment key={`${key}-frag`}>\n                <Divider />\n                {node}\n              </React.Fragment>\n            );\n          }\n          return node;\n        })}\n      </Menu>\n    </Box>\n  );\n}\n\nexport default AppBarUserMenu;\n"],"names":["createContext","useContext","useTheme","resolvePreset","useMemo","jsx","MuiAppBar","Toolbar","jsxs","Box","Typography","Tooltip","IconButton","useState","_a","Avatar","Menu","Divider","MenuItem","ListItemIcon","ListItemText"],"mappings":"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"}

package/dist/components/AppBar/AppBar.d.ts

@@ -0,0 +1,55 @@
+import { ReactNode } from 'react';
+import { AppBarProps as MuiAppBarProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+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 declare function AppBar({ children, position, color, elevation, height, onMenuToggle, menuOpen, preset, sx, toolbarSx, className, appBarProps, }: AppBarProps): import("react/jsx-runtime").JSX.Element;
+export default AppBar;