@stackcraftmx/calcita 0.32.2 → 0.51.0

package/dist/types/upload/FileDropzone.d.ts

@@ -1,21 +1,4 @@
-/**
- * @param {object} props
- * @param {File|null} [props.value] el archivo elegido
- * @param {(file: File|null) => void} props.onChange null al quitarlo
- * @param {string|string[]} [props.accept] 'excel' | ['excel', 'pdf'] | '.xlsx,.xls' | 'image/*'
- * @param {number|string} [props.maxSize] bytes o '10 MB'
- * @param {string} [props.hint] ya traducido; por omisión «Arrastre aquí su archivo»
- * @param {string} [props.buttonLabel] ya traducido; por omisión «Elegir archivo»
- * @param {boolean} [props.disabled]
- * @param {boolean} [props.busy] candado mientras se sube: no se puede soltar, elegir ni quitar
- * @param {boolean|{title?: string, text?: string}} [props.busyModal] además bloquea la pantalla mientras busy
- * @param {(file: File, reason: string) => void} [props.onReject] reason es uno de FILE_REJECTION; sin él, un aviso
- * @param {import('react').ReactNode} [props.actions]
- * @param {import('react').ReactNode} [props.children]
- * @param {object} [props.sx] ajustes del recuadro
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function FileDropzone(props: {
+declare const FileDropzone: (props: {
     value?: File | null;
     onChange: (file: File | null) => void;
     accept?: string | string[];
@@ -29,8 +12,13 @@ export default function FileDropzone(props: {
         text?: string;
     };
     onReject?: (file: File, reason: string) => void;
+    template?: Parameters<typeof import('./TemplateDownloadButton.js').default>[0];
     actions?: import('react').ReactNode;
     children?: import('react').ReactNode;
     sx?: object;
     texts?: object;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default FileDropzone;

package/dist/types/upload/FileInput.d.ts

@@ -0,0 +1,31 @@
+declare const FileInput: (props: {
+    name?: string;
+    label?: import('react').ReactNode;
+    value?: File | {
+        name: string;
+        size?: number;
+    } | null;
+    onChange: (file: File | null) => void;
+    onBlur?: () => void;
+    accept?: string | string[];
+    maxSize?: number | string;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    buttonLabel?: string;
+    emptyText?: string;
+    disabled?: boolean;
+    busy?: boolean;
+    onReject?: (file: File, reason: string) => void;
+    template?: Parameters<typeof import('./TemplateDownloadButton.js').default>[0];
+    actions?: import('react').ReactNode;
+    sx?: object;
+    messages?: Record<string, string | object>;
+    texts?: object;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default FileInput;

package/dist/types/upload/FileUploadInput.d.ts

@@ -0,0 +1,56 @@
+/** En qué va el archivo de un renglón (onStatusChange). */
+export declare const FILE_UPLOAD_STATUS: Readonly<{
+    pending: "pending";
+    uploading: "uploading";
+    processing: "processing";
+    uploaded: "uploaded";
+    failed: "failed";
+}>;
+declare const FileUploadInput: (props: {
+    name?: string;
+    label?: import('react').ReactNode;
+    value?: string | null;
+    onChange: (value: string) => void;
+    onBlur?: () => void;
+    upload: (file: File, options: {
+        signal: AbortSignal;
+        idempotencyKey: string;
+        onUploadProgress: (transfer: {
+            loaded: number;
+            total: number;
+            rate?: number;
+            estimated?: number;
+        }) => void;
+    }) => Promise<any>;
+    idOf?: (result: any) => string;
+    uploadedFile?: {
+        name: string;
+        size?: number;
+    } | null;
+    download?: (value: string, transferOptions: object) => Promise<{
+        blob: Blob;
+        fileName: string;
+    }>;
+    accept?: string | string[];
+    maxSize?: number | string;
+    limitsText?: string;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    disabled?: boolean;
+    actions?: import('react').ReactNode;
+    onUploaded?: (result: any) => void;
+    onUploadFailed?: (error: unknown) => void;
+    onCancel?: () => void;
+    onRemove?: () => void;
+    onStatusChange?: (status: string) => void;
+    sx?: object;
+    messages?: Record<string, string | object>;
+    texts?: object;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default FileUploadInput;

package/dist/types/upload/ImageInput.d.ts

@@ -0,0 +1,35 @@
+/** La forma de la vista previa: círculo para una persona, recuadro para lo demás. */
+export declare const IMAGE_SHAPE: Readonly<{
+    circle: "circle";
+    rounded: "rounded";
+}>;
+declare const ImageInput: (props: {
+    name?: string;
+    label?: import('react').ReactNode;
+    value?: File | string | null;
+    onChange: (file: File | null) => void;
+    onBlur?: () => void;
+    shape?: 'circle' | 'rounded';
+    size?: number;
+    alt?: string;
+    placeholder?: import('react').ReactNode;
+    accept?: string | string[];
+    maxSize?: number | string;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    chooseLabel?: string;
+    removeLabel?: string;
+    disabled?: boolean;
+    busy?: boolean;
+    onReject?: (file: File, reason: string) => void;
+    sx?: object;
+    messages?: Record<string, string | object>;
+    texts?: object;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default ImageInput;

package/dist/types/upload/TemplateDownloadButton.d.ts

@@ -0,0 +1,27 @@
+declare const TemplateDownloadButton: (props: {
+    href?: string;
+    fileName?: string;
+    request?: (transferOptions: {
+        signal: AbortSignal;
+        onDownloadProgress: (progress: {
+            loaded: number;
+            total?: number | null;
+        }) => void;
+    }) => Promise<{
+        blob: Blob;
+        fileName: string;
+    }>;
+    format?: string;
+    label?: string;
+    onDownload?: () => void;
+    variant?: 'text' | 'outlined' | 'contained';
+    size?: 'small' | 'medium' | 'large';
+    disabled?: boolean;
+    startIcon?: import('react').ReactNode;
+    sx?: object;
+    texts?: object;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default TemplateDownloadButton;

package/dist/types/upload/fileAppearance.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @param {string} fileName
+ * @returns {{Icon: import('react').ElementType, color: string}}
+ */
+export declare function fileAppearanceOf(fileName: string): {
+    Icon: import('react').ElementType;
+    color: string;
+};

package/dist/types/upload/fileRules.d.ts

@@ -49,3 +49,41 @@ export declare function matchesAccept(file: {
  * @returns {number|null} null si no hay límite
  */
 export declare function parseFileSize(size: number | string | undefined | null): number | null;
+/**
+ * Lo que queda al elegir o soltar archivos: cuáles pasan y cuáles no, con su motivo. La usan los cargadores de MUI del
+ * paquete (la zona, el compacto, «Adjuntar» y la imagen), así rechazan igual y con los mismos motivos.
+ *
+ * Un archivo con el MISMO nombre que uno que ya estaba lo reemplaza (se volvió a elegir corregido) y no cuenta doble ni
+ * en la cantidad ni en el peso. Se revisa en este orden: tipo, peso del archivo, cantidad y peso de todos juntos.
+ *
+ * @param {Array<{name: string, type?: string, size?: number}>} pickedFiles lo que se eligió o se soltó
+ * @param {object} rules
+ * @param {string} [rules.resolvedAccept] lo que regresa resolveAccept
+ * @param {number|null} [rules.maxBytes] el peso máximo de cada archivo
+ * @param {number} [rules.maxFiles] cuántos como máximo entre los que ya estaban y los nuevos
+ * @param {number|null} [rules.maxTotalBytes] cuánto pueden pesar todos juntos
+ * @param {Array<{name: string, size?: number}>} [rules.keptFiles] los que ya estaban (un archivo guardado sin peso cuenta 0)
+ * @returns {{files: Array<object>, accepted: Array<object>, rejected: Array<{file: object, reason: string}>}} files: los
+ *     que ya estaban (sin los reemplazados) y después los nuevos que pasaron
+ */
+export declare function screenFiles(pickedFiles: Array<{
+    name: string;
+    type?: string;
+    size?: number;
+}>, { resolvedAccept, maxBytes, maxFiles, maxTotalBytes, keptFiles }?: {
+    resolvedAccept?: string;
+    maxBytes?: number | null;
+    maxFiles?: number;
+    maxTotalBytes?: number | null;
+    keptFiles?: Array<{
+        name: string;
+        size?: number;
+    }>;
+}): {
+    files: Array<object>;
+    accepted: Array<object>;
+    rejected: Array<{
+        file: object;
+        reason: string;
+    }>;
+};

package/dist/types/upload/transferProgress.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @param {{loaded: number, total: number, rate?: number, estimated?: number}} transfer lo que avisa la subida (bytes)
+ * @param {number} startedAt cuándo empezó la subida, en milisegundos
+ * @param {number} [now]
+ * @returns {{percent: number, loaded: number, total: number, bytesPerSecond: number|null, remainingSeconds: number|null}}
+ */
+export declare function transferProgressOf({ loaded, total, rate, estimated }: {
+    loaded: number;
+    total: number;
+    rate?: number;
+    estimated?: number;
+}, startedAt: number, now?: number): {
+    percent: number;
+    loaded: number;
+    total: number;
+    bytesPerSecond: number | null;
+    remainingSeconds: number | null;
+};

package/dist/types/upload/uploadMachine.d.ts

@@ -16,8 +16,12 @@ export declare const uploadMachine: import("xstate").StateMachine<import("xstate
  *
  * fromCallback y no fromPromise: hacen falta EVENTOS a medio camino (el avance) y un CLEANUP que aborte la petición.
  *
- * @param {(input: object, onProgress: (percent: number) => void, signal: AbortSignal) => Promise<unknown>} uploadFile
+ * @param {(input: object, onProgress: (percent: number, transfer?: {loaded: number, total: number}) => void, signal: AbortSignal) => Promise<unknown>} uploadFile
+ *     onProgress lleva, si se sabe, cuánto va y cuánto pesa (para la velocidad y lo que falta)
  */
-export declare function buildUploadActors(uploadFile: (input: object, onProgress: (percent: number) => void, signal: AbortSignal) => Promise<unknown>): {
+export declare function buildUploadActors(uploadFile: (input: object, onProgress: (percent: number, transfer?: {
+    loaded: number;
+    total: number;
+}) => void, signal: AbortSignal) => Promise<unknown>): {
     upload: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
 };

package/dist/types/upload/uploadWithProgress.d.ts

@@ -3,14 +3,18 @@
  * @param {FormData} formData los archivos y los campos que pida el backend
  * @param {object} [options]
  * @param {Record<string, string>} [options.headers] p. ej. Authorization; Accept-Language ya va con el idioma activo
- * @param {(percent: number) => void} [options.onProgress] 0 a 100 de lo que ya viajó del cuerpo
+ * @param {(percent: number, transfer: {loaded: number, total: number}) => void} [options.onProgress] 0 a 100 de lo que ya
+ *     viajó del cuerpo, y los bytes (para la velocidad y lo que falta)
  * @param {AbortSignal} [options.signal]
  * @param {boolean} [options.withCredentials] manda las cookies a otro dominio (sesión de Sanctum en otro subdominio)
  * @returns {Promise<Response>}
  */
 export declare function uploadWithProgress(url: string, formData: FormData, { headers, onProgress, signal, withCredentials }?: {
     headers?: Record<string, string>;
-    onProgress?: (percent: number) => void;
+    onProgress?: (percent: number, transfer: {
+        loaded: number;
+        total: number;
+    }) => void;
     signal?: AbortSignal;
     withCredentials?: boolean;
 }): Promise<Response>;

package/dist/types/upload/useFilePicker.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @param {object} options
+ * @param {string|string[]} [options.accept] 'excel' | ['excel', 'pdf'] | '.xlsx,.xls' | 'image/*'
+ * @param {number|string} [options.maxSize] el peso máximo de cada archivo: bytes o '10 MB'
+ * @param {boolean} [options.multiple] varios a la vez; sin él, solo el primero que se elija o se suelte
+ * @param {number} [options.maxFiles] con multiple: cuántos como máximo, contando los que ya estaban
+ * @param {number|string} [options.maxTotalSize] con multiple: cuánto pueden pesar todos juntos
+ * @param {Array<{name: string, size?: number}>} [options.keptFiles] con multiple: los que ya estaban (cuentan en los topes)
+ * @param {boolean} [options.disabled] no se puede elegir ni soltar (también mientras se sube)
+ * @param {(picked: any) => void} options.onAccept sin multiple, el archivo; con multiple, la lista completa (los que ya
+ *     estaban y los nuevos), lista para guardarse
+ * @param {(file: File, reason: string) => void} [options.onReject] reason es uno de FILE_REJECTION; sin él, un aviso
+ * @param {object} [options.texts] los textos que cambian, con la forma de `common`
+ * @returns {{inputProps: object, open: () => void, pickFiles: (fileList: FileList|File[]|null|undefined) => void, isDragging: boolean, dropHandlers: object, resolvedAccept: string|undefined, maxBytes: number|null, maxTotalBytes: number|null}}
+ */
+export declare function useFilePicker({ accept, maxSize, multiple, maxFiles, maxTotalSize, keptFiles, disabled, onAccept, onReject, texts, }: {
+    accept?: string | string[];
+    maxSize?: number | string;
+    multiple?: boolean;
+    maxFiles?: number;
+    maxTotalSize?: number | string;
+    keptFiles?: Array<{
+        name: string;
+        size?: number;
+    }>;
+    disabled?: boolean;
+    onAccept: (picked: any) => void;
+    onReject?: (file: File, reason: string) => void;
+    texts?: object;
+}): {
+    inputProps: object;
+    open: () => void;
+    pickFiles: (fileList: FileList | File[] | null | undefined) => void;
+    isDragging: boolean;
+    dropHandlers: object;
+    resolvedAccept: string | undefined;
+    maxBytes: number | null;
+    maxTotalBytes: number | null;
+};

package/dist/ui/actions/ActionsMenu.js

@@ -1,25 +1,60 @@
 "use client";
 import { jsxs, Fragment, jsx } from "react/jsx-runtime";
-import { useState } from "react";
+import { useState, useRef, useEffect } from "react";
+import Divider from "@mui/material/Divider";
 import IconButton from "@mui/material/IconButton";
 import ListItemIcon from "@mui/material/ListItemIcon";
 import ListItemText from "@mui/material/ListItemText";
+import ListSubheader from "@mui/material/ListSubheader";
 import Menu from "@mui/material/Menu";
 import MenuItem from "@mui/material/MenuItem";
 import Tooltip from "@mui/material/Tooltip";
+import ChevronLeftRoundedIcon from "@mui/icons-material/ChevronLeftRounded";
+import ChevronRightRoundedIcon from "@mui/icons-material/ChevronRightRounded";
 import MoreHorizRoundedIcon from "@mui/icons-material/MoreHorizRounded";
-import { piecePart, usePieceProps } from "../../theme/themePieces.js";
+import { piecePart, withPieceSlots, usePieceProps } from "../../theme/themePieces.js";
+import { useToolkitNavigation } from "../../toolkit/toolkitContext.js";
+import { useToolkitTranslation } from "../../toolkit/useToolkitTranslation.js";
 import { warnUnknownProps } from "../../toolkit/unknownProps.js";
+const ACTIONS_MENU_ROW = Object.freeze({ section: "section", divider: "divider" });
 const THEME_NAME = "CalcitaActionsMenu";
 const ActionsItem = piecePart(THEME_NAME, "Item", MenuItem);
 const ActionsItemIcon = piecePart(THEME_NAME, "ItemIcon", ListItemIcon);
-function ActionsMenu(props) {
-  const { label, actions, icon, size = "small", ...unknownProps } = usePieceProps(props, THEME_NAME);
+function levelOf(actions, path) {
+  const parents = [];
+  let items = actions;
+  for (const key of path) {
+    const parent = items.find((item) => item.key === key);
+    if (!parent?.children) {
+      break;
+    }
+    parents.push(parent);
+    items = parent.children;
+  }
+  return { items, parents };
+}
+function ActionsMenuContent(props) {
+  const { label, actions, icon, size = "small", texts, ...unknownProps } = usePieceProps(props, THEME_NAME);
   warnUnknownProps(THEME_NAME, unknownProps);
+  const { t } = useToolkitTranslation("common", texts);
+  const { Link } = useToolkitNavigation();
   const [anchor, setAnchor] = useState(null);
+  const [path, setPath] = useState([]);
+  const listRef = useRef(null);
+  const { items, parents } = levelOf(actions ?? [], path);
+  useEffect(() => {
+    if (anchor) {
+      listRef.current?.querySelector('[role="menuitem"]:not([aria-disabled="true"])')?.focus();
+    }
+  }, [path, anchor]);
   if (!actions?.length) {
     return null;
   }
+  const close = () => {
+    setAnchor(null);
+    setPath([]);
+  };
+  const goBack = () => setPath((current) => current.slice(0, -1));
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(Tooltip, { title: label, children: /* @__PURE__ */ jsx(
       IconButton,
@@ -34,25 +69,82 @@ function ActionsMenu(props) {
         children: icon ?? /* @__PURE__ */ jsx(MoreHorizRoundedIcon, { fontSize: "small" })
       }
     ) }),
-    /* @__PURE__ */ jsx(Menu, { anchorEl: anchor, open: Boolean(anchor), onClose: () => setAnchor(null), onClick: (event) => event.stopPropagation(), children: actions.map((action) => /* @__PURE__ */ jsxs(
-      ActionsItem,
+    /* @__PURE__ */ jsxs(
+      Menu,
       {
-        disabled: action.disabled,
-        onClick: () => {
-          setAnchor(null);
-          action.onClick();
-        },
-        ownSx: action.color ? { color: `${action.color}.main` } : void 0,
+        anchorEl: anchor,
+        open: Boolean(anchor),
+        onClose: close,
+        onClick: (event) => event.stopPropagation(),
+        slotProps: { list: { ref: listRef, onKeyDown: (event) => {
+          if (event.key === "ArrowLeft" && path.length > 0) {
+            event.preventDefault();
+            goBack();
+          }
+        } } },
         children: [
-          action.icon && /* @__PURE__ */ jsx(ActionsItemIcon, { ownSx: action.color ? { color: "inherit" } : void 0, children: action.icon }),
-          /* @__PURE__ */ jsx(ListItemText, { children: action.label })
+          parents.length > 0 && [
+            /* @__PURE__ */ jsxs(ActionsItem, { onClick: goBack, ownSx: { fontWeight: 600 }, children: [
+              /* @__PURE__ */ jsx(ActionsItemIcon, { children: /* @__PURE__ */ jsx(ChevronLeftRoundedIcon, { fontSize: "small" }) }),
+              /* @__PURE__ */ jsx(ListItemText, { primary: parents.at(-1).label, secondary: t("actionsMenu.back") })
+            ] }, "__back"),
+            /* @__PURE__ */ jsx(Divider, {}, "__back-divider")
+          ],
+          items.map((item) => {
+            if (item.type === ACTIONS_MENU_ROW.divider) {
+              return /* @__PURE__ */ jsx(Divider, {}, item.key);
+            }
+            if (item.type === ACTIONS_MENU_ROW.section) {
+              return /* @__PURE__ */ jsx(ListSubheader, { sx: { lineHeight: 2.5, bgcolor: "transparent" }, children: item.label }, item.key);
+            }
+            if (item.render) {
+              return /* @__PURE__ */ jsx("li", { children: item.render({ close }) }, item.key);
+            }
+            const hasChildren = Boolean(item.children?.length);
+            let destinationProps = {};
+            if (item.to) {
+              destinationProps = { component: Link, to: item.to, ...item.replace && { replace: true } };
+            } else if (item.href) {
+              destinationProps = { component: "a", href: item.href, download: item.download };
+            }
+            return /* @__PURE__ */ jsxs(
+              ActionsItem,
+              {
+                disabled: item.disabled,
+                ...destinationProps,
+                "aria-haspopup": hasChildren ? "menu" : void 0,
+                onKeyDown: (event) => {
+                  if (hasChildren && event.key === "ArrowRight") {
+                    event.preventDefault();
+                    setPath((current) => [...current, item.key]);
+                  }
+                },
+                onClick: (event) => {
+                  if (hasChildren) {
+                    setPath((current) => [...current, item.key]);
+                    return;
+                  }
+                  close();
+                  item.onClick?.(event);
+                },
+                ownSx: item.color ? { color: `${item.color}.main` } : void 0,
+                children: [
+                  item.icon && /* @__PURE__ */ jsx(ActionsItemIcon, { ownSx: item.color ? { color: "inherit" } : void 0, children: item.icon }),
+                  /* @__PURE__ */ jsx(ListItemText, { primary: item.label, secondary: item.description }),
+                  hasChildren && /* @__PURE__ */ jsx(ChevronRightRoundedIcon, { fontSize: "small", sx: { ml: 2, color: "text.secondary" } })
+                ]
+              },
+              item.key
+            );
+          })
         ]
-      },
-      action.key
-    )) })
+      }
+    )
   ] });
 }
+const ActionsMenu = withPieceSlots(ActionsMenuContent, THEME_NAME);
 export {
+  ACTIONS_MENU_ROW,
   ActionsMenu as default
 };
 //# sourceMappingURL=ActionsMenu.js.map

package/dist/ui/actions/ActionsMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionsMenu.js","sources":["../../../src/ui/actions/ActionsMenu.jsx"],"sourcesContent":["// Un botón «⋯» con un menú de acciones: el de cada tarjeta del tablero, el de cada columna, el de cada mensaje de la bandeja.\n// Las acciones las da la pantalla (label ya traducido, ícono, color, apagada); sin acciones no se pinta nada.\n//\n//   <ActionsMenu label=\"Acciones de «Junta de cierre»\"\n//                actions={[{key: 'delete', label: 'Borrar', icon: <DeleteOutlineIcon fontSize=\"small\" />, color: 'error', onClick: remove}]} />\n//\n// El clic no llega a lo de abajo: no levanta una tarjeta que se arrastra ni abre el renglón donde vive.\n//\n// Se cambia desde el tema del proyecto, como las piezas de MUI: components.CalcitaActionsMenu con defaultProps y\n// styleOverrides de sus partes: item, itemIcon.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useState} from 'react';\nimport IconButton from '@mui/material/IconButton';\nimport ListItemIcon from '@mui/material/ListItemIcon';\nimport ListItemText from '@mui/material/ListItemText';\nimport Menu from '@mui/material/Menu';\nimport MenuItem from '@mui/material/MenuItem';\nimport Tooltip from '@mui/material/Tooltip';\nimport MoreHorizRoundedIcon from '@mui/icons-material/MoreHorizRounded';\nimport {piecePart, usePieceProps} from '@/theme/themePieces.js';\nimport {warnUnknownProps} from '@/toolkit/unknownProps.js';\n\n// el nombre de la pieza en el tema y sus partes (theme.components.CalcitaActionsMenu)\nconst THEME_NAME = 'CalcitaActionsMenu';\nconst ActionsItem = piecePart(THEME_NAME, 'Item', MenuItem);\nconst ActionsItemIcon = piecePart(THEME_NAME, 'ItemIcon', ListItemIcon);\n\n/**\n * @param {object} props\n * @param {string} props.label el nombre del botón (lector de pantalla y su tooltip), ya traducido\n * @param {Array<{key: string, label: string, icon?: import('react').ReactNode, color?: string, disabled?: boolean, onClick: () => void}>} [props.actions]\n * @param {import('react').ReactNode} [props.icon] otro ícono para el botón (por omisión «⋯»)\n * @param {'small'|'medium'} [props.size]\n */\nexport default function ActionsMenu(props) {\n    // lo que el proyecto puso en su tema (components.CalcitaActionsMenu.defaultProps) y encima lo que llega aquí\n    const {label, actions, icon, size = 'small', ...unknownProps} = usePieceProps(props, THEME_NAME);\n    warnUnknownProps(THEME_NAME, unknownProps);\n    const [anchor, setAnchor] = useState(null);\n    if (!actions?.length) {\n        return null;\n    }\n    return (\n        <>\n            <Tooltip title={label}>\n                <IconButton size={size} aria-label={label} aria-haspopup=\"menu\"\n                            onClick={(event) => {\n                                event.stopPropagation();\n                                setAnchor(event.currentTarget);\n                            }}>\n                    {icon ?? <MoreHorizRoundedIcon fontSize=\"small\" />}\n                </IconButton>\n            </Tooltip>\n            <Menu anchorEl={anchor} open={Boolean(anchor)} onClose={() => setAnchor(null)} onClick={(event) => event.stopPropagation()}>\n                {actions.map((action) => (\n                    <ActionsItem key={action.key} disabled={action.disabled}\n                              onClick={() => {\n                                  setAnchor(null);\n                                  action.onClick();\n                              }}\n                              ownSx={action.color ? {color: `${action.color}.main`} : undefined}>\n                        {action.icon && <ActionsItemIcon ownSx={action.color ? {color: 'inherit'} : undefined}>{action.icon}</ActionsItemIcon>}\n                        <ListItemText>{action.label}</ListItemText>\n                    </ActionsItem>\n                ))}\n            </Menu>\n        </>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAwBA,MAAM,aAAa;AACnB,MAAM,cAAc,UAAU,YAAY,QAAQ,QAAQ;AAC1D,MAAM,kBAAkB,UAAU,YAAY,YAAY,YAAY;AAStE,SAAwB,YAAY,OAAO;AAEvC,QAAM,EAAC,OAAO,SAAS,MAAM,OAAO,SAAS,GAAG,aAAA,IAAgB,cAAc,OAAO,UAAU;AAC/F,mBAAiB,YAAY,YAAY;AACzC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,IAAI;AACzC,MAAI,CAAC,SAAS,QAAQ;AAClB,WAAO;AAAA,EACX;AACA,SACI,qBAAA,UAAA,EACI,UAAA;AAAA,IAAA,oBAAC,SAAA,EAAQ,OAAO,OACZ,UAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QAAW;AAAA,QAAY,cAAY;AAAA,QAAO,iBAAc;AAAA,QAC7C,SAAS,CAAC,UAAU;AAChB,gBAAM,gBAAA;AACN,oBAAU,MAAM,aAAa;AAAA,QACjC;AAAA,QACP,UAAA,QAAQ,oBAAC,sBAAA,EAAqB,UAAS,QAAA,CAAQ;AAAA,MAAA;AAAA,IAAA,GAExD;AAAA,IACA,oBAAC,QAAK,UAAU,QAAQ,MAAM,QAAQ,MAAM,GAAG,SAAS,MAAM,UAAU,IAAI,GAAG,SAAS,CAAC,UAAU,MAAM,mBACpG,UAAA,QAAQ,IAAI,CAAC,WACV;AAAA,MAAC;AAAA,MAAA;AAAA,QAA6B,UAAU,OAAO;AAAA,QACrC,SAAS,MAAM;AACX,oBAAU,IAAI;AACd,iBAAO,QAAA;AAAA,QACX;AAAA,QACA,OAAO,OAAO,QAAQ,EAAC,OAAO,GAAG,OAAO,KAAK,QAAA,IAAW;AAAA,QAC7D,UAAA;AAAA,UAAA,OAAO,QAAQ,oBAAC,iBAAA,EAAgB,OAAO,OAAO,QAAQ,EAAC,OAAO,UAAA,IAAa,QAAY,UAAA,OAAO,MAAK;AAAA,UACpG,oBAAC,cAAA,EAAc,UAAA,OAAO,MAAA,CAAM;AAAA,QAAA;AAAA,MAAA;AAAA,MAPd,OAAO;AAAA,IAAA,CAS5B,EAAA,CACL;AAAA,EAAA,GACJ;AAER;"}
+{"version":3,"file":"ActionsMenu.js","sources":["../../../src/ui/actions/ActionsMenu.jsx"],"sourcesContent":["// Un botón «⋯» con un menú de acciones: el de cada tarjeta del tablero, el de cada columna, el de cada mensaje de la bandeja,\n// el de cada tarjeta de registro. Las acciones las da la pantalla (label ya traducido, ícono, color, apagada); sin acciones\n// no se pinta nada.\n//\n//   <ActionsMenu label=\"Acciones de «Junta de cierre»\"\n//                actions={[{key: 'delete', label: 'Borrar', icon: <DeleteOutlineIcon fontSize=\"small\" />, color: 'error', onClick: remove}]} />\n//\n// Tan flexible como un menú de sistema (cada renglón es uno de estos):\n//   {key, label, icon?, description?, color?, disabled?, onClick}   una acción; onClick recibe el evento del clic\n//   {key, label, to, replace?}                                      una pantalla de la app, con la navegación del proyecto\n//                                                                   (react-router, Next o la del navegador): el clic normal\n//                                                                   navega sin recargar y Cmd/Ctrl+clic o el botón de en\n//                                                                   medio la abren en otra pestaña, como cualquier liga\n//   {key, label, href, download?}                                   una liga de afuera (bajar un documento, otro sistema)\n//   {key, label, children: [...]}                                   un submenú: se abre DENTRO del mismo menú, con «‹ Regresar»\n//                                                                   arriba (igual en el teléfono); también con → y ←\n//   {type: 'section', key, label}                                   un título de sección\n//   {type: 'divider', key}                                          una línea\n//   {key, render: ({close}) => …}                                   un renglón propio (abre su ventana y cierra el menú)\n//\n// El clic no llega a lo de abajo: no levanta una tarjeta que se arrastra ni abre el renglón donde vive.\n//\n// Se cambia desde el tema del proyecto, como las piezas de MUI: components.CalcitaActionsMenu con defaultProps y\n// styleOverrides de sus partes: item, itemIcon.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useEffect, useRef, useState} from 'react';\nimport Divider from '@mui/material/Divider';\nimport IconButton from '@mui/material/IconButton';\nimport ListItemIcon from '@mui/material/ListItemIcon';\nimport ListItemText from '@mui/material/ListItemText';\nimport ListSubheader from '@mui/material/ListSubheader';\nimport Menu from '@mui/material/Menu';\nimport MenuItem from '@mui/material/MenuItem';\nimport Tooltip from '@mui/material/Tooltip';\nimport ChevronLeftRoundedIcon from '@mui/icons-material/ChevronLeftRounded';\nimport ChevronRightRoundedIcon from '@mui/icons-material/ChevronRightRounded';\nimport MoreHorizRoundedIcon from '@mui/icons-material/MoreHorizRounded';\n\nimport {piecePart, usePieceProps, withPieceSlots} from '@/theme/themePieces.js';\nimport {useToolkitNavigation} from '@/toolkit/toolkitContext.js';\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport {warnUnknownProps} from '@/toolkit/unknownProps.js';\n\n/** Los renglones que no son acciones. */\nexport const ACTIONS_MENU_ROW = Object.freeze({section: 'section', divider: 'divider'});\n\n// el nombre de la pieza en el tema y sus partes (theme.components.CalcitaActionsMenu)\nconst THEME_NAME = 'CalcitaActionsMenu';\nconst ActionsItem = piecePart(THEME_NAME, 'Item', MenuItem);\nconst ActionsItemIcon = piecePart(THEME_NAME, 'ItemIcon', ListItemIcon);\n\n/**\n * Los renglones del nivel abierto y sus títulos, siguiendo las llaves de los submenús abiertos.\n *\n * @param {object[]} actions\n * @param {string[]} path las llaves de los submenús abiertos, del primero al último\n * @returns {{items: object[], parents: object[]}}\n */\nfunction levelOf(actions, path) {\n    const parents = [];\n    let items = actions;\n    for (const key of path) {\n        const parent = items.find((item) => item.key === key);\n        if (!parent?.children) {\n            break;\n        }\n        parents.push(parent);\n        items = parent.children;\n    }\n    return {items, parents};\n}\n\n/**\n * @param {object} props\n * @param {string} props.label el nombre del botón (lector de pantalla y su tooltip), ya traducido\n * @param {Array<{key: string, type?: string, label?: string, icon?: import('react').ReactNode, description?: string, color?: string, disabled?: boolean, onClick?: (event: import('react').MouseEvent<HTMLElement>) => void, to?: string, replace?: boolean, href?: string, download?: string|boolean, children?: object[], render?: (helpers: {close: () => void}) => import('react').ReactNode}>} [props.actions]\n * @param {import('react').ReactNode} [props.icon] otro ícono para el botón (por omisión «⋯»)\n * @param {'small'|'medium'} [props.size]\n * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete\n */\nfunction ActionsMenuContent(props) {\n    // lo que el proyecto puso en su tema (components.CalcitaActionsMenu.defaultProps) y encima lo que llega aquí\n    const {label, actions, icon, size = 'small', texts, ...unknownProps} = usePieceProps(props, THEME_NAME);\n    warnUnknownProps(THEME_NAME, unknownProps);\n    const {t} = useToolkitTranslation('common', texts);\n    // las pantallas de la app (to) van con el enlace de la navegación del proyecto: así el clic normal no recarga la app\n    const {Link} = useToolkitNavigation();\n    const [anchor, setAnchor] = useState(null);\n    // los submenús abiertos (llaves), del primero al último\n    const [path, setPath] = useState([]);\n    const listRef = useRef(null);\n    const {items, parents} = levelOf(actions ?? [], path);\n\n    // al entrar o salir de un submenú, el foco va a su primer renglón (con el teclado se sigue sin el ratón)\n    useEffect(() => {\n        if (anchor) {\n            listRef.current?.querySelector('[role=\"menuitem\"]:not([aria-disabled=\"true\"])')?.focus();\n        }\n    }, [path, anchor]);\n\n    if (!actions?.length) {\n        return null;\n    }\n    const close = () => {\n        setAnchor(null);\n        setPath([]);\n    };\n    const goBack = () => setPath((current) => current.slice(0, -1));\n\n    return (\n        <>\n            <Tooltip title={label}>\n                <IconButton size={size} aria-label={label} aria-haspopup=\"menu\"\n                            onClick={(event) => {\n                                event.stopPropagation();\n                                setAnchor(event.currentTarget);\n                            }}>\n                    {icon ?? <MoreHorizRoundedIcon fontSize=\"small\" />}\n                </IconButton>\n            </Tooltip>\n            <Menu anchorEl={anchor} open={Boolean(anchor)} onClose={close} onClick={(event) => event.stopPropagation()}\n                  slotProps={{list: {ref: listRef, onKeyDown: (event) => {\n                      if (event.key === 'ArrowLeft' && path.length > 0) {\n                          event.preventDefault();\n                          goBack();\n                      }\n                  }}}}>\n                {parents.length > 0 && [\n                    <ActionsItem key=\"__back\" onClick={goBack} ownSx={{fontWeight: 600}}>\n                        <ActionsItemIcon><ChevronLeftRoundedIcon fontSize=\"small\" /></ActionsItemIcon>\n                        <ListItemText primary={parents.at(-1).label} secondary={t('actionsMenu.back')} />\n                    </ActionsItem>,\n                    <Divider key=\"__back-divider\" />,\n                ]}\n                {items.map((item) => {\n                    if (item.type === ACTIONS_MENU_ROW.divider) {\n                        return <Divider key={item.key} />;\n                    }\n                    if (item.type === ACTIONS_MENU_ROW.section) {\n                        return <ListSubheader key={item.key} sx={{lineHeight: 2.5, bgcolor: 'transparent'}}>{item.label}</ListSubheader>;\n                    }\n                    if (item.render) {\n                        return <li key={item.key}>{item.render({close})}</li>;\n                    }\n                    const hasChildren = Boolean(item.children?.length);\n                    // a dónde lleva el renglón: una pantalla de la app (to), una liga de afuera (href) o nada (una acción)\n                    let destinationProps = {};\n                    if (item.to) {\n                        destinationProps = {component: Link, to: item.to, ...(item.replace && {replace: true})};\n                    } else if (item.href) {\n                        destinationProps = {component: 'a', href: item.href, download: item.download};\n                    }\n                    return (\n                        <ActionsItem\n                            key={item.key}\n                            disabled={item.disabled}\n                            {...destinationProps}\n                            aria-haspopup={hasChildren ? 'menu' : undefined}\n                            onKeyDown={(event) => {\n                                if (hasChildren && event.key === 'ArrowRight') {\n                                    event.preventDefault();\n                                    setPath((current) => [...current, item.key]);\n                                }\n                            }}\n                            onClick={(event) => {\n                                if (hasChildren) {\n                                    setPath((current) => [...current, item.key]);\n                                    return;\n                                }\n                                close();\n                                // con el evento la pantalla decide (saber si fue con Cmd/Ctrl, o detener una liga propia)\n                                item.onClick?.(event);\n                            }}\n                            ownSx={item.color ? {color: `${item.color}.main`} : undefined}\n                        >\n                            {item.icon && <ActionsItemIcon ownSx={item.color ? {color: 'inherit'} : undefined}>{item.icon}</ActionsItemIcon>}\n                            <ListItemText primary={item.label} secondary={item.description} />\n                            {hasChildren && <ChevronRightRoundedIcon fontSize=\"small\" sx={{ml: 2, color: 'text.secondary'}} />}\n                        </ActionsItem>\n                    );\n                })}\n            </Menu>\n        </>\n    );\n}\n\n// lo que se exporta: la pieza con slots y slotProps para cambiar sus partes (themePieces.js)\nconst ActionsMenu = withPieceSlots(ActionsMenuContent, THEME_NAME);\nexport default ActionsMenu;\n"],"names":[],"mappings":"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"}

package/dist/ui/actions/CopyButton.js

@@ -1,29 +1,54 @@
 "use client";
-import { jsx } from "react/jsx-runtime";
-import { useState } from "react";
-import { useToolkitTranslation } from "../../toolkit/useToolkitTranslation.js";
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { useState, useRef, useEffect } from "react";
+import Box from "@mui/material/Box";
 import IconButton from "@mui/material/IconButton";
 import Tooltip from "@mui/material/Tooltip";
 import CheckIcon from "@mui/icons-material/CheckRounded";
 import CopyIcon from "@mui/icons-material/ContentCopyOutlined";
+import ErrorOutlineIcon from "@mui/icons-material/ErrorOutline";
+import { useToolkitTranslation } from "../../toolkit/useToolkitTranslation.js";
 import { warnUnknownProps } from "../../toolkit/unknownProps.js";
-const COPIED_FEEDBACK_MILLISECONDS = 2e3;
-function CopyButton({ value, label, size = "small", onCopied, texts, ...unknownProps }) {
-  warnUnknownProps("CopyButton", unknownProps);
+import { piecePart, withPieceSlots, usePieceProps } from "../../theme/themePieces.js";
+const THEME_NAME = "CalcitaCopyButton";
+const CopyButtonButton = piecePart(THEME_NAME, "Button", IconButton);
+const FEEDBACK_MILLISECONDS = 2e3;
+const COPY_STATE = Object.freeze({ idle: "idle", copied: "copied", failed: "failed" });
+const ICON_BY_STATE = Object.freeze({ [COPY_STATE.idle]: CopyIcon, [COPY_STATE.copied]: CheckIcon, [COPY_STATE.failed]: ErrorOutlineIcon });
+const COLOR_BY_STATE = Object.freeze({ [COPY_STATE.idle]: void 0, [COPY_STATE.copied]: "success.dark", [COPY_STATE.failed]: "error.dark" });
+const VISUALLY_HIDDEN_SX = { position: "absolute", width: "1px", height: "1px", overflow: "hidden", clip: "rect(0 0 0 0)", whiteSpace: "nowrap" };
+function CopyButtonContent(props) {
+  const { value, label, size = "small", onCopied, onCopyFailed, texts, ...unknownProps } = usePieceProps(props, THEME_NAME);
+  warnUnknownProps(THEME_NAME, unknownProps);
   const { t } = useToolkitTranslation("common", texts);
-  const [isCopied, setIsCopied] = useState(false);
+  const [copyState, setCopyState] = useState(COPY_STATE.idle);
+  const resetTimer = useRef(null);
   const buttonLabel = label ?? t("form.copy");
+  useEffect(() => () => clearTimeout(resetTimer.current), []);
   const copy = async () => {
+    clearTimeout(resetTimer.current);
     try {
-      await navigator.clipboard.writeText(value);
-      setIsCopied(true);
+      await navigator.clipboard.writeText(typeof value === "function" ? value() : value);
+      setCopyState(COPY_STATE.copied);
       onCopied?.();
-      setTimeout(() => setIsCopied(false), COPIED_FEEDBACK_MILLISECONDS);
-    } catch {
+    } catch (error) {
+      setCopyState(COPY_STATE.failed);
+      onCopyFailed?.(error);
     }
+    resetTimer.current = setTimeout(() => setCopyState(COPY_STATE.idle), FEEDBACK_MILLISECONDS);
   };
-  return /* @__PURE__ */ jsx(Tooltip, { title: isCopied ? t("form.copied") : buttonLabel, children: /* @__PURE__ */ jsx(IconButton, { size, "aria-label": buttonLabel, onClick: copy, color: isCopied ? "success" : "default", children: isCopied ? /* @__PURE__ */ jsx(CheckIcon, { fontSize: "inherit" }) : /* @__PURE__ */ jsx(CopyIcon, { fontSize: "inherit" }) }) });
+  const feedbackText = {
+    [COPY_STATE.idle]: buttonLabel,
+    [COPY_STATE.copied]: t("form.copied"),
+    [COPY_STATE.failed]: t("form.copyFailed")
+  }[copyState];
+  const StateIcon = ICON_BY_STATE[copyState];
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Tooltip, { title: feedbackText, open: copyState === COPY_STATE.idle ? void 0 : true, placement: "top", children: /* @__PURE__ */ jsx(CopyButtonButton, { size, "aria-label": buttonLabel, onClick: copy, sx: { color: COLOR_BY_STATE[copyState] }, children: /* @__PURE__ */ jsx(StateIcon, { fontSize: "inherit" }) }) }),
+    /* @__PURE__ */ jsx(Box, { component: "span", role: "status", "aria-live": "polite", sx: VISUALLY_HIDDEN_SX, children: copyState === COPY_STATE.idle ? "" : feedbackText })
+  ] });
 }
+const CopyButton = withPieceSlots(CopyButtonContent, THEME_NAME);
 export {
   CopyButton as default
 };