@vectoriox/iox-builder 2.2.2 → 2.3.1

package/fesm2022/vectoriox-iox-builder.mjs

@@ -17,7 +17,7 @@ import { SelectModule } from 'primeng/select';
 import { TooltipModule } from 'primeng/tooltip';
 import { DialogModule } from 'primeng/dialog';
 import * as i16 from '@vectoriox/iox-ui';
-import { ComponentInstanceRegistryService, DEFAULT_WIDTH_BY_TYPE, compileDeclarations, composeVirtualTraits, IS_PREVIEW, planDataSource, dataSourcePlanToRequest, normalizeCollectionResult, resolveRepeaterItems, IoxPageModule } from '@vectoriox/iox-ui';
+import { ComponentInstanceRegistryService, DEFAULT_WIDTH_BY_TYPE, compileDeclarations, composeVirtualTraits, IS_PREVIEW, planDataSource, dataSourcePlanToRequest, normalizeCollectionResult, resolveRepeaterItems, getByPath, IoxPageModule } from '@vectoriox/iox-ui';
 export { ComponentInstanceRegistryService, VIRTUAL_TRAIT_KEYS, composeVirtualTraits } from '@vectoriox/iox-ui';
 import Lenis from 'lenis';
 import { Subject, BehaviorSubject, of } from 'rxjs';
@@ -1894,6 +1894,9 @@ var DataSourceType;
     DataSourceType["ExternalApi"] = "external-api";
     DataSourceType["InternalApi"] = "internal-api";
     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. */
+    DataSourceType["Derived"] = "derived";
 })(DataSourceType || (DataSourceType = {}));
 /**
  * Maps each action type to its logical inverse for auto-populating toggle
@@ -5571,6 +5574,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  * Examples: 'title', 'author.name', 'tags[0]', 'items[2].title'
  */
 function resolvePath(obj, path) {
+    // Empty path (or `$`) means "the value itself" — used to bind to an item that IS a primitive
+    // (e.g. a Repeater over `gallery: string[]`, where each item is the URL string). See
+    // binding-panel-redesign-plan.md.
+    if (path === '' || path === '$' || path == null)
+        return obj;
     return path.split('.').reduce((current, key) => {
         if (current == null)
             return undefined;
@@ -5688,6 +5696,27 @@ class BuilderDataSourceService {
     fetchRepeaterItems(ds, sourcePath) {
         return this.fetch(ds).pipe(map(value => resolveRepeaterItems(value, sourcePath)));
     }
+    /**
+     * 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, findByAlias) {
+        const ds = findByAlias(alias);
+        if (!ds)
+            return of(null);
+        if (ds.type === 'derived') {
+            const d = ds.request?.derived;
+            if (!d?.from)
+                return of(null);
+            return this.fetchByAlias(d.from, findByAlias).pipe(map(parent => getByPath(parent, d.path ?? '')));
+        }
+        return this.fetch(ds);
+    }
+    /** Repeater items for an alias (follows derived aliases + applies an optional sourcePath). */
+    fetchRepeaterItemsByAlias(alias, findByAlias, sourcePath) {
+        return this.fetchByAlias(alias, findByAlias).pipe(map(value => resolveRepeaterItems(value, sourcePath)));
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: BuilderDataSourceService, deps: [{ token: i1.HttpClient }, { token: IOX_DATA_SOURCE_ENDPOINTS, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: BuilderDataSourceService }); }
 }
@@ -5830,9 +5859,9 @@ class BuilderRepeaterComponent {
             return;
         this.isLoading = true;
         this.cdr.markForCheck();
-        // sourcePath (when set) repeats over an array PROPERTY of a single-resource source
-        // (e.g. product.gallery); otherwise the source itself is the list. Shared decision.
-        this.dataSourceService.fetchRepeaterItems(this.dsRegistry.findByAlias(this._source), this._sourcePath).subscribe(items => {
+        // Resolve BY ALIAS so `derived` sources (e.g. galleryImages = product.gallery) follow their
+        // parent. `sourcePath` (legacy/back-compat) still repeats over an array property inline.
+        this.dataSourceService.fetchRepeaterItemsByAlias(this._source, (a) => this.dsRegistry.findByAlias(a), this._sourcePath).subscribe(items => {
             this.items = items.slice(0, this._limit);
             this.refreshPreviews();
             this.isLoading = false;
@@ -7895,17 +7924,6 @@ class RepeaterComponentConfig extends ComponentConfig {
                 options: [], // populated at runtime from DataSourceRegistryService aliases
                 default: '',
             },
-            {
-                // Repeat over an ARRAY PROPERTY inside a SINGLE resource (e.g. product → `gallery`).
-                // Empty for list/query sources (the source itself is the array). The Bindings panel
-                // populates the options from the resource schema's array fields when the source is a
-                // single resource. See repeater-nested-array-plan.md.
-                name: 'sourcePath',
-                label: 'Repeat over property',
-                type: TraitInputType.Select,
-                options: [], // populated at runtime from the single source's array schema fields
-                default: '',
-            },
             {
                 name: 'limit',
                 label: 'Limit',