@vectoriox/iox-builder 2.3.4 → 2.5.0

package/package.json

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

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

@@ -1,14 +1,14 @@
 import * as i0 from '@angular/core';
 import { ComponentRef, Type, ChangeDetectorRef, OnInit, AfterViewInit, OnChanges, OnDestroy, EventEmitter, ElementRef, ApplicationRef, SimpleChanges, ViewContainerRef, Injector, EnvironmentInjector, InjectionToken, TemplateRef, AfterContentInit, QueryList } from '@angular/core';
+import * as i28 from '@vectoriox/iox-ui';
+import { RelativeSourceSpec, DataSourceEndpoints } from '@vectoriox/iox-ui';
+export { ComponentInstanceRegistryService, VIRTUAL_TRAIT_KEYS, composeVirtualTraits } from '@vectoriox/iox-ui';
 import * as rxjs from 'rxjs';
 import { Subject, Subscription, BehaviorSubject, Observable } from 'rxjs';
 import * as _vectoriox_iox_builder from '@vectoriox/iox-builder';
 import * as i23 from 'primeng/popover';
 import { Popover } from 'primeng/popover';
 import { HttpClient } from '@angular/common/http';
-import * as i28 from '@vectoriox/iox-ui';
-import { DataSourceEndpoints } from '@vectoriox/iox-ui';
-export { ComponentInstanceRegistryService, VIRTUAL_TRAIT_KEYS, composeVirtualTraits } from '@vectoriox/iox-ui';
 import * as i20 from '@angular/cdk/drag-drop';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import * as i18 from '@angular/common';
@@ -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",
@@ -69,11 +72,15 @@ declare enum DataSourceType {
     Static = "static",
     /** A VIEW into another variable: `{ from: <alias>, path }` (e.g. galleryImages = product.gallery).
      *  Resolves to the value one (or more) level(s) into a parent variable — page-scoped. */
-    Derived = "derived"
+    Derived = "derived",
+    /** A ROUTE-CONTEXT value derived from the current route item — `$route`/`$current`/`$siblings`/
+     *  `$related`. Not fetched: computed by the shared `computeRelative` from other resolved sources.
+     *  See relative-data-sources-plan.md. */
+    Relative = "relative"
 }
 interface IoxDataSource {
     id: string;
-    type: 'cms' | 'shop' | 'internal-api' | 'external-api' | 'static' | 'derived';
+    type: 'cms' | 'shop' | 'internal-api' | 'external-api' | 'static' | 'derived' | 'relative';
     mode: 'single' | 'query';
     alias: string;
     request: {
@@ -84,6 +91,9 @@ interface IoxDataSource {
             from: string;
             path: string;
         };
+        /** `relative` alias: a route-context computation (kind + from/subjectFrom/sortBy/matchFields…),
+         *  resolved by the shared `computeRelative`. */
+        relative?: RelativeSourceSpec;
         cms?: {
             contentType: string;
             filter?: any;
@@ -292,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;
@@ -369,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();
 }
@@ -1380,6 +1399,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>;
@@ -1800,8 +1823,14 @@ declare class BuilderDataSourceService {
     fetchRepeaterItems(ds: IoxDataSource | undefined, sourcePath?: string): Observable<any[]>;
     /**
      * Resolve a data source BY ALIAS, following `derived` aliases (a VIEW into another variable:
-     * resolve the parent, then getByPath). `findByAlias` is injected so this module stays registry-free
-     * (the caller passes its own page-scoped registry). Recurses for chained derived aliases.
+     * resolve the parent, then getByPath) and `relative` aliases (route-context — `$current`/
+     * `$siblings`/`$related`). `findByAlias` is injected so this module stays registry-free (the caller
+     * passes its own page-scoped registry). Recurses for chained aliases.
+     *
+     * The builder is design time: `relative` sources resolve their dependency aliases (subject +
+     * collection) — a single source falls back to its `defaultId`, a list to the whole collection —
+     * then run the SHARED `computeRelative`, so the canvas shows the SAME neighbours the SSR engine
+     * bakes into the live page. `$route` has no live params at design time → `{}`.
      */
     fetchByAlias(alias: string, findByAlias: (a: string) => IoxDataSource | undefined): Observable<any>;
     /** Repeater items for an alias (follows derived aliases + applies an optional sourcePath). */
@@ -2290,5 +2319,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, flattenSchemaFields, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
 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 };