@vectoriox/iox-builder 1.4.34 → 1.4.36

package/package.json

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

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

@@ -133,6 +133,14 @@ interface StylePreset {
     /** Per-state style overrides stored alongside the preset (e.g. hover, active, focus). */
     stateStyles?: Partial<Record<ElementState, Record<string, any>>>;
 }
+/** A reusable element definition whose instances all stay in sync.
+ *  Stored in the `symbols` backend collection; referenced by ComponentNode.symbolId. */
+interface IoxSymbol {
+    id: string;
+    name: string;
+    /** Full serialised node tree — same shape as a page layout node. */
+    node: Record<string, any>;
+}
 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[];
@@ -175,6 +183,10 @@ interface ComponentNode {
      *  interaction target identifier. Only nodes with a label appear in the
      *  interaction target picker. */
     label?: string;
+    /** ID of the org-level IoxSymbol this node is linked to.
+     *  Absent on stamps (independent copies). When present, any style change
+     *  on this node propagates to all other instances of the same symbol. */
+    symbolId?: string;
 }
 /**
  * Build a full StyleTraitGroup[] schema populated with values from a flat
@@ -335,7 +347,8 @@ declare enum ToolbarAction {
     SaveAsBlock = "save-as-block",
     MakeGlobal = "make-global",
     RemoveGlobal = "remove-global",
-    EditPreset = "edit-preset"
+    EditPreset = "edit-preset",
+    DetachSymbol = "detach-symbol"
 }
 declare enum NodeAction {
     Delete = "delete",
@@ -454,7 +467,9 @@ declare enum PanelEventTypes {
     /** Open the Style panel in preset-edit mode for the given preset ID. */
     PRESET_EDIT = "presetedit",
     /** Fired after a preset is created, updated, or deleted so panels refresh their list. */
-    PRESETS_CHANGED = "presetschanged"
+    PRESETS_CHANGED = "presetschanged",
+    /** Fired when a linked symbol instance's styles change — propagates to all instances. */
+    SYMBOLS_CHANGED = "symbolschanged"
 }
 interface PanelEvent {
     type: PanelEventTypes;
@@ -535,6 +550,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;
@@ -1050,10 +1067,28 @@ declare class PresetRegistryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<PresetRegistryService>;
 }
 
+/**
+ * SymbolRegistryService — in-memory store for org-level symbols.
+ *
+ * Loaded once per page by PageUiComponent alongside the page layout.
+ * Scoped to PageUiComponent.providers[] via IoxBuilderModule — one registry per builder instance.
+ */
+declare class SymbolRegistryService {
+    private symbols;
+    setSymbols(symbols: IoxSymbol[]): void;
+    getSymbol(id: string): IoxSymbol | undefined;
+    getAll(): IoxSymbol[];
+    upsert(symbol: IoxSymbol): void;
+    remove(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SymbolRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SymbolRegistryService>;
+}
+
 declare class OverlayComponent implements OnInit, OnDestroy {
     private overlayService;
     private viewportService;
     private presetRegistry;
+    private symbolRegistry;
     private styleRegistry;
     private cdr;
     toolbarAction: EventEmitter<{
@@ -1074,8 +1109,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, styleRegistry: StyleRegistryService, cdr: ChangeDetectorRef);
+    constructor(overlayService: OverlayService, viewportService: ViewportService, presetRegistry: PresetRegistryService, symbolRegistry: SymbolRegistryService, styleRegistry: StyleRegistryService, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnDestroy(): void;
     onSelectParent(event: MouseEvent): void;
@@ -1091,7 +1128,10 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     get hasInteractions(): boolean;
     get selectedNodeIsGlobal(): boolean;
     get selectedPresetName(): string | null;
+    get isLinkedSymbol(): boolean;
+    get linkedSymbolName(): string | null;
     onEditPreset(event: MouseEvent): void;
+    onDetachSymbol(event: MouseEvent): void;
     private observeSelectElement;
     private updateAll;
     private updateHover;
@@ -1528,5 +1568,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, 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, 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, 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 };