@vectoriox/iox-builder 2.5.0 → 2.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-builder",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "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;
@@ -1553,7 +1555,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 +1596,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;
@@ -2204,6 +2218,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 +2365,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 };