@stackcraftmx/calcita 0.32.2 → 0.51.0

package/dist/types/ui/layout/ScrollableRow.d.ts

@@ -10,18 +10,7 @@ export declare const scrollableRow: {
         display: string;
     };
 };
-/**
- * @param {object} props
- * @param {import('react').ReactNode} props.children
- * @param {number} [props.gap]
- * @param {number} [props.py]
- * @param {object} [props.sx]
- * @param {boolean} [props.enableDragScroll]
- * @param {boolean} [props.enableWheelToX]
- * @param {boolean} [props.fadeEdges]
- * @param {import('react').Ref<HTMLElement>} [props.ref]
- */
-export default function ScrollableRow(props: {
+declare const ScrollableRow: (props: {
     children: import('react').ReactNode;
     gap?: number;
     py?: number;
@@ -30,4 +19,8 @@ export default function ScrollableRow(props: {
     enableWheelToX?: boolean;
     fadeEdges?: boolean;
     ref?: import('react').Ref<HTMLElement>;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default ScrollableRow;

package/dist/types/ui/layout/SectionCard.d.ts

@@ -1,11 +1,9 @@
-/**
- * @param {object} props
- * @param {string} props.title texto ya traducido
- * @param {import('react').ReactNode} [props.action] botón o liga a la derecha del título
- * @param {import('react').ReactNode} props.children
- */
-export default function SectionCard(props: {
+declare const SectionCard: (props: {
     title: string;
     action?: import('react').ReactNode;
     children: import('react').ReactNode;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default SectionCard;

package/dist/types/ui/metrics/BarList.d.ts

@@ -1,14 +1,4 @@
-/**
- * @param {object} props
- * @param {Array<{key: string, label: string, value: number, detail?: string, tooltip?: string}>} props.items
- * @param {(item: any) => void} [props.onSelect] recibe el renglón de items que se picó
- * @param {string} props.emptyLabel ya traducido
- * @param {'primary'|'success'|'warning'|'error'|'info'} [props.tone]
- * @param {'chart'|'table'} [props.defaultView] cómo se ve al abrir (CHART_VIEW); por omisión dibujada
- * @param {(view: 'chart'|'table') => void} [props.onViewChange] la persona cambió a la tabla o a la gráfica
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function BarList(props: {
+declare const BarList: (props: {
     items: Array<{
         key: string;
         label: string;
@@ -22,4 +12,8 @@ export default function BarList(props: {
     defaultView?: 'chart' | 'table';
     onViewChange?: (view: 'chart' | 'table') => 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 BarList;

package/dist/types/ui/metrics/CalendarHeatmap.d.ts

@@ -1,21 +1,4 @@
-/**
- * @param {object} props
- * @param {string} [props.startsOn] primer día del rango ("2025-09-16"), fecha de calendario; sin él, un año antes de endsOn
- * @param {string} [props.endsOn] último día del rango ("2026-09-15"); sin él, hoy en la zona del proveedor
- * @param {Array<{date: string, value: number, detail?: string}>} [props.days] solo los días con actividad; el resto vale
- *     0
- * @param {string} props.ariaLabel qué muestra el calendario, ya traducido
- * @param {string} props.valueLabel encabezado de la columna de valor en la tabla ("Registros leídos")
- * @param {(value: number) => string} [props.describeValue] el valor en palabras para el tooltip ("120 registros leídos");
- *     sin ella, solo el número
- * @param {import('react').ReactNode} [props.summary] renglón de resumen arriba del calendario
- * @param {string} [props.emptyLabel] qué decir si ningún día tiene actividad
- * @param {'primary'|'info'|'success'|'warning'|'error'} [props.tone]
- * @param {'chart'|'table'} [props.defaultView] cómo se ve al abrir (CHART_VIEW); por omisión dibujada
- * @param {(view: 'chart'|'table') => void} [props.onViewChange] la persona cambió a la tabla o a la gráfica
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function CalendarHeatmap(props: {
+declare const CalendarHeatmap: (props: {
     startsOn?: string;
     endsOn?: string;
     days?: Array<{
@@ -32,4 +15,8 @@ export default function CalendarHeatmap(props: {
     defaultView?: 'chart' | 'table';
     onViewChange?: (view: 'chart' | 'table') => 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 CalendarHeatmap;

package/dist/types/ui/metrics/ChartTooltip.d.ts

@@ -1,11 +1,11 @@
-/**
- * @param {{active?: boolean, payload?: Array<{payload: any}>, render: (item: any) => import('react').ReactNode}} props
- *     active y payload los pone recharts; render recibe el renglón de data del punto o la columna
- */
-export default function ChartTooltip(props: {
+declare const ChartTooltip: (props: {
     active?: boolean;
     payload?: Array<{
         payload: any;
     }>;
     render: (item: any) => import('react').ReactNode;
-}): 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 ChartTooltip;

package/dist/types/ui/metrics/ColumnChart.d.ts

@@ -1,27 +1,4 @@
-/**
- * @param {object} props
- * @param {Array<Record<string, any>>} props.data un renglón por periodo: {key, label, value, tooltip?} con una serie, o
- *     {key, label, [llave de cada serie]: número} con varias
- * @param {string} props.periodLabel encabezado de la primera columna de la tabla («Mes»), ya traducido
- * @param {string} [props.valueLabel] cómo se llama lo que se cuenta, ya traducido (una serie)
- * @param {Array<{key: string, label: string, tone?: 'primary'|'secondary'|'success'|'warning'|'error'|'info'}>} [props.series]
- *     varias series agrupadas: la llave de cada una en data, su nombre ya traducido y su color (por omisión, en orden)
- * @param {string} props.ariaLabel
- * @param {string} props.emptyLabel
- * @param {number} [props.height]
- * @param {'primary'|'success'|'warning'|'error'|'info'} [props.tone] el color de una sola serie
- * @param {(item: any, seriesKey: string) => void} [props.onSelect] recibe el renglón de data que se picó y la serie
- * @param {(value: number) => string} [props.formatValue] cómo se escribe un valor (en el eje, en la tabla y en el
- *     tooltip)
- * @param {{value: number, label: string}} [props.referenceLine] línea de referencia con su rótulo ya traducido («Meta:
- *     10 %»)
- * @param {(row: any) => import('react').ReactNode} [props.renderTooltip] lo que dice el globo de un periodo; por omisión su
- *     nombre y el valor de cada serie
- * @param {'chart'|'table'} [props.defaultView] cómo se ve al abrir (CHART_VIEW); por omisión dibujada
- * @param {(view: 'chart'|'table') => void} [props.onViewChange] la persona cambió a la tabla o a la gráfica
- * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {charts: {viewAsTable, viewAsChart, legend}}
- */
-export default function ColumnChart(props: {
+declare const ColumnChart: (props: {
     data: Array<Record<string, any>>;
     periodLabel: string;
     valueLabel?: string;
@@ -44,4 +21,8 @@ export default function ColumnChart(props: {
     defaultView?: 'chart' | 'table';
     onViewChange?: (view: 'chart' | 'table') => 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 ColumnChart;

package/dist/types/ui/metrics/LineChart.d.ts

@@ -1,22 +1,4 @@
-/**
- * @param {object} props
- * @param {Array<Record<string, any>>} props.data un renglón por periodo: {key, label, [llave de cada serie]: número}
- * @param {Array<{key: string, label: string, tone?: 'primary'|'secondary'|'success'|'warning'|'error'|'info', dash?: string}>} props.series
- *     la llave de cada serie en data, su nombre ya traducido, su color y su trazo (por omisión, en orden)
- * @param {string} props.periodLabel encabezado de la primera columna de la tabla («Mes»), ya traducido
- * @param {string} props.ariaLabel
- * @param {string} props.emptyLabel
- * @param {number} [props.height]
- * @param {(value: number) => string} [props.formatValue] cómo se escribe un valor (en el eje, en la tabla y en el globo)
- * @param {{value: number, label: string}} [props.referenceLine] línea de referencia (la meta) con su rótulo ya traducido
- * @param {(row: any) => void} [props.onSelect] recibe el renglón de data del periodo que se picó
- * @param {(row: any) => import('react').ReactNode} [props.renderTooltip] lo que dice el globo de un periodo; por omisión su
- *     nombre y el valor de cada serie
- * @param {'chart'|'table'} [props.defaultView] cómo se ve al abrir (CHART_VIEW); por omisión dibujada
- * @param {(view: 'chart'|'table') => void} [props.onViewChange] la persona cambió a la tabla o a la gráfica
- * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {charts: {viewAsTable, viewAsChart, legend}}
- */
-export default function LineChart(props: {
+declare const LineChart: (props: {
     data: Array<Record<string, any>>;
     series: Array<{
         key: string;
@@ -38,4 +20,8 @@ export default function LineChart(props: {
     defaultView?: 'chart' | 'table';
     onViewChange?: (view: 'chart' | 'table') => 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 LineChart;

package/dist/types/ui/metrics/MetricCard.d.ts

@@ -4,22 +4,7 @@ export declare const TREND_DIRECTION: Readonly<{
     down: "down";
     flat: "flat";
 }>;
-/**
- * @param {object} props
- * @param {string} props.label texto ya traducido
- * @param {import('react').ReactNode} props.value ya formateado (formatNumber)
- * @param {import('react').ReactNode} [props.caption]
- * @param {'info'|'success'|'warning'|'error'} [props.tone]
- * @param {string} [props.valueColor] color del número si no debe ir del tono (p. ej. un total en texto normal)
- * @param {boolean} [props.isLoading]
- * @param {string} [props.to] ruta interna a la que lleva la tarjeta
- * @param {{label: string, direction: 'up'|'down'|'flat', isGood?: boolean}} [props.trend] cuánto cambió (TREND_DIRECTION)
- * @param {import('react').ReactNode} [props.icon] junto al título, del color del tono (<ShoppingBagOutlinedIcon />)
- * @param {import('react').ReactNode} [props.children] contenido propio debajo de la nota (una barra de avance, un desglose)
- * @param {() => void} [props.onClick] la tarjeta entera como botón, cuando no lleva a otra pantalla (to)
- * @param {object} [props.texts] los textos que cambian, con la forma de `metricCard`: {trend: {up: 'subió'}}
- */
-export default function MetricCard(props: {
+declare const MetricCard: (props: {
     label: string;
     value: import('react').ReactNode;
     caption?: import('react').ReactNode;
@@ -36,4 +21,8 @@ export default function MetricCard(props: {
     children?: import('react').ReactNode;
     onClick?: () => 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 MetricCard;

package/dist/types/ui/metrics/TableToggle.d.ts

@@ -3,12 +3,12 @@ export declare const CHART_VIEW: Readonly<{
     chart: "chart";
     table: "table";
 }>;
-/**
- * @param {{asTable: boolean, onToggle: () => void, texts?: object}} props texts: los textos que cambian, con la forma de
- *     `common` ({charts: {viewAsTable, viewAsChart}})
- */
-export default function TableToggle(props: {
+declare const TableToggle: (props: {
     asTable: boolean;
     onToggle: () => 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 TableToggle;

package/dist/types/ui/metrics/chartParts.d.ts

@@ -60,17 +60,7 @@ export declare function highestValueOf(data: Array<Record<string, any>>, series:
 }>, referenceLine: {
     value: number;
 } | undefined): number;
-/**
- * La vista de tabla: un renglón por periodo y una columna por serie.
- *
- * @param {object} props
- * @param {Array<Record<string, any>>} props.data
- * @param {Array<{key: string, label: string}>} props.series
- * @param {string} props.periodLabel
- * @param {(value: number) => string} props.formatValue
- * @param {number} props.height
- */
-export declare function ChartTable({ data, series, periodLabel, formatValue, height, ...unknownProps }: {
+export declare const ChartTable: (props: {
     data: Array<Record<string, any>>;
     series: Array<{
         key: string;
@@ -79,16 +69,11 @@ export declare function ChartTable({ data, series, periodLabel, formatValue, hei
     periodLabel: string;
     formatValue: (value: number) => string;
     height: number;
-}): import("react").JSX.Element;
-/**
- * La leyenda: solo con dos series o más. Cada una con su muestra (su color y, en líneas, su trazo).
- *
- * @param {object} props
- * @param {Array<{key: string, label: string, color: string, dash: string}>} props.series ya resueltas
- * @param {boolean} [props.showsDash] la muestra con el trazo de su línea (LineChart); sin él, un cuadro de color
- * @param {string} props.ariaLabel
- */
-export declare function ChartLegend({ series, showsDash, ariaLabel, ...unknownProps }: {
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export declare const ChartLegend: (props: {
     series: Array<{
         key: string;
         label: string;
@@ -97,16 +82,16 @@ export declare function ChartLegend({ series, showsDash, ariaLabel, ...unknownPr
     }>;
     showsDash?: boolean;
     ariaLabel: string;
-}): import("react").JSX.Element | null;
-/**
- * El rótulo de la línea de referencia (la meta), debajo de la gráfica: sobre la línea se encimaba con la última columna, y
- * así también lo lee quien ve la tabla.
- *
- * @param {{referenceLine?: {value: number, label: string}}} props
- */
-export declare function ReferenceCaption({ referenceLine, ...unknownProps }: {
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element | null;
+export declare const ReferenceCaption: (props: {
     referenceLine?: {
         value: number;
         label: string;
     };
-}): import("react").JSX.Element | null;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element | null;

package/dist/types/ui/navigation/BackButton.d.ts

@@ -1,13 +1,10 @@
-/**
- * @param {object} props
- * @param {string} props.fallbackTo ruta de la lista sin filtros (último respaldo)
- * @param {string} [props.listKey] la misma llave que usa useRememberListUrl en la lista
- * @param {string} [props.label] ya traducido; se usa cuando la página anterior no anotó su nombre o no hay historial
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function BackButton({ fallbackTo, listKey, label, texts, ...buttonProps }: {
+declare const BackButton: (props: {
     fallbackTo: string;
     listKey?: string;
     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 BackButton;

package/dist/types/ui/navigation/ColorSchemeToggle.d.ts

@@ -1,13 +1,10 @@
-/**
- * @param {object} [props]
- * @param {'small'|'medium'} [props.size]
- * @param {boolean} [props.inverted] ícono blanco para fondos oscuros
- * @param {(mode: 'light'|'dark'|'system') => void} [props.onChange] la persona cambió el modo (para guardarlo en su servidor)
- * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
- */
-export default function ColorSchemeToggle(props?: {
+declare const ColorSchemeToggle: (props: {
     size?: 'small' | 'medium';
     inverted?: boolean;
     onChange?: (mode: 'light' | 'dark' | 'system') => 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 ColorSchemeToggle;

package/dist/types/ui/navigation/FontSizeToggle.d.ts

@@ -1,11 +1,9 @@
-/**
- * @param {object} [props]
- * @param {'small'|'medium'} [props.size]
- * @param {(level: string) => void} [props.onChange] la persona eligió otro tamaño (FONT_SIZE_LEVELS; para guardarlo en su servidor)
- * @param {object} [props.texts] los textos que cambian, con la forma de `layout` en los textos del paquete
- */
-export default function FontSizeToggle(props?: {
+declare const FontSizeToggle: (props: {
     size?: 'small' | 'medium';
     onChange?: (level: string) => 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 FontSizeToggle;

package/dist/types/ui/navigation/LanguageToggle.d.ts

@@ -1,13 +1,11 @@
 /** Los idiomas que traen los textos del paquete. */
 export declare const LANGUAGES: readonly ("en" | "es")[];
-/**
- * @param {object} [props]
- * @param {boolean} [props.inverted] texto blanco para fondos oscuros
- * @param {(language: string) => void} [props.onChange] además de avisar a ToolkitProvider, cada que se elige un idioma
- * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {language: {switchToNamed, choose}}
- */
-export default function LanguageToggle(props?: {
+declare const LanguageToggle: (props: {
     inverted?: boolean;
     onChange?: (language: string) => 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 LanguageToggle;

package/dist/types/ui/navigation/PageBreadcrumbs.d.ts

@@ -1,12 +1,11 @@
-/**
- * @param {object} props
- * @param {Array<{label: string, to?: string}>} props.items textos ya traducidos
- * @param {object} [props.texts] los textos que cambian, con la forma de `layout` en los textos del paquete
- */
-export default function PageBreadcrumbs(props: {
+declare const PageBreadcrumbs: (props: {
     items: Array<{
         label: string;
         to?: string;
     }>;
     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 PageBreadcrumbs;

package/dist/types/ui/navigation/RouteTabs.d.ts

@@ -0,0 +1,39 @@
+/** Dónde vive la pestaña: en la ruta o en la consulta. */
+export declare const ROUTE_TABS_MODE: Readonly<{
+    path: "path";
+    query: "query";
+}>;
+/**
+ * La pestaña activa, para que la pantalla pinte lo suyo (sobre todo con mode query: la pantalla es una sola).
+ *
+ * @param {object[]} tabs las mismas de RouteTabs
+ * @param {{mode?: string, paramName?: string}} [options]
+ * @returns {string|null} el `to` (por ruta) o el `value` (por consulta) de la activa
+ */
+export declare function useActiveRouteTab(tabs: object[], { mode, paramName }?: {
+    mode?: string;
+    paramName?: string;
+}): string | null;
+declare const RouteTabs: (props: {
+    tabs: Array<{
+        to?: string;
+        value?: string;
+        label: import('react').ReactNode;
+        icon?: import('react').ReactElement;
+        badge?: import('react').ReactNode;
+        access?: object;
+        exact?: boolean;
+        disabled?: boolean;
+        hidden?: boolean;
+    }>;
+    ariaLabel: string;
+    mode?: 'path' | 'query';
+    paramName?: string;
+    replace?: boolean;
+    onChange?: (tab: object) => void;
+    sx?: object;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default RouteTabs;

package/dist/types/ui/navigation/routeTabMatching.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @param {Array<{to: string, exact?: boolean}>} tabs
+ * @param {string} pathname
+ * @returns {string|null} el `to` de la pestaña activa
+ */
+export declare function activeRouteTabOf(tabs: Array<{
+    to: string;
+    exact?: boolean;
+}>, pathname: string): string | null;
+/**
+ * @param {Array<{value: string}>} tabs
+ * @param {string} search la consulta de la dirección ('?tab=pagos&page=2')
+ * @param {string} paramName 'tab'
+ * @returns {string|null} la pestaña de la consulta si existe; si no, la primera
+ */
+export declare function queryTabOf(tabs: Array<{
+    value: string;
+}>, search: string, paramName: string): string | null;
+/**
+ * La consulta con otra pestaña, sin perder lo demás que traía (?page=2 se queda).
+ *
+ * @param {string} search
+ * @param {string} paramName
+ * @param {string} value
+ * @returns {string} '?tab=pagos&page=2'
+ */
+export declare function searchWithTab(search: string, paramName: string, value: string): string;

package/dist/types/ui/timeline/GroupedTimeline.d.ts

@@ -1,25 +1,4 @@
-/**
- * @param {object} props
- * @param {Object[]} props.groups
- * @param {string} props.groups[].key
- * @param {string} [props.groups[].title] texto ya traducido; sin título el grupo no pinta encabezado
- * @param {string} [props.groups[].badge] insignia junto al título (p. ej. «Intento actual»)
- * @param {string} [props.groups[].summary] lo que se lee junto al título del grupo plegado (p. ej. «6 eventos»)
- * @param {boolean} [props.groups[].isCollapsible] el título se vuelve un botón que abre y cierra el grupo (necesita
- *     title)
- * @param {boolean} [props.groups[].defaultExpanded] si un grupo plegable arranca abierto (por omisión, sí)
- * @param {'highlighted'|'normal'|'muted'} [props.groups[].emphasis]
- * @param {Object[]} props.groups[].items
- * @param {string} props.groups[].items[].key
- * @param {import('react').ElementType} [props.groups[].items[].icon] ícono dentro del punto
- * @param {string} [props.groups[].items[].tone] success, warning, error, info, primary o grey
- * @param {import('react').ReactNode} props.groups[].items[].title
- * @param {string} [props.groups[].items[].timestamp] fecha y hora ya formateadas
- * @param {import('react').ReactNode} [props.groups[].items[].details] lo que va abajo del título (chip de resultado, una liga...)
- * @param {(groupKey: string, isExpanded: boolean) => void} [props.onGroupToggle] la persona abrió o plegó un grupo (por ejemplo,
- *     para pedir sus eventos hasta que se abre)
- */
-export default function GroupedTimeline(props: {
+declare const GroupedTimeline: (props: {
     groups: {
         key: string;
         title?: string;
@@ -38,4 +17,8 @@ export default function GroupedTimeline(props: {
         }[];
     }[];
     onGroupToggle?: (groupKey: string, isExpanded: boolean) => void;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default GroupedTimeline;

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

@@ -0,0 +1,72 @@
+/**
+ * La lista conserva el tipo que usa la pantalla para lo ya guardado (T): onChange regresa esos mismos y los File nuevos.
+ *
+ * @template {File|{id?: string, name: string, size?: number}} T
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {import('react').ReactNode} [props.label] ya traducida; sin ella, va sin etiqueta (dentro de un correo, por ejemplo)
+ * @param {T[]} [props.value] los nuevos y los que ya están guardados
+ * @param {(files: Array<T|File>) => void} props.onChange la lista completa
+ * @param {() => void} [props.onBlur] se llama al agregar o quitar (para que el formulario lo marque como tocado)
+ * @param {(file: T) => void} [props.onRemove] al quitar uno (antes de onChange)
+ * @param {string|string[]} [props.accept] 'excel' | ['pdf', 'image'] | '.xlsx,.xls' | 'image/*'
+ * @param {number|string} [props.maxSize] el peso máximo de cada archivo: bytes o '10 MB'
+ * @param {number} [props.maxFiles] cuántos como máximo
+ * @param {number|string} [props.maxTotalSize] cuánto pueden pesar todos juntos
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText] ya traducida
+ * @param {string} [props.buttonLabel] ya traducido; por omisión «Adjuntar»
+ * @param {boolean} [props.showButton] false esconde «Adjuntar» (la ventana se abre con pickerRef desde un botón suyo)
+ * @param {import('react').Ref<{open: () => void}>} [props.pickerRef] recibe {open} para abrir la ventana de archivos
+ * @param {boolean} [props.disabled]
+ * @param {boolean} [props.busy] candado mientras se sube: no se puede agregar ni quitar
+ * @param {(file: File, reason: string) => void} [props.onReject] reason es uno de FILE_REJECTION; sin él, un aviso
+ * @param {Parameters<typeof import('./TemplateDownloadButton.js').default>[0]} [props.template] «Descargar la
+ *     plantilla» junto a «Adjuntar»
+ * @param {import('react').ReactNode} [props.actions] botones suyos junto a «Adjuntar»
+ * @param {object} [props.sx]
+ * @param {Record<string, string|object>} [props.messages] el texto del error de este campo, por regla de validación
+ *     ({required: 'Escriba el RFC', matches: 'El RFC lleva 12 o 13 caracteres'}): gana al de Calcita y al de los textos
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ * @param {Record<string, import('react').ElementType>} [props.slots] otro componente en lugar de una parte (root, actions, list…)
+ * @param {Record<string, object>} [props.slotProps] props de más para una parte
+ */
+declare function AttachmentsInputContent<T extends File | {
+    id?: string;
+    name: string;
+    size?: number;
+}>(props: {
+    name?: string;
+    label?: import('react').ReactNode;
+    value?: T[];
+    onChange: (files: Array<T | File>) => void;
+    onBlur?: () => void;
+    onRemove?: (file: T) => void;
+    accept?: string | string[];
+    maxSize?: number | string;
+    maxFiles?: number;
+    maxTotalSize?: number | string;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    buttonLabel?: string;
+    showButton?: boolean;
+    pickerRef?: import('react').Ref<{
+        open: () => void;
+    }>;
+    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>;
+}): import("react").JSX.Element;
+/** @type {typeof AttachmentsInputContent} */
+declare const AttachmentsInput: typeof AttachmentsInputContent;
+export default AttachmentsInput;

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

@@ -0,0 +1,18 @@
+/**
+ * @param {object} props
+ * @param {{name: string, size?: number}} props.file
+ * @param {(() => void)|undefined} [props.onRemove] sin él no hay × (con el candado puesto, por ejemplo)
+ * @param {string} props.removeLabel ya traducido: «Quitar contrato.pdf»
+ * @param {import('react').ElementType} [props.ChipComponent] la parte del tema del cargador (por omisión, el Chip de MUI)
+ * @param {object} [props.ownSx] el estilo de la casa, debajo del tema del proyecto
+ */
+export default function FileChip({ file, onRemove, removeLabel, ChipComponent, ownSx }: {
+    file: {
+        name: string;
+        size?: number;
+    };
+    onRemove?: (() => void) | undefined;
+    removeLabel: string;
+    ChipComponent?: import('react').ElementType;
+    ownSx?: object;
+}): import("react").JSX.Element;