@vectoriox/iox-builder 2.3.4 → 2.4.0

package/fesm2022/vectoriox-iox-builder.mjs

@@ -17,10 +17,10 @@ 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, getByPath, IoxPageModule } from '@vectoriox/iox-ui';
+import { ComponentInstanceRegistryService, DEFAULT_WIDTH_BY_TYPE, compileDeclarations, composeVirtualTraits, IS_PREVIEW, planDataSource, dataSourcePlanToRequest, normalizeCollectionResult, resolveRepeaterItems, getByPath, computeRelative, 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';
+import { Subject, BehaviorSubject, of, forkJoin } from 'rxjs';
 import interact from 'interactjs';
 import Moveable from 'moveable';
 import Selecto from 'selecto';
@@ -1897,6 +1897,10 @@ var DataSourceType;
     /** 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";
+    /** 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. */
+    DataSourceType["Relative"] = "relative";
 })(DataSourceType || (DataSourceType = {}));
 /**
  * Maps each action type to its logical inverse for auto-populating toggle
@@ -5747,8 +5751,14 @@ class BuilderDataSourceService {
     }
     /**
      * 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, findByAlias) {
         const ds = findByAlias(alias);
@@ -5760,6 +5770,19 @@ class BuilderDataSourceService {
                 return of(null);
             return this.fetchByAlias(d.from, findByAlias).pipe(map(parent => getByPath(parent, d.path ?? '')));
         }
+        if (ds.type === 'relative') {
+            const spec = ds.request?.relative;
+            if (!spec)
+                return of(null);
+            if (spec.kind === 'route')
+                return of({});
+            const subjectAlias = spec.kind === 'current' ? spec.from : (spec.subjectFrom ?? spec.from);
+            const needsCollection = spec.kind === 'siblings' || spec.kind === 'related';
+            return forkJoin({
+                subject: subjectAlias ? this.fetchByAlias(subjectAlias, findByAlias) : of(undefined),
+                collection: needsCollection && spec.from ? this.fetchByAlias(spec.from, findByAlias) : of(undefined),
+            }).pipe(map(({ subject, collection }) => computeRelative(spec, { subject, collection, routeParams: {} })));
+        }
         return this.fetch(ds);
     }
     /** Repeater items for an alias (follows derived aliases + applies an optional sourcePath). */