@stackcraftmx/calcita 0.0.0-stage → 0.25.0

package/dist/dates.js

@@ -0,0 +1,25 @@
+const PLAIN_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+function parseInstant(value) {
+  if (value === null || value === void 0 || value === "") {
+    return null;
+  }
+  const instant = new Date(value);
+  return Number.isNaN(instant.getTime()) ? null : instant;
+}
+function parsePlainDate(value) {
+  const match = typeof value === "string" ? PLAIN_DATE_PATTERN.exec(value) : null;
+  if (!match) {
+    return null;
+  }
+  const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
+  const calendarDate = new Date(Date.UTC(year, month - 1, day));
+  if (calendarDate.getUTCMonth() !== month - 1 || calendarDate.getUTCDate() !== day) {
+    return null;
+  }
+  return { year, month, day };
+}
+export {
+  parseInstant,
+  parsePlainDate
+};
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sources":["../src/dates.js"],"sourcesContent":["// Fechas que llegan del API, leídas sin librería (Date + Intl).\n//\n// La zona en que se pintan las horas es la del proveedor (`timeZone` de ToolkitProvider; por omisión la del navegador).\n// Un negocio que decide sus cortes en una zona fija la pasa ahí, para que alguien que abre la pantalla desde otra zona\n// vea la misma hora que ve operación.\n//\n// El backend manda instantes ISO con desfase (UTC) y fechas de calendario sin hora (\"2026-08-16\"). Son dos cosas\n// distintas:\n//   - un instante es un punto en el tiempo (parseInstant); la zona del negocio la aplica Intl con timeZone al\n//     pintarlo (formatting.js), así que aquí no se convierte nada;\n//   - una fecha de calendario NO tiene zona: pasarla por Date la podría correr un día (parsePlainDate la separa en\n//     año, mes y día).\n//\n// Funciones puras, no renderizan: function (regla de la casa).\n\nconst PLAIN_DATE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\n/**\n * Un instante (ISO con desfase, milisegundos o Date) como Date válido.\n *\n * @param {string|Date|number|null|undefined} value\n * @returns {Date|null} null si no hay dato o no es una fecha válida\n */\nexport function parseInstant(value) {\n    if (value === null || value === undefined || value === '') {\n        return null;\n    }\n    const instant = new Date(value);\n    return Number.isNaN(instant.getTime()) ? null : instant;\n}\n\n/**\n * Una fecha de calendario (\"2026-08-16\") en sus partes, sin moverla de zona.\n *\n * @param {string|null|undefined} value\n * @returns {{year: number, month: number, day: number}|null} null si no tiene la forma o no existe (2026-02-31)\n */\nexport function parsePlainDate(value) {\n    const match = typeof value === 'string' ? PLAIN_DATE_PATTERN.exec(value) : null;\n    if (!match) {\n        return null;\n    }\n    const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];\n    // guard clause: Date.UTC \"arregla\" el 31 de febrero pasándolo a marzo; si el día cambió, la fecha no existe\n    const calendarDate = new Date(Date.UTC(year, month - 1, day));\n    if (calendarDate.getUTCMonth() !== month - 1 || calendarDate.getUTCDate() !== day) {\n        return null;\n    }\n    return {year, month, day};\n}\n"],"names":[],"mappings":"AAeA,MAAM,qBAAqB;AAQpB,SAAS,aAAa,OAAO;AAChC,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,IAAI;AACvD,WAAO;AAAA,EACX;AACA,QAAM,UAAU,IAAI,KAAK,KAAK;AAC9B,SAAO,OAAO,MAAM,QAAQ,QAAO,CAAE,IAAI,OAAO;AACpD;AAQO,SAAS,eAAe,OAAO;AAClC,QAAM,QAAQ,OAAO,UAAU,WAAW,mBAAmB,KAAK,KAAK,IAAI;AAC3E,MAAI,CAAC,OAAO;AACR,WAAO;AAAA,EACX;AACA,QAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC;AAEhF,QAAM,eAAe,IAAI,KAAK,KAAK,IAAI,MAAM,QAAQ,GAAG,GAAG,CAAC;AAC5D,MAAI,aAAa,YAAW,MAAO,QAAQ,KAAK,aAAa,WAAU,MAAO,KAAK;AAC/E,WAAO;AAAA,EACX;AACA,SAAO,EAAC,MAAM,OAAO,IAAG;AAC5B;"}

package/dist/dictionaries/dictionaries.js

@@ -0,0 +1,48 @@
+import { createLogger } from "../observability/logger.js";
+const log = createLogger("dictionaries");
+const NAMESPACE = "dictionaries";
+const UNKNOWN_ENTRY = Object.freeze({
+  value: null,
+  labelKey: `${NAMESPACE}:unknown.label`,
+  tooltipKey: `${NAMESPACE}:unknown.tooltip`,
+  color: "default",
+  isKnown: false
+});
+function dictionaryEntryOf(value, keyPrefix, color, { hasShortLabel = false } = {}) {
+  return Object.freeze({
+    value,
+    labelKey: `${NAMESPACE}:${keyPrefix}.label`,
+    tooltipKey: `${NAMESPACE}:${keyPrefix}.tooltip`,
+    ...hasShortLabel ? { shortLabelKey: `${NAMESPACE}:${keyPrefix}.shortLabel` } : {},
+    color,
+    isKnown: true
+  });
+}
+function lookup(dictionary, value) {
+  if (value !== null && value !== void 0 && Object.hasOwn(dictionary, value)) {
+    return dictionary[value];
+  }
+  if (value !== null && value !== void 0) {
+    log.warn("valor sin entrada en el diccionario", { value });
+  }
+  return { ...UNKNOWN_ENTRY, value: value ?? null };
+}
+function labelOf(dictionaryEntry, translate) {
+  if (dictionaryEntry.isKnown || dictionaryEntry.value === null) {
+    return translate(dictionaryEntry.labelKey);
+  }
+  return dictionaryEntry.value;
+}
+function shortLabelOf(dictionaryEntry, translate) {
+  if (dictionaryEntry.isKnown && dictionaryEntry.shortLabelKey) {
+    return translate(dictionaryEntry.shortLabelKey);
+  }
+  return labelOf(dictionaryEntry, translate);
+}
+export {
+  dictionaryEntryOf,
+  labelOf,
+  lookup,
+  shortLabelOf
+};
+//# sourceMappingURL=dictionaries.js.map

package/dist/dictionaries/dictionaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaries.js","sources":["../../src/dictionaries/dictionaries.js"],"sourcesContent":["// Diccionarios de valores cerrados que llegan del API → etiqueta, tooltip y color del chip (StatusChip, DictionaryText).\n//\n// El paquete trae el mecanismo; los diccionarios los arma cada proyecto con dictionaryEntryOf:\n//\n//   export const ORDER_STATUS = Object.freeze({\n//       pending: dictionaryEntryOf('pending', 'orderStatus.pending', 'warning'),\n//       paid: dictionaryEntryOf('paid', 'orderStatus.paid', 'success'),\n//   });\n//\n// Forma de cada entrada: {value, labelKey, tooltipKey, color, isKnown} y, solo en algunas, shortLabelKey\n//   - value: el código del API tal cual.\n//   - labelKey / tooltipKey: llaves de texto del namespace \"dictionaries\" (los textos los pone el proyecto con `texts` o\n//     `translate` de ToolkitProvider). El texto NUNCA va aquí: así cambia de idioma sin tocar el diccionario.\n//   - shortLabelKey: palabra corta para una columna angosta («Rechazada» por «Rechazada por estructura»). Solo la traen\n//     las entradas cuyo nombre completo no cabe; quien la pinta deja el nombre completo en el tooltip (StatusChip, short).\n//   - color: color de paleta de MUI (success, warning, error, info, default).\n//   - isKnown: false solo en la entrada \"unknown\"; sirve para pintar el código crudo cuando no hay texto (p. ej. un\n//     estatus nuevo que el backend empezó a mandar).\n//\n// Se congelan con Object.freeze para que nadie los mute por accidente desde una pantalla.\n// Un valor que el API mande y no esté en el diccionario no truena la pantalla: lookup regresa la entrada \"unknown\" y lo\n// anota en el log para agregarlo.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport {createLogger} from '@/observability/logger.js';\n\nconst log = createLogger('dictionaries');\n\nconst NAMESPACE = 'dictionaries';\n\nconst UNKNOWN_ENTRY = Object.freeze({\n    value: null,\n    labelKey: `${NAMESPACE}:unknown.label`,\n    tooltipKey: `${NAMESPACE}:unknown.tooltip`,\n    color: 'default',\n    isKnown: false,\n});\n\n/**\n * Una entrada de diccionario, congelada.\n *\n * @param {string} value el código del API\n * @param {string} keyPrefix dónde viven sus textos dentro del namespace dictionaries ('orderStatus.paid' → orderStatus.paid.label)\n * @param {string} color color de paleta de MUI\n * @param {{hasShortLabel?: boolean}} [options] hasShortLabel: trae palabra corta (keyPrefix.shortLabel)\n * @returns {{value: string, labelKey: string, tooltipKey: string, shortLabelKey?: string, color: string, isKnown: boolean}}\n */\nexport function dictionaryEntryOf(value, keyPrefix, color, {hasShortLabel = false} = {}) {\n    return Object.freeze({\n        value,\n        labelKey: `${NAMESPACE}:${keyPrefix}.label`,\n        tooltipKey: `${NAMESPACE}:${keyPrefix}.tooltip`,\n        ...(hasShortLabel ? {shortLabelKey: `${NAMESPACE}:${keyPrefix}.shortLabel`} : {}),\n        color,\n        isKnown: true,\n    });\n}\n\n/**\n * La entrada del diccionario para un valor del API.\n *\n * @param {Record<string, object>} dictionary p. ej. ORDER_STATUS\n * @param {string|null|undefined} value código del API\n * @returns {{value: string|null, labelKey: string, tooltipKey: string, color: string, isKnown: boolean}}\n */\nexport function lookup(dictionary, value) {\n    if (value !== null && value !== undefined && Object.hasOwn(dictionary, value)) {\n        return dictionary[value];\n    }\n    if (value !== null && value !== undefined) {\n        log.warn('valor sin entrada en el diccionario', {value});\n    }\n    return {...UNKNOWN_ENTRY, value: value ?? null};\n}\n\n/**\n * Texto que se pinta para una entrada: su etiqueta traducida o, si el valor no está en el diccionario, el código\n * crudo. Un estatus nuevo se lee con su código y no como \"Sin estatus\".\n *\n * @param {{value: string|null, labelKey: string, isKnown: boolean}} dictionaryEntry lo que regresa lookup\n * @param {(key: string) => string} translate el t de useToolkitTranslation\n * @returns {string}\n */\nexport function labelOf(dictionaryEntry, translate) {\n    if (dictionaryEntry.isKnown || dictionaryEntry.value === null) {\n        return translate(dictionaryEntry.labelKey);\n    }\n    return dictionaryEntry.value;\n}\n\n/**\n * La palabra corta de una entrada, para una columna angosta. Una entrada sin palabra corta regresa su etiqueta de siempre.\n *\n * @param {object} dictionaryEntry entrada del diccionario (lookup)\n * @param {Function} translate traductor\n * @returns {string}\n */\nexport function shortLabelOf(dictionaryEntry, translate) {\n    if (dictionaryEntry.isKnown && dictionaryEntry.shortLabelKey) {\n        return translate(dictionaryEntry.shortLabelKey);\n    }\n    return labelOf(dictionaryEntry, translate);\n}\n"],"names":[],"mappings":";AA0BA,MAAM,MAAM,aAAa,cAAc;AAEvC,MAAM,YAAY;AAElB,MAAM,gBAAgB,OAAO,OAAO;AAAA,EAChC,OAAO;AAAA,EACP,UAAU,GAAG,SAAS;AAAA,EACtB,YAAY,GAAG,SAAS;AAAA,EACxB,OAAO;AAAA,EACP,SAAS;AACb,CAAC;AAWM,SAAS,kBAAkB,OAAO,WAAW,OAAO,EAAC,gBAAgB,MAAK,IAAI,IAAI;AACrF,SAAO,OAAO,OAAO;AAAA,IACjB;AAAA,IACA,UAAU,GAAG,SAAS,IAAI,SAAS;AAAA,IACnC,YAAY,GAAG,SAAS,IAAI,SAAS;AAAA,IACrC,GAAI,gBAAgB,EAAC,eAAe,GAAG,SAAS,IAAI,SAAS,cAAa,IAAI;IAC9E;AAAA,IACA,SAAS;AAAA,EACjB,CAAK;AACL;AASO,SAAS,OAAO,YAAY,OAAO;AACtC,MAAI,UAAU,QAAQ,UAAU,UAAa,OAAO,OAAO,YAAY,KAAK,GAAG;AAC3E,WAAO,WAAW,KAAK;AAAA,EAC3B;AACA,MAAI,UAAU,QAAQ,UAAU,QAAW;AACvC,QAAI,KAAK,uCAAuC,EAAC,MAAK,CAAC;AAAA,EAC3D;AACA,SAAO,EAAC,GAAG,eAAe,OAAO,SAAS,KAAI;AAClD;AAUO,SAAS,QAAQ,iBAAiB,WAAW;AAChD,MAAI,gBAAgB,WAAW,gBAAgB,UAAU,MAAM;AAC3D,WAAO,UAAU,gBAAgB,QAAQ;AAAA,EAC7C;AACA,SAAO,gBAAgB;AAC3B;AASO,SAAS,aAAa,iBAAiB,WAAW;AACrD,MAAI,gBAAgB,WAAW,gBAAgB,eAAe;AAC1D,WAAO,UAAU,gBAAgB,aAAa;AAAA,EAClD;AACA,SAAO,QAAQ,iBAAiB,SAAS;AAC7C;"}

package/dist/downloads/DownloadManager.js

@@ -0,0 +1,195 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState, useRef, useEffect, Fragment } from "react";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import { useSelector } from "@xstate/react";
+import Box from "@mui/material/Box";
+import CircularProgress from "@mui/material/CircularProgress";
+import Collapse from "@mui/material/Collapse";
+import Divider from "@mui/material/Divider";
+import IconButton from "@mui/material/IconButton";
+import List from "@mui/material/List";
+import ListItem from "@mui/material/ListItem";
+import Paper from "@mui/material/Paper";
+import Slide from "@mui/material/Slide";
+import Stack from "@mui/material/Stack";
+import Tooltip from "@mui/material/Tooltip";
+import Typography from "@mui/material/Typography";
+import BlockOutlinedIcon from "@mui/icons-material/BlockOutlined";
+import CheckCircleIcon from "@mui/icons-material/CheckCircle";
+import CloseIcon from "@mui/icons-material/Close";
+import ErrorOutlineIcon from "@mui/icons-material/ErrorOutline";
+import ExpandLessIcon from "@mui/icons-material/ExpandLess";
+import ExpandMoreIcon from "@mui/icons-material/ExpandMore";
+import { downloadsActor, countActiveDownloads, clearFinishedDownloads, cancelDownload } from "./downloadQueue.js";
+import { useFileTypes, UNKNOWN_FILE_TYPE } from "./fileTypes.js";
+import { DOWNLOAD_STATUS } from "./downloadsMachine.js";
+import { useFormatters } from "../toolkit/useFormatters.js";
+import { isGlassTheme, glassStylesOf } from "../theme/glassSurface.js";
+import ComponentTexts from "../toolkit/ComponentTexts.js";
+const AUTO_DISMISS_MILLISECONDS = 5e3;
+const SCREEN_EDGE_SPACING = 3;
+const PANEL_WIDTH_PIXELS = 360;
+const LIST_MAX_HEIGHT = "40vh";
+const PROGRESS_RING_PIXELS = 22;
+function fileTypeAppearanceOf(download, fileTypes) {
+  const extension = download.fileName?.split(".").pop()?.toLowerCase();
+  const fileType = fileTypes[download.format ?? extension];
+  return fileType ? { Icon: fileType.Icon ?? UNKNOWN_FILE_TYPE.Icon, color: fileType.color ?? UNKNOWN_FILE_TYPE.color } : UNKNOWN_FILE_TYPE;
+}
+function detailTextOf(download, t, formatFileSize) {
+  if (download.status === DOWNLOAD_STATUS.completed) {
+    return formatFileSize(download.loadedBytes);
+  }
+  if (download.status === DOWNLOAD_STATUS.failed) {
+    return download.errorMessage ?? t("downloads.failed");
+  }
+  if (download.status === DOWNLOAD_STATUS.canceled) {
+    return t("downloads.canceled");
+  }
+  if (download.loadedBytes === 0) {
+    return t("downloads.preparing");
+  }
+  return download.totalBytes ? t("downloads.progressOf", { loaded: formatFileSize(download.loadedBytes), total: formatFileSize(download.totalBytes) }) : t("downloads.progressLoaded", { loaded: formatFileSize(download.loadedBytes) });
+}
+function summaryTextOf(downloads, t) {
+  const activeCount = countActiveDownloads(downloads);
+  if (activeCount > 0) {
+    return t("downloads.summaryDownloading", { count: activeCount });
+  }
+  const failedCount = downloads.filter((download) => download.status === DOWNLOAD_STATUS.failed).length;
+  if (failedCount > 0) {
+    return t("downloads.summaryFailed", { count: failedCount });
+  }
+  const completedCount = downloads.filter((download) => download.status === DOWNLOAD_STATUS.completed).length;
+  return t("downloads.summaryCompleted", { count: completedCount });
+}
+function DownloadStatusIndicator({ download, displayName }) {
+  const { t } = useToolkitTranslation("common");
+  if (download.status === DOWNLOAD_STATUS.completed) {
+    return /* @__PURE__ */ jsx(CheckCircleIcon, { sx: { color: "success.main" }, "aria-label": t("downloads.completedOf", { name: displayName }) });
+  }
+  if (download.status === DOWNLOAD_STATUS.failed) {
+    return /* @__PURE__ */ jsx(ErrorOutlineIcon, { sx: { color: "error.main" }, "aria-label": t("downloads.failedOf", { name: displayName }) });
+  }
+  if (download.status === DOWNLOAD_STATUS.canceled) {
+    return /* @__PURE__ */ jsx(BlockOutlinedIcon, { sx: { color: "text.disabled" }, "aria-label": t("downloads.canceledOf", { name: displayName }) });
+  }
+  const hasKnownSize = Boolean(download.totalBytes);
+  return /* @__PURE__ */ jsx(Tooltip, { title: t("downloads.cancel"), children: /* @__PURE__ */ jsxs(
+    IconButton,
+    {
+      size: "small",
+      "aria-label": t("downloads.cancelOf", { name: displayName }),
+      onClick: () => cancelDownload(download.id),
+      sx: { position: "relative", width: PROGRESS_RING_PIXELS + 10, height: PROGRESS_RING_PIXELS + 10 },
+      children: [
+        /* @__PURE__ */ jsx(
+          CircularProgress,
+          {
+            size: PROGRESS_RING_PIXELS,
+            thickness: 4,
+            variant: hasKnownSize ? "determinate" : "indeterminate",
+            value: hasKnownSize ? Math.min(100, download.loadedBytes * 100 / download.totalBytes) : void 0,
+            sx: { position: "absolute" }
+          }
+        ),
+        /* @__PURE__ */ jsx(CloseIcon, { sx: { fontSize: 12 } })
+      ]
+    }
+  ) });
+}
+function DownloadRow({ download }) {
+  const { t } = useToolkitTranslation("common");
+  const { formatFileSize } = useFormatters();
+  const { Icon, color } = fileTypeAppearanceOf(download, useFileTypes());
+  const displayName = download.fileName ?? download.label;
+  const isFailed = download.status === DOWNLOAD_STATUS.failed;
+  return (
+    // minWidth 0: sin él un nombre largo empuja el renglón y la lista enseña una barra horizontal
+    /* @__PURE__ */ jsxs(ListItem, { disableGutters: true, sx: { gap: 1.5, px: 2, py: 1, minWidth: 0 }, children: [
+      /* @__PURE__ */ jsx(Icon, { fontSize: "small", sx: { color, flexShrink: 0 } }),
+      /* @__PURE__ */ jsxs(Box, { sx: { minWidth: 0, flex: 1 }, children: [
+        /* @__PURE__ */ jsx(Tooltip, { title: displayName, children: /* @__PURE__ */ jsx(Typography, { variant: "body2", noWrap: true, children: displayName }) }),
+        /* @__PURE__ */ jsx(
+          Typography,
+          {
+            variant: "caption",
+            component: "p",
+            noWrap: !isFailed,
+            sx: { color: isFailed ? "error.main" : "text.secondary" },
+            children: detailTextOf(download, t, formatFileSize)
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx(Box, { sx: { flexShrink: 0, display: "flex", alignItems: "center" }, children: /* @__PURE__ */ jsx(DownloadStatusIndicator, { download, displayName }) })
+    ] })
+  );
+}
+function DownloadManager({ texts } = {}) {
+  const { t } = useToolkitTranslation("common", texts);
+  const downloads = useSelector(downloadsActor, (snapshot) => snapshot.context.downloads);
+  const [isExpanded, setIsExpanded] = useState(true);
+  const previousCountRef = useRef(downloads.length);
+  const activeCount = countActiveDownloads(downloads);
+  const allSucceeded = downloads.length > 0 && downloads.every((download) => download.status === DOWNLOAD_STATUS.completed);
+  useEffect(() => {
+    if (downloads.length > previousCountRef.current) {
+      setIsExpanded(true);
+    }
+    previousCountRef.current = downloads.length;
+  }, [downloads.length]);
+  useEffect(() => {
+    if (!allSucceeded) {
+      return void 0;
+    }
+    const dismissTimer = setTimeout(clearFinishedDownloads, AUTO_DISMISS_MILLISECONDS);
+    return () => clearTimeout(dismissTimer);
+  }, [allSucceeded, downloads.length]);
+  return /* @__PURE__ */ jsx(ComponentTexts, { namespace: "common", texts, children: /* @__PURE__ */ jsx(Slide, { direction: "up", in: downloads.length > 0, mountOnEnter: true, unmountOnExit: true, children: /* @__PURE__ */ jsxs(
+    Paper,
+    {
+      elevation: 8,
+      role: "region",
+      "aria-label": t("downloads.title"),
+      sx: [{
+        position: "fixed",
+        right: (theme) => theme.spacing(SCREEN_EDGE_SPACING),
+        bottom: 0,
+        width: (theme) => `min(${PANEL_WIDTH_PIXELS}px, calc(100vw - ${theme.spacing(SCREEN_EDGE_SPACING * 2)}))`,
+        // pegado al borde de abajo como en Drive: solo se redondean las esquinas de arriba
+        borderBottomLeftRadius: 0,
+        borderBottomRightRadius: 0,
+        overflow: "hidden",
+        zIndex: (theme) => theme.zIndex.snackbar
+      }, (theme) => isGlassTheme(theme) ? glassStylesOf(theme) : {}],
+      children: [
+        /* @__PURE__ */ jsxs(Stack, { direction: "row", sx: { alignItems: "center", gap: 0.5, pl: 2, pr: 1, py: 1, bgcolor: "action.hover" }, children: [
+          /* @__PURE__ */ jsx(Typography, { variant: "subtitle2", component: "h2", noWrap: true, sx: { flex: 1 }, "aria-live": "polite", children: summaryTextOf(downloads, t) }),
+          /* @__PURE__ */ jsx(Tooltip, { title: isExpanded ? t("downloads.collapse") : t("downloads.expand"), children: /* @__PURE__ */ jsx(
+            IconButton,
+            {
+              size: "small",
+              "aria-expanded": isExpanded,
+              "aria-label": isExpanded ? t("downloads.collapse") : t("downloads.expand"),
+              onClick: () => setIsExpanded((wasExpanded) => !wasExpanded),
+              children: isExpanded ? /* @__PURE__ */ jsx(ExpandMoreIcon, { fontSize: "small" }) : /* @__PURE__ */ jsx(ExpandLessIcon, { fontSize: "small" })
+            }
+          ) }),
+          activeCount === 0 && /* @__PURE__ */ jsx(Tooltip, { title: t("downloads.close"), children: /* @__PURE__ */ jsx(IconButton, { size: "small", "aria-label": t("downloads.close"), onClick: clearFinishedDownloads, children: /* @__PURE__ */ jsx(CloseIcon, { fontSize: "small" }) }) })
+        ] }),
+        /* @__PURE__ */ jsxs(Collapse, { in: isExpanded, children: [
+          /* @__PURE__ */ jsx(Divider, {}),
+          /* @__PURE__ */ jsx(List, { dense: true, disablePadding: true, sx: { maxHeight: LIST_MAX_HEIGHT, overflowY: "auto", overflowX: "hidden" }, children: downloads.map((download, index) => /* @__PURE__ */ jsxs(Fragment, { children: [
+            index > 0 && /* @__PURE__ */ jsx(Divider, { component: "li" }),
+            /* @__PURE__ */ jsx(DownloadRow, { download })
+          ] }, download.id)) })
+        ] })
+      ]
+    }
+  ) }) });
+}
+export {
+  DownloadManager as default
+};
+//# sourceMappingURL=DownloadManager.js.map

package/dist/downloads/DownloadManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DownloadManager.js","sources":["../../src/downloads/DownloadManager.jsx"],"sourcesContent":["// Panel de descargas al estilo de Google Drive: se pega abajo a la derecha SOLO mientras hay descargas, con una barra que\n// resume («Descargando 2 archivos…», «3 descargas listas») y la lista con el ícono del tipo de archivo y un anillo de\n// avance que termina en ✓. Con MUI y XState, sin Redux.\n//\n// Qué hace para no hacer ruido:\n//   - no hay botón fijo: sin descargas no se pinta nada;\n//   - se pliega a la barra con la flecha y se vuelve a abrir cuando entra otra descarga;\n//   - cuando todo terminó bien se va solo a los AUTO_DISMISS_MILLISECONDS; si algo falló o se canceló se queda hasta que\n//     la persona lo cierra, para que vea el motivo;\n//   - la X solo aparece cuando ya nada descarga (cerrar a media descarga dejaría el archivo sin aviso de que terminó).\n//\n// Se monta UNA sola vez en la raíz de la aplicación. Lee la lista de downloadsActor; las descargas las arranca startDownload desde cada\n// pantalla. Los avisos (sonner) salen abajo a la izquierda, así que el panel va a la derecha.\n// Con el vidrio del tema (createToolkitTheme({glass: true})) el panel es de vidrio: flota sobre la pantalla.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {Fragment, useEffect, useRef, useState} from 'react';\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport {useSelector} from '@xstate/react';\nimport Box from '@mui/material/Box';\nimport CircularProgress from '@mui/material/CircularProgress';\nimport Collapse from '@mui/material/Collapse';\nimport Divider from '@mui/material/Divider';\nimport IconButton from '@mui/material/IconButton';\nimport List from '@mui/material/List';\nimport ListItem from '@mui/material/ListItem';\nimport Paper from '@mui/material/Paper';\nimport Slide from '@mui/material/Slide';\nimport Stack from '@mui/material/Stack';\nimport Tooltip from '@mui/material/Tooltip';\nimport Typography from '@mui/material/Typography';\nimport BlockOutlinedIcon from '@mui/icons-material/BlockOutlined';\nimport CheckCircleIcon from '@mui/icons-material/CheckCircle';\nimport CloseIcon from '@mui/icons-material/Close';\nimport ErrorOutlineIcon from '@mui/icons-material/ErrorOutline';\nimport ExpandLessIcon from '@mui/icons-material/ExpandLess';\nimport ExpandMoreIcon from '@mui/icons-material/ExpandMore';\n\nimport {cancelDownload, clearFinishedDownloads, countActiveDownloads, downloadsActor} from '@/downloads/downloadQueue.js';\nimport {UNKNOWN_FILE_TYPE, useFileTypes} from '@/downloads/fileTypes.js';\nimport {DOWNLOAD_STATUS} from '@/downloads/downloadsMachine.js';\nimport {useFormatters} from '@/toolkit/useFormatters.js';\nimport {glassStylesOf, isGlassTheme} from '@/theme/glassSurface.js';\nimport ComponentTexts from '@/toolkit/ComponentTexts.jsx';\n\n// cuánto se queda el panel después de que TODAS las descargas terminaron bien\nconst AUTO_DISMISS_MILLISECONDS = 5000;\n\n// separación del borde derecho y ancho del panel (en el teléfono ocupa el ancho menos los márgenes)\nconst SCREEN_EDGE_SPACING = 3;\nconst PANEL_WIDTH_PIXELS = 360;\nconst LIST_MAX_HEIGHT = '40vh';\nconst PROGRESS_RING_PIXELS = 22;\n\n/**\n * Tipo de archivo de una descarga: el que dijo quien la arrancó o, al terminar, la extensión del nombre. Los tipos son los de\n * la casa y los del proyecto (ToolkitProvider fileTypes).\n *\n * @param {object} download renglón de la lista (downloadsMachine)\n * @param {Record<string, {Icon: import('react').ElementType, color?: string}>} fileTypes\n * @returns {{Icon: import('react').ElementType, color: string}}\n */\nfunction fileTypeAppearanceOf(download, fileTypes) {\n    const extension = download.fileName?.split('.').pop()?.toLowerCase();\n    const fileType = fileTypes[download.format ?? extension];\n    return fileType ? {Icon: fileType.Icon ?? UNKNOWN_FILE_TYPE.Icon, color: fileType.color ?? UNKNOWN_FILE_TYPE.color} : UNKNOWN_FILE_TYPE;\n}\n\n/**\n * Segunda línea del renglón: cuánto lleva, cuánto pesó o por qué no se pudo.\n *\n * @param {object} download\n * @param {Function} t traductor de common\n * @param {(bytes: number) => string} formatFileSize el de useFormatters (el idioma del proveedor más cercano)\n * @returns {string}\n */\nfunction detailTextOf(download, t, formatFileSize) {\n    if (download.status === DOWNLOAD_STATUS.completed) {\n        return formatFileSize(download.loadedBytes);\n    }\n    if (download.status === DOWNLOAD_STATUS.failed) {\n        return download.errorMessage ?? t('downloads.failed');\n    }\n    if (download.status === DOWNLOAD_STATUS.canceled) {\n        return t('downloads.canceled');\n    }\n    if (download.loadedBytes === 0) {\n        return t('downloads.preparing');\n    }\n    // un archivo que se arma al vuelo (el log) no dice su tamaño: se enseña lo que ya bajó\n    return download.totalBytes\n        ? t('downloads.progressOf', {loaded: formatFileSize(download.loadedBytes), total: formatFileSize(download.totalBytes)})\n        : t('downloads.progressLoaded', {loaded: formatFileSize(download.loadedBytes)});\n}\n\n/**\n * Resumen de la barra, como en Drive: lo que está pasando ahora o cómo terminó.\n *\n * @param {Array<object>} downloads\n * @param {Function} t traductor de common\n * @returns {string}\n */\nfunction summaryTextOf(downloads, t) {\n    const activeCount = countActiveDownloads(downloads);\n    if (activeCount > 0) {\n        return t('downloads.summaryDownloading', {count: activeCount});\n    }\n    const failedCount = downloads.filter((download) => download.status === DOWNLOAD_STATUS.failed).length;\n    if (failedCount > 0) {\n        return t('downloads.summaryFailed', {count: failedCount});\n    }\n    const completedCount = downloads.filter((download) => download.status === DOWNLOAD_STATUS.completed).length;\n    return t('downloads.summaryCompleted', {count: completedCount});\n}\n\n/**\n * Lo que va a la derecha del renglón: el anillo de avance con su botón para cancelar, o cómo terminó.\n *\n * @param {{download: object, displayName: string}} props\n */\nfunction DownloadStatusIndicator({download, displayName}) {\n    const {t} = useToolkitTranslation('common');\n\n    if (download.status === DOWNLOAD_STATUS.completed) {\n        return <CheckCircleIcon sx={{color: 'success.main'}} aria-label={t('downloads.completedOf', {name: displayName})} />;\n    }\n    if (download.status === DOWNLOAD_STATUS.failed) {\n        return <ErrorOutlineIcon sx={{color: 'error.main'}} aria-label={t('downloads.failedOf', {name: displayName})} />;\n    }\n    if (download.status === DOWNLOAD_STATUS.canceled) {\n        return <BlockOutlinedIcon sx={{color: 'text.disabled'}} aria-label={t('downloads.canceledOf', {name: displayName})} />;\n    }\n\n    const hasKnownSize = Boolean(download.totalBytes);\n    // el anillo y, encima, la X para cancelar: como en Drive, un solo lugar para ver y detener\n    return (\n        <Tooltip title={t('downloads.cancel')}>\n            <IconButton size=\"small\" aria-label={t('downloads.cancelOf', {name: displayName})} onClick={() => cancelDownload(download.id)}\n                        sx={{position: 'relative', width: PROGRESS_RING_PIXELS + 10, height: PROGRESS_RING_PIXELS + 10}}>\n                <CircularProgress\n                    size={PROGRESS_RING_PIXELS}\n                    thickness={4}\n                    variant={hasKnownSize ? 'determinate' : 'indeterminate'}\n                    value={hasKnownSize ? Math.min(100, (download.loadedBytes * 100) / download.totalBytes) : undefined}\n                    sx={{position: 'absolute'}}\n                />\n                <CloseIcon sx={{fontSize: 12}} />\n            </IconButton>\n        </Tooltip>\n    );\n}\n\n/**\n * Un renglón: ícono del tipo de archivo, nombre, detalle y estatus.\n *\n * @param {{download: object}} props\n */\nfunction DownloadRow({download}) {\n    const {t} = useToolkitTranslation('common');\n    const {formatFileSize} = useFormatters();\n    const {Icon, color} = fileTypeAppearanceOf(download, useFileTypes());\n    const displayName = download.fileName ?? download.label;\n    const isFailed = download.status === DOWNLOAD_STATUS.failed;\n\n    return (\n        // minWidth 0: sin él un nombre largo empuja el renglón y la lista enseña una barra horizontal\n        <ListItem disableGutters sx={{gap: 1.5, px: 2, py: 1, minWidth: 0}}>\n            <Icon fontSize=\"small\" sx={{color, flexShrink: 0}} />\n            <Box sx={{minWidth: 0, flex: 1}}>\n                <Tooltip title={displayName}>\n                    <Typography variant=\"body2\" noWrap>{displayName}</Typography>\n                </Tooltip>\n                <Typography variant=\"caption\" component=\"p\" noWrap={!isFailed}\n                            sx={{color: isFailed ? 'error.main' : 'text.secondary'}}>\n                    {detailTextOf(download, t, formatFileSize)}\n                </Typography>\n            </Box>\n            <Box sx={{flexShrink: 0, display: 'flex', alignItems: 'center'}}>\n                <DownloadStatusIndicator download={download} displayName={displayName} />\n            </Box>\n        </ListItem>\n    );\n}\n\n/**\n * @param {object} [props]\n * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete\n */\nexport default function DownloadManager({texts} = {}) {\n    const {t} = useToolkitTranslation('common', texts);\n    const downloads = useSelector(downloadsActor, (snapshot) => snapshot.context.downloads);\n    const [isExpanded, setIsExpanded] = useState(true);\n    const previousCountRef = useRef(downloads.length);\n\n    const activeCount = countActiveDownloads(downloads);\n    const allSucceeded = downloads.length > 0 && downloads.every((download) => download.status === DOWNLOAD_STATUS.completed);\n\n    // una descarga nueva vuelve a desplegar el panel aunque se haya plegado\n    useEffect(() => {\n        if (downloads.length > previousCountRef.current) {\n            setIsExpanded(true);\n        }\n        previousCountRef.current = downloads.length;\n    }, [downloads.length]);\n\n    // todo terminó bien: el panel se va solo (con un error o una cancelada se queda para que se lea)\n    useEffect(() => {\n        if (!allSucceeded) {\n            return undefined;\n        }\n        const dismissTimer = setTimeout(clearFinishedDownloads, AUTO_DISMISS_MILLISECONDS);\n        return () => clearTimeout(dismissTimer);\n    }, [allSucceeded, downloads.length]);\n\n    return (\n        <ComponentTexts namespace=\"common\" texts={texts}>\n            <Slide direction=\"up\" in={downloads.length > 0} mountOnEnter unmountOnExit>\n                <Paper\n                    elevation={8}\n                    role=\"region\"\n                    aria-label={t('downloads.title')}\n                    sx={[{\n                        position: 'fixed',\n                        right: (theme) => theme.spacing(SCREEN_EDGE_SPACING),\n                        bottom: 0,\n                        width: (theme) => `min(${PANEL_WIDTH_PIXELS}px, calc(100vw - ${theme.spacing(SCREEN_EDGE_SPACING * 2)}))`,\n                        // pegado al borde de abajo como en Drive: solo se redondean las esquinas de arriba\n                        borderBottomLeftRadius: 0,\n                        borderBottomRightRadius: 0,\n                        overflow: 'hidden',\n                        zIndex: (theme) => theme.zIndex.snackbar,\n                    }, (theme) => (isGlassTheme(theme) ? glassStylesOf(theme) : {})]}\n                >\n                    <Stack direction=\"row\" sx={{alignItems: 'center', gap: 0.5, pl: 2, pr: 1, py: 1, bgcolor: 'action.hover'}}>\n                        <Typography variant=\"subtitle2\" component=\"h2\" noWrap sx={{flex: 1}} aria-live=\"polite\">\n                            {summaryTextOf(downloads, t)}\n                        </Typography>\n                        <Tooltip title={isExpanded ? t('downloads.collapse') : t('downloads.expand')}>\n                            <IconButton size=\"small\" aria-expanded={isExpanded}\n                                        aria-label={isExpanded ? t('downloads.collapse') : t('downloads.expand')}\n                                        onClick={() => setIsExpanded((wasExpanded) => !wasExpanded)}>\n                                {isExpanded ? <ExpandMoreIcon fontSize=\"small\" /> : <ExpandLessIcon fontSize=\"small\" />}\n                            </IconButton>\n                        </Tooltip>\n                        {/* cerrar a media descarga dejaría el archivo sin aviso de que terminó: la X sale cuando ya nada baja */}\n                        {activeCount === 0 && (\n                            <Tooltip title={t('downloads.close')}>\n                                <IconButton size=\"small\" aria-label={t('downloads.close')} onClick={clearFinishedDownloads}>\n                                    <CloseIcon fontSize=\"small\" />\n                                </IconButton>\n                            </Tooltip>\n                        )}\n                    </Stack>\n                    <Collapse in={isExpanded}>\n                        <Divider />\n                        {/* OJO: overflowY auto también prende el scroll horizontal ante 1 px de más; se apaga explícito */}\n                        <List dense disablePadding sx={{maxHeight: LIST_MAX_HEIGHT, overflowY: 'auto', overflowX: 'hidden'}}>\n                            {downloads.map((download, index) => (\n                                <Fragment key={download.id}>\n                                    {index > 0 && <Divider component=\"li\" />}\n                                    <DownloadRow download={download} />\n                                </Fragment>\n                            ))}\n                        </List>\n                    </Collapse>\n                </Paper>\n            </Slide>\n        </ComponentTexts>\n    );\n}\n"],"names":[],"mappings":"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"}

package/dist/downloads/downloadQueue.js

@@ -0,0 +1,56 @@
+import { createActor } from "xstate";
+import { downloadsMachine, DOWNLOAD_STATUS } from "./downloadsMachine.js";
+import { saveBlob } from "../files.js";
+import { newIdentifier } from "../identifiers.js";
+const downloadsActor = createActor(downloadsMachine).start();
+const abortControllerByDownloadId = /* @__PURE__ */ new Map();
+async function startDownload({ label, format, request, onCompleted, onFailed, onCanceled }) {
+  const downloadId = newIdentifier();
+  const abortController = new AbortController();
+  abortControllerByDownloadId.set(downloadId, abortController);
+  downloadsActor.send({ type: "STARTED", id: downloadId, label, format });
+  try {
+    const { blob, fileName } = await request({
+      signal: abortController.signal,
+      // la petición avisa cada pedazo que llega; total viene en null cuando el servidor arma el archivo al vuelo (sin
+      // Content-Length) y el panel enseña lo que lleva en vez del porcentaje
+      onDownloadProgress: (progressEvent) => downloadsActor.send({
+        type: "PROGRESSED",
+        id: downloadId,
+        loadedBytes: progressEvent.loaded,
+        totalBytes: progressEvent.total
+      })
+    });
+    saveBlob(blob, fileName);
+    downloadsActor.send({ type: "COMPLETED", id: downloadId, fileName, sizeBytes: blob.size });
+    onCompleted?.(fileName);
+  } catch (error) {
+    if (abortController.signal.aborted) {
+      downloadsActor.send({ type: "CANCELED", id: downloadId });
+      onCanceled?.();
+    } else {
+      downloadsActor.send({ type: "FAILED", id: downloadId, errorMessage: error?.message ?? null });
+      onFailed?.(error);
+    }
+  } finally {
+    abortControllerByDownloadId.delete(downloadId);
+  }
+  return downloadId;
+}
+function cancelDownload(downloadId) {
+  abortControllerByDownloadId.get(downloadId)?.abort();
+}
+function clearFinishedDownloads() {
+  downloadsActor.send({ type: "CLEAR_FINISHED" });
+}
+function countActiveDownloads(downloads) {
+  return downloads.filter((download) => download.status === DOWNLOAD_STATUS.downloading).length;
+}
+export {
+  cancelDownload,
+  clearFinishedDownloads,
+  countActiveDownloads,
+  downloadsActor,
+  startDownload
+};
+//# sourceMappingURL=downloadQueue.js.map

package/dist/downloads/downloadQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadQueue.js","sources":["../../src/downloads/downloadQueue.js"],"sourcesContent":["// Arranca descargas y las anota en la lista que pinta DownloadManager (el administrador de descargas).\n//\n// Uso (desde un módulo, que es quien conoce el API):\n//   startDownload({\n//       label: t('detail.downloadLog'),\n//       request: (transferOptions) => ingestionApi.downloadProcessingLog(batchId, transferOptions),\n//       onCompleted: () => refreshPeriods(),\n//   });\n//\n// startDownload no espera a que termine quien la llama: el diálogo de confirmación se cierra en cuanto la descarga entra\n// a la lista y la persona sigue trabajando mientras baja (el log más grande tarda ~30 s). El panel (tipo Google Drive) es\n// el ÚNICO lugar que avisa: avance, lista y error con su texto del API (RFC 9457). Sin aviso aparte, para no avisar dos\n// veces lo mismo.\n//\n// Una sola lista para toda la app (un actor de módulo, como el cliente de createApiClient): la llenan varias pantallas y\n// la lee un solo panel montado en la raíz de la aplicación.\n//\n// Funciones puras del paquete, no renderizan: function (regla de la casa). No conoce el API: el archivo lo pide la\n// `request` que le pasan.\nimport {createActor} from 'xstate';\n\nimport {DOWNLOAD_STATUS, downloadsMachine} from '@/downloads/downloadsMachine.js';\nimport {saveBlob} from '@/files.js';\nimport {newIdentifier} from '@/identifiers.js';\n\nexport const downloadsActor = createActor(downloadsMachine).start();\n\n// cómo cancelar cada descarga en curso; vive fuera del contexto de la máquina porque un AbortController no es un dato\nconst abortControllerByDownloadId = new Map();\n\n/**\n * Descarga un archivo con avance en el panel, lo guarda en disco y avisa al terminar.\n *\n * @param {object} options\n * @param {string} options.label ya traducido; lo que se ve en el panel mientras todavía no se sabe el nombre del\n *     archivo\n * @param {string} [options.format] el tipo de archivo, para su ícono en el panel: xlsx, csv, pdf o uno del proyecto\n *     (ToolkitProvider fileTypes)\n * @param {(transferOptions: {signal: AbortSignal, onDownloadProgress: (progress: {loaded: number, total?: number|null}) => void}) => Promise<{blob: Blob, fileName: string}>} options.request\n * @param {(fileName: string) => void} [options.onCompleted] p. ej. volver a pedir la tabla (si la descarga cambia algo\n *     en el servidor)\n * @param {(error: unknown) => void} [options.onFailed] cuando no se pudo (el panel ya lo dice; para avisar o reportarlo)\n * @param {() => void} [options.onCanceled] cuando la persona la canceló\n * @returns {Promise<string>} id de la descarga; la promesa se cumple cuando termina (bien, mal o cancelada), nunca falla\n */\nexport async function startDownload({label, format, request, onCompleted, onFailed, onCanceled}) {\n    const downloadId = newIdentifier();\n    const abortController = new AbortController();\n    abortControllerByDownloadId.set(downloadId, abortController);\n    downloadsActor.send({type: 'STARTED', id: downloadId, label, format});\n\n    try {\n        const {blob, fileName} = await request({\n            signal: abortController.signal,\n            // la petición avisa cada pedazo que llega; total viene en null cuando el servidor arma el archivo al vuelo (sin\n            // Content-Length) y el panel enseña lo que lleva en vez del porcentaje\n            onDownloadProgress: (progressEvent) => downloadsActor.send({\n                type: 'PROGRESSED', id: downloadId, loadedBytes: progressEvent.loaded, totalBytes: progressEvent.total,\n            }),\n        });\n        saveBlob(blob, fileName);\n        downloadsActor.send({type: 'COMPLETED', id: downloadId, fileName, sizeBytes: blob.size});\n        onCompleted?.(fileName);\n    } catch (error) {\n        // OJO: cancelar también llega aquí como error (el AbortError del navegador); se distingue por la señal, no por el\n        // tipo de error, porque cada `request` del proyecto puede tronar con el suyo\n        if (abortController.signal.aborted) {\n            downloadsActor.send({type: 'CANCELED', id: downloadId});\n            onCanceled?.();\n        } else {\n            // el mensaje ya viene traducido del API (ApiError con el detail de RFC 9457)\n            downloadsActor.send({type: 'FAILED', id: downloadId, errorMessage: error?.message ?? null});\n            onFailed?.(error);\n        }\n    } finally {\n        abortControllerByDownloadId.delete(downloadId);\n    }\n\n    return downloadId;\n}\n\n/**\n * Cancela una descarga en curso (el panel la marca como cancelada).\n *\n * @param {string} downloadId\n */\nexport function cancelDownload(downloadId) {\n    abortControllerByDownloadId.get(downloadId)?.abort();\n}\n\n/** Quita del panel todas las descargas terminadas (completadas, fallidas o canceladas). */\nexport function clearFinishedDownloads() {\n    downloadsActor.send({type: 'CLEAR_FINISHED'});\n}\n\n/**\n * ¿Cuántas siguen descargando? Decide el resumen del panel y si se puede cerrar.\n *\n * @param {Array<object>} downloads\n * @returns {number}\n */\nexport function countActiveDownloads(downloads) {\n    return downloads.filter((download) => download.status === DOWNLOAD_STATUS.downloading).length;\n}\n"],"names":[],"mappings":";;;;AAyBY,MAAC,iBAAiB,YAAY,gBAAgB,EAAE,MAAK;AAGjE,MAAM,8BAA8B,oBAAI,IAAG;AAiBpC,eAAe,cAAc,EAAC,OAAO,QAAQ,SAAS,aAAa,UAAU,WAAU,GAAG;AAC7F,QAAM,aAAa,cAAa;AAChC,QAAM,kBAAkB,IAAI,gBAAe;AAC3C,8BAA4B,IAAI,YAAY,eAAe;AAC3D,iBAAe,KAAK,EAAC,MAAM,WAAW,IAAI,YAAY,OAAO,OAAM,CAAC;AAEpE,MAAI;AACA,UAAM,EAAC,MAAM,SAAQ,IAAI,MAAM,QAAQ;AAAA,MACnC,QAAQ,gBAAgB;AAAA;AAAA;AAAA,MAGxB,oBAAoB,CAAC,kBAAkB,eAAe,KAAK;AAAA,QACvD,MAAM;AAAA,QAAc,IAAI;AAAA,QAAY,aAAa,cAAc;AAAA,QAAQ,YAAY,cAAc;AAAA,MACjH,CAAa;AAAA,IACb,CAAS;AACD,aAAS,MAAM,QAAQ;AACvB,mBAAe,KAAK,EAAC,MAAM,aAAa,IAAI,YAAY,UAAU,WAAW,KAAK,KAAI,CAAC;AACvF,kBAAc,QAAQ;AAAA,EAC1B,SAAS,OAAO;AAGZ,QAAI,gBAAgB,OAAO,SAAS;AAChC,qBAAe,KAAK,EAAC,MAAM,YAAY,IAAI,WAAU,CAAC;AACtD,mBAAU;AAAA,IACd,OAAO;AAEH,qBAAe,KAAK,EAAC,MAAM,UAAU,IAAI,YAAY,cAAc,OAAO,WAAW,KAAI,CAAC;AAC1F,iBAAW,KAAK;AAAA,IACpB;AAAA,EACJ,UAAC;AACG,gCAA4B,OAAO,UAAU;AAAA,EACjD;AAEA,SAAO;AACX;AAOO,SAAS,eAAe,YAAY;AACvC,8BAA4B,IAAI,UAAU,GAAG,MAAK;AACtD;AAGO,SAAS,yBAAyB;AACrC,iBAAe,KAAK,EAAC,MAAM,iBAAgB,CAAC;AAChD;AAQO,SAAS,qBAAqB,WAAW;AAC5C,SAAO,UAAU,OAAO,CAAC,aAAa,SAAS,WAAW,gBAAgB,WAAW,EAAE;AAC3F;"}

package/dist/downloads/downloadsMachine.js

@@ -0,0 +1,80 @@
+import { setup, assign } from "xstate";
+const DOWNLOAD_STATUS = Object.freeze({
+  downloading: "downloading",
+  completed: "completed",
+  failed: "failed",
+  canceled: "canceled"
+});
+function updateActiveDownload(downloads, downloadId, changes) {
+  return downloads.map((download) => download.id === downloadId && download.status === DOWNLOAD_STATUS.downloading ? { ...download, ...changes } : download);
+}
+const downloadsMachine = setup({}).createMachine({
+  id: "downloads",
+  context: {
+    // la más nueva primero
+    downloads: []
+  },
+  on: {
+    STARTED: {
+      actions: assign({
+        downloads: ({ context, event }) => [
+          {
+            id: event.id,
+            label: event.label,
+            // xlsx, csv o pdf: el panel pinta el ícono del tipo de archivo (null si quien descarga no lo dice)
+            format: event.format ?? null,
+            fileName: null,
+            status: DOWNLOAD_STATUS.downloading,
+            loadedBytes: 0,
+            totalBytes: null,
+            errorMessage: null
+          },
+          ...context.downloads
+        ]
+      })
+    },
+    PROGRESSED: {
+      actions: assign({
+        downloads: ({ context, event }) => updateActiveDownload(context.downloads, event.id, {
+          loadedBytes: event.loadedBytes,
+          // un archivo que se arma al vuelo (el log) no dice su tamaño: se queda en null y la barra no tiene fin
+          totalBytes: event.totalBytes ?? null
+        })
+      })
+    },
+    COMPLETED: {
+      actions: assign({
+        // con el tamaño del archivo ya guardado: un archivo armado en el navegador (CSV, JSON) no avisa avance y el
+        // panel decía «0 bytes» de un archivo con datos
+        downloads: ({ context, event }) => updateActiveDownload(context.downloads, event.id, {
+          status: DOWNLOAD_STATUS.completed,
+          fileName: event.fileName,
+          ...typeof event.sizeBytes === "number" && { loadedBytes: event.sizeBytes, totalBytes: event.sizeBytes }
+        })
+      })
+    },
+    FAILED: {
+      actions: assign({
+        downloads: ({ context, event }) => updateActiveDownload(context.downloads, event.id, {
+          status: DOWNLOAD_STATUS.failed,
+          errorMessage: event.errorMessage ?? null
+        })
+      })
+    },
+    CANCELED: {
+      actions: assign({
+        downloads: ({ context, event }) => updateActiveDownload(context.downloads, event.id, { status: DOWNLOAD_STATUS.canceled })
+      })
+    },
+    CLEAR_FINISHED: {
+      actions: assign({
+        downloads: ({ context }) => context.downloads.filter((download) => download.status === DOWNLOAD_STATUS.downloading)
+      })
+    }
+  }
+});
+export {
+  DOWNLOAD_STATUS,
+  downloadsMachine
+};
+//# sourceMappingURL=downloadsMachine.js.map

package/dist/downloads/downloadsMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadsMachine.js","sources":["../../src/downloads/downloadsMachine.js"],"sourcesContent":["// Lista de descargas de la sesión (el «administrador de descargas», sin Redux).\n//\n// Cada descarga vive así:\n//\n//   STARTED ──▶ downloading ──PROGRESSED──▶ downloading\n//                   │\n//                   ├── COMPLETED ──▶ completed ─┐\n//                   ├── FAILED ─────▶ failed ────┼── CLEAR_FINISHED ──▶ (sale de la lista)\n//                   └── CANCELED ───▶ canceled ──┘\n//\n// Por qué una máquina y no un useState: la lista la alimentan varias pantallas a la vez (quien descarga) y la lee un\n// solo panel (DownloadManager); una descarga que ya terminó no puede volver a «descargando» por un aviso de progreso\n// que llegó tarde. Lo prueba downloadsMachine.test.js.\n//\n// Pura: solo importa xstate. Quien descarga de verdad es startDownload (downloadQueue.js); el paquete no conoce el API.\nimport {assign, setup} from 'xstate';\n\n/** Estatus de una descarga; son los que pinta el panel (con su texto en common:downloads.statuses). */\nexport const DOWNLOAD_STATUS = Object.freeze({\n    downloading: 'downloading',\n    completed: 'completed',\n    failed: 'failed',\n    canceled: 'canceled',\n});\n\n/**\n * Cambia una sola descarga de la lista, y solo si sigue descargando (las terminadas ya no cambian).\n *\n * @param {Array<object>} downloads\n * @param {string} downloadId\n * @param {object} changes\n * @returns {Array<object>}\n */\nfunction updateActiveDownload(downloads, downloadId, changes) {\n    return downloads.map((download) => (\n        download.id === downloadId && download.status === DOWNLOAD_STATUS.downloading ? {...download, ...changes} : download\n    ));\n}\n\nexport const downloadsMachine = setup({}).createMachine({\n    id: 'downloads',\n    context: {\n        // la más nueva primero\n        downloads: [],\n    },\n    on: {\n        STARTED: {\n            actions: assign({\n                downloads: ({context, event}) => [\n                    {\n                        id: event.id,\n                        label: event.label,\n                        // xlsx, csv o pdf: el panel pinta el ícono del tipo de archivo (null si quien descarga no lo dice)\n                        format: event.format ?? null,\n                        fileName: null,\n                        status: DOWNLOAD_STATUS.downloading,\n                        loadedBytes: 0,\n                        totalBytes: null,\n                        errorMessage: null,\n                    },\n                    ...context.downloads,\n                ],\n            }),\n        },\n        PROGRESSED: {\n            actions: assign({\n                downloads: ({context, event}) => updateActiveDownload(context.downloads, event.id, {\n                    loadedBytes: event.loadedBytes,\n                    // un archivo que se arma al vuelo (el log) no dice su tamaño: se queda en null y la barra no tiene fin\n                    totalBytes: event.totalBytes ?? null,\n                }),\n            }),\n        },\n        COMPLETED: {\n            actions: assign({\n                // con el tamaño del archivo ya guardado: un archivo armado en el navegador (CSV, JSON) no avisa avance y el\n                // panel decía «0 bytes» de un archivo con datos\n                downloads: ({context, event}) => updateActiveDownload(context.downloads, event.id, {\n                    status: DOWNLOAD_STATUS.completed,\n                    fileName: event.fileName,\n                    ...(typeof event.sizeBytes === 'number' && {loadedBytes: event.sizeBytes, totalBytes: event.sizeBytes}),\n                }),\n            }),\n        },\n        FAILED: {\n            actions: assign({\n                downloads: ({context, event}) => updateActiveDownload(context.downloads, event.id, {\n                    status: DOWNLOAD_STATUS.failed,\n                    errorMessage: event.errorMessage ?? null,\n                }),\n            }),\n        },\n        CANCELED: {\n            actions: assign({\n                downloads: ({context, event}) => updateActiveDownload(context.downloads, event.id, {status: DOWNLOAD_STATUS.canceled}),\n            }),\n        },\n        CLEAR_FINISHED: {\n            actions: assign({\n                downloads: ({context}) => context.downloads.filter((download) => download.status === DOWNLOAD_STATUS.downloading),\n            }),\n        },\n    },\n});\n"],"names":[],"mappings":";AAkBY,MAAC,kBAAkB,OAAO,OAAO;AAAA,EACzC,aAAa;AAAA,EACb,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,UAAU;AACd,CAAC;AAUD,SAAS,qBAAqB,WAAW,YAAY,SAAS;AAC1D,SAAO,UAAU,IAAI,CAAC,aAClB,SAAS,OAAO,cAAc,SAAS,WAAW,gBAAgB,cAAc,EAAC,GAAG,UAAU,GAAG,QAAO,IAAI,QAC/G;AACL;AAEY,MAAC,mBAAmB,MAAM,EAAE,EAAE,cAAc;AAAA,EACpD,IAAI;AAAA,EACJ,SAAS;AAAA;AAAA,IAEL,WAAW,CAAA;AAAA,EACnB;AAAA,EACI,IAAI;AAAA,IACA,SAAS;AAAA,MACL,SAAS,OAAO;AAAA,QACZ,WAAW,CAAC,EAAC,SAAS,MAAK,MAAM;AAAA,UAC7B;AAAA,YACI,IAAI,MAAM;AAAA,YACV,OAAO,MAAM;AAAA;AAAA,YAEb,QAAQ,MAAM,UAAU;AAAA,YACxB,UAAU;AAAA,YACV,QAAQ,gBAAgB;AAAA,YACxB,aAAa;AAAA,YACb,YAAY;AAAA,YACZ,cAAc;AAAA,UACtC;AAAA,UACoB,GAAG,QAAQ;AAAA,QAC/B;AAAA,MACA,CAAa;AAAA,IACb;AAAA,IACQ,YAAY;AAAA,MACR,SAAS,OAAO;AAAA,QACZ,WAAW,CAAC,EAAC,SAAS,MAAK,MAAM,qBAAqB,QAAQ,WAAW,MAAM,IAAI;AAAA,UAC/E,aAAa,MAAM;AAAA;AAAA,UAEnB,YAAY,MAAM,cAAc;AAAA,QACpD,CAAiB;AAAA,MACjB,CAAa;AAAA,IACb;AAAA,IACQ,WAAW;AAAA,MACP,SAAS,OAAO;AAAA;AAAA;AAAA,QAGZ,WAAW,CAAC,EAAC,SAAS,MAAK,MAAM,qBAAqB,QAAQ,WAAW,MAAM,IAAI;AAAA,UAC/E,QAAQ,gBAAgB;AAAA,UACxB,UAAU,MAAM;AAAA,UAChB,GAAI,OAAO,MAAM,cAAc,YAAY,EAAC,aAAa,MAAM,WAAW,YAAY,MAAM,UAAS;AAAA,QACzH,CAAiB;AAAA,MACjB,CAAa;AAAA,IACb;AAAA,IACQ,QAAQ;AAAA,MACJ,SAAS,OAAO;AAAA,QACZ,WAAW,CAAC,EAAC,SAAS,MAAK,MAAM,qBAAqB,QAAQ,WAAW,MAAM,IAAI;AAAA,UAC/E,QAAQ,gBAAgB;AAAA,UACxB,cAAc,MAAM,gBAAgB;AAAA,QACxD,CAAiB;AAAA,MACjB,CAAa;AAAA,IACb;AAAA,IACQ,UAAU;AAAA,MACN,SAAS,OAAO;AAAA,QACZ,WAAW,CAAC,EAAC,SAAS,MAAK,MAAM,qBAAqB,QAAQ,WAAW,MAAM,IAAI,EAAC,QAAQ,gBAAgB,SAAQ,CAAC;AAAA,MACrI,CAAa;AAAA,IACb;AAAA,IACQ,gBAAgB;AAAA,MACZ,SAAS,OAAO;AAAA,QACZ,WAAW,CAAC,EAAC,QAAO,MAAM,QAAQ,UAAU,OAAO,CAAC,aAAa,SAAS,WAAW,gBAAgB,WAAW;AAAA,MAChI,CAAa;AAAA,IACb;AAAA,EACA;AACA,CAAC;"}

package/dist/downloads/fileTypes.js

@@ -0,0 +1,22 @@
+"use client";
+import InsertDriveFileOutlinedIcon from "@mui/icons-material/InsertDriveFileOutlined";
+import PictureAsPdfOutlinedIcon from "@mui/icons-material/PictureAsPdfOutlined";
+import TableViewOutlinedIcon from "@mui/icons-material/TableViewOutlined";
+import TextSnippetOutlinedIcon from "@mui/icons-material/TextSnippetOutlined";
+import { useToolkitSettings } from "../toolkit/toolkitContext.js";
+const DEFAULT_FILE_TYPES = Object.freeze({
+  xlsx: Object.freeze({ Icon: TableViewOutlinedIcon, color: "success.main" }),
+  csv: Object.freeze({ Icon: TextSnippetOutlinedIcon, color: "info.main" }),
+  pdf: Object.freeze({ Icon: PictureAsPdfOutlinedIcon, color: "error.main" })
+});
+const UNKNOWN_FILE_TYPE = Object.freeze({ Icon: InsertDriveFileOutlinedIcon, color: "text.secondary" });
+function useFileTypes() {
+  const { fileTypes } = useToolkitSettings();
+  return fileTypes ? { ...DEFAULT_FILE_TYPES, ...fileTypes } : DEFAULT_FILE_TYPES;
+}
+export {
+  DEFAULT_FILE_TYPES,
+  UNKNOWN_FILE_TYPE,
+  useFileTypes
+};
+//# sourceMappingURL=fileTypes.js.map

package/dist/downloads/fileTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTypes.js","sources":["../../src/downloads/fileTypes.js"],"sourcesContent":["// Los tipos de archivo que conocen las descargas: el ícono y el color con que se ven en el menú «Descargar» y en el panel.\n// La casa trae los básicos (Excel, CSV y PDF); el proyecto agrega los suyos en ToolkitProvider `fileTypes` (un ZIP de\n// facturas, el XML del SAT, un Word), con su ícono, su color y su texto: el paquete no conoce todos los tipos ni debe.\n//\n//   <ToolkitProvider fileTypes={{zip: {Icon: FolderZipOutlinedIcon, color: 'warning.main', label: 'ZIP', hint: 'Todas las facturas'}}}>\n//\n// El texto de un tipo de la casa sale de los textos del paquete (common:download.formats.<tipo>); el de uno del proyecto, de su\n// label y hint (o de esas mismas llaves en sus texts).\n//\n// Hook genérico: function (regla de la casa).\nimport InsertDriveFileOutlinedIcon from '@mui/icons-material/InsertDriveFileOutlined';\nimport PictureAsPdfOutlinedIcon from '@mui/icons-material/PictureAsPdfOutlined';\nimport TableViewOutlinedIcon from '@mui/icons-material/TableViewOutlined';\nimport TextSnippetOutlinedIcon from '@mui/icons-material/TextSnippetOutlined';\n\nimport {useToolkitSettings} from '@/toolkit/toolkitContext.js';\n\n/** Los tipos de la casa: su ícono y su color (de la paleta del tema, claro y oscuro). */\nexport const DEFAULT_FILE_TYPES = Object.freeze({\n    xlsx: Object.freeze({Icon: TableViewOutlinedIcon, color: 'success.main'}),\n    csv: Object.freeze({Icon: TextSnippetOutlinedIcon, color: 'info.main'}),\n    pdf: Object.freeze({Icon: PictureAsPdfOutlinedIcon, color: 'error.main'}),\n});\n\n/** Un tipo que nadie declaró: el ícono de archivo y el gris del texto. */\nexport const UNKNOWN_FILE_TYPE = Object.freeze({Icon: InsertDriveFileOutlinedIcon, color: 'text.secondary'});\n\n/**\n * Los tipos que conoce esta app: los de la casa y los del proyecto (el del proyecto gana si se llama igual).\n *\n * @returns {Record<string, {Icon: import('react').ElementType, color: string, label?: string, hint?: string}>}\n */\nexport function useFileTypes() {\n    const {fileTypes} = useToolkitSettings();\n    return fileTypes ? {...DEFAULT_FILE_TYPES, ...fileTypes} : DEFAULT_FILE_TYPES;\n}\n"],"names":[],"mappings":";;;;;;AAkBY,MAAC,qBAAqB,OAAO,OAAO;AAAA,EAC5C,MAAM,OAAO,OAAO,EAAC,MAAM,uBAAuB,OAAO,eAAc,CAAC;AAAA,EACxE,KAAK,OAAO,OAAO,EAAC,MAAM,yBAAyB,OAAO,YAAW,CAAC;AAAA,EACtE,KAAK,OAAO,OAAO,EAAC,MAAM,0BAA0B,OAAO,aAAY,CAAC;AAC5E,CAAC;AAGW,MAAC,oBAAoB,OAAO,OAAO,EAAC,MAAM,6BAA6B,OAAO,iBAAgB,CAAC;AAOpG,SAAS,eAAe;AAC3B,QAAM,EAAC,UAAS,IAAI,mBAAkB;AACtC,SAAO,YAAY,EAAC,GAAG,oBAAoB,GAAG,UAAS,IAAI;AAC/D;"}