@acvl/frontend-components 0.0.101 → 0.0.103

package/dist/index.d.ts

@@ -785,7 +785,8 @@ interface MainDrawerV2Props {
      * queda donde esté declarado.
      *
      * El hueco es uno solo y se turnan: abrir un panel encoge al que estuviera puesto, y
-     * cerrarlo le devuelve el turno. Nunca se reparten el ancho entre varios.
+     * cerrarlo le devuelve el turno. Nunca se reparten el ancho entre varios. Un panel
+     * flotante no entra en el turno: se abre encima y el acoplado sigue puesto debajo.
      *
      * En acoplado el ancho se anima al abrir y cerrar, y `anchor` sólo decide de qué
      * lado va el tirador de arrastre: la posición la fija el contenedor. `slotProps.drawer`
@@ -847,6 +848,11 @@ interface MainDrawerV2Props {
         footer?: ReactNode;
     };
     slotProps?: {
+        /**
+         * Props del `Drawer` flotante. Su `sx` se concatena después del propio, así que un
+         * `zIndex` aquí gana sobre el de la librería: 1202, o `theme.zIndex.modal` dentro de
+         * un `OverModalContext` en `true`.
+         */
         drawer?: Partial<DrawerProps>;
         /** Estilos del `Paper`; se aplican después de los propios, así que ganan. */
         paper?: {
@@ -883,6 +889,10 @@ interface MainDrawerV2Props {
  * Con `variant="docked"` el mismo panel se acopla en el flujo en vez de flotar: sin backdrop,
  * encogiendo a lo que tenga al lado en lugar de taparlo, de modo que la página de atrás sigue
  * usable con el panel abierto. Ver el `sidePanel` de `MainLayout`.
+ *
+ * El flotante que cuelga de un modal —dentro de un `OverModalContext` en `true`— sube al nivel
+ * del modal para no abrirse detrás de él. Todo lo que la librería construye sobre este panel
+ * (`DetailFormDrawer_v2`, `DrawerGrid_v2`, el historial…) lo hereda sin más.
  */
 declare function MainDrawer$1({ open, onClose, title, subtitle, children, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, disableBackdropClose, hideCloseButton, disableGutters, pageBackgroundColor, chromeBackgroundColor, contentGap, contentBorderRadius, slots, slotProps, }: MainDrawerV2Props): react_jsx_runtime.JSX.Element;
 
@@ -900,6 +910,9 @@ interface SidePanelHost {
      *
      * La identidad la pone el propio panel (un `useId`). Hay que soltar el turno al
      * desmontar, o el hueco se queda esperando a un panel que ya no existe.
+     *
+     * Sólo se anuncian los acoplados (ver `pideElHueco`): un panel flotante no ocupa el
+     * hueco, así que no tiene por qué quitárselo a nadie.
      */
     registrar: (id: string, abierto: boolean) => void;
     /**
@@ -926,6 +939,43 @@ 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;
 
+/**
+ * Nivel de un cajón flotante fuera de un modal: por encima del toolbar fijo de Toolpad (~1200),
+ * para que el panel y su backdrop cubran todo el viewport, pero por debajo de los modales (1300).
+ */
+declare const DRAWER_Z_INDEX = 1202;
+/**
+ * **Si lo que se pinta cuelga de un modal** (un `Dialog`), para que los cajones que abre queden
+ * encima de él y no escondidos detrás.
+ *
+ * Un `MainDrawer_v2` flotante vive a 1202 y los modales de MUI a 1300: un cajón abierto desde
+ * un diálogo se abriría detrás del diálogo que lo abrió. Con este contexto en `true` el cajón
+ * sube al nivel del modal (ver `drawerZIndex`) y, como se monta después, queda encima.
+ *
+ * Lo provee el modal —alrededor de lo que monta— y no cada cajón por prop, porque la cadena es
+ * larga y buena parte de ella la pinta la librería por dentro: el diálogo abre la ficha en un
+ * cajón, la ficha abre el historial en otro, una grilla de la ficha abre el suyo. El contexto
+ * cruza portales, así que llega a todos los de abajo sin que ninguno lo pase.
+ *
+ * Fuera de un modal vale `false` y los cajones se quedan a su nivel de siempre.
+ *
+ * `DetailFormDialog_v2` ya lo provee a su contenido.
+ */
+declare const OverModalContext: React$1.Context<boolean>;
+/** Provee `OverModalContext`: `<OverModalProvider value>` alrededor del contenido de un modal. */
+declare const OverModalProvider: React$1.Provider<boolean>;
+/** Si lo que se pinta cuelga de un modal (ver `OverModalContext`). */
+declare const useOverModal: () => boolean;
+/**
+ * El `zIndex` de un cajón flotante.
+ *
+ * Dentro de un modal va al nivel de los modales (`theme.zIndex.modal`), **no más arriba**: las
+ * listas, menús, popovers y diálogos que se abren desde el cajón también flotan a ese nivel y se
+ * montan después, así que siguen quedando encima de él. Entre cajones y modales del mismo nivel
+ * manda el orden de montaje: el último abierto queda arriba.
+ */
+declare const drawerZIndex: (theme: Pick<Theme, "zIndex">, overModal: boolean) => number;
+
 declare module "@mui/x-data-grid" {
     interface ToolbarPropsOverrides {
         handleClick: () => void;
@@ -3193,6 +3243,19 @@ interface DetailFormProps {
     formId?: string;
     /** Persist-tab key for multi-section forms. Defaults to `formId`. */
     storageKey?: string;
+    /**
+     * Pestaña con la que abre una ficha de varias secciones, por su **título**: el `label` que
+     * la sección declara y que la pestaña muestra. Se busca entre las secciones visibles, así
+     * que una sección escondida más arriba no la cambia por otra; si ninguna visible se llama
+     * así, abre en la primera. Ver `resolveTabPorTitulo`.
+     *
+     * Con ella la pestaña no se recuerda en `sessionStorage` —`storageKey` deja de aplicar—:
+     * quien la pasa decide dónde abre, y una visita anterior que le ganara no dejaría pedir
+     * nada. Se aplica al montar el cuerpo; después el usuario cambia de pestaña libremente.
+     * Para reaplicarla sin desmontar, el contenedor le cambia la `key` (ver
+     * `DetailFormDrawer_v2`).
+     */
+    initialTab?: string;
     /**
      * Bajo qué nombre recuerda el formulario lo que el usuario acomoda en él: hoy, cuáles
      * subsecciones dejó plegadas (ver `SubsectionProps.collapsible`).
@@ -3237,7 +3300,7 @@ interface DetailFormProps {
  * element and the section/tab render tree — no page layout, no header buttons. Compose it
  * inside a page, dialog or drawer shell that supplies the surrounding chrome.
  */
-declare function DetailForm({ controller, formId, storageKey, storageScope, loadingHeight, responsiveTo, containerBreakpoints, slotProps, }: DetailFormProps): react_jsx_runtime.JSX.Element;
+declare function DetailForm({ controller, formId, storageKey, initialTab, storageScope, loadingHeight, responsiveTo, containerBreakpoints, slotProps, }: DetailFormProps): react_jsx_runtime.JSX.Element;
 
 /**
  * An action the consumer hangs off a record's chrome — cerrar, revertir, descargar el PDF —
@@ -3840,6 +3903,20 @@ interface DetailFormDrawerProps {
      * read-only and `startInEdit` is re-applied against the new record's own permissions.
      */
     recordKey?: string | number;
+    /**
+     * Pestaña con la que abre el cajón cuando la ficha tiene varias secciones, por su
+     * **título**: el `label` que declara la sección, el mismo que muestra la pestaña —
+     * `initialTab="Paradas"`—. Se busca entre las visibles, así que esconder una sección de
+     * arriba no la cambia por otra; si ninguna visible se llama así, abre en la primera.
+     *
+     * Se aplica cada vez que el cajón se abre y cada vez que cambia `recordKey` —el navegador
+     * pasando de registro—; entre una cosa y otra el usuario cambia de pestaña y nadie se la
+     * regresa. Con ella la pestaña no se recuerda de una apertura a otra: sin ella todo sigue
+     * como antes.
+     *
+     * @see DetailFormProps.initialTab
+     */
+    initialTab?: string;
     permissionsPath?: string;
     /** Runs after a successful mutation, before the drawer closes. Receives the response. */
     onSuccess?: (response: any) => void;
@@ -3988,7 +4065,7 @@ interface DetailFormDrawerProps {
  * deja el registro en pantalla y editando — para formularios que se capturan de a poco o que
  * llevan una grilla adentro.
  */
-declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, permissionsPath, onSuccess, keepOpenOnSave, extraButtons, historial, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, storageScope, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
+declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, initialTab, permissionsPath, onSuccess, keepOpenOnSave, extraButtons, historial, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, storageScope, 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`. */
@@ -4305,7 +4382,8 @@ interface DetailFormDialogProps {
      * de la ruta, y la ruta de un diálogo es la de la pantalla de atrás, no la del registro.
      *
      * El panel va flotando por fuerza: un diálogo es modal, y uno acoplado se pintaría en el
-     * hueco del layout, o sea por debajo de su backdrop.
+     * hueco del layout, o sea por debajo de su backdrop. Y flota al nivel del diálogo, no
+     * detrás de él: el diálogo provee `OverModalContext` a todo lo que monta.
      */
     historial?: DetailActionsProps["historial"];
     labels?: {
@@ -5094,5 +5172,5 @@ declare const mutationParams: (arg: any) => {
  */
 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, GrillaHastaElFondo, HEADER_CONTAINER, HEADER_NARROW, HiddenPageHeaderContext, 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, StyledToggleButtonGroup, TEXTOS, Tabs, Transitions, TrueFalse, UncontrolledText, aplicarLocaleDeDayjs, buildEstadoTabs, 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, useHiddenPageHeader, useHiddenPageHeaderHost, useKeyboardShortcut, useLocale, useMutationHandler, useNavigation, usePageActionsHost, usePageBadgeHost, usePageInfoHost, useServerGrid, useSidePanelHost, useStickyPageHeader, useStickyPageHeaderHost, useTextos, valueLabel };
+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, DRAWER_Z_INDEX, 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, GrillaHastaElFondo, HEADER_CONTAINER, HEADER_NARROW, HiddenPageHeaderContext, 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, OverModalContext, OverModalProvider, PageActionsHostContext, PageBadgeHostContext, PageInfo, PageInfoHostContext, Panel, PollingCountdownChip, PulseDot, RESPONSIVE_ACTION_MODES, ResponsiveActions, SIDE_PANEL_WIDTH_VAR, SaveCancelButton, ServerGrid as ServerGrid_v2, SidePanelHostContext, StatusBadge, StickyPageHeaderContext, StyledMenu, StyledToggleButtonGroup, TEXTOS, Tabs, Transitions, TrueFalse, UncontrolledText, aplicarLocaleDeDayjs, buildEstadoTabs, changeTitle, closeProgressSnack, columnasDeCatalogo, composeGridProps, crearFabricaDeCatalogos, deleteColumn$1 as deleteColumn, deleteColumn as deleteColumn_v2, drawerZIndex, 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, useHiddenPageHeader, useHiddenPageHeaderHost, useKeyboardShortcut, useLocale, useMutationHandler, useNavigation, useOverModal, usePageActionsHost, usePageBadgeHost, usePageInfoHost, useServerGrid, useSidePanelHost, useStickyPageHeader, useStickyPageHeaderHost, useTextos, valueLabel };
 export type { APIcontextProps, AccountMenuContentProps, AccountMenuItem, AddressValue, AppTheme, AutocompleteOption, BuildEstadoTabsOptions, CSVMenuOptionProps, 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, EstadoDeFiltro, EstadoTabConfig, ExportCSVProps as ExportCSVProps_v2, ExtraCreateOptionProps, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, FilterInput, FormBreakpoint, FormGridSxOptions, GlobalSearchOption, GlobalSearchProps, GridArgs, GridColDefPropsOverrides, GridLayerContribution, GridLayerId, GridLayerMap, GrillaHastaElFondoProps, HiddenPageHeaderHost, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@acvl/frontend-components",
-    "version": "0.0.101",
+    "version": "0.0.103",
     "description": "Component library for ACV frontend projects.",
     "homepage": "https://github.com/ACV-Logistics/acv-frontend-components#readme",
     "access": "public",