asma-ui-core 3.108.2 → 3.108.4

package/dist/src/components/feedback/dialog/StyledDialog.d.ts

@@ -16,7 +16,12 @@ interface DialogPaperProps {
  */
 export interface IStyledDialogProps {
     open: boolean;
-    onClose?: (event: SyntheticEvent | Event, reason: DialogCloseReason) => void;
+    /**
+     * ✕, Escape and (ASMA-8471) native Back all funnel through this. Returning a Promise (a dirty or
+     * async confirmation) latches the dialog against Back while it is pending (`requestCloseTopOverlayBack`);
+     * returning nothing leaves it unlatched, so a repeated Back repeats the same dismissal attempt.
+     */
+    onClose?: (event: SyntheticEvent | Event, reason: DialogCloseReason) => void | Promise<unknown>;
     children?: ReactNode;
     dataTest: string;
     maxWidth?: DialogMaxWidth;

package/dist/src/components/navigation/drawer/StyledDrawer.d.ts

@@ -22,6 +22,8 @@ export interface DrawerProps {
     };
     /** Trigger element — when inside a modal `<dialog>`, portal into it so the sheet is interactive. */
     anchorEl?: Element | null;
+    /** Set `false` when a wrapper already owns the Back-close registration. */
+    registerBackClose?: boolean;
     children?: ReactNode;
 }
 /**

package/dist/src/components/utils/bottom-sheet/StyledBottomSheet.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 import { PopoverSlot } from '../popover/PopoverSheet';
 export type BottomSheetCloseReason = 'closeButton' | 'scrim' | 'escape' | 'drag' | 'viewResults' | 'action';
 /** @figmaNode 9Q7C7JYPgnUSsrX1L8v40t#5354-169163 (Ad-Voca-concept · "_bottom sheet") */
@@ -41,6 +41,10 @@ export interface StyledBottomSheetProps {
     closeLabel?: string;
     /** @figmaProp none — style escape hatch, applied to the sheet container */
     className?: string;
+    /** Set `false` when a wrapper already owns the Back-close registration. */
+    registerBackClose?: boolean;
+    /** Logical owner supplied by a wrapper that must keep one identity across responsive variants. */
+    ownerRef?: RefObject<Element | null>;
 }
 /**
  * ASMA Design System **Bottom Sheet** (ASMA-8184) — the mobile (0–743px) form of the Action popover:
@@ -56,4 +60,4 @@ export interface StyledBottomSheetProps {
  * Focus moves to the sheet on open (so the title is announced first) and back to the trigger on
  * close. `PopoverSheet` with `variant='action'` renders this automatically below 744px.
  */
-export declare const StyledBottomSheet: ({ dataTest, id, open, onClose, title, ariaLabel, children, viewResultsAction, resetAction, footerActions, resultCount, closeLabel, className, }: StyledBottomSheetProps) => JSX.Element | null;
+export declare const StyledBottomSheet: ({ dataTest, id, open, onClose, title, ariaLabel, children, viewResultsAction, resetAction, footerActions, resultCount, closeLabel, className, registerBackClose, ownerRef, }: StyledBottomSheetProps) => JSX.Element | null;

package/dist/src/components/utils/popover/StyledPopover.d.ts

@@ -35,6 +35,8 @@ export interface StyledPopoverProps {
      * dialog in the same tick it opens.
      */
     keepMounted?: boolean;
+    /** Set `false` when a wrapper already owns the Back-close registration. */
+    registerBackClose?: boolean;
 }
 /**
  * @figmaNode none — no standalone Figma component
@@ -51,4 +53,4 @@ export interface StyledPopoverProps {
  * mapping to MUI's `onClose(event, reason)`. `anchorOrigin`/`transformOrigin`/`slotProps.paper`
  * preserved (DEC-003). TASK-302.
  */
-export declare const StyledPopover: ({ open, anchorEl, onClose, anchorOrigin, transformOrigin, id, className, sx, slotProps, onClick, children, keepMounted, tabIntoContent, }: StyledPopoverProps) => JSX.Element | null;
+export declare const StyledPopover: ({ open, anchorEl, onClose, anchorOrigin, transformOrigin, id, className, sx, slotProps, onClick, children, keepMounted, tabIntoContent, registerBackClose, }: StyledPopoverProps) => JSX.Element | null;

package/dist/src/datetime/hooks/useBackNavigationClose.hook.d.ts

@@ -1,4 +1,5 @@
+/** Keeps the pre-adapter picker Back behavior while the host rollout flag is off. */
 export declare const useBackNavigationClose: ({ open, onClose }: {
     open: boolean;
     onClose: () => void;
-}) => null;
+}) => void;

package/dist/src/hooks/useBackCloses.hook.d.ts

@@ -0,0 +1,101 @@
+import { RefObject } from 'react';
+/**
+ * ASMA-8471 — native Back closes the top ui-core overlay through its own close path.
+ *
+ * This module owns ONLY the overlay side of the contract: a LIFO registry of open overlays plus the
+ * arbitration that decides which one a Back press (or a native dialog `cancel`/`close`) acts on. It
+ * never touches browser history — no `pushState`, `back()` or `go()` — that lives in
+ * `asma-core-helpers`' `getHistory()` adapter (PR #51, ASMA-8476), published at
+ * `window.__ASMA__SHELL__.overlayBack = { v, enabled, register }`. When that adapter is live (`v ===
+ * 1` and `register` is a function) this module registers ONE long-lived closer with it as soon as the
+ * stack goes from empty to non-empty, and unregisters it once the stack drains back to empty — see
+ * {@link registerOverlayBackCloser}. When the adapter is absent, or on a version this module doesn't
+ * speak, it runs registry-only and never touches `window.__ASMA__SHELL__` at all.
+ *
+ * **Window-scoped, not module-scoped** — same reasoning as `useTopLayer.hook.ts`'s
+ * `__asmaOpenModalDialogRegistry__`: a normal (non-`KERNEL_EXTERNAL`) build instantiates this module
+ * once per micro-frontend bundle, so a module-level array would give every bundle its own stack and
+ * "close only the top" would silently become "close only MY top" — and TWO bundles would each try to
+ * register their own adapter closer. `document.defaultView` (or `rawWindow` under the `asma-micro-app`
+ * sandbox) is the one object every bundle in the page shares, so the adapter registration state lives
+ * there too.
+ */
+export declare const OVERLAY_BACK_REGISTRY_VERSION = 1;
+/** Returns nothing: no latch, a repeated Back repeats the dismissal. Returns a Promise: the entry
+ *  latches until it settles, and Back on a latched top does nothing (see `requestCloseTopOverlayBack`). */
+export type OverlayBackRequestClose = (event?: Event) => false | void | Promise<unknown>;
+interface OverlayBackEntry {
+    requestClose: OverlayBackRequestClose;
+    pending: boolean;
+    owner: Element | null;
+    parentOwner: Element | null;
+    ownerRef?: RefObject<Element | null>;
+    parentOwnerRef?: RefObject<Element | null>;
+}
+interface OverlayBackAdapterState {
+    /** The adapter's own unregister for our one long-lived closer, once `register()` has been called. */
+    unregister: (() => void) | null;
+}
+interface OverlayBackRegistry {
+    version: number;
+    entries: OverlayBackEntry[];
+    adapter: OverlayBackAdapterState;
+}
+/** The `asma-core-helpers` contract (PR #51, ASMA-8476): `register` hands it the current top's close
+ *  function and gets back that registration's unregister. Absent, or `v` other than `1`, means no
+ *  history adapter is live. */
+interface OverlayBackAdapter {
+    v?: number;
+    enabled?: boolean;
+    pendingNavigation?: boolean;
+    register?: (requestClose: OverlayBackRequestClose) => () => void;
+    continuePendingNavigation?: () => void;
+    failOpenPendingNavigation?: () => void;
+}
+declare global {
+    interface Window {
+        rawWindow?: Window;
+        __asmaOverlayBackRegistry__?: OverlayBackRegistry;
+        __ASMA__SHELL__?: {
+            overlayBack?: OverlayBackAdapter;
+        };
+    }
+}
+/**
+ * Push a LIFO entry onto the overlay-back stack. The returned unregister must run when the overlay
+ * stops being eligible to receive Back (closes, or is no longer the active layer) — see
+ * {@link useBackCloses} for the React lifecycle wrapper every consumer actually uses.
+ */
+export declare function registerOverlayBackCloser(requestClose: OverlayBackRequestClose, owner?: Element | null, parentOwner?: Element | null, ownerRef?: RefObject<Element | null>, parentOwnerRef?: RefObject<Element | null>): () => void;
+export declare const OverlayBackOwnerContext: import('react').Context<RefObject<Element | null> | undefined>;
+/**
+ * Act on the topmost registered overlay, honouring the close contract's latch: a top entry whose
+ * previous `requestClose` returned a Promise that hasn't settled yet is skipped entirely (one
+ * documented dead press), never passed through to the next entry down — BACK-2 is "one press closes
+ * one layer", not "closes the nearest dismissible one".
+ *
+ * `StyledDialog`'s native `cancel`/`close` arbitration calls this directly, and it is exactly what the
+ * one closer registered with the history adapter (`asma-core-helpers`, a separate package) delegates
+ * to on an owned traversal.
+ */
+export declare function requestCloseTopOverlayBack(event?: Event): false | void | Promise<unknown>;
+/** Number of overlays currently registered. */
+export declare function getOverlayBackStackSize(): number;
+/** `true` when a live `asma-core-helpers` history adapter (PAT-002) has published `overlayBack.v === 1`. */
+export declare function hasOverlayBackAdapter(): boolean;
+/** Native close-watcher events are part of the feature and must respect the host kill switch. */
+export declare function isOverlayBackEnabled(): boolean;
+/**
+ * Register a surface onto the overlay-back stack while `active`, so native Back closes it through its
+ * own `requestClose` — see {@link requestCloseTopOverlayBack} for the arbitration. This hook never
+ * installs a `popstate`/history listener of its own, with or without a live adapter — that would race
+ * `asma-core-helpers`' own listener (CON-002/CON-009) and duplicate work the adapter already owns. The
+ * adapter registration itself (see {@link registerOverlayBackCloser}) is driven purely by the stack's
+ * empty/non-empty transitions, not by this hook.
+ */
+export declare function useBackCloses({ active, requestClose, ownerRef, }: {
+    active: boolean;
+    requestClose: OverlayBackRequestClose;
+    ownerRef?: RefObject<Element | null>;
+}): void;
+export {};

package/dist/src/hooks/useBackCloses.hook.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -3,7 +3,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "3.108.2",
+    "version": "3.108.4",
     "type": "module",
     "sideEffects": [
         "**/*.css",