@vectoriox/iox-builder 2.10.4 → 2.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-builder",
-  "version": "2.10.4",
+  "version": "2.12.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/types/vectoriox-iox-builder.d.ts

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { ComponentRef, Type, ChangeDetectorRef, OnInit, AfterViewInit, OnChanges, OnDestroy, EventEmitter, ElementRef, ApplicationRef, SimpleChanges, ViewContainerRef, Injector, EnvironmentInjector, InjectionToken, TemplateRef, AfterContentInit, QueryList } from '@angular/core';
 import * as i28 from '@vectoriox/iox-ui';
 import { RelativeSourceSpec, DataSourceEndpoints } from '@vectoriox/iox-ui';
-export { ComponentInstanceRegistryService, VIRTUAL_TRAIT_KEYS, composeVirtualTraits } from '@vectoriox/iox-ui';
+export { ComponentInstanceRegistryService, IoxContextSlot, SetContextParams, VIRTUAL_TRAIT_KEYS, composeVirtualTraits } from '@vectoriox/iox-ui';
 import * as rxjs from 'rxjs';
 import { Subject, Subscription, BehaviorSubject, Observable } from 'rxjs';
 import * as _vectoriox_iox_builder from '@vectoriox/iox-builder';
@@ -119,8 +119,9 @@ interface IoxDataSource {
         params?: Record<string, any>;
     };
 }
+
 type InteractionTrigger = 'pageLoad' | 'click' | 'hover' | 'viewportEnter' | 'scrollProgress' | 'pageLeave' | 'pageEnter' | 'swiperSlideChange' | 'swiperReachBeginning' | 'swiperReachEnd' | 'swiperAutoplayStart' | 'swiperAutoplayStop' | 'swiperSlideActive' | 'swiperSlideInactive';
-type InteractionActionType = 'fadeIn' | 'fadeOut' | 'moveUp' | 'moveDown' | 'moveLeft' | 'moveRight' | 'scaleIn' | 'scaleOut' | 'rotate' | 'show' | 'hide' | 'toggleVisibility' | 'swiperNext' | 'swiperPrev' | 'swiperGoToSlide' | 'swiperAutoplayStart' | 'swiperAutoplayStop' | 'swiperAutoplayPause';
+type InteractionActionType = 'fadeIn' | 'fadeOut' | 'moveUp' | 'moveDown' | 'moveLeft' | 'moveRight' | 'scaleIn' | 'scaleOut' | 'rotate' | 'show' | 'hide' | 'toggleVisibility' | 'setContext' | 'clearContext' | 'swiperNext' | 'swiperPrev' | 'swiperGoToSlide' | 'swiperAutoplayStart' | 'swiperAutoplayStop' | 'swiperAutoplayPause';
 interface InteractionAction {
     type: InteractionActionType;
     /** 'self' targets the node that owns the interaction; otherwise a node ID. */
@@ -130,7 +131,12 @@ interface InteractionAction {
     /** Delay in milliseconds before the action starts. */
     delay: number;
     easing: 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';
-    /** Extra parameters (e.g. { distance: 20 } for move actions). */
+    /**
+     * Extra parameters — `{ distance: 20 }` for move actions. For `setContext`/`clearContext` this
+     * holds a `SetContextParams` (`{ slot, value, noReverse? }`), read structurally by the shared
+     * `contextActionEffect` in @vectoriox/iox-ui. Kept as an index signature because animation
+     * actions access it by key (`params?.['degrees']`).
+     */
     params?: Record<string, any>;
     /** If true, the action only plays once (relevant for viewport/scroll triggers). */
     once?: boolean;
@@ -1071,6 +1077,10 @@ declare class DataSourceRegistryService {
 declare class InteractionEngineService {
     private overlayService;
     private attached;
+    /** Shared with the SSR engine — one store type, one set of semantics. */
+    private contextStore;
+    /** Resolved data for the canvas, so a row marker (source + index) resolves back to its item. */
+    private contextData;
     /** Elements that have had pre-state applied (hidden by attach). */
     private preStatedElements;
     /**
@@ -1137,6 +1147,16 @@ declare class InteractionEngineService {
     private attachClick;
     private attachHover;
     private runActions;
+    /**
+     * Execute a context action against the shared store. The forward/reverse semantics come from
+     * `contextActionEffect` in @vectoriox/iox-ui — the same function the SSR engine calls, so the
+     * builder canvas and the live site behave identically.
+     */
+    private applyContextAction;
+    /** The repeater item this element belongs to — the nearest marked row ancestor. */
+    private rowItemFor;
+    /** Resolved data for the canvas, kept current by the repeater as it fetches. */
+    setContextData(data: Record<string, any>): void;
     private executeSwiperAction;
     private resolveTarget;
     private executeAction;
@@ -1262,6 +1282,15 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private appRef;
     private moveableCanvas;
     private selectoCanvas;
+    private contextStore;
+    /**
+     * Re-apply context-bound inputs on the CANVAS when a slot changes — the builder twin of the
+     * engine's effect. The canvas is a live runtime, so hovering a repeater row while editing must
+     * swap the bound element just as it does on the published site.
+     *
+     * Only nodes that read a slot are touched; nothing else re-renders (trap T2).
+     */
+    private readonly contextEffect;
     layout: ComponentNode[];
     dataSources: IoxDataSource[];
     orgId: string;
@@ -1362,6 +1391,12 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
+    /**
+     * Walk the tree and push freshly-resolved values into the live component instances of every node
+     * that reads a context slot. Uses the overlay's node→ComponentRef registry, and the shared
+     * `safeSetInput` so an undeclared input can never trigger NG0303.
+     */
+    private applyContextBindings;
     ngOnDestroy(): void;
     /**
      * Cancel the browser's default navigation for any link clicked on the editing canvas.
@@ -1900,6 +1935,7 @@ declare class BuilderRepeaterComponent implements OnInit, OnDestroy {
     private dsRegistry;
     private panelEventService;
     private cdr;
+    private interactionEngine;
     private _children;
     get children(): ComponentNode[];
     /** RenderDirective sets `source` (→ fetchData) BEFORE `children`. With an async source the response
@@ -1931,7 +1967,7 @@ declare class BuilderRepeaterComponent implements OnInit, OnDestroy {
     set sourcePath(value: string);
     get limit(): number;
     set limit(value: number);
-    constructor(dragEngine: DragEngineService, overlayService: OverlayService, dataSourceService: BuilderDataSourceService, dsRegistry: DataSourceRegistryService, panelEventService: PanelEventService, cdr: ChangeDetectorRef);
+    constructor(dragEngine: DragEngineService, overlayService: OverlayService, dataSourceService: BuilderDataSourceService, dsRegistry: DataSourceRegistryService, panelEventService: PanelEventService, cdr: ChangeDetectorRef, interactionEngine: InteractionEngineService);
     ngOnInit(): void;
     ngOnDestroy(): void;
     onDrop(event: IoxDropEvent): void;
@@ -2220,6 +2256,15 @@ declare class InteractionsPanelComponent implements OnInit, OnDestroy {
         label: string;
         value: string;
     }[];
+    /** Slot names already used anywhere on the canvas — offered as suggestions, not a closed list.
+     *  A slot needs no declaration to work: naming it in a setContext action creates it. */
+    knownSlots: string[];
+    /** Data-source aliases, for the "Pick a value…" mode. */
+    sourceOptions: {
+        label: string;
+        value: string;
+    }[];
+    private dsRegistry;
     /** State for the "add interaction" form */
     isAdding: boolean;
     newTrigger: InteractionTrigger;
@@ -2254,6 +2299,25 @@ declare class InteractionsPanelComponent implements OnInit, OnDestroy {
     removeInteraction(id: string): void;
     addAction(interaction: IoxInteraction): void;
     removeAction(interaction: IoxInteraction, index: number): void;
+    /** True for setContext/clearContext — they get a slot editor instead of a target + easing. */
+    isContextAction(action: InteractionAction): boolean;
+    private ctxParams;
+    slotOf(action: InteractionAction): string;
+    setSlot(action: InteractionAction, slot: string): void;
+    valueKindOf(action: InteractionAction): string;
+    setValueKind(action: InteractionAction, kind: string): void;
+    valueSourceOf(action: InteractionAction): string;
+    setValueSource(action: InteractionAction, source: string): void;
+    valuePathOf(action: InteractionAction): string;
+    setValuePath(action: InteractionAction, path: string): void;
+    /**
+     * "Keep after leave" — ON means the slot survives mouseleave (stored as `noReverse`).
+     * Defaults to ON: a repeater row that cleared itself on leave would blink on every row-to-row
+     * move. Turning it OFF is the list-container behaviour (leave clears).
+     */
+    keepAfterLeave(action: InteractionAction): boolean;
+    setKeepAfterLeave(action: InteractionAction, keep: boolean): void;
+    private refreshKnownSlots;
     hasToggle(interaction: IoxInteraction): boolean;
     enableToggle(interaction: IoxInteraction): void;
     disableToggle(interaction: IoxInteraction): void;