@acvl/frontend-components 0.0.77 → 0.0.79

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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 from 'react';
+import * as React$1 from 'react';
 import React__default, { ReactNode, Dispatch, SetStateAction, JSX, RefObject, ReactElement, 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, GridApi, GridPaginationModel, GridColumnVisibilityModel, useGridApiRef, GridColDef } from '@mui/x-data-grid';
@@ -11,6 +11,7 @@ import * as zod from 'zod';
 import { coerce, z } from 'zod';
 import { NumericFormatProps } from 'react-number-format';
 import { TextFieldProps } from '@mui/material/TextField';
+import dayjs from 'dayjs';
 export { default as dayjs } from 'dayjs';
 import * as redux from 'redux';
 import * as _reduxjs_toolkit from '@reduxjs/toolkit';
@@ -282,12 +283,20 @@ interface EditGridColumnsProps {
     options?: {
         [key: string]: unknown[] | undefined;
     };
+    /** Rótulos de la columna y de sus acciones. Los pasa el wrapper, que tiene el idioma. */
+    etiquetas?: {
+        editar?: string;
+        guardar?: string;
+        cancelar?: string;
+    };
 }
 declare const editColumn: (props?: EditGridColumnsProps) => GridColDefPropsOverrides[];
 
 interface DeleteGridColumnsProps$1 {
     displayDelete?: boolean;
     handleOpen: (id: GridRowId) => () => void;
+    /** Rótulo de la columna y de la acción. Lo pasa el wrapper, que es quien tiene el idioma. */
+    etiqueta?: string;
 }
 declare const deleteColumn$1: (props: DeleteGridColumnsProps$1) => GridColDefPropsOverrides[];
 
@@ -879,7 +888,7 @@ interface SidePanelHost {
  * Fuera de un `MainLayout` el contexto es `null`: el panel se pinta donde esté declarado y
  * no se turna con nadie.
  */
-declare const SidePanelHostContext: React.Context<SidePanelHost | null>;
+declare const SidePanelHostContext: React$1.Context<SidePanelHost | null>;
 /** El hueco de paneles acoplados del layout, o `null` si no hay ninguno arriba. */
 declare const useSidePanelHost: () => SidePanelHost | null;
 
@@ -1090,7 +1099,7 @@ interface TransitionsProps {
 /**
  * Componente customizable para generar efectos de transición
 **/
-declare const Transitions: React.ForwardRefExoticComponent<Omit<TransitionsProps, "ref"> & React.RefAttributes<unknown>>;
+declare const Transitions: React$1.ForwardRefExoticComponent<Omit<TransitionsProps, "ref"> & React$1.RefAttributes<unknown>>;
 
 interface ListPageProps {
     tabs?: MyTabProps;
@@ -1134,7 +1143,7 @@ interface APIcontextProps {
     useGuardarPreferenciaDeExportacionMutation: any;
     useBorrarPreferenciaDeExportacionMutation: any;
 }
-declare const APIContext: React.Context<APIcontextProps | null>;
+declare const APIContext: React$1.Context<APIcontextProps | null>;
 declare const APIProvider: ({ children, hooks, }: {
     children: ReactNode;
     hooks: APIcontextProps;
@@ -1193,9 +1202,511 @@ interface NavigationContextProps {
     children: ReactNode;
     hook: any;
 }
-declare const NavigationContext: React.Context<NavigationContextProps | null>;
+declare const NavigationContext: React$1.Context<NavigationContextProps | null>;
 declare const NavigationProvider: ({ children, hook }: NavigationContextProps) => react_jsx_runtime.JSX.Element;
 
+/**
+ * Los textos que la librería dibuja por su cuenta, en los dos idiomas.
+ *
+ * Es un diccionario tipado y no un runtime de i18n a propósito. La librería la consumen tres
+ * portales (`acv-wms`, `acv-tms`, `acv-suma`) y meterle `i18next` como dependencia obligaría a los
+ * tres a montar una instancia antes de poder actualizar. Aquí sólo hay ~130 textos y ninguno se
+ * carga tarde ni se interpola de formas raras, así que un objeto alcanza —y de paso da autocompletado
+ * y error de compilación si a `en` le falta una llave, que un `t("llave.mal.escrita")` no da—.
+ *
+ * El idioma lo pone la app con `LocaleProvider`; se lee con `useTextos()`.
+ *
+ * Las plantillas van como funciones (`registrosSeleccionados: (n) => ...`) en vez de concatenarse
+ * en el punto de uso: el orden de las palabras cambia entre idiomas y una concatenación lo fija.
+ */
+/** Idiomas que entiende la librería. */
+type Locale = "es" | "en";
+declare const es: {
+    comun: {
+        aceptar: string;
+        cancelar: string;
+        guardar: string;
+        editar: string;
+        eliminar: string;
+        crear: string;
+        cerrar: string;
+        limpiar: string;
+        aplicar: string;
+        confirmar: string;
+        volver: string;
+        buscar: string;
+        busqueda: string;
+        busquedaPlaceholder: string;
+        limpiarBusqueda: string;
+        redimensionarPanel: string;
+        sinResultados: string;
+        cargando: string;
+        todos: string;
+        todas: string;
+        noDisponible: string;
+        algoSalioMal: string;
+        error: string;
+    };
+    grid: {
+        columnas: string;
+        filtros: string;
+        exportar: string;
+        dobleClicParaHerramientas: string;
+        abrirEnPaginaCompleta: string;
+        guardarYSiguienteCorto: string;
+        hilerasPorPagina: string;
+        informacionActualizada: string;
+        errorActualizando: string;
+        ordenar: string;
+        ordenarAsc: string;
+        ordenarDesc: string;
+        menu: string;
+        refrescar: string;
+        acciones: string;
+    };
+    exportar: {
+        titulo: string;
+        descargarCSV: string;
+        descargado: string;
+        errorAlDescargar: string;
+        generandose: string;
+        noSePudieronCargarColumnas: string;
+        todasLasColumnas: string;
+        usarPorDefecto: string;
+        eliminarPreferencia: string;
+        quitarTodas: string;
+        seleccionarTodas: string;
+        nombreDeLaPreferencia: string;
+        seExportaranRegistros: (n: string) => string;
+        seExportaraElListado: string;
+        alcanceDeSeleccion: (n: string, cantidad: number) => string;
+        columnasElegidas: (n: number) => string;
+    };
+    detalle: {
+        editar: string;
+        editarAtajo: string;
+        eliminar: string;
+        historial: string;
+        historialAtajo: string;
+        anterior: string;
+        siguiente: string;
+        guardarYSiguiente: string;
+        cambiosPendientes: string;
+        masInformacion: string;
+        /** El título de "crear" que arma `PageHeader` a partir del nombre del modelo. */
+        crearRegistro: (singular: string) => string;
+        cargarPagina: (titulo: string) => string;
+    };
+    notificaciones: {
+        titulo: string;
+        vacio: string;
+        todas: string;
+        noLeidas: string;
+        cerrar: string;
+        marcarTodasComoLeidas: string;
+        todasMarcadasComoLeidas: string;
+        todasBorradas: string;
+        anterior: string;
+        siguiente: string;
+        leerTodas: string;
+        borrarTodas: string;
+        borrarTodasAria: string;
+    };
+    cuenta: {
+        modoOscuro: string;
+        idioma: string;
+        espanol: string;
+        ingles: string;
+    };
+    historial: {
+        titulo: string;
+        ocultarCampos: string;
+        verTodosLosCampos: string;
+        verLosCampos: string;
+    };
+    opciones: {
+        agregarNuevo: string;
+        agregarOpcion: string;
+        editarOpcion: string;
+        eliminarOpcion: string;
+        creada: string;
+        errorAlCrear: string;
+        actualizada: string;
+        errorAlActualizar: string;
+        eliminada: string;
+        errorAlEliminar: string;
+        seleccionarTodo: string;
+        escribeAlMenos: (n: number) => string;
+    };
+    archivos: {
+        subidoConExito: string;
+        error: string;
+        archivoDeMuestra: string;
+        tipoInvalido: string;
+        soltarAqui: string;
+        arrastraOHazClic: string;
+        archivos: string;
+    };
+    color: {
+        sinColor: string;
+        formatoInvalido: string;
+        elegirColor: string;
+        colorPersonalizado: string;
+    };
+    confirmarBorrado: {
+        /**
+         * La palabra que hay que teclear para confirmar. **No es sólo copia**: el diálogo compara
+         * lo tecleado contra este mismo valor, así que traducirla cambia el comportamiento y las
+         * dos cosas tienen que salir de aquí para no quedar desfasadas.
+         */
+        palabra: string;
+        instruccion: (palabra: string) => string;
+        exito: string;
+    };
+    errores: {
+        accesoNoPermitido: string;
+        sinPermisos: string;
+        validacion: string;
+        alGuardar: string;
+    };
+    layout: {
+        avisoDePrivacidad: string;
+        avisoDePrivacidadCorto: string;
+        verNovedades: string;
+    };
+};
+/**
+ * La forma del diccionario, tomada del español. Cualquier llave que le falte a `en` —o que sobre—
+ * es error de compilación.
+ */
+type Textos = typeof es;
+/** Los diccionarios por idioma. */
+declare const TEXTOS: Record<Locale, Textos>;
+
+/**
+ * El idioma en el que la librería dibuja lo suyo.
+ *
+ * La librería **no traduce**: recibe el idioma ya resuelto y lo usa para elegir diccionario. Quien
+ * decide es el proyecto —de dónde lo saca (el usuario, el navegador, un claim del token), dónde lo
+ * guarda y dónde pone el interruptor es asunto suyo—. Es el mismo trato que `useColorMode`: la
+ * librería da estado y acciones, el proyecto los coloca.
+ *
+ * Si nadie monta el provider el idioma es español, que es como se comportaba antes de que esto
+ * existiera. Por eso `acv-tms` y `acv-suma` pueden actualizar sin tocar nada.
+ *
+ * @example
+ * // En el `main.tsx` del proyecto, al lado de los otros providers
+ * <LocaleProvider locale={idioma} setLocale={setIdioma}>
+ *     <App />
+ * </LocaleProvider>
+ *
+ * @example
+ * // Dentro de un componente de la librería
+ * const t = useTextos();
+ * <Button>{t.comun.guardar}</Button>
+ */
+interface LocaleContextProps {
+    /** Idioma activo. */
+    locale: Locale;
+    /**
+     * Cambia el idioma. Opcional: un proyecto puede fijar el idioma y no ofrecer cómo cambiarlo,
+     * en cuyo caso los controles que la librería dibuja para elegirlo no aparecen.
+     */
+    setLocale?: (locale: Locale) => void;
+}
+declare const LocaleContext: React$1.Context<LocaleContextProps>;
+interface LocaleProviderProps extends LocaleContextProps {
+    children: ReactNode;
+}
+declare const LocaleProvider: ({ children, locale, setLocale }: LocaleProviderProps) => react_jsx_runtime.JSX.Element;
+/** El idioma activo y, si el proyecto lo ofrece, cómo cambiarlo. */
+declare const useLocale: () => LocaleContextProps;
+/**
+ * Los textos de la librería en el idioma activo.
+ *
+ * Devuelve el diccionario entero, no una función: `t.comun.guardar` se autocompleta y una llave
+ * mal escrita no compila.
+ */
+declare const useTextos: () => Textos;
+
+/**
+ * Fija el idioma de dayjs.
+ *
+ * `dayjs.locale()` es una **mutación global** del módulo: no hay forma de tener dos idiomas vivos
+ * en subárboles distintos, y alcanza también a quien importe `dayjs` directo en vez de esta copia.
+ * Aquí eso es lo que se quiere —hay un solo idioma activo a la vez— pero conviene saberlo antes de
+ * intentar usarlo por componente.
+ *
+ * Lo llama `LocaleProvider`; no hace falta invocarlo a mano.
+ */
+declare const aplicarLocaleDeDayjs: (locale: "es" | "en") => void;
+
+declare const localeTextDeMUI: (locale: Locale) => {
+    columnHeaderSortIconLabel: string;
+    columnMenuSortAsc: string;
+    columnMenuSortDesc: string;
+    columnMenuLabel: string;
+    noRowsLabel?: string | undefined;
+    noResultsOverlayLabel?: string | undefined;
+    noColumnsOverlayLabel?: string | undefined;
+    noColumnsOverlayManageColumns?: string | undefined;
+    emptyPivotOverlayLabel?: string | undefined;
+    toolbarDensity?: React.ReactNode;
+    toolbarDensityLabel?: string | undefined;
+    toolbarDensityCompact?: string | undefined;
+    toolbarDensityStandard?: string | undefined;
+    toolbarDensityComfortable?: string | undefined;
+    toolbarUndo?: React.ReactNode;
+    toolbarRedo?: React.ReactNode;
+    toolbarColumns?: React.ReactNode;
+    toolbarColumnsLabel?: string | undefined;
+    toolbarFilters?: React.ReactNode;
+    toolbarFiltersLabel?: string | undefined;
+    toolbarFiltersTooltipHide?: React.ReactNode;
+    toolbarFiltersTooltipShow?: React.ReactNode;
+    toolbarFiltersTooltipActive?: ((count: number) => React.ReactNode) | undefined;
+    toolbarQuickFilterPlaceholder?: string | undefined;
+    toolbarQuickFilterLabel?: string | undefined;
+    toolbarQuickFilterDeleteIconLabel?: string | undefined;
+    toolbarExport?: React.ReactNode;
+    toolbarExportLabel?: string | undefined;
+    toolbarExportCSV?: React.ReactNode;
+    toolbarExportPrint?: React.ReactNode;
+    toolbarExportExcel?: string | undefined;
+    toolbarPivot?: string | undefined;
+    toolbarCharts?: string | undefined;
+    toolbarAssistant?: React.ReactNode;
+    columnsManagementSearchTitle?: string | undefined;
+    columnsManagementNoColumns?: string | undefined;
+    columnsManagementShowHideAllText?: string | undefined;
+    columnsManagementReset?: string | undefined;
+    columnsManagementDeleteIconLabel?: string | undefined;
+    filterPanelAddFilter?: React.ReactNode;
+    filterPanelRemoveAll?: React.ReactNode;
+    filterPanelDeleteIconLabel?: string | undefined;
+    filterPanelLogicOperator?: string | undefined;
+    filterPanelOperator?: React.ReactNode;
+    filterPanelOperatorAnd?: React.ReactNode;
+    filterPanelOperatorOr?: React.ReactNode;
+    filterPanelColumns?: React.ReactNode;
+    filterPanelInputLabel?: string | undefined;
+    filterPanelInputPlaceholder?: string | undefined;
+    filterOperatorContains?: string | undefined;
+    filterOperatorDoesNotContain?: string | undefined;
+    filterOperatorEquals?: string | undefined;
+    filterOperatorDoesNotEqual?: string | undefined;
+    filterOperatorStartsWith?: string | undefined;
+    filterOperatorEndsWith?: string | undefined;
+    filterOperatorIs?: string | undefined;
+    filterOperatorNot?: string | undefined;
+    filterOperatorAfter?: string | undefined;
+    filterOperatorOnOrAfter?: string | undefined;
+    filterOperatorBefore?: string | undefined;
+    filterOperatorOnOrBefore?: string | undefined;
+    filterOperatorIsEmpty?: string | undefined;
+    filterOperatorIsNotEmpty?: string | undefined;
+    filterOperatorIsAnyOf?: string | undefined;
+    'filterOperator='?: string | undefined;
+    'filterOperator!='?: string | undefined;
+    'filterOperator>'?: string | undefined;
+    'filterOperator>='?: string | undefined;
+    'filterOperator<'?: string | undefined;
+    'filterOperator<='?: string | undefined;
+    headerFilterOperatorContains?: string | undefined;
+    headerFilterOperatorDoesNotContain?: string | undefined;
+    headerFilterOperatorEquals?: string | undefined;
+    headerFilterOperatorDoesNotEqual?: string | undefined;
+    headerFilterOperatorStartsWith?: string | undefined;
+    headerFilterOperatorEndsWith?: string | undefined;
+    headerFilterOperatorIs?: string | undefined;
+    headerFilterOperatorNot?: string | undefined;
+    headerFilterOperatorAfter?: string | undefined;
+    headerFilterOperatorOnOrAfter?: string | undefined;
+    headerFilterOperatorBefore?: string | undefined;
+    headerFilterOperatorOnOrBefore?: string | undefined;
+    headerFilterOperatorIsEmpty?: string | undefined;
+    headerFilterOperatorIsNotEmpty?: string | undefined;
+    headerFilterOperatorIsAnyOf?: string | undefined;
+    'headerFilterOperator='?: string | undefined;
+    'headerFilterOperator!='?: string | undefined;
+    'headerFilterOperator>'?: string | undefined;
+    'headerFilterOperator>='?: string | undefined;
+    'headerFilterOperator<'?: string | undefined;
+    'headerFilterOperator<='?: string | undefined;
+    headerFilterClear?: string | undefined;
+    filterValueAny?: string | undefined;
+    filterValueTrue?: string | undefined;
+    filterValueFalse?: string | undefined;
+    columnMenuAriaLabel?: ((columnName: string) => string) | undefined;
+    columnMenuShowColumns?: React.ReactNode;
+    columnMenuManageColumns?: React.ReactNode;
+    columnMenuFilter?: React.ReactNode;
+    columnMenuHideColumn?: React.ReactNode;
+    columnMenuUnsort?: React.ReactNode;
+    columnMenuManagePivot?: string | undefined;
+    columnMenuManageCharts?: string | undefined;
+    columnHeaderFiltersTooltipActive?: ((count: number) => React.ReactNode) | undefined;
+    columnHeaderFiltersLabel?: string | undefined;
+    footerRowSelected?: ((count: number) => React.ReactNode) | undefined;
+    footerTotalRows?: React.ReactNode;
+    footerTotalVisibleRows?: ((visibleCount: number, totalCount: number) => React.ReactNode) | undefined;
+    checkboxSelectionHeaderName?: string | undefined;
+    checkboxSelectionSelectAllRows?: string | undefined;
+    checkboxSelectionUnselectAllRows?: string | undefined;
+    checkboxSelectionSelectRow?: string | undefined;
+    checkboxSelectionUnselectRow?: string | undefined;
+    booleanCellTrueLabel?: string | undefined;
+    booleanCellFalseLabel?: string | undefined;
+    longTextCellExpandLabel?: string | undefined;
+    longTextCellCollapseLabel?: string | undefined;
+    actionsCellMore?: string | undefined;
+    pinToLeft?: string | undefined;
+    pinToRight?: string | undefined;
+    unpin?: string | undefined;
+    treeDataGroupingHeaderName?: string | undefined;
+    treeDataExpand?: string | undefined;
+    treeDataCollapse?: string | undefined;
+    groupingColumnHeaderName?: string | undefined;
+    groupColumn?: ((name: string) => string) | undefined;
+    unGroupColumn?: ((name: string) => string) | undefined;
+    detailPanelToggle?: string | undefined;
+    expandDetailPanel?: string | undefined;
+    collapseDetailPanel?: string | undefined;
+    rowReorderingHeaderName?: string | undefined;
+    aggregationMenuItemHeader?: string | undefined;
+    aggregationFunctionLabelNone?: string | undefined;
+    aggregationFunctionLabelSum?: string | undefined;
+    aggregationFunctionLabelAvg?: string | undefined;
+    aggregationFunctionLabelMin?: string | undefined;
+    aggregationFunctionLabelMax?: string | undefined;
+    aggregationFunctionLabelSize?: string | undefined;
+    paginationRowsPerPage?: string | undefined;
+    paginationDisplayedRows?: ((params: {
+        from: number;
+        to: number;
+        count: number;
+        estimated: number | undefined;
+    }) => string) | undefined;
+    paginationItemAriaLabel?: ((type: "first" | "last" | "previous" | "next") => string) | undefined;
+    pivotToggleLabel?: string | undefined;
+    pivotCloseButton?: string | undefined;
+    pivotSearchButton?: string | undefined;
+    pivotSearchControlPlaceholder?: string | undefined;
+    pivotSearchControlLabel?: string | undefined;
+    pivotSearchControlClear?: string | undefined;
+    pivotNoFields?: string | undefined;
+    pivotRows?: string | undefined;
+    pivotColumns?: string | undefined;
+    pivotValues?: string | undefined;
+    pivotMenuMoveUp?: string | undefined;
+    pivotMenuMoveDown?: string | undefined;
+    pivotMenuMoveToTop?: string | undefined;
+    pivotMenuMoveToBottom?: string | undefined;
+    pivotMenuRows?: string | undefined;
+    pivotMenuColumns?: string | undefined;
+    pivotMenuValues?: string | undefined;
+    pivotMenuOptions?: string | undefined;
+    pivotMenuAddToRows?: string | undefined;
+    pivotMenuAddToColumns?: string | undefined;
+    pivotMenuAddToValues?: string | undefined;
+    pivotMenuRemove?: string | undefined;
+    pivotDragToRows?: string | undefined;
+    pivotDragToColumns?: string | undefined;
+    pivotDragToValues?: string | undefined;
+    pivotYearColumnHeaderName?: string | undefined;
+    pivotQuarterColumnHeaderName?: string | undefined;
+    chartsNoCharts?: string | undefined;
+    chartsChartNotSelected?: string | undefined;
+    chartsTabChart?: string | undefined;
+    chartsTabFields?: string | undefined;
+    chartsTabCustomize?: string | undefined;
+    chartsCloseButton?: string | undefined;
+    chartsSyncButtonLabel?: string | undefined;
+    chartsSearchPlaceholder?: string | undefined;
+    chartsSearchLabel?: string | undefined;
+    chartsSearchClear?: string | undefined;
+    chartsNoFields?: string | undefined;
+    chartsFieldBlocked?: string | undefined;
+    chartsCategories?: string | undefined;
+    chartsSeries?: string | undefined;
+    chartsMenuAddToDimensions?: ((dimensionLabel: string) => string) | undefined;
+    chartsMenuAddToValues?: ((valuesLabel: string) => string) | undefined;
+    chartsMenuMoveUp?: string | undefined;
+    chartsMenuMoveDown?: string | undefined;
+    chartsMenuMoveToTop?: string | undefined;
+    chartsMenuMoveToBottom?: string | undefined;
+    chartsMenuOptions?: string | undefined;
+    chartsMenuRemove?: string | undefined;
+    chartsDragToDimensions?: ((dimensionLabel: string) => string) | undefined;
+    chartsDragToValues?: ((valuesLabel: string) => string) | undefined;
+    aiAssistantPanelTitle?: string | undefined;
+    aiAssistantPanelClose?: string | undefined;
+    aiAssistantPanelConversationHistory?: string | undefined;
+    aiAssistantPanelNewConversation?: string | undefined;
+    aiAssistantPanelEmptyConversation?: string | undefined;
+    aiAssistantSuggestions?: string | undefined;
+    promptRerun?: string | undefined;
+    promptProcessing?: string | undefined;
+    promptAppliedChanges?: string | undefined;
+    promptChangeGroupDescription?: ((column: string) => string) | undefined;
+    promptChangeAggregationLabel?: ((column: string, aggregation: string) => string) | undefined;
+    promptChangeAggregationDescription?: ((column: string, aggregation: string) => string) | undefined;
+    promptChangeFilterLabel?: ((column: string, operator: string, value: string) => string) | undefined;
+    promptChangeFilterDescription?: ((column: string, operator: string, value: string) => string) | undefined;
+    promptChangeSortDescription?: ((column: string, direction: string) => string) | undefined;
+    promptChangePivotEnableLabel?: string | undefined;
+    promptChangePivotEnableDescription?: string | undefined;
+    promptChangePivotColumnsLabel?: ((count: number) => string) | undefined;
+    promptChangePivotColumnsDescription?: ((column: string, direction: string) => string) | undefined;
+    promptChangePivotRowsLabel?: ((count: number) => string) | undefined;
+    promptChangePivotValuesLabel?: ((count: number) => string) | undefined;
+    promptChangePivotValuesDescription?: ((column: string, aggregation: string) => string) | undefined;
+    promptChangeChartsLabel?: ((dimensionsCount: number, valuesCount: number) => string) | undefined;
+    promptFieldLabel?: string | undefined;
+    promptFieldPlaceholder?: string | undefined;
+    promptFieldPlaceholderWithRecording?: string | undefined;
+    promptFieldPlaceholderListening?: string | undefined;
+    promptFieldSpeechRecognitionNotSupported?: string | undefined;
+    promptFieldSend?: string | undefined;
+    promptFieldRecord?: string | undefined;
+    promptFieldStopRecording?: string | undefined;
+};
+
+/**
+ * La etiqueta BCP-47 para `toLocaleString` / `Intl.*` según el idioma activo.
+ *
+ * Está aquí para que no vuelva a haber tres `toLocaleString` con la etiqueta escrita a mano —y
+ * discrepando entre sí: había dos en `"es-MX"` y una en `"en-US"`—.
+ */
+declare const localeDeNumeros: (locale: Locale) => string;
+
+/** El `localeText` para Toolpad, o `undefined` cuando su propio idioma ya sirve. */
+declare const localeTextDeToolpad: (locale: Locale) => {
+    accountSignInLabel: string;
+    accountSignOutLabel: string;
+    accountPreviewTitle: string;
+    accountPreviewIconButtonLabel: string;
+    signInTitle: string;
+    signInSubtitle: string;
+    signInRememberMe: string;
+    providerSignInTitle: (proveedor: string) => string;
+    email: string;
+    password: string;
+    username: string;
+    passkey: string;
+    save: string;
+    cancel: string;
+    ok: string;
+    or: string;
+    to: string;
+    with: string;
+    close: string;
+    delete: string;
+    alert: string;
+    confirm: string;
+    loading: string;
+} | undefined;
+
 declare const mergeSettings: (baseSettings: object, mergingSettings?: object) => any;
 declare const filterQuery: ({ filters }: {
     filters: {
@@ -1844,10 +2355,11 @@ declare function resolveInitialState({ storageKey, disabled, initialState, colum
  * 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`.
+ * `-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 PAGE_SIZE_OPTIONS: (number | {
+declare const pageSizeOptions: (etiquetaTodos: string) => (number | {
     value: number;
     label: string;
 })[];
@@ -1862,6 +2374,12 @@ 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.
@@ -1878,6 +2396,17 @@ type ChipColor = StatusColor;
 type ChipOption = {
     value: string;
     label: string;
+    /**
+     * Etiquetas extra con las que **emparejar**, sin que ninguna llegue a mostrarse.
+     *
+     * Existe porque el backend manda la etiqueta y no el código
+     * (`serializers.CharField(source='get_estado_display')`), así que el emparejado real de casi
+     * todas las columnas de estado es contra el texto en español. En cuanto `label` se traduce,
+     * ese emparejado deja de encontrar nada y la celda sale **en blanco** —sin error, sin aviso—.
+     *
+     * Aquí se conserva el texto original: `label` es lo que se ve, `match` lo que se reconoce.
+     */
+    match?: string[];
 };
 declare const resolveChipOption: (value: unknown, options: ChipOption[]) => ChipOption | undefined;
 type ChipCellProps = {
@@ -2580,6 +3109,8 @@ interface DetailFormDrawerProps {
         /** @see DetailPageV2Props.slotProps.badge */
         badge?: {
             colors?: Record<string, StatusColor>;
+            /** @see DetailPageV2Props.slotProps.badge.options */
+            options?: ChipOption[];
         };
     };
 }
@@ -2698,6 +3229,11 @@ interface DrawerGridDrawerConfig {
     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;
@@ -3058,6 +3594,19 @@ interface DetailPageV2Props {
              * 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[];
         };
     };
 }
@@ -3141,11 +3690,29 @@ interface DetachedPage {
     title: string;
     path: string;
     breadcrumbs: Breadcrumb[];
+    /**
+     * El título en singular, para cuando la heurística no dé con él.
+     * @see MainLayoutPageHeaderProps.singularTitles
+     */
+    singularTitle?: string;
 }
 interface MainLayoutPageHeaderProps extends PageHeaderProps {
     fullScreen?: boolean;
     detachedPages?: DetachedPage[];
     documentTitleSuffix?: string;
+    /**
+     * Títulos en singular declarados a mano, indexados por la ruta de la página
+     * (`{ "/cobranza/ordenes-de-envio": "Orden de envío" }`).
+     *
+     * El singular se deduce del título de la navegación —"Embarques" nombra a sus
+     * registros "Embarque 1234" y a su formulario "Crear embarque"—, y deducirlo es una
+     * heurística: acierta en los plurales regulares y se queda corta en los que la
+     * morfología española no deja resolver ("Meses" y "Bases" se escriben igual y se
+     * singularizan distinto), en los títulos con dos núcleos ("Órdenes de envíos") y en
+     * los que no son un plural en absoluto. Aquí se declara el que haga falta.
+     * @see singularizarTitulo
+     */
+    singularTitles?: Record<string, string>;
     /**
      * El padding horizontal del panel de contenido, que el `MainLayout` le pasa tal cual.
      *
@@ -3233,6 +3800,16 @@ interface MainLayoutProps {
     detachedPages?: DetachedPage[];
     /** Sufijo del `document.title` (ej. "Embarques" => "Título | Embarques"). */
     documentTitleSuffix?: string;
+    /**
+     * Títulos en singular declarados a mano, indexados por la ruta de la página
+     * (`{ "/cobranza/ordenes-de-envio": "Orden de envío" }`).
+     *
+     * El `PageHeader` nombra los registros con el título de su página puesto en singular
+     * ("Embarques" → "Embarque 1234", "Crear embarque"), y lo deduce con una heurística
+     * de plurales españoles. Aquí se corrige la que no acierte.
+     * @see MainLayoutPageHeaderProps.singularTitles
+     */
+    singularTitles?: Record<string, string>;
     /**
      * Configuración del pie del sidebar por defecto: versión, copyright, aviso de
      * privacidad y enlace a las novedades. Cada pieza se pinta sólo si se pasa.
@@ -3356,6 +3933,18 @@ interface MainLayoutProps {
 declare const SIDE_PANEL_WIDTH_VAR = "--acv-side-panel-width";
 declare const MainLayout: (props: MainLayoutProps) => react_jsx_runtime.JSX.Element;
 
+/**
+ * Pasa a singular una palabra suelta. Devuelve la palabra tal cual cuando no reconoce un
+ * plural, que es el modo seguro de fallar: un título sin tocar se lee bien igual.
+ */
+declare function singularizarPalabra(palabra: string): string;
+/**
+ * Pasa a singular un título completo, que es pasar a singular su núcleo: todas las
+ * palabras hasta el primer conector —"Notas rojas" → "Nota roja"— y ninguna después
+ * —"Órdenes de envío" → "Orden de envío"—.
+ */
+declare function singularizarTitulo(titulo: string): string;
+
 interface PageInfoProps {
     /**
      * La nota. Admite marcado —negritas, listas, enlaces—, así que puede ser lo mismo
@@ -3405,7 +3994,7 @@ interface PageInfoHost {
  * Fuera de un `MainLayout` el contexto es `null` y `<PageInfo>` no pinta nada, en vez de
  * soltar el botón en medio del contenido.
  */
-declare const PageInfoHostContext: React.Context<PageInfoHost | null>;
+declare const PageInfoHostContext: React$1.Context<PageInfoHost | null>;
 /** El hueco de la nota del encabezado, o `null` si no hay ninguno arriba. */
 declare const usePageInfoHost: () => PageInfoHost | null;
 
@@ -3433,7 +4022,7 @@ interface PageActionsHost {
  * Fuera de un `MainLayout` el contexto es `null`, y quien lo use se las arregla por su cuenta
  * —la página de detalle vuelve a la esquina flotante de siempre—.
  */
-declare const PageActionsHostContext: React.Context<PageActionsHost | null>;
+declare const PageActionsHostContext: React$1.Context<PageActionsHost | null>;
 /** El hueco de las acciones del encabezado, o `null` si no hay ninguno arriba. */
 declare const usePageActionsHost: () => PageActionsHost | null;
 
@@ -3458,7 +4047,7 @@ interface PageBadgeHost {
  * Fuera de un `MainLayout` el contexto es `null` y la página de detalle vuelve a colgar la
  * insignia de la esquina flotante del `ContentLayout`, que es donde vivía.
  */
-declare const PageBadgeHostContext: React.Context<PageBadgeHost | null>;
+declare const PageBadgeHostContext: React$1.Context<PageBadgeHost | null>;
 /** El hueco de la insignia del encabezado, o `null` si no hay ninguno arriba. */
 declare const usePageBadgeHost: () => PageBadgeHost | null;
 
@@ -3485,7 +4074,7 @@ interface StickyPageHeaderHost {
  * Fuera de un `MainLayout` el contexto es `null` y no pasa nada: el encabezado de ese proyecto
  * se queda como estaba.
  */
-declare const StickyPageHeaderContext: React.Context<StickyPageHeaderHost | null>;
+declare const StickyPageHeaderContext: React$1.Context<StickyPageHeaderHost | null>;
 /** Lo lee el encabezado para saber si le toca pegarse. */
 declare const useStickyPageHeaderHost: () => StickyPageHeaderHost | null;
 /**
@@ -3761,5 +4350,5 @@ 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, Logo, MainDrawer, MainDrawer$1 as MainDrawer_v2, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, NotificationItem, NotificationsBell, ObjectProgressStack, PAGE_SIZE_OPTIONS, PageActionsHostContext, PageBadgeHostContext, PageInfo, PageInfoHostContext, Panel, PollingCountdownChip, PulseDot, RESPONSIVE_ACTION_MODES, ResponsiveActions, SIDE_PANEL_WIDTH_VAR, SaveCancelButton, ServerGrid as ServerGrid_v2, SidePanelHostContext, StatusBadge, StickyPageHeaderContext, StyledMenu, Tabs, Transitions, TrueFalse, UncontrolledText, changeTitle, closeProgressSnack, composeGridProps, deleteColumn$1 as deleteColumn, deleteColumn as deleteColumn_v2, editColumn, filterQuery, formContainerSx, formGridSx, formParser, headerContainerSx, _default as headerReducer, manualCacheRefresh, mergeSettings, openProgressSnack, query, renderChipCell, renderEditCellWithErrorTooltip, resolveChipOption, resolveInitialState, resolveStatusColor, setErrors, _default$1 as snackProgressReducer, statusColors, tags, theme, togglableFields, updateProgressSnackData, useAPI, useColorMode, useDetailForm, useHasPermission, useHasPermission_v2, useKeyboardShortcut, useMutationHandler, useNavigation, usePageActionsHost, usePageBadgeHost, usePageInfoHost, useServerGrid, useSidePanelHost, useStickyPageHeader, useStickyPageHeaderHost, 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, 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, UseColorModeResult, UseServerGridOptions };
+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 };