@acvl/frontend-components 0.0.85 → 0.0.87

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 import * as _mui_material from '@mui/material';
 import { ButtonProps, ButtonGroupProps, IconButtonProps, MenuItemProps, BoxProps, AutocompleteProps, SliderProps, SwitchProps, GridProps, DrawerProps, SxProps, Theme, StackProps, TypographyProps, MenuProps, PaletteColorOptions, TextFieldProps as TextFieldProps$1, InputBaseProps, DialogProps, DialogContentProps } from '@mui/material';
 import * as React$1 from 'react';
-import React__default, { ReactNode, Dispatch, SetStateAction, JSX, RefObject, ReactElement, ComponentType, FC, BaseSyntheticEvent, JSXElementConstructor, ElementType } from 'react';
+import React__default, { ReactNode, Dispatch, SetStateAction, JSX, RefObject, FC, ReactElement, ComponentType, BaseSyntheticEvent, JSXElementConstructor, ElementType } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { GridRowId, GridRowSelectionModel, GridSortModel, GridFilterModel, GridRowModesModel, GridRenderEditCellParams, GridToolbarProps, DataGridProps as DataGridProps$1, GridApi, GridPaginationModel, GridColumnVisibilityModel, useGridApiRef, GridColDef } from '@mui/x-data-grid';
 import { DataGridProps, GridBaseColDef } from '@mui/x-data-grid/internals';
 import { NavigateOptions } from 'react-router-dom';
 import * as zod_v4_core from 'zod/v4/core';
 import * as zod from 'zod';
-import { coerce, z } from 'zod';
+import { coerce, ZodType, z } from 'zod';
 import { NumericFormatProps } from 'react-number-format';
 import { TextFieldProps } from '@mui/material/TextField';
 import dayjs from 'dayjs';
@@ -18,8 +18,10 @@ import * as _reduxjs_toolkit from '@reduxjs/toolkit';
 import * as _emotion_styled from '@emotion/styled';
 import * as _mui_system from '@mui/system';
 import { Theme as Theme$1, CssVarsTheme, CSSObject } from '@mui/material/styles';
-import { DebouncedFunc } from 'lodash';
+import { BaseQueryFn, FetchArgs, EndpointDefinitions, Api, CoreModule } from '@reduxjs/toolkit/query';
+import { reactHooksModuleName } from '@reduxjs/toolkit/query/react';
 import { UseFormReturn } from 'react-hook-form';
+import { DebouncedFunc } from 'lodash';
 import { Breadcrumb, PageHeaderProps, Navigation, Branding, Session, Authentication, DashboardHeaderProps } from '@toolpad/core';
 import { SidebarFooterProps } from '@toolpad/core/DashboardLayout';
 
@@ -1887,115 +1889,532 @@ declare const COLOR_SCHEME_SELECTOR = "data-color-scheme";
 type AppTheme = Theme$1 & CssVarsTheme;
 declare const theme: () => AppTheme;
 
-interface KpiCardProps {
-    icon: ReactNode;
-    label: string;
-    value: ReactNode;
-    caption?: string;
-    color?: string;
-    /** Variante tipográfica del valor. Por defecto `h4`; usa `h5` cuando el valor es
-     *  largo o hay muchas tarjetas por fila. */
-    valueVariant?: TypographyProps["variant"];
-    isLoading: boolean;
+/**
+ * Datos que recibe el renderizado de detalle de un input. Es un subconjunto de
+ * `FieldProps` (los campos que necesita la vista de solo lectura), más un
+ * `content` opcional con el valor ya formateado y envuelto con pre/post por el
+ * contenedor `DetailField` (útil para renderizadores completos como archivos).
+ */
+interface DetailRenderProps {
+    fieldData?: any;
+    /** Registro completo de la página; permite leer valores hermanos. */
+    data?: any;
+    name?: string;
+    detail_name?: string;
+    extraProps?: any;
+    /** Valor formateado + pre/post, disponible para `Detail`. */
+    content?: string;
 }
-/** Tarjeta de KPI: ícono + etiqueta, un valor destacado y una leyenda opcional.
- *  Muestra un esqueleto mientras se cargan los datos. */
-declare function KpiCard({ icon, label, value, caption, color, valueVariant, isLoading, }: KpiCardProps): react_jsx_runtime.JSX.Element;
-
-interface PanelProps {
-    /** Ícono a la izquierda del título (típicamente `color="action" fontSize="small"`). */
-    icon?: ReactNode;
-    /** Título del encabezado. Si se omite (y no hay ícono ni acción), no se renderiza encabezado. */
-    title?: ReactNode;
-    /** Contenido alineado a la derecha del encabezado (chips, botones, etc.). */
-    action?: ReactNode;
-    /** Región entre el encabezado y el divisor, p. ej. un `<Tabs>`. */
-    tabs?: ReactNode;
-    /** Muestra un divisor bajo el encabezado/tabs. Por defecto `true`. */
-    divider?: boolean;
-    /** Altura del contenedor. Con un número (px) el contenido ocupa el espacio
-     *  restante y hace scroll; con `"100%"` solo iguala la altura de la columna. */
-    height?: number | string;
-    /** Estilos adicionales para el `Paper`. */
-    sx?: SxProps<Theme>;
-    children?: ReactNode;
+/**
+ * Contrato de un input controlado de v2. Además de renderizar su modo de
+ * edición (el propio componente), puede aportar su propia lógica de detalle:
+ *
+ * - `formatDetail`: convierte el valor en contenido mostrable (string o nodo).
+ *   Cubre la mayoría de los casos; el contenedor se encarga de envolverlo con
+ *   enlaces de navegación y pre/post.
+ * - `Detail`: renderizado de detalle completo (badges, popovers…). Poco común;
+ *   solo para inputs que necesitan controlar toda su UI de solo lectura.
+ */
+interface ControlledInput<P = any> extends FC<P> {
+    formatDetail?: (props: DetailRenderProps) => ReactNode;
+    Detail?: (props: DetailRenderProps) => ReactNode;
 }
-/** Contenedor estándar de panel: `Paper` con encabezado (ícono + título + acción),
- *  divisor opcional y contenido. Unifica el aspecto de los paneles del dashboard. */
-declare function Panel({ icon, title, action, tabs, divider, height, sx, children }: PanelProps): react_jsx_runtime.JSX.Element;
 
-interface PollingCountdownChipProps {
-    pollingInterval: number;
-    isFetching: boolean;
-    onRefresh?: () => void;
+/**
+ * Forma JSON que se guarda en el formulario / se envía al backend.
+ * Para direcciones escritas a mano solo viene `formatted_address`.
+ */
+interface AddressValue {
+    formatted_address: string;
+    place_id?: string | null;
+    lat?: number | null;
+    lng?: number | null;
+    street_number?: string;
+    route?: string | null;
+    neighborhood?: string | null;
+    locality?: string | null;
+    administrative_area_level_1?: string | null;
+    postal_code?: string | null;
+    country?: string | null;
+    country_code?: string | null;
 }
-/** Chip con cuenta regresiva hasta el próximo refresco de un polling. Al terminar cada
- *  fetch reinicia el conteo; opcionalmente refresca al hacer clic. */
-declare function PollingCountdownChip({ pollingInterval, isFetching, onRefresh, }: PollingCountdownChipProps): react_jsx_runtime.JSX.Element;
+interface ControlledAddressAutocompleteProps {
+    name: string;
+    label?: string;
+    control: any;
+    fieldProps?: TextFieldProps$1;
+    extraProps?: {
+        /**
+         * API key de Google Maps. Si no se pasa, se intenta leer
+         * `VITE_GOOGLE_MAPS_API_KEY` de `import.meta.env`.
+         */
+        apiKey?: string;
+        /** Restringe los resultados a estos países, p.ej. ["mx", "us"]. */
+        countries?: string[];
+        /** Idioma de los resultados, p.ej. "es". */
+        language?: string;
+        /**
+         * Callback opcional con el `Place` resuelto (con addressComponents,
+         * location, etc.) por si la pantalla necesita autollenar otros campos.
+         */
+        onResolved?: (place: any) => void;
+    };
+}
+declare const ControlledAddressAutocomplete: {
+    ({ name, label, control, fieldProps, extraProps, }: ControlledAddressAutocompleteProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+    formatDetail({ fieldData }: DetailRenderProps): string;
+};
 
-interface FilterInput {
-    /** The column this input filters on — used only as a React key. */
-    field: string;
-    /**
-     * The query keys this input writes. Usually one, but a range input owns two
-     * (`_min`/`_max`, `_after`/`_before`), which is why this isn't just `field`.
-     */
-    keys: string[];
+/** Opción de un desplegable: `{ value, label }`. */
+interface Opciones {
+    value: string;
     label: string;
-    type: string;
-    element: ReactElement;
+}
+interface ControlledAmountWithCurrencyProps {
+    /** Ruta del monto en el formulario, p.ej. "valores_de_factura.subtotal". */
+    name: string;
+    /** Control de react-hook-form (lo inyecta el `EditField` de la página). */
+    control?: any;
+    fieldProps?: Partial<NumericFormatProps<InputBaseProps>>;
+    extraProps?: {
+        /**
+         * Ruta de la moneda en el formulario. Por defecto `${name}_moneda`,
+         * de modo que "valores_de_factura.subtotal" usa
+         * "valores_de_factura.subtotal_moneda".
+         */
+        currencyName?: string;
+        /** Origen de las opciones de moneda (endpoint `como_opciones`). */
+        queryArgs?: ComoOpcionesProps;
+        /** Opciones estáticas de moneda (alternativa a `queryArgs`). */
+        options?: Opciones[];
+    };
 }
 /**
- * A filter the page adds itself, for something no column represents — a scope toggle, a flag
- * the backend computes, anything whose value isn't a column's value.
+ * Campo compuesto de monto + moneda que se muestra como una sola fila con
+ * borde: importe alineado a la derecha y un selector de moneda compacto al
+ * final.
  *
- * The element is read fresh on every render rather than captured with the schema, so an input
- * that closes over page state stays current.
+ * Está pensado para usarse como `type` de un campo de una página de detalle.
+ * La etiqueta la aporta el `Field` contenedor (no el propio campo):
+ *
+ * ```ts
+ * {
+ *     name: "valores_de_factura.subtotal",
+ *     label: "Subtotal",
+ *     type: ControlledAmountWithCurrency,
+ *     gridProps: { size: 12 },
+ * }
+ * ```
  */
-interface CustomFilterDef {
-    /**
-     * The query key sent to the backend, and the form field name the element must bind to.
-     *
-     * Wins over a column that would generate the same key: the column's input is dropped from
-     * the panel, so one key never gets two inputs writing to it.
-     */
-    field: string;
-    label: string;
-    /** Any controlled input. The panel clones `control` in, exactly as it does for columns. */
-    element: ReactElement;
-    /** Defaults to `z.any().optional()` — enough for a value the backend validates anyway. */
-    schema?: z.ZodType<any, any>;
-    /** What the panel resets to, and what "Limpiar" restores. Defaults to `""`. */
-    defaultValue?: any;
-}
+declare const ControlledAmountWithCurrency: {
+    ({ name, control, fieldProps, extraProps, }: ControlledAmountWithCurrencyProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+    formatDetail({ fieldData, extraProps, data, name, }: DetailRenderProps): string;
+};
 
 /**
- * Where the filter panel renders. `"drawer"` (the default) docks it to the right of the rows;
- * `"popper"` floats it off the toolbar button, the way it used to.
+ * Helpers puros del `ControlledAutocomplete`: los argumentos de la consulta, la
+ * lista que se muestra y las cuentas del "seleccionar todo". Viven fuera del
+ * componente para poder probarlos sin montar MUI ni RTK Query.
  */
-type FiltersVariant = "drawer" | "popper";
+
+/** Una opción del desplegable, tal como la devuelve `como_opciones`. */
+interface AutocompleteOption {
+    value: any;
+    label: string;
+}
 
 /**
- * What the grid hands its RTK lazy query — the corrected `GridArgs`.
+ * Props que el consumidor escribe en `fieldProps` pensando en "el campo" pero que
+ * son del `TextField` que dibuja `renderInput`, no del `Autocomplete`.
  *
- * v1 typed `filterModel` as MUI's `GridFilterModel` (`items: GridFilterItem[]`), a shape the
- * grid has never sent; it actually sends `MyGridFilterModel`, whose `items` is a plain
- * key/value bag. Endpoints typed against the v1 type were describing something that never
- * arrived. The index signature is real too: `api.data.args` may add arbitrary keys (several
- * endpoints read an `endpoint` or `tipo` off it).
+ * MUI sólo reenvía a `renderInput` `id`, `disabled`, `size`, `fullWidth` e
+ * `InputProps`; lo demás se quedaba en el nodo raíz del `Autocomplete` —sin
+ * efecto y sin aviso—, así que un `fieldProps: { helperText: "…" }` no se veía
+ * por ningún lado. Se reparten antes del spread para que lleguen a su sitio.
  */
-interface ServerGridArgs {
-    page?: number;
-    pageSize?: number;
-    sortModel: GridSortModel;
-    filterModel: MyGridFilterModel;
-    ignoreSort?: boolean;
-    [key: string]: any;
+declare const TEXT_FIELD_KEYS: readonly ["helperText", "placeholder", "required", "margin"];
+type TextFieldOnlyProps = Pick<TextFieldProps$1, (typeof TEXT_FIELD_KEYS)[number]>;
+type AutocompleteFieldProps = Partial<AutocompleteProps<any, any, any, any>> & TextFieldOnlyProps;
+interface ControlledAutocompleteProps {
+    name: string;
+    label?: string;
+    /** Control de react-hook-form; lo inyecta el `EditField` o el panel de filtros. */
+    control?: any;
+    /**
+     * Props del campo (ganan sobre las de aquí). Las del `Autocomplete` van tal
+     * cual; las que son del `TextField` (`helperText`, `placeholder`, `required`,
+     * `margin`) se enrutan solas al input, que es donde se ven.
+     */
+    fieldProps?: AutocompleteFieldProps;
+    extraProps?: {
+        /** Selección múltiple con casillas y chips. Por defecto, simple. */
+        multiple?: boolean;
+        /** Opciones fijas. Con ellas no se consulta nada y filtra el navegador. */
+        options?: AutocompleteOption[];
+        /** Origen remoto de las opciones (endpoint `como_opciones`). */
+        queryArgs?: ComoOpcionesProps;
+        /** Filtro contra el que se busca el texto. Por defecto `nombre__icontains`. */
+        searchField?: string;
+        /** Retardo del tecleo antes de consultar. Por defecto 400 ms. */
+        debounceMs?: number;
+        /** Caracteres mínimos para consultar. Por defecto 0 (lista completa al abrir). */
+        minChars?: number;
+        /** Fila de "seleccionar todo" en el modo múltiple. Por defecto, sí. */
+        selectAll?: boolean;
+        /**
+         * Quita el hueco reservado para el mensaje de error debajo del campo. No
+         * afecta al `helperText` de `fieldProps`: si hay texto de ayuda, se ve.
+         */
+        disableHT?: boolean;
+    };
 }
-interface ServerGridDataApi {
-    /** RTK Query lazy hook, e.g. `useLazyGetConceptosQuery`. */
-    query: any;
-    /** Extra query args, deep-merged over the grid's own. Deep-compared, so literals are safe. */
+/**
+ * Desplegable de opciones para react-hook-form: simple o múltiple, con opciones
+ * fijas o consultadas a `como_opciones` según lo que se escribe. Unifica los
+ * `ControlledDropdown` (simple) y `ControlledSelect` (múltiple) de v1, que eran
+ * el mismo componente duplicado.
+ *
+ * ```ts
+ * {
+ *     name: "cliente",
+ *     label: "Cliente",
+ *     type: ControlledAutocomplete,
+ *     extraProps: { queryArgs: { endpoint: "clientes" } },
+ * }
+ * ```
+ *
+ * Sobre las peticiones, que era el punto flojo de v1:
+ *
+ * - **Una por apertura.** v1 pedía dos veces al abrir (el `onOpen` disparaba la
+ *   consulta y el efecto la repetía con retardo) y otra vez en cada render del
+ *   padre, porque `queryArgs` llega como objeto literal y su identidad cambiaba.
+ * - **Elegir una opción no consulta.** Al elegir, MUI reescribe el texto del
+ *   campo con la etiqueta; v1 lo trataba como búsqueda nueva y volvía a pedir.
+ * - **Sin parpadeo ni respuestas cruzadas.** La lista es la del hook de RTK
+ *   Query, que siempre corresponde a los últimos argumentos disparados; v1
+ *   guardaba las opciones en estado propio, las vaciaba en cada tecla y una
+ *   respuesta lenta podía pisar a una más nueva.
+ * - **Repetir una búsqueda sale de la caché**, incluido borrar el texto para
+ *   volver al listado completo.
+ */
+declare const ControlledAutocomplete: ControlledInput<ControlledAutocompleteProps>;
+
+interface ControlledColorProps {
+    /** Ruta del color en el formulario. */
+    name: string;
+    /** Control de react-hook-form (lo inyecta el `EditField` de la página). */
+    control?: any;
+    /** `readOnly` no es prop de `TextField`, pero el `EditField` lo inyecta ahí. */
+    fieldProps?: TextFieldProps$1 & {
+        readOnly?: boolean;
+    };
+    extraProps?: {
+        /** Colores de acceso rápido. Por defecto, la paleta de la librería. */
+        presets?: string[];
+        /** Muestra el botón de "Sin color". Por defecto `true`. */
+        clearable?: boolean;
+    };
+}
+/**
+ * Campo de color en hexadecimal. Se puede escribir el hex a mano o abrirlo
+ * desde la muestra de la izquierda, que despliega la paleta de accesos rápidos
+ * y el selector del sistema para cualquier otro color.
+ *
+ * El valor que guarda en el formulario es siempre una cadena `#RRGGBB` (o `""`
+ * si se quita el color), que es lo que espera el backend.
+ *
+ * ```ts
+ * {
+ *     name: "color_en_calendario",
+ *     label: "Color en calendario",
+ *     type: ControlledColor,
+ *     gridProps: { size: { xs: 12, md: 4 } },
+ * }
+ * ```
+ */
+declare const ControlledColor: ControlledInput<ControlledColorProps>;
+
+/**
+ * `ControlledDate` de v2. Reutiliza el renderizado de edición de v1 (no se
+ * duplica su lógica) y añade el renderizado de detalle mediante `formatDetail`,
+ * de modo que la página de detalle no necesita conocer este tipo de campo.
+ *
+ * Migrar un input a v2 consiste en esto: envolver el componente de v1 y
+ * adjuntarle `formatDetail` (y opcionalmente `Detail`). Sirve de plantilla para
+ * el resto de inputs.
+ */
+declare const ControlledDate: ControlledInput;
+
+/**
+ * `ControlledSelect` de v2: hoy es un `ControlledAutocomplete` en modo múltiple.
+ *
+ * Se conserva el nombre porque ya lo usan varias pantallas de los dos
+ * proyectos; lo que cambia por dentro es cuándo y cuántas veces se piden las
+ * opciones (ver `ControlledAutocomplete`). `disableHT` viene en `true` para no
+ * mover el alto de esas pantallas: el select de v1 no reservaba el renglón del
+ * mensaje de error. Quien lo necesite puede pasarlo en `false`.
+ *
+ * Para código nuevo conviene usar `ControlledAutocomplete` directamente, que
+ * además cubre el modo simple.
+ */
+declare const ControlledSelect: ControlledInput;
+
+/**
+ * `ControlledFileField` de v2. Reutiliza el renderizado de edición de v1 y
+ * aporta su renderizado de detalle completo mediante `Detail` (badge + popover),
+ * además del texto formateado mediante `formatDetail`.
+ */
+declare const ControlledFileField: ControlledInput;
+
+interface FieldProps {
+    pageType?: PageType;
+    fieldData?: any;
+    /** Registro completo de la página; permite a los campos leer valores hermanos. */
+    data?: any;
+    name: string;
+    detail_name?: string;
+    label: string;
+    /** Ubicación de la etiqueta respecto al campo. Por defecto `"top"`. */
+    labelPosition?: "top" | "left";
+    /** Input controlado a renderizar (edición) y, opcionalmente, su detalle. */
+    type: ControlledInput;
+    gridProps?: GridProps;
+    fieldProps?: object;
+    extraProps?: any;
+    detailFieldProps?: {
+        preValue?: string;
+        postValue?: string;
+    };
+    navigation?: {
+        url: string;
+        permission: string;
+    };
+    permission?: string;
+    display?: boolean;
+}
+
+/**
+ * Un catálogo administrable por el negocio: código, nombre, descripción y activo.
+ *
+ * Muchos modelos de un sistema son idénticos salvo por su nombre, su endpoint y —a lo mucho— un
+ * par de campos extra, así que se declaran en vez de escribirse: los endpoints los arma
+ * `crearFabricaDeCatalogos` y la pantalla `CatalogoList` y `CatalogoItem`, a partir de esto.
+ *
+ * Lo que NO cabe aquí se escribe a mano. La fábrica existe para lo repetitivo; en cuanto un
+ * catálogo necesita lógica propia deja de ser uno de estos y pasa a ser una pantalla normal.
+ * Estirar la fábrica para acomodarlo es cómo se convierte en el lugar donde se esconden los
+ * casos especiales — el mismo criterio con el que en el backend los modelos comparten base pero
+ * los filtros, serializadores y vistas no.
+ *
+ * ## Lo que el backend tiene que cumplir
+ *
+ * Los campos base **no son configurables**: son el contrato. El recurso en `endpoint` sirve, en
+ * el listado y en el detalle:
+ *
+ * - `id`.
+ * - `codigo` — cadena, obligatoria y **única**. Es la llave con la que se identifica el registro
+ *   fuera de la base (la del CSV, la que alguien dicta por teléfono). La ficha avisa que "se
+ *   guarda en mayúsculas y sin espacios", así que el backend lo normaliza así al guardar, y
+ *   busca con la misma normalización al importar: si no, una actualización por código no
+ *   encuentra la fila y choca contra el `unique`.
+ * - `nombre` — cadena, obligatoria. Es el orden inicial del listado.
+ * - `descripcion` — texto libre, puede ser nulo.
+ * - `activo` — booleano. Es la baja lógica: un registro referenciado no se borra, se desactiva.
+ *
+ * **La unicidad de `codigo` la garantiza el backend, no la grilla.** Un choque vuelve como un
+ * 400 con el error en `codigo`, y la edición en línea lo pinta sobre la celda
+ * (`renderEditCellWithErrorTooltip` con `mutationErrors`); la ficha, sobre el campo. El
+ * `extra.queryArgs.endpoint` que lleva la columna `codigo` no valida nada: es lo que hace que el
+ * panel de filtros la ofrezca como selector múltiple, con las opciones que sirve el
+ * `como_opciones` de ese mismo endpoint, y filtre por `codigo__in`. Por eso el recurso también
+ * tiene que servir `como_opciones`.
+ *
+ * Y lo que ya pide cualquier pantalla de la librería:
+ *
+ * - El listado, paginado con `results` y `count`.
+ * - `obj_permissions` en cada registro (`edit`, `delete`). Es lo único que la ficha consulta para
+ *   ofrecer editar y borrar, y la grilla para dejar editar un renglón. Como la baja es lógica,
+ *   el backend tiene que calcular `obj_permissions.delete` con el `deletable` del registro —falso
+ *   mientras algo lo referencie—, no sólo con el permiso del modelo: si no, la ficha ofrece un
+ *   borrado que el servidor va a rechazar.
+ * - Guardar (POST o PATCH) contesta `{ detail, list }`: `manualCacheRefresh` copia `detail` en la
+ *   caché del detalle y `list` en el renglón del listado, sin volver a pedirlos.
+ */
+interface DefinicionDeCatalogo {
+    /**
+     * Identificador único dentro del store. Nombra los endpoints de RTK Query y el tag de caché,
+     * así que **no puede repetirse entre catálogos**: todos inyectan sobre el mismo `createApi`.
+     */
+    clave: string;
+    /** Ruta del recurso en el backend, sin diagonal final: `/<app>/<recurso>`. */
+    endpoint: string;
+    /** Permiso del modelo como lo resuelve `has_perm`, sin la acción: `<app>.<modelo>`. */
+    permiso: string;
+    /** Singular, para los mensajes y el título del detalle. */
+    singular: string;
+    /** Plural, para el título del listado. */
+    plural: string;
+    /** Campos propios, encima de código / nombre / descripción / activo. */
+    camposExtra?: FieldProps[];
+    /**
+     * Columnas propias del listado, insertadas antes de `Descripción`.
+     *
+     * Es una función y no un arreglo para que reciba `mutationErrors`, que es lo que pinta
+     * el tooltip de error sobre la celda que el servidor rechazó. Sin eso, las columnas
+     * declaradas aquí fallarían en silencio mientras las de la base sí avisan.
+     */
+    columnasExtra?: (props?: EditGridColumnsProps) => GridColDefPropsOverrides[];
+    /**
+     * Columnas de la base que este catálogo **no** enseña.
+     *
+     * Quita, no agrega: es lo único que la deja ser una opción sin volverse el lugar donde se
+     * esconden los casos especiales. Existe porque un catálogo puede tener algo más informativo
+     * que decir en el mismo espacio —a quién le aplica cada registro, antes que su
+     * descripción— y el ancho de una grilla no es infinito.
+     *
+     * El campo sigue estando en la ficha y en el CSV; lo único que cambia es qué se ve de un
+     * vistazo en el listado.
+     */
+    ocultarColumnas?: string[];
+    /** Se suma al esquema base de zod. */
+    esquemaExtra?: Record<string, ZodType>;
+    /** Valores iniciales de los campos extra en el alta. */
+    valoresExtra?: Record<string, unknown>;
+}
+
+/** Los módulos de un `createApi` de `@reduxjs/toolkit/query/react`: el núcleo y los hooks. */
+type ConHooks = CoreModule | typeof reactHooksModuleName;
+/**
+ * Los cuatro hooks de un catálogo simple.
+ *
+ * Van como `any` porque los nombres de los endpoints se arman en tiempo de ejecución a partir de
+ * `clave`, así que TypeScript no puede derivar los hooks `useXQuery` que RTK genera.
+ */
+interface CatalogoAPI {
+    /** `useQuery` del detalle: `useObtener({ id })`. */
+    useObtener: any;
+    /** `useLazyQuery` del listado: lo que `ServerGrid_v2` pide en `api.data.query`. */
+    useListarLazy: any;
+    /** `useMutation` de guardar: POST sin id, PATCH con id. */
+    useGuardar: any;
+    /** `useMutation` de borrar. */
+    useEliminar: any;
+}
+/** Lo que devuelve `crearFabricaDeCatalogos`: la fábrica ya atada al `createApi` de una app. */
+type CrearCatalogoAPI = (definicion: DefinicionDeCatalogo) => CatalogoAPI;
+/**
+ * Ata la fábrica de catálogos al `createApi` de una app.
+ *
+ * El `createApi` es de cada app —su `baseQuery`, su refresh del token, sus tags— y tiene que ser
+ * uno solo, así que se inyecta en vez de crearse aquí. Cada app lo hace una vez:
+ *
+ *     export const crearCatalogoAPI = crearFabricaDeCatalogos(mainAPI);
+ *
+ * y de ahí en adelante declara catálogos sin volver a nombrar su store.
+ *
+ * Acepta el `createApi` tal como sale de `@reduxjs/toolkit/query/react`, con dos condiciones que
+ * el tipo comprueba: que traiga los hooks de React —son lo que la fábrica devuelve— y que su
+ * `baseQuery` acepte `string | FetchArgs`, que es lo que arman los endpoints (una URL para leer;
+ * `{ url, method, body }` para escribir). El parámetro es genérico a propósito: `Api` es
+ * invariante en sus definiciones, así que ningún `Api<any, …>` fijo acepta el `mainAPI` concreto
+ * de una app, y así entra tal cual.
+ *
+ * Lo que devuelve arma los cuatro endpoints de RTK Query que necesita un catálogo simple. Es
+ * exactamente el `<modelo>API.ts` de un CRUD escrito a mano, parametrizado: obtener uno, listar
+ * con los argumentos del grid, guardar (POST o PATCH según traiga id) y borrar. Los nombres se
+ * derivan de `definicion.clave` porque **todos los catálogos inyectan sobre el mismo `createApi`**
+ * y dos endpoints con el mismo nombre se pisan en silencio: con `overrideExisting: false`, el
+ * segundo catálogo con una clave repetida se queda con los endpoints —y el `endpoint`— del
+ * primero.
+ *
+ * `serializeQueryArgs` replica el del molde: el listado guarda una sola entrada de caché por
+ * recurso —los filtros y el orden viajan en los args y no deben multiplicarla— y el detalle una
+ * por id. `forceRefetch` con `isEqual` es lo que hace que un cambio de filtro sí vuelva a pedir.
+ *
+ * Se llama al cargar el módulo, una vez por catálogo, y no dentro de un componente: cada llamada
+ * inyecta endpoints en el store.
+ */
+declare const crearFabricaDeCatalogos: <BaseQuery extends BaseQueryFn<string | FetchArgs, any, any, any, any>, Definiciones extends EndpointDefinitions, ReducerPath extends string, Tags extends string>(mainAPI: Api<BaseQuery, Definiciones, ReducerPath, Tags, ConHooks>) => CrearCatalogoAPI;
+
+/**
+ * Las columnas de un catálogo simple: código, nombre, las propias que declare, descripción y
+ * activo.
+ *
+ * Un catálogo puede omitir alguna de las de la base con `ocultarColumnas` — quitar, nunca cambiar
+ * lo que hacen; ver `DefinicionDeCatalogo`.
+ *
+ * `codigo` lleva `extra.queryArgs.endpoint`, que es lo que hace que el panel de filtros la
+ * ofrezca como selector múltiple con las opciones del propio recurso (`como_opciones`). **No
+ * valida la unicidad**: eso lo hace el backend al guardar, y el choque vuelve como el error que
+ * `renderEditCellWithErrorTooltip` pinta sobre la celda.
+ */
+declare const columnasDeCatalogo: (definicion: DefinicionDeCatalogo) => (props?: EditGridColumnsProps) => GridColDefPropsOverrides[];
+
+interface FilterInput {
+    /** The column this input filters on — used only as a React key. */
+    field: string;
+    /**
+     * The query keys this input writes. Usually one, but a range input owns two
+     * (`_min`/`_max`, `_after`/`_before`), which is why this isn't just `field`.
+     */
+    keys: string[];
+    label: string;
+    type: string;
+    element: ReactElement;
+}
+/**
+ * A filter the page adds itself, for something no column represents — a scope toggle, a flag
+ * the backend computes, anything whose value isn't a column's value.
+ *
+ * The element is read fresh on every render rather than captured with the schema, so an input
+ * that closes over page state stays current.
+ */
+interface CustomFilterDef {
+    /**
+     * The query key sent to the backend, and the form field name the element must bind to.
+     *
+     * Wins over a column that would generate the same key: the column's input is dropped from
+     * the panel, so one key never gets two inputs writing to it.
+     */
+    field: string;
+    label: string;
+    /** Any controlled input. The panel clones `control` in, exactly as it does for columns. */
+    element: ReactElement;
+    /** Defaults to `z.any().optional()` — enough for a value the backend validates anyway. */
+    schema?: z.ZodType<any, any>;
+    /** What the panel resets to, and what "Limpiar" restores. Defaults to `""`. */
+    defaultValue?: any;
+}
+
+/**
+ * Where the filter panel renders. `"drawer"` (the default) docks it to the right of the rows;
+ * `"popper"` floats it off the toolbar button, the way it used to.
+ */
+type FiltersVariant = "drawer" | "popper";
+
+/**
+ * What the grid hands its RTK lazy query — the corrected `GridArgs`.
+ *
+ * v1 typed `filterModel` as MUI's `GridFilterModel` (`items: GridFilterItem[]`), a shape the
+ * grid has never sent; it actually sends `MyGridFilterModel`, whose `items` is a plain
+ * key/value bag. Endpoints typed against the v1 type were describing something that never
+ * arrived. The index signature is real too: `api.data.args` may add arbitrary keys (several
+ * endpoints read an `endpoint` or `tipo` off it).
+ */
+interface ServerGridArgs {
+    page?: number;
+    pageSize?: number;
+    sortModel: GridSortModel;
+    filterModel: MyGridFilterModel;
+    ignoreSort?: boolean;
+    [key: string]: any;
+}
+interface ServerGridDataApi {
+    /** RTK Query lazy hook, e.g. `useLazyGetConceptosQuery`. */
+    query: any;
+    /** Extra query args, deep-merged over the grid's own. Deep-compared, so literals are safe. */
     args?: any;
     /** Filter keys the user may not clear from the filters panel. */
     protectFilters?: string[];
@@ -2225,209 +2644,46 @@ interface GridLayerContribution {
 }
 type GridLayerMap = Partial<Record<GridLayerId, GridLayerContribution>>;
 
+interface CatalogoListProps {
+    definicion: DefinicionDeCatalogo;
+    api: CatalogoAPI;
+    /**
+     * Ruta a la que navega un renglón, y llave con la que el grid guarda filtros y columnas.
+     *
+     * Por defecto es la ruta actual, que es lo correcto cuando el listado ES la página. Dentro de
+     * una pestaña hay que pasarla explícitamente: ahí `useLocation()` devuelve la ruta de la
+     * página contenedora, así que sin esto los renglones navegarían al detalle de la página que
+     * contiene las pestañas y todas ellas compartirían una sola llave de persistencia.
+     */
+    pathname?: string;
+    /**
+     * La importación del listado: lo que va tal cual en `create.csv_upload` de `ServerGrid_v2`.
+     *
+     * - **Sin esto no hay importación.** La grilla no pinta la opción de CSV, y el menú de Crear
+     *   se queda sólo con "Manual".
+     * - `{ enable: true }` abre el cajón de CSV de la librería (`CSVUpload`): sube el archivo con
+     *   el `useSubirCSVMutation` que la app registra en su `APIProvider`, contra el `pathname` de
+     *   la grilla, y ofrece la plantilla estática `/plantillas/plantilla_<último segmento>.xlsx`.
+     * - `{ enable: true, component }` cambia ese cajón por el de la app, que recibe las mismas
+     *   props (`CSVUploadSlotProps`). Es por donde entra un importador propio, con lo que su
+     *   backend acepte junto al archivo. El componente tiene que ser **estable** —memoizado, o
+     *   declarado fuera del render—: uno nuevo en cada render desmonta el cajón y se pierde el
+     *   archivo que el usuario ya había elegido.
+     *
+     * Se recibe hecho y no se arma aquí porque la política de importación es de cada app, y
+     * crecerle opciones a la librería para cubrirlas a todas es cómo un componente compartido se
+     * vuelve la unión de tres aplicaciones. Si la política depende del permiso del catálogo, ése
+     * ya viaja en `definicion.permiso`.
+     */
+    csvUpload?: ServerGridCreateApi["csv_upload"];
+}
 /**
- * Server-mode DataGrid: pagination, sorting and filtering all resolved by the backend, with
- * optional create / edit / delete modes layered on top.
+ * El listado de un catálogo simple: grid del servidor, edición en línea, borrado y alta.
  *
- * The optional modes are real components wrapping the grid, so each one's hooks belong to it
- * rather than to this component. That is the difference from v1, where the wrappers were
- * called as plain functions and their hooks landed in the grid's own hook list — a page that
- * built `api.edit` conditionally would then change React's hook order and crash.
+ * El alta siempre está —sujeta al permiso de agregar—; la importación CSV sólo si se pasa
+ * `csvUpload`.
  */
-declare function ServerGrid(props: ServerGridProps): react_jsx_runtime.JSX.Element;
-
-interface ExportCSVProps {
-    handleClick: () => void;
-    filterModel: MyGridFilterModel;
-    sortModel: GridSortModel;
-    rowSelectionModel: GridRowSelectionModel;
-    /** The scoping the grid queries with. Without it an export exceeds what the grid shows. */
-    queryArgs?: ServerGridArgs;
-    disabledWithoutSelection?: boolean;
-    /** Rows the current filters match, for the count shown in the picker. */
-    rowCount?: number;
-    ignore?: {
-        filters?: string[];
-        sort?: boolean;
-    };
-    slots?: {
-        endpoint?: string;
-        title?: string;
-        variant?: string;
-        column_key?: string;
-        /** Opens the column picker instead of downloading straight away. Defaults to on. */
-        columnPicker?: boolean;
-    };
-}
-/**
- * Downloads the whole filtered result set as CSV — the server rebuilds it from the filters,
- * so this is never limited to the rows currently on screen.
- */
-declare function ExportCSV(props: ExportCSVProps): react_jsx_runtime.JSX.Element;
-
-interface UseServerGridOptions {
-    /** Where this grid's state is remembered. Fixed for the lifetime of the mount. */
-    storageKey: string;
-    dontSaveState?: boolean;
-    /** RTK Query lazy hook, e.g. `useLazyGetConceptosQuery`. */
-    query: any;
-    /** Extra query args, deep-compared — object literals are safe. */
-    args?: any;
-    /** Passed to the lazy hook (`{ pollingInterval }`, …). Also deep-compared. */
-    queryOptions?: {
-        [key: string]: any;
-    };
-    initialState?: MyDataGridProps["initialState"];
-    columns?: readonly GridColDef[];
-}
-interface ServerGridPermissions {
-    create?: boolean;
-    edit?: boolean;
-    delete?: boolean;
-}
-interface ServerGridState {
-    apiRef: ReturnType<typeof useGridApiRef>;
-    rows: readonly any[];
-    rowCount: number;
-    permissions: ServerGridPermissions;
-    isLoading: boolean;
-    isFetching: boolean;
-    isError: boolean;
-    paginationModel: GridPaginationModel;
-    setPaginationModel: Dispatch<SetStateAction<GridPaginationModel>>;
-    sortModel: GridSortModel;
-    setSortModel: Dispatch<SetStateAction<GridSortModel>>;
-    filterModel: MyGridFilterModel;
-    setFilterModel: Dispatch<SetStateAction<MyGridFilterModel>>;
-    columnVisibilityModel: GridColumnVisibilityModel;
-    setColumnVisibilityModel: Dispatch<SetStateAction<GridColumnVisibilityModel>>;
-    rowSelectionModel: GridRowSelectionModel;
-    setRowSelectionModel: Dispatch<SetStateAction<GridRowSelectionModel>>;
-    /** Debounced quick-search setter. Cancelled on unmount. */
-    setQuickSearchValue: DebouncedFunc<(value: string) => void>;
-    /** Toolbar collapse, hoisted here so shortcuts can reopen a collapsed toolbar. */
-    toolbarExpanded: boolean;
-    setToolbarExpanded: Dispatch<SetStateAction<boolean>>;
-    /**
-     * Whether the filter panel is showing. Up here rather than in the toolbar because the
-     * docked panel is a sibling of the grid, not a child of the button that opens it — and
-     * because Ctrl+Shift+F has to reach it from a collapsed toolbar either way.
-     */
-    filtersOpen: boolean;
-    setFiltersOpen: Dispatch<SetStateAction<boolean>>;
-    /** Exactly what was last sent to the server. Also feeds the CSV export. */
-    args: ServerGridArgs;
-    refetch: () => void;
-    subscribeRows: (callback: (snapshot: RowsSnapshot) => void) => () => void;
-}
-/**
- * Everything a server-mode grid needs to hold: the models the user drives, the persisted
- * state they start from, and the lazy query that keeps rows in step with them. Renders
- * nothing — `ServerGrid` supplies it through context, and pages that need a shape the grid
- * doesn't offer can drive their own `DataGrid` from it.
- */
-declare function useServerGrid(options: UseServerGridOptions): ServerGridState;
-
-interface ComposeGridPropsInput {
-    /** The grid's own baseline — slots, locale, density. */
-    defaults: Partial<MyDataGridProps>;
-    layers: GridLayerMap;
-    /** `props.dataGridProps`, straight from the page. */
-    consumer?: Partial<MyDataGridProps>;
-}
-/**
- * Flattens the grid defaults, every mounted layer and the consumer's own props into one
- * `DataGrid` prop object.
- *
- * Precedence, low to high:
- *   1. grid defaults
- *   2. layer `defaults`, in `LAYER_ORDER`
- *   3. the consumer's `dataGridProps`
- *   4. layer `overrides`, in `LAYER_ORDER`
- *
- * Tier 4 sits above the consumer on purpose — a layer must be able to force the grid into a
- * coherent state while its mode is on (no checkboxes and no row navigation while rows are
- * being deleted). It is only ever allowed to publish mode-*on* values there; see
- * `GridLayerContribution.overrides`.
- */
-declare function composeGridProps({ defaults, layers, consumer, }: ComposeGridPropsInput): Partial<MyDataGridProps>;
-
-/**
- * Columns the user is allowed to hide.
- *
- * v1 excluded `"actions"` by *field*, but that is a column **type** — the real action columns
- * are `edit` and `delete`, so both showed up in the columns panel and could be hidden (and
- * persisted hidden) out from under the layer that owns them. Matched on both here.
- */
-declare const togglableFields: (columns?: readonly GridColDef[]) => string[];
-interface ResolvedGridState {
-    paginationModel: GridPaginationModel;
-    sortModel: GridSortModel;
-    filterModel: MyGridFilterModel;
-    columnVisibilityModel: GridColumnVisibilityModel;
-}
-interface ResolveInitialStateInput {
-    storageKey: string;
-    /** `slotProps.dontSaveState` — skip the session store entirely. */
-    disabled?: boolean;
-    initialState?: MyDataGridProps["initialState"];
-    columns?: readonly GridColDef[];
-}
-/**
- * Works out the state a grid starts in, from what the session remembers and what the page
- * declared. The only place that precedence lives.
- *
- * Pagination, sorting and column visibility prefer the **session**: those are the user's own
- * choices and should survive navigating away and back.
- *
- * Filters are the exception — the page's `initialState.filters` wins, key by key. Those
- * express scoping ("this embarque's recibos"), not preference, and in v1 the session beat
- * them outright, so a grid opened on record B kept showing record A's rows for the rest of
- * the session. Pages worked around it by repeating the same filter in `api.data.args`; they
- * no longer have to. A user-set filter on any *other* key still survives.
- */
-declare function resolveInitialState({ storageKey, disabled, initialState, columns, }: ResolveInitialStateInput): ResolvedGridState;
-
-/**
- * Page sizes offered by the grid and by the pagination slot. One list: in v1 the grid and
- * `CustomPagination` each declared their own copy and had to be kept in sync by hand.
- *
- * `-1` is "all" — the backends read that literal and return the whole result set with
- * `next`/`previous` null but a correct `count`. Only its label is translated; the value is wire
- * protocol and never changes.
- */
-declare const pageSizeOptions: (etiquetaTodos: string) => (number | {
-    value: number;
-    label: string;
-})[];
-declare const DEFAULT_PAGINATION: GridPaginationModel;
-/**
- * The order layer contributions are applied in — columns, toolbar buttons and prop overrides
- * alike. Declared here so it never depends on how the layers happen to nest, which is what
- * made the delete column's position accidental in v1.
- */
-declare const LAYER_ORDER: readonly GridLayerId[];
-
-interface DeleteGridColumnsProps {
-    displayDelete?: boolean;
-    handleOpen: (id: GridRowId) => () => void;
-    /**
-     * Rótulo de la columna y de la acción. Es un parámetro y no un `useTextos()` porque esto no
-     * es un componente: lo llama la capa de borrado, que sí es la que tiene el idioma a mano.
-     * El default en español mantiene andando a quien la llame sin pasarlo.
-     */
-    etiqueta?: string;
-}
-/**
- * The per-row delete action, shown only while delete mode is on.
- *
- * v1 left `type` off, so the column defaulted to `string`: sortable by a user, and offered in
- * the filters panel as an "Eliminar" text filter that meant nothing. Declaring `type: "actions"`
- * fixes both — but it has to come with `getActions` rather than `renderCell`, because an
- * explicit `renderCell` beats the actions type's own cell and takes its keyboard handling and
- * overflow menu with it.
- */
-declare const deleteColumn: (props: DeleteGridColumnsProps) => GridColDefPropsOverrides[];
+declare const CatalogoList: ({ definicion, api, pathname, csvUpload }: CatalogoListProps) => react_jsx_runtime.JSX.Element;
 
 type ChipColor = StatusColor;
 type ChipOption = {
@@ -2456,310 +2712,156 @@ declare const renderChipCell: (options: ChipOption[], colors?: Record<string, Ch
     value?: unknown;
 }) => react_jsx_runtime.JSX.Element;
 
+interface PulseDotProps {
+    /** Cuando es `true`, el punto es verde y parpadea; si no, usa `inactiveColor`. */
+    active: boolean;
+    /** Color cuando no está activo. Por defecto `error.main`. */
+    inactiveColor?: string;
+    /** Tamaño del punto en px. Por defecto 10. */
+    size?: number;
+    /** Título opcional; si se pasa, envuelve el punto en un Tooltip. */
+    title?: ReactNode;
+}
+/** Punto de estado: verde con animación de parpadeo cuando está activo, de lo
+ *  contrario un color fijo. Se usa para indicar conexión/actividad en vivo. */
+declare function PulseDot({ active, inactiveColor, size, title }: PulseDotProps): react_jsx_runtime.JSX.Element;
+
 /**
- * Datos que recibe el renderizado de detalle de un input. Es un subconjunto de
- * `FieldProps` (los campos que necesita la vista de solo lectura), más un
- * `content` opcional con el valor ya formateado y envuelto con pre/post por el
- * contenedor `DetailField` (útil para renderizadores completos como archivos).
+ * El contenedor que declara todo renglón que lleve un título y sus adornos: el encabezado de
+ * una página, el de un cajón y el de un diálogo.
+ *
+ * Se llama igual en los tres a propósito. Lo que aterriza en ese renglón —el estado de un
+ * registro, una barra de acciones— tiene que encogerse cuando el renglón se queda corto, y con
+ * un solo nombre esa regla se escribe una vez y sirve en los tres sitios: cada cosa mide contra
+ * el renglón que la contiene, que en una página es el ancho de la página y en un cajón de 460px
+ * es el del cajón. Los breakpoints del viewport no sabrían distinguirlos —la pantalla es la
+ * misma— y `@container` sí.
+ *
+ * No se pisan entre ellos aunque compartan nombre: un cajón y un diálogo se pintan por portal,
+ * fuera del árbol de la página, así que nunca hay uno dentro de otro. Y si lo hubiera, una
+ * `@container` resuelve contra el contenedor ancestro más cercano, que es justo el que manda.
  */
-interface DetailRenderProps {
-    fieldData?: any;
-    /** Registro completo de la página; permite leer valores hermanos. */
-    data?: any;
-    name?: string;
-    detail_name?: string;
-    extraProps?: any;
-    /** Valor formateado + pre/post, disponible para `Detail`. */
-    content?: string;
-}
+declare const HEADER_CONTAINER = "acv-header";
 /**
- * Contrato de un input controlado de v2. Además de renderizar su modo de
- * edición (el propio componente), puede aportar su propia lógica de detalle:
+ * Debajo de este ancho el renglón se considera angosto y lo que viva en él debería encogerse:
+ * la insignia de estado, por ejemplo, se queda en un punto de color con el rótulo en el globo.
  *
- * - `formatDetail`: convierte el valor en contenido mostrable (string o nodo).
- *   Cubre la mayoría de los casos; el contenedor se encarga de envolverlo con
- *   enlaces de navegación y pre/post.
- * - `Detail`: renderizado de detalle completo (badges, popovers…). Poco común;
- *   solo para inputs que necesitan controlar toda su UI de solo lectura.
+ * Se escribe como regla y no como número suelto para que quien la use no tenga que rearmar la
+ * consulta —ni equivocarse al hacerlo—:
+ *
+ *     sx={{ [HEADER_NARROW]: { display: "none" } }}
  */
-interface ControlledInput<P = any> extends FC<P> {
-    formatDetail?: (props: DetailRenderProps) => ReactNode;
-    Detail?: (props: DetailRenderProps) => ReactNode;
-}
-
+declare const HEADER_NARROW = "@container acv-header (max-width: 600px)";
 /**
- * Forma JSON que se guarda en el formulario / se envía al backend.
- * Para direcciones escritas a mano solo viene `formatted_address`.
+ * Convierte un renglón en el contenedor contra el que se miden sus adornos.
+ *
+ * `inline-size`, nunca `size`: contener también el eje de bloque le fijaría la altura al
+ * encabezado, que crece con lo que lleva dentro —un subtítulo, un título en dos renglones—.
  */
-interface AddressValue {
-    formatted_address: string;
-    place_id?: string | null;
-    lat?: number | null;
-    lng?: number | null;
-    street_number?: string;
-    route?: string | null;
-    neighborhood?: string | null;
-    locality?: string | null;
-    administrative_area_level_1?: string | null;
-    postal_code?: string | null;
-    country?: string | null;
-    country_code?: string | null;
-}
-interface ControlledAddressAutocompleteProps {
-    name: string;
-    label?: string;
-    control: any;
-    fieldProps?: TextFieldProps$1;
-    extraProps?: {
-        /**
-         * API key de Google Maps. Si no se pasa, se intenta leer
-         * `VITE_GOOGLE_MAPS_API_KEY` de `import.meta.env`.
-         */
-        apiKey?: string;
-        /** Restringe los resultados a estos países, p.ej. ["mx", "us"]. */
-        countries?: string[];
-        /** Idioma de los resultados, p.ej. "es". */
-        language?: string;
-        /**
-         * Callback opcional con el `Place` resuelto (con addressComponents,
-         * location, etc.) por si la pantalla necesita autollenar otros campos.
-         */
-        onResolved?: (place: any) => void;
-    };
-}
-declare const ControlledAddressAutocomplete: {
-    ({ name, label, control, fieldProps, extraProps, }: ControlledAddressAutocompleteProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-    formatDetail({ fieldData }: DetailRenderProps): string;
-};
+declare const headerContainerSx: CSSObject;
 
-/** Opción de un desplegable: `{ value, label }`. */
-interface Opciones {
-    value: string;
-    label: string;
-}
-interface ControlledAmountWithCurrencyProps {
-    /** Ruta del monto en el formulario, p.ej. "valores_de_factura.subtotal". */
-    name: string;
-    /** Control de react-hook-form (lo inyecta el `EditField` de la página). */
-    control?: any;
-    fieldProps?: Partial<NumericFormatProps<InputBaseProps>>;
-    extraProps?: {
-        /**
-         * Ruta de la moneda en el formulario. Por defecto `${name}_moneda`,
-         * de modo que "valores_de_factura.subtotal" usa
-         * "valores_de_factura.subtotal_moneda".
-         */
-        currencyName?: string;
-        /** Origen de las opciones de moneda (endpoint `como_opciones`). */
-        queryArgs?: ComoOpcionesProps;
-        /** Opciones estáticas de moneda (alternativa a `queryArgs`). */
-        options?: Opciones[];
-    };
-}
 /**
- * Campo compuesto de monto + moneda que se muestra como una sola fila con
- * borde: importe alineado a la derecha y un selector de moneda compacto al
- * final.
+ * Cómo se está dibujando la barra. En orden de lo que ocupa: las acciones a la vista con su
+ * etiqueta, las mismas sólo con el icono, sólo las fijadas, o ninguna.
  *
- * Está pensado para usarse como `type` de un campo de una página de detalle.
- * La etiqueta la aporta el `Field` contenedor (no el propio campo):
+ * El modo dice qué se dibuja *fuera* del menú; lo que quede fuera de eso —y lo que sobre del
+ * tope de `maxVisible`— está siempre dentro de él, así que hasta en `"full"` puede haber menú.
  *
- * ```ts
- * {
- *     name: "valores_de_factura.subtotal",
- *     label: "Subtotal",
- *     type: ControlledAmountWithCurrency,
- *     gridProps: { size: 12 },
- * }
- * ```
- */
-declare const ControlledAmountWithCurrency: {
-    ({ name, control, fieldProps, extraProps, }: ControlledAmountWithCurrencyProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-    formatDetail({ fieldData, extraProps, data, name, }: DetailRenderProps): string;
-};
-
-/**
- * Helpers puros del `ControlledAutocomplete`: los argumentos de la consulta, la
- * lista que se muestra y las cuentas del "seleccionar todo". Viven fuera del
- * componente para poder probarlos sin montar MUI ni RTK Query.
+ * `"pinned"` sólo es un escalón cuando hay alguna acción fijada; sin ellas la barra pasa de
+ * `"icons"` derecho a `"menu"`.
  */
-
-/** Una opción del desplegable, tal como la devuelve `como_opciones`. */
-interface AutocompleteOption {
-    value: any;
+declare const RESPONSIVE_ACTION_MODES: readonly ["full", "icons", "pinned", "menu"];
+type ResponsiveActionsMode = (typeof RESPONSIVE_ACTION_MODES)[number];
+interface ResponsiveAction {
+    /** Texto del botón; también lo que se lee en el menú y en el tooltip del modo icono. */
     label: string;
+    /** Se dibuja como `startIcon`, como el botón entero, o a la izquierda del renglón del menú. */
+    icon: ReactNode;
+    onClick: () => void;
+    /** Ayuda larga. Sustituye a `label` como tooltip —el modo icono siempre lleva uno. */
+    tooltip?: string;
+    disabled?: boolean;
+    /** Spinner en lugar del icono, y la acción bloqueada mientras tanto. */
+    loading?: boolean;
+    /** También tiñe el renglón del menú, para que la acción se vea igual se dibuje como se dibuje. */
+    color?: ButtonProps["color"];
+    /**
+     * La última en esconderse: cuando el renglón deja de dar para todas, esta se queda a la vista
+     * —como icono— y las demás se van al menú. Es para la que se usa siempre (editar, en una
+     * ficha); fijar media barra no sirve de mucho, porque entonces ese escalón acaba pesando casi
+     * lo mismo que el anterior y se salta solo.
+     */
+    pinned?: boolean;
 }
-
-/**
- * Props que el consumidor escribe en `fieldProps` pensando en "el campo" pero que
- * son del `TextField` que dibuja `renderInput`, no del `Autocomplete`.
- *
- * MUI sólo reenvía a `renderInput` `id`, `disabled`, `size`, `fullWidth` e
- * `InputProps`; lo demás se quedaba en el nodo raíz del `Autocomplete` —sin
- * efecto y sin aviso—, así que un `fieldProps: { helperText: "…" }` no se veía
- * por ningún lado. Se reparten antes del spread para que lleguen a su sitio.
- */
-declare const TEXT_FIELD_KEYS: readonly ["helperText", "placeholder", "required", "margin"];
-type TextFieldOnlyProps = Pick<TextFieldProps$1, (typeof TEXT_FIELD_KEYS)[number]>;
-type AutocompleteFieldProps = Partial<AutocompleteProps<any, any, any, any>> & TextFieldOnlyProps;
-interface ControlledAutocompleteProps {
-    name: string;
-    label?: string;
-    /** Control de react-hook-form; lo inyecta el `EditField` o el panel de filtros. */
-    control?: any;
+interface ResponsiveActionsProps {
+    actions: ResponsiveAction[];
     /**
-     * Props del campo (ganan sobre las de aquí). Las del `Autocomplete` van tal
-     * cual; las que son del `TextField` (`helperText`, `placeholder`, `required`,
-     * `margin`) se enrutan solas al input, que es donde se ven.
+     * Cuántas acciones se dibujan como botón, como mucho. Las demás se van al menú desde el
+     * primer modo, quepan o no: es un tope de cuántas *merecen* estar a la vista, no de cuántas
+     * caben —de eso ya se encarga la medición—. Sin él salen todas.
+     *
+     * Se queda con las primeras, así que el orden manda: lo importante va delante. Fijar una
+     * acción (`pinned`) no la adelanta, sólo la hace la última en esconderse.
      */
-    fieldProps?: AutocompleteFieldProps;
-    extraProps?: {
-        /** Selección múltiple con casillas y chips. Por defecto, simple. */
-        multiple?: boolean;
-        /** Opciones fijas. Con ellas no se consulta nada y filtra el navegador. */
-        options?: AutocompleteOption[];
-        /** Origen remoto de las opciones (endpoint `como_opciones`). */
-        queryArgs?: ComoOpcionesProps;
-        /** Filtro contra el que se busca el texto. Por defecto `nombre__icontains`. */
-        searchField?: string;
-        /** Retardo del tecleo antes de consultar. Por defecto 400 ms. */
-        debounceMs?: number;
-        /** Caracteres mínimos para consultar. Por defecto 0 (lista completa al abrir). */
-        minChars?: number;
-        /** Fila de "seleccionar todo" en el modo múltiple. Por defecto, sí. */
-        selectAll?: boolean;
-        /**
-         * Quita el hueco reservado para el mensaje de error debajo del campo. No
-         * afecta al `helperText` de `fieldProps`: si hay texto de ayuda, se ve.
-         */
-        disableHT?: boolean;
-    };
+    maxVisible?: number;
+    /** @default "small" */
+    size?: "small" | "medium";
+    /** Fija el modo y apaga la medición. Para cuando el ancho no es quien debe decidir. */
+    mode?: ResponsiveActionsMode;
 }
 /**
- * Desplegable de opciones para react-hook-form: simple o múltiple, con opciones
- * fijas o consultadas a `como_opciones` según lo que se escribe. Unifica los
- * `ControlledDropdown` (simple) y `ControlledSelect` (múltiple) de v1, que eran
- * el mismo componente duplicado.
+ * Una barra de acciones que se encoge sola cuando deja de caber: primero pierde las etiquetas y
+ * se queda en iconos, después esconde en un menú de tres puntos todo menos lo fijado, y al final
+ * se mete ahí entera.
  *
- * ```ts
- * {
- *     name: "cliente",
- *     label: "Cliente",
- *     type: ControlledAutocomplete,
- *     extraProps: { queryArgs: { endpoint: "clientes" } },
- * }
- * ```
+ * Encogerse es cosa del ancho; cuántas acciones merecen un botón, no. Para eso está `maxVisible`,
+ * que manda al menú lo que pase de la cuenta aunque sobre sitio —una barra de ocho botones cabe
+ * en una pantalla ancha y aun así no hay quien la lea—.
  *
- * Sobre las peticiones, que era el punto flojo de v1:
+ * Mide, no adivina. Los breakpoints del viewport no sirven aquí —la misma barra vive en una
+ * página ancha y en un cajón de 460px, donde la pantalla es grande y el hueco no—, así que
+ * compara el ancho que le dejaron con el que sus botones piden y baja un escalón cuando no
+ * alcanza. Es el mismo motivo por el que el layout de los campos resuelve por `@container`.
  *
- * - **Una por apertura.** v1 pedía dos veces al abrir (el `onOpen` disparaba la
- *   consulta y el efecto la repetía con retardo) y otra vez en cada render del
- *   padre, porque `queryArgs` llega como objeto literal y su identidad cambiaba.
- * - **Elegir una opción no consulta.** Al elegir, MUI reescribe el texto del
- *   campo con la etiqueta; v1 lo trataba como búsqueda nueva y volvía a pedir.
- * - **Sin parpadeo ni respuestas cruzadas.** La lista es la del hook de RTK
- *   Query, que siempre corresponde a los últimos argumentos disparados; v1
- *   guardaba las opciones en estado propio, las vaciaba en cada tecla y una
- *   respuesta lenta podía pisar a una más nueva.
- * - **Repetir una búsqueda sale de la caché**, incluido borrar el texto para
- *   volver al listado completo.
+ * Para que la medición signifique algo, el padre tiene que ser un renglón flex que le deje
+ * crecer al sobrante: la raíz se estira (`flexGrow`) para que su ancho *sea* el hueco, y los
+ * botones van dentro sin encogerse, así que su ancho es lo que piden de verdad.
  */
-declare const ControlledAutocomplete: ControlledInput<ControlledAutocompleteProps>;
+declare const ResponsiveActions: ({ actions, maxVisible, size, mode: forcedMode, }: ResponsiveActionsProps) => react_jsx_runtime.JSX.Element | null;
 
-interface ControlledColorProps {
-    /** Ruta del color en el formulario. */
-    name: string;
-    /** Control de react-hook-form (lo inyecta el `EditField` de la página). */
-    control?: any;
-    /** `readOnly` no es prop de `TextField`, pero el `EditField` lo inyecta ahí. */
-    fieldProps?: TextFieldProps$1 & {
-        readOnly?: boolean;
+interface DetailActionsProps {
+    /**
+     * Editar. Va fijada, así que es la última en irse al menú cuando el renglón se estrecha: es
+     * la acción de siempre en una ficha, y la que se busca sin leer. Se lleva consigo el Ctrl+E
+     * que vivía en `EditButton`, el botón suelto que esta barra vino a sustituir.
+     */
+    edit?: {
+        onClick: () => void;
     };
-    extraProps?: {
-        /** Colores de acceso rápido. Por defecto, la paleta de la librería. */
-        presets?: string[];
-        /** Muestra el botón de "Sin color". Por defecto `true`. */
-        clearable?: boolean;
+    delete?: {
+        mutation: any;
+        disableNavBack?: boolean;
+    };
+    historial?: {
+        endpoint?: string;
+        /** Defaults to `"docked"` — the panel takes its own space beside the page. */
+        variant?: _HistorialDrawerProps["variant"];
+        /** Panel width in px. Defaults to 600. */
+        width?: number | string;
     };
-}
-/**
- * Campo de color en hexadecimal. Se puede escribir el hex a mano o abrirlo
- * desde la muestra de la izquierda, que despliega la paleta de accesos rápidos
- * y el selector del sistema para cualquier otro color.
- *
- * El valor que guarda en el formulario es siempre una cadena `#RRGGBB` (o `""`
- * si se quita el color), que es lo que espera el backend.
- *
- * ```ts
- * {
- *     name: "color_en_calendario",
- *     label: "Color en calendario",
- *     type: ControlledColor,
- *     gridProps: { size: { xs: 12, md: 4 } },
- * }
- * ```
- */
-declare const ControlledColor: ControlledInput<ControlledColorProps>;
-
-/**
- * `ControlledDate` de v2. Reutiliza el renderizado de edición de v1 (no se
- * duplica su lógica) y añade el renderizado de detalle mediante `formatDetail`,
- * de modo que la página de detalle no necesita conocer este tipo de campo.
- *
- * Migrar un input a v2 consiste en esto: envolver el componente de v1 y
- * adjuntarle `formatDetail` (y opcionalmente `Detail`). Sirve de plantilla para
- * el resto de inputs.
- */
-declare const ControlledDate: ControlledInput;
-
-/**
- * `ControlledSelect` de v2: hoy es un `ControlledAutocomplete` en modo múltiple.
- *
- * Se conserva el nombre porque ya lo usan varias pantallas de los dos
- * proyectos; lo que cambia por dentro es cuándo y cuántas veces se piden las
- * opciones (ver `ControlledAutocomplete`). `disableHT` viene en `true` para no
- * mover el alto de esas pantallas: el select de v1 no reservaba el renglón del
- * mensaje de error. Quien lo necesite puede pasarlo en `false`.
- *
- * Para código nuevo conviene usar `ControlledAutocomplete` directamente, que
- * además cubre el modo simple.
- */
-declare const ControlledSelect: ControlledInput;
-
-/**
- * `ControlledFileField` de v2. Reutiliza el renderizado de edición de v1 y
- * aporta su renderizado de detalle completo mediante `Detail` (badge + popover),
- * además del texto formateado mediante `formatDetail`.
- */
-declare const ControlledFileField: ControlledInput;
-
-interface FieldProps {
-    pageType?: PageType;
-    fieldData?: any;
-    /** Registro completo de la página; permite a los campos leer valores hermanos. */
-    data?: any;
-    name: string;
-    detail_name?: string;
-    label: string;
-    /** Ubicación de la etiqueta respecto al campo. Por defecto `"top"`. */
-    labelPosition?: "top" | "left";
-    /** Input controlado a renderizar (edición) y, opcionalmente, su detalle. */
-    type: ControlledInput;
-    gridProps?: GridProps;
-    fieldProps?: object;
-    extraProps?: any;
-    detailFieldProps?: {
-        preValue?: string;
-        postValue?: string;
-    };
-    navigation?: {
-        url: string;
-        permission: string;
-    };
-    permission?: string;
-    display?: boolean;
+    extraButtons?: {
+        title: string;
+        icon: ReactNode;
+        onClick: () => void;
+    }[];
+    /** Tamaño de los botones. `"small"` para las cabeceras del cajón. */
+    size?: "small" | "medium";
+    /**
+     * Fija cómo se dibuja la barra en vez de dejar que se mida. El cajón lo usa para quedarse
+     * siempre en el menú de tres puntos: su cabecera ya lleva sus propios botones al lado.
+     * @see ResponsiveActionsProps.mode
+     */
+    mode?: ResponsiveActionsMode;
 }
 
 interface SubsectionProps {
@@ -3009,648 +3111,792 @@ interface DetailExtraButton {
     display?: (data: any) => boolean;
 }
 
-interface DetailFormDrawerNavigation {
-    /** Open the previous record of the list the drawer is walking. */
-    onPrev: () => void;
-    onNext: () => void;
-    /** Whether a previous/next record exists. The arrows are disabled when it doesn't. */
-    hasPrev: boolean;
-    hasNext: boolean;
-    /** 1-based position of the current record, shown between the arrows. */
-    position?: number;
-    /** Size of the list; shown as `position / count`. */
-    count?: number;
-    /** Blocks both arrows for a caller-side reason (e.g. while the next batch loads). */
-    disabled?: boolean;
-}
-interface DetailFormDrawerProps {
-    open: boolean;
-    /** Close the drawer. Also invoked after a successful save and on cancel. */
-    onClose: () => void;
-    title?: ReactNode;
+interface DetailPageV2Props {
     api: DetailFormApi;
     form: DetailFormConfig["form"];
     sections: DetailFormConfig["sections"];
-    /** Defaults to `"create"`. */
-    pageType?: PageType;
-    /**
-     * Open a `"detail"` drawer straight in edit mode, as if the user had hit the Editar
-     * button. Ignored for the other page types, and for records the user may not edit.
-     */
-    startInEdit?: boolean;
-    /**
-     * Identity of the record on show. Swapping it (as the navigator does, without remounting
-     * the drawer) re-derives the per-record chrome — the in-place edit toggle drops back to
-     * read-only and `startInEdit` is re-applied against the new record's own permissions.
-     */
-    recordKey?: string | number;
-    permissionsPath?: string;
-    /** Runs after a successful mutation, before the drawer closes. Receives the response. */
-    onSuccess?: (response: any) => void;
-    /**
-     * Guardar deja el cajón abierto —y editando— en vez de cerrarlo. El usuario lo cierra
-     * cuando termina, con la X o con Cancelar.
-     *
-     * Para registros que se capturan de a poco, o que llevan dentro su propia grilla editable:
-     * ahí cerrar al guardar cuesta reabrir el registro, volver a entrar a editar y volver a
-     * bajar hasta donde se iba. El caso que lo pide es un cajón anidado —una orden de envío
-     * abierta desde la pestaña de su embarque, con la grilla de sus recibos adentro—, donde el
-     * cierre además se lleva la grilla de en medio.
-     *
-     * Un guardado que **no** guardó igual cierra: `useMutationHandler` corre su `onSuccess` sin
-     * respuesta ante un 403 para quitar la pantalla de en medio, y eso no es algo en lo que
-     * quedarse. Tampoco compite con "Guardar ↓" — ése ya se queda abierto por su cuenta, y
-     * cuando los dos aplican gana el paso al siguiente registro, que es lo que se pidió.
-     */
-    keepOpenOnSave?: boolean;
+    pageType: PageType;
     /**
-     * Acciones propias del registro —cerrar, revertir, descargar su PDF—, las mismas que
-     * `DetailPage_v2` recibe en `slots.extraButtons` y con la misma forma, para que un registro
-     * traiga sus acciones se abra en su página o en el cajón.
+     * What the `size` breakpoints of the fields — and of the subsections themselves — resolve
+     * against. Defaults to `"container"`: the width of the form, not of the screen.
      *
-     * Van en un menú "⋮" de la cabecera —no como iconos sueltos— porque la cabecera del cajón
-     * es angosta y ya carga Editar, Eliminar y lo que venga en `slots.headerActions`; el menú
-     * además las nombra, igual que el de la página completa. Se filtran contra el modo que el
-     * cajón muestra *en ese momento*: entrar a editar esconde las de `"detail"`, como en la
-     * página. `display` y `onClick` reciben el registro cargado.
-     */
-    extraButtons?: DetailExtraButton[];
-    /**
-     * Footer record navigator: prev/next arrows (Alt+↑ / Alt+↓) that step through a list of
-     * sibling records — e.g. the rows of the grid the drawer was opened from — without
-     * closing the drawer. Omit it and no navigator renders.
-     */
-    navigation?: DetailFormDrawerNavigation;
-    /** Panel width. Defaults to `600`. */
-    width?: number | string;
-    /** Side the drawer slides in from. Defaults to `"right"`. */
-    anchor?: DrawerProps["anchor"];
-    /**
-     * `"temporary"` (the default) floats over the page. `"docked"` takes its own space at
-     * the side of the screen and shrinks the app instead of covering it, so the page behind
-     * stays usable — see `MainDrawer_v2`.
+     * A full page is no longer the whole viewport minus the sidebar — a docked side panel
+     * takes its share of it — so the screen stopped being a good proxy for how much room
+     * the fields actually have. Against the form they re-flow as that room changes, with
+     * no re-render: the breakpoint ladder is CSS.
      *
-     * Docked drops the modal: nothing stops the user from touching the page while the form
-     * is open, so a drawer that guards unsaved edits behind the backdrop no longer does.
-     */
-    variant?: MainDrawerV2Props["variant"];
-    /**
-     * Let the user drag the drawer's inner edge to resize it. Forwarded to `MainDrawer_v2`
-     * along with the four props below — see it for the full behaviour.
-     */
-    resizable?: boolean;
-    /** Smallest width the drag allows, in px. Defaults to `320`. */
-    minWidth?: number;
-    /** Largest width the drag allows, in px. Defaults to the viewport minus a margin. */
-    maxWidth?: number;
-    /**
-     * Remember the dragged width under this `localStorage` key. Worth setting whenever the
-     * drawer is remounted per record — a fresh mount otherwise forgets the drag.
-     */
-    widthStorageKey?: string;
-    /** Fires with the final dragged width in px, or `null` when a double click resets it. */
-    onWidthChange?: (width: number | null) => void;
-    /**
-     * What the `size` breakpoints of the fields — and of the subsections themselves — resolve
-     * against. Defaults to `"container"`: a drawer is narrow by construction, so viewport
-     * breakpoints would pick the wide-screen value and cram the fields — and they would not
-     * react to a drag either.
+     * `"viewport"` restores MUI's own behaviour for a page that needs it.
      * @see DetailFormProps.responsiveTo
      */
     responsiveTo?: DetailFormProps["responsiveTo"];
     /** @see DetailFormProps.containerBreakpoints */
     containerBreakpoints?: DetailFormProps["containerBreakpoints"];
-    labels?: {
-        save?: string;
-        cancel?: string;
+    /**
+     * Deja el renglón del título —con el estado y la barra de acciones— pegado al tope mientras
+     * se scrollea la ficha. Las migas se recogen al llegar arriba, así que lo que se queda es
+     * sólo lo que hace falta tener a la mano.
+     *
+     * Encendido por defecto: una ficha es larga y sus acciones viven arriba, así que sin esto
+     * editar o abrir el historial obliga a volver al principio. Vale igual capturando —ahí lo
+     * que queda a la mano es Guardar y Cancelar—, que es la otra mitad del mismo problema.
+     *
+     * Apagarlo tiene sentido en una ficha corta, donde el encabezado nunca se va. Se ignora
+     * cuando no hay renglón de título donde poner las acciones (pantalla completa, o un
+     * `pageHeader` propio que no lo reserve): ahí vuelven a la esquina flotante de siempre.
+     * @default true
+     */
+    stickyHeader?: boolean;
+    slots?: {
+        button?: ReactNode;
         /**
-         * Rótulo del guardar-y-seguir. Por defecto `"Guardar ↓"`, corto porque va junto al
-         * Guardar de siempre y el tooltip ya dice qué hace; pásale un texto propio donde el
-         * paso al siguiente registro merezca nombrarse ("Guardar y siguiente bulto").
+         * Acciones propias del registro, junto a las del armazón. En `"detail"` entran en la
+         * barra de acciones; en alta y edición, como iconos al lado de Guardar.
+         *
+         * Las mismas se le pueden pasar al cajón de `DrawerGrid_v2` (`drawer.extraButtons`),
+         * para que el registro traiga sus acciones se abra donde se abra.
          */
-        saveAndNext?: string;
-    };
-    slots?: {
+        extraButtons?: DetailExtraButton[];
         /**
-         * Ruta al estado del registro —`"estado"`—, la misma que recibe `DetailPage_v2`: se
-         * pinta junto al título, como en la página, y con el mismo mapa de colores.
+         * Ruta al estado del registro dentro del dato —`"estado"`—, que el backend manda como
+         * `{ value, label }`: se lee la etiqueta y el código decide el color.
          *
-         * @see DetailPageV2Props.slots.badge
+         * @see DetailPageV2Props.slotProps.badge
          */
         badge?: string;
-        /** Extra actions rendered in the header, left of the close button (e.g. "open full page"). */
-        headerActions?: ReactNode;
     };
     slotProps?: {
-        drawer?: Partial<DrawerProps>;
-        saveButton?: Partial<ButtonProps>;
-        cancelButton?: Partial<ButtonProps>;
-        saveAndNextButton?: Partial<ButtonProps>;
-        /** @see DetailPageV2Props.slotProps.badge */
+        button?: {
+            save?: {
+                type: "onClick";
+                disableNavBack?: boolean;
+                onClick?: () => void;
+            };
+            cancel?: Partial<ButtonProps>;
+        };
+        /**
+         * The history panel opened from the actions bar. It docks beside the page rather
+         * than floating over it, so the record stays readable next to what the history says
+         * about it — see `DetailActionsProps.historial` for how to change that.
+         */
+        historial?: DetailActionsProps["historial"];
+        permissionsPath?: string;
+        deleteButton?: {
+            disableNavBack?: boolean;
+        };
         badge?: {
+            /**
+             * De qué color se pinta cada estado, por código:
+             *
+             *     colors: { "1": "warning", "2": "info", "3": "success" }
+             *
+             * Es el mismo mapa que recibe `renderChipCell` en las columnas de una tabla, así que
+             * lo natural es declararlo junto al catálogo y pasarlo a los dos: el estado "2" se ve
+             * igual en la lista que en la ficha.
+             *
+             * Sin mapa la insignia queda neutra —gris—, que es como se veían todos antes de que
+             * hubiera con qué distinguirlos.
+             */
             colors?: Record<string, StatusColor>;
-            /** @see DetailPageV2Props.slotProps.badge.options */
+            /**
+             * Los estados con su rótulo, para poder mostrarlo en otro idioma.
+             *
+             * Es el mismo `ChipOption[]` que reciben las columnas de la tabla, y se resuelve
+             * igual (`resolveChipOption`), así que la ficha y la lista nombran el estado con la
+             * misma palabra. Sin esto, la insignia sólo puede repetir lo que mandó el backend,
+             * que viene en español (`get_estado_display`).
+             *
+             * Ojo con traducir el `label` de una opción: casi todos estos endpoints mandan la
+             * etiqueta y no el código, así que el emparejado real es contra el texto en español
+             * — para eso está `ChipOption.match`.
+             */
             options?: ChipOption[];
         };
     };
 }
+declare function DetailPage(props: DetailPageV2Props): react_jsx_runtime.JSX.Element;
+
+type ConfiguracionDeInsignia = NonNullable<NonNullable<DetailPageV2Props["slotProps"]>["badge"]>;
 /**
- * A record form inside a side drawer. Reuses the same `useDetailForm` engine and
- * `DetailForm` body as `DetailPage_v2`, and `MainDrawer_v2` for the chrome — so it frames
- * the form exactly like every other v2 drawer. What it adds on top is the per-record
- * furniture: edit/delete in the header — plus the record's own actions, when the consumer
- * hands them over in `extraButtons`, in a "⋮" menu beside them — and a footer holding the
- * form actions and, when
- * `navigation` is given, a prev/next record navigator (Alt+↑ / Alt+↓) plus "Guardar ↓"
- * (Alt+Shift+↓) — a save that steps to the next record instead of closing, so a column can be
- * captured down a list in one pass without the hands leaving the keyboard. Rename it with
- * `labels.saveAndNext`. Guardar sits outside the `<form>` and submits via the native
- * `form={formId}` attribute; Guardar ↓ submits by hand, so the implicit Enter stays Guardar.
+ * La insignia de estado junto al título de la ficha: exactamente `slots.badge` y
+ * `slotProps.badge` de `DetailPage_v2`, y nada más.
  *
- * `keepOpenOnSave` cambia lo que hace Guardar cuando no hay a dónde avanzar: en vez de cerrar,
- * deja el registro en pantalla y editando — para formularios que se capturan de a poco o que
- * llevan una grilla adentro.
+ * Es un hueco y no algo fijo porque qué estado enseñar —y con qué colores— depende de lo que
+ * mande el backend de cada app. Vale la pena cuando lo manda: si la baja es lógica, "está dado de
+ * baja" es un estado del registro y no su ausencia, y un catálogo desactivado se ve igual que uno
+ * vivo hasta que alguien nota que dejó de aparecer en los selectores.
+ *
+ * **No apuntes `slots.badge` a `activo`.** La insignia no se dibuja cuando lo que encuentra es
+ * falso, así que apuntarla al booleano la haría salir sólo en los registros vivos y desaparecer
+ * en los dados de baja — al revés de para lo que sirve. Apúntala a un campo que el backend mande
+ * en los dos casos, como `{ value, label }` o como cadena.
+ *
+ * Sólo se pinta en modo detalle. Son estas dos props y no las de `DetailPage_v2` en general
+ * porque un comodín sería justo el lugar donde se esconden los casos especiales (ver
+ * `DefinicionDeCatalogo`).
  */
-declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, permissionsPath, onSuccess, keepOpenOnSave, extraButtons, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
-
-interface DrawerGridDrawerConfig {
-    /** Shared field layout, used by every mode. Same shape as `DetailPage_v2`'s `form`/`sections`. */
-    form: DetailFormConfig["form"];
-    sections: DetailFormConfig["sections"];
-    permissionsPath?: string;
-    /** Panel width. Defaults to the drawer's own default (600). */
-    width?: number | string;
-    /**
-     * How the panel sits on the screen. Defaults to `"temporary"`: it floats over the page,
-     * modal, the way it always has.
-     *
-     * `"docked"` gives it its own space at the side and shrinks the app instead of covering
-     * it, so the grid stays visible next to the record. Worth it where the row and the list
-     * are read together; it costs two things, both from dropping the modal:
-     *
-     * - Nothing stops the user from re-sorting, filtering or paging the grid while the
-     *   drawer is open, and the footer navigator walks the rows it sampled when the record
-     *   opened. It stays on the list the user was reading, which is usually what's wanted,
-     *   but it can no longer claim to match what's on screen.
-     * - Unsaved edits are no longer fenced off by the backdrop.
-     */
-    variant?: DetailFormDrawerProps["variant"];
-    /**
-     * Let the user drag the drawer's inner edge to resize it. The dragged width is remembered
-     * across openings under a key derived from the grid's own storage key — override it with
-     * `widthStorageKey`, or turn the memory off by passing an empty string.
-     */
-    resizable?: boolean;
-    /** Smallest width the drag allows, in px. Defaults to `320`. */
-    minWidth?: number;
-    /** Largest width the drag allows, in px. Defaults to the viewport minus a margin. */
-    maxWidth?: number;
-    /** Where the dragged width is remembered. Defaults to the grid's storage key + `_DW`. */
-    widthStorageKey?: string;
-    /**
-     * What the fields' `size` breakpoints resolve against. Defaults to `"container"` — the
-     * width of the panel, not of the screen.
-     * @see DetailFormDrawerProps.responsiveTo
-     */
-    responsiveTo?: DetailFormDrawerProps["responsiveTo"];
-    /** @see DetailFormDrawerProps.containerBreakpoints */
-    containerBreakpoints?: DetailFormDrawerProps["containerBreakpoints"];
-    title?: {
-        create?: ReactNode;
-        record?: ReactNode | ((id: GridRowId) => ReactNode);
-    };
-    /** Create-mode API (opened by the "Quick create" menu option). */
-    create: {
-        mutation: any;
-        /** Defaults to `"create"`. */
-        pageType?: PageType;
-        successMessage?: string | ((response: any) => string);
+interface InsigniaDeCatalogo {
+    slots: {
+        /** Ruta al estado dentro del detalle: `slots.badge` de `DetailPage_v2`. */
+        badge: string;
     };
-    /** Record-mode API (opened by a row click). */
-    record: {
-        /** Single-record query hook, called with `{ id, ...args(id) }`. */
-        query: any;
-        mutation: any;
-        /**
-         * Defaults to `"detail"` (read-only), matching a row-click. Use `"edit"` for an always
-         * editable drawer — a `"detail"` drawer already opens editing while the grid itself is
-         * in edit mode.
-         */
-        pageType?: PageType;
-        successMessage?: string | ((response: any) => string);
-        /** Extra query args merged with `{ id }`. */
-        args?: (id: GridRowId) => Record<string, any>;
-        /** Optional delete mutation. When set and the user has delete permission, a delete button appears in the drawer header. */
-        delete?: {
-            mutation: any;
-        };
+    slotProps?: {
+        /** Colores y rótulos por código: `slotProps.badge` de `DetailPage_v2`. */
+        badge?: ConfiguracionDeInsignia;
     };
-    /**
-     * Acciones propias del registro —las mismas que su página completa recibe en
-     * `DetailPage_v2`'s `slots.extraButtons`, y con la misma forma—, en un menú "⋮" de la
-     * cabecera del cajón. Se filtran por modo y por `display(registro)`, así que las de la
-     * página se pasan tal cual: abrir el renglón en el cajón deja de ser una versión recortada
-     * de abrirlo en su página.
-     */
-    extraButtons?: DetailExtraButton[];
-    /**
-     * El estado del registro, junto al título de la cabecera del cajón —igual que en su página
-     * completa—. `path` es la ruta al campo dentro del dato, que el backend manda como
-     * `{ value, label }`, y `colors` dice de qué color va cada código:
-     *
-     *     badge: { path: "estado", colors: { "1": "warning", "2": "info" } }
-     *
-     * `colors` es el mismo mapa que recibe `renderChipCell`, así que lo natural es declararlo
-     * junto al catálogo y pasárselo a los dos: el estado se ve igual en la columna de la tabla
-     * que en el cajón que abre esa misma fila.
-     *
-     * @see DetailPageV2Props.slots.badge
-     */
-    badge?: {
-        path: string;
-        colors?: Record<string, StatusColor>;
-        /**
-         * Los estados con su rótulo, para poder mostrarlo en otro idioma.
-         * @see DetailPageV2Props.slotProps.badge.options
-         */
-        options?: ChipOption[];
+}
+interface CatalogoItemProps {
+    definicion: DefinicionDeCatalogo;
+    api: CatalogoAPI;
+    type: PageType;
+    /** La insignia de estado junto al título. Sin ella, la ficha no lleva ninguna. */
+    insignia?: InsigniaDeCatalogo;
+}
+/**
+ * El alta, detalle y edición de un catálogo simple.
+ *
+ * `codigo` y `nombre` son obligatorios; `descripcion` es libre y `activo` es la baja lógica —un
+ * catálogo referenciado no se borra, se desactiva, y el backend lo refleja en el
+ * `obj_permissions.delete` del detalle a partir de `deletable`—. El botón de borrar lo pinta o no
+ * `DetailPage_v2` con ese `obj_permissions`, así que aquí no hay nada que decidir.
+ */
+declare const CatalogoItem: ({ definicion, api, type, insignia }: CatalogoItemProps) => react_jsx_runtime.JSX.Element;
+
+interface KpiCardProps {
+    icon: ReactNode;
+    label: string;
+    value: ReactNode;
+    caption?: string;
+    color?: string;
+    /** Variante tipográfica del valor. Por defecto `h4`; usa `h5` cuando el valor es
+     *  largo o hay muchas tarjetas por fila. */
+    valueVariant?: TypographyProps["variant"];
+    isLoading: boolean;
+}
+/** Tarjeta de KPI: ícono + etiqueta, un valor destacado y una leyenda opcional.
+ *  Muestra un esqueleto mientras se cargan los datos. */
+declare function KpiCard({ icon, label, value, caption, color, valueVariant, isLoading, }: KpiCardProps): react_jsx_runtime.JSX.Element;
+
+interface PanelProps {
+    /** Ícono a la izquierda del título (típicamente `color="action" fontSize="small"`). */
+    icon?: ReactNode;
+    /** Título del encabezado. Si se omite (y no hay ícono ni acción), no se renderiza encabezado. */
+    title?: ReactNode;
+    /** Contenido alineado a la derecha del encabezado (chips, botones, etc.). */
+    action?: ReactNode;
+    /** Región entre el encabezado y el divisor, p. ej. un `<Tabs>`. */
+    tabs?: ReactNode;
+    /** Muestra un divisor bajo el encabezado/tabs. Por defecto `true`. */
+    divider?: boolean;
+    /** Altura del contenedor. Con un número (px) el contenido ocupa el espacio
+     *  restante y hace scroll; con `"100%"` solo iguala la altura de la columna. */
+    height?: number | string;
+    /** Estilos adicionales para el `Paper`. */
+    sx?: SxProps<Theme>;
+    children?: ReactNode;
+}
+/** Contenedor estándar de panel: `Paper` con encabezado (ícono + título + acción),
+ *  divisor opcional y contenido. Unifica el aspecto de los paneles del dashboard. */
+declare function Panel({ icon, title, action, tabs, divider, height, sx, children }: PanelProps): react_jsx_runtime.JSX.Element;
+
+interface PollingCountdownChipProps {
+    pollingInterval: number;
+    isFetching: boolean;
+    onRefresh?: () => void;
+}
+/** Chip con cuenta regresiva hasta el próximo refresco de un polling. Al terminar cada
+ *  fetch reinicia el conteo; opcionalmente refresca al hacer clic. */
+declare function PollingCountdownChip({ pollingInterval, isFetching, onRefresh, }: PollingCountdownChipProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Server-mode DataGrid: pagination, sorting and filtering all resolved by the backend, with
+ * optional create / edit / delete modes layered on top.
+ *
+ * The optional modes are real components wrapping the grid, so each one's hooks belong to it
+ * rather than to this component. That is the difference from v1, where the wrappers were
+ * called as plain functions and their hooks landed in the grid's own hook list — a page that
+ * built `api.edit` conditionally would then change React's hook order and crash.
+ */
+declare function ServerGrid(props: ServerGridProps): react_jsx_runtime.JSX.Element;
+
+interface ExportCSVProps {
+    handleClick: () => void;
+    filterModel: MyGridFilterModel;
+    sortModel: GridSortModel;
+    rowSelectionModel: GridRowSelectionModel;
+    /** The scoping the grid queries with. Without it an export exceeds what the grid shows. */
+    queryArgs?: ServerGridArgs;
+    disabledWithoutSelection?: boolean;
+    /** Rows the current filters match, for the count shown in the picker. */
+    rowCount?: number;
+    ignore?: {
+        filters?: string[];
+        sort?: boolean;
     };
-    /** Runs after any successful create/edit (e.g. side effects; the grid refetches via RTK tag invalidation). */
-    onSaved?: (response: any) => void;
-    /**
-     * Whether these records have a full page of their own. Defaults to `true`.
-     *
-     * Set it to `false` for rows that exist only inside their parent and have no route —
-     * it drops the drawer header's "open full page" button *and* the Ctrl/Alt+click
-     * shortcuts, which would otherwise navigate to a route that isn't registered.
-     */
-    showOpenFullPage?: boolean;
-    /**
-     * Show the footer navigator that walks the grid's rows — prev/next arrows plus the
-     * record's position — in the record drawer. Defaults to `true`.
-     *
-     * It also gates "Guardar ↓", the save that steps to the next row instead of closing:
-     * without a list to walk there is nothing to continue to.
-     */
-    showNavigator?: boolean;
-    /**
-     * Guardar deja el cajón abierto y editando en vez de cerrarlo; se cierra con la X o con
-     * Cancelar. Para registros que se capturan de a poco, o que llevan su propia grilla
-     * editable adentro y perderían el lugar al cerrarse.
-     *
-     * @see DetailFormDrawerProps.keepOpenOnSave
-     */
-    keepOpenOnSave?: boolean;
-    /** Rótulos del pie del cajón. `saveAndNext` por defecto es `"Guardar ↓"`. */
-    labels?: {
-        save?: string;
-        cancel?: string;
-        saveAndNext?: string;
+    slots?: {
+        endpoint?: string;
+        title?: string;
+        variant?: string;
+        column_key?: string;
+        /** Opens the column picker instead of downloading straight away. Defaults to on. */
+        columnPicker?: boolean;
     };
 }
-interface DrawerGridEditConfig {
-    /** Hides the toggle (and its shortcuts) without touching permissions. */
-    disabled?: boolean;
-    /**
-     * Drives edit mode from outside instead of leaving it to the toolbar toggle — pass the
-     * edit state of the form this grid is embedded in and a row click follows it, opening the
-     * drawer already editing without the user flipping a second switch. The toolbar button
-     * disappears while it's set, and it stays fail-closed against the model's permission.
-     */
-    active?: boolean;
+/**
+ * Downloads the whole filtered result set as CSV — the server rebuilds it from the filters,
+ * so this is never limited to the rows currently on screen.
+ */
+declare function ExportCSV(props: ExportCSVProps): react_jsx_runtime.JSX.Element;
+
+interface UseServerGridOptions {
+    /** Where this grid's state is remembered. Fixed for the lifetime of the mount. */
+    storageKey: string;
+    dontSaveState?: boolean;
+    /** RTK Query lazy hook, e.g. `useLazyGetConceptosQuery`. */
+    query: any;
+    /** Extra query args, deep-compared — object literals are safe. */
+    args?: any;
+    /** Passed to the lazy hook (`{ pollingInterval }`, …). Also deep-compared. */
+    queryOptions?: {
+        [key: string]: any;
+    };
+    initialState?: MyDataGridProps["initialState"];
+    columns?: readonly GridColDef[];
 }
-interface DrawerGridProps {
+interface ServerGridPermissions {
+    create?: boolean;
+    edit?: boolean;
+    delete?: boolean;
+}
+interface ServerGridState {
+    apiRef: ReturnType<typeof useGridApiRef>;
+    rows: readonly any[];
+    rowCount: number;
+    permissions: ServerGridPermissions;
+    isLoading: boolean;
+    isFetching: boolean;
+    isError: boolean;
+    paginationModel: GridPaginationModel;
+    setPaginationModel: Dispatch<SetStateAction<GridPaginationModel>>;
+    sortModel: GridSortModel;
+    setSortModel: Dispatch<SetStateAction<GridSortModel>>;
+    filterModel: MyGridFilterModel;
+    setFilterModel: Dispatch<SetStateAction<MyGridFilterModel>>;
+    columnVisibilityModel: GridColumnVisibilityModel;
+    setColumnVisibilityModel: Dispatch<SetStateAction<GridColumnVisibilityModel>>;
+    rowSelectionModel: GridRowSelectionModel;
+    setRowSelectionModel: Dispatch<SetStateAction<GridRowSelectionModel>>;
+    /** Debounced quick-search setter. Cancelled on unmount. */
+    setQuickSearchValue: DebouncedFunc<(value: string) => void>;
+    /** Toolbar collapse, hoisted here so shortcuts can reopen a collapsed toolbar. */
+    toolbarExpanded: boolean;
+    setToolbarExpanded: Dispatch<SetStateAction<boolean>>;
     /**
-     * Full `ServerGrid_v2` configuration (pathname, api, dataGridProps, slotProps, ref), with
-     * one twist: `api.edit` here is the drawer's edit *mode* — a toolbar toggle that makes a
-     * row click open the drawer already editing — not in-grid row editing. It takes no
-     * mutation and no columns, because everything that writes goes through the drawer form.
+     * Whether the filter panel is showing. Up here rather than in the toolbar because the
+     * docked panel is a sibling of the grid, not a child of the button that opens it — and
+     * because Ctrl+Shift+F has to reach it from a collapsed toolbar either way.
      */
-    grid: Omit<ServerGridProps, "api" | "ref"> & {
-        api: Omit<ServerGridProps["api"], "edit" | "editToggle"> & {
-            edit?: DrawerGridEditConfig;
-        };
-        ref?: RefObject<any>;
-    };
-    drawer: DrawerGridDrawerConfig;
+    filtersOpen: boolean;
+    setFiltersOpen: Dispatch<SetStateAction<boolean>>;
+    /** Exactly what was last sent to the server. Also feeds the CSV export. */
+    args: ServerGridArgs;
+    refetch: () => void;
+    subscribeRows: (callback: (snapshot: RowsSnapshot) => void) => () => void;
 }
 /**
- * A `ServerGrid_v2` whose rows and create button open a `DetailFormDrawer_v2` instead of
- * navigating to a full page — without giving up the full-page routes.
- *
- * The panel floats over the page by default. `drawer.variant: "docked"` gives it its own
- * space at the side instead, shrinking the app so the grid stays visible next to the
- * record; read that prop before switching, the two differ in more than looks.
- *
- * A row click and the create menu's "Manual" option both open the drawer; Ctrl/Cmd+click still opens the full
- * page in a new tab, Alt+click opens it in the same tab, and the record drawer carries an
- * "open full page" button — so the routes stay reachable either way. Grids whose rows have
- * no route of their own turn all three off with `drawer.showOpenFullPage: false`.
- *
- * A record drawer also carries a footer navigator: arrows (and Alt+↑ / Alt+↓) that walk the
- * grid's rows in their displayed order, position counter included, so reviewing a list no
- * longer means closing the drawer and clicking the next row. Stepping off either end of the
- * page turns the grid's own page instead of stopping, so the walk covers every row behind
- * the current filters — not just the ones on screen. Turn it off with
- * `drawer.showNavigator: false`.
- *
- * Editing a list that way gets a third footer button, "Guardar ↓" / Alt+Shift+↓ (rename it
- * with `drawer.labels.saveAndNext`): it saves and steps to the next row instead of closing,
- * carrying the edit mode over, so capturing a column across many rows is one pass rather than
- * open-edit-save-reopen per row — and with the shortcut, without leaving the keyboard. It
- * rides on the navigator — no navigator, or last row, and there is just Guardar.
- *
- * `drawer.keepOpenOnSave` hace que Guardar no cierre: el registro se queda en pantalla y
- * editando. Vale la pena donde el cajón lleva su propia grilla adentro —cerrarlo se lleva
- * también lo que se estaba capturando ahí— o donde el registro se llena en varias pasadas.
- *
- * Edit mode is opt-in with `api.edit: {}` and adds nothing to the grid but a toolbar toggle —
- * no mutation, no actions column, no in-grid editing. While it's on, a row click opens the
- * record drawer already editing, provided the record allows it; the drawer form is the only
- * thing that writes. A grid embedded in a detail form can hand the mode over instead, with
- * `api.edit: { active: pageType === "edit" }`, so it follows the form rather than asking for
- * a second switch.
+ * Everything a server-mode grid needs to hold: the models the user drives, the persisted
+ * state they start from, and the lazy query that keeps rows in step with them. Renders
+ * nothing — `ServerGrid` supplies it through context, and pages that need a shape the grid
+ * doesn't offer can drive their own `DataGrid` from it.
+ */
+declare function useServerGrid(options: UseServerGridOptions): ServerGridState;
+
+interface ComposeGridPropsInput {
+    /** The grid's own baseline — slots, locale, density. */
+    defaults: Partial<MyDataGridProps>;
+    layers: GridLayerMap;
+    /** `props.dataGridProps`, straight from the page. */
+    consumer?: Partial<MyDataGridProps>;
+}
+/**
+ * Flattens the grid defaults, every mounted layer and the consumer's own props into one
+ * `DataGrid` prop object.
  *
- * The full grid config goes under `grid` (`{ pathname, api, dataGridProps, slotProps }`),
- * alongside `drawer`.
+ * Precedence, low to high:
+ *   1. grid defaults
+ *   2. layer `defaults`, in `LAYER_ORDER`
+ *   3. the consumer's `dataGridProps`
+ *   4. layer `overrides`, in `LAYER_ORDER`
  *
- * Composition only: the grid stays drawer-agnostic (its `onRowClick`, `onManualCreate` and
- * `onEditModeChange` are generic passthroughs), and the navigator reaches it through the
- * public `ServerGridHandle` rather than MUI's internal state.
+ * Tier 4 sits above the consumer on purpose — a layer must be able to force the grid into a
+ * coherent state while its mode is on (no checkboxes and no row navigation while rows are
+ * being deleted). It is only ever allowed to publish mode-*on* values there; see
+ * `GridLayerContribution.overrides`.
  */
-declare function DrawerGrid({ grid, drawer }: DrawerGridProps): react_jsx_runtime.JSX.Element;
+declare function composeGridProps({ defaults, layers, consumer, }: ComposeGridPropsInput): Partial<MyDataGridProps>;
 
-interface ConfirmDialogProps {
-    open: boolean;
-    titulo: string;
-    mensaje: ReactNode;
-    confirmLabel?: string;
-    cancelLabel?: string;
-    confirmColor?: "primary" | "secondary" | "error" | "warning" | "info" | "success";
-    confirmIcon?: ReactNode;
-    isLoading?: boolean;
-    onConfirm: () => void;
-    onClose: () => void;
+/**
+ * Columns the user is allowed to hide.
+ *
+ * v1 excluded `"actions"` by *field*, but that is a column **type** — the real action columns
+ * are `edit` and `delete`, so both showed up in the columns panel and could be hidden (and
+ * persisted hidden) out from under the layer that owns them. Matched on both here.
+ */
+declare const togglableFields: (columns?: readonly GridColDef[]) => string[];
+interface ResolvedGridState {
+    paginationModel: GridPaginationModel;
+    sortModel: GridSortModel;
+    filterModel: MyGridFilterModel;
+    columnVisibilityModel: GridColumnVisibilityModel;
 }
-/** Diálogo de confirmación genérico: título, mensaje y un par de acciones. El botón de
- *  confirmar puede mostrar estado de carga mientras se resuelve la acción. */
-declare function ConfirmDialog({ open, titulo, mensaje, confirmLabel, cancelLabel, confirmColor, confirmIcon, isLoading, onConfirm, onClose, }: ConfirmDialogProps): react_jsx_runtime.JSX.Element;
-
-interface PulseDotProps {
-    /** Cuando es `true`, el punto es verde y parpadea; si no, usa `inactiveColor`. */
-    active: boolean;
-    /** Color cuando no está activo. Por defecto `error.main`. */
-    inactiveColor?: string;
-    /** Tamaño del punto en px. Por defecto 10. */
-    size?: number;
-    /** Título opcional; si se pasa, envuelve el punto en un Tooltip. */
-    title?: ReactNode;
+interface ResolveInitialStateInput {
+    storageKey: string;
+    /** `slotProps.dontSaveState` — skip the session store entirely. */
+    disabled?: boolean;
+    initialState?: MyDataGridProps["initialState"];
+    columns?: readonly GridColDef[];
 }
-/** Punto de estado: verde con animación de parpadeo cuando está activo, de lo
- *  contrario un color fijo. Se usa para indicar conexión/actividad en vivo. */
-declare function PulseDot({ active, inactiveColor, size, title }: PulseDotProps): react_jsx_runtime.JSX.Element;
-
 /**
- * El contenedor que declara todo renglón que lleve un título y sus adornos: el encabezado de
- * una página, el de un cajón y el de un diálogo.
+ * Works out the state a grid starts in, from what the session remembers and what the page
+ * declared. The only place that precedence lives.
  *
- * Se llama igual en los tres a propósito. Lo que aterriza en ese renglón —el estado de un
- * registro, una barra de acciones— tiene que encogerse cuando el renglón se queda corto, y con
- * un solo nombre esa regla se escribe una vez y sirve en los tres sitios: cada cosa mide contra
- * el renglón que la contiene, que en una página es el ancho de la página y en un cajón de 460px
- * es el del cajón. Los breakpoints del viewport no sabrían distinguirlos —la pantalla es la
- * misma— y `@container` sí.
+ * Pagination, sorting and column visibility prefer the **session**: those are the user's own
+ * choices and should survive navigating away and back.
  *
- * No se pisan entre ellos aunque compartan nombre: un cajón y un diálogo se pintan por portal,
- * fuera del árbol de la página, así que nunca hay uno dentro de otro. Y si lo hubiera, una
- * `@container` resuelve contra el contenedor ancestro más cercano, que es justo el que manda.
+ * Filters are the exception — the page's `initialState.filters` wins, key by key. Those
+ * express scoping ("this embarque's recibos"), not preference, and in v1 the session beat
+ * them outright, so a grid opened on record B kept showing record A's rows for the rest of
+ * the session. Pages worked around it by repeating the same filter in `api.data.args`; they
+ * no longer have to. A user-set filter on any *other* key still survives.
  */
-declare const HEADER_CONTAINER = "acv-header";
+declare function resolveInitialState({ storageKey, disabled, initialState, columns, }: ResolveInitialStateInput): ResolvedGridState;
+
 /**
- * Debajo de este ancho el renglón se considera angosto y lo que viva en él debería encogerse:
- * la insignia de estado, por ejemplo, se queda en un punto de color con el rótulo en el globo.
- *
- * Se escribe como regla y no como número suelto para que quien la use no tenga que rearmar la
- * consulta —ni equivocarse al hacerlo—:
+ * Page sizes offered by the grid and by the pagination slot. One list: in v1 the grid and
+ * `CustomPagination` each declared their own copy and had to be kept in sync by hand.
  *
- *     sx={{ [HEADER_NARROW]: { display: "none" } }}
+ * `-1` is "all" — the backends read that literal and return the whole result set with
+ * `next`/`previous` null but a correct `count`. Only its label is translated; the value is wire
+ * protocol and never changes.
  */
-declare const HEADER_NARROW = "@container acv-header (max-width: 600px)";
+declare const pageSizeOptions: (etiquetaTodos: string) => (number | {
+    value: number;
+    label: string;
+})[];
+declare const DEFAULT_PAGINATION: GridPaginationModel;
 /**
- * Convierte un renglón en el contenedor contra el que se miden sus adornos.
- *
- * `inline-size`, nunca `size`: contener también el eje de bloque le fijaría la altura al
- * encabezado, que crece con lo que lleva dentro —un subtítulo, un título en dos renglones—.
+ * The order layer contributions are applied in — columns, toolbar buttons and prop overrides
+ * alike. Declared here so it never depends on how the layers happen to nest, which is what
+ * made the delete column's position accidental in v1.
  */
-declare const headerContainerSx: CSSObject;
+declare const LAYER_ORDER: readonly GridLayerId[];
 
+interface DeleteGridColumnsProps {
+    displayDelete?: boolean;
+    handleOpen: (id: GridRowId) => () => void;
+    /**
+     * Rótulo de la columna y de la acción. Es un parámetro y no un `useTextos()` porque esto no
+     * es un componente: lo llama la capa de borrado, que sí es la que tiene el idioma a mano.
+     * El default en español mantiene andando a quien la llame sin pasarlo.
+     */
+    etiqueta?: string;
+}
 /**
- * Cómo se está dibujando la barra. En orden de lo que ocupa: las acciones a la vista con su
- * etiqueta, las mismas sólo con el icono, sólo las fijadas, o ninguna.
- *
- * El modo dice qué se dibuja *fuera* del menú; lo que quede fuera de eso —y lo que sobre del
- * tope de `maxVisible`— está siempre dentro de él, así que hasta en `"full"` puede haber menú.
+ * The per-row delete action, shown only while delete mode is on.
  *
- * `"pinned"` sólo es un escalón cuando hay alguna acción fijada; sin ellas la barra pasa de
- * `"icons"` derecho a `"menu"`.
+ * v1 left `type` off, so the column defaulted to `string`: sortable by a user, and offered in
+ * the filters panel as an "Eliminar" text filter that meant nothing. Declaring `type: "actions"`
+ * fixes both — but it has to come with `getActions` rather than `renderCell`, because an
+ * explicit `renderCell` beats the actions type's own cell and takes its keyboard handling and
+ * overflow menu with it.
  */
-declare const RESPONSIVE_ACTION_MODES: readonly ["full", "icons", "pinned", "menu"];
-type ResponsiveActionsMode = (typeof RESPONSIVE_ACTION_MODES)[number];
-interface ResponsiveAction {
-    /** Texto del botón; también lo que se lee en el menú y en el tooltip del modo icono. */
-    label: string;
-    /** Se dibuja como `startIcon`, como el botón entero, o a la izquierda del renglón del menú. */
-    icon: ReactNode;
-    onClick: () => void;
-    /** Ayuda larga. Sustituye a `label` como tooltip —el modo icono siempre lleva uno. */
-    tooltip?: string;
+declare const deleteColumn: (props: DeleteGridColumnsProps) => GridColDefPropsOverrides[];
+
+interface DetailFormDrawerNavigation {
+    /** Open the previous record of the list the drawer is walking. */
+    onPrev: () => void;
+    onNext: () => void;
+    /** Whether a previous/next record exists. The arrows are disabled when it doesn't. */
+    hasPrev: boolean;
+    hasNext: boolean;
+    /** 1-based position of the current record, shown between the arrows. */
+    position?: number;
+    /** Size of the list; shown as `position / count`. */
+    count?: number;
+    /** Blocks both arrows for a caller-side reason (e.g. while the next batch loads). */
     disabled?: boolean;
-    /** Spinner en lugar del icono, y la acción bloqueada mientras tanto. */
-    loading?: boolean;
-    /** También tiñe el renglón del menú, para que la acción se vea igual se dibuje como se dibuje. */
-    color?: ButtonProps["color"];
+}
+interface DetailFormDrawerProps {
+    open: boolean;
+    /** Close the drawer. Also invoked after a successful save and on cancel. */
+    onClose: () => void;
+    title?: ReactNode;
+    api: DetailFormApi;
+    form: DetailFormConfig["form"];
+    sections: DetailFormConfig["sections"];
+    /** Defaults to `"create"`. */
+    pageType?: PageType;
     /**
-     * La última en esconderse: cuando el renglón deja de dar para todas, esta se queda a la vista
-     * —como icono— y las demás se van al menú. Es para la que se usa siempre (editar, en una
-     * ficha); fijar media barra no sirve de mucho, porque entonces ese escalón acaba pesando casi
-     * lo mismo que el anterior y se salta solo.
+     * Open a `"detail"` drawer straight in edit mode, as if the user had hit the Editar
+     * button. Ignored for the other page types, and for records the user may not edit.
      */
-    pinned?: boolean;
-}
-interface ResponsiveActionsProps {
-    actions: ResponsiveAction[];
+    startInEdit?: boolean;
     /**
-     * Cuántas acciones se dibujan como botón, como mucho. Las demás se van al menú desde el
-     * primer modo, quepan o no: es un tope de cuántas *merecen* estar a la vista, no de cuántas
-     * caben —de eso ya se encarga la medición—. Sin él salen todas.
+     * Identity of the record on show. Swapping it (as the navigator does, without remounting
+     * the drawer) re-derives the per-record chrome — the in-place edit toggle drops back to
+     * read-only and `startInEdit` is re-applied against the new record's own permissions.
+     */
+    recordKey?: string | number;
+    permissionsPath?: string;
+    /** Runs after a successful mutation, before the drawer closes. Receives the response. */
+    onSuccess?: (response: any) => void;
+    /**
+     * Guardar deja el cajón abierto —y editando— en vez de cerrarlo. El usuario lo cierra
+     * cuando termina, con la X o con Cancelar.
      *
-     * Se queda con las primeras, así que el orden manda: lo importante va delante. Fijar una
-     * acción (`pinned`) no la adelanta, sólo la hace la última en esconderse.
+     * Para registros que se capturan de a poco, o que llevan dentro su propia grilla editable:
+     * ahí cerrar al guardar cuesta reabrir el registro, volver a entrar a editar y volver a
+     * bajar hasta donde se iba. El caso que lo pide es un cajón anidado —una orden de envío
+     * abierta desde la pestaña de su embarque, con la grilla de sus recibos adentro—, donde el
+     * cierre además se lleva la grilla de en medio.
+     *
+     * Un guardado que **no** guardó igual cierra: `useMutationHandler` corre su `onSuccess` sin
+     * respuesta ante un 403 para quitar la pantalla de en medio, y eso no es algo en lo que
+     * quedarse. Tampoco compite con "Guardar ↓" — ése ya se queda abierto por su cuenta, y
+     * cuando los dos aplican gana el paso al siguiente registro, que es lo que se pidió.
      */
-    maxVisible?: number;
-    /** @default "small" */
-    size?: "small" | "medium";
-    /** Fija el modo y apaga la medición. Para cuando el ancho no es quien debe decidir. */
-    mode?: ResponsiveActionsMode;
+    keepOpenOnSave?: boolean;
+    /**
+     * Acciones propias del registro —cerrar, revertir, descargar su PDF—, las mismas que
+     * `DetailPage_v2` recibe en `slots.extraButtons` y con la misma forma, para que un registro
+     * traiga sus acciones se abra en su página o en el cajón.
+     *
+     * Van en un menú "⋮" de la cabecera —no como iconos sueltos— porque la cabecera del cajón
+     * es angosta y ya carga Editar, Eliminar y lo que venga en `slots.headerActions`; el menú
+     * además las nombra, igual que el de la página completa. Se filtran contra el modo que el
+     * cajón muestra *en ese momento*: entrar a editar esconde las de `"detail"`, como en la
+     * página. `display` y `onClick` reciben el registro cargado.
+     */
+    extraButtons?: DetailExtraButton[];
+    /**
+     * Footer record navigator: prev/next arrows (Alt+↑ / Alt+↓) that step through a list of
+     * sibling records — e.g. the rows of the grid the drawer was opened from — without
+     * closing the drawer. Omit it and no navigator renders.
+     */
+    navigation?: DetailFormDrawerNavigation;
+    /** Panel width. Defaults to `600`. */
+    width?: number | string;
+    /** Side the drawer slides in from. Defaults to `"right"`. */
+    anchor?: DrawerProps["anchor"];
+    /**
+     * `"temporary"` (the default) floats over the page. `"docked"` takes its own space at
+     * the side of the screen and shrinks the app instead of covering it, so the page behind
+     * stays usable — see `MainDrawer_v2`.
+     *
+     * Docked drops the modal: nothing stops the user from touching the page while the form
+     * is open, so a drawer that guards unsaved edits behind the backdrop no longer does.
+     */
+    variant?: MainDrawerV2Props["variant"];
+    /**
+     * Let the user drag the drawer's inner edge to resize it. Forwarded to `MainDrawer_v2`
+     * along with the four props below — see it for the full behaviour.
+     */
+    resizable?: boolean;
+    /** Smallest width the drag allows, in px. Defaults to `320`. */
+    minWidth?: number;
+    /** Largest width the drag allows, in px. Defaults to the viewport minus a margin. */
+    maxWidth?: number;
+    /**
+     * Remember the dragged width under this `localStorage` key. Worth setting whenever the
+     * drawer is remounted per record — a fresh mount otherwise forgets the drag.
+     */
+    widthStorageKey?: string;
+    /** Fires with the final dragged width in px, or `null` when a double click resets it. */
+    onWidthChange?: (width: number | null) => void;
+    /**
+     * What the `size` breakpoints of the fields — and of the subsections themselves — resolve
+     * against. Defaults to `"container"`: a drawer is narrow by construction, so viewport
+     * breakpoints would pick the wide-screen value and cram the fields — and they would not
+     * react to a drag either.
+     * @see DetailFormProps.responsiveTo
+     */
+    responsiveTo?: DetailFormProps["responsiveTo"];
+    /** @see DetailFormProps.containerBreakpoints */
+    containerBreakpoints?: DetailFormProps["containerBreakpoints"];
+    labels?: {
+        save?: string;
+        cancel?: string;
+        /**
+         * Rótulo del guardar-y-seguir. Por defecto `"Guardar ↓"`, corto porque va junto al
+         * Guardar de siempre y el tooltip ya dice qué hace; pásale un texto propio donde el
+         * paso al siguiente registro merezca nombrarse ("Guardar y siguiente bulto").
+         */
+        saveAndNext?: string;
+    };
+    slots?: {
+        /**
+         * Ruta al estado del registro —`"estado"`—, la misma que recibe `DetailPage_v2`: se
+         * pinta junto al título, como en la página, y con el mismo mapa de colores.
+         *
+         * @see DetailPageV2Props.slots.badge
+         */
+        badge?: string;
+        /** Extra actions rendered in the header, left of the close button (e.g. "open full page"). */
+        headerActions?: ReactNode;
+    };
+    slotProps?: {
+        drawer?: Partial<DrawerProps>;
+        saveButton?: Partial<ButtonProps>;
+        cancelButton?: Partial<ButtonProps>;
+        saveAndNextButton?: Partial<ButtonProps>;
+        /** @see DetailPageV2Props.slotProps.badge */
+        badge?: {
+            colors?: Record<string, StatusColor>;
+            /** @see DetailPageV2Props.slotProps.badge.options */
+            options?: ChipOption[];
+        };
+    };
 }
 /**
- * Una barra de acciones que se encoge sola cuando deja de caber: primero pierde las etiquetas y
- * se queda en iconos, después esconde en un menú de tres puntos todo menos lo fijado, y al final
- * se mete ahí entera.
- *
- * Encogerse es cosa del ancho; cuántas acciones merecen un botón, no. Para eso está `maxVisible`,
- * que manda al menú lo que pase de la cuenta aunque sobre sitio —una barra de ocho botones cabe
- * en una pantalla ancha y aun así no hay quien la lea—.
- *
- * Mide, no adivina. Los breakpoints del viewport no sirven aquí —la misma barra vive en una
- * página ancha y en un cajón de 460px, donde la pantalla es grande y el hueco no—, así que
- * compara el ancho que le dejaron con el que sus botones piden y baja un escalón cuando no
- * alcanza. Es el mismo motivo por el que el layout de los campos resuelve por `@container`.
+ * A record form inside a side drawer. Reuses the same `useDetailForm` engine and
+ * `DetailForm` body as `DetailPage_v2`, and `MainDrawer_v2` for the chrome — so it frames
+ * the form exactly like every other v2 drawer. What it adds on top is the per-record
+ * furniture: edit/delete in the header — plus the record's own actions, when the consumer
+ * hands them over in `extraButtons`, in a "⋮" menu beside them — and a footer holding the
+ * form actions and, when
+ * `navigation` is given, a prev/next record navigator (Alt+↑ / Alt+↓) plus "Guardar ↓"
+ * (Alt+Shift+↓) — a save that steps to the next record instead of closing, so a column can be
+ * captured down a list in one pass without the hands leaving the keyboard. Rename it with
+ * `labels.saveAndNext`. Guardar sits outside the `<form>` and submits via the native
+ * `form={formId}` attribute; Guardar ↓ submits by hand, so the implicit Enter stays Guardar.
  *
- * Para que la medición signifique algo, el padre tiene que ser un renglón flex que le deje
- * crecer al sobrante: la raíz se estira (`flexGrow`) para que su ancho *sea* el hueco, y los
- * botones van dentro sin encogerse, así que su ancho es lo que piden de verdad.
+ * `keepOpenOnSave` cambia lo que hace Guardar cuando no hay a dónde avanzar: en vez de cerrar,
+ * deja el registro en pantalla y editando — para formularios que se capturan de a poco o que
+ * llevan una grilla adentro.
  */
-declare const ResponsiveActions: ({ actions, maxVisible, size, mode: forcedMode, }: ResponsiveActionsProps) => react_jsx_runtime.JSX.Element | null;
+declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, permissionsPath, onSuccess, keepOpenOnSave, extraButtons, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
 
-interface DetailActionsProps {
+interface DrawerGridDrawerConfig {
+    /** Shared field layout, used by every mode. Same shape as `DetailPage_v2`'s `form`/`sections`. */
+    form: DetailFormConfig["form"];
+    sections: DetailFormConfig["sections"];
+    permissionsPath?: string;
+    /** Panel width. Defaults to the drawer's own default (600). */
+    width?: number | string;
     /**
-     * Editar. Va fijada, así que es la última en irse al menú cuando el renglón se estrecha: es
-     * la acción de siempre en una ficha, y la que se busca sin leer. Se lleva consigo el Ctrl+E
-     * que vivía en `EditButton`, el botón suelto que esta barra vino a sustituir.
+     * How the panel sits on the screen. Defaults to `"temporary"`: it floats over the page,
+     * modal, the way it always has.
+     *
+     * `"docked"` gives it its own space at the side and shrinks the app instead of covering
+     * it, so the grid stays visible next to the record. Worth it where the row and the list
+     * are read together; it costs two things, both from dropping the modal:
+     *
+     * - Nothing stops the user from re-sorting, filtering or paging the grid while the
+     *   drawer is open, and the footer navigator walks the rows it sampled when the record
+     *   opened. It stays on the list the user was reading, which is usually what's wanted,
+     *   but it can no longer claim to match what's on screen.
+     * - Unsaved edits are no longer fenced off by the backdrop.
      */
-    edit?: {
-        onClick: () => void;
+    variant?: DetailFormDrawerProps["variant"];
+    /**
+     * Let the user drag the drawer's inner edge to resize it. The dragged width is remembered
+     * across openings under a key derived from the grid's own storage key — override it with
+     * `widthStorageKey`, or turn the memory off by passing an empty string.
+     */
+    resizable?: boolean;
+    /** Smallest width the drag allows, in px. Defaults to `320`. */
+    minWidth?: number;
+    /** Largest width the drag allows, in px. Defaults to the viewport minus a margin. */
+    maxWidth?: number;
+    /** Where the dragged width is remembered. Defaults to the grid's storage key + `_DW`. */
+    widthStorageKey?: string;
+    /**
+     * What the fields' `size` breakpoints resolve against. Defaults to `"container"` — the
+     * width of the panel, not of the screen.
+     * @see DetailFormDrawerProps.responsiveTo
+     */
+    responsiveTo?: DetailFormDrawerProps["responsiveTo"];
+    /** @see DetailFormDrawerProps.containerBreakpoints */
+    containerBreakpoints?: DetailFormDrawerProps["containerBreakpoints"];
+    title?: {
+        create?: ReactNode;
+        record?: ReactNode | ((id: GridRowId) => ReactNode);
     };
-    delete?: {
+    /** Create-mode API (opened by the "Quick create" menu option). */
+    create: {
         mutation: any;
-        disableNavBack?: boolean;
+        /** Defaults to `"create"`. */
+        pageType?: PageType;
+        successMessage?: string | ((response: any) => string);
     };
-    historial?: {
-        endpoint?: string;
-        /** Defaults to `"docked"` — the panel takes its own space beside the page. */
-        variant?: _HistorialDrawerProps["variant"];
-        /** Panel width in px. Defaults to 600. */
-        width?: number | string;
+    /** Record-mode API (opened by a row click). */
+    record: {
+        /** Single-record query hook, called with `{ id, ...args(id) }`. */
+        query: any;
+        mutation: any;
+        /**
+         * Defaults to `"detail"` (read-only), matching a row-click. Use `"edit"` for an always
+         * editable drawer — a `"detail"` drawer already opens editing while the grid itself is
+         * in edit mode.
+         */
+        pageType?: PageType;
+        successMessage?: string | ((response: any) => string);
+        /** Extra query args merged with `{ id }`. */
+        args?: (id: GridRowId) => Record<string, any>;
+        /** Optional delete mutation. When set and the user has delete permission, a delete button appears in the drawer header. */
+        delete?: {
+            mutation: any;
+        };
     };
-    extraButtons?: {
-        title: string;
-        icon: ReactNode;
-        onClick: () => void;
-    }[];
-    /** Tamaño de los botones. `"small"` para las cabeceras del cajón. */
-    size?: "small" | "medium";
     /**
-     * Fija cómo se dibuja la barra en vez de dejar que se mida. El cajón lo usa para quedarse
-     * siempre en el menú de tres puntos: su cabecera ya lleva sus propios botones al lado.
-     * @see ResponsiveActionsProps.mode
+     * Acciones propias del registro —las mismas que su página completa recibe en
+     * `DetailPage_v2`'s `slots.extraButtons`, y con la misma forma—, en un menú "⋮" de la
+     * cabecera del cajón. Se filtran por modo y por `display(registro)`, así que las de la
+     * página se pasan tal cual: abrir el renglón en el cajón deja de ser una versión recortada
+     * de abrirlo en su página.
      */
-    mode?: ResponsiveActionsMode;
-}
-
-interface DetailPageV2Props {
-    api: DetailFormApi;
-    form: DetailFormConfig["form"];
-    sections: DetailFormConfig["sections"];
-    pageType: PageType;
+    extraButtons?: DetailExtraButton[];
     /**
-     * What the `size` breakpoints of the fields — and of the subsections themselves — resolve
-     * against. Defaults to `"container"`: the width of the form, not of the screen.
+     * El estado del registro, junto al título de la cabecera del cajón —igual que en su página
+     * completa—. `path` es la ruta al campo dentro del dato, que el backend manda como
+     * `{ value, label }`, y `colors` dice de qué color va cada código:
      *
-     * A full page is no longer the whole viewport minus the sidebar — a docked side panel
-     * takes its share of it — so the screen stopped being a good proxy for how much room
-     * the fields actually have. Against the form they re-flow as that room changes, with
-     * no re-render: the breakpoint ladder is CSS.
+     *     badge: { path: "estado", colors: { "1": "warning", "2": "info" } }
      *
-     * `"viewport"` restores MUI's own behaviour for a page that needs it.
-     * @see DetailFormProps.responsiveTo
+     * `colors` es el mismo mapa que recibe `renderChipCell`, así que lo natural es declararlo
+     * junto al catálogo y pasárselo a los dos: el estado se ve igual en la columna de la tabla
+     * que en el cajón que abre esa misma fila.
+     *
+     * @see DetailPageV2Props.slots.badge
      */
-    responsiveTo?: DetailFormProps["responsiveTo"];
-    /** @see DetailFormProps.containerBreakpoints */
-    containerBreakpoints?: DetailFormProps["containerBreakpoints"];
+    badge?: {
+        path: string;
+        colors?: Record<string, StatusColor>;
+        /**
+         * Los estados con su rótulo, para poder mostrarlo en otro idioma.
+         * @see DetailPageV2Props.slotProps.badge.options
+         */
+        options?: ChipOption[];
+    };
+    /** Runs after any successful create/edit (e.g. side effects; the grid refetches via RTK tag invalidation). */
+    onSaved?: (response: any) => void;
     /**
-     * Deja el renglón del título —con el estado y la barra de acciones— pegado al tope mientras
-     * se scrollea la ficha. Las migas se recogen al llegar arriba, así que lo que se queda es
-     * sólo lo que hace falta tener a la mano.
+     * Whether these records have a full page of their own. Defaults to `true`.
      *
-     * Encendido por defecto: una ficha es larga y sus acciones viven arriba, así que sin esto
-     * editar o abrir el historial obliga a volver al principio. Vale igual capturando —ahí lo
-     * que queda a la mano es Guardar y Cancelar—, que es la otra mitad del mismo problema.
+     * Set it to `false` for rows that exist only inside their parent and have no route —
+     * it drops the drawer header's "open full page" button *and* the Ctrl/Alt+click
+     * shortcuts, which would otherwise navigate to a route that isn't registered.
+     */
+    showOpenFullPage?: boolean;
+    /**
+     * Show the footer navigator that walks the grid's rows — prev/next arrows plus the
+     * record's position — in the record drawer. Defaults to `true`.
      *
-     * Apagarlo tiene sentido en una ficha corta, donde el encabezado nunca se va. Se ignora
-     * cuando no hay renglón de título donde poner las acciones (pantalla completa, o un
-     * `pageHeader` propio que no lo reserve): ahí vuelven a la esquina flotante de siempre.
-     * @default true
+     * It also gates "Guardar ↓", the save that steps to the next row instead of closing:
+     * without a list to walk there is nothing to continue to.
      */
-    stickyHeader?: boolean;
-    slots?: {
-        button?: ReactNode;
-        /**
-         * Acciones propias del registro, junto a las del armazón. En `"detail"` entran en la
-         * barra de acciones; en alta y edición, como iconos al lado de Guardar.
-         *
-         * Las mismas se le pueden pasar al cajón de `DrawerGrid_v2` (`drawer.extraButtons`),
-         * para que el registro traiga sus acciones se abra donde se abra.
-         */
-        extraButtons?: DetailExtraButton[];
-        /**
-         * Ruta al estado del registro dentro del dato —`"estado"`—, que el backend manda como
-         * `{ value, label }`: se lee la etiqueta y el código decide el color.
-         *
-         * @see DetailPageV2Props.slotProps.badge
-         */
-        badge?: string;
+    showNavigator?: boolean;
+    /**
+     * Guardar deja el cajón abierto y editando en vez de cerrarlo; se cierra con la X o con
+     * Cancelar. Para registros que se capturan de a poco, o que llevan su propia grilla
+     * editable adentro y perderían el lugar al cerrarse.
+     *
+     * @see DetailFormDrawerProps.keepOpenOnSave
+     */
+    keepOpenOnSave?: boolean;
+    /** Rótulos del pie del cajón. `saveAndNext` por defecto es `"Guardar ↓"`. */
+    labels?: {
+        save?: string;
+        cancel?: string;
+        saveAndNext?: string;
     };
-    slotProps?: {
-        button?: {
-            save?: {
-                type: "onClick";
-                disableNavBack?: boolean;
-                onClick?: () => void;
-            };
-            cancel?: Partial<ButtonProps>;
-        };
-        /**
-         * The history panel opened from the actions bar. It docks beside the page rather
-         * than floating over it, so the record stays readable next to what the history says
-         * about it — see `DetailActionsProps.historial` for how to change that.
-         */
-        historial?: DetailActionsProps["historial"];
-        permissionsPath?: string;
-        deleteButton?: {
-            disableNavBack?: boolean;
-        };
-        badge?: {
-            /**
-             * De qué color se pinta cada estado, por código:
-             *
-             *     colors: { "1": "warning", "2": "info", "3": "success" }
-             *
-             * Es el mismo mapa que recibe `renderChipCell` en las columnas de una tabla, así que
-             * lo natural es declararlo junto al catálogo y pasarlo a los dos: el estado "2" se ve
-             * igual en la lista que en la ficha.
-             *
-             * Sin mapa la insignia queda neutra —gris—, que es como se veían todos antes de que
-             * hubiera con qué distinguirlos.
-             */
-            colors?: Record<string, StatusColor>;
-            /**
-             * Los estados con su rótulo, para poder mostrarlo en otro idioma.
-             *
-             * Es el mismo `ChipOption[]` que reciben las columnas de la tabla, y se resuelve
-             * igual (`resolveChipOption`), así que la ficha y la lista nombran el estado con la
-             * misma palabra. Sin esto, la insignia sólo puede repetir lo que mandó el backend,
-             * que viene en español (`get_estado_display`).
-             *
-             * Ojo con traducir el `label` de una opción: casi todos estos endpoints mandan la
-             * etiqueta y no el código, así que el emparejado real es contra el texto en español
-             * — para eso está `ChipOption.match`.
-             */
-            options?: ChipOption[];
+}
+interface DrawerGridEditConfig {
+    /** Hides the toggle (and its shortcuts) without touching permissions. */
+    disabled?: boolean;
+    /**
+     * Drives edit mode from outside instead of leaving it to the toolbar toggle — pass the
+     * edit state of the form this grid is embedded in and a row click follows it, opening the
+     * drawer already editing without the user flipping a second switch. The toolbar button
+     * disappears while it's set, and it stays fail-closed against the model's permission.
+     */
+    active?: boolean;
+}
+interface DrawerGridProps {
+    /**
+     * Full `ServerGrid_v2` configuration (pathname, api, dataGridProps, slotProps, ref), with
+     * one twist: `api.edit` here is the drawer's edit *mode* — a toolbar toggle that makes a
+     * row click open the drawer already editing — not in-grid row editing. It takes no
+     * mutation and no columns, because everything that writes goes through the drawer form.
+     */
+    grid: Omit<ServerGridProps, "api" | "ref"> & {
+        api: Omit<ServerGridProps["api"], "edit" | "editToggle"> & {
+            edit?: DrawerGridEditConfig;
         };
+        ref?: RefObject<any>;
     };
+    drawer: DrawerGridDrawerConfig;
 }
-declare function DetailPage(props: DetailPageV2Props): react_jsx_runtime.JSX.Element;
+/**
+ * A `ServerGrid_v2` whose rows and create button open a `DetailFormDrawer_v2` instead of
+ * navigating to a full page — without giving up the full-page routes.
+ *
+ * The panel floats over the page by default. `drawer.variant: "docked"` gives it its own
+ * space at the side instead, shrinking the app so the grid stays visible next to the
+ * record; read that prop before switching, the two differ in more than looks.
+ *
+ * A row click and the create menu's "Manual" option both open the drawer; Ctrl/Cmd+click still opens the full
+ * page in a new tab, Alt+click opens it in the same tab, and the record drawer carries an
+ * "open full page" button — so the routes stay reachable either way. Grids whose rows have
+ * no route of their own turn all three off with `drawer.showOpenFullPage: false`.
+ *
+ * A record drawer also carries a footer navigator: arrows (and Alt+↑ / Alt+↓) that walk the
+ * grid's rows in their displayed order, position counter included, so reviewing a list no
+ * longer means closing the drawer and clicking the next row. Stepping off either end of the
+ * page turns the grid's own page instead of stopping, so the walk covers every row behind
+ * the current filters — not just the ones on screen. Turn it off with
+ * `drawer.showNavigator: false`.
+ *
+ * Editing a list that way gets a third footer button, "Guardar ↓" / Alt+Shift+↓ (rename it
+ * with `drawer.labels.saveAndNext`): it saves and steps to the next row instead of closing,
+ * carrying the edit mode over, so capturing a column across many rows is one pass rather than
+ * open-edit-save-reopen per row — and with the shortcut, without leaving the keyboard. It
+ * rides on the navigator — no navigator, or last row, and there is just Guardar.
+ *
+ * `drawer.keepOpenOnSave` hace que Guardar no cierre: el registro se queda en pantalla y
+ * editando. Vale la pena donde el cajón lleva su propia grilla adentro —cerrarlo se lleva
+ * también lo que se estaba capturando ahí— o donde el registro se llena en varias pasadas.
+ *
+ * Edit mode is opt-in with `api.edit: {}` and adds nothing to the grid but a toolbar toggle —
+ * no mutation, no actions column, no in-grid editing. While it's on, a row click opens the
+ * record drawer already editing, provided the record allows it; the drawer form is the only
+ * thing that writes. A grid embedded in a detail form can hand the mode over instead, with
+ * `api.edit: { active: pageType === "edit" }`, so it follows the form rather than asking for
+ * a second switch.
+ *
+ * The full grid config goes under `grid` (`{ pathname, api, dataGridProps, slotProps }`),
+ * alongside `drawer`.
+ *
+ * Composition only: the grid stays drawer-agnostic (its `onRowClick`, `onManualCreate` and
+ * `onEditModeChange` are generic passthroughs), and the navigator reaches it through the
+ * public `ServerGridHandle` rather than MUI's internal state.
+ */
+declare function DrawerGrid({ grid, drawer }: DrawerGridProps): react_jsx_runtime.JSX.Element;
+
+interface ConfirmDialogProps {
+    open: boolean;
+    titulo: string;
+    mensaje: ReactNode;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    confirmColor?: "primary" | "secondary" | "error" | "warning" | "info" | "success";
+    confirmIcon?: ReactNode;
+    isLoading?: boolean;
+    onConfirm: () => void;
+    onClose: () => void;
+}
+/** Diálogo de confirmación genérico: título, mensaje y un par de acciones. El botón de
+ *  confirmar puede mostrar estado de carga mientras se resuelve la acción. */
+declare function ConfirmDialog({ open, titulo, mensaje, confirmLabel, cancelLabel, confirmColor, confirmIcon, isLoading, onConfirm, onClose, }: ConfirmDialogProps): react_jsx_runtime.JSX.Element;
 
 interface DetailFormDialogProps {
     open: boolean;
@@ -4398,5 +4644,30 @@ interface UseColorModeResult {
 }
 declare function useColorMode(): UseColorModeResult;
 
-export { APIContext, APIProvider, AccountMenuContent, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, COLOR_SCHEME_SELECTOR, CSVUpload, ChipCell, ConfirmDialog, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, ControlledAutocomplete, ControlledColor, ControlledDate$1 as ControlledDate, ControlledDate as ControlledDate_v2, ControlledDropdown, ControlledFileField$1 as ControlledFileField, ControlledFileField as ControlledFileField_v2, FileUploadBox as ControlledFileUploadBox, ControlledNumber, ControlledPhoneNumber, ControlledSelect$1 as ControlledSelect, ControlledSelect as ControlledSelect_v2, ControlledSlider as ControlledSimpleSlider, ControlledSlider$1 as ControlledSlider, ControlledSwitch, ControlledText, ControlledTimePicker, ControlledToggleButtons, CoverPage, CreateButtonBase, CreateButtonWithMenuOptions, CrudDropdown, CustomNoRows, DEFAULT_FORM_BREAKPOINTS, DEFAULT_PAGINATION, DeleteButton, DeleteConfirmationDialog, DetailFormDialog as DetailFormDialog_v2, DetailFormDrawer as DetailFormDrawer_v2, DetailForm as DetailForm_v2, DetailPage$1 as DetailPage, DetailPage as DetailPage_v2, DrawerGrid as DrawerGrid_v2, EditButton, ExportCSV$1 as ExportCSV, ExportCSV as ExportCSV_v2, ExtraButtons, FORM_CONTAINER_NAME, GlobalSearch, HEADER_CONTAINER, HEADER_NARROW, HistorialDrawer, KpiCard, LAYER_ORDER, ListPage, Loadable, LoadingComponent, LocaleContext, LocaleProvider, Logo, MainDrawer, MainDrawer$1 as MainDrawer_v2, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, NotificationItem, NotificationsBell, ObjectProgressStack, PageActionsHostContext, PageBadgeHostContext, PageInfo, PageInfoHostContext, Panel, PollingCountdownChip, PulseDot, RESPONSIVE_ACTION_MODES, ResponsiveActions, SIDE_PANEL_WIDTH_VAR, SaveCancelButton, ServerGrid as ServerGrid_v2, SidePanelHostContext, StatusBadge, StickyPageHeaderContext, StyledMenu, TEXTOS, Tabs, Transitions, TrueFalse, UncontrolledText, aplicarLocaleDeDayjs, changeTitle, closeProgressSnack, composeGridProps, deleteColumn$1 as deleteColumn, deleteColumn as deleteColumn_v2, editColumn, filterQuery, formContainerSx, formGridSx, formParser, headerContainerSx, _default as headerReducer, localeDeNumeros, localeTextDeMUI, localeTextDeToolpad, manualCacheRefresh, mergeSettings, openProgressSnack, pageSizeOptions, query, renderChipCell, renderEditCellWithErrorTooltip, resolveChipOption, resolveInitialState, resolveStatusColor, setErrors, singularizarPalabra, singularizarTitulo, _default$1 as snackProgressReducer, statusColors, tags, theme, togglableFields, updateProgressSnackData, useAPI, useColorMode, useDetailForm, useHasPermission, useHasPermission_v2, useKeyboardShortcut, useLocale, useMutationHandler, useNavigation, usePageActionsHost, usePageBadgeHost, usePageInfoHost, useServerGrid, useSidePanelHost, useStickyPageHeader, useStickyPageHeaderHost, useTextos, valueLabel };
-export type { APIcontextProps, AccountMenuContentProps, AccountMenuItem, AddressValue, AppTheme, AutocompleteOption, ChipCellProps, ChipColor, ChipOption, ColorMode, ComoOpcionesProps, ConfirmDialogProps, ControlledAutocompleteProps, ControlledInput, CustomFilterDef, CustomToolbarProps, DeleteGridColumnsProps$1 as DeleteGridColumnsProps, DetachedPage, DetailExtraButton, DetailFormApi, DetailFormConfig, DetailFormController, DetailFormDialogProps, DetailFormDrawerNavigation, DetailFormDrawerProps, DetailFormProps, DetailFormStatus, DetailPageV2Props, DetailRenderProps, DrawerGridDrawerConfig, DrawerGridEditConfig, DrawerGridProps, EditGridColumnsProps, EditReadOnlyFields, ExportCSVProps as ExportCSVProps_v2, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, FilterInput, FormBreakpoint, FormGridSxOptions, GlobalSearchOption, GlobalSearchProps, GridArgs, GridColDefPropsOverrides, GridLayerContribution, GridLayerId, GridLayerMap, JSONFormProps, JSONParserProps, KeyboardShortcut, KpiCardProps, Locale, LocaleContextProps, LocaleProviderProps, MainDrawerV2Props, MainLayoutFooterConfig, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, NotificationItemProps, NotificationsApi, NotificationsBellProps, PageActionsHost, PageBadgeHost, PageInfoHost, PageInfoProps, PageType, PanelProps, PollingCountdownChipProps, ProgressStatusProps, PulseDotProps, ResponsiveAction, ResponsiveActionsMode, ResponsiveActionsProps, RowsSnapshot, ServerGridArgs, ServerGridCreateApi, ServerGridDataApi, ServerGridDeleteApi, ServerGridEditApi, ServerGridEditToggleApi, ServerGridHandle, ServerGridProps, ServerGridSnapshot, ServerGridState, SidePanelHost, StatusColor, StickyPageHeaderHost, Textos, UseColorModeResult, UseServerGridOptions };
+/**
+ * El argumento de una mutación que llega envuelto: lo que manda `DetailPage_v2` (y cualquier
+ * formulario que pase por `useMutationHandler`), con el cuerpo en `data` y los argumentos de la
+ * página en `params`.
+ */
+interface MutationArgs<T = any> {
+    data: T;
+    params?: {
+        [k: string]: any;
+    };
+}
+/** El cuerpo de la mutación, venga envuelto o suelto. */
+declare const mutationData: (arg: any) => any;
+/** Los argumentos de la página, si llegaron envueltos. Un renglón suelto no trae. */
+declare const mutationParams: (arg: any) => {
+    [k: string]: any;
+} | undefined;
+/**
+ * El id del registro, que decide entre alta y edición (POST o PATCH).
+ *
+ * De un `FormData` sale con `get("id")`, así que llega como cadena —o `null` si no lo trae—, no
+ * como número.
+ */
+declare const mutationId: (arg: any) => any;
+
+export { APIContext, APIProvider, AccountMenuContent, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, COLOR_SCHEME_SELECTOR, CSVUpload, CatalogoItem, CatalogoList, ChipCell, ConfirmDialog, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, ControlledAutocomplete, ControlledColor, ControlledDate$1 as ControlledDate, ControlledDate as ControlledDate_v2, ControlledDropdown, ControlledFileField$1 as ControlledFileField, ControlledFileField as ControlledFileField_v2, FileUploadBox as ControlledFileUploadBox, ControlledNumber, ControlledPhoneNumber, ControlledSelect$1 as ControlledSelect, ControlledSelect as ControlledSelect_v2, ControlledSlider as ControlledSimpleSlider, ControlledSlider$1 as ControlledSlider, ControlledSwitch, ControlledText, ControlledTimePicker, ControlledToggleButtons, CoverPage, CreateButtonBase, CreateButtonWithMenuOptions, CrudDropdown, CustomNoRows, DEFAULT_FORM_BREAKPOINTS, DEFAULT_PAGINATION, DeleteButton, DeleteConfirmationDialog, DetailFormDialog as DetailFormDialog_v2, DetailFormDrawer as DetailFormDrawer_v2, DetailForm as DetailForm_v2, DetailPage$1 as DetailPage, DetailPage as DetailPage_v2, DrawerGrid as DrawerGrid_v2, EditButton, ExportCSV$1 as ExportCSV, ExportCSV as ExportCSV_v2, ExtraButtons, FORM_CONTAINER_NAME, GlobalSearch, HEADER_CONTAINER, HEADER_NARROW, HistorialDrawer, KpiCard, LAYER_ORDER, ListPage, Loadable, LoadingComponent, LocaleContext, LocaleProvider, Logo, MainDrawer, MainDrawer$1 as MainDrawer_v2, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, NotificationItem, NotificationsBell, ObjectProgressStack, PageActionsHostContext, PageBadgeHostContext, PageInfo, PageInfoHostContext, Panel, PollingCountdownChip, PulseDot, RESPONSIVE_ACTION_MODES, ResponsiveActions, SIDE_PANEL_WIDTH_VAR, SaveCancelButton, ServerGrid as ServerGrid_v2, SidePanelHostContext, StatusBadge, StickyPageHeaderContext, StyledMenu, TEXTOS, Tabs, Transitions, TrueFalse, UncontrolledText, aplicarLocaleDeDayjs, changeTitle, closeProgressSnack, columnasDeCatalogo, composeGridProps, crearFabricaDeCatalogos, deleteColumn$1 as deleteColumn, deleteColumn as deleteColumn_v2, editColumn, filterQuery, formContainerSx, formGridSx, formParser, headerContainerSx, _default as headerReducer, localeDeNumeros, localeTextDeMUI, localeTextDeToolpad, manualCacheRefresh, mergeSettings, mutationData, mutationId, mutationParams, openProgressSnack, pageSizeOptions, query, renderChipCell, renderEditCellWithErrorTooltip, resolveChipOption, resolveInitialState, resolveStatusColor, setErrors, singularizarPalabra, singularizarTitulo, _default$1 as snackProgressReducer, statusColors, tags, theme, togglableFields, updateProgressSnackData, useAPI, useColorMode, useDetailForm, useHasPermission, useHasPermission_v2, useKeyboardShortcut, useLocale, useMutationHandler, useNavigation, usePageActionsHost, usePageBadgeHost, usePageInfoHost, useServerGrid, useSidePanelHost, useStickyPageHeader, useStickyPageHeaderHost, useTextos, valueLabel };
+export type { APIcontextProps, AccountMenuContentProps, AccountMenuItem, AddressValue, AppTheme, AutocompleteOption, CatalogoAPI, CatalogoItemProps, CatalogoListProps, ChipCellProps, ChipColor, ChipOption, ColorMode, ComoOpcionesProps, ConfirmDialogProps, ControlledAutocompleteProps, ControlledInput, CrearCatalogoAPI, CustomFilterDef, CustomToolbarProps, DefinicionDeCatalogo, DeleteGridColumnsProps$1 as DeleteGridColumnsProps, DetachedPage, DetailExtraButton, DetailFormApi, DetailFormConfig, DetailFormController, DetailFormDialogProps, DetailFormDrawerNavigation, DetailFormDrawerProps, DetailFormProps, DetailFormStatus, DetailPageV2Props, DetailRenderProps, DrawerGridDrawerConfig, DrawerGridEditConfig, DrawerGridProps, EditGridColumnsProps, EditReadOnlyFields, ExportCSVProps as ExportCSVProps_v2, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, FilterInput, FormBreakpoint, FormGridSxOptions, GlobalSearchOption, GlobalSearchProps, GridArgs, GridColDefPropsOverrides, GridLayerContribution, GridLayerId, GridLayerMap, InsigniaDeCatalogo, JSONFormProps, JSONParserProps, KeyboardShortcut, KpiCardProps, Locale, LocaleContextProps, LocaleProviderProps, MainDrawerV2Props, MainLayoutFooterConfig, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MutationArgs, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, NotificationItemProps, NotificationsApi, NotificationsBellProps, PageActionsHost, PageBadgeHost, PageInfoHost, PageInfoProps, PageType, PanelProps, PollingCountdownChipProps, ProgressStatusProps, PulseDotProps, ResponsiveAction, ResponsiveActionsMode, ResponsiveActionsProps, RowsSnapshot, ServerGridArgs, ServerGridCreateApi, ServerGridDataApi, ServerGridDeleteApi, ServerGridEditApi, ServerGridEditToggleApi, ServerGridHandle, ServerGridProps, ServerGridSnapshot, ServerGridState, SidePanelHost, StatusColor, StickyPageHeaderHost, Textos, UseColorModeResult, UseServerGridOptions };