@acvl/frontend-components 0.0.69 → 0.0.71

package/dist/index.d.ts

@@ -953,17 +953,17 @@ declare const LoadingComponent: React__default.FC<LoadingComponentProps>;
 /**
  * Muestra el logo de la empresa
  *
- * El archivo de marca es un JPG con fondo blanco, bola roja y letras negras: tal
- * cual, en modo oscuro se ve un recuadro blanco. Como no hay versión clara del
- * archivo, en oscuro se recolorea por CSS a blanco sobre transparente.
+ * El archivo de marca es un PNG con fondo transparente, bola roja y letras
+ * negras. En claro va tal cual; en oscuro las letras negras desaparecerían
+ * contra el fondo, así que se recolorea por CSS a blanco.
 **/
 interface LogoProps {
     /** Altura máxima en px. */
     maxHeight?: number;
     /**
-     * Logo alternativo para modo oscuro. Lo suyo es un SVG o PNG blanco con fondo
-     * transparente: en cuanto exista, pasarlo aquí sustituye el recoloreado por
-     * el archivo de verdad sin tocar nada más.
+     * Logo alternativo para modo oscuro. Lo suyo es una versión blanca de la
+     * marca: en cuanto exista, pasarla aquí sustituye el recoloreado por el
+     * archivo de verdad sin tocar nada más.
      */
     darkSrc?: string;
 }
@@ -983,11 +983,10 @@ interface MyTabProps {
     /**
      * Alto que se ajusta al contenido, con `ALTO` de tope, en vez del alto fijo de siempre.
      *
-     * El default arma la cadena de altos con porcentajes: el contenedor mide `ALTO`, el de
-     * los paneles 93.5% de él y cada panel 100% del anterior. Eso sólo funciona con un alto
-     * definido arriba — si el contenedor midiera `100%` de un padre sin alto, toda la cadena
-     * resuelve a `auto` y lo de adentro (un DataGrid, por ejemplo) crece con su contenido y
-     * se desborda.
+     * El default llena el alto del padre y reparte por flex: los botones ceden lo suyo y el
+     * resto se lo queda el contenido. Si el padre no tiene alto definido —un `Tabs` dentro
+     * de un formulario o de un cajón—, ese `100%` resuelve a `auto` y toda la cadena se
+     * quedaría sin alto, así que ahí entra `ALTO` como mínimo.
      *
      * Con `fitContent` la cadena es flex: el contenedor no fija alto, sólo `maxHeight`, y
      * cada eslabón va con `flex: 1 1 auto` + `minHeight: 0` para poder encoger. Las pestañas
@@ -1374,6 +1373,12 @@ interface CustomFilterDef {
     defaultValue?: any;
 }
 
+/**
+ * Where the filter panel renders. `"drawer"` (the default) docks it to the right of the rows;
+ * `"popper"` floats it off the toolbar button, the way it used to.
+ */
+type FiltersVariant = "drawer" | "popper";
+
 /**
  * What the grid hands its RTK lazy query — the corrected `GridArgs`.
  *
@@ -1500,6 +1505,30 @@ interface ServerGridProps {
          * filter. The grid has no notion of who is looking at it.
          */
         customFilters?: CustomFilterDef[];
+        /**
+         * Where the filters panel goes. Defaults to `"drawer"`: docked to the right of the
+         * rows, taking its own column, so a filter and what it did to the list are on screen
+         * together and the panel survives being used — applying no longer dismisses it.
+         *
+         * `"popper"` is the old floating panel, hanging off the toolbar button.
+         *
+         * A grid too narrow to dock into falls back to the popper on its own, so this rarely
+         * needs setting for width's sake alone — see `filtersMinGridWidth`.
+         */
+        filtersVariant?: FiltersVariant;
+        /** Width of the docked filters panel, in px. Defaults to `340`. Ignored by the popper. */
+        filtersWidth?: number;
+        /**
+         * How much room the rows must keep for the panel to dock at all, in px. Defaults to
+         * `480`.
+         *
+         * The grid measures itself — not the window, since the same grid is a full page on one
+         * route and a panel inside a drawer on the next — and falls back to the popper whenever
+         * `filtersWidth` wouldn't leave this much behind. Raise it for grids with wide columns
+         * that need more room before the trade is worth it; `0` turns the fallback off and
+         * docks at any width.
+         */
+        filtersMinGridWidth?: number;
         /** Skip session persistence entirely. */
         dontSaveState?: boolean;
         /**
@@ -1625,6 +1654,13 @@ interface ServerGridState {
     /** Toolbar collapse, hoisted here so shortcuts can reopen a collapsed toolbar. */
     toolbarExpanded: boolean;
     setToolbarExpanded: Dispatch<SetStateAction<boolean>>;
+    /**
+     * Whether the filter panel is showing. Up here rather than in the toolbar because the
+     * docked panel is a sibling of the grid, not a child of the button that opens it — and
+     * because Ctrl+Shift+F has to reach it from a collapsed toolbar either way.
+     */
+    filtersOpen: boolean;
+    setFiltersOpen: Dispatch<SetStateAction<boolean>>;
     /** Exactly what was last sent to the server. Also feeds the CSV export. */
     args: ServerGridArgs;
     refetch: () => void;
@@ -1732,6 +1768,22 @@ interface DeleteGridColumnsProps {
  */
 declare const deleteColumn: (props: DeleteGridColumnsProps) => GridColDefPropsOverrides[];
 
+type ChipColor = "primary" | "secondary" | "error" | "warning" | "info" | "success";
+type ChipOption = {
+    value: string;
+    label: string;
+};
+declare const resolveChipOption: (value: unknown, options: ChipOption[]) => ChipOption | undefined;
+type ChipCellProps = {
+    value?: unknown;
+    options: ChipOption[];
+    colors?: Record<string, ChipColor>;
+};
+declare const ChipCell: ({ value, options, colors }: ChipCellProps) => react_jsx_runtime.JSX.Element | null;
+declare const renderChipCell: (options: ChipOption[], colors?: Record<string, ChipColor>) => ({ value }: {
+    value?: unknown;
+}) => react_jsx_runtime.JSX.Element;
+
 /**
  * Datos que recibe el renderizado de detalle de un input. Es un subconjunto de
  * `FieldProps` (los campos que necesita la vista de solo lectura), más un
@@ -2154,6 +2206,27 @@ interface DetailFormProps {
  */
 declare function DetailForm({ controller, formId, storageKey, 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 —
+ * next to the ones the shell provides on its own (editar, eliminar, historial).
+ *
+ * The same shape drives every shell that shows a record, so the buttons of a full page can be
+ * handed to its drawer without rewriting them (see `resolveExtraButtons`).
+ */
+interface DetailExtraButton {
+    /** Mode the action belongs to. `"all"` shows it in every one. */
+    pageType: PageType | "all";
+    title: string;
+    icon: ReactNode;
+    /** Receives the loaded record — `undefined` in create mode, where there is none yet. */
+    onClick: (data: any) => void;
+    /**
+     * Condition on top of `pageType`, checked against the loaded record. Typically one of its
+     * own flags (`puede_cerrar`), so what the backend allows is what the user sees.
+     */
+    display?: (data: any) => boolean;
+}
+
 interface DetailFormDrawerNavigation {
     /** Open the previous record of the list the drawer is walking. */
     onPrev: () => void;
@@ -2192,6 +2265,18 @@ interface DetailFormDrawerProps {
     permissionsPath?: string;
     /** Runs after a successful mutation, before the drawer closes. Receives the response. */
     onSuccess?: (response: any) => void;
+    /**
+     * Acciones propias del registro —cerrar, revertir, descargar su PDF—, las mismas que
+     * `DetailPage_v2` recibe en `slots.extraButtons` y con la misma forma, para que un registro
+     * traiga sus acciones se abra en su página o en el cajón.
+     *
+     * Van en un menú "⋮" de la cabecera —no como iconos sueltos— porque la cabecera del cajón
+     * es angosta y ya carga Editar, Eliminar y lo que venga en `slots.headerActions`; el menú
+     * además las nombra, igual que el de la página completa. Se filtran contra el modo que el
+     * cajón muestra *en ese momento*: entrar a editar esconde las de `"detail"`, como en la
+     * página. `display` y `onClick` reciben el registro cargado.
+     */
+    extraButtons?: DetailExtraButton[];
     /**
      * Footer record navigator: prev/next arrows (Alt+↑ / Alt+↓) that step through a list of
      * sibling records — e.g. the rows of the grid the drawer was opened from — without
@@ -2262,14 +2347,16 @@ interface DetailFormDrawerProps {
  * A record form inside a side drawer. Reuses the same `useDetailForm` engine and
  * `DetailForm` body as `DetailPage_v2`, and `MainDrawer_v2` for the chrome — so it frames
  * the form exactly like every other v2 drawer. What it adds on top is the per-record
- * furniture: edit/delete in the header, and a footer holding the form actions and, when
+ * furniture: edit/delete in the header — plus the record's own actions, when the consumer
+ * hands them over in `extraButtons`, in a "⋮" menu beside them — and a footer holding the
+ * form actions and, when
  * `navigation` is given, a prev/next record navigator (Alt+↑ / Alt+↓) plus "Guardar ↓"
  * (Alt+Shift+↓) — a save that steps to the next record instead of closing, so a column can be
  * captured down a list in one pass without the hands leaving the keyboard. Rename it with
  * `labels.saveAndNext`. Guardar sits outside the `<form>` and submits via the native
  * `form={formId}` attribute; Guardar ↓ submits by hand, so the implicit Enter stays Guardar.
  */
-declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, permissionsPath, onSuccess, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
+declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, permissionsPath, onSuccess, extraButtons, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, 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`. */
@@ -2343,6 +2430,14 @@ interface DrawerGridDrawerConfig {
             mutation: any;
         };
     };
+    /**
+     * Acciones propias del registro —las mismas que su página completa recibe en
+     * `DetailPage_v2`'s `slots.extraButtons`, y con la misma forma—, en un menú "⋮" de la
+     * cabecera del cajón. Se filtran por modo y por `display(registro)`, así que las de la
+     * página se pasan tal cual: abrir el renglón en el cajón deja de ser una versión recortada
+     * de abrirlo en su página.
+     */
+    extraButtons?: DetailExtraButton[];
     /** Runs after any successful create/edit (e.g. side effects; the grid refetches via RTK tag invalidation). */
     onSaved?: (response: any) => void;
     /**
@@ -2469,6 +2564,8 @@ interface ActionsMenuProps {
         icon: ReactNode;
         onClick: () => void;
     }[];
+    /** Tamaño del botón que abre el menú. `"small"` para las cabeceras del cajón. */
+    size?: "small" | "medium";
 }
 
 interface DetailPageV2Props {
@@ -2493,13 +2590,14 @@ interface DetailPageV2Props {
     containerBreakpoints?: DetailFormProps["containerBreakpoints"];
     slots?: {
         button?: ReactNode;
-        extraButtons?: {
-            pageType: PageType | "all";
-            title: string;
-            icon: ReactNode;
-            onClick: (data: any) => void;
-            display?: (data: any) => boolean;
-        }[];
+        /**
+         * Acciones propias del registro, junto a las del armazón. En `"detail"` viven dentro
+         * del menú de acciones; en alta y edición, como iconos al lado de Guardar.
+         *
+         * Las mismas se le pueden pasar al cajón de `DrawerGrid_v2` (`drawer.extraButtons`),
+         * para que el registro traiga sus acciones se abra donde se abra.
+         */
+        extraButtons?: DetailExtraButton[];
         badge?: string;
     };
     slotProps?: {
@@ -2671,8 +2769,8 @@ interface MainLayoutProps {
     /**
      * Separación en px entre el contorno y el panel de contenido, a la derecha
      * y abajo (arriba y a la izquierda el contenido va a ras del header y del
-     * sidebar). Se descuenta de la altura del área de trabajo para que el
-     * contenido siga cabiendo sin scroll extra.
+     * sidebar). Al ser margen del scroll container, el área de trabajo lo
+     * descuenta sola y el contenido sigue cabiendo sin scroll extra.
      */
     contentGap?: number;
     /**
@@ -2850,5 +2948,5 @@ interface PulseDotProps {
  *  contrario un color fijo. Se usa para indicar conexión/actividad en vivo. */
 declare function PulseDot({ active, inactiveColor, size, title }: PulseDotProps): react_jsx_runtime.JSX.Element;
 
-export { APIContext, APIProvider, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, COLOR_SCHEME_SELECTOR, CSVUpload, ConfirmDialog, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, 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, ExtraButtons, FORM_CONTAINER_NAME, HistorialDrawer, KpiCard, LAYER_ORDER, ListPage, Loadable, LoadingComponent, Logo, MainDrawer, MainDrawer$1 as MainDrawer_v2, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, ObjectProgressStack, PAGE_SIZE_OPTIONS, Panel, PollingCountdownChip, PulseDot, SIDE_PANEL_WIDTH_VAR, SaveCancelButton, ServerGrid as ServerGrid_v2, SidePanelHostContext, StatusBadge, StyledMenu, Tabs, Transitions, TrueFalse, UncontrolledText, changeTitle, closeProgressSnack, composeGridProps, deleteColumn$1 as deleteColumn, deleteColumn as deleteColumn_v2, editColumn, filterQuery, formContainerSx, formGridSx, formParser, _default as headerReducer, manualCacheRefresh, mergeSettings, openProgressSnack, query, renderEditCellWithErrorTooltip, resolveInitialState, setErrors, _default$1 as snackProgressReducer, tags, theme, togglableFields, updateProgressSnackData, useAPI, useColorMode, useDetailForm, useHasPermission, useHasPermission_v2, useKeyboardShortcut, useMutationHandler, useNavigation, useServerGrid, useSidePanelHost, valueLabel };
-export type { APIcontextProps, AddressValue, AppTheme, ColorMode, ComoOpcionesProps, ConfirmDialogProps, ControlledInput, CustomFilterDef, CustomToolbarProps, DeleteGridColumnsProps$1 as DeleteGridColumnsProps, DetachedPage, DetailFormApi, DetailFormConfig, DetailFormController, DetailFormDialogProps, DetailFormDrawerNavigation, DetailFormDrawerProps, DetailFormProps, DetailFormStatus, DetailPageV2Props, DetailRenderProps, DrawerGridDrawerConfig, DrawerGridEditConfig, DrawerGridProps, EditGridColumnsProps, EditReadOnlyFields, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, FilterInput, FormBreakpoint, FormGridSxOptions, GridArgs, GridColDefPropsOverrides, GridLayerContribution, GridLayerId, GridLayerMap, JSONFormProps, JSONParserProps, KeyboardShortcut, KpiCardProps, MainDrawerV2Props, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, PageType, PanelProps, PollingCountdownChipProps, ProgressStatusProps, PulseDotProps, RowsSnapshot, ServerGridArgs, ServerGridCreateApi, ServerGridDataApi, ServerGridDeleteApi, ServerGridEditApi, ServerGridEditToggleApi, ServerGridHandle, ServerGridProps, ServerGridSnapshot, ServerGridState, SidePanelHost, UseColorModeResult, UseServerGridOptions };
+export { APIContext, APIProvider, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, COLOR_SCHEME_SELECTOR, CSVUpload, ChipCell, ConfirmDialog, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, 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, ExtraButtons, FORM_CONTAINER_NAME, HistorialDrawer, KpiCard, LAYER_ORDER, ListPage, Loadable, LoadingComponent, Logo, MainDrawer, MainDrawer$1 as MainDrawer_v2, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, ObjectProgressStack, PAGE_SIZE_OPTIONS, Panel, PollingCountdownChip, PulseDot, SIDE_PANEL_WIDTH_VAR, SaveCancelButton, ServerGrid as ServerGrid_v2, SidePanelHostContext, StatusBadge, StyledMenu, Tabs, Transitions, TrueFalse, UncontrolledText, changeTitle, closeProgressSnack, composeGridProps, deleteColumn$1 as deleteColumn, deleteColumn as deleteColumn_v2, editColumn, filterQuery, formContainerSx, formGridSx, formParser, _default as headerReducer, manualCacheRefresh, mergeSettings, openProgressSnack, query, renderChipCell, renderEditCellWithErrorTooltip, resolveChipOption, resolveInitialState, setErrors, _default$1 as snackProgressReducer, tags, theme, togglableFields, updateProgressSnackData, useAPI, useColorMode, useDetailForm, useHasPermission, useHasPermission_v2, useKeyboardShortcut, useMutationHandler, useNavigation, useServerGrid, useSidePanelHost, valueLabel };
+export type { APIcontextProps, AddressValue, AppTheme, ChipCellProps, ChipColor, ChipOption, ColorMode, ComoOpcionesProps, ConfirmDialogProps, ControlledInput, CustomFilterDef, CustomToolbarProps, DeleteGridColumnsProps$1 as DeleteGridColumnsProps, DetachedPage, DetailExtraButton, DetailFormApi, DetailFormConfig, DetailFormController, DetailFormDialogProps, DetailFormDrawerNavigation, DetailFormDrawerProps, DetailFormProps, DetailFormStatus, DetailPageV2Props, DetailRenderProps, DrawerGridDrawerConfig, DrawerGridEditConfig, DrawerGridProps, EditGridColumnsProps, EditReadOnlyFields, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, FilterInput, FormBreakpoint, FormGridSxOptions, GridArgs, GridColDefPropsOverrides, GridLayerContribution, GridLayerId, GridLayerMap, JSONFormProps, JSONParserProps, KeyboardShortcut, KpiCardProps, MainDrawerV2Props, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, PageType, PanelProps, PollingCountdownChipProps, ProgressStatusProps, PulseDotProps, RowsSnapshot, ServerGridArgs, ServerGridCreateApi, ServerGridDataApi, ServerGridDeleteApi, ServerGridEditApi, ServerGridEditToggleApi, ServerGridHandle, ServerGridProps, ServerGridSnapshot, ServerGridState, SidePanelHost, UseColorModeResult, UseServerGridOptions };

package/package.json

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