@vectoriox/iox-ui 5.36.0 → 5.38.0

package/actions-core/index.d.ts

@@ -1,3 +1,5 @@
+import { CompositeItemAction } from '@vectoriox/iox-ui/composite-core';
+
 /**
  * The ONE descriptor shape for everything an author can put in an ordered action list —
  * a form's after-submit steps today, element behaviour actions (A1) next. Promoted out of
@@ -8,7 +10,7 @@
 /** 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' | 'form' | 'data' | 'consent' | 'service';
+type ActionGroup = 'motion' | 'visibility' | 'navigate' | 'dialog' | '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
@@ -26,10 +28,12 @@ interface ActionParamSpec {
         labelKey: string;
     }[];
 }
-/** Does this action point at another node — and may it be any node or only certain types? */
+/** Does this action point at another node — and may it be any node, or only certain types / composite roles? */
 interface ActionTargetSpec {
     required: boolean;
     types?: string[];
+    /** Only nodes playing one of these composite roles (`openItem` targets an accordion item or a disclosure). */
+    roles?: string[];
 }
 /**
  * One row of an action catalog. Every field beyond `type`/`labelKey` is optional so the
@@ -105,6 +109,16 @@ 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 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>>;
+/** The item action an action type runs, or null when it is not one. */
+/** True when an `openDialog` action opens its dialog at the clicked row's slide (CC3 "Open at the clicked item"). */
+declare function opensAtClickedItem(action: {
+    type?: string;
+    params?: Record<string, unknown> | null;
+} | null | undefined): boolean;
+declare function itemActionOf(type: string | null | undefined): CompositeItemAction | null;
 /** The consent actions' dispatch set (C3) — the engines branch on it beside DIALOG/BEHAVIOUR.
  *  `openConsentPreferences` is dialog-opening by nature and included so ONE branch owns consent. */
 declare const CONSENT_ACTION_TYPES: ReadonlySet<string>;
@@ -166,5 +180,5 @@ 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;
 
-export { BEHAVIOUR_ACTION_TYPES, CONSENT_ACTION_TYPES, DIALOG_ACTION_TYPE_SET, DIALOG_OPENER_ACTION_TYPES, DIALOG_OPENER_TRIGGER, DIALOG_SELECTOR, ELEMENT_ACTION_DESCRIPTORS, ELEMENT_ACTION_GROUP_ORDER, FORM_SUBMIT_ACTION_DESCRIPTORS, OpenerAttribute, SERVER_ELEMENT_ACTION_TYPES, addableActions, dialogDomId, dialogOpenerAttributes, dialogOpenersSelector, groupedElementActions, nodeIdOfDialogDomId, openedDialogId, resolveActionAvailability };
+export { BEHAVIOUR_ACTION_TYPES, CONSENT_ACTION_TYPES, DIALOG_ACTION_TYPE_SET, 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, dialogDomId, dialogOpenerAttributes, dialogOpenersSelector, groupedElementActions, itemActionOf, nodeIdOfDialogDomId, openedDialogId, opensAtClickedItem, resolveActionAvailability };
 export type { ActionAvailability, ActionAvailabilityContext, ActionAvailabilityState, ActionDescriptor, ActionGroup, ActionKind, ActionParamSpec, ActionTargetSpec, BuilderBehaviour, OpenerActionLike, OpenerInteractionLike, OpenerNodeLike };