@stackcraftmx/calcita 0.47.0 → 0.51.0

package/dist/types/locales/es.d.ts

@@ -62,6 +62,26 @@ declare const _default: Readonly<{
             all: string;
             countAriaLabel: string;
         };
+        views: {
+            label: string;
+            table: string;
+            cards: string;
+        };
+        cards: {
+            label: string;
+            pagination: {
+                page: string;
+                first: string;
+                last: string;
+                next: string;
+                previous: string;
+                "start-ellipsis": string;
+                "end-ellipsis": string;
+            };
+        };
+        cells: {
+            empty: string;
+        };
         detail: {
             tooltip: string;
             ariaLabel: string;
@@ -684,6 +704,10 @@ declare const _default: Readonly<{
         rfc: string;
         curp: string;
         clabe: string;
+        sameAs: string;
+        sameAsUnnamed: string;
+        percent: string;
+        postalCode: string;
         listDuplicate: string;
         listOrderBetween: string;
         listOrderAbovePrevious: string;

package/dist/types/maps/MapView.d.ts

@@ -3,22 +3,7 @@ export declare const OPEN_STREET_MAP_TILES: Readonly<{
     url: "https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png";
     attribution: "&copy; <a href=\"https://www.openstreetmap.org/copyright\">OpenStreetMap</a>";
 }>;
-/**
- * @param {object} props
- * @param {Array<{id: string, position: [number, number], title: string, description?: string, tone?: string} & Record<string, any>>} props.markers
- *     tone: un color del tema (primary, success, warning, error, info…); por omisión primary
- * @param {string|null} [props.selectedId]
- * @param {(markerId: string) => void} [props.onSelect] al picar un marcador
- * @param {string} props.ariaLabel ya traducido: qué enseña el mapa
- * @param {number} [props.height] px
- * @param {{url: string, attribution: string}} [props.tileLayer] por omisión OpenStreetMap
- * @param {(marker: any) => import('react').ReactNode} [props.renderPopup] lo que dice el globo de un marcador (recibe el
- *     marcador tal cual, con sus campos propios); por omisión su título y su descripción
- * @param {(position: [number, number]) => void} [props.onMapClick] al picar el mapa fuera de un marcador
- * @param {import('react').ReactNode} [props.children] capas propias de react-leaflet (Circle, Polygon, GeoJSON…)
- * @param {object} [props.mapProps] lo demás de MapContainer de react-leaflet (scrollWheelZoom, minZoom…)
- */
-export default function MapView(props: {
+declare const MapView: (props: {
     markers: Array<{
         id: string;
         position: [number, number];
@@ -38,4 +23,8 @@ export default function MapView(props: {
     onMapClick?: (position: [number, number]) => void;
     children?: import('react').ReactNode;
     mapProps?: object;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default MapView;

package/dist/types/mexico/CfdiSummary.d.ts

@@ -1,17 +1,12 @@
-/**
- * @param {object} props
- * @param {import('./cfdiReader.js').Cfdi} props.cfdi lo que regresa readCfdi
- * @param {string} [props.expectedReceiverRfc] el RFC que debe recibirla (el de la empresa); si es otro, se avisa
- * @param {boolean} [props.showConcepts] por omisión, sí
- * @param {import('react').ReactNode} [props.actions] botones suyos abajo («Cargar la factura»)
- * @param {object} [props.sx]
- * @param {object} [props.texts] los textos que cambian, con la forma de `mexico` en los textos del paquete
- */
-export default function CfdiSummary(props: {
+declare const CfdiSummary: (props: {
     cfdi: import('./cfdiReader.js').Cfdi;
     expectedReceiverRfc?: string;
     showConcepts?: boolean;
     actions?: 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 CfdiSummary;

package/dist/types/mexico/EfirmaFields.d.ts

@@ -1,18 +1,4 @@
-/**
- * @param {object} props
- * @param {{certificateFile: File|null, keyFile: File|null, password: string}} [props.value]
- * @param {(value: {certificateFile: File|null, keyFile: File|null, password: string}) => void} props.onChange el valor completo
- * @param {string} [props.expectedRfc] el RFC que debe traer el certificado (el de la empresa); si es otro, se avisa
- * @param {(certificate: ReturnType<typeof import('./certificateReader.js').readCertificate>|null) => void} [props.onCertificateRead] lo que dice el certificado al elegirlo (null al quitarlo
- *     o si no se pudo leer)
- * @param {(input: {certificateFile: File, keyFile: File, password: string, certificate: ReturnType<typeof import('./certificateReader.js').readCertificate>}) => Promise<void>} [props.onVerifyKey]
- *     la revisión del proyecto (su API); si truena, su mensaje se enseña. Sin él, se abre en el navegador con jsrsasign
- * @param {string} [props.verifyLabel] ya traducido; por omisión «Revisar la e.firma»
- * @param {boolean} [props.disabled]
- * @param {object} [props.sx]
- * @param {object} [props.texts] los textos que cambian, con la forma de `mexico` en los textos del paquete
- */
-export default function EfirmaFields(props: {
+declare const EfirmaFields: (props: {
     value?: {
         certificateFile: File | null;
         keyFile: File | null;
@@ -35,4 +21,8 @@ export default function EfirmaFields(props: {
     disabled?: 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 EfirmaFields;

package/dist/types/mexico/mexicoIdentifiers.d.ts

@@ -59,3 +59,10 @@ export declare function clabeCheckDigitOf(clabe: string): string;
  * @returns {boolean}
  */
 export declare function isValidClabe(clabe: string | null | undefined): boolean;
+/**
+ * ¿El código postal está bien escrito? 5 dígitos (los espacios no cuentan) que no empiezan con 00.
+ *
+ * @param {string|null|undefined} postalCode
+ * @returns {boolean}
+ */
+export declare function isValidPostalCode(postalCode: string | null | undefined): boolean;

package/dist/types/mexico/mexicoRules.d.ts

@@ -1,6 +1,6 @@
 /**
  * @param {{strict?: boolean}} [options] strict: también el dígito verificador (ver isValidRfc)
- * @returns {{name: string, message: {key: string}, test: (value: unknown) => boolean}}
+ * @returns {{name: string, message: {key: string, values: object, rule: string}, test: (value: unknown) => boolean}}
  */
 export declare function rfcRule({ strict }?: {
     strict?: boolean;
@@ -8,22 +8,38 @@ export declare function rfcRule({ strict }?: {
     name: string;
     message: {
         key: string;
+        values: object;
+        rule: string;
     };
     test: (value: unknown) => boolean;
 };
-/** @returns {{name: string, message: {key: string}, test: (value: unknown) => boolean}} */
+/** @returns {{name: string, message: {key: string, values: object, rule: string}, test: (value: unknown) => boolean}} */
 export declare function curpRule(): {
     name: string;
     message: {
         key: string;
+        values: object;
+        rule: string;
     };
     test: (value: unknown) => boolean;
 };
-/** @returns {{name: string, message: {key: string}, test: (value: unknown) => boolean}} */
+/** @returns {{name: string, message: {key: string, values: object, rule: string}, test: (value: unknown) => boolean}} */
 export declare function clabeRule(): {
     name: string;
     message: {
         key: string;
+        values: object;
+        rule: string;
+    };
+    test: (value: unknown) => boolean;
+};
+/** @returns {{name: string, message: {key: string, values: object, rule: string}, test: (value: unknown) => boolean}} */
+export declare function postalCodeRule(): {
+    name: string;
+    message: {
+        key: string;
+        values: object;
+        rule: string;
     };
     test: (value: unknown) => boolean;
 };

package/dist/types/mexico.d.ts

@@ -1,5 +1,5 @@
-export { RFC_KIND, clabeCheckDigitOf, curpCheckDigitOf, isValidClabe, isValidCurp, isValidRfc, rfcCheckDigitOf, rfcKindOf, } from './mexico/mexicoIdentifiers.js';
-export { clabeRule, curpRule, rfcRule } from './mexico/mexicoRules.js';
+export { RFC_KIND, clabeCheckDigitOf, curpCheckDigitOf, isValidClabe, isValidCurp, isValidPostalCode, isValidRfc, rfcCheckDigitOf, rfcKindOf, } from './mexico/mexicoIdentifiers.js';
+export { clabeRule, curpRule, postalCodeRule, rfcRule } from './mexico/mexicoRules.js';
 export { CERTIFICATE_STATUS, certificateStatusOf, readCertificate } from './mexico/certificateReader.js';
 export { CFDI_VOUCHER_TYPE, readCfdi, readCfdiFile } from './mexico/cfdiReader.js';
 export { EFIRMA_KEY_PROBLEM, EfirmaKeyError, verifyEfirmaKey } from './mexico/efirmaKey.js';

package/dist/types/pwa/InstallAppSetting.d.ts

@@ -1,7 +1,7 @@
-/**
- * @param {object} [props]
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function InstallAppSetting({ texts, ...unknownProps }?: {
+declare const InstallAppSetting: (props: {
     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 InstallAppSetting;

package/dist/types/pwa/InstallInstructionsDialog.d.ts

@@ -5,16 +5,13 @@
  * @returns {boolean}
  */
 export declare function variantHasInstructions(variant: string | null): boolean;
-/**
- * @param {object} props
- * @param {string|null} props.variant una de INSTALL_VARIANT (useInstallPrompt)
- * @param {boolean} props.open
- * @param {() => void} props.onClose
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function InstallInstructionsDialog(props: {
+declare const InstallInstructionsDialog: (props: {
     variant: string | null;
     open: boolean;
     onClose: () => void;
     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 InstallInstructionsDialog;

package/dist/types/pwa/InstallPromptBanner.d.ts

@@ -1,16 +1,11 @@
-/**
- * @param {object} [props]
- * @param {string} [props.message] ya traducido; por omisión el del paquete con el nombre de la app (appName de ToolkitProvider)
- * @param {(outcome: 'accepted'|'dismissed'|null) => void} [props.onInstallChoice] lo que contestó la persona al diálogo de
- *     instalar del navegador (Chrome, Edge, Android)
- * @param {() => void} [props.onShowSteps] abrió los pasos para instalar (iPhone, iPad, Firefox de Android)
- * @param {() => void} [props.onDismiss] dijo «Ahora no» (o cerró los pasos): no se le vuelve a ofrecer en este navegador
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function InstallPromptBanner(props?: {
+declare const InstallPromptBanner: (props: {
     message?: string;
     onInstallChoice?: (outcome: 'accepted' | 'dismissed' | null) => void;
     onShowSteps?: () => void;
     onDismiss?: () => void;
     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 InstallPromptBanner;

package/dist/types/react-hook-form.d.ts

@@ -13,6 +13,7 @@ export { default as FormProblemAlert } from './hookForm/FormProblemAlert.js';
 export { default as FormRepeatingFields } from './hookForm/FormRepeatingFields.js';
 export { default as FormTransferListField } from './hookForm/FormTransferListField.js';
 export { listTotalAtMostRule, listTotalOf, orderedInListRule, uniqueInListRule } from './forms/listRules.js';
+export { percentRule, sameAsFieldRule } from './forms/fieldRules.js';
 export { default as FormSelectField } from './hookForm/FormSelectField.js';
 export { default as FormWizard } from './hookForm/FormWizard.js';
 export { default as FormTextField } from './hookForm/FormTextField.js';

package/dist/types/richText/RichTextEditor.d.ts

@@ -1,24 +1,4 @@
-/**
- * @param {object} props
- * @param {string} [props.name]
- * @param {import('react').ReactNode} props.label ya traducida
- * @param {string|null|undefined} props.value el HTML guardado ('' sin texto)
- * @param {(html: string) => void} props.onChange recibe el HTML ('' si se borra todo)
- * @param {() => void} [props.onBlur]
- * @param {string} [props.placeholder] ya traducido: lo que se ve con el editor vacío
- * @param {string|{key: string, values?: object}} [props.error]
- * @param {string} [props.helperText] ya traducida
- * @param {number} [props.maxLength] el tope de caracteres (con su contador abajo)
- * @param {string[]} [props.features] los botones de la barra (RICH_TEXT_FEATURE); por omisión todos
- * @param {Array<object>} [props.extensions] extensiones de Tiptap del proyecto
- * @param {import('react').ReactNode} [props.toolbarActions] botones propios al final de la barra
- * @param {(editor: import('@tiptap/react').Editor) => void} [props.onEditorReady] el editor de Tiptap, al estar listo
- * @param {number} [props.minHeight] el alto mínimo del texto en px; por omisión 160
- * @param {boolean} [props.disabled]
- * @param {object} [props.sx]
- * @param {object} [props.texts] los textos que cambian, con la forma de `richText` en los textos del paquete
- */
-export default function RichTextEditor(props: {
+declare const RichTextEditor: (props: {
     name?: string;
     label: import('react').ReactNode;
     value: string | null | undefined;
@@ -38,5 +18,10 @@ export default function RichTextEditor(props: {
     minHeight?: number;
     disabled?: boolean;
     sx?: object;
+    messages?: Record<string, string | 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 RichTextEditor;

package/dist/types/richText/RichTextView.d.ts

@@ -1,13 +1,10 @@
-/**
- * @param {object} props
- * @param {string|null|undefined} props.value el HTML guardado
- * @param {string[]} [props.features] lo que se deja pasar (por omisión, lo de un editor completo)
- * @param {Array<object>} [props.extensions] las extensiones de Tiptap del proyecto (las mismas que tiene su editor)
- * @param {object} [props.sx]
- */
-export default function RichTextView(props: {
+declare const RichTextView: (props: {
     value: string | null | undefined;
     features?: string[];
     extensions?: Array<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 RichTextView;

package/dist/types/security/ActivityLog.d.ts

@@ -12,14 +12,7 @@ export declare const ACCOUNT_EVENT_KIND: Readonly<{
     recoveryCodeUsed: "recoveryCodeUsed";
     sessionsClosed: "sessionsClosed";
 }>;
-/**
- * @param {object} props
- * @param {Array<{id: string, kind: string, occurredAt: string, device?: string|null, network?: string|null, description?: string}>|null} props.events
- *     del más nuevo al más viejo; null mientras llegan
- * @param {string|null} [props.error] ya traducido si no se pudieron traer
- * @param {object} [props.texts] los textos que cambian, con la forma de `security` en los textos del paquete
- */
-export default function ActivityLog(props: {
+declare const ActivityLog: (props: {
     events: Array<{
         id: string;
         kind: string;
@@ -30,4 +23,8 @@ export default function ActivityLog(props: {
     }> | null;
     error?: string | null;
     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 ActivityLog;

package/dist/types/security/RecoveryCodesDialog.d.ts

@@ -1,16 +1,11 @@
-/**
- * @param {object} props
- * @param {string[]|null} props.codes los códigos recién generados; sin códigos el diálogo está cerrado
- * @param {string} [props.account] la cuenta (normalmente el correo), para el archivo
- * @param {() => void} props.onClose solo se llama después de «Ya los guardé»
- * @param {(method: 'copy'|'download') => void} [props.onCodesSaved] la persona los copió o los descargó (para la bitácora de
- *     seguridad)
- * @param {object} [props.texts] los textos que cambian, con la forma de `security` en los textos del paquete
- */
-export default function RecoveryCodesDialog(props: {
+declare const RecoveryCodesDialog: (props: {
     codes: string[] | null;
     account?: string;
     onClose: () => void;
     onCodesSaved?: (method: 'copy' | 'download') => 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 RecoveryCodesDialog;

package/dist/types/security/SessionsCard.d.ts

@@ -1,13 +1,4 @@
-/**
- * @param {object} props
- * @param {Array<{id: string, browser?: string|null, platform?: string|null, isMobile?: boolean, startedAt: string, network?: string|null, isCurrent?: boolean}>|null} props.sessions
- *     null mientras llegan
- * @param {string|null} [props.error] ya traducido (ApiError.message) si no se pudieron traer
- * @param {() => Promise<number>} props.onCloseOthers cierra las demás; regresa cuántas cerró
- * @param {() => void} [props.onClosed] p. ej. volver a pedir la lista
- * @param {object} [props.texts] los textos que cambian, con la forma de `security` en los textos del paquete
- */
-export default function SessionsCard(props: {
+declare const SessionsCard: (props: {
     sessions: Array<{
         id: string;
         browser?: string | null;
@@ -21,4 +12,8 @@ export default function SessionsCard(props: {
     onCloseOthers: () => Promise<number>;
     onClosed?: () => 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 SessionsCard;

package/dist/types/table.d.ts

@@ -1,3 +1,5 @@
-export { AuditTrailDialog, AuditTrailTable, EmptyState, FILTER_KINDS, FilterChips, GoToPage, SELECTION_PHONE_LAYOUT, ServerTable, ServerTableFilterDrawer, TableFilterContext, buildChipConfig, buildTableActors, detailColumn, facetColumn, isFilterActive, tableMachine, textColumn, toServerTableParams, useDebouncedFilter, useTableFilter, useTableState, } from './DataTable/index.js';
+export { ACTIONS_COLUMN_FIELD, AuditTrailDialog, AuditTrailTable, DETAIL_COLUMN_FIELD, EmptyState, FILTER_KINDS, FilterChips, GoToPage, SELECTION_PHONE_LAYOUT, ServerTable, ServerTableFilterDrawer, StackedCell, TABLE_VIEW, TableCardsView, TableFilterContext, TableViewToggle, actionsColumn, buildChipConfig, buildTableActors, detailColumn, facetColumn, fixedColumnOffsetsOf, fixedFieldsOf, isFilterActive, stackedColumn, statusColumn, statusColumnWidthOf, tableMachine, textColumn, textWidthOf, toServerTableParams, useDebouncedFilter, useTableFilter, useTableState, useTableView, } from './DataTable/index.js';
 export type RowSelection = import('./DataTable/rowSelection.js').RowSelection;
+export type StackedEntry = import('./DataTable/StackedCell.js').StackedEntry;
 /** @typedef {import('./DataTable/rowSelection.js').RowSelection} RowSelection */
+/** @typedef {import('./DataTable/StackedCell.js').StackedEntry} StackedEntry */

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;
+};