@vectoriox/iox-builder 2.5.0 → 2.6.1

package/package.json

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

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

@@ -522,7 +522,8 @@ declare enum ToolbarAction {
     PasteInteractionPreset = "paste-interaction-preset",
     Copy = "copy",
     Paste = "paste",
-    AddSlide = "add-slide"
+    AddSlide = "add-slide",
+    Wrap = "wrap"
 }
 declare enum NodeAction {
     Delete = "delete",
@@ -1376,6 +1377,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
         entry: OverlayEntry;
         position?: 'before' | 'after';
         interaction?: IoxInteraction;
+        wrapType?: string;
     }): void;
     confirmSaveBlock(): void;
     cancelSaveBlock(): void;
@@ -1397,6 +1399,10 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
      *  scope, so the bindings panel needs the repeater to sample its current item (e.g. bind an
      *  Image to a `gallery` string item). Prefers the innermost repeater when nested. */
     private findRepeaterAncestorOf;
+    /** If `node` lives inside a Repeater template, tell that repeater to rebuild its preview rows so
+     *  a structural change (e.g. wrapping a template child) propagates to every repeated row. No-op
+     *  when the node is not inside a repeater. */
+    private _refreshRepeaterFor;
     /** Emit ELEMENT_SELECT with the ancestors the panels need (symbol + repeater item scope). */
     private _emitElementSelect;
     /** Read a node's current `display` value. The style panel mutates `styleTraits` in place at edit
@@ -1553,7 +1559,16 @@ declare class OverlayComponent implements OnInit, OnDestroy {
         entry: OverlayEntry;
         position?: "before" | "after";
         interaction?: IoxInteraction;
+        wrapType?: string;
     }>;
+    /** Element types the selected node can be wrapped in (Wrap-in submenu). Phase 1: layout containers. */
+    readonly wrapTargets: {
+        type: string;
+        label: string;
+        icon: string;
+    }[];
+    /** Whether the Wrap-in flyout submenu is open (hover-driven). */
+    wrapSubmenuOpen: boolean;
     hoverEntry: OverlayEntry | null;
     selectEntry: OverlayEntry | null;
     hiOutlineStyle: Record<string, string>;
@@ -1585,6 +1600,9 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     onSelectParent(event: MouseEvent): void;
     onDuplicate(event: MouseEvent): void;
     onDelete(event: MouseEvent): void;
+    onWrap(event: MouseEvent, wrapType: string): void;
+    /** Slider slides must stay direct children of the slider container — never wrap them. */
+    get canWrap(): boolean;
     onPlay(event: MouseEvent): void;
     onSaveAsBlock(event: MouseEvent): void;
     onToggleMore(event: MouseEvent): void;
@@ -1887,6 +1905,13 @@ declare class BuilderRepeaterComponent implements OnInit, OnDestroy {
     private isInTemplate;
     private refreshPreviews;
     private applyFirstItemToTemplate;
+    /** Apply item[0]'s bound values to the live template row, walking the WHOLE subtree — not just
+     *  direct children. A bound node can sit any level deep once a template child is wrapped in a
+     *  container (or otherwise nested), so recursion is required or the first row shows defaults. */
+    private applyBindingsToNodes;
+    /** Rebuild preview rows after the template STRUCTURE changed (e.g. a child was wrapped, deleted,
+     *  or moved). Deferred so the new DOM + overlay refs exist before bindings are re-applied. */
+    refreshTemplate(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BuilderRepeaterComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BuilderRepeaterComponent, "app-builder-repeater", never, { "children": { "alias": "children"; "required": false; }; "style": { "alias": "style"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "dropListId": { "alias": "dropListId"; "required": false; }; "source": { "alias": "source"; "required": false; }; "sourcePath": { "alias": "sourcePath"; "required": false; }; "limit": { "alias": "limit"; "required": false; }; }, { "childClick": "childClick"; "childMouseEnter": "childMouseEnter"; "childMouseLeave": "childMouseLeave"; }, never, never, false, never>;
 }
@@ -2204,6 +2229,38 @@ declare class IoxBuilderModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<IoxBuilderModule>;
 }
 
+/**
+ * Locate a node within a forest (array of root nodes + their descendants) by
+ * reference identity. Returns the parent array holding the node and its index,
+ * or `null` if the node is not present.
+ *
+ * Reference-based to match the rest of the builder tree operations, which pass
+ * the live `ComponentNode` object around (see `findNodeInTree`).
+ */
+declare function findNodeLocation(roots: ComponentNode[], target: ComponentNode): {
+    parent: ComponentNode[];
+    index: number;
+} | null;
+/**
+ * Wrap `target` inside `wrapper`, in place, within the forest it already lives in.
+ *
+ * The wrapper replaces the target at its original position and takes the target
+ * as its only child. **Context is preserved** — the operation never moves the
+ * node between the page and global trees; the caller passes the forest the node
+ * lives in (page layout OR global elements), and the surgery stays inside it.
+ *
+ * Global flags (`isGlobal`/`globalPosition`) are carried ONLY by the top-level
+ * node of the global forest. When wrapping such a node, those flags transfer to
+ * the wrapper — which becomes the new top-level global node — and are cleared on
+ * the now-inner node, so the element keeps rendering in its global slot. Wrapping
+ * anything else (a page node, or a child nested inside a global element) leaves
+ * all global flags untouched.
+ *
+ * @returns the wrapper on success, or `null` if the target was not found (in
+ *          which case nothing is mutated).
+ */
+declare function wrapNode(roots: ComponentNode[], target: ComponentNode, wrapper: ComponentNode): ComponentNode | null;
+
 interface HistoryEntry {
     layout: ComponentNode[];
     timestamp: number;
@@ -2319,5 +2376,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, 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, DEVICE_OPTIONS, DataSourceRegistryService, DataSourceType, DeviceMode, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EffectsGroupStyleConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, 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, SymbolRegistryService, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, buildFullStyleTraits, buildPresetStyleTraits, defaultPageSettings, flattenSchemaFields, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
+export { ACTION_TYPE_OPTIONS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, 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, DEVICE_OPTIONS, DataSourceRegistryService, DataSourceType, DeviceMode, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EffectsGroupStyleConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, 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, SymbolRegistryService, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, buildFullStyleTraits, buildPresetStyleTraits, defaultPageSettings, findNodeLocation, flattenSchemaFields, generateNodeId, resolveTraitControllerType, resolveTraitOptions, wrapNode };
 export type { BuilderClipboard, ComponentEventDef, ComponentMethodDef, ComponentNode, ComponentTrait, DeviceOption, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, HistoryEntry, InteractionAction, InteractionActionType, InteractionPreset, InteractionTrigger, IoxBinding, IoxDataSource, IoxDropEvent, IoxFontManager, IoxInteraction, IoxSymbol, NodeRef, OverlayBoxModel, OverlayBoxSpacing, OverlayEntry, PageRouteAnimationSettings, PageScrollSettings, PageSettings, PageStyleSettings, PanelEvent, QuadSizeSegment, RouteAnimationPreset, ScreenWidthOption, StylePreset, StyleTrait, StyleTraitGroup, TraitOptionMap, TraitSelectOption, TraitShowCondition, ViewportState, ZoomOption };