@acvl/frontend-components 0.0.102 → 0.0.104

package/dist/index.d.ts

@@ -793,6 +793,21 @@ interface MainDrawerV2Props {
      * y `slotProps.paper` no aplican —no hay `Drawer` ni `Paper` que configurar.
      */
     variant?: "temporary" | "docked";
+    /**
+     * Conserva montados a los hijos cuando `variant` cambia con el panel ya puesto —el que se
+     * acopla en pantalla ancha y flota en la angosta, al cruzar el breakpoint—. Sin esto las
+     * dos variantes son árboles distintos, y el cambio desmonta lo que llevan: un mapa, un
+     * formulario a medias o una grilla vuelven a empezar.
+     *
+     * Los hijos viven entonces en su propio nodo, que se cuelga del cuerpo de la variante
+     * activa, y siguen montados también con el panel cerrado (como con `keepMounted`). A
+     * cambio, sus eventos de React suben hasta quien declara el panel y no pasan por el
+     * `Drawer` ni por el cuerpo: los manejadores de `slotProps.drawer` y `slotProps.body` ya no
+     * los ven. El Escape del flotante lo atiende el propio panel.
+     *
+     * Se lee al montar el panel; cambiarla después no tiene efecto.
+     */
+    keepMountedAcrossVariants?: boolean;
     /**
      * Añade un tirador en el borde interior del panel para arrastrar su tamaño. Mientras el
      * usuario no lo arrastre, `width` manda; en cuanto lo hace, el tamaño arrastrado la pisa
@@ -848,6 +863,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,8 +904,12 @@ 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;
+declare function MainDrawer$1({ open, onClose, title, subtitle, children, width, anchor, variant, keepMountedAcrossVariants, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, disableBackdropClose, hideCloseButton, disableGutters, pageBackgroundColor, chromeBackgroundColor, contentGap, contentBorderRadius, slots, slotProps, }: MainDrawerV2Props): react_jsx_runtime.JSX.Element;
 
 interface SidePanelHost {
     /**
@@ -930,6 +954,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;
@@ -2849,6 +2910,33 @@ declare const HEADER_NARROW = "@container acv-header (max-width: 600px)";
  */
 declare const headerContainerSx: CSSObject;
 
+/**
+ * Radio en px de las esquinas del panel de contenido cuando `MainLayout` no recibe otro por
+ * `contentBorderRadius`.
+ */
+declare const DEFAULT_CONTENT_BORDER_RADIUS = 12;
+/**
+ * **El radio que tienen de verdad las esquinas del panel donde se pinta la página**, para que lo
+ * que va a sangre dentro de él —un mapa, un tablero— redondee con la misma curva sin repetir el
+ * número.
+ *
+ * Lo provee `MainLayout` con su `contentBorderRadius`, y `MainDrawer_v2` lo vuelve a proveer a
+ * su cuerpo con el suyo: dentro de un cajón el panel que rodea al contenido es el del cajón, y
+ * ése tiene su propio radio (por defecto `theme.shape.borderRadius`). El contexto cruza
+ * portales, así que un cajón acoplado en el hueco del layout también lo lee bien.
+ *
+ * Fuera de los dos vale `DEFAULT_CONTENT_BORDER_RADIUS`.
+ */
+declare const ContentBorderRadiusContext: React$1.Context<number>;
+/**
+ * El radio en px del panel de contenido que envuelve a quien lo pide (ver
+ * `ContentBorderRadiusContext`).
+ *
+ *     const radio = useContentBorderRadius();
+ *     <Box sx={{ borderRadius: `${radio}px` }} />
+ */
+declare const useContentBorderRadius: () => number;
+
 /**
  * Cómo se está dibujando la barra. En orden de lo que ocupa: las acciones a la vista con su
  * etiqueta, las mismas sólo con el icono, sólo las fijadas, o ninguna.
@@ -3493,6 +3581,31 @@ declare function PollingCountdownChip({ pollingInterval, isFetching, onRefresh,
  */
 declare function ServerGrid(props: ServerGridProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * The frame the filters panel draws around itself: border, rounded corners and surface.
+ *
+ * It is the frame the DataGrid draws around itself, read off the same tokens it reads: its
+ * border is `TableCell.border` rather than plain `divider`, and its surface is the paper colour
+ * lifted 5% towards white in dark mode. Matching both is the difference between one card beside
+ * another and two that only nearly agree — which is also why it is exported: anything a page
+ * docks beside a grid, or beside a map framed like one, should be the same card.
+ *
+ * Put `FILTERS_DRAWER_GAP` between the two cards. Only the frame lives here; layout (width,
+ * height, flex direction) stays with whoever places the panel.
+ *
+ *     <Box sx={(theme) => ({ ...filtersPanelFrameSx(theme), display: "flex" })} />
+ */
+declare const filtersPanelFrameSx: (theme: Theme$1) => CSSObject;
+
+/**
+ * Space in px between the grid's frame and the panel's.
+ *
+ * Carried inside the sliding column rather than as a `gap` on the row outside it: a gap would
+ * be full width the instant the panel mounts, so the grid would jump 12px sideways and only
+ * then start being pushed. This way the whole column — panel and margin — animates as one.
+ */
+declare const FILTERS_DRAWER_GAP = 12;
+
 /** Lo que vale un estado en el filtro: el entero de un `choices` o su clave de texto. */
 type EstadoDeFiltro = string | number;
 interface EstadoTabConfig {
@@ -4336,7 +4449,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?: {
@@ -4567,7 +4681,9 @@ interface MainLayoutProps {
     /**
      * 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.
+     * del sidebar con la misma curva. `0` deja el contenido a ras. Por defecto
+     * `DEFAULT_CONTENT_BORDER_RADIUS`; lo que se pinta dentro lo lee con
+     * `useContentBorderRadius()`.
      */
     contentBorderRadius?: number;
     /**
@@ -5125,5 +5241,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, ContentBorderRadiusContext, 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_CONTENT_BORDER_RADIUS, 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, FILTERS_DRAWER_GAP, 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, filtersPanelFrameSx, 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, useContentBorderRadius, 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.104",
     "description": "Component library for ACV frontend projects.",
     "homepage": "https://github.com/ACV-Logistics/acv-frontend-components#readme",
     "access": "public",