@vectoriox/iox-builder 2.11.0 → 2.12.1

package/package.json

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

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

@@ -1077,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;
     /**
@@ -1143,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;
@@ -1268,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;
@@ -1368,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.
@@ -1906,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
@@ -1937,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;
@@ -2226,6 +2256,22 @@ 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[];
+    /** Add-form state for a context action. */
+    newSlot: string;
+    newValueKind: 'item' | 'source';
+    newValueSource: string;
+    newValuePath: string;
+    /** Defaults ON — a row that cleared itself on mouseleave would blink on every row-to-row move. */
+    newKeepAfterLeave: boolean;
+    /** 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;
@@ -2243,6 +2289,8 @@ declare class InteractionsPanelComponent implements OnInit, OnDestroy {
     constructor(overlayService: OverlayService, componentRegistry: ComponentRegistryService);
     get isSwiperGoToSlide(): boolean;
     get isSwiperAction(): boolean;
+    /** The add-form is building a context action — it needs a slot, not a target/duration/easing. */
+    get isNewContextAction(): boolean;
     ngOnInit(): void;
     /** Merge component-specific events into trigger options and methods into action options. */
     private refreshDynamicOptions;
@@ -2260,6 +2308,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;