@mcurros2/microm 1.1.435-0 → 1.1.437-0

package/dist/index.d.ts

@@ -339,6 +339,8 @@ export type ValidatorConfigurationParms = {
     data?: any;
 };
 export type ValidatorConfiguration = Partial<Record<keyof typeof CommonValidators, ValidatorConfigurationParms>>;
+/** `disabled` bypasses protection. `allways` skips dirty checks only in edit; view is unprotected. */
+export type NavigationProtectionMode = 'save' | 'confirm' | 'allways' | 'disabled';
 export const ModalsManagerDefaultProps: {
     closeLabel: string;
     fullscreenLabel: string;
@@ -355,6 +357,10 @@ export type MicroMModalSettings = Partial<Omit<ModalSettings, 'size'>> & {
     withFullscreenButton?: boolean;
 };
 export interface ModalOpenProps {
+    /** Optional stable identifier for targeted programmatic closes. */
+    id?: string;
+    /** Internal confirmation dialogs use false; normal modals participate in Back. */
+    history?: boolean;
     content: ReactNode | Promise<ReactNode>;
     modalProps: MicroMModalSettings;
     onClosed?: () => void;
@@ -362,9 +368,10 @@ export interface ModalOpenProps {
 }
 export interface ModalContextType {
     open: (props: ModalOpenProps, onClosed?: () => void) => Promise<void>;
-    close: () => Promise<void>;
+    close: (id?: string) => Promise<void>;
 }
 export interface ModalType {
+    history?: boolean;
     originalContent: ReactNode | Promise<ReactNode>;
     resolvedContent?: ReactNode;
     props: ModalSettings;
@@ -380,6 +387,7 @@ export interface ModalsManagerProps extends PropsWithChildren {
     /** This delay in milliseconds will be used to wait for the modal to be closed and fire the onClosed() event */
     animationDuration: number;
 }
+export const useModalScope: () => string | undefined;
 export const ModalsManager: ({ modalProps, animationDuration, children }: ModalsManagerProps) => JSX.Element;
 export const useModal: () => ModalContextType;
 export type ConfirmLeaveStaySaveResult = 'save' | 'leave' | 'stay';
@@ -393,8 +401,6 @@ export interface ConfirmLeaveStaySaveProps {
 }
 export const ConfirmLeaveStaySaveDefaultProps: Partial<ConfirmLeaveStaySaveProps>;
 export function ConfirmLeaveStaySave(props: ConfirmLeaveStaySaveProps): JSX.Element;
-/** `allways` skips dirty/value checks only in edit mode; add uses those checks and view is unprotected. */
-export type NavigationProtectionMode = 'save' | 'confirm' | 'allways';
 export type ConfirmNavigationType = 'local' | 'remote';
 export interface UseConfirmNavigationOptions {
     mode?: NavigationProtectionMode;
@@ -573,6 +579,7 @@ export interface EntityFormModalProps {
     entityConstructor: (client: MicroMClient) => Entity<EntityDefinition>;
     initialFormMode?: FormMode;
     getDataOnInit?: boolean;
+    navigationProtection?: NavigationProtectionMode;
     openState: boolean;
     setOpenState: (open: boolean) => void;
     onModalClosed?: () => void;
@@ -1171,6 +1178,10 @@ export interface EntityClientAction {
     showActionInViewMode?: boolean;
     onClick: (props: EntityClientActionOnClickProps) => Promise<boolean>;
 }
+/** Form actions complete through onClose(true, status). Successful completion clears
+ * dirty state before invoking onSaved (OK) or onCancel (Cancel), including silent actions.
+ * Failed statuses do not complete the form. Returning from onClick alone does not complete it.
+ */
 export interface EntityFormClientActionOnClickProps extends EntityClientActionOnClickProps {
     silent: boolean;
 }
@@ -2452,6 +2463,7 @@ export interface OpenFormProps {
     title?: string;
     element?: HTMLElement;
     getDataOnInit?: boolean;
+    navigationProtection?: NavigationProtectionMode;
     onModalSaved?: (new_status: OperationStatus<DBStatusResult | null>) => void;
     onModalCancelled?: () => void;
     onModalClosed?: () => void;