@vectoriox/iox-builder 2.2.1 → 2.3.0

package/package.json

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

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

@@ -66,16 +66,24 @@ declare enum DataSourceType {
     Shop = "shop",
     ExternalApi = "external-api",
     InternalApi = "internal-api",
-    Static = "static"
+    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"
 }
 interface IoxDataSource {
     id: string;
-    type: 'cms' | 'shop' | 'internal-api' | 'external-api' | 'static';
+    type: 'cms' | 'shop' | 'internal-api' | 'external-api' | 'static' | 'derived';
     mode: 'single' | 'query';
     alias: string;
     request: {
         method?: 'GET' | 'POST';
         endpoint?: string;
+        /** `derived` alias: resolve `from` (another alias) then getByPath(value, path). */
+        derived?: {
+            from: string;
+            path: string;
+        };
         cms?: {
             contentType: string;
             filter?: any;
@@ -1767,6 +1775,14 @@ declare class BuilderDataSourceService {
      * Uses the SHARED `resolveRepeaterItems` so the canvas preview matches the SSR engine.
      */
     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.
+     */
+    fetchByAlias(alias: string, findByAlias: (a: string) => IoxDataSource | undefined): Observable<any>;
+    /** Repeater items for an alias (follows derived aliases + applies an optional sourcePath). */
+    fetchRepeaterItemsByAlias(alias: string, findByAlias: (a: string) => IoxDataSource | undefined, sourcePath?: string): Observable<any[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<BuilderDataSourceService, [null, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<BuilderDataSourceService>;
 }
@@ -1778,7 +1794,13 @@ declare class BuilderRepeaterComponent implements OnInit, OnDestroy {
     private dsRegistry;
     private panelEventService;
     private cdr;
-    children: ComponentNode[];
+    private _children;
+    get children(): ComponentNode[];
+    /** RenderDirective sets `source` (→ fetchData) BEFORE `children`. With an async source the response
+     *  lands after children are set, so previews build fine; but a SYNC source (static, or a fast
+     *  cache) resolves before children exist, leaving previewRows empty. Rebuild when children arrive
+     *  (or change) so both orderings — and loaded pages with sync sources — render their rows. */
+    set children(value: ComponentNode[]);
     style: {
         [key: string]: any;
     };