@stackcraftmx/calcita 0.0.0-stage → 0.25.0

package/dist/api/staleChunks.js

@@ -0,0 +1,47 @@
+import { createLogger } from "../observability/logger.js";
+const log = createLogger("chunks");
+const RELOAD_STORAGE_KEY = "calcita:chunkReloadAt";
+const RELOAD_COOLDOWN_MILLISECONDS = 15e3;
+const STALE_CHUNK_MESSAGES = Object.freeze([
+  "failed to fetch dynamically imported module",
+  "error loading dynamically imported module",
+  "importing a module script failed",
+  "failed to load module script"
+]);
+function isStaleChunkError(error) {
+  const message = String(error?.message ?? error ?? "").toLowerCase();
+  return STALE_CHUNK_MESSAGES.some((knownMessage) => message.includes(knownMessage));
+}
+function reloadedRecently() {
+  try {
+    const reloadedAt = Number(window.sessionStorage.getItem(RELOAD_STORAGE_KEY) ?? 0);
+    return reloadedAt > 0 && Date.now() - reloadedAt < RELOAD_COOLDOWN_MILLISECONDS;
+  } catch {
+    return false;
+  }
+}
+function markReload() {
+  try {
+    window.sessionStorage.setItem(RELOAD_STORAGE_KEY, String(Date.now()));
+  } catch {
+  }
+}
+function recoverFromStaleChunk(error) {
+  if (!isStaleChunkError(error)) {
+    throw error;
+  }
+  if (reloadedRecently()) {
+    log.error("el archivo de la pantalla sigue sin cargar después de recargar", { cause: String(error) });
+    throw error;
+  }
+  log.warn("archivo de una versión anterior: se recarga la página", { cause: String(error) });
+  markReload();
+  window.location.reload();
+  return new Promise(() => {
+  });
+}
+export {
+  isStaleChunkError,
+  recoverFromStaleChunk
+};
+//# sourceMappingURL=staleChunks.js.map

package/dist/api/staleChunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleChunks.js","sources":["../../src/api/staleChunks.js"],"sourcesContent":["// Sobrevivir a una publicación con la app abierta.\n//\n// El síntoma (Chrome): «Failed to fetch dynamically imported module: …/assets/orders-LUgRFrRF.js».\n//\n// Qué pasó: cada pantalla viaja en su propio archivo con la huella de su contenido en el nombre. Al publicar, los nombres\n// cambian y los viejos se borran. Quien tenía la app abierta sigue con el índice anterior en memoria: en cuanto entra a\n// una pantalla que no había abierto, pide un archivo que ya no existe. No es un error de red ni de la persona; le pasa a\n// cualquiera que tenga la pestaña abierta durante una publicación.\n//\n// Qué se hace: recargar UNA vez. La página nueva trae los nombres nuevos y la persona ve un parpadeo en lugar de una\n// pantalla rota. El candado contra el ciclo es la hora de la última recarga en sessionStorage: si se recargó hace menos de\n// RELOAD_COOLDOWN_MILLISECONDS, el error sigue su camino (un archivo que de verdad falta dejaría la pestaña recargándose\n// para siempre). La ventana es corta a propósito: otra publicación media hora después se tiene que poder recuperar igual.\n//\n//   lazy: () => import('./OrdersPage.jsx').catch(recoverFromStaleChunk)\n//\n// Con react-router, withChunkRecovery(routes) de /react-router lo pone en todas las rutas lazy.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport {createLogger} from '@/observability/logger.js';\n\nconst log = createLogger('chunks');\n\nconst RELOAD_STORAGE_KEY = 'calcita:chunkReloadAt';\nconst RELOAD_COOLDOWN_MILLISECONDS = 15_000;\n\n// Cada navegador lo redacta distinto: Chromium «Failed to fetch dynamically imported module», Firefox «error loading\n// dynamically imported module», Safari «Importing a module script failed».\nconst STALE_CHUNK_MESSAGES = Object.freeze([\n    'failed to fetch dynamically imported module',\n    'error loading dynamically imported module',\n    'importing a module script failed',\n    'failed to load module script',\n]);\n\n/**\n * ¿El error es un archivo de pantalla que ya no existe (se publicó otra versión), y no otra cosa?\n *\n * @param {unknown} error\n * @returns {boolean}\n */\nexport function isStaleChunkError(error) {\n    const message = String(error?.message ?? error ?? '').toLowerCase();\n    return STALE_CHUNK_MESSAGES.some((knownMessage) => message.includes(knownMessage));\n}\n\n/** ¿Ya se recargó por esto hace poco? Sin sessionStorage no hay candado: mejor recargar una vez que dejar la pantalla rota. */\nfunction reloadedRecently() {\n    try {\n        const reloadedAt = Number(window.sessionStorage.getItem(RELOAD_STORAGE_KEY) ?? 0);\n        return reloadedAt > 0 && Date.now() - reloadedAt < RELOAD_COOLDOWN_MILLISECONDS;\n    } catch {\n        return false;\n    }\n}\n\nfunction markReload() {\n    try {\n        window.sessionStorage.setItem(RELOAD_STORAGE_KEY, String(Date.now()));\n    } catch {\n        // almacenamiento bloqueado: se recarga igual, solo sin candado\n    }\n}\n\n/**\n * Lo que va en el .catch() de un import dinámico: si el archivo es de una versión vieja, recarga una vez; si no, deja\n * pasar el error tal cual para que lo vea quien corresponda.\n *\n * @param {unknown} error\n * @returns {Promise<never>}\n */\nexport function recoverFromStaleChunk(error) {\n    if (!isStaleChunkError(error)) {\n        throw error;\n    }\n    if (reloadedRecently()) {\n        // ya se recargó y volvió a fallar: no es una publicación, el archivo de verdad falta. Nunca fallar en silencio\n        log.error('el archivo de la pantalla sigue sin cargar después de recargar', {cause: String(error)});\n        throw error;\n    }\n    log.warn('archivo de una versión anterior: se recarga la página', {cause: String(error)});\n    markReload();\n    window.location.reload();\n    // OJO: la promesa NUNCA se resuelve, a propósito: la página ya se está yendo y resolverla haría que se pintara un error\n    // un instante antes de recargar\n    return new Promise(() => {});\n}\n"],"names":[],"mappings":";AAqBA,MAAM,MAAM,aAAa,QAAQ;AAEjC,MAAM,qBAAqB;AAC3B,MAAM,+BAA+B;AAIrC,MAAM,uBAAuB,OAAO,OAAO;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAQM,SAAS,kBAAkB,OAAO;AACrC,QAAM,UAAU,OAAO,OAAO,WAAW,SAAS,EAAE,EAAE,YAAW;AACjE,SAAO,qBAAqB,KAAK,CAAC,iBAAiB,QAAQ,SAAS,YAAY,CAAC;AACrF;AAGA,SAAS,mBAAmB;AACxB,MAAI;AACA,UAAM,aAAa,OAAO,OAAO,eAAe,QAAQ,kBAAkB,KAAK,CAAC;AAChF,WAAO,aAAa,KAAK,KAAK,IAAG,IAAK,aAAa;AAAA,EACvD,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAEA,SAAS,aAAa;AAClB,MAAI;AACA,WAAO,eAAe,QAAQ,oBAAoB,OAAO,KAAK,IAAG,CAAE,CAAC;AAAA,EACxE,QAAQ;AAAA,EAER;AACJ;AASO,SAAS,sBAAsB,OAAO;AACzC,MAAI,CAAC,kBAAkB,KAAK,GAAG;AAC3B,UAAM;AAAA,EACV;AACA,MAAI,iBAAgB,GAAI;AAEpB,QAAI,MAAM,kEAAkE,EAAC,OAAO,OAAO,KAAK,EAAC,CAAC;AAClG,UAAM;AAAA,EACV;AACA,MAAI,KAAK,yDAAyD,EAAC,OAAO,OAAO,KAAK,EAAC,CAAC;AACxF,aAAU;AACV,SAAO,SAAS,OAAM;AAGtB,SAAO,IAAI,QAAQ,MAAM;AAAA,EAAC,CAAC;AAC/B;"}

package/dist/appShell/AccountMenu.js

@@ -0,0 +1,86 @@
+"use client";
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import { useToolkitNavigation } from "../toolkit/toolkitContext.js";
+import Avatar from "@mui/material/Avatar";
+import Box from "@mui/material/Box";
+import Divider from "@mui/material/Divider";
+import IconButton from "@mui/material/IconButton";
+import ListItemIcon from "@mui/material/ListItemIcon";
+import ListItemText from "@mui/material/ListItemText";
+import Menu from "@mui/material/Menu";
+import MenuItem from "@mui/material/MenuItem";
+import Tooltip from "@mui/material/Tooltip";
+import Typography from "@mui/material/Typography";
+import LogoutIcon from "@mui/icons-material/Logout";
+import PersonOutlineIcon from "@mui/icons-material/PersonOutline";
+import { initialsOf, menuItemLabelOf } from "./menuItemText.js";
+import { barMenuPlacementOf } from "./barMenuPlacement.js";
+function AccountMenu({ user, profilePath, accountMenuItems = [], onSignOut, isSigningOut = false, settings }) {
+  const { t } = useToolkitTranslation("layout");
+  const { Link: RouterLink } = useToolkitNavigation();
+  const [anchorElement, setAnchorElement] = useState(null);
+  const closeMenu = () => setAnchorElement(null);
+  const menuLinks = [
+    ...profilePath ? [{ to: profilePath, labelKey: "layout:account.myProfile", Icon: PersonOutlineIcon }] : [],
+    ...accountMenuItems
+  ];
+  const placement = barMenuPlacementOf(anchorElement);
+  const signOut = () => {
+    closeMenu();
+    onSignOut();
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Tooltip, { title: t("account.open"), children: /* @__PURE__ */ jsx(IconButton, { size: "small", "aria-label": t("account.open"), "aria-haspopup": "menu", onClick: (event) => setAnchorElement(event.currentTarget), sx: { p: 0.5 }, children: /* @__PURE__ */ jsx(Avatar, { src: user.avatarUrl, alt: "", sx: { width: 32, height: 32, fontSize: "0.875rem", bgcolor: "secondary.main", color: "secondary.contrastText" }, children: initialsOf(user.name) }) }) }),
+    /* @__PURE__ */ jsxs(
+      Menu,
+      {
+        anchorEl: anchorElement,
+        open: Boolean(anchorElement),
+        onClose: closeMenu,
+        anchorOrigin: placement.anchorOrigin,
+        transformOrigin: placement.transformOrigin,
+        slotProps: { paper: { sx: { minWidth: settings ? 300 : 240, maxWidth: 360, ...placement.gapSx } } },
+        children: [
+          /* @__PURE__ */ jsxs(Box, { sx: { px: 2, py: 1.25 }, children: [
+            /* @__PURE__ */ jsx(Typography, { variant: "subtitle2", noWrap: true, sx: { fontWeight: 600 }, children: user.name }),
+            user.email && /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "text.secondary", noWrap: true, children: user.email }),
+            user.subtitle && /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "text.secondary", component: "p", noWrap: true, children: user.subtitle })
+          ] }),
+          settings && /* @__PURE__ */ jsx(Divider, {}),
+          settings && /* @__PURE__ */ jsx(Box, { sx: { py: 0.5 }, children: settings }),
+          menuLinks.length > 0 && /* @__PURE__ */ jsx(Divider, {}),
+          menuLinks.map((menuLink) => {
+            const Icon = menuLink.Icon;
+            const linkProps = menuLink.to ? { component: RouterLink, to: menuLink.to } : {};
+            return /* @__PURE__ */ jsxs(
+              MenuItem,
+              {
+                ...linkProps,
+                onClick: () => {
+                  closeMenu();
+                  menuLink.onClick?.();
+                },
+                children: [
+                  Icon && /* @__PURE__ */ jsx(ListItemIcon, { children: /* @__PURE__ */ jsx(Icon, { fontSize: "small" }) }),
+                  /* @__PURE__ */ jsx(ListItemText, { primary: menuItemLabelOf(menuLink, t) })
+                ]
+              },
+              menuLink.to ?? menuItemLabelOf(menuLink, t)
+            );
+          }),
+          onSignOut && /* @__PURE__ */ jsx(Divider, {}),
+          onSignOut && /* @__PURE__ */ jsxs(MenuItem, { onClick: signOut, disabled: isSigningOut, children: [
+            /* @__PURE__ */ jsx(ListItemIcon, { children: /* @__PURE__ */ jsx(LogoutIcon, { fontSize: "small" }) }),
+            /* @__PURE__ */ jsx(ListItemText, { primary: t("signOut") })
+          ] })
+        ]
+      }
+    )
+  ] });
+}
+export {
+  AccountMenu as default
+};
+//# sourceMappingURL=AccountMenu.js.map

package/dist/appShell/AccountMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountMenu.js","sources":["../../src/appShell/AccountMenu.jsx"],"sourcesContent":["// La cuenta de quien está dentro, arriba a la derecha (como en las plantillas de MUI): un avatar con sus iniciales (o su\n// foto) que abre un menú con su nombre y correo, Mi perfil, lo que el proyecto agregue (accountMenuItems: Facturación,\n// Mis llaves…) y Salir.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useState} from 'react';\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport {useToolkitNavigation} from '@/toolkit/toolkitContext.js';\nimport Avatar from '@mui/material/Avatar';\nimport Box from '@mui/material/Box';\nimport Divider from '@mui/material/Divider';\nimport IconButton from '@mui/material/IconButton';\nimport ListItemIcon from '@mui/material/ListItemIcon';\nimport ListItemText from '@mui/material/ListItemText';\nimport Menu from '@mui/material/Menu';\nimport MenuItem from '@mui/material/MenuItem';\nimport Tooltip from '@mui/material/Tooltip';\nimport Typography from '@mui/material/Typography';\nimport LogoutIcon from '@mui/icons-material/Logout';\nimport PersonOutlineIcon from '@mui/icons-material/PersonOutline';\n\nimport {initialsOf, menuItemLabelOf} from '@/appShell/menuItemText.js';\nimport {barMenuPlacementOf} from '@/appShell/barMenuPlacement.js';\n\n/**\n * @param {object} props\n * @param {{name: string, email?: string, subtitle?: string, avatarUrl?: string}} props.user\n * @param {string} [props.profilePath] sin ella no sale «Mi perfil»\n * @param {Array<{to?: string, onClick?: Function, label?: string, labelKey?: string, Icon?: import('react').ElementType}>} [props.accountMenuItems]\n * @param {() => void} [props.onSignOut] sin él no sale «Salir»\n * @param {boolean} [props.isSigningOut]\n * @param {import('react').ReactNode} [props.settings] los ajustes de la app, entre los datos de la persona y sus ligas\n */\nexport default function AccountMenu({user, profilePath, accountMenuItems = [], onSignOut, isSigningOut = false, settings}) {\n    const {t} = useToolkitTranslation('layout');\n    const {Link: RouterLink} = useToolkitNavigation();\n    const [anchorElement, setAnchorElement] = useState(null);\n    const closeMenu = () => setAnchorElement(null);\n    const menuLinks = [\n        ...(profilePath ? [{to: profilePath, labelKey: 'layout:account.myProfile', Icon: PersonOutlineIcon}] : []),\n        ...accountMenuItems,\n    ];\n\n    // hacia arriba si la barra está abajo (teléfono con vidrio)\n    const placement = barMenuPlacementOf(anchorElement);\n\n    const signOut = () => {\n        closeMenu();\n        onSignOut();\n    };\n\n    return (\n        <>\n            <Tooltip title={t('account.open')}>\n                <IconButton size=\"small\" aria-label={t('account.open')} aria-haspopup=\"menu\" onClick={(event) => setAnchorElement(event.currentTarget)} sx={{p: 0.5}}>\n                    <Avatar src={user.avatarUrl} alt=\"\" sx={{width: 32, height: 32, fontSize: '0.875rem', bgcolor: 'secondary.main', color: 'secondary.contrastText'}}>\n                        {initialsOf(user.name)}\n                    </Avatar>\n                </IconButton>\n            </Tooltip>\n            <Menu anchorEl={anchorElement} open={Boolean(anchorElement)} onClose={closeMenu}\n                  anchorOrigin={placement.anchorOrigin} transformOrigin={placement.transformOrigin}\n                  slotProps={{paper: {sx: {minWidth: settings ? 300 : 240, maxWidth: 360, ...placement.gapSx}}}}>\n                <Box sx={{px: 2, py: 1.25}}>\n                    <Typography variant=\"subtitle2\" noWrap sx={{fontWeight: 600}}>{user.name}</Typography>\n                    {user.email && <Typography variant=\"body2\" color=\"text.secondary\" noWrap>{user.email}</Typography>}\n                    {user.subtitle && <Typography variant=\"caption\" color=\"text.secondary\" component=\"p\" noWrap>{user.subtitle}</Typography>}\n                </Box>\n                {/* los ajustes de la app (letra, idioma, claro u oscuro y los del proyecto): en la cuenta y no sueltos en la barra */}\n                {settings && <Divider />}\n                {settings && <Box sx={{py: 0.5}}>{settings}</Box>}\n                {menuLinks.length > 0 && <Divider />}\n                {menuLinks.map((menuLink) => {\n                    const Icon = menuLink.Icon;\n                    const linkProps = menuLink.to ? {component: RouterLink, to: menuLink.to} : {};\n                    return (\n                        <MenuItem key={menuLink.to ?? menuItemLabelOf(menuLink, t)} {...linkProps}\n                                  onClick={() => {\n                                      closeMenu();\n                                      menuLink.onClick?.();\n                                  }}>\n                            {Icon && <ListItemIcon><Icon fontSize=\"small\" /></ListItemIcon>}\n                            <ListItemText primary={menuItemLabelOf(menuLink, t)} />\n                        </MenuItem>\n                    );\n                })}\n                {onSignOut && <Divider />}\n                {onSignOut && (\n                    <MenuItem onClick={signOut} disabled={isSigningOut}>\n                        <ListItemIcon><LogoutIcon fontSize=\"small\" /></ListItemIcon>\n                        <ListItemText primary={t('signOut')} />\n                    </MenuItem>\n                )}\n            </Menu>\n        </>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAiCA,SAAwB,YAAY,EAAC,MAAM,aAAa,mBAAmB,IAAI,WAAW,eAAe,OAAO,YAAW;AACvH,QAAM,EAAC,EAAA,IAAK,sBAAsB,QAAQ;AAC1C,QAAM,EAAC,MAAM,WAAA,IAAc,qBAAA;AAC3B,QAAM,CAAC,eAAe,gBAAgB,IAAI,SAAS,IAAI;AACvD,QAAM,YAAY,MAAM,iBAAiB,IAAI;AAC7C,QAAM,YAAY;AAAA,IACd,GAAI,cAAc,CAAC,EAAC,IAAI,aAAa,UAAU,4BAA4B,MAAM,kBAAA,CAAkB,IAAI,CAAA;AAAA,IACvG,GAAG;AAAA,EAAA;AAIP,QAAM,YAAY,mBAAmB,aAAa;AAElD,QAAM,UAAU,MAAM;AAClB,cAAA;AACA,cAAA;AAAA,EACJ;AAEA,SACI,qBAAA,UAAA,EACI,UAAA;AAAA,IAAA,oBAAC,SAAA,EAAQ,OAAO,EAAE,cAAc,GAC5B,8BAAC,YAAA,EAAW,MAAK,SAAQ,cAAY,EAAE,cAAc,GAAG,iBAAc,QAAO,SAAS,CAAC,UAAU,iBAAiB,MAAM,aAAa,GAAG,IAAI,EAAC,GAAG,IAAA,GAC5I,UAAA,oBAAC,QAAA,EAAO,KAAK,KAAK,WAAW,KAAI,IAAG,IAAI,EAAC,OAAO,IAAI,QAAQ,IAAI,UAAU,YAAY,SAAS,kBAAkB,OAAO,yBAAA,GACnH,qBAAW,KAAK,IAAI,GACzB,EAAA,CACJ,EAAA,CACJ;AAAA,IACA;AAAA,MAAC;AAAA,MAAA;AAAA,QAAK,UAAU;AAAA,QAAe,MAAM,QAAQ,aAAa;AAAA,QAAG,SAAS;AAAA,QAChE,cAAc,UAAU;AAAA,QAAc,iBAAiB,UAAU;AAAA,QACjE,WAAW,EAAC,OAAO,EAAC,IAAI,EAAC,UAAU,WAAW,MAAM,KAAK,UAAU,KAAK,GAAG,UAAU,MAAA,IAAM;AAAA,QAC7F,UAAA;AAAA,UAAA,qBAAC,OAAI,IAAI,EAAC,IAAI,GAAG,IAAI,QACjB,UAAA;AAAA,YAAA,oBAAC,YAAA,EAAW,SAAQ,aAAY,QAAM,MAAC,IAAI,EAAC,YAAY,IAAA,GAAO,UAAA,KAAK,KAAA,CAAK;AAAA,YACxE,KAAK,SAAS,oBAAC,YAAA,EAAW,SAAQ,SAAQ,OAAM,kBAAiB,QAAM,MAAE,UAAA,KAAK,MAAA,CAAM;AAAA,YACpF,KAAK,YAAY,oBAAC,YAAA,EAAW,SAAQ,WAAU,OAAM,kBAAiB,WAAU,KAAI,QAAM,MAAE,eAAK,SAAA,CAAS;AAAA,UAAA,GAC/G;AAAA,UAEC,gCAAa,SAAA,EAAQ;AAAA,UACrB,gCAAa,KAAA,EAAI,IAAI,EAAC,IAAI,IAAA,GAAO,UAAA,UAAS;AAAA,UAC1C,UAAU,SAAS,KAAK,oBAAC,SAAA,CAAA,CAAQ;AAAA,UACjC,UAAU,IAAI,CAAC,aAAa;AACzB,kBAAM,OAAO,SAAS;AACtB,kBAAM,YAAY,SAAS,KAAK,EAAC,WAAW,YAAY,IAAI,SAAS,GAAA,IAAM,CAAA;AAC3E,mBACI;AAAA,cAAC;AAAA,cAAA;AAAA,gBAA4D,GAAG;AAAA,gBACtD,SAAS,MAAM;AACX,4BAAA;AACA,2BAAS,UAAA;AAAA,gBACb;AAAA,gBACL,UAAA;AAAA,kBAAA,4BAAS,cAAA,EAAa,UAAA,oBAAC,MAAA,EAAK,UAAS,SAAQ,GAAE;AAAA,sCAC/C,cAAA,EAAa,SAAS,gBAAgB,UAAU,CAAC,EAAA,CAAG;AAAA,gBAAA;AAAA,cAAA;AAAA,cAN1C,SAAS,MAAM,gBAAgB,UAAU,CAAC;AAAA,YAAA;AAAA,UASjE,CAAC;AAAA,UACA,iCAAc,SAAA,EAAQ;AAAA,UACtB,aACG,qBAAC,UAAA,EAAS,SAAS,SAAS,UAAU,cAClC,UAAA;AAAA,YAAA,oBAAC,cAAA,EAAa,UAAA,oBAAC,YAAA,EAAW,UAAS,SAAQ,GAAE;AAAA,YAC7C,oBAAC,cAAA,EAAa,SAAS,EAAE,SAAS,EAAA,CAAG;AAAA,UAAA,EAAA,CACzC;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAER,GACJ;AAER;"}