@vectoriox/iox-builder 1.9.2 → 2.0.0

package/package.json

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

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

@@ -1,11 +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 rxjs from 'rxjs';
-import { Subject, Subscription, BehaviorSubject } 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 { ActivatedRoute } from '@angular/router';
+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';
@@ -16,8 +19,6 @@ import * as i24 from 'primeng/inputtext';
 import * as i25 from 'primeng/select';
 import * as i26 from 'primeng/tooltip';
 import * as i27 from 'primeng/dialog';
-import * as i28 from '@vectoriox/iox-ui';
-export { ComponentInstanceRegistryService, VIRTUAL_TRAIT_KEYS, composeVirtualTraits } from '@vectoriox/iox-ui';
 
 declare enum StyleCategory {
     Layout = "Layout",
@@ -49,13 +50,15 @@ interface DsFilterByRouteParam {
     defaultId?: string;
 }
 /**
- * When mode=query: each entry maps a schema field to a URL query string
- * key (e.g. ?status=active → field "status").
- * `defaultValue` is used as a fallback in the builder preview.
+ * When mode=query: each entry filters a schema field, either from a URL query string key
+ * (e.g. ?status=active → field "status") or by a constant.
+ * `queryParam` OMITTED → constant filter: `defaultValue` is always the value.
+ * `queryParam` present → the URL value wins and `defaultValue` is the fallback (which is what the
+ * builder preview always uses — design time has no live query params).
  */
 interface DsFilterByQueryParam {
     field: string;
-    queryParam: string;
+    queryParam?: string;
     defaultValue?: string;
 }
 declare enum DataSourceType {
@@ -1636,32 +1639,53 @@ declare class BuilderLinkedContainerComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<BuilderLinkedContainerComponent, "app-builder-linked-container", never, { "children": { "alias": "children"; "required": false; }; "style": { "alias": "style"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "dropListId": { "alias": "dropListId"; "required": false; }; "linkType": { "alias": "linkType"; "required": false; }; "url": { "alias": "url"; "required": false; }; "pageRoute": { "alias": "pageRoute"; "required": false; }; "target": { "alias": "target"; "required": false; }; }, { "childClick": "childClick"; "childMouseEnter": "childMouseEnter"; "childMouseLeave": "childMouseLeave"; }, never, never, false, never>;
 }
 
-/** Optional CMS content fetcher. Provide from the host app to enable Repeater data preview. */
-declare const IOX_CONTENT_SERVICE: InjectionToken<IoxContentService>;
-/** Optional shop content fetcher. Provide from the host app to enable Repeater shop data preview. */
-declare const IOX_SHOP_SERVICE: InjectionToken<IoxContentService>;
-/** Optional font manager. Provide from the host app to populate the fontFamily dropdown. */
-declare const IOX_FONT_MANAGER: InjectionToken<IoxFontManager>;
-interface IoxContentService {
-    getContent(contentType: string, orgId?: string): rxjs.Observable<any>;
-}
-interface IoxFontManager {
-    loadFonts(orgId: string): void;
-    uploadedFonts$: rxjs.Observable<any>;
-    getAllFontOptions(): {
-        label: string;
-        value: string;
-    }[];
+/**
+ * Public content bases the builder canvas resolves data against — the SAME `@Public()` controllers
+ * the live storefront (SSR engine) hits, so the canvas preview shows what the published page shows.
+ * Provide from the host app, e.g. `{ cmsBase: config.host + 'api/', shopBase: config.host + 'api/shop/' }`.
+ */
+declare const IOX_DATA_SOURCE_ENDPOINTS: InjectionToken<DataSourceEndpoints>;
+/**
+ * THE data fetch for every canvas component that renders a data source (Repeater, SliderContainer)
+ * and for the bindings preview.
+ *
+ * Before this existed, each of those fetched by itself through an injected admin content service
+ * (`getContent(contentType, orgId)` → `api/org/:orgId/resources/:type`), which takes NO filters:
+ * the data source's `filterByQueryParams` / `filterByRouteParam` were silently ignored, so the
+ * canvas always showed the whole unfiltered collection, and the live SSR site — which does apply
+ * them — rendered something different. Every caller now runs the SHARED `planDataSource` from
+ * `@vectoriox/iox-ui` against the public controllers, exactly like the SSR engine.
+ */
+declare class BuilderDataSourceService {
+    private http;
+    private endpoints;
+    constructor(http: HttpClient, endpoints: DataSourceEndpoints | null);
+    /** True when the host app wired the public endpoints — without them nothing can be fetched. */
+    get isConfigured(): boolean;
+    /**
+     * Resolve a data source to the value its MODE describes: the item for a `single` source, the
+     * array for a `list`. The builder is design time — there are no live route or query params — so
+     * a route filter falls back to `defaultId` and a query filter to its `defaultValue`, which is
+     * exactly what `planDataSource` does with empty params.
+     *
+     * Callers pass the source itself (resolved from their own page-scoped
+     * `DataSourceRegistryService`) rather than an alias: this service is module-scoped and must not
+     * capture a registry from the wrong injector. Emits `null` when the source resolves to no
+     * request or the fetch fails — the canvas degrades to an empty preview, it never throws.
+     */
+    fetch(ds: IoxDataSource | undefined): Observable<any>;
+    /** Same fetch, always as an array — for the canvas components that repeat over the source. */
+    fetchItems(ds: IoxDataSource | undefined): Observable<any[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderDataSourceService, [null, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BuilderDataSourceService>;
 }
 
 declare class BuilderRepeaterComponent implements OnInit, OnDestroy {
     private dragEngine;
     private overlayService;
-    private contentService;
-    private shopContentService;
+    private dataSourceService;
     private dsRegistry;
     private panelEventService;
-    private activatedRoute;
     private cdr;
     children: ComponentNode[];
     style: {
@@ -1679,21 +1703,22 @@ declare class BuilderRepeaterComponent implements OnInit, OnDestroy {
     readonly refreshPreviewsBound: () => void;
     private _source;
     private _limit;
-    private orgId;
     private bindingSub?;
     get source(): string;
     set source(value: string);
     get limit(): number;
     set limit(value: number);
-    constructor(dragEngine: DragEngineService, overlayService: OverlayService, contentService: IoxContentService | null, shopContentService: IoxContentService | null, dsRegistry: DataSourceRegistryService, panelEventService: PanelEventService, activatedRoute: ActivatedRoute, cdr: ChangeDetectorRef);
+    constructor(dragEngine: DragEngineService, overlayService: OverlayService, dataSourceService: BuilderDataSourceService, dsRegistry: DataSourceRegistryService, panelEventService: PanelEventService, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnDestroy(): void;
     onDrop(event: IoxDropEvent): void;
+    /** Data comes from the SHARED resolver (public controllers + the source's own filters) — the
+     *  same decision the SSR engine runs, so the canvas preview matches the published page. */
     private fetchData;
     private isInTemplate;
     private refreshPreviews;
     private applyFirstItemToTemplate;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderRepeaterComponent, [null, null, { optional: true; }, { optional: true; }, null, null, null, null]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderRepeaterComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BuilderRepeaterComponent, "app-builder-repeater", never, { "children": { "alias": "children"; "required": false; }; "style": { "alias": "style"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "dropListId": { "alias": "dropListId"; "required": false; }; "source": { "alias": "source"; "required": false; }; "limit": { "alias": "limit"; "required": false; }; }, { "childClick": "childClick"; "childMouseEnter": "childMouseEnter"; "childMouseLeave": "childMouseLeave"; }, never, never, false, never>;
 }
 
@@ -1726,11 +1751,9 @@ declare class SliderContainerComponent implements OnInit, AfterViewInit, OnChang
     private cdr;
     isPreview: boolean;
     private overlayService;
-    private contentService;
-    private shopContentService;
+    private dataSourceService;
     private dsRegistry;
     private panelEventService;
-    private activatedRoute;
     children: ComponentNode[];
     private _style;
     private _previewStyle;
@@ -1792,18 +1815,19 @@ declare class SliderContainerComponent implements OnInit, AfterViewInit, OnChang
     editSwiperEl?: ElementRef<HTMLElement>;
     _swiper: any;
     private _initRafId;
-    private _orgId;
     private _bindingSub?;
     private instanceRegistry;
     private interactionEngine;
     private ngZone;
-    constructor(dragEngine: DragEngineService, cdr: ChangeDetectorRef, isPreview: boolean, overlayService: OverlayService, contentService: IoxContentService | null, shopContentService: IoxContentService | null, dsRegistry: DataSourceRegistryService, panelEventService: PanelEventService, activatedRoute: ActivatedRoute);
+    constructor(dragEngine: DragEngineService, cdr: ChangeDetectorRef, isPreview: boolean, overlayService: OverlayService, dataSourceService: BuilderDataSourceService | null, dsRegistry: DataSourceRegistryService, panelEventService: PanelEventService);
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     trackByNodeId(_index: number, node: ComponentNode): string;
     onDrop(event: IoxDropEvent): void;
+    /** Slides come from the SHARED resolver (public controllers + the source's own filters) — the
+     *  same decision the SSR engine runs, so the canvas preview matches the published page. */
     private fetchData;
     private refreshPreviews;
     private applyFirstItemToTemplate;
@@ -1813,7 +1837,7 @@ declare class SliderContainerComponent implements OnInit, AfterViewInit, OnChang
     private _initSwiper;
     private _destroySwiper;
     private _onSwiperEvent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SliderContainerComponent, [null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SliderContainerComponent, [null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SliderContainerComponent, "app-slider-container", never, { "children": { "alias": "children"; "required": false; }; "style": { "alias": "style"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "dropListId": { "alias": "dropListId"; "required": false; }; "dir": { "alias": "dir"; "required": false; }; "direction": { "alias": "direction"; "required": false; }; "slidesPerView": { "alias": "slidesPerView"; "required": false; }; "slidesPerGroup": { "alias": "slidesPerGroup"; "required": false; }; "loop": { "alias": "loop"; "required": false; }; "centeredSlides": { "alias": "centeredSlides"; "required": false; }; "spaceBetween": { "alias": "spaceBetween"; "required": false; }; "initialSlide": { "alias": "initialSlide"; "required": false; }; "autoHeight": { "alias": "autoHeight"; "required": false; }; "grabCursor": { "alias": "grabCursor"; "required": false; }; "slideToClickedSlide": { "alias": "slideToClickedSlide"; "required": false; }; "effect": { "alias": "effect"; "required": false; }; "speed": { "alias": "speed"; "required": false; }; "enableNavigation": { "alias": "enableNavigation"; "required": false; }; "navigationColor": { "alias": "navigationColor"; "required": false; }; "navigationSize": { "alias": "navigationSize"; "required": false; }; "enablePagination": { "alias": "enablePagination"; "required": false; }; "paginationColor": { "alias": "paginationColor"; "required": false; }; "paginationType": { "alias": "paginationType"; "required": false; }; "paginationClickable": { "alias": "paginationClickable"; "required": false; }; "paginationDynamicBullets": { "alias": "paginationDynamicBullets"; "required": false; }; "enableAutoplay": { "alias": "enableAutoplay"; "required": false; }; "autoplayDelay": { "alias": "autoplayDelay"; "required": false; }; "autoplayPauseOnMouseEnter": { "alias": "autoplayPauseOnMouseEnter"; "required": false; }; "autoplayDisableOnInteraction": { "alias": "autoplayDisableOnInteraction"; "required": false; }; "enableScrollbar": { "alias": "enableScrollbar"; "required": false; }; "freeMode": { "alias": "freeMode"; "required": false; }; "enableKeyboard": { "alias": "enableKeyboard"; "required": false; }; "enableMousewheel": { "alias": "enableMousewheel"; "required": false; }; "enableZoom": { "alias": "enableZoom"; "required": false; }; "enableParallax": { "alias": "enableParallax"; "required": false; }; "enableGrid": { "alias": "enableGrid"; "required": false; }; "gridRows": { "alias": "gridRows"; "required": false; }; "breakpoints": { "alias": "breakpoints"; "required": false; }; "source": { "alias": "source"; "required": false; }; "limit": { "alias": "limit"; "required": false; }; }, { "childClick": "childClick"; "childMouseEnter": "childMouseEnter"; "childMouseLeave": "childMouseLeave"; }, never, never, false, never>;
 }
 
@@ -2020,6 +2044,24 @@ declare class BuilderHistoryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<BuilderHistoryService>;
 }
 
+/**
+ * Canvas data preview used to come from host-provided content services (IOX_CONTENT_SERVICE /
+ * IOX_SHOP_SERVICE), whose `getContent(contentType, orgId)` hit the ADMIN resources endpoint and
+ * accepted no filters — so the Repeater/Slider ignored every data-source filter. Data now flows
+ * through BuilderDataSourceService + the shared planDataSource, configured with
+ * IOX_DATA_SOURCE_ENDPOINTS. Those tokens are gone; do not reintroduce a fetch that bypasses it.
+ */
+/** Optional font manager. Provide from the host app to populate the fontFamily dropdown. */
+declare const IOX_FONT_MANAGER: InjectionToken<IoxFontManager>;
+interface IoxFontManager {
+    loadFonts(orgId: string): void;
+    uploadedFonts$: rxjs.Observable<any>;
+    getAllFontOptions(): {
+        label: string;
+        value: string;
+    }[];
+}
+
 declare class BuilderButtonComponentConfig extends ComponentConfig {
     constructor();
 }
@@ -2093,5 +2135,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, 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, DataSourceType, DeviceMode, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EffectsGroupStyleConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_CONTENT_SERVICE, IOX_FONT_MANAGER, IOX_SHOP_SERVICE, 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, 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, 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, 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, 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 };