@vectoriox/iox-builder 1.0.9 → 1.1.0

package/package.json

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

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

@@ -107,6 +107,17 @@ declare const ACTION_TYPE_OPTIONS: {
     value: InteractionActionType;
     label: string;
 }[];
+/**
+ * A named, reusable collection of CSS style properties stored at the org level.
+ * Elements reference a preset by `stylePresetId`. At render time the engine
+ * merges `preset.styleProps → element.styleOverrides` so local overrides win.
+ */
+interface StylePreset {
+    id: string;
+    name: string;
+    /** Flat CSS property map — same shape as IoxLayoutNode.styleProps. */
+    styleProps: Record<string, any>;
+}
 interface ComponentNode {
     id?: string;
     /**
@@ -125,7 +136,21 @@ interface ComponentNode {
     children?: ComponentNode[];
     isGlobal?: boolean;
     globalPosition?: 'before' | 'after';
+    /** ID of the org-level StylePreset applied to this node. */
+    stylePresetId?: string;
+    /**
+     * CSS properties explicitly overridden by the user after a preset was applied.
+     * Serialized to `styleProps` in the page layout JSON when a preset is active.
+     * Absent when no preset is applied (full styles stored in styleTraits instead).
+     */
+    styleOverrides?: Record<string, any>;
 }
+/**
+ * Build a full StyleTraitGroup[] schema populated with values from a flat
+ * styleProps map. Used when editing a preset in the Style panel — the panel
+ * receives the same `StyleTraitGroup[]` shape regardless of context.
+ */
+declare function buildPresetStyleTraits(styleProps: Record<string, any>): StyleTraitGroup[];
 declare enum TraitInputType {
     Text = "text",
     Number = "number",
@@ -266,7 +291,8 @@ declare enum ToolbarAction {
     Play = "play",
     SaveAsBlock = "save-as-block",
     MakeGlobal = "make-global",
-    RemoveGlobal = "remove-global"
+    RemoveGlobal = "remove-global",
+    EditPreset = "edit-preset"
 }
 declare enum NodeAction {
     Delete = "delete",
@@ -373,7 +399,11 @@ declare enum PanelEventTypes {
     PANEL_OPEN = "panelopen",
     PANEL_CLOSE = "panelclose",
     BINDING_CHANGED = "bindingchanged",
-    NODE_RENDERED = "noderendered"
+    NODE_RENDERED = "noderendered",
+    /** 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"
 }
 interface PanelEvent {
     type: PanelEventTypes;
@@ -833,9 +863,39 @@ declare class IoxDropzoneDirective implements OnInit, OnDestroy {
     static ɵdir: i0.ɵɵDirectiveDeclaration<IoxDropzoneDirective, "[ioxDropzone]", never, { "ioxDropzoneId": { "alias": "ioxDropzoneId"; "required": false; }; "ioxDropzoneData": { "alias": "ioxDropzoneData"; "required": false; }; "ioxDropzonePostDrop": { "alias": "ioxDropzonePostDrop"; "required": false; }; }, { "ioxDrop": "ioxDrop"; }, never, never, false, never>;
 }
 
+/**
+ * PresetRegistryService — in-memory store for org-level style presets.
+ *
+ * Loaded once per page by PageUiComponent (alongside the page layout) and
+ * injected into the overlay (for badge labels) and style panel (for apply /
+ * create / edit / detach flows).
+ *
+ * Scoped to PageUiComponent.providers[] — one registry per builder instance.
+ */
+declare class PresetRegistryService {
+    private presets;
+    setPresets(presets: StylePreset[]): void;
+    getPreset(id: string): StylePreset | undefined;
+    getAll(): StylePreset[];
+    upsert(preset: StylePreset): void;
+    remove(id: string): void;
+    /**
+     * Resolve the effective style map for a node that references a preset.
+     * Merges preset base styles with the node's local overrides so that
+     * element-level values always win.
+     *
+     * @param presetId  ID of the applied preset.
+     * @param overrides The node's `styleOverrides` record (may be empty).
+     */
+    resolveStyles(presetId: string, overrides: Record<string, any>): Record<string, any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PresetRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PresetRegistryService>;
+}
+
 declare class OverlayComponent implements OnInit, OnDestroy {
     private overlayService;
     private viewportService;
+    private presetRegistry;
     private cdr;
     toolbarAction: EventEmitter<{
         action: ToolbarAction;
@@ -857,7 +917,7 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     private mutationObserver?;
     private boundUpdate;
     private activeScrollContainer;
-    constructor(overlayService: OverlayService, viewportService: ViewportService, cdr: ChangeDetectorRef);
+    constructor(overlayService: OverlayService, viewportService: ViewportService, presetRegistry: PresetRegistryService, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnDestroy(): void;
     onSelectParent(event: MouseEvent): void;
@@ -874,6 +934,8 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     closeContextMenu(): void;
     get hasInteractions(): boolean;
     get selectedNodeIsGlobal(): boolean;
+    get selectedPresetName(): string | null;
+    onEditPreset(event: MouseEvent): void;
     private observeSelectElement;
     private updateAll;
     private updateHover;
@@ -1242,5 +1304,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, BuilderButtonComponentConfig, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, CardComponentConfig, ComponentConfig, ComponentRegistryService, DEVICE_OPTIONS, DataSourceRegistryService, DeviceMode, DragEngineService, EASING_OPTIONS, GroupStyleConfig, IOX_CONTENT_SERVICE, IOX_FONT_MANAGER, InteractionEngineService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LayerTreeComponent, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, SectionComponent, SectionComponentConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, defaultPageSettings, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
-export type { ComponentNode, ComponentTrait, DeviceOption, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, InteractionAction, InteractionActionType, InteractionTrigger, IoxBinding, IoxContentService, IoxDataSource, IoxDropEvent, IoxFontManager, IoxInteraction, NodeRef, OverlayBoxModel, OverlayBoxSpacing, OverlayEntry, PageRouteAnimationSettings, PageScrollSettings, PageSettings, PageStyleSettings, PanelEvent, QuadSizeSegment, RouteAnimationPreset, ScreenWidthOption, StyleTrait, StyleTraitGroup, TraitOptionMap, TraitSelectOption, TraitShowCondition, ViewportState, ZoomOption };
+export { ACTION_TYPE_OPTIONS, BuilderButtonComponentConfig, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, CardComponentConfig, ComponentConfig, ComponentRegistryService, DEVICE_OPTIONS, DataSourceRegistryService, DeviceMode, DragEngineService, EASING_OPTIONS, GroupStyleConfig, IOX_CONTENT_SERVICE, IOX_FONT_MANAGER, InteractionEngineService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LayerTreeComponent, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PresetRegistryService, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, SectionComponent, SectionComponentConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, buildPresetStyleTraits, defaultPageSettings, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
+export type { ComponentNode, ComponentTrait, DeviceOption, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, 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 };