@vectoriox/iox-ui 4.19.0 → 4.21.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -1913,10 +1913,38 @@ function planDataSource(ds, routeParams = {}, queryParams = {}) {
             const d = ds.request?.derived;
             return d?.from ? { kind: 'derived', from: d.from, path: d.path ?? '', mode } : { kind: 'none' };
         }
+        case 'variable':
+            // A VARIABLE is a page-local resource whose value is WRITTEN at runtime by an interaction
+            // (setContext), never fetched. It resolves to nothing here on purpose: the page renders
+            // its empty state until something writes it. `request.variable.itemsFrom` only names the
+            // source whose items it holds, so the bind picker can suggest fields.
+            return { kind: 'none' };
         default:
             return { kind: 'none' };
     }
 }
+/**
+ * The aliases on a page that are VARIABLES — runtime-written resources, not fetched data.
+ *
+ * Shared so the builder and the SSR engine agree on which aliases start empty and are filled by
+ * interactions. See element-context-state-plan.md.
+ */
+function variableAliases(dataSources) {
+    const out = new Set();
+    for (const ds of dataSources ?? []) {
+        if (ds?.type === 'variable' && ds.alias)
+            out.add(ds.alias);
+    }
+    return out;
+}
+/** The source alias whose items a variable holds, if it declares one (for field suggestions). */
+function variableItemsFrom(dataSources, alias) {
+    for (const ds of dataSources ?? []) {
+        if (ds?.type === 'variable' && ds.alias === alias)
+            return ds.request?.variable?.itemsFrom || undefined;
+    }
+    return undefined;
+}
 /**
  * Normalise a collection response into the shape a source expects: unwraps `{items}`/`{data}`
  * envelopes, then returns the first item for a `single` source or the whole array for a `list`.
@@ -3480,6 +3508,59 @@ function contextActionEffect(action, pass = 'forward') {
     return params.noReverse ? null : { op: 'clear', slot };
 }
 
+/**
+ * Which slot keys are actually IN USE on a page — derived from the layout tree itself.
+ *
+ * A slot only matters at runtime if something writes it (a `setContext`/`clearContext` action) or
+ * reads it (a binding whose `source` names it). Deriving the set from the tree means the runtime
+ * works without waiting on the page model: a DECLARED `IoxContextSlot` adds typing for the bind
+ * picker and a `default`, but is not required for the channel to function.
+ *
+ * Union of declared + in-use, so a declared-but-unused slot still seeds its default, and a slot used
+ * by a symbol dropped onto a page that never declared it still works (it just has no default).
+ */
+function collectContextSlotKeys(nodes, 
+/** Declared VARIABLES — page resources of `type: 'variable'`, or legacy slot declarations. */
+declared = []) {
+    const written = new Set();
+    const read = new Set();
+    walk(nodes, written, read);
+    // A binding only names a SLOT if something writes that key; otherwise it names a data source.
+    const keys = new Set(written);
+    for (const key of read)
+        if (written.has(key))
+            keys.add(key);
+    for (const decl of declared) {
+        // A declared variable (a data source of type 'variable') or a legacy IoxContextSlot.
+        const key = decl?.key
+            ?? (decl?.type === 'variable' ? decl.alias : undefined);
+        if (key)
+            keys.add(key);
+    }
+    return keys;
+}
+function walk(nodes, written, read) {
+    for (const raw of nodes ?? []) {
+        const node = raw;
+        if (!node)
+            continue;
+        for (const ix of node.interactions ?? []) {
+            for (const action of [...(ix?.actions ?? []), ...(ix?.reverseActions ?? [])]) {
+                const effect = contextActionEffect(action, 'forward')
+                    ?? contextActionEffect(action, 'reverse');
+                if (effect)
+                    written.add(effect.slot);
+            }
+        }
+        for (const binding of node.bindings ?? []) {
+            if (binding?.source)
+                read.add(binding.source);
+        }
+        if (Array.isArray(node.children))
+            walk(node.children, written, read);
+    }
+}
+
 /**
  * Cinematic page-transition presets — the SINGLE SOURCE OF TRUTH shared by the page builder
  * (preview) and the SSR client engine (production). Pure, transport-agnostic: this module only
@@ -3914,5 +3995,5 @@ function effectiveTransitionId(anim) {
  * Generated bundle index. Do not edit.
  */
 
-export { AOSService, AnalyticsService, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, ContextStore, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, ENVIRONMENT, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxPageComponent, IoxPageModule, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, applyBindingPipes, applyFeel, buildDataSourceFilter, buildRelatedFilter, buildTargetedStateSelector, buildTransitionTimeline, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, dataSourcePlanToRequest, declaredInputNames, effectiveTransitionId, excludeSelf, feelFor, getByPath, initialSlotValues, isContextAction, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, parseUrlList, planDataSource, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, rewriteViewportUnits, safeSetInput, stripSuppressedProps, styleKeyToKebab, withContextSlots };
+export { AOSService, AnalyticsService, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, ContextStore, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, ENVIRONMENT, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxPageComponent, IoxPageModule, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, applyBindingPipes, applyFeel, buildDataSourceFilter, buildRelatedFilter, buildTargetedStateSelector, buildTransitionTimeline, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, dataSourcePlanToRequest, declaredInputNames, effectiveTransitionId, excludeSelf, feelFor, getByPath, initialSlotValues, isContextAction, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, parseUrlList, planDataSource, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, rewriteViewportUnits, safeSetInput, stripSuppressedProps, styleKeyToKebab, variableAliases, variableItemsFrom, withContextSlots };
 //# sourceMappingURL=vectoriox-iox-ui.mjs.map