@vectoriox/iox-ui 5.85.0 → 5.86.1

package/index.d.ts

@@ -776,6 +776,10 @@ declare class ClientSliderContainerComponent implements AfterViewInit, OnDestroy
     };
     private swiper;
     private slidesSeen;
+    /** The slides the renderer placed (it asks `childHostFor` for each, before the first change detection), so a played
+     *  slider's runway reserves its steps in the SERVER render — the page never shifts when the slider boots. */
+    private slideTotal;
+    get runwaySteps(): number;
     private readonly instanceRegistry;
     constructor(platformId: object);
     /** Swiper draws its own arrows / dots only for a saved slider whose controls are not parts yet. */
@@ -1176,6 +1180,16 @@ declare enum FormRenderState {
     Success = "success",
     Error = "error"
 }
+/**
+ * What a form shows once it has sent (premium M5, N3) — the Form's "After sending" choice:
+ * - `message`: the success in place (M3): the fields leave, the Success block shows, Send reads "Sent" and stays so;
+ * - `toast`: the fields STAY, cleared for the next answer, and a toast says the form's Sent words — a newsletter in a
+ *   footer, a form someone may send again.
+ */
+declare enum FormAfterSend {
+    Message = "message",
+    Toast = "toast"
+}
 /**
  * The fields a CLIENT needs to validate a form: never its actions (where submissions go — an email
  * address, a webhook) and never its anti-spam settings. A string-rendered form carries this on
@@ -1325,6 +1339,9 @@ declare class IoxFormComponent implements OnChanges, OnInit {
     get renderState(): FormRenderState | string;
     private _renderState;
     feedback: FeedbackTiming | string;
+    /** After sending (premium M5): the success in place (`message`), or keep the fields and say it in a toast. */
+    afterSend: FormAfterSend | string;
+    get keepsFields(): boolean;
     /**
      * Move focus to the first field that failed, instead of leaving the visitor to hunt for red
      * text. On by default — the single most valuable thing a failed submit can do.
@@ -1388,7 +1405,7 @@ declare class IoxFormComponent implements OnChanges, OnInit {
     /** Focus the first field that failed and shake it once (premium N2 — Emil 134; none under reduced motion). */
     private focusFirstInvalid;
     static ɵfac: i0.ɵɵFactoryDeclaration<IoxFormComponent, [null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFormComponent, "form[iox-form]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "renderState": { "alias": "renderState"; "required": false; }; "feedback": { "alias": "feedback"; "required": false; }; "focusFirstProblem": { "alias": "focusFirstProblem"; "required": false; }; "announceFailure": { "alias": "announceFailure"; "required": false; }; }, { "formSubmit": "formSubmit"; "validationFailed": "validationFailed"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFormComponent, "form[iox-form]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "renderState": { "alias": "renderState"; "required": false; }; "feedback": { "alias": "feedback"; "required": false; }; "afterSend": { "alias": "afterSend"; "required": false; }; "focusFirstProblem": { "alias": "focusFirstProblem"; "required": false; }; "announceFailure": { "alias": "announceFailure"; "required": false; }; }, { "formSubmit": "formSubmit"; "validationFailed": "validationFailed"; }, never, never, false, never>;
 }
 
 /**
@@ -1621,9 +1638,28 @@ declare class IoxDialogComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<IoxDialogComponent, "dialog[iox-dialog]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; }; "consentRole": { "alias": "consentRole"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+/**
+ * The Popover's LIVE twin on the engine's component path (premium components M5, N4). Directive-host: the panel IS the
+ * host, carrying exactly the markup the string renderer writes — `data-iox-popover`, `popover="manual"` (closed in the
+ * raw SSR with no script: the browser hides a popover until it is shown), `role="dialog"`, `tabindex="-1"` (focus moves
+ * to the panel on open) and the side the author picked — so ONE runtime (`openPopover` / `closePopover`) treats both
+ * paths alike. Its id and accessible name are the shared `nodeA11yAttributes`, applied by the engine.
+ */
+declare class IoxPopoverComponent {
+    nodeId: string;
+    placement: string;
+    childrenHost: ViewContainerRef;
+    get side(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IoxPopoverComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxPopoverComponent, "div[iox-popover]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; }, {}, never, never, false, never>;
+}
+/** The attributes the string renderer writes on a Popover panel (beside its class, id and name) — the component's host
+ *  bindings, as data, so the two paths cannot drift. */
+declare function popoverPanelAttributes(placement: unknown): Record<string, string>;
+
 declare class IoxBuilderComponentsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<IoxBuilderComponentsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<IoxBuilderComponentsModule, [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent, typeof IoxVideoComponent, typeof IoxFormComponent, typeof IoxFieldComponent, typeof IoxSubmitButtonComponent, typeof IoxFormSuccessComponent, typeof IoxFormErrorComponent, typeof IoxDialogComponent], [typeof i2.CommonModule], [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent, typeof IoxVideoComponent, typeof IoxFormComponent, typeof IoxFieldComponent, typeof IoxSubmitButtonComponent, typeof IoxFormSuccessComponent, typeof IoxFormErrorComponent, typeof IoxDialogComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<IoxBuilderComponentsModule, [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent, typeof IoxVideoComponent, typeof IoxFormComponent, typeof IoxFieldComponent, typeof IoxSubmitButtonComponent, typeof IoxFormSuccessComponent, typeof IoxFormErrorComponent, typeof IoxDialogComponent, typeof IoxPopoverComponent], [typeof i2.CommonModule], [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent, typeof IoxVideoComponent, typeof IoxFormComponent, typeof IoxFieldComponent, typeof IoxSubmitButtonComponent, typeof IoxFormSuccessComponent, typeof IoxFormErrorComponent, typeof IoxDialogComponent, typeof IoxPopoverComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<IoxBuilderComponentsModule>;
 }
 
@@ -1858,12 +1894,6 @@ declare function sliderInputsFromProps(props: Record<string, unknown>, responsiv
  * `1vh` / `1vw` fallbacks restore native browser behaviour.
  */
 declare function rewriteViewportUnits(value: string): string;
-/**
- * Style props a type's render-default fully REPLACES. Emitting them would produce a dead
- * declaration that is immediately overridden in the same rule (e.g. an Icon's serialised
- * `lineHeight: 1.5` followed by the forced `line-height: 1`), so callers strip them first via
- * {@link stripSuppressedProps} and let renderDefaultDeclarations supply the real value.
- */
 declare const SUPPRESSED_STYLE_PROPS_BY_TYPE: Readonly<Record<string, readonly string[]>>;
 /** Remove the style props whose value a type's render-default always overrides. Returns the map
  *  unchanged (same reference) when the type suppresses nothing. */
@@ -2445,10 +2475,21 @@ declare enum A11yTrait {
     /** "Accessibility ▸ Accessible name" — the name of an icon-only control (and of a Dialog). */
     AccessibleName = "ariaLabel",
     /** A Dialog's "Close when wider than": a breakpoint id, or empty = never. */
-    CloseAbove = "closeAbove"
+    CloseAbove = "closeAbove",
+    /** "Tooltip ▸ Words" (premium M5): words for a control that has none of its own. */
+    Tooltip = "tooltip",
+    /** "Tooltip ▸ Side": above (default) · below · start · end. */
+    TooltipPlacement = "tooltipPlacement"
 }
 /** The types that carry an Accessible name trait. */
 declare const ACCESSIBLE_NAME_TYPES: ReadonlyArray<string>;
+/** The types that carry a Tooltip (premium M5): the controls — a button, a linked box, a link (a gallery's arrows are
+ *  ButtonBlocks). Not a Text or an Image: a tooltip on something that takes no focus is invisible to a keyboard. */
+declare const TOOLTIP_TYPES: ReadonlyArray<string>;
+/** The attribute a tooltip's words travel on (the raw SSR carries it; the tooltip runtime reads it). */
+declare const TOOLTIP_ATTRIBUTE = "data-iox-tooltip";
+/** The side it asks for, when not the default (above). */
+declare const TOOLTIP_PLACEMENT_ATTRIBUTE = "data-iox-tooltip-placement";
 /** The types that link to a page and can therefore be the current page's link. */
 declare const CURRENT_LINK_TYPES: ReadonlyArray<string>;
 
@@ -2506,6 +2547,8 @@ interface NodeA11yContext {
 }
 /** The attributes a node renders. */
 declare function nodeA11yAttributes(node: A11yNodeSource | null | undefined, ctx?: NodeA11yContext): Record<string, string>;
+/** The node's tooltip words (premium M5), trimmed, or '' — only on the types that carry one. */
+declare function tooltipWords(node: A11yNodeSource | null | undefined): string;
 /** The attributes as an HTML string fragment (` name="value"`…) for a string renderer. */
 declare function serializeA11yAttributes(attrs: Readonly<Record<string, string>>, escape: (v: string) => string): string;
 /**
@@ -3819,7 +3862,7 @@ declare const CALENDAR_CLOSING_ATTRIBUTE = "data-iox-closing";
 declare const CALENDAR_INSTANT_ATTRIBUTE = "data-iox-instant";
 /** On the panel the builder canvas draws for its design-time Open state (in the flow, inert). */
 declare const CALENDAR_DESIGN_ATTRIBUTE = "data-iox-cal-design";
-/** A phone gets the sheet (the drawer curve, the scrim) — the same width the shared CSS keys on. */
+/** A phone gets the sheet (the drawer curve, the scrim) — the floating family's ONE decision (a popover too). */
 declare const CALENDAR_SHEET_QUERY = "(max-width: 767px)";
 /** The language the field speaks: the host's, the nearest `[lang]`, the document's. */
 declare function fieldLanguage(field: Element, lang?: string | null): string;
@@ -3893,15 +3936,16 @@ declare const SHAKE_EASING = "cubic-bezier(0.23, 1, 0.32, 1)";
 declare function shakeElement(el: Element | null | undefined, reducedMotion?: boolean): Animation | null;
 
 /**
- * placeFloating — where a panel anchored to a control goes (premium components N8, reused by M5's tooltip and popover).
+ * placeFloating — where a panel anchored to a control goes (premium components N8; M5's tooltip and popover).
  *
- * ONE pure decision for every floating panel: under its anchor, aligned to the anchor's reading start (the left edge in
- * LTR, the right in RTL); above it when there is no room below and more above; held inside the viewport with a margin;
- * and the transform-origin AT the anchor, so the panel grows from the control that opened it (Emil 47) — even when the
- * clamp moved it sideways.
+ * ONE pure decision for every floating panel: on the side the caller prefers (under its anchor by default; a tooltip
+ * above), flipped to the opposite side when the preferred one has no room and the other has more; lined up with the
+ * anchor's reading start (the left edge in LTR, the right in RTL) or centred on it; held inside the viewport with a
+ * margin; and the transform-origin AT the anchor, so the panel grows from the control that opened it (Emil 47) — even
+ * when the clamp moved it sideways.
  *
- * Lives in the main entry: nothing server-side places a panel, and the date picker (now) and the floating family (M5)
- * are DOM runtimes of the main entry. Pure — no DOM read here: the caller measures, this decides, the caller writes.
+ * Lives in the main entry: nothing server-side places a panel; the date picker, the tooltip and the popover are DOM
+ * runtimes of the main entry. Pure — no DOM read here: the caller measures, this decides, the caller writes.
  */
 interface FloatingRect {
     top: number;
@@ -3917,31 +3961,391 @@ interface FloatingViewport {
     width: number;
     height: number;
 }
+/** The side of the anchor the panel sits on. Start / End follow the reading direction (Start is the left in LTR). */
 declare enum FloatingSide {
     Below = "below",
-    Above = "above"
+    Above = "above",
+    Start = "start",
+    End = "end"
+}
+/** How the panel lines up with its anchor across the side: at the anchor's reading start (top, for a Start / End
+ *  panel), or centred on it (a tooltip). */
+declare enum FloatingAlign {
+    Start = "start",
+    Center = "center"
 }
 interface FloatingOptions {
     /** Space between the anchor and the panel. */
     gap?: number;
     /** Space the panel always keeps from the viewport's edges. */
     margin?: number;
-    /** Right-to-left: the panel lines up with the anchor's right edge. */
+    /** Right-to-left: Start is the right side, and a start-aligned panel lines up with the anchor's right edge. */
     rtl?: boolean;
+    /** The side the panel prefers (Below when absent). */
+    side?: FloatingSide;
+    /** Start (default) or Center. */
+    align?: FloatingAlign;
 }
 interface FloatingPlacement {
     top: number;
     left: number;
+    /** The side it ended on (the preferred one, or its opposite after a flip). */
     side: FloatingSide;
-    /** A CSS transform-origin in the panel's own box, pointing at the anchor's reading-start corner. */
+    /** A CSS transform-origin in the panel's own box, pointing at the anchor. */
     origin: string;
 }
 /** Emil's popover spacing: close enough to read as the control's, clear of its focus ring. */
 declare const FLOATING_GAP = 8;
 /** The viewport margin — a panel never touches the screen's edge. */
 declare const FLOATING_MARGIN = 12;
+/**
+ * Where a floating panel stops being a panel and becomes a bottom sheet (the date picker's calendar, a popover): a
+ * phone. ONE decision, the width the shared CSS keys its sheets on.
+ */
+declare const FLOATING_SHEET_QUERY = "(max-width: 767px)";
 /** Where `panel` goes beside `anchor` inside `viewport`. */
 declare function placeFloating(anchor: FloatingRect, panel: FloatingSize, viewport: FloatingViewport, options?: FloatingOptions): FloatingPlacement;
+/**
+ * A screen rect in the coordinates of a LAYER — a box that fills the viewport on the live site (scale 1, at 0,0) and
+ * the page frame on the builder canvas (offset, zoomed). The floating runtimes place inside a layer, so one placement
+ * serves both; `layerRect` is the layer's screen rect and `scale` its zoom (its screen width over its layout width).
+ */
+declare function toLayerRect(rect: FloatingRect, layerRect: Pick<FloatingRect, 'top' | 'left'>, scale?: number): FloatingRect;
+
+/**
+ * THE FLOATING LAYER (premium components M5) — the one box tooltips and toasts are placed in.
+ *
+ * On the live site it is a `popover="manual"` element in the TOP LAYER, filling the viewport: above a fixed header, a
+ * slider's `overflow: hidden`, a nav's `backdrop-filter` (which would otherwise contain anything fixed inside it).
+ * Each SCOPE has its own layer — the document's body, or an open modal `<dialog>` (a tooltip on a lightbox's arrow, a
+ * toast raised from a drawer's form): a layer inside the dialog is shown after it, so it sits above it in the top
+ * layer, it is not inert behind it, and it inherits the dialog's tokens and scheme through the DOM.
+ * On the builder canvas it is a plain `position: fixed` box inside the transformed page frame, which CONTAINS it — so
+ * it fills the frame and zooms with it; nothing is drawn over the builder's own panels.
+ *
+ * Every placement is made in the layer's own px (`layerFrame` + `toLayerRect`), so the site and the canvas share it.
+ */
+declare const FLOATING_LAYER_CLASS = "iox-float-layer";
+interface FloatingLayerOptions {
+    /** Where the layer lives when the trigger is in no open dialog: the body on the site; on the canvas the token scope
+     *  the element sits in (the page frame, or the globals' overlay) — a function of the element it was raised from. */
+    container?: Element | null | ((from: Element | null) => Element | null);
+    /** True on the live site (a top-layer popover); false on the canvas (contained by the zoomed frame). */
+    topLayer?: boolean;
+}
+/** The layer's frame: where it is on screen, its zoom, and its own size — the viewport a placement keeps inside. */
+interface LayerFrame {
+    rect: {
+        top: number;
+        left: number;
+    };
+    scale: number;
+    viewport: FloatingViewport;
+}
+/** True when the browser has the Popover API (jsdom and old engines do not — they open by `hidden`). */
+declare function canPopover(el: Element): boolean;
+/** True while a `popover` element is shown in the top layer. */
+declare function isOpenPopover(el: Element): boolean;
+/** Show a `popover` element in the top layer; an element without the API is un-hidden instead. */
+declare function showInTopLayer(el: HTMLElement): void;
+/** Take a `popover` element out of the top layer (or hide it). */
+declare function hideFromTopLayer(el: HTMLElement): void;
+/** The scope a floating element raised from `from` belongs to: its closest open modal dialog, else the container. */
+declare function floatingScope(from: Element | null | undefined, options?: FloatingLayerOptions): Element | null;
+/** The layer of a scope — created on first use, raised into the top layer when the site asks for it. */
+declare function floatingLayer(scope: Element, options?: FloatingLayerOptions): HTMLElement;
+/** Show a top-layer layer (again): a layer closed by a scope change, or one a later modal dialog now covers. */
+declare function raiseFloatingLayer(layer: HTMLElement): void;
+/** The layer's frame. On the site: (0, 0), scale 1, the viewport. On the canvas: the frame's corner, its zoom, its px. */
+declare function layerFrame(layer: HTMLElement): LayerFrame;
+/** An element's screen rect in the layer's px. */
+declare function rectInLayer(el: Element, frame: LayerFrame): FloatingRect;
+
+/**
+ * THE TOOLTIP (premium components M5, N4) — words for a control that has none of its own (an icon button, a gallery
+ * arrow). ONE DOM runtime for the live site (both engine paths) and the builder canvas; the trigger carries what the
+ * shared `nodeA11yAttributes` rendered (`data-iox-tooltip`, `data-iox-tooltip-placement`), so the raw SSR already says it.
+ *
+ * - Shows on HOVER for a mouse or a pen (never a finger — a tap is not a hover) and on KEYBOARD focus
+ *   (`:focus-visible`), never on a tap. A press, Esc, a scroll or leaving hides it.
+ * - The first waits (`TOOLTIP_FIRST_DELAY_MS`); while one is open, or within `TOOLTIP_WARM_MS` of one closing, the next
+ *   opens AT ONCE with no motion (Emil 125). Keyboard focus opens at once, with no motion (Emil 2).
+ * - Grows from its trigger (the origin `placeFloating` gives, Emil 47/124); leaves faster than it came (Emil 30).
+ * - Hoverable and dismissible (WCAG 1.4.13): the pointer may move onto it; Esc hides it until the pointer or focus
+ *   leaves the trigger.
+ * - `aria-describedby` points at it while it is shown — unless the tooltip IS the control's name (an icon-only control:
+ *   `nodeA11yAttributes` already made the words its `aria-label`; describing it twice would read it twice).
+ */
+/** On the drawn tooltip while it appears or moves with no motion (a neighbour, keyboard focus). */
+declare const TOOLTIP_INSTANT_ATTRIBUTE = "data-iox-instant";
+/** On a trigger whose tooltip the builder canvas holds open (the design-time "Showing on canvas" state). */
+declare const TOOLTIP_PINNED_ATTRIBUTE = "data-iox-tooltip-pinned";
+/** The side the drawn tooltip ended on (after a flip) — the shared CSS reads it for nothing but the e2e reads it. */
+declare const TOOLTIP_SIDE_ATTRIBUTE = "data-iox-side";
+declare enum TooltipClass {
+    Tip = "iox-tooltip",
+    /** The element style's marker — set when the trigger wears the design system (a legacy page keeps the literals). */
+    Marker = "iox-es-tooltip"
+}
+/** The FIRST tooltip waits this long under a resting pointer (Emil 125: the first waits, the next does not). */
+declare const TOOLTIP_FIRST_DELAY_MS = 500;
+/** A tooltip opened within this window of another closing opens at once — moving along a row of icons. */
+declare const TOOLTIP_WARM_MS = 300;
+/** Leaving the trigger hides after this grace, so the pointer can cross onto the tooltip (WCAG 1.4.13 hoverable). */
+declare const TOOLTIP_HIDE_GRACE_MS = 100;
+interface TooltipTimingState {
+    /** A tooltip is shown right now. */
+    open: boolean;
+    /** When the last one closed (ms, the runtime's clock), or null. */
+    lastClosedAt: number | null;
+}
+/** How long before a tooltip shows, and whether it shows with no motion. Pure — the runtime asks it on every hover. */
+declare function tooltipTiming(state: TooltipTimingState, now: number, firstDelayMs?: number, warmMs?: number): {
+    delayMs: number;
+    instant: boolean;
+};
+/** The side a trigger asks for (Above when it names none, or names something else). */
+declare function tooltipSide(value: string | null | undefined): FloatingSide;
+interface TooltipRuntimeOptions {
+    /** Where the floating layer lives outside an open dialog: the body on the site, the canvas's token scope. */
+    container?: Element | null | ((from: Element | null) => Element | null);
+    /** True on the live site (the top layer); false on the canvas (contained by the zoomed frame). */
+    topLayer?: boolean;
+    /** The clock (a spec's fake). */
+    now?: () => number;
+}
+/** The runtime over one root (the document on the site, the page's frame on the canvas). Built by `attachTooltips`. */
+declare class TooltipRuntime {
+    private readonly root;
+    private readonly options;
+    private tip;
+    private trigger;
+    private pinned;
+    private pinWatch;
+    private suppressed;
+    private showTimer;
+    private hideTimer;
+    private lastClosedAt;
+    private exiting;
+    private readonly listeners;
+    constructor(root: Document | Element, options?: TooltipRuntimeOptions);
+    /** The trigger whose tooltip is shown, or null. */
+    get shownFor(): HTMLElement | null;
+    /** The drawn tooltip (created on first show). */
+    get element(): HTMLElement | null;
+    /** Show the trigger's tooltip now. `instant` skips the entrance (a neighbour, keyboard focus, the canvas pin). */
+    show(trigger: HTMLElement, instant?: boolean): void;
+    /** Hide it — with its exit, or `immediate`ly (a press, Esc, a scroll, keyboard focus leaving). */
+    hide(immediate?: boolean): void;
+    /** The builder canvas's design-time state: hold the trigger's tooltip open (true) or let it go (false). */
+    pin(trigger: HTMLElement, on: boolean): void;
+    /** Place the shown tooltip again (the trigger moved — the canvas re-laid out). */
+    reposition(): void;
+    destroy(): void;
+    private get doc();
+    private now;
+    private triggerOf;
+    private onPointerOver;
+    private onPointerOut;
+    private onFocusIn;
+    private onFocusOut;
+    private escape;
+    /** A scroll hides a hover / focus tooltip (it would float away from its trigger); a pinned one follows it. */
+    private onScroll;
+    /** A press, a scroll: gone at once (and a pending one never shows). */
+    private dismiss;
+    private cancelHide;
+    private clearTimers;
+    /** The drawn tooltip, in the layer of the trigger's scope (a lightbox's arrow → the lightbox's own layer). */
+    private ensureTip;
+    /** Where it goes: the side the trigger asks for (flipped when there is no room), centred on it, inside the layer. */
+    private place;
+    /** Point the trigger's description at the tooltip — unless the tooltip is already its name. */
+    private describe;
+    private listen;
+}
+/** The runtime already running over `root`, if any. */
+declare function tooltipsOf(root: Document | Element | null | undefined): TooltipRuntime | null;
+/** Run tooltips over `root` — once: a root already running is returned as is. */
+declare function attachTooltips(root: Document | Element | null | undefined, options?: TooltipRuntimeOptions): TooltipRuntime | null;
+
+/**
+ * THE POPOVER on the live site (premium components M5, N4) — an anchored, NON-modal panel of ordinary nodes, opened by
+ * its opener's `openPopover` / `togglePopover` action and closed by `closePopover`, Esc or a press outside it. ONE DOM
+ * runtime for both engine paths (the component path and the string path render the same element: `[data-iox-popover]`,
+ * `popover="manual"`, `role="dialog"`, `tabindex="-1"`, the node's own id); the builder canvas has its own twin that
+ * places itself with the same `placeFloating`.
+ *
+ * - In the TOP LAYER (`showPopover`): above a fixed header and a slider's clipping; it still inherits the section's tokens
+ *   and scheme through the DOM, where the node sits.
+ * - Placed beside its opener on the side the author picked (flipped at the viewport's edge, shifted inside it), lined up
+ *   with the opener's reading start, growing from it (Emil 47/123); placed again while the page scrolls or resizes.
+ * - On a phone (`FLOATING_SHEET_QUERY`, the date picker's decision) it is a bottom sheet over the look's scrim, and the
+ *   page holds still under it.
+ * - Focus moves INTO it on open (the panel itself: no ring after a tap), and back to the opener when Esc closes it, or
+ *   when a press outside closes it and focus had nowhere else to go. Focus leaving it (Tab) closes it.
+ * - A keyboard open (Enter / Space on the opener) and Esc have no motion (Emil 2); the exit is faster than the entrance
+ *   (the shared CSS, on the popover tokens).
+ */
+declare enum PopoverAttribute {
+    Root = "data-iox-popover",
+    Placement = "data-iox-popover-placement",
+    /** On the panel while it is a phone's bottom sheet. */
+    Sheet = "data-iox-sheet",
+    /** The side it ended on (after a flip). */
+    Side = "data-iox-side",
+    /** Opened from the keyboard: it appears and goes with no motion. */
+    Instant = "data-iox-instant",
+    /** On the panel while it is open (the canvas twin reads the same name). */
+    Open = "data-iox-open"
+}
+declare const POPOVER_SELECTOR = "[data-iox-popover]";
+interface PopoverOpenOptions {
+    /** The element whose action opened it — what it is anchored to and where focus goes back. */
+    opener?: HTMLElement | null;
+    /** Opened from the keyboard: no motion in, none out. */
+    instant?: boolean;
+    /** The page holds still under a phone's sheet (Lenis would scroll it). */
+    lockScroll?: () => void;
+    unlockScroll?: () => void;
+}
+interface PopoverCloseOptions {
+    /** No motion (Esc, a keyboard action). */
+    instant?: boolean;
+    /** Focus back on the opener: always (Esc), or only when focus was inside the panel or nowhere (`'if-lost'`). */
+    returnFocus?: boolean | 'if-lost';
+}
+/** True while the popover is open (an exit that is playing counts as closed). */
+declare function isPopoverOpen(el: Element | null | undefined): boolean;
+/** The side a panel asks for (Below unless it names another). */
+declare function popoverSide(value: string | null | undefined): FloatingSide;
+/** Beside its opener, inside the viewport, growing from it — the ONE `placeFloating`. A sheet is the shared CSS's. */
+declare function placePopover(el: HTMLElement, opener: HTMLElement | null): void;
+/** Open the popover beside `options.opener`. Opening one that is leaving keeps it open. */
+declare function openPopover(el: HTMLElement | null | undefined, options?: PopoverOpenOptions): void;
+/** Close the popover with its exit (the shared CSS), then hand focus back as asked. */
+declare function closePopover(el: HTMLElement | null | undefined, options?: PopoverCloseOptions): Promise<void>;
+/** Toggle: close an open one, open a closed (or leaving) one. */
+declare function togglePopover(el: HTMLElement | null | undefined, options?: PopoverOpenOptions): void;
+/** Close every open popover under `root` at once (a page leaving, a route change). */
+declare function closeAllPopovers(root: ParentNode | null | undefined): void;
+
+/**
+ * THE TOAST (premium components M5, N3) — a non-modal notice at an edge of the screen. ONE DOM runtime for the live site
+ * (the `showToast` action on both engine paths, and a form that keeps its fields after sending) and the builder canvas
+ * (the same action RUNS there; the design-time "Showing on canvas" state holds one up to style it).
+ *
+ * - Speaks through a polite live region that exists BEFORE the first notice lands (a region inserted with its words is
+ *   not announced); never takes focus.
+ * - Enters from its edge and leaves to the SAME edge (Emil 129–130), on the look's toast tokens (400ms `ease` in, a
+ *   faster exit); reduced motion keeps the fade and drops the slide (the shared CSS).
+ * - Its timer pauses while the tab is hidden, the pointer is on the stack or focus is inside it (Emil 132; WCAG 2.2.1),
+ *   and it has a close control.
+ * - At most `TOAST_MAX_VISIBLE` at once — the oldest leaves for a new one; the rest slide to their new places (FLIP on
+ *   `translate`, which composes with the entrance's `transform`), so nothing jumps.
+ * - Above the home indicator (`env(safe-area-inset-*)`) and above a bottom tab bar (the shared CSS).
+ */
+declare enum ToastEdge {
+    Bottom = "bottom",
+    Top = "top"
+}
+declare enum ToastClass {
+    Stack = "iox-toasts",
+    Toast = "iox-toast",
+    Text = "iox-toast__text",
+    Close = "iox-toast__close",
+    /** The element style's marker — set when the element it was raised from wears the design system. */
+    Marker = "iox-es-toast"
+}
+declare const TOAST_EDGE_ATTRIBUTE = "data-iox-edge";
+/** On the toast the builder canvas holds up for styling (no timer, never leaves on its own). */
+declare const TOAST_DESIGN_ATTRIBUTE = "data-iox-toast-design";
+/** A stack created for a toast waits this long before the words land: a live region must exist before it changes. */
+declare const TOAST_FIRST_LANDS_MS = 80;
+/** The most toasts on screen at once (Emil 131: a short stack, never a wall). */
+declare const TOAST_MAX_VISIBLE = 3;
+/** A toast stays at least this long … */
+declare const TOAST_MIN_MS = 4000;
+/** … at most this long … */
+declare const TOAST_MAX_MS = 10000;
+/** … and this much longer per character it says (a reader's pace). */
+declare const TOAST_MS_PER_CHAR = 60;
+/** The close control's words in the page's language. */
+declare const TOAST_CLOSE_WORDS: Readonly<Record<string, string>>;
+/** "Close" in `lang` (its base language), else English. */
+declare function toastCloseWord(lang: string | null | undefined): string;
+/** How long a toast stays: long enough to read, within bounds. Pure. */
+declare function toastDuration(text: string, override?: number | null): number;
+/** Which toasts leave so a new one fits: the oldest first, keeping `max - 1` beside the newcomer. Pure. */
+declare function toastsToEvict<T>(shown: ReadonlyArray<T>, max?: number): T[];
+/** The edge a value names (Bottom unless it says Top). */
+declare function toastEdge(value: unknown): ToastEdge;
+declare enum PauseReason {
+    Hidden = "hidden",
+    Hover = "hover",
+    Focus = "focus"
+}
+/**
+ * A countdown that stops while any reason holds it (the tab hidden, the pointer on the stack, focus inside) and runs
+ * on from what was left. Its clock and scheduler are injectable for a spec.
+ */
+declare class PausableTimer {
+    private readonly onDone;
+    private readonly now;
+    private remaining;
+    private startedAt;
+    private handle;
+    private readonly reasons;
+    private done;
+    constructor(ms: number, onDone: () => void, now?: () => number);
+    get paused(): boolean;
+    /** What is left (ms), counting the time run since the last start. */
+    left(): number;
+    pause(reason: PauseReason): void;
+    resume(reason: PauseReason): void;
+    clear(): void;
+    private run;
+}
+interface ToastOptions extends FloatingLayerOptions {
+    /** The edge it enters from and leaves to (Bottom by default). */
+    edge?: ToastEdge | string | null;
+    /** How long it stays (else `toastDuration(text)`). */
+    durationMs?: number | null;
+    /** The element that raised it — its scope (an open dialog) and whether the look applies. */
+    from?: Element | null;
+    /** The page's language for the close control's name. */
+    lang?: string | null;
+}
+interface ToastHandle {
+    readonly element: HTMLElement;
+    /** Leave now (the close control, a newer toast, the canvas switching it off). */
+    close(): void;
+}
+/** Take down every toast stack under `root` (a page torn down, a spec). */
+declare function clearToasts(root: ParentNode | null | undefined): void;
+/**
+ * Raise a toast. Null when there is nothing to say or nowhere to say it (no document).
+ * A first toast creates its live region and lands a frame later, so assistive technology hears it.
+ */
+declare function showToast(doc: Document | null | undefined, text: string | null | undefined, options?: ToastOptions): ToastHandle | null;
+/**
+ * The builder canvas's design-time state: hold a toast up (no timer) so the author styles it, or take it down. One per
+ * layer; showing it again only changes its words.
+ */
+declare function showToastDesign(doc: Document | null | undefined, text: string, show: boolean, options?: ToastOptions): void;
+
+/**
+ * A form that KEEPS its fields after sending says so in a toast (premium M5, N3 — the Form's After sending ▸ "Keep the
+ * fields and show a toast"). Its words are the form's own Sent words — the ones its submit button shows once it has sent
+ * (the author's "Once sent", else "Sent" in the page's language) — so the toast and the button never disagree. ONE
+ * helper for the component path and the string path.
+ */
+/** The Sent words a form says: its submit button's Sent label, else "Sent" in its language. */
+declare function formSentWords(form: Element): string;
+/** True when the rendered form keeps its fields and toasts (the attribute every renderer writes). */
+declare function formToastsOnSend(form: Element | null | undefined): boolean;
+/** Raise the form's Sent toast (from the form — its scope and its look). */
+declare function raiseFormToast(form: Element): ToastHandle | null;
 
-export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CALENDAR_CLOSING_ATTRIBUTE, CALENDAR_DESIGN_ATTRIBUTE, CALENDAR_INSTANT_ATTRIBUTE, CALENDAR_SHEET_QUERY, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CalendarClass, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_INTERACTION_EASING, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DatePickerRuntime, DeclarationContext, EASING_KEYWORDS, EASING_TOKENS, ELEMENT_STYLE_TRANSITION_EXTRAS, ENTRANCE_ACTION_TYPES, ENTRANCE_FALLBACK_CSS, ENTRANCE_NOSCRIPT_CSS, ENTRANCE_PRESTATE_ATTRIBUTE, EXIT_ACTION_TYPES, EasingKeyword, EasingToken, FLOATING_GAP, FLOATING_MARGIN, FloatingSide, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HEADER_SCROLL_HYSTERESIS_PX, HOVER_DEFAULT_TRANSITION_TRAITS, HOVER_MEDIA_QUERY, HOVER_STATES, HeaderRuntime, INTERACTION_ANIMATION_ID, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, IoxVideoComponent, LAST_EMITTED_STATES, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION_TRAITS, LEGACY_SWIPER_CONTROLS, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, NAMED_GROUP_ROLES, NO_PAGE_TRANSITION, ON_STATE_ROLES, OUTER_STYLE_PROPS, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PART_PAGINATION_MODIFIER, PHONE_TRANSITION_QUERY, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PageStyleField, PageStyleSource, PointerKind, REDUCED_MOTION_QUERY, RELATIONAL_STATE_PSEUDO, RevealActionType, SCROLLED_ATTRIBUTE, SCROLLED_STATE_ROLE, SCROLLED_THRESHOLD_PX, SCROLL_EASINGS, SELF_PLAYING_TRIGGERS, SHAKE_DURATION_MS, SHAKE_EASING, SHAKE_KEYFRAMES, SLIDER_FEEL, SLIDER_INPUTS_ATTRIBUTE, SLIDER_INPUT_NAMES, SLIDER_PHONE_BREAKPOINT, SLIDER_RUNWAY_CLASS, SLIDER_STEPS_PROPERTY, SLIDE_CAPTION_ATTRIBUTE, STATE_PSEUDO_CLASS, STRUCTURAL_STATES, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SWIPER_TRIGGER_EVENTS, ScrollEasing, SectionComponent, SettleMode, StringFormRuntime, SwiperModuleName, TARGETED_STATE_SUFFIX, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TRANSITION_FEELS, TRANSITION_PROPERTY_KEY, TextAlign, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, animateAction, applyBindingPipes, applyFeel, attachDatePicker, attachDatePickers, attachStringForm, bootSlider, breakpointDef, breakpointForWidth, breakpointQueryFor, buildInteractionKeyframes, buildPartSelector, buildSwiperBreakpoints, buildTargetedStateSelector, buildTargetedSuffixSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, closeAboveMediaQuery, collectContextSlotKeys, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, datePickerOf, declaredInputNames, decomposeBackdropFilter, defaultHoverTransitionTraits, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, domHasSliderParts, durationMs, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, entranceStartsHidden, feelFor, fieldLanguage, finalKeyframe, framesFromLiveValue, gateHoverRule, getSeoValue, hasHoverState, hasOwnPageTransition, hasOwnTransition, headerShouldHide, hidingHeadersIn, initialSlotValues, isActionEnabled, isContextAction, isCubicBezier, isCurrentLink, isEasingToken, isExternalOrFragment, isGradientPaint, isHoverPointer, isHoverState, isInputOverriddenAt, isInteractionEasing, isLastEmittedStateKey, isOverriddenAt, isPressFeedback, isScrolled, isStructuralState, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, legacyEnterToTransition, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, needsGroupName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeGalleryImage, normalizeIconClass, orderStatesForEmit, pageTransitionOf, parentBreakpoint, parseUrlList, partClassName, placeFloating, planPartRule, planResponsiveRules, planScroll, planStateRule, planSwiperOptions, playDualLayerTransition, playInteraction, prefersReducedMotion, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolveInteractionEasing, resolvePageTransition, resolvePath, resolveSeo, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setDateFieldValue, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, settleInteraction, settleModeFor, shakeElement, showCalendarDesign, sliderControlElements, sliderInputsFromProps, sliderInputsOf, sliderRunwayHtml, splitOuterProps, splitPressFeedback, stateNamesIn, statePseudoClass, stateSelectorSuffix, stateTransitionProperties, stringFormRuntimeOf, stripSuppressedProps, swiperAutoplayAllowed, swiperLoopOptions, swiperModuleNames, syncNodeA11yAttributes, syncSubmitButtons, targetedStateSelector, transitionPropertyList, viewportTransitionContext, watchHeaders, watchScrolled, withContextSlots, withPhoneDefaults, withStateTransitions, wrapInBreakpointQuery, wrapInMediaQuery };
-export type { A11yNodeSource, AnimateActionOptions, BoundValueSpec, BreakpointDef, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, DatePickerOptions, FloatingOptions, FloatingPlacement, FloatingRect, FloatingSize, FloatingViewport, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, HeaderRuntimeOptions, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageScrollStart, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionContext, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, PlannedPageTransition, PressAction, RegisteredField, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteAnimationLike, ScrollPlanContext, ScrollSource, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SettleOptions, SliderBootOptions, SliderControlElements, SliderInputs, StateRulePlan, StateScope, StateStyleMap, StringFormOptions, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, SwiperPlan, SwiperPlanContext, ToggleableAction, TransitionFeel, TransitionPhase, TransitionPreviewLayers, TransitionTimelineInput, TransitionViewport, ValueSource, VirtualTraitGroup };
+export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CALENDAR_CLOSING_ATTRIBUTE, CALENDAR_DESIGN_ATTRIBUTE, CALENDAR_INSTANT_ATTRIBUTE, CALENDAR_SHEET_QUERY, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CalendarClass, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_INTERACTION_EASING, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DatePickerRuntime, DeclarationContext, EASING_KEYWORDS, EASING_TOKENS, ELEMENT_STYLE_TRANSITION_EXTRAS, ENTRANCE_ACTION_TYPES, ENTRANCE_FALLBACK_CSS, ENTRANCE_NOSCRIPT_CSS, ENTRANCE_PRESTATE_ATTRIBUTE, EXIT_ACTION_TYPES, EasingKeyword, EasingToken, FLOATING_GAP, FLOATING_LAYER_CLASS, FLOATING_MARGIN, FLOATING_SHEET_QUERY, FloatingAlign, FloatingSide, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HEADER_SCROLL_HYSTERESIS_PX, HOVER_DEFAULT_TRANSITION_TRAITS, HOVER_MEDIA_QUERY, HOVER_STATES, HeaderRuntime, INTERACTION_ANIMATION_ID, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxPopoverComponent, IoxSubmitButtonComponent, IoxUiModule, IoxVideoComponent, LAST_EMITTED_STATES, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION_TRAITS, LEGACY_SWIPER_CONTROLS, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, NAMED_GROUP_ROLES, NO_PAGE_TRANSITION, ON_STATE_ROLES, OUTER_STYLE_PROPS, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PART_PAGINATION_MODIFIER, PHONE_TRANSITION_QUERY, PIPE_DESCRIPTORS, PIPE_REGISTRY, POPOVER_SELECTOR, PageScrollProvider, PageStyleField, PageStyleSource, PausableTimer, PauseReason, PointerKind, PopoverAttribute, REDUCED_MOTION_QUERY, RELATIONAL_STATE_PSEUDO, RevealActionType, SCROLLED_ATTRIBUTE, SCROLLED_STATE_ROLE, SCROLLED_THRESHOLD_PX, SCROLL_EASINGS, SELF_PLAYING_TRIGGERS, SHAKE_DURATION_MS, SHAKE_EASING, SHAKE_KEYFRAMES, SLIDER_FEEL, SLIDER_INPUTS_ATTRIBUTE, SLIDER_INPUT_NAMES, SLIDER_PHONE_BREAKPOINT, SLIDER_RUNWAY_CLASS, SLIDER_STEPS_PROPERTY, SLIDE_CAPTION_ATTRIBUTE, STATE_PSEUDO_CLASS, STRUCTURAL_STATES, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SWIPER_TRIGGER_EVENTS, ScrollEasing, SectionComponent, SettleMode, StringFormRuntime, SwiperModuleName, TARGETED_STATE_SUFFIX, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TOAST_CLOSE_WORDS, TOAST_DESIGN_ATTRIBUTE, TOAST_EDGE_ATTRIBUTE, TOAST_FIRST_LANDS_MS, TOAST_MAX_MS, TOAST_MAX_VISIBLE, TOAST_MIN_MS, TOAST_MS_PER_CHAR, TOOLTIP_ATTRIBUTE, TOOLTIP_FIRST_DELAY_MS, TOOLTIP_HIDE_GRACE_MS, TOOLTIP_INSTANT_ATTRIBUTE, TOOLTIP_PINNED_ATTRIBUTE, TOOLTIP_PLACEMENT_ATTRIBUTE, TOOLTIP_SIDE_ATTRIBUTE, TOOLTIP_TYPES, TOOLTIP_WARM_MS, TRANSITION_FEELS, TRANSITION_PROPERTY_KEY, TextAlign, TextBlockComponent, ToastClass, ToastEdge, TooltipClass, TooltipRuntime, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, animateAction, applyBindingPipes, applyFeel, attachDatePicker, attachDatePickers, attachStringForm, attachTooltips, bootSlider, breakpointDef, breakpointForWidth, breakpointQueryFor, buildInteractionKeyframes, buildPartSelector, buildSwiperBreakpoints, buildTargetedStateSelector, buildTargetedSuffixSelector, buildTransitionTimeline, canPopover, cascadeChain, clearInputOverride, clearOverride, clearToasts, closeAboveMediaQuery, closeAllPopovers, closePopover, collectContextSlotKeys, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, datePickerOf, declaredInputNames, decomposeBackdropFilter, defaultHoverTransitionTraits, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, domHasSliderParts, durationMs, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, entranceStartsHidden, feelFor, fieldLanguage, finalKeyframe, floatingLayer, floatingScope, formSentWords, formToastsOnSend, framesFromLiveValue, gateHoverRule, getSeoValue, hasHoverState, hasOwnPageTransition, hasOwnTransition, headerShouldHide, hideFromTopLayer, hidingHeadersIn, initialSlotValues, isActionEnabled, isContextAction, isCubicBezier, isCurrentLink, isEasingToken, isExternalOrFragment, isGradientPaint, isHoverPointer, isHoverState, isInputOverriddenAt, isInteractionEasing, isLastEmittedStateKey, isOpenPopover, isOverriddenAt, isPopoverOpen, isPressFeedback, isScrolled, isStructuralState, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, layerFrame, legacyEnterToTransition, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, needsGroupName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeGalleryImage, normalizeIconClass, openPopover, orderStatesForEmit, pageTransitionOf, parentBreakpoint, parseUrlList, partClassName, placeFloating, placePopover, planPartRule, planResponsiveRules, planScroll, planStateRule, planSwiperOptions, playDualLayerTransition, playInteraction, popoverPanelAttributes, popoverSide, prefersReducedMotion, raiseFloatingLayer, raiseFormToast, rectInLayer, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolveInteractionEasing, resolvePageTransition, resolvePath, resolveSeo, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setDateFieldValue, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, settleInteraction, settleModeFor, shakeElement, showCalendarDesign, showInTopLayer, showToast, showToastDesign, sliderControlElements, sliderInputsFromProps, sliderInputsOf, sliderRunwayHtml, splitOuterProps, splitPressFeedback, stateNamesIn, statePseudoClass, stateSelectorSuffix, stateTransitionProperties, stringFormRuntimeOf, stripSuppressedProps, swiperAutoplayAllowed, swiperLoopOptions, swiperModuleNames, syncNodeA11yAttributes, syncSubmitButtons, targetedStateSelector, toLayerRect, toastCloseWord, toastDuration, toastEdge, toastsToEvict, togglePopover, tooltipSide, tooltipTiming, tooltipWords, tooltipsOf, transitionPropertyList, viewportTransitionContext, watchHeaders, watchScrolled, withContextSlots, withPhoneDefaults, withStateTransitions, wrapInBreakpointQuery, wrapInMediaQuery };
+export type { A11yNodeSource, AnimateActionOptions, BoundValueSpec, BreakpointDef, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, DatePickerOptions, FloatingLayerOptions, FloatingOptions, FloatingPlacement, FloatingRect, FloatingSize, FloatingViewport, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, HeaderRuntimeOptions, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, LayerFrame, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageScrollStart, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionContext, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, PlannedPageTransition, PopoverCloseOptions, PopoverOpenOptions, PressAction, RegisteredField, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteAnimationLike, ScrollPlanContext, ScrollSource, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SettleOptions, SliderBootOptions, SliderControlElements, SliderInputs, StateRulePlan, StateScope, StateStyleMap, StringFormOptions, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, SwiperPlan, SwiperPlanContext, ToastHandle, ToastOptions, ToggleableAction, TooltipRuntimeOptions, TooltipTimingState, TransitionFeel, TransitionPhase, TransitionPreviewLayers, TransitionTimelineInput, TransitionViewport, ValueSource, VirtualTraitGroup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.85.0",
+  "version": "5.86.1",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/src/actions-core/action.model.ts

@@ -11,7 +11,7 @@ export type ActionKind = 'animated' | 'instant' | 'server';
 
 /** Picker grouping. Flat lists die at ~10 entries; the group is data, never a second list. */
 export type ActionGroup =
-    | 'motion' | 'visibility' | 'navigate' | 'dialog' | 'item' | 'form' | 'data' | 'consent' | 'service';
+    | 'motion' | 'visibility' | 'navigate' | 'dialog' | 'popover' | 'notice' | 'item' | 'form' | 'data' | 'consent' | 'service';
 
 /**
  * What a step does inside the live builder canvas (the canvas RUNS interactions):

package/src/actions-core/dialog-opener.ts

@@ -56,18 +56,24 @@ export interface OpenerNodeLike {
 
 const SELF = 'self';
 
-/** The Dialog node id the element's click opens (its first enabled opener action), or null. */
-export function openedDialogId(node: OpenerNodeLike | null | undefined): string | 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). */
+export function openedTargetId(node: OpenerNodeLike | null | undefined, openerTypes: ReadonlySet<string>): string | null {
     for (const ix of node?.interactions ?? []) {
         if (ix?.trigger !== DIALOG_OPENER_TRIGGER) continue;
         for (const action of ix.actions ?? []) {
-            if (!action || action.disabled === true || !DIALOG_OPENER_ACTION_TYPES.has(String(action.type))) continue;
+            if (!action || action.disabled === true || !openerTypes.has(String(action.type))) continue;
             if (action.target && action.target !== SELF) return action.target;
         }
     }
     return null;
 }
 
+/** The Dialog node id the element's click opens (its first enabled opener action), or null. */
+export function openedDialogId(node: OpenerNodeLike | null | undefined): string | null {
+    return openedTargetId(node, DIALOG_OPENER_ACTION_TYPES);
+}
+
 /**
  * The opener attributes for a node: `{}` when its click opens no dialog, else
  * `aria-haspopup="dialog"`, `aria-controls="iox-dialog-<id>"` and `aria-expanded` (`false` unless