@acvl/frontend-components 0.0.102 → 0.0.103

package/dist/index.d.ts

@@ -848,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?: {
@@ -884,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;
 
@@ -930,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;
@@ -4336,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?: {
@@ -5125,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.102",
+    "version": "0.0.103",
     "description": "Component library for ACV frontend projects.",
     "homepage": "https://github.com/ACV-Logistics/acv-frontend-components#readme",
     "access": "public",