@vectoriox/iox-builder 4.25.0 → 4.27.0

package/index.d.ts

@@ -1,24 +1,24 @@
 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 i29 from '@vectoriox/iox-ui';
-import { ResponsiveOverrides, RelativeSourceSpec, Breakpoint, PageStyleSettings, FormRenderState, DataSourceEndpoints } from '@vectoriox/iox-ui';
+import * as i30 from '@vectoriox/iox-ui';
+import { ResponsiveOverrides, RelativeSourceSpec, Breakpoint, PageStyleSettings, FormRenderState, DataSourceEndpoints, ComponentInstanceRegistryService } from '@vectoriox/iox-ui';
 export { ComponentInstanceRegistryService, IoxContextSlot, PageStyleSettings, 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';
-import * as i24 from 'primeng/popover';
+import * as i25 from 'primeng/popover';
 import { Popover } from 'primeng/popover';
 import { HttpClient } from '@angular/common/http';
-import * as i21 from '@angular/cdk/drag-drop';
+import * as i22 from '@angular/cdk/drag-drop';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
-import * as i19 from '@angular/common';
-import * as i20 from '@angular/forms';
-import * as i22 from 'primeng/accordion';
-import * as i23 from 'primeng/button';
-import * as i25 from 'primeng/inputtext';
-import * as i26 from 'primeng/select';
-import * as i27 from 'primeng/tooltip';
-import * as i28 from 'primeng/dialog';
+import * as i20 from '@angular/common';
+import * as i21 from '@angular/forms';
+import * as i23 from 'primeng/accordion';
+import * as i24 from 'primeng/button';
+import * as i26 from 'primeng/inputtext';
+import * as i27 from 'primeng/select';
+import * as i28 from 'primeng/tooltip';
+import * as i29 from 'primeng/dialog';
 
 declare enum StyleCategory {
     Layout = "Layout",
@@ -131,7 +131,7 @@ interface IoxDataSource {
 }
 
 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' | 'setContext' | 'clearContext' | 'swiperNext' | 'swiperPrev' | 'swiperGoToSlide' | 'swiperAutoplayStart' | 'swiperAutoplayStop' | 'swiperAutoplayPause';
+type InteractionActionType = 'fadeIn' | 'fadeOut' | 'moveUp' | 'moveDown' | 'moveLeft' | 'moveRight' | 'scaleIn' | 'scaleOut' | 'rotate' | 'show' | 'hide' | 'toggleVisibility' | 'setContext' | 'clearContext' | 'openDialog' | 'closeDialog' | 'toggleDialog' | 'navigate' | 'scrollTo' | 'submitForm' | 'copyToClipboard' | 'swiperNext' | 'swiperPrev' | 'swiperGoToSlide' | 'swiperAutoplayStart' | 'swiperAutoplayStop' | 'swiperAutoplayPause';
 interface InteractionAction {
     type: InteractionActionType;
     /** 'self' targets the node that owns the interaction; otherwise a node ID. */
@@ -1395,6 +1395,8 @@ declare class InteractionEngineService {
     private rowItemFor;
     /** Resolved data for the canvas, kept current by the repeater as it fetches. */
     setContextData(data: Record<string, any>): void;
+    private executeBehaviourAction;
+    private executeDialogAction;
     private executeSwiperAction;
     private resolveTarget;
     private executeAction;
@@ -1880,6 +1882,12 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private updatePreviewVh;
     private initLenis;
     private destroyLenis;
+    /**
+     * K5 (actions plan): actions need NAMED targets — the panel lists only labeled nodes, so an
+     * unlabeled Dialog is unpickable. Every insert path labels the node "<Type>" or "<Type> N",
+     * counting existing labels of that family across the whole tree.
+     */
+    private autoLabel;
     addComponent(name: string): void;
     onDrop(event: IoxDropEvent): void;
     onModeChange(mode: BuilderMode): void;
@@ -2593,6 +2601,40 @@ declare class BuilderButtonBlockComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<BuilderButtonBlockComponent, "button[iox-button-block],a[iox-button-block]", never, { "children": { "alias": "children"; "required": false; }; "style": { "alias": "style"; "required": false; }; "tag": { "alias": "tag"; "required": false; }; "href": { "alias": "href"; "required": false; }; "target": { "alias": "target"; "required": false; }; "type": { "alias": "type"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "dropListId": { "alias": "dropListId"; "required": false; }; }, { "childClick": "childClick"; "childMouseEnter": "childMouseEnter"; "childMouseLeave": "childMouseLeave"; }, never, never, false, never>;
 }
 
+/**
+ * The Dialog's CANVAS twin (actions plan A1b / boards A4–A5). Two render strategies, one model:
+ * the live site uses a real `<dialog>` (top layer); here the overlay is `position: fixed`, which
+ * a transformed ancestor CONTAINS — so it fills the page frame, not the admin viewport, at every
+ * zoom. Closed it renders as a compact chip in flow (A4's "closed later? reopen from the chip"),
+ * and a freshly dropped EMPTY dialog opens itself — you land designing it, not hunting it.
+ * Open/close/toggle actions reach it through the instance registry, same as Swiper's methods.
+ */
+declare class BuilderDialogComponent implements OnInit, OnDestroy {
+    private dragEngine;
+    private instanceRegistry;
+    private cdr;
+    children: ComponentNode[];
+    style: {
+        [key: string]: any;
+    };
+    nodeId: string;
+    dropListId: string;
+    closeOnBackdrop: boolean | string;
+    showCloseButton: boolean | string;
+    childClick: EventEmitter<any>;
+    childMouseEnter: EventEmitter<any>;
+    childMouseLeave: EventEmitter<void>;
+    /** Canvas-only visibility. Never serialised; the live site always starts closed. */
+    designOpen: boolean;
+    constructor(dragEngine: DragEngineService, instanceRegistry: ComponentInstanceRegistryService, cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    onBackdrop(): void;
+    onDrop(event: IoxDropEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BuilderDialogComponent, "app-builder-dialog", never, { "children": { "alias": "children"; "required": false; }; "style": { "alias": "style"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "dropListId": { "alias": "dropListId"; "required": false; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; }; }, { "childClick": "childClick"; "childMouseEnter": "childMouseEnter"; "childMouseLeave": "childMouseLeave"; }, never, never, false, never>;
+}
+
 declare class SliderContainerComponent implements OnInit, AfterViewInit, OnChanges, OnDestroy {
     private dragEngine;
     private cdr;
@@ -2881,7 +2923,7 @@ declare class AuditPanelComponent {
 
 declare class IoxBuilderModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<IoxBuilderModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<IoxBuilderModule, [typeof BuilderComponent, typeof RenderDirective, typeof IoxDraggableDirective, typeof IoxDropzoneDirective, typeof OverlayComponent, typeof ToolbarComponent, typeof SectionComponent, typeof BuilderContainerComponent, typeof BuilderLinkedContainerComponent, typeof BuilderRepeaterComponent, typeof BuilderButtonBlockComponent, typeof SliderContainerComponent, typeof SliderSlideComponent, typeof PanelComponent, typeof PanelChildComponent, typeof LayerTreeComponent, typeof BreadcrumbBarComponent, typeof AuditPanelComponent], [typeof i19.CommonModule, typeof i20.FormsModule, typeof i21.DragDropModule, typeof i22.AccordionModule, typeof i23.ButtonModule, typeof i24.PopoverModule, typeof i25.InputTextModule, typeof i26.SelectModule, typeof i27.TooltipModule, typeof i28.DialogModule, typeof i29.IoxPageModule], [typeof i19.CommonModule, typeof i20.FormsModule, typeof i21.DragDropModule, typeof i22.AccordionModule, typeof i23.ButtonModule, typeof i24.PopoverModule, typeof i25.InputTextModule, typeof i26.SelectModule, typeof i27.TooltipModule, typeof i28.DialogModule, typeof i29.IoxPageModule, typeof BuilderComponent, typeof RenderDirective, typeof IoxDraggableDirective, typeof IoxDropzoneDirective, typeof OverlayComponent, typeof ToolbarComponent, typeof SectionComponent, typeof BuilderContainerComponent, typeof BuilderLinkedContainerComponent, typeof BuilderRepeaterComponent, typeof BuilderButtonBlockComponent, typeof SliderContainerComponent, typeof SliderSlideComponent, typeof PanelComponent, typeof PanelChildComponent, typeof LayerTreeComponent, typeof BreadcrumbBarComponent, typeof AuditPanelComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<IoxBuilderModule, [typeof BuilderComponent, typeof RenderDirective, typeof IoxDraggableDirective, typeof IoxDropzoneDirective, typeof OverlayComponent, typeof ToolbarComponent, typeof SectionComponent, typeof BuilderContainerComponent, typeof BuilderLinkedContainerComponent, typeof BuilderRepeaterComponent, typeof BuilderButtonBlockComponent, typeof BuilderDialogComponent, typeof SliderContainerComponent, typeof SliderSlideComponent, typeof PanelComponent, typeof PanelChildComponent, typeof LayerTreeComponent, typeof BreadcrumbBarComponent, typeof AuditPanelComponent], [typeof i20.CommonModule, typeof i21.FormsModule, typeof i22.DragDropModule, typeof i23.AccordionModule, typeof i24.ButtonModule, typeof i25.PopoverModule, typeof i26.InputTextModule, typeof i27.SelectModule, typeof i28.TooltipModule, typeof i29.DialogModule, typeof i30.IoxPageModule], [typeof i20.CommonModule, typeof i21.FormsModule, typeof i22.DragDropModule, typeof i23.AccordionModule, typeof i24.ButtonModule, typeof i25.PopoverModule, typeof i26.InputTextModule, typeof i27.SelectModule, typeof i28.TooltipModule, typeof i29.DialogModule, typeof i30.IoxPageModule, typeof BuilderComponent, typeof RenderDirective, typeof IoxDraggableDirective, typeof IoxDropzoneDirective, typeof OverlayComponent, typeof ToolbarComponent, typeof SectionComponent, typeof BuilderContainerComponent, typeof BuilderLinkedContainerComponent, typeof BuilderRepeaterComponent, typeof BuilderButtonBlockComponent, typeof BuilderDialogComponent, typeof SliderContainerComponent, typeof SliderSlideComponent, typeof PanelComponent, typeof PanelChildComponent, typeof LayerTreeComponent, typeof BreadcrumbBarComponent, typeof AuditPanelComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<IoxBuilderModule>;
 }
 
@@ -3100,6 +3142,17 @@ declare function nearestFormNode(path: readonly ComponentNode[] | null | undefin
  */
 declare function dropTargetLabel(containerName: string | null | undefined, index: number, childCount: number): string;
 
+/**
+ * Dialog (actions plan A1b) — an ordinary container whose children are normal nodes, rendered
+ * on the live site as a real `<dialog>` (top layer, free focus trap/Esc) and in the CANVAS as a
+ * fixed-position overlay contained by the transformed frame (a transform is a containing block
+ * for fixed descendants — the deliberate two-strategy split, see actions plan §6a).
+ * Ships CLOSED on the live site always; opened only by the dialog actions.
+ */
+declare class DialogComponentConfig extends ComponentConfig {
+    constructor();
+}
+
 declare class BuilderButtonComponentConfig extends ComponentConfig {
     constructor();
 }
@@ -3238,5 +3291,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BODY_CRUMB_LABEL, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BUILDER_CHROME_EN, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DataSourceRegistryService, DataSourceType, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, FIELD_PARTS, FORM_PRESETS, FORM_TYPE, FieldComponentConfig, FieldGroupComponentConfig, FormComponentConfig, FormErrorComponentConfig, FormStateService, FormSuccessComponentConfig, GalleryConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_BUILDER_LABELS, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SubmitButtonComponentConfig, SymbolRegistryService, TARGETED_STATES, TARGETED_STATE_BASE, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, VALIDATION_STATES, VALIDATION_STATE_CLASS, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildFormPreset, buildFullStyleTraits, buildLayoutPreset, buildPresetStyleTraits, canFluidise, collapseColumnsProps, columnCountOf, defaultBuilderLabels, defaultPageSettings, dropTargetLabel, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, isHiddenAt, matchesControlSearch, nearestFormNode, nodeAncestorPath, nodeAncestorPathInEither, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, setStyleTrait, stackChildrenProps, summarise, visibilityProps, wrapNode };
+export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BODY_CRUMB_LABEL, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BUILDER_CHROME_EN, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDialogComponent, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DataSourceRegistryService, DataSourceType, DialogComponentConfig, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, FIELD_PARTS, FORM_PRESETS, FORM_TYPE, FieldComponentConfig, FieldGroupComponentConfig, FormComponentConfig, FormErrorComponentConfig, FormStateService, FormSuccessComponentConfig, GalleryConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_BUILDER_LABELS, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SubmitButtonComponentConfig, SymbolRegistryService, TARGETED_STATES, TARGETED_STATE_BASE, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, VALIDATION_STATES, VALIDATION_STATE_CLASS, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildFormPreset, buildFullStyleTraits, buildLayoutPreset, buildPresetStyleTraits, canFluidise, collapseColumnsProps, columnCountOf, defaultBuilderLabels, defaultPageSettings, dropTargetLabel, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, isHiddenAt, matchesControlSearch, nearestFormNode, nodeAncestorPath, nodeAncestorPathInEither, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, setStyleTrait, stackChildrenProps, summarise, visibilityProps, wrapNode };
 export type { AuditFinding, AuditNode, BreakpointPresentation, BuilderClipboard, BuilderLabelResolver, ComponentEventDef, ComponentMethodDef, ComponentNode, ComponentTrait, CreateConfig, Crumb, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, FormPresetDef, FormPresetField, FormStateSnapshot, HistoryEntry, InsertTarget, InteractionAction, InteractionActionType, InteractionPreset, InteractionTrigger, IoxBinding, IoxDataSource, IoxDropEvent, IoxFontManager, IoxInteraction, IoxSymbol, LayoutPresetChildStyles, LayoutPresetDef, NodeRef, OverlayBoxModel, OverlayBoxSpacing, OverlayEntry, PageRouteAnimationSettings, PageScrollSettings, PageSettings, PanelEvent, QuadSizeSegment, RouteAnimationPreset, ScreenWidthOption, SelectionBadge, StyleMap, StylePart, StylePreset, StyleTrait, StyleTraitGroup, TraitOptionMap, TraitSelectOption, TraitShowCondition, TreePathNode, ViewportState, ZoomOption };

package/package.json

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