@acvl/frontend-components 0.0.63 → 0.0.65

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as _mui_material from '@mui/material';
-import { ButtonProps, ButtonGroupProps, IconButtonProps, MenuItemProps, AlertProps, BoxProps, AutocompleteProps, SliderProps, SwitchProps, GridProps, DrawerProps, MenuProps, PaletteColorOptions, TypographyProps, SxProps, Theme, TextFieldProps as TextFieldProps$1, InputBaseProps, DialogProps, DialogContentProps } from '@mui/material';
+import { ButtonProps, ButtonGroupProps, IconButtonProps, MenuItemProps, AlertProps, 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 from 'react';
 import React__default, { ReactNode, Dispatch, SetStateAction, JSX, RefObject, FC, 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 } from '@mui/x-data-grid';
+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';
@@ -16,6 +16,7 @@ import * as redux from 'redux';
 import * as _reduxjs_toolkit from '@reduxjs/toolkit';
 import * as _emotion_styled from '@emotion/styled';
 import * as _mui_system from '@mui/system';
+import { DebouncedFunc } from 'lodash';
 import { UseFormReturn } from 'react-hook-form';
 import { Breadcrumb, PageHeaderProps, Navigation, Branding, Session, Authentication, DashboardHeaderProps } from '@toolpad/core';
 import { SidebarFooterProps } from '@toolpad/core/DashboardLayout';
@@ -59,7 +60,7 @@ interface CreateButtonBaseProps {
 }
 declare const CreateButtonBase: React__default.FC<CreateButtonBaseProps>;
 
-interface CSVMenuOptionProps$1 {
+interface CSVMenuOptionProps$2 {
     endpoint?: string;
     title?: string;
     custom?: string;
@@ -69,7 +70,7 @@ interface CreateButtonWithMenuOptionsProps {
     permission: boolean;
     csv_upload?: {
         enable: boolean;
-        extraOptions?: CSVMenuOptionProps$1[];
+        extraOptions?: CSVMenuOptionProps$2[];
     };
     pathname: string;
     navigate: any;
@@ -85,7 +86,16 @@ interface ButtonWithDrawerProps {
         drawer: {
             title: string;
             content: (props: any) => JSX.Element;
+            /** Acciones en el encabezado. Sustituyen al botón de cerrar integrado. */
             button?: ReactNode;
+            /**
+             * Pie fijo del panel — el sitio habitual para guardar/cancelar. Recibe
+             * `handleClose` porque, con el panel sin controlar desde fuera, es la única
+             * forma que tiene el consumidor de cerrarlo.
+             */
+            footer?: (props: {
+                handleClose: () => void;
+            }) => ReactNode;
         };
     };
     slotProps?: {
@@ -205,7 +215,7 @@ interface CSVUploadProps {
     postAction?: (response: any) => void;
     open: boolean;
     drawerToggle: () => void;
-    data?: CSVMenuOptionProps$1;
+    data?: CSVMenuOptionProps$2;
 }
 declare const CSVUpload: React__default.FC<CSVUploadProps>;
 
@@ -220,11 +230,11 @@ interface EditGridColumnsProps {
 }
 declare const editColumn: (props?: EditGridColumnsProps) => GridColDefPropsOverrides[];
 
-interface DeleteGridColumnsProps {
+interface DeleteGridColumnsProps$1 {
     displayDelete?: boolean;
     handleOpen: (id: GridRowId) => () => void;
 }
-declare const deleteColumn: (props: DeleteGridColumnsProps) => GridColDefPropsOverrides[];
+declare const deleteColumn$1: (props: DeleteGridColumnsProps$1) => GridColDefPropsOverrides[];
 
 interface EditGridAPIProps {
     mutation: any;
@@ -243,6 +253,16 @@ interface EditGridAPIProps {
     postAction?: (result: any) => void;
 }
 
+interface EditToggleGridAPIProps {
+    /** Hides the button and its shortcuts without touching permissions. */
+    disabled?: boolean;
+    /**
+     * Notified whenever the toggle flips. Generic passthrough — `DrawerGrid_v2` uses it to
+     * open its row drawer already in edit mode.
+     */
+    onEditModeChange?: (edit: boolean) => void;
+}
+
 interface DeleteGridWrapperProps {
     mutation: any;
     permission: boolean;
@@ -253,22 +273,22 @@ interface DeleteGridWrapperProps {
     dataGridProps?: Partial<MyDataGridProps>;
 }
 
-interface CSVMenuOptionProps {
+interface CSVMenuOptionProps$1 {
     endpoint: string;
     title?: string;
     custom?: string;
     icon?: any;
 }
-interface ExtraCreateOptionProps {
+interface ExtraCreateOptionProps$1 {
     title: string;
     icon: any;
     onClick: () => void;
 }
 interface CreateGridAPIProps {
-    extraOptions?: ExtraCreateOptionProps[];
+    extraOptions?: ExtraCreateOptionProps$1[];
     csv_upload?: {
         enable: boolean;
-        extraOptions?: CSVMenuOptionProps[];
+        extraOptions?: CSVMenuOptionProps$1[];
     };
     navigationOptions?: NavigateOptions;
     /**
@@ -291,6 +311,11 @@ interface BaseGridProps {
             };
         };
         edit?: EditGridAPIProps;
+        /**
+         * Edit mode without any in-grid editing: just the toolbar toggle, for grids whose
+         * writing happens elsewhere (see `DrawerGrid_v2`). Ignored when `edit` is set.
+         */
+        editToggle?: EditToggleGridAPIProps;
         delete?: Pick<DeleteGridWrapperProps, "mutation">;
         create?: CreateGridAPIProps;
     };
@@ -303,6 +328,12 @@ interface BaseGridProps {
     };
     ref?: RefObject<any>;
 }
+/**
+ * @deprecated Use `ServerGrid_v2`. This grid is frozen: it still composes its wrappers by
+ * calling them as plain functions, so their hooks land in this component's hook list and a
+ * consumer that builds `api.edit`/`api.delete` conditionally will crash on the flip. v2 fixes
+ * that along with the toolbar defects, and its props are a drop-in superset of these.
+ */
 declare const Base: React__default.FC<BaseGridProps>;
 
 interface ActiveCellProps {
@@ -336,9 +367,18 @@ interface ExportButtonProps {
     filterModel: FiltersButtonProps["filters"]["filterModel"];
     sortModel: GridSortModel;
     rowSelectionModel: GridRowSelectionModel;
+    /**
+     * The grid's `api.data.args` — the scoping its query is actually made with. Threaded
+     * here so an export can't include rows the grid itself would never show.
+     */
+    queryArgs?: {
+        filterModel?: FiltersButtonProps["filters"]["filterModel"];
+    } & {
+        [key: string]: any;
+    };
 }
 
-interface ExportCSVButtonProps extends Pick<ExportButtonProps, "filterModel" | "sortModel" | "rowSelectionModel"> {
+interface ExportCSVButtonProps extends Pick<ExportButtonProps, "filterModel" | "sortModel" | "rowSelectionModel" | "queryArgs"> {
     handleClick: () => void;
     disabledWithoutSelection?: boolean;
     ignore?: {
@@ -374,6 +414,11 @@ interface CustomToolbarProps extends GridToolbarProps, FiltersButtonProps, Selec
         buttonProps?: any;
     }[];
     sortModel: GridSortModel;
+    /**
+     * The grid's `api.data.args`, forwarded to the export so a CSV carries the same scoping
+     * the grid queries with. Set by `Base`; consumers don't pass it.
+     */
+    queryArgs?: ExportButtonProps["queryArgs"];
     buttons: {
         settings?: {
             hide?: boolean;
@@ -604,18 +649,71 @@ interface FieldProps$1 {
     readOnly?: boolean;
 }
 
-interface MainDrawerProps {
+interface MainDrawerV2Props {
     open: boolean;
-    drawerToggle: () => void;
-    title: string;
+    /** Cierra el panel. Se invoca desde el botón de cerrar, Escape y el backdrop. */
+    onClose: () => void;
+    /** Se muestra en la barra del encabezado, a la misma altura que las acciones. */
+    title?: ReactNode;
+    /** Línea secundaria bajo el título (opcional). El encabezado crece para alojarla. */
+    subtitle?: ReactNode;
     children: ReactNode;
-    drawerProps?: DrawerProps;
+    /**
+     * Ancho del panel para los anchors laterales (`"left"` / `"right"`); alto para
+     * `"top"` / `"bottom"`. El panel nunca excede el viewport. Por defecto `600`.
+     */
     width?: number | string;
+    /** Lado desde el que entra el panel. Por defecto `"right"`. */
+    anchor?: DrawerProps["anchor"];
+    /** Impide que un clic en el backdrop cierre el panel (formularios con cambios sin guardar). */
+    disableBackdropClose?: boolean;
+    /** Oculta el botón de cerrar integrado, para reemplazarlo desde `slots.headerActions`. */
+    hideCloseButton?: boolean;
+    /** Quita el padding interno del panel de contenido, para contenido a sangre. */
+    disableGutters?: boolean;
+    /** Color de fondo del panel de contenido. Por defecto `#f7f7f7`. */
+    pageBackgroundColor?: string;
+    /** Color del contorno: encabezado, pie y el marco alrededor del contenido. */
+    chromeBackgroundColor?: string;
+    /** Separación en px entre el contorno y el panel de contenido. `0` lo deja a ras. */
+    contentGap?: number;
+    /** Radio de las esquinas del panel de contenido. Por defecto `theme.shape.borderRadius`. */
+    contentBorderRadius?: number;
     slots?: {
-        button?: ReactNode;
+        /** Acciones del encabezado, a la izquierda del botón de cerrar. */
+        headerActions?: ReactNode;
+        /** Pie fijo — no scrollea con el cuerpo. Pensado para guardar/cancelar. */
+        footer?: ReactNode;
+    };
+    slotProps?: {
+        drawer?: Partial<DrawerProps>;
+        /** Estilos del `Paper`; se aplican después de los propios, así que ganan. */
+        paper?: {
+            sx?: SxProps<Theme>;
+        };
+        header?: Partial<StackProps>;
+        body?: Partial<BoxProps>;
+        footer?: Partial<BoxProps>;
+        title?: Partial<TypographyProps>;
+        closeButton?: Partial<IconButtonProps>;
     };
 }
-declare const MainDrawer: React__default.FC<MainDrawerProps>;
+/**
+ * Panel lateral genérico: encabezado fijo con el título y las acciones en la misma línea,
+ * cuerpo scrolleable y pie opcional anclado abajo.
+ *
+ * Repite el formato del área de contenido de `MainLayout`: encabezado y pie del color del
+ * contorno, y el contenido flotando dentro como un panel redondeado separado del marco, de
+ * modo que quede un borde blanco a los lados.
+ *
+ * Frente a `MainDrawer` (v1): el título y los botones comparten una barra alineada al centro
+ * en lugar de apilarse a alturas distintas; el encabezado y el pie no scrollean con el
+ * contenido (el botón de cerrar siempre queda a la vista); el redondeo sale de
+ * `theme.shape.borderRadius` y sigue al `anchor`; y el `sx` que llega por `slotProps` se
+ * concatena en vez de reemplazar el propio. No depende de `@toolpad/core`, así que sirve
+ * fuera de un layout de Toolpad.
+ */
+declare function MainDrawer$1({ open, onClose, title, subtitle, children, width, anchor, disableBackdropClose, hideCloseButton, disableGutters, pageBackgroundColor, chromeBackgroundColor, contentGap, contentBorderRadius, slots, slotProps, }: MainDrawerV2Props): react_jsx_runtime.JSX.Element;
 
 declare module "@mui/x-data-grid" {
     interface ToolbarPropsOverrides {
@@ -635,7 +733,11 @@ interface ArrayFieldProps {
     parser?: JSONParserProps;
     fields: FieldProps$1[];
     slotProps?: {
-        drawer?: Partial<MainDrawerProps>;
+        /**
+         * Se aplica sobre el panel de edición. `open` y `onClose` los gobierna este
+         * componente; el resto (`title`, `width`, `anchor`, ...) se puede sobreescribir.
+         */
+        drawer?: Partial<MainDrawerV2Props>;
     };
 }
 
@@ -930,6 +1032,25 @@ interface ObjectProgressStackProps {
 }
 declare const ObjectProgressStack: React__default.FC<ObjectProgressStackProps>;
 
+interface MainDrawerProps {
+    open: boolean;
+    drawerToggle: () => void;
+    title: string;
+    children: ReactNode;
+    drawerProps?: DrawerProps;
+    width?: number | string;
+    slots?: {
+        button?: ReactNode;
+    };
+}
+/**
+ * @deprecated Usa `MainDrawer_v2` (`@v2/drawers`). Ya no queda ningún consumidor dentro de
+ * la librería; se mantiene exportado sólo para los proyectos que lo importan directamente.
+ * En v2 el título y las acciones comparten una barra, el encabezado y el pie no scrollean
+ * con el contenido, y `drawerToggle` pasa a llamarse `onClose`.
+ */
+declare const MainDrawer: React__default.FC<MainDrawerProps>;
+
 interface _HistorialDrawerProps {
     open: boolean;
     handleDrawer: () => void;
@@ -1027,6 +1148,343 @@ interface PollingCountdownChipProps {
  *  fetch reinicia el conteo; opcionalmente refresca al hacer clic. */
 declare function PollingCountdownChip({ pollingInterval, isFetching, onRefresh, }: PollingCountdownChipProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * 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[];
+    /** Passed straight to the lazy hook (`{ pollingInterval }`, …). Also deep-compared. */
+    options?: {
+        [key: string]: any;
+    };
+}
+/** In-grid row editing: an actions column, `editMode: "row"`, and optional drag & drop. */
+interface ServerGridEditApi {
+    mutation: any;
+    disabled?: boolean;
+    columns: (props?: EditGridColumnsProps) => GridColDefPropsOverrides[];
+    options?: {
+        [key: string]: unknown[] | undefined;
+    };
+    parser?: JSONParserProps;
+    dnd?: {
+        field: string;
+        args?: {
+            [key: string]: any;
+        };
+    };
+    postAction?: (result: any) => void;
+}
+/**
+ * Edit mode without any in-grid editing: just the toolbar toggle, for grids whose writing
+ * happens elsewhere (see `DrawerGrid_v2`). Ignored when `edit` is set.
+ */
+interface ServerGridEditToggleApi {
+    /** Hides the button and its shortcuts without touching permissions. */
+    disabled?: boolean;
+    /** Notified whenever the toggle flips. */
+    onEditModeChange?: (edit: boolean) => void;
+}
+interface ServerGridDeleteApi {
+    mutation: any;
+}
+interface CSVMenuOptionProps {
+    endpoint: string;
+    title?: string;
+    custom?: string;
+    icon?: any;
+}
+interface ExtraCreateOptionProps {
+    title: string;
+    icon: any;
+    onClick: () => void;
+}
+interface ServerGridCreateApi {
+    extraOptions?: ExtraCreateOptionProps[];
+    csv_upload?: {
+        enable: boolean;
+        extraOptions?: CSVMenuOptionProps[];
+    };
+    navigationOptions?: NavigateOptions;
+    /**
+     * Overrides the "Manual" option's default behavior (routing to the create page). When
+     * provided, the option runs this callback instead of navigating — e.g. to open a drawer.
+     */
+    onManualCreate?: () => void;
+}
+/**
+ * A drop-in superset of v1's `BaseGridProps`: every key means the same thing, so migrating a
+ * page is `<Base` → `<ServerGrid_v2` plus deleting whatever workarounds it carried.
+ */
+interface ServerGridProps {
+    /** Route the rows navigate into, and the default persistence key. */
+    pathname: string;
+    dataGridProps: Partial<MyDataGridProps>;
+    api: {
+        data: ServerGridDataApi;
+        edit?: ServerGridEditApi;
+        editToggle?: ServerGridEditToggleApi;
+        delete?: ServerGridDeleteApi;
+        create?: ServerGridCreateApi;
+    };
+    slotProps?: {
+        /** Row/create navigation base, when it differs from `pathname`. */
+        navigation?: string;
+        /** Disambiguates several grids sharing one `pathname`. Part of the storage key. */
+        tab?: string;
+        /** Scopes the filter panel's option lookups to the current detail record. */
+        columnsFilter?: string;
+        /** Skip session persistence entirely. */
+        dontSaveState?: boolean;
+        /**
+         * Overrides the whole persistence key. Use when `pathname` + `tab` can't make two
+         * grids on one route distinct — otherwise they silently share saved state.
+         */
+        storageKey?: string;
+    };
+    ref?: RefObject<ServerGridHandle | null>;
+}
+interface ServerGridSnapshot {
+    paginationModel: GridPaginationModel;
+    sortModel: GridSortModel;
+    filterModel: MyGridFilterModel;
+    columnVisibilityModel: GridColumnVisibilityModel;
+    rowSelectionModel: GridRowSelectionModel;
+    rowCount: number;
+}
+/** Emitted whenever a page of rows lands. */
+interface RowsSnapshot {
+    page: number;
+    rowIds: GridRowId[];
+}
+interface ServerGridHandle {
+    /**
+     * The raw MUI api. Escape hatch — prefer the typed members below, which read the grid's
+     * own state rather than MUI internals.
+     */
+    getApi(): GridApi | null;
+    setFilterModel(model: SetStateAction<MyGridFilterModel>): void;
+    refetch(): void;
+    getState(): ServerGridSnapshot;
+    setPage(page: number): void;
+    setPageSize(pageSize: number): void;
+    setSortModel(model: GridSortModel): void;
+    /** Row ids in displayed order. Under server pagination that's the current page. */
+    getRowIds(): GridRowId[];
+    /**
+     * Fires once per page of rows actually landing. Narrower than MUI's `rowsSet`, which
+     * also fires on selection changes and other unrelated state writes.
+     */
+    subscribeRows(callback: (snapshot: RowsSnapshot) => void): () => void;
+}
+type GridLayerId = "delete" | "edit" | "editToggle" | "create";
+/**
+ * What a layer contributes to the grid. Layers nest so they can own their portals, but
+ * nothing here depends on that nesting — everything is applied in `LAYER_ORDER`.
+ */
+interface GridLayerContribution {
+    /** Inserted before the consumer's columns, in `LAYER_ORDER`. */
+    prependColumns?: GridColDefPropsOverrides[];
+    /** Appended after the consumer's columns, in `LAYER_ORDER`. */
+    appendColumns?: GridColDefPropsOverrides[];
+    /** Appended after the consumer's own toolbar buttons, in `LAYER_ORDER`. */
+    toolbarButtons?: NonNullable<CustomToolbarProps["extraButtons"]>;
+    /** Suggested props. The consumer's `dataGridProps` still wins. */
+    defaults?: Partial<MyDataGridProps>;
+    /**
+     * Props that beat the consumer.
+     *
+     * Only ever populate these while the layer's transient mode is active. A layer that
+     * publishes its mode-*off* value here overrides grids that deliberately opted out — a
+     * grid passing `checkboxSelection: false` would get checkboxes back the moment delete
+     * mode was idle.
+     */
+    overrides?: Partial<MyDataGridProps>;
+    /** Extra flags folded into the grid's `loading` disjunction. */
+    loadingParams?: unknown[];
+}
+type GridLayerMap = Partial<Record<GridLayerId, GridLayerContribution>>;
+
+/**
+ * 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 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>>;
+    /** 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 "Todos" — the backends read that literal and return the whole result set with
+ * `next`/`previous` null but a correct `count`.
+ */
+declare const PAGE_SIZE_OPTIONS: (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;
+}
+/**
+ * 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[];
+
 /**
  * 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
@@ -1258,7 +1716,7 @@ interface DetailFormConfig {
             [k: string]: any;
         };
     };
-    sections: (form: any) => SectionProps[];
+    sections: (form: any, pageType: PageType) => SectionProps[];
     pageType: PageType;
     /** dot-path prefix where `obj_permissions` live inside the fetched record. */
     permissionsPath?: string;
@@ -1294,7 +1752,7 @@ interface DetailFormController {
     /** Node emitted by a successful mutation's `post_action`, or `null`. */
     postActionNode: ReactNode;
     /** Passthroughs consumed by `<DetailForm/>`. */
-    sections: (form: any) => SectionProps[];
+    sections: (form: any, pageType: PageType) => SectionProps[];
     pageType: PageType;
 }
 /**
@@ -1329,7 +1787,11 @@ interface DrawerGridDrawerConfig {
         /** 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 editable drawer. */
+        /**
+         * 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 }`. */
@@ -1341,30 +1803,69 @@ interface DrawerGridDrawerConfig {
     };
     /** Runs after any successful create/edit (e.g. side effects; the grid refetches via RTK tag invalidation). */
     onSaved?: (response: any) => void;
-    /** Show the "open full page" button in the drawer header. Defaults to `true`. */
+    /**
+     * 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`.
+     */
+    showNavigator?: boolean;
     labels?: {
         save?: string;
         cancel?: string;
     };
 }
+interface DrawerGridEditConfig {
+    /** Hides the toggle (and its shortcuts) without touching permissions. */
+    disabled?: boolean;
+}
 interface DrawerGridProps {
-    /** Full v1 `Base` grid configuration (pathname, api, dataGridProps, slotProps, ref). */
-    grid: BaseGridProps;
+    /**
+     * 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;
 }
 /**
- * A v1 `Base` grid whose rows and create button open a `DetailFormDrawer_v2` instead of
+ * 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. 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, and the record drawer carries an "open full page" button — so the
- * routes stay reachable either way.
+ * 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`.
  *
- * The full `Base` grid config goes under `grid` (`{ pathname, api, dataGridProps, slotProps }`),
+ * 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.
+ *
+ * The full grid config goes under `grid` (`{ pathname, api, dataGridProps, slotProps }`),
  * alongside `drawer`.
  *
- * Composition only: the v1 grid stays drawer-agnostic (its `onRowClick` and `onManualCreate`
- * are generic passthroughs), so the v1→v2 layering is never inverted.
+ * 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;
 
@@ -1476,6 +1977,20 @@ interface DetailFormDialogProps {
  */
 declare function DetailFormDialog({ open, onClose, title, api, form, sections, pageType, permissionsPath, onSuccess, labels, slotProps, }: DetailFormDialogProps): react_jsx_runtime.JSX.Element;
 
+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. */
@@ -1486,9 +2001,26 @@ interface DetailFormDrawerProps {
     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;
+    /**
+     * 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 `480`. */
     width?: number | string;
     /** Side the drawer slides in from. Defaults to `"right"`. */
@@ -1509,11 +2041,13 @@ interface DetailFormDrawerProps {
 }
 /**
  * A record form inside a side drawer. Reuses the same `useDetailForm` engine and
- * `DetailForm` body as `DetailPage_v2`; only the chrome differs — a titled header, a
- * scrollable body and a pinned footer holding the actions. The save button sits outside
- * the `<form>`, so it submits via the native `form={formId}` attribute.
+ * `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, and a footer holding the form actions and, when
+ * `navigation` is given, a prev/next record navigator. The save button sits outside the
+ * `<form>`, so it submits via the native `form={formId}` attribute.
  */
-declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, permissionsPath, onSuccess, width, anchor, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
+declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, permissionsPath, onSuccess, navigation, width, anchor, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Encabezado por defecto del `PageContainer`: resuelve título y breadcrumbs a
@@ -1548,6 +2082,9 @@ interface MainLayoutPageHeaderProps extends PageHeaderProps {
  * `header` (leído por el `PageHeader` por defecto).
  *
  * Atajo Shift+F: alterna pantalla completa (oculta navegación y encabezados).
+ *
+ * El estado plegado/expandido del sidebar de escritorio se guarda en
+ * `localStorage` y se restaura al recargar (ver `sidebarStorageKey`).
  **/
 interface MainLayoutProps {
     /** Definición de navegación de Toolpad (items del sidebar). */
@@ -1571,12 +2108,56 @@ interface MainLayoutProps {
     };
     /** Ancho del sidebar expandido. */
     sidebarExpandedWidth?: number;
+    /**
+     * Estado inicial del sidebar cuando no hay nada guardado en `localStorage`
+     * (o cuando la persistencia está desactivada).
+     */
+    defaultSidebarCollapsed?: boolean;
+    /**
+     * Muestra el título bajo el icono cuando el sidebar está plegado, como hace
+     * Toolpad por defecto. Con `false` el menú plegado queda solo con iconos
+     * (el título sigue en el árbol de accesibilidad, dando nombre al botón).
+     */
+    miniSidebarLabels?: boolean;
+    /**
+     * Clave de `localStorage` donde se recuerda si el sidebar quedó plegado, de
+     * forma que se restaure al recargar. Pasa `null` para no persistirlo.
+     *
+     * Solo se guarda el estado del sidebar de escritorio (breakpoint `md` hacia
+     * arriba); el drawer temporal de móvil siempre arranca cerrado.
+     */
+    sidebarStorageKey?: string | null;
     /**
      * Color de fondo del área de contenido. Se aplica al scroll container
      * (`<main>`) para que cubra toda la altura scrolleable y no se corte cuando
      * la página es más larga que el viewport.
      */
     pageBackgroundColor?: string;
+    /**
+     * Color del contorno: el marco continuo que forman el header y el sidebar
+     * alrededor del panel de contenido.
+     */
+    chromeBackgroundColor?: string;
+    /**
+     * Radio de las esquinas del panel de contenido. Como el contorno lo rodea
+     * por arriba y por la izquierda, redondearlo recorta el borde del header y
+     * del sidebar con la misma curva. `0` deja el contenido a ras.
+     */
+    contentBorderRadius?: number;
+    /**
+     * Separación en px entre el contorno y el panel de contenido, a la derecha
+     * y abajo (arriba y a la izquierda el contenido va a ras del header y del
+     * sidebar). Se descuenta de la altura del área de trabajo para que el
+     * contenido siga cabiendo sin scroll extra.
+     */
+    contentGap?: number;
+    /**
+     * Padding horizontal dentro del panel de contenido. `PageContainer` es un
+     * `Container` de MUI, que trae 24px en `sm` hacia arriba; aquí se fija un
+     * valor único para todos los breakpoints. Número = unidades de spacing del
+     * tema (2 => 16px); también admite string CSS ("12px").
+     */
+    contentPaddingX?: number | string;
     /**
      * Estilos extra para el `DashboardLayout`. Se aplican después de los del
      * layout, así que pueden sobreescribirlos (ej. el ancho mínimo del sidebar
@@ -1659,5 +2240,5 @@ interface PulseDotProps {
  *  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;
 
-export { APIContext, APIProvider, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, CSVUpload, ConfirmDialog, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, 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, 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, ExtraButtons, HistorialDrawer, KpiCard, ListPage, Loadable, LoadingComponent, Logo, MainDrawer, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, ObjectProgressStack, Panel, PollingCountdownChip, PulseDot, SaveCancelButton, StatusBadge, StyledMenu, Tabs, Transitions, UncontrolledText, changeTitle, closeProgressSnack, deleteColumn, editColumn, filterQuery, formParser, _default as headerReducer, manualCacheRefresh, mergeSettings, openProgressSnack, query, renderEditCellWithErrorTooltip, setErrors, _default$1 as snackProgressReducer, tags, theme, updateProgressSnackData, useAPI, useDetailForm, useHasPermission, useHasPermission_v2, useKeyboardShortcut, useMutationHandler, useNavigation, valueLabel };
-export type { APIcontextProps, AddressValue, ComoOpcionesProps, ConfirmDialogProps, ControlledInput, CustomToolbarProps, DeleteGridColumnsProps, DetachedPage, DetailFormApi, DetailFormConfig, DetailFormController, DetailFormDialogProps, DetailFormDrawerProps, DetailFormProps, DetailFormStatus, DetailPageV2Props, DetailRenderProps, DrawerGridDrawerConfig, DrawerGridProps, EditGridColumnsProps, EditReadOnlyFields, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, GridArgs, GridColDefPropsOverrides, JSONFormProps, JSONParserProps, KeyboardShortcut, KpiCardProps, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, PageType, PanelProps, PollingCountdownChipProps, ProgressStatusProps, PulseDotProps };
+export { APIContext, APIProvider, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, CSVUpload, ConfirmDialog, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, 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_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, ExtraButtons, HistorialDrawer, KpiCard, LAYER_ORDER, ListPage, Loadable, LoadingComponent, Logo, MainDrawer, MainDrawer$1 as MainDrawer_v2, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, ObjectProgressStack, PAGE_SIZE_OPTIONS, Panel, PollingCountdownChip, PulseDot, SaveCancelButton, ServerGrid as ServerGrid_v2, StatusBadge, StyledMenu, Tabs, Transitions, UncontrolledText, changeTitle, closeProgressSnack, composeGridProps, deleteColumn$1 as deleteColumn, deleteColumn as deleteColumn_v2, editColumn, filterQuery, formParser, _default as headerReducer, manualCacheRefresh, mergeSettings, openProgressSnack, query, renderEditCellWithErrorTooltip, resolveInitialState, setErrors, _default$1 as snackProgressReducer, tags, theme, togglableFields, updateProgressSnackData, useAPI, useDetailForm, useHasPermission, useHasPermission_v2, useKeyboardShortcut, useMutationHandler, useNavigation, useServerGrid, valueLabel };
+export type { APIcontextProps, AddressValue, ComoOpcionesProps, ConfirmDialogProps, ControlledInput, CustomToolbarProps, DeleteGridColumnsProps$1 as DeleteGridColumnsProps, DetachedPage, DetailFormApi, DetailFormConfig, DetailFormController, DetailFormDialogProps, DetailFormDrawerNavigation, DetailFormDrawerProps, DetailFormProps, DetailFormStatus, DetailPageV2Props, DetailRenderProps, DrawerGridDrawerConfig, DrawerGridEditConfig, DrawerGridProps, EditGridColumnsProps, EditReadOnlyFields, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, GridArgs, GridColDefPropsOverrides, GridLayerContribution, GridLayerId, GridLayerMap, JSONFormProps, JSONParserProps, KeyboardShortcut, KpiCardProps, MainDrawerV2Props, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, PageType, PanelProps, PollingCountdownChipProps, ProgressStatusProps, PulseDotProps, RowsSnapshot, ServerGridArgs, ServerGridCreateApi, ServerGridDataApi, ServerGridDeleteApi, ServerGridEditApi, ServerGridEditToggleApi, ServerGridHandle, ServerGridProps, ServerGridSnapshot, ServerGridState, UseServerGridOptions };