@stackcraftmx/calcita 0.47.0 → 0.52.0

package/dist/types/theme/themePieces.d.ts

@@ -1,6 +1,29 @@
+/**
+ * El sx de la pantalla como lista, para ponerlo DESPUÉS del de la pieza sin mezclarlo dentro del mismo objeto.
+ *
+ * OJO, trampa pagada: `{...estiloDeLaPieza, ...sx}` reemplaza la llave entera cuando las dos traen la misma
+ * ('& .MuiDataGrid-cell': la pieza ponía display flex y la pantalla solo quería alinear arriba: se perdía el flex sin
+ * avisar). En una lista, MUI aplica cada elemento encima del anterior y se combinan regla por regla.
+ *
+ *   sx={[{p: 2}, ...sxListOf(sx)]}
+ *
+ * @param {object|Function|Array<object|Function|boolean|null|undefined>|null|undefined} sx
+ * @returns {Array<object|Function|boolean|null|undefined>}
+ */
+export declare function sxListOf(sx: object | Function | Array<object | Function | boolean | null | undefined> | null | undefined): Array<object | Function | boolean | null | undefined>;
+/**
+ * Las props de una parte con las de slotProps encima: las de la pantalla ganan, menos className (se suman), style (se
+ * juntan) y sx (va después y se combina regla por regla).
+ *
+ * @param {object} partProps las que le pone Calcita
+ * @param {object|((partProps: object) => object)|undefined} extra las de slotProps (o una función que las da)
+ * @returns {object}
+ */
+export declare function mergedSlotProps(partProps: object, extra: object | ((partProps: object) => object) | undefined): object;
 /**
  * Un componente con su lugar en el tema: theme.components[name].styleOverrides[parte con minúscula] se aplica después
- * del estilo de Calcita (ownSx) y gana.
+ * del estilo de Calcita (ownSx) y gana. La parte también se puede cambiar o recibir props de más con slots y slotProps
+ * de su pieza.
  *
  * @template {import('react').ElementType} C
  * @param {string} name el nombre de la pieza en el tema (CalcitaMetricCard)
@@ -10,11 +33,40 @@
  */
 export declare function piecePart<C extends import('react').ElementType>(name: string, slot: string, component?: C): import('react').ComponentType<any>;
 /**
- * Los props de la pieza con los defaultProps del tema del proyecto debajo: lo que llega en la pantalla gana.
+ * Los props de la pieza con los defaultProps del tema del proyecto debajo: lo que llega en la pantalla gana. Sin slots ni
+ * slotProps: esos son de sus partes (withPieceSlots).
+ *
+ * OJO: una pieza cuyo `slotProps` ya es de otra cosa (TextInput se lo pasa al TextField de MUI: input, htmlInput…) lo
+ * conserva con {ownSlotProps: true} y no se envuelve con withPieceSlots.
  *
  * @template {object} P
  * @param {P} props
  * @param {string} name el nombre de la pieza en el tema
+ * @param {{ownSlotProps?: boolean}} [options]
  * @returns {P}
  */
-export declare function usePieceProps<P extends object>(props: P, name: string): P;
+export declare function usePieceProps<P extends object>(props: P, name: string, { ownSlotProps }?: {
+    ownSlotProps?: boolean;
+}): P;
+/**
+ * La pieza con slots y slotProps: lee los de la pantalla (y los de defaultProps del tema) y se los da a sus partes.
+ *
+ * OJO con el tipo: se toma del componente entero (Parameters) y no de un genérico de sus props: con las props opcionales
+ * (ColorSchemeToggle) TypeScript las deducía como `object` y se perdían.
+ *
+ * Una parte que también se exporta sola y se pinta DENTRO de su pieza madre con el mismo nombre (las tarjetas de
+ * TableCardsView dentro de ServerTable, las dos CalcitaServerTable) va con {sharedWithParent: true}: adentro usa los slots
+ * de la madre (sin eso los borraría con los suyos, vacíos), salvo que la pantalla le dé los suyos; sola, los suyos.
+ *
+ * @template {(props: any) => any} C
+ * @param {C} Content la pieza
+ * @param {string} name el nombre de la pieza en el tema
+ * @param {{sharedWithParent?: boolean}} [options]
+ * @returns {(props: NonNullable<Parameters<C>[0]> & {slots?: Record<string, import('react').ElementType>, slotProps?: Record<string, object|((partProps: object) => object)>}) => ReturnType<C>}
+ */
+export declare function withPieceSlots<C extends (props: any) => any>(Content: C, name: string, { sharedWithParent }?: {
+    sharedWithParent?: boolean;
+}): (props: NonNullable<Parameters<C>[0]> & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => ReturnType<C>;

package/dist/types/toolkit/ToolkitProvider.d.ts

@@ -8,6 +8,12 @@
  *     tipos de archivo del proyecto para las descargas, además de Excel, CSV y PDF (downloads/fileTypes.js)
  * @param {(language: string) => void} [props.onLanguageChange] lo llama LanguageToggle; el proyecto cambia su idioma
  * @param {object} [props.texts] textos propios por idioma, con la forma de locales/ ({es: {table: {...}}})
+ * @param {(error: unknown) => unknown} [props.readValidationMessage] cómo leer los mensajes de validación de un sistema que ya
+ *     existe (su propio setLocale de yup, su forma de error): regresa un texto, {key, values} o undefined para la lectura de
+ *     siempre. Ej. ({msg, values}) de muchos sistemas con i18next ya se entiende solo; esto es para lo demás
+ * @param {(missing: {namespace: string, key: string, language: string}) => void} [props.onMissingText] avisa cada texto que
+ *     no existe (la pantalla enseña la llave): para mandarlo a Sentry o tronar una prueba. Sin él, Calcita avisa en la
+ *     consola una vez por idioma y llave
  * @param {(namespace: string, key: string, values?: object) => string|undefined} [props.translate] traductor del
  *     proyecto (por ejemplo i18next); undefined deja el texto del paquete
  * @param {string} [props.timeZone] zona de las fechas (por omisión la del navegador)
@@ -23,7 +29,7 @@
  *     tiene regla
  * @param {import('react').ReactNode} props.children
  */
-export declare const ToolkitProvider: ({ language, languages, onLanguageChange, texts, translate, timeZone, currency, hourCycle, appName, navigation, buildId, canAccess, fileTypes, children, ...unknownProps }: {
+export declare const ToolkitProvider: ({ language, languages, onLanguageChange, onMissingText, readValidationMessage, texts, translate, timeZone, currency, hourCycle, appName, navigation, buildId, canAccess, fileTypes, children, ...unknownProps }: {
     language?: string;
     languages?: Array<{
         code: string;
@@ -38,6 +44,12 @@ export declare const ToolkitProvider: ({ language, languages, onLanguageChange,
     }>;
     onLanguageChange?: (language: string) => void;
     texts?: object;
+    readValidationMessage?: (error: unknown) => unknown;
+    onMissingText?: (missing: {
+        namespace: string;
+        key: string;
+        language: string;
+    }) => void;
     translate?: (namespace: string, key: string, values?: object) => string | undefined;
     timeZone?: string;
     currency?: string;

package/dist/types/toolkit/browserNavigation.d.ts

@@ -2,12 +2,14 @@
  * La navegación del navegador, con o sin prefijo.
  *
  * @param {{basePath?: string}} [options] basePath: donde vive la app detrás de un proxy ('/portal'); sin él, la raíz
- * @returns {{useNavigate: () => (destination: string|number) => void, useLocation: () => {pathname: string, search: string, key: string}, Link: import('react').ElementType}}
+ * @returns {{useNavigate: () => (destination: string|number, options?: {replace?: boolean}) => void, useLocation: () => {pathname: string, search: string, key: string}, Link: import('react').ElementType}}
  */
 export declare function createBrowserNavigation({ basePath }?: {
     basePath?: string;
 }): {
-    useNavigate: () => (destination: string | number) => void;
+    useNavigate: () => (destination: string | number, options?: {
+        replace?: boolean;
+    }) => void;
     useLocation: () => {
         pathname: string;
         search: string;
@@ -17,7 +19,9 @@ export declare function createBrowserNavigation({ basePath }?: {
 };
 /** La de omisión: sin prefijo. */
 export declare const browserNavigation: {
-    useNavigate: () => (destination: string | number) => void;
+    useNavigate: () => (destination: string | number, options?: {
+        replace?: boolean;
+    }) => void;
     useLocation: () => {
         pathname: string;
         search: string;

package/dist/types/toolkit/combineTexts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {Array<Record<string, Record<string, object>>>} textFiles los textos de cada módulo, por idioma
+ * @returns {Record<string, Record<string, object>>} todos los textos, por idioma y namespace
+ * @throws {Error} si dos módulos definen el mismo texto
+ */
+export declare function combineTexts(textFiles: Array<Record<string, Record<string, object>>>): Record<string, Record<string, object>>;

package/dist/types/toolkit/hashNavigation.d.ts

@@ -1,8 +1,10 @@
 /**
- * @returns {{useNavigate: () => (destination: string|number) => void, useLocation: () => {pathname: string, search: string, key: string}, Link: import('react').ElementType}}
+ * @returns {{useNavigate: () => (destination: string|number, options?: {replace?: boolean}) => void, useLocation: () => {pathname: string, search: string, key: string}, Link: import('react').ElementType}}
  */
 export declare function createHashNavigation(): {
-    useNavigate: () => (destination: string | number) => void;
+    useNavigate: () => (destination: string | number, options?: {
+        replace?: boolean;
+    }) => void;
     useLocation: () => {
         pathname: string;
         search: string;

package/dist/types/toolkit/navigationPaths.d.ts

@@ -41,3 +41,38 @@ export declare function hashLocationOf(hash: string): {
  * @returns {string}
  */
 export declare function hashHrefOf(destination: string): string;
+/**
+ * Si un clic en un enlace es el normal: el botón principal, sin Cmd/Ctrl/Shift/Alt y sin que nadie lo haya detenido.
+ * Solo ese se hace por dentro (cambiar de pantalla, reemplazar el historial); con Cmd/Ctrl+clic, Shift+clic o el botón de en
+ * medio el navegador hace lo suyo (otra pestaña, otra ventana), como con cualquier liga.
+ *
+ * @param {{button?: number, metaKey?: boolean, ctrlKey?: boolean, shiftKey?: boolean, altKey?: boolean, defaultPrevented?: boolean}} event
+ * @param {string} [target] el target del enlace: con _blank tampoco se hace por dentro
+ * @returns {boolean}
+ */
+export declare function isPlainLeftClick(event: {
+    button?: number;
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    defaultPrevented?: boolean;
+}, target?: string): boolean;
+/**
+ * El prefijo con que el servidor sirvió la página, leído al abrirla de su <base href> ('/ventas'), o null si la página no
+ * trae <base>. Así UNA compilación sirve detrás de cualquier prefijo que decida el servidor (Laravel lo pone con
+ * config('app.url'), un proxy con su ruta): el prefijo no se fija al compilar. Para el basename del router y para
+ * createBrowserNavigation({basePath}).
+ *
+ *   <base href="{{ rtrim(config('app.url'), '/') . '/' }}">          (en la vista que sirve la app)
+ *   createBrowserRouter(routes, {basename: documentBasePath() || '/'})
+ *
+ * OJO: con <base>, todo lo relativo de la página (imágenes, ligas «#sección») se lee desde ese prefijo.
+ *
+ * @param {{baseURI?: string, querySelector?: (selector: string) => unknown}} [currentDocument] por omisión el de la página
+ * @returns {string|null} '' en la raíz; null sin <base> (o sin navegador)
+ */
+export declare function documentBasePath(currentDocument?: {
+    baseURI?: string;
+    querySelector?: (selector: string) => unknown;
+}): string | null;

package/dist/types/toolkit/pathIndex.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Le pone sus partes a una ruta: las que pide con dos puntos y, lo que sobre, la consulta. Los nulos y los vacíos no se
+ * escriben.
+ *
+ * @param {string} route la ruta con sus :partes ('/orders/:orderId', ':page?' es opcional)
+ * @param {Record<string, unknown>} [params]
+ * @param {string} [name] cómo se llama, para decirlo si algo falta
+ * @returns {string}
+ * @throws {Error} si la ruta pide una parte obligatoria que no viene
+ */
+export declare function fillPath(route: string, params?: Record<string, unknown>, name?: string): string;
+/**
+ * El índice de las direcciones que publica cada módulo.
+ *
+ * @param {Record<string, Record<string, unknown>>} modules lo que da import.meta.glob(..., {eager: true}): archivo → sus exports
+ * @param {object} [options]
+ * @param {string} [options.exportName] el export con las direcciones en cada archivo (por omisión 'paths'; para el API, 'uris')
+ * @param {RegExp} [options.modulePattern] saca del nombre del archivo el camino del módulo (el primer grupo, con /)
+ * @returns {{pathOf: (name: string, params?: Record<string, unknown>) => string, allPaths: () => object}}
+ */
+export declare function createPathIndex(modules: Record<string, Record<string, unknown>>, { exportName, modulePattern }?: {
+    exportName?: string;
+    modulePattern?: RegExp;
+}): {
+    pathOf: (name: string, params?: Record<string, unknown>) => string;
+    allPaths: () => object;
+};

package/dist/types/toolkit/toolkitSettings.d.ts

@@ -33,7 +33,7 @@ export declare function browserTimeZone(): string;
  * Cambia la configuración que leen las funciones del paquete. La llama ToolkitProvider; un proyecto sin React (o una
  * prueba) la puede llamar directo.
  *
- * @param {{language?: string, texts?: object, translate?: Function|null, timeZone?: string, currency?: string, hourCycle?: 'h23'|'h12', appName?: string, buildId?: string, languages?: Array<{code: string, label: string, locale?: string}>}} settings
+ * @param {{language?: string, texts?: object, translate?: Function|null, timeZone?: string, currency?: string, hourCycle?: 'h23'|'h12', appName?: string, buildId?: string, languages?: Array<{code: string, label: string, locale?: string}>, onMissingText?: Function|null}} settings
  * @returns {void}
  */
 export declare function configureToolkit(settings: {
@@ -50,6 +50,7 @@ export declare function configureToolkit(settings: {
         label: string;
         locale?: string;
     }>;
+    onMissingText?: Function | null;
 }): void;
 /**
  * La configuración vigente.
@@ -102,16 +103,18 @@ export declare function componentTextOf(layers: Array<{
 /**
  * El texto de una llave con una configuración dada (la del proveedor o la vigente).
  *
- * @param {{language: string, texts: object, translate: Function|null}} settings
+ * @param {{language: string, texts: object, translate: Function|null, onMissingText?: Function|null}} settings
  * @param {string} defaultNamespace el namespace cuando la llave no trae uno («table», «common», «problems»...)
  * @param {string} key «llave» o «namespace:llave»
- * @param {object} [values] las variables del texto y, para el plural, count
- * @returns {string} la llave misma si no hay texto, para que se note qué falta
+ * @param {object} [values] las variables del texto y, para el plural, count. Con `defaultValue` el texto es opcional: si no
+ *     existe se usa ese y no se avisa
+ * @returns {string} la llave misma si no hay texto, para que se note qué falta (y se avisa: reportMissingText)
  */
 export declare function translateWith(settings: {
     language: string;
     texts: object;
     translate: Function | null;
+    onMissingText?: Function | null;
 }, defaultNamespace: string, key: string, values?: object): string;
 /**
  * El texto de una llave con la configuración vigente, para lo que no es componente (avisos, errores del servidor).

package/dist/types/ui/actions/ActionsMenu.d.ts

@@ -3,15 +3,7 @@ export declare const ACTIONS_MENU_ROW: Readonly<{
     section: "section";
     divider: "divider";
 }>;
-/**
- * @param {object} props
- * @param {string} props.label el nombre del botón (lector de pantalla y su tooltip), ya traducido
- * @param {Array<{key: string, type?: string, label?: string, icon?: import('react').ReactNode, description?: string, color?: string, disabled?: boolean, onClick?: () => void, href?: string, download?: string|boolean, children?: object[], render?: (helpers: {close: () => void}) => import('react').ReactNode}>} [props.actions]
- * @param {import('react').ReactNode} [props.icon] otro ícono para el botón (por omisión «⋯»)
- * @param {'small'|'medium'} [props.size]
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function ActionsMenu(props: {
+declare const ActionsMenu: (props: {
     label: string;
     actions?: Array<{
         key: string;
@@ -21,7 +13,9 @@ export default function ActionsMenu(props: {
         description?: string;
         color?: string;
         disabled?: boolean;
-        onClick?: () => void;
+        onClick?: (event: import('react').MouseEvent<HTMLElement>) => void;
+        to?: string;
+        replace?: boolean;
         href?: string;
         download?: string | boolean;
         children?: object[];
@@ -32,4 +26,8 @@ export default function ActionsMenu(props: {
     icon?: import('react').ReactNode;
     size?: 'small' | 'medium';
     texts?: object;
-}): import("react").JSX.Element | null;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element | null;
+export default ActionsMenu;

package/dist/types/ui/actions/CopyButton.d.ts

@@ -1,18 +1,12 @@
-/**
- * @param {object} props
- * @param {string|(() => string)} props.value lo que se copia; una función se llama al picar
- * @param {string} [props.label] ya traducido: qué copia («Copiar el folio»); por omisión «Copiar». Es el globo y el nombre
- *     del botón para un lector de pantalla
- * @param {'small'|'medium'} [props.size]
- * @param {() => void} [props.onCopied]
- * @param {(error: unknown) => void} [props.onCopyFailed] el navegador no dejó copiar (el botón ya lo dice en rojo)
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function CopyButton({ value, label, size, onCopied, onCopyFailed, texts, ...unknownProps }: {
+declare const CopyButton: (props: {
     value: string | (() => string);
     label?: string;
     size?: 'small' | 'medium';
     onCopied?: () => void;
     onCopyFailed?: (error: unknown) => void;
     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 CopyButton;

package/dist/types/ui/actions/DownloadMenu.d.ts

@@ -1,31 +1,4 @@
-/**
- * @param {object} props
- * @param {string[]} props.formats los tipos de archivo, en orden: los de la casa (xlsx, csv, pdf) y los que el proyecto declare
- *     en ToolkitProvider fileTypes (zip, xml…)
- * @param {(format: string, transferOptions: {signal: AbortSignal, onDownloadProgress: (progress: {loaded: number, total?: number|null}) => void}) => Promise<{blob: Blob, fileName: string}>} props.download
- * @param {string} [props.label] ya traducido; por defecto "Descargar"
- * @param {string} [props.downloadLabel] ya traducido; lo que se ve en el panel de descargas antes de saber el nombre
- *     del archivo
- * @param {boolean} [props.disabled]
- * @param {(format: string) => {title: string, description: import('react').ReactNode, confirmLabel?: string}} [props.confirmation]
- * @param {(format: string) => void} [props.onDownloaded] p. ej. volver a pedir la tabla (si la descarga cambia algo en
- *     el servidor)
- * @param {(format: string, error: unknown) => void} [props.onFailed] cuando la descarga no se pudo (el panel ya lo dice)
- * @param {(format: string) => void} [props.onCanceled] cuando la persona la canceló desde el panel
- * @param {'button'|'icon'} [props.variant] icon = solo el icono (columna de acciones de una tabla)
- * @param {string} [props.ariaLabel] ya traducido; obligatorio en la variante icon
- * @param {(format: string) => void} [props.onChooseFormat] quien llama se encarga de confirmar y descargar
- * @param {import('react').ElementType} [props.icon] ícono del botón; por defecto el de descarga. Distingue dos descargas en la
- *     misma fila
- *
- * IMPORTANTE: hay que pasar `confirmation` u `onChooseFormat`. Sin ninguno de los dos el menú no descarga nada (regla de
- * tablas: toda descarga pasa por confirmación).
- *
- * OJO onChooseFormat: dentro de una celda del DataGrid el diálogo de confirmación NO puede vivir en la celda (el grid
- * virtualiza y vuelve a pintar sus celdas; el diálogo se perdía al elegir el formato). Ahí el menú solo avisa qué formato
- * se eligió y la pantalla abre SU confirmación (useConfirmAction) fuera de la tabla.
- */
-export default function DownloadMenu(props: {
+declare const DownloadMenu: (props: {
     formats: string[];
     download: (format: string, transferOptions: {
         signal: AbortSignal;
@@ -52,4 +25,8 @@ export default function DownloadMenu(props: {
     ariaLabel?: string;
     onChooseFormat?: (format: string) => void;
     icon?: import('react').ElementType;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default DownloadMenu;

package/dist/types/ui/actions/SecretField.d.ts

@@ -1,17 +1,12 @@
-/**
- * @param {object} props
- * @param {string} props.value el secreto
- * @param {string} props.label ya traducido
- * @param {string} [props.helperText] p. ej. «Guárdela: no se vuelve a enseñar»
- * @param {() => void} [props.onCopied]
- * @param {(isRevealed: boolean) => void} [props.onRevealChange] se destapó o se tapó (para registrar quién vio el secreto)
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function SecretField({ value, label, helperText, onCopied, onRevealChange, texts, ...unknownProps }: {
+declare const SecretField: (props: {
     value: string;
     label: string;
     helperText?: string;
     onCopied?: () => void;
     onRevealChange?: (isRevealed: boolean) => void;
     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 SecretField;

package/dist/types/ui/actions/SelectionActions.d.ts

@@ -11,18 +11,7 @@ export declare const SELECTION_PHONE_LAYOUT: Readonly<{
  * @returns {boolean}
  */
 export declare function selectionFloatsOnPhone(theme: object): boolean;
-/**
- * @param {object} props
- * @param {string} props.countText «5 pedidos elegidos», ya traducido. La pieza se pinta mientras la pantalla la ponga: con
- *     nada elegido, no la ponga
- * @param {Array<{key: string, label: string, icon?: import('react').ReactNode, color?: 'inherit'|'primary'|'secondary'|'error'|'info'|'success'|'warning', disabled?: boolean, onClick: () => unknown}>} [props.actions]
- *     label ya traducido; en el teléfono se ve el ícono (sin él, el texto). onClick puede regresar una promesa
- * @param {() => void} props.onClear quitar la selección
- * @param {'top'|'split'} [props.phoneLayout] SELECTION_PHONE_LAYOUT; por omisión todo arriba
- * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {selection: {clear, actionsLabel, summaryLabel}}
- * @param {object} [props.sx] estilos del renglón
- */
-export default function SelectionActions(props: {
+declare const SelectionActions: (props: {
     countText: string;
     actions?: Array<{
         key: string;
@@ -36,4 +25,8 @@ export default function SelectionActions(props: {
     phoneLayout?: 'top' | 'split';
     texts?: object;
     sx?: object;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default SelectionActions;

package/dist/types/ui/cards/RecordCard.d.ts

@@ -1,33 +1,15 @@
 /**
- * @param {object} props
- * @param {import('react').ReactNode} props.title el nombre del registro, ya traducido
- * @param {import('react').ReactNode} [props.eyebrow] arriba del título: el folio o el tipo
- * @param {import('react').ReactNode} [props.subtitle] abajo del título
- * @param {string|import('react').ReactNode} [props.avatar] un texto (de él salen las iniciales) o un ícono
- * @param {import('react').ReactNode} [props.status] a la derecha: StatusChip, IconBadge…
- * @param {Parameters<typeof import('../actions/ActionsMenu.js').default>[0]['actions']} [props.actions] el menú «⋯», con sus secciones,
- *     separadores, ligas y submenús (los renglones de ActionsMenu)
- * @param {Array<{key?: string, title?: import('react').ReactNode, facts?: Array<{label: import('react').ReactNode, value: import('react').ReactNode, emphasis?: boolean}>, content?: import('react').ReactNode}>} [props.groups]
- *     los datos, en grupos; emphasis los pone en negritas; content en lugar de facts para un grupo libre (una barra, unas
- *     insignias, un enlace)
- * @param {import('react').ReactNode} [props.header] un encabezado propio en lugar del de la casa (avatar, títulos, estatus)
- * @param {import('react').ReactNode} [props.children] contenido libre entre el cuerpo y lo de abajo
- * @param {{label: import('react').ReactNode, value: import('react').ReactNode, caption?: import('react').ReactNode}} [props.highlight] el dato principal
- * @param {import('react').ReactNode} [props.trailing] la última columna del cuerpo, después de los grupos y del dato principal
- *     (el estatus o unos botones, cuando el orden obligatorio los pone al final)
- * @param {string} [props.columns] en escritorio, el ancho de cada columna del cuerpo como en CSS ('1.2fr 1fr 1fr auto'); por
- *     omisión, los grupos a partes iguales y el dato principal y trailing a su medida
- * @param {import('react').ReactNode} [props.footer] abajo, a todo lo ancho
- * @param {import('react').ReactNode} [props.details] lo que se despliega con «Ver detalle»
- * @param {string} [props.detailsLabel] ya traducido; por omisión «Ver detalle»
- * @param {boolean} [props.defaultDetailsOpen]
- * @param {(isOpen: boolean) => void} [props.onDetailsToggle]
- * @param {() => void} [props.onOpen] el botón para abrir el registro (su detalle)
- * @param {string} [props.openLabel] ya traducido: el nombre de ese botón («Abrir el pedido P-1203»)
- * @param {object} [props.sx]
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ * Cómo se acomoda el renglón de abajo (footer y «Ver detalle»):
+ *   spaceBetween  el footer a la izquierda y «Ver detalle» en la otra orilla (lo de siempre);
+ *   start         los dos juntos, a la izquierda;
+ *   end           los dos juntos, a la derecha.
  */
-export default function RecordCard(props: {
+export declare const RECORD_CARD_FOOTER_ALIGN: Readonly<{
+    spaceBetween: "spaceBetween";
+    start: "start";
+    end: "end";
+}>;
+declare const RecordCard: (props: {
     title: import('react').ReactNode;
     eyebrow?: import('react').ReactNode;
     subtitle?: import('react').ReactNode;
@@ -54,6 +36,7 @@ export default function RecordCard(props: {
     trailing?: import('react').ReactNode;
     columns?: string;
     footer?: import('react').ReactNode;
+    footerAlign?: 'spaceBetween' | 'start' | 'end';
     details?: import('react').ReactNode;
     detailsLabel?: string;
     defaultDetailsOpen?: boolean;
@@ -62,4 +45,8 @@ export default function RecordCard(props: {
     openLabel?: string;
     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 RecordCard;

package/dist/types/ui/cards/RecordCardSkeleton.d.ts

@@ -1,17 +1,12 @@
-/**
- * @param {object} props
- * @param {number} [props.groups] cuántos grupos de datos (como los de la tarjeta)
- * @param {number} [props.factsPerGroup]
- * @param {boolean} [props.withAvatar]
- * @param {boolean} [props.withHighlight]
- * @param {object} [props.sx]
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function RecordCardSkeleton({ groups, factsPerGroup, withAvatar, withHighlight, sx, texts, ...unknownProps }: {
+declare const RecordCardSkeleton: (props: {
     groups?: number;
     factsPerGroup?: number;
     withAvatar?: boolean;
     withHighlight?: boolean;
     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 RecordCardSkeleton;

package/dist/types/ui/countdown/Countdown.d.ts

@@ -1,17 +1,4 @@
-/**
- * @param {object} props
- * @param {string|number|Date} props.until el momento: un instante en texto, un Date o milisegundos
- * @param {string} [props.label] ya traducido: qué se cuenta («Tiempo para que cierren las inscripciones»), para un lector de pantalla
- * @param {() => void} [props.onComplete] al llegar a cero (una vez)
- * @param {import('react').ReactNode} [props.completedText] lo que dice al terminar; por omisión «Ya terminó»
- * @param {boolean} [props.showSeconds] por omisión, sí
- * @param {(parts: {days: number, hours: number, minutes: number, seconds: number, totalSeconds: number, isOver: boolean}) => import('react').ReactNode} [props.children]
- *     para pintarla a su manera
- * @param {import('@mui/material/Typography').TypographyProps['variant']} [props.variant] por omisión body1
- * @param {object} [props.sx]
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function Countdown(props: {
+declare const Countdown: (props: {
     until: string | number | Date;
     label?: string;
     onComplete?: () => void;
@@ -28,4 +15,8 @@ export default function Countdown(props: {
     variant?: import('@mui/material/Typography').TypographyProps['variant'];
     sx?: object;
     texts?: object;
-}): string | number | bigint | boolean | import("react").JSX.Element | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | Iterable<import("react").ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => string | number | bigint | boolean | import("react").JSX.Element | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | Iterable<import("react").ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;
+export default Countdown;

package/dist/types/ui/documents/PdfViewerDialog.d.ts

@@ -1,15 +1,4 @@
-/**
- * @param {object} props
- * @param {boolean} props.open
- * @param {() => void} props.onClose
- * @param {string} props.title ya traducido: qué documento es
- * @param {string|Blob|null} props.src la dirección del PDF o el archivo (Blob o File)
- * @param {string} [props.fileName] con qué nombre se descarga (por omisión, el título con .pdf)
- * @param {import('react').ReactNode} [props.actions] botones suyos junto a «Abrir en otra pestaña» y «Descargar»
- * @param {() => void} [props.onDownload] al descargar (para registrarlo, por ejemplo)
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function PdfViewerDialog(props: {
+declare const PdfViewerDialog: (props: {
     open: boolean;
     onClose: () => void;
     title: string;
@@ -18,4 +7,8 @@ export default function PdfViewerDialog(props: {
     actions?: import('react').ReactNode;
     onDownload?: () => void;
     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 PdfViewerDialog;

package/dist/types/ui/filters/DateRangeFilter.d.ts

@@ -1,12 +1,4 @@
-/**
- * @param {object} props
- * @param {string} [props.from] AAAA-MM-DD o '' si no hay
- * @param {string} [props.to] AAAA-MM-DD o '' si no hay
- * @param {(range: {from: string, to: string}) => void} props.onChange '' para quitar
- * @param {string} [props.label] ya traducido; por defecto "Personalizado"
- * @param {object} [props.texts] los textos que cambian, con la forma de `table` en los textos del paquete
- */
-export default function DateRangeFilter(props: {
+declare const DateRangeFilter: (props: {
     from?: string;
     to?: string;
     onChange: (range: {
@@ -15,4 +7,8 @@ export default function DateRangeFilter(props: {
     }) => void;
     label?: string;
     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 DateRangeFilter;

package/dist/types/ui/filters/FilterDrawer.d.ts

@@ -3,22 +3,7 @@ export declare const FILTER_DRAWER_ANCHOR: Readonly<{
     left: "left";
     right: "right";
 }>;
-/**
- * @param {object} props
- * @param {boolean} props.open
- * @param {() => void} props.onClose
- * @param {object[]} props.fields los campos (filterDrawerFields.js): {name, label, kind, options?, keys?, prefix?, suffix?, decimals?, operators?, render?…}
- * @param {Record<string, unknown>} props.values los filtros puestos hoy (de ahí sale el borrador al abrir)
- * @param {(values: Record<string, unknown>) => void} props.onApply todos los campos del cajón juntos, al picar «Buscar»
- * @param {'left'|'right'} [props.anchor] de qué lado sale (FILTER_DRAWER_ANCHOR); por omisión la derecha
- * @param {number} [props.width] su ancho en escritorio, en px
- * @param {string} [props.title] ya traducido; por omisión «Filtros»
- * @param {string} [props.applyLabel] ya traducido; por omisión «Buscar»
- * @param {boolean} [props.closeOnApply] por omisión sí
- * @param {import('react').ReactNode} [props.children] algo más abajo de los campos (una nota, un enlace)
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function FilterDrawer(props: {
+declare const FilterDrawer: (props: {
     open: boolean;
     onClose: () => void;
     fields: object[];
@@ -31,4 +16,8 @@ export default function FilterDrawer(props: {
     closeOnApply?: boolean;
     children?: import('react').ReactNode;
     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 FilterDrawer;