@acvl/frontend-components 0.0.76 → 0.0.78

package/dist/index.d.ts

@@ -2478,6 +2478,22 @@ interface DetailFormDrawerProps {
     permissionsPath?: string;
     /** Runs after a successful mutation, before the drawer closes. Receives the response. */
     onSuccess?: (response: any) => void;
+    /**
+     * Guardar deja el cajón abierto —y editando— en vez de cerrarlo. El usuario lo cierra
+     * cuando termina, con la X o con Cancelar.
+     *
+     * Para registros que se capturan de a poco, o que llevan dentro su propia grilla editable:
+     * ahí cerrar al guardar cuesta reabrir el registro, volver a entrar a editar y volver a
+     * bajar hasta donde se iba. El caso que lo pide es un cajón anidado —una orden de envío
+     * abierta desde la pestaña de su embarque, con la grilla de sus recibos adentro—, donde el
+     * cierre además se lleva la grilla de en medio.
+     *
+     * Un guardado que **no** guardó igual cierra: `useMutationHandler` corre su `onSuccess` sin
+     * respuesta ante un 403 para quitar la pantalla de en medio, y eso no es algo en lo que
+     * quedarse. Tampoco compite con "Guardar ↓" — ése ya se queda abierto por su cuenta, y
+     * cuando los dos aplican gana el paso al siguiente registro, que es lo que se pidió.
+     */
+    keepOpenOnSave?: boolean;
     /**
      * 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
@@ -2579,8 +2595,12 @@ interface DetailFormDrawerProps {
  * 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.
+ *
+ * `keepOpenOnSave` cambia lo que hace Guardar cuando no hay a dónde avanzar: en vez de cerrar,
+ * 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, extraButtons, 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, keepOpenOnSave, 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`. */
@@ -2697,6 +2717,14 @@ interface DrawerGridDrawerConfig {
      * without a list to walk there is nothing to continue to.
      */
     showNavigator?: boolean;
+    /**
+     * Guardar deja el cajón abierto y editando en vez de cerrarlo; se cierra con la X o con
+     * Cancelar. Para registros que se capturan de a poco, o que llevan su propia grilla
+     * editable adentro y perderían el lugar al cerrarse.
+     *
+     * @see DetailFormDrawerProps.keepOpenOnSave
+     */
+    keepOpenOnSave?: boolean;
     /** Rótulos del pie del cajón. `saveAndNext` por defecto es `"Guardar ↓"`. */
     labels?: {
         save?: string;
@@ -2756,6 +2784,10 @@ interface DrawerGridProps {
  * open-edit-save-reopen per row — and with the shortcut, without leaving the keyboard. It
  * rides on the navigator — no navigator, or last row, and there is just Guardar.
  *
+ * `drawer.keepOpenOnSave` hace que Guardar no cierre: el registro se queda en pantalla y
+ * editando. Vale la pena donde el cajón lleva su propia grilla adentro —cerrarlo se lleva
+ * también lo que se estaba capturando ahí— o donde el registro se llena en varias pasadas.
+ *
  * Edit mode is opt-in with `api.edit: {}` and adds nothing to the grid but a toolbar toggle —
  * no mutation, no actions column, no in-grid editing. While it's on, a row click opens the
  * record drawer already editing, provided the record allows it; the drawer form is the only
@@ -3109,11 +3141,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.
      *
@@ -3201,6 +3251,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.
@@ -3324,6 +3384,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
@@ -3729,5 +3801,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 { 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, singularizarPalabra, singularizarTitulo, _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 };

package/package.json

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