@vectoriox/iox-builder 2.4.0 → 2.6.0

package/package.json

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

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

@@ -22,6 +22,9 @@ import * as i27 from 'primeng/dialog';
 
 declare enum StyleCategory {
     Layout = "Layout",
+    /** How THIS node participates in its parent's flex/grid flow (align-self, flex-grow, grid-column…).
+     *  Distinct from Layout, which configures the node as a container for its OWN children. */
+    ChildLayout = "Child Layout",
     Size = "Size",
     Typography = "Typography",
     Spacing = "Spacing",
@@ -299,12 +302,18 @@ interface QuadSizeSegment {
     icon: string;
     ariaLabel?: string;
 }
-/** Conditional visibility: this trait only shows when the named sibling trait matches one of the given values. */
+/** Conditional visibility: this trait only shows when a controlling trait matches one of the given values.
+ *  `scope` selects whose trait is inspected:
+ *   - `'self'` (default): a sibling trait on the SAME node/group (e.g. grid tracks show when this node's display=grid).
+ *   - `'parent'`: the same-named trait on the node's PARENT (e.g. flex-child props show when the PARENT's display=flex).
+ *     Parent-scoped conditions are resolved by the style panel, which threads the parent's live value in. */
 interface TraitShowCondition {
-    /** name of another trait in the same style group */
+    /** name of the controlling trait (a sibling when scope='self'; read off the parent when scope='parent') */
     trait: string;
     /** one value or an array of values that make this trait visible */
     values: string | string[];
+    /** whose trait to inspect — defaults to 'self' (a sibling in the same group). */
+    scope?: 'self' | 'parent';
 }
 interface ComponentTrait {
     name: string;
@@ -376,6 +385,9 @@ declare class PositionGroupStyleConfig extends GroupStyleConfig {
 declare class LayoutGroupStyleConfig extends GroupStyleConfig {
     constructor();
 }
+declare class ChildLayoutGroupStyleConfig extends GroupStyleConfig {
+    constructor();
+}
 declare class SizeGroupStyleConfig extends GroupStyleConfig {
     constructor();
 }
@@ -510,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",
@@ -1364,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;
@@ -1387,6 +1401,10 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private findRepeaterAncestorOf;
     /** 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
+     *  time, so that is the live source of truth; fall back to a preset's `styleOverrides` map, then
+     *  the CSS initial value. */
+    private readNodeDisplay;
     private handlePanelEvents;
     static ɵfac: i0.ɵɵFactoryDeclaration<BuilderComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BuilderComponent, "app-builder", never, { "layout": { "alias": "layout"; "required": false; }; "dataSources": { "alias": "dataSources"; "required": false; }; "orgId": { "alias": "orgId"; "required": false; }; "routeParams": { "alias": "routeParams"; "required": false; }; "pageName": { "alias": "pageName"; "required": false; }; "isSaving": { "alias": "isSaving"; "required": false; }; "pageStatus": { "alias": "pageStatus"; "required": false; }; "pageSettings": { "alias": "pageSettings"; "required": false; }; "globalElements": { "alias": "globalElements"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "moveableMode": { "alias": "moveableMode"; "required": false; }; }, { "save": "save"; "undo": "undo"; "redo": "redo"; "back": "back"; "preview": "preview"; "publishToggle": "publishToggle"; "pageSettingsChange": "pageSettingsChange"; "applyAnimationToAll": "applyAnimationToAll"; "saveBlock": "saveBlock"; "globalElementsChange": "globalElementsChange"; }, never, ["[builderComponents]", "[builderTokens]", "[builderPanel]"], false, never>;
@@ -1537,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>;
@@ -1569,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;
@@ -2188,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;
@@ -2303,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, 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 };