@vectoriox/iox-builder 1.4.35 → 1.4.37

package/package.json

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

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

@@ -141,6 +141,16 @@ interface IoxSymbol {
     /** Full serialised node tree — same shape as a page layout node. */
     node: Record<string, any>;
 }
+/**
+ * A named, reusable collection of IoxInteraction[] stored at the org level.
+ * Elements reference a preset by `interactionPresetId`. Editing the preset
+ * propagates updated interactions to all linked elements immediately.
+ */
+interface InteractionPreset {
+    id: string;
+    name: string;
+    interactions: IoxInteraction[];
+}
 type ElementState = 'hover' | 'active' | 'focus' | 'first-child' | 'last-child' | 'nth-child(odd)' | 'nth-child(even)';
 /** Interaction pseudo-classes — compiled to .iox-node-{id}:state */
 declare const INTERACTION_STATES: ElementState[];
@@ -187,6 +197,9 @@ interface ComponentNode {
      *  Absent on stamps (independent copies). When present, any style change
      *  on this node propagates to all other instances of the same symbol. */
     symbolId?: string;
+    /** ID of the org-level InteractionPreset applied to this node.
+     *  When set, node.interactions reflects the preset's interactions. */
+    interactionPresetId?: string;
 }
 /**
  * Build a full StyleTraitGroup[] schema populated with values from a flat
@@ -298,7 +311,8 @@ declare function buildFullStyleTraits(): GroupStyleConfig[];
 declare enum PanelTypes {
     BINDINGS = "Bindings",
     STYLES = "Styles",
-    PAGE = "Page"
+    PAGE = "Page",
+    INTERACTIONS = "Interactions"
 }
 type RouteAnimationPreset = 'none' | 'fade' | 'slideUp' | 'slideDown' | 'zoomIn' | 'zoomOut' | 'blurIn' | 'flip';
 declare const ROUTE_ANIMATION_OPTIONS: {
@@ -348,7 +362,12 @@ declare enum ToolbarAction {
     MakeGlobal = "make-global",
     RemoveGlobal = "remove-global",
     EditPreset = "edit-preset",
-    DetachSymbol = "detach-symbol"
+    DetachSymbol = "detach-symbol",
+    EditInteractionPreset = "edit-interaction-preset",
+    CopyPreset = "copy-preset",
+    PastePreset = "paste-preset",
+    CopyInteractionPreset = "copy-interaction-preset",
+    PasteInteractionPreset = "paste-interaction-preset"
 }
 declare enum NodeAction {
     Delete = "delete",
@@ -469,7 +488,13 @@ declare enum PanelEventTypes {
     /** Fired after a preset is created, updated, or deleted so panels refresh their list. */
     PRESETS_CHANGED = "presetschanged",
     /** Fired when a linked symbol instance's styles change — propagates to all instances. */
-    SYMBOLS_CHANGED = "symbolschanged"
+    SYMBOLS_CHANGED = "symbolschanged",
+    /** Fired on every structural or style mutation — used by BuilderHistoryService to snapshot. */
+    LAYOUT_CHANGED = "layoutchanged",
+    /** Open the Interactions panel in preset-edit mode for the given preset ID. */
+    INTERACTION_PRESET_EDIT = "interactionpresetedit",
+    /** Fired after an interaction preset is created, updated, or deleted so panels refresh. */
+    INTERACTION_PRESETS_CHANGED = "interactionpresetschanged"
 }
 interface PanelEvent {
     type: PanelEventTypes;
@@ -550,6 +575,8 @@ declare class DragEngineService {
     private _scale;
     /** Called by BuilderComponent whenever the viewport scale changes. */
     setScale(scale: number): void;
+    private _dropzoneRectCache;
+    private _snapshotRects;
     private readonly ROOT_ESCAPE_PX;
     private _rootEscapeActiveFor;
     private _getEl;
@@ -722,6 +749,31 @@ declare class ViewportService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ViewportService>;
 }
 
+interface BuilderClipboard {
+    node?: ComponentNode;
+    presetId?: string;
+    interactionPresetId?: string;
+}
+/**
+ * BuilderClipboardService — in-memory typed clipboard for the page builder.
+ *
+ * Stores element copies, style preset references, and interaction preset references.
+ * Lives in memory only — no navigator.clipboard usage.
+ * Scoped to PageUiComponent.providers[] — one clipboard per builder instance.
+ */
+declare class BuilderClipboardService {
+    private _clip;
+    copyNode(node: ComponentNode): void;
+    copyPreset(presetId: string): void;
+    copyInteractionPreset(interactionPresetId: string): void;
+    getNode(): ComponentNode | undefined;
+    getPresetId(): string | undefined;
+    getInteractionPresetId(): string | undefined;
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderClipboardService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BuilderClipboardService>;
+}
+
 declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDestroy {
     private registry;
     private overlayService;
@@ -730,6 +782,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private dsRegistry;
     private viewportService;
     private interactionEngine;
+    private clipboard;
     private cdr;
     private appRef;
     layout: ComponentNode[];
@@ -820,7 +873,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     get canvasMinHeight(): number;
     private sub?;
     private registrySub?;
-    constructor(registry: ComponentRegistryService, overlayService: OverlayService, panelEventService: PanelEventService, dragEngine: DragEngineService, dsRegistry: DataSourceRegistryService, viewportService: ViewportService, interactionEngine: InteractionEngineService, cdr: ChangeDetectorRef, appRef: ApplicationRef);
+    constructor(registry: ComponentRegistryService, overlayService: OverlayService, panelEventService: PanelEventService, dragEngine: DragEngineService, dsRegistry: DataSourceRegistryService, viewportService: ViewportService, interactionEngine: InteractionEngineService, clipboard: BuilderClipboardService, cdr: ChangeDetectorRef, appRef: ApplicationRef);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
@@ -1082,11 +1135,30 @@ declare class SymbolRegistryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<SymbolRegistryService>;
 }
 
+/**
+ * InteractionPresetRegistryService — in-memory store for org-level interaction presets.
+ *
+ * Loaded once per page by PageUiComponent alongside the page layout.
+ * Scoped to PageUiComponent.providers[] via IoxBuilderModule — one registry per builder instance.
+ */
+declare class InteractionPresetRegistryService {
+    private presets;
+    setPresets(presets: InteractionPreset[]): void;
+    getPreset(id: string): InteractionPreset | undefined;
+    getAll(): InteractionPreset[];
+    upsert(preset: InteractionPreset): void;
+    remove(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InteractionPresetRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<InteractionPresetRegistryService>;
+}
+
 declare class OverlayComponent implements OnInit, OnDestroy {
     private overlayService;
     private viewportService;
     private presetRegistry;
     private symbolRegistry;
+    private interactionPresetRegistry;
+    private clipboard;
     private styleRegistry;
     private cdr;
     toolbarAction: EventEmitter<{
@@ -1107,8 +1179,10 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     private containerResizeObserver?;
     private mutationObserver?;
     private boundUpdate;
+    private _scrollRaf;
+    private boundScrollUpdate;
     private activeScrollContainer;
-    constructor(overlayService: OverlayService, viewportService: ViewportService, presetRegistry: PresetRegistryService, symbolRegistry: SymbolRegistryService, styleRegistry: StyleRegistryService, cdr: ChangeDetectorRef);
+    constructor(overlayService: OverlayService, viewportService: ViewportService, presetRegistry: PresetRegistryService, symbolRegistry: SymbolRegistryService, interactionPresetRegistry: InteractionPresetRegistryService, clipboard: BuilderClipboardService, styleRegistry: StyleRegistryService, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnDestroy(): void;
     onSelectParent(event: MouseEvent): void;
@@ -1126,7 +1200,15 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     get selectedPresetName(): string | null;
     get isLinkedSymbol(): boolean;
     get linkedSymbolName(): string | null;
+    get selectedInteractionPresetName(): string | null;
+    get hasPresetInClipboard(): boolean;
+    get hasInteractionPresetInClipboard(): boolean;
     onEditPreset(event: MouseEvent): void;
+    onEditInteractionPreset(event: MouseEvent): void;
+    onCopyPreset(event: MouseEvent): void;
+    onPastePreset(event: MouseEvent): void;
+    onCopyInteractionPreset(event: MouseEvent): void;
+    onPasteInteractionPreset(event: MouseEvent): void;
     onDetachSymbol(event: MouseEvent): void;
     private observeSelectElement;
     private updateAll;
@@ -1488,6 +1570,30 @@ declare class IoxBuilderModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<IoxBuilderModule>;
 }
 
+interface HistoryEntry {
+    layout: ComponentNode[];
+    timestamp: number;
+}
+/**
+ * BuilderHistoryService — snapshot-based undo/redo for the page builder.
+ *
+ * Snapshots are JSON deep-clones of the full layout array.
+ * Session-only — not persisted to the backend.
+ * Scoped to PageUiComponent.providers[] — one history stack per builder instance.
+ */
+declare class BuilderHistoryService {
+    private _past;
+    private _future;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    push(layout: ComponentNode[]): void;
+    undo(): ComponentNode[] | null;
+    redo(): ComponentNode[] | null;
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderHistoryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BuilderHistoryService>;
+}
+
 declare const VIRTUAL_TRAIT_KEYS: Set<string>;
 /**
  * Strip virtual trait keys from `raw` and emit their composed CSS equivalents.
@@ -1564,5 +1670,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ComponentConfig, ComponentRegistryService, DEVICE_OPTIONS, DataSourceRegistryService, DeviceMode, DragEngineService, EASING_OPTIONS, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_CONTENT_SERVICE, IOX_FONT_MANAGER, InteractionEngineService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LayerTreeComponent, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PresetRegistryService, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SymbolRegistryService, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, VIRTUAL_TRAIT_KEYS, ViewportService, ZOOM_OPTIONS, buildFullStyleTraits, buildPresetStyleTraits, composeVirtualTraits, defaultPageSettings, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
-export type { ComponentNode, ComponentTrait, DeviceOption, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, InteractionAction, InteractionActionType, InteractionTrigger, IoxBinding, IoxContentService, 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 };
+export { ACTION_TYPE_OPTIONS, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ComponentConfig, ComponentRegistryService, DEVICE_OPTIONS, DataSourceRegistryService, DeviceMode, DragEngineService, EASING_OPTIONS, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_CONTENT_SERVICE, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LayerTreeComponent, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PresetRegistryService, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SymbolRegistryService, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, VIRTUAL_TRAIT_KEYS, ViewportService, ZOOM_OPTIONS, buildFullStyleTraits, buildPresetStyleTraits, composeVirtualTraits, defaultPageSettings, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
+export type { BuilderClipboard, ComponentNode, ComponentTrait, DeviceOption, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, HistoryEntry, InteractionAction, InteractionActionType, InteractionPreset, InteractionTrigger, IoxBinding, IoxContentService, 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 };