@stackcraftmx/calcita 0.0.0-stage → 0.23.0

package/dist/downloads/DownloadManager.js

@@ -0,0 +1,201 @@
+"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 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 { downloadsActor, countActiveDownloads, clearFinishedDownloads, cancelDownload } from "./downloadQueue.js";
+import { DOWNLOAD_STATUS } from "./downloadsMachine.js";
+import { formatFileSize } from "../formatting.js";
+import { isGlassTheme, glassStylesOf } from "../theme/glassSurface.js";
+const FILE_TYPE_APPEARANCE = {
+  xlsx: { Icon: TableViewOutlinedIcon, color: "success.main" },
+  csv: { Icon: TextSnippetOutlinedIcon, color: "info.main" },
+  pdf: { Icon: PictureAsPdfOutlinedIcon, color: "error.main" }
+};
+const DEFAULT_FILE_TYPE_APPEARANCE = { Icon: InsertDriveFileOutlinedIcon, color: "text.secondary" };
+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) {
+  const extension = download.fileName?.split(".").pop()?.toLowerCase();
+  return FILE_TYPE_APPEARANCE[download.format ?? extension] ?? DEFAULT_FILE_TYPE_APPEARANCE;
+}
+function detailTextOf(download, t) {
+  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 { Icon, color } = fileTypeAppearanceOf(download);
+  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)
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx(Box, { sx: { flexShrink: 0, display: "flex", alignItems: "center" }, children: /* @__PURE__ */ jsx(DownloadStatusIndicator, { download, displayName }) })
+    ] })
+  );
+}
+function DownloadManager() {
+  const { t } = useToolkitTranslation("common");
+  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(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';\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 {cancelDownload, clearFinishedDownloads, countActiveDownloads, downloadsActor} from '@/downloads/downloadQueue.js';\nimport {DOWNLOAD_STATUS} from '@/downloads/downloadsMachine.js';\nimport {formatFileSize} from '@/formatting.js';\nimport {glassStylesOf, isGlassTheme} from '@/theme/glassSurface.js';\n\n// ícono y color del tipo de archivo (el color sale de la paleta del tema, claro y oscuro)\nconst FILE_TYPE_APPEARANCE = {\n    xlsx: {Icon: TableViewOutlinedIcon, color: 'success.main'},\n    csv: {Icon: TextSnippetOutlinedIcon, color: 'info.main'},\n    pdf: {Icon: PictureAsPdfOutlinedIcon, color: 'error.main'},\n};\nconst DEFAULT_FILE_TYPE_APPEARANCE = {Icon: InsertDriveFileOutlinedIcon, color: 'text.secondary'};\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.\n *\n * @param {object} download renglón de la lista (downloadsMachine)\n * @returns {{Icon: import('react').ElementType, color: string}}\n */\nfunction fileTypeAppearanceOf(download) {\n    const extension = download.fileName?.split('.').pop()?.toLowerCase();\n    return FILE_TYPE_APPEARANCE[download.format ?? extension] ?? DEFAULT_FILE_TYPE_APPEARANCE;\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 * @returns {string}\n */\nfunction detailTextOf(download, t) {\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 {Icon, color} = fileTypeAppearanceOf(download);\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)}\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\nexport default function DownloadManager() {\n    const {t} = useToolkitTranslation('common');\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        <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    );\n}\n"],"names":[],"mappings":"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"}

package/dist/downloads/downloadQueue.js

@@ -0,0 +1,54 @@
+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 }) {
+  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 });
+    onCompleted?.(fileName);
+  } catch (error) {
+    if (abortController.signal.aborted) {
+      downloadsActor.send({ type: "CANCELED", id: downloadId });
+    } else {
+      downloadsActor.send({ type: "FAILED", id: downloadId, errorMessage: error?.message ?? null });
+    }
+  } 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 {'xlsx'|'csv'|'pdf'} [options.format] para el ícono del tipo de archivo en el panel\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 * @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}) {\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});\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        } 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        }\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;AAcpC,eAAe,cAAc,EAAC,OAAO,QAAQ,SAAS,YAAW,GAAG;AACvE,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,SAAQ,CAAC;AACjE,kBAAc,QAAQ;AAAA,EAC1B,SAAS,OAAO;AAGZ,QAAI,gBAAgB,OAAO,SAAS;AAChC,qBAAe,KAAK,EAAC,MAAM,YAAY,IAAI,WAAU,CAAC;AAAA,IAC1D,OAAO;AAEH,qBAAe,KAAK,EAAC,MAAM,UAAU,IAAI,YAAY,cAAc,OAAO,WAAW,KAAI,CAAC;AAAA,IAC9F;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,77 @@
+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({
+        downloads: ({ context, event }) => updateActiveDownload(context.downloads, event.id, {
+          status: DOWNLOAD_STATUS.completed,
+          fileName: event.fileName
+        })
+      })
+    },
+    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                downloads: ({context, event}) => updateActiveDownload(context.downloads, event.id, {\n                    status: DOWNLOAD_STATUS.completed,\n                    fileName: event.fileName,\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,QACZ,WAAW,CAAC,EAAC,SAAS,MAAK,MAAM,qBAAqB,QAAQ,WAAW,MAAM,IAAI;AAAA,UAC/E,QAAQ,gBAAgB;AAAA,UACxB,UAAU,MAAM;AAAA,QACpC,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;"}