@acvl/frontend-components 0.0.51 → 0.0.53

package/dist/esm/types/src/components/v1/lib/hooks/index.d.ts

@@ -1,3 +1,4 @@
 export { useHasPermission } from './users';
 export { useAPI } from './api';
 export { useNavigation } from './navigation';
+export { useKeyboardShortcut, type KeyboardShortcut } from './useKeyboardShortcut';

package/dist/esm/types/src/components/v1/lib/hooks/useKeyboardShortcut.d.ts

@@ -0,0 +1,42 @@
+export interface KeyboardShortcut {
+    /** Tecla objetivo. Se compara con `event.key` sin distinguir mayúsculas (p. ej. "f", "e", "Escape"). */
+    key: string;
+    /** Requiere Ctrl. Si se omite, la tecla Ctrl debe estar ausente. */
+    ctrl?: boolean;
+    /** Requiere Shift. Si se omite, la tecla Shift debe estar ausente. */
+    shift?: boolean;
+    /** Requiere Alt. Si se omite, la tecla Alt debe estar ausente. */
+    alt?: boolean;
+    /** Requiere Meta/Cmd. Si se omite, la tecla Meta debe estar ausente. */
+    meta?: boolean;
+    /**
+     * No dispara el atajo mientras el foco está en un campo editable
+     * (`input`, `textarea`, `select` o `contentEditable`). Evita que atajos de
+     * una sola letra (p. ej. `Shift+F`) se traguen la tecla al escribir.
+     * Por defecto `true`.
+     */
+    ignoreWhenTyping?: boolean;
+    /** Llama a `event.preventDefault()` al coincidir. Por defecto `true`. */
+    preventDefault?: boolean;
+    /** Permite desactivar el atajo sin desmontar el componente. Por defecto `true`. */
+    enabled?: boolean;
+}
+/**
+ * Registra un atajo de teclado global (listener en `document`) y ejecuta
+ * `handler` cuando la combinación coincide.
+ *
+ * - Compara la tecla sin distinguir mayúsculas y exige el estado exacto de los
+ *   modificadores, de modo que `Ctrl+E` y `Ctrl+Shift+E` no colisionan entre sí.
+ * - Por defecto ignora el atajo mientras se escribe en un campo editable.
+ * - `handler` se lee siempre en su versión más reciente, así que no hace falta
+ *   memoizarlo con `useCallback` en el componente que lo usa.
+ *
+ * Llama al hook varias veces para registrar varios atajos en un mismo componente.
+ *
+ * @example
+ * useKeyboardShortcut({ key: "f", shift: true }, () => setFullScreen((p) => !p));
+ * useKeyboardShortcut({ key: "e", ctrl: true }, () => navigate("editar"));
+ * useKeyboardShortcut({ key: "Escape", shift: true, enabled: edit }, cancelEdit);
+ */
+export declare function useKeyboardShortcut(shortcut: KeyboardShortcut, handler: (event: KeyboardEvent) => void): void;
+export default useKeyboardShortcut;

package/dist/esm/types/src/components/v2/layout/pages/DetailPage/index.d.ts

@@ -13,6 +13,11 @@ export interface DetailPageV2Props {
             mutation: any;
             args?: any;
             disable?: boolean;
+            postAction?: {
+                after: "create" | "edit" | "both";
+                type: string;
+                node: ReactNode;
+            };
         };
         delete?: {
             mutation: any;

package/dist/index.d.ts

@@ -813,6 +813,48 @@ declare const useNavigation: () => {
     back: any;
 };
 
+interface KeyboardShortcut {
+    /** Tecla objetivo. Se compara con `event.key` sin distinguir mayúsculas (p. ej. "f", "e", "Escape"). */
+    key: string;
+    /** Requiere Ctrl. Si se omite, la tecla Ctrl debe estar ausente. */
+    ctrl?: boolean;
+    /** Requiere Shift. Si se omite, la tecla Shift debe estar ausente. */
+    shift?: boolean;
+    /** Requiere Alt. Si se omite, la tecla Alt debe estar ausente. */
+    alt?: boolean;
+    /** Requiere Meta/Cmd. Si se omite, la tecla Meta debe estar ausente. */
+    meta?: boolean;
+    /**
+     * No dispara el atajo mientras el foco está en un campo editable
+     * (`input`, `textarea`, `select` o `contentEditable`). Evita que atajos de
+     * una sola letra (p. ej. `Shift+F`) se traguen la tecla al escribir.
+     * Por defecto `true`.
+     */
+    ignoreWhenTyping?: boolean;
+    /** Llama a `event.preventDefault()` al coincidir. Por defecto `true`. */
+    preventDefault?: boolean;
+    /** Permite desactivar el atajo sin desmontar el componente. Por defecto `true`. */
+    enabled?: boolean;
+}
+/**
+ * Registra un atajo de teclado global (listener en `document`) y ejecuta
+ * `handler` cuando la combinación coincide.
+ *
+ * - Compara la tecla sin distinguir mayúsculas y exige el estado exacto de los
+ *   modificadores, de modo que `Ctrl+E` y `Ctrl+Shift+E` no colisionan entre sí.
+ * - Por defecto ignora el atajo mientras se escribe en un campo editable.
+ * - `handler` se lee siempre en su versión más reciente, así que no hace falta
+ *   memoizarlo con `useCallback` en el componente que lo usa.
+ *
+ * Llama al hook varias veces para registrar varios atajos en un mismo componente.
+ *
+ * @example
+ * useKeyboardShortcut({ key: "f", shift: true }, () => setFullScreen((p) => !p));
+ * useKeyboardShortcut({ key: "e", ctrl: true }, () => navigate("editar"));
+ * useKeyboardShortcut({ key: "Escape", shift: true, enabled: edit }, cancelEdit);
+ */
+declare function useKeyboardShortcut(shortcut: KeyboardShortcut, handler: (event: KeyboardEvent) => void): void;
+
 interface NavigationContextProps {
     children: ReactNode;
     hook: any;
@@ -1143,6 +1185,11 @@ interface DetailPageV2Props {
             mutation: any;
             args?: any;
             disable?: boolean;
+            postAction?: {
+                after: "create" | "edit" | "both";
+                type: string;
+                node: ReactNode;
+            };
         };
         delete?: {
             mutation: any;
@@ -1305,5 +1352,5 @@ declare const useMutationHandler: ({ mutationFn, form, onSuccess, onValidationEr
     }) => void;
 };
 
-export { APIContext, APIProvider, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, CSVUpload, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, 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, DeleteButton, DeleteConfirmationDialog, DetailPage$1 as DetailPage, DetailPage as DetailPage_v2, EditButton, ExportCSV, ExtraButtons, HistorialDrawer, ListPage, Loadable, LoadingComponent, Logo, MainDrawer, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, ObjectProgressStack, SaveCancelButton, StatusBadge, StyledMenu, Tabs, Transitions, UncontrolledText, changeTitle, closeProgressSnack, deleteColumn, editColumn, filterQuery, formParser, _default as headerReducer, manualCacheRefresh, mergeSettings, openProgressSnack, query, renderEditCellWithErrorTooltip, setErrors, _default$1 as snackProgressReducer, tags, theme, updateProgressSnackData, useAPI, useHasPermission, useMutationHandler, useNavigation, valueLabel };
-export type { APIcontextProps, AddressValue, ComoOpcionesProps, ControlledInput, CustomToolbarProps, DeleteGridColumnsProps, DetachedPage, DetailRenderProps, EditGridColumnsProps, EditReadOnlyFields, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, GridArgs, GridColDefPropsOverrides, JSONFormProps, JSONParserProps, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, PageType, ProgressStatusProps };
+export { APIContext, APIProvider, ActiveCell, ActiveIcon, Base, ButtonWithDrawer, CSVUpload, ContentLayout, ControlledAddressAutocomplete, ControlledAmountWithCurrency, 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, DeleteButton, DeleteConfirmationDialog, DetailPage$1 as DetailPage, DetailPage as DetailPage_v2, EditButton, ExportCSV, ExtraButtons, HistorialDrawer, ListPage, Loadable, LoadingComponent, Logo, MainDrawer, MainLayout, MenuItemWithLoading, ModuleCard, MoreOptions, MyGridEditSingleSelect, NavigationContext, NavigationProvider, NormalOrIcon, NotAllowed, NotFound, ObjectProgressStack, SaveCancelButton, StatusBadge, StyledMenu, Tabs, Transitions, UncontrolledText, changeTitle, closeProgressSnack, deleteColumn, editColumn, filterQuery, formParser, _default as headerReducer, manualCacheRefresh, mergeSettings, openProgressSnack, query, renderEditCellWithErrorTooltip, setErrors, _default$1 as snackProgressReducer, tags, theme, updateProgressSnackData, useAPI, useHasPermission, useKeyboardShortcut, useMutationHandler, useNavigation, valueLabel };
+export type { APIcontextProps, AddressValue, ComoOpcionesProps, ControlledInput, CustomToolbarProps, DeleteGridColumnsProps, DetachedPage, DetailRenderProps, EditGridColumnsProps, EditReadOnlyFields, FieldFilter, FieldProps$1 as FieldProps, FieldValidationProps, GridArgs, GridColDefPropsOverrides, JSONFormProps, JSONParserProps, KeyboardShortcut, MainLayoutPageHeaderProps, MainLayoutProps, MainLayoutSidebarFooterProps, MyDataGridProps, MyGridFilterModel, MyTab, MyTabProps, PageType, ProgressStatusProps };

package/package.json

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