@vectoriox/iox-ui 5.85.0 → 5.86.1

package/actions-core/index.d.ts

@@ -10,7 +10,7 @@ import { CompositeItemAction } from '@vectoriox/iox-ui/composite-core';
 /** How a step executes — decides which editor fields appear (timing only for `animated`). */
 type ActionKind = 'animated' | 'instant' | 'server';
 /** Picker grouping. Flat lists die at ~10 entries; the group is data, never a second list. */
-type ActionGroup = 'motion' | 'visibility' | 'navigate' | 'dialog' | 'item' | 'form' | 'data' | 'consent' | 'service';
+type ActionGroup = 'motion' | 'visibility' | 'navigate' | 'dialog' | 'popover' | 'notice' | 'item' | 'form' | 'data' | 'consent' | 'service';
 /**
  * What a step does inside the live builder canvas (the canvas RUNS interactions):
  * `run` for real (open the dialog), `simulate` announce-only (navigate), `inert` with a
@@ -109,6 +109,8 @@ declare const SERVER_ELEMENT_ACTION_TYPES: ReadonlySet<string>;
 /** The Tier-A behaviour executors' dispatch set (A1c) — the engines branch on it beside
  *  DIALOG/SWIPER. Dialog actions have their own set; context/visibility stay in the legacy path. */
 declare const BEHAVIOUR_ACTION_TYPES: ReadonlySet<string>;
+/** The toast action's dispatch set (premium M5) — the engines branch on it beside DIALOG / POPOVER. */
+declare const TOAST_ACTION_TYPES: ReadonlySet<string>;
 /** The item actions' dispatch set (T14) and what each does to its item — the engines branch on it beside
  *  DIALOG/BEHAVIOUR, and composite-core `runCompositeItemAction` runs it on the target item's own runtime. */
 declare const ITEM_ACTION_TYPES: Readonly<Record<string, CompositeItemAction>>;
@@ -169,6 +171,9 @@ interface OpenerInteractionLike {
 interface OpenerNodeLike {
     interactions?: ReadonlyArray<OpenerInteractionLike> | null;
 }
+/** The node id the element's click opens through one of `openerTypes` (its first enabled such action), or null —
+ *  the ONE reading every opener kind shares (a dialog's, a popover's). */
+declare function openedTargetId(node: OpenerNodeLike | null | undefined, openerTypes: ReadonlySet<string>): string | null;
 /** The Dialog node id the element's click opens (its first enabled opener action), or null. */
 declare function openedDialogId(node: OpenerNodeLike | null | undefined): string | null;
 /**
@@ -180,6 +185,29 @@ declare function dialogOpenerAttributes(node: OpenerNodeLike | null | undefined,
 /** The selector of every opener of one dialog (by its DOM id) — what a runtime updates on open/close. */
 declare function dialogOpenersSelector(dialogDomIdValue: string): string;
 
+/**
+ * What an element that OPENS a popover says about itself (premium components M5, N4 — the APG disclosure pattern over a
+ * non-modal dialog): `aria-haspopup="dialog"`, `aria-controls` = the popover's DOM id, and `aria-expanded` — `false` in
+ * the server render, kept in step by the runtime. ONE decision for every renderer, read the way a dialog opener is
+ * (`openedTargetId`); the popover's DOM id comes from `popoverDomId`, the one place that names it.
+ */
+/** The Popover node type. */
+declare const POPOVER_NODE_TYPE = "Popover";
+/** The actions that open a popover (close-only actions do not make an opener). */
+declare const POPOVER_OPENER_ACTION_TYPES: ReadonlySet<string>;
+/** Every action that opens, closes or toggles a popover — what the engines dispatch. */
+declare const POPOVER_ACTION_TYPE_SET: ReadonlySet<string>;
+/** The DOM id of a Popover node's panel — what an opener's `aria-controls` names. */
+declare function popoverDomId(nodeId: string): string;
+/** The node id a popover DOM id names, or null. */
+declare function nodeIdOfPopoverDomId(domId: string | null | undefined): string | null;
+/** The Popover node id the element's click opens, or null. */
+declare function openedPopoverId(node: OpenerNodeLike | null | undefined): string | null;
+/** The opener attributes for a node: `{}` when its click opens no popover. */
+declare function popoverOpenerAttributes(node: OpenerNodeLike | null | undefined, open?: boolean): Record<string, string>;
+/** The selector of every opener of one popover (by its DOM id). */
+declare function popoverOpenersSelector(popoverDomIdValue: string): string;
+
 /**
  * How a dialog LEAVES (CC1 follow-up — the drawer that vanished). Opening is pure CSS (`@starting-style`
  * in the shared `iox-design.css`); closing needs one beat of script, because `dialog.close()` drops the
@@ -257,5 +285,5 @@ interface FocusableSheet {
  */
 declare function focusDialogSheet(dialog: FocusableSheet | null | undefined): boolean;
 
-export { BEHAVIOUR_ACTION_TYPES, CONSENT_ACTION_TYPES, DIALOG_ACTION_TYPE_SET, DIALOG_CLOSING_ATTRIBUTE, DIALOG_EXIT_TIMEOUT_MS, DIALOG_OPENER_ACTION_TYPES, DIALOG_OPENER_TRIGGER, DIALOG_SELECTOR, ELEMENT_ACTION_DESCRIPTORS, ELEMENT_ACTION_GROUP_ORDER, FORM_SUBMIT_ACTION_DESCRIPTORS, ITEM_ACTION_TYPES, OpenerAttribute, SERVER_ELEMENT_ACTION_TYPES, addableActions, cancelExit, closeDialogAnimated, dialogDomId, dialogOpenerAttributes, dialogOpenersSelector, dialogTogglesClosed, focusDialogSheet, groupedElementActions, isExiting, itemActionOf, nodeIdOfDialogDomId, openedDialogId, opensAtClickedItem, resolveActionAvailability, runExitMotion };
+export { BEHAVIOUR_ACTION_TYPES, CONSENT_ACTION_TYPES, DIALOG_ACTION_TYPE_SET, DIALOG_CLOSING_ATTRIBUTE, DIALOG_EXIT_TIMEOUT_MS, DIALOG_OPENER_ACTION_TYPES, DIALOG_OPENER_TRIGGER, DIALOG_SELECTOR, ELEMENT_ACTION_DESCRIPTORS, ELEMENT_ACTION_GROUP_ORDER, FORM_SUBMIT_ACTION_DESCRIPTORS, ITEM_ACTION_TYPES, OpenerAttribute, POPOVER_ACTION_TYPE_SET, POPOVER_NODE_TYPE, POPOVER_OPENER_ACTION_TYPES, SERVER_ELEMENT_ACTION_TYPES, TOAST_ACTION_TYPES, addableActions, cancelExit, closeDialogAnimated, dialogDomId, dialogOpenerAttributes, dialogOpenersSelector, dialogTogglesClosed, focusDialogSheet, groupedElementActions, isExiting, itemActionOf, nodeIdOfDialogDomId, nodeIdOfPopoverDomId, openedDialogId, openedPopoverId, openedTargetId, opensAtClickedItem, popoverDomId, popoverOpenerAttributes, popoverOpenersSelector, resolveActionAvailability, runExitMotion };
 export type { ActionAvailability, ActionAvailabilityContext, ActionAvailabilityState, ActionDescriptor, ActionGroup, ActionKind, ActionParamSpec, ActionTargetSpec, BuilderBehaviour, DialogElementLike, ExitAnimationLike, ExitMotionElement, ExitMotionOptions, FocusableSheet, OpenerActionLike, OpenerInteractionLike, OpenerNodeLike };