@vectoriox/iox-builder 3.0.0 → 3.1.0

package/package.json

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

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

@@ -83,11 +83,16 @@ declare enum DataSourceType {
     /** 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"
+    Relative = "relative",
+    /** A page-local VARIABLE: a named resource whose value is WRITTEN at runtime by an interaction
+     *  (`setContext`), never fetched. Starts empty; elements bind to it like any other alias.
+     *  `request.variable.itemsFrom` names the source whose items it holds, for field suggestions.
+     *  See element-context-state-plan.md. */
+    Variable = "variable"
 }
 interface IoxDataSource {
     id: string;
-    type: 'cms' | 'shop' | 'internal-api' | 'external-api' | 'static' | 'derived' | 'relative';
+    type: 'cms' | 'shop' | 'internal-api' | 'external-api' | 'static' | 'derived' | 'relative' | 'variable';
     mode: 'single' | 'query';
     alias: string;
     request: {
@@ -101,6 +106,11 @@ interface IoxDataSource {
         /** `relative` alias: a route-context computation (kind + from/subjectFrom/sortBy/matchFields…),
          *  resolved by the shared `computeRelative`. */
         relative?: RelativeSourceSpec;
+        /** `variable` alias: written at runtime by an interaction. `itemsFrom` names the source whose
+         *  items it holds — optional, and used only to suggest fields in the bind picker. */
+        variable?: {
+            itemsFrom?: string;
+        };
         cms?: {
             contentType: string;
             filter?: any;