@vectoriox/iox-ui 4.17.3 → 4.19.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { EventEmitter, HostListener, Output, Input, Directive, NgModule, Injectable, ViewChild, Component, Host, Optional, inject, NgZone, Inject, InjectionToken, PLATFORM_ID, ChangeDetectionStrategy, ViewContainerRef, reflectComponentType } from '@angular/core';
+import { EventEmitter, HostListener, Output, Input, Directive, NgModule, Injectable, ViewChild, Component, Host, Optional, inject, NgZone, Inject, InjectionToken, PLATFORM_ID, ChangeDetectionStrategy, ViewContainerRef, reflectComponentType, signal, computed } from '@angular/core';
 import * as i2 from '@angular/animations';
 import { style, animate } from '@angular/animations';
 import { Subject, fromEvent, of } from 'rxjs';
@@ -3260,6 +3260,226 @@ function safeSetInput(ref, name, value) {
     return false;
 }
 
+/**
+ * THE binding path resolver — one implementation, shared by every renderer.
+ *
+ * Resolves a dot-notation path with optional array brackets against a data object:
+ * `title`, `author.name`, `tags[0]`, `items[2].title`.
+ *
+ * This lived in three places before (iox-builder's binding-path.util, the engine's string
+ * renderer, and the engine's component renderer) and had already drifted: the component-renderer
+ * copy was missing the `$` case below, so a repeater over a primitive array rendered in the SSR
+ * HTML and then blanked on hydration. See render-parity.md.
+ */
+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;
+        const bracketMatch = key.match(/^(\w+)\[(\d+)]$/);
+        if (bracketMatch) {
+            const arr = current[bracketMatch[1]];
+            return Array.isArray(arr) ? arr[parseInt(bracketMatch[2], 10)] : undefined;
+        }
+        return current[key];
+    }, obj);
+}
+
+/**
+ * Element context state — shared types.
+ *
+ * A **context slot** is a data-source alias whose value is WRITTEN at runtime (by an interaction)
+ * instead of fetched. That is the whole trick: bindings need no new grammar, because a slot is just
+ * another key in the `resolvedData` map both renderers already resolve against.
+ *
+ * See architecture/builder/element-context-state-plan.md.
+ */
+
+/**
+ * Turn a `setContext` value spec into the value to store.
+ *
+ * Returns `undefined` when the spec cannot be satisfied (e.g. `$item` on an element that is not in
+ * a loop), which the store treats as "don't write" rather than "write empty".
+ */
+function resolveContextValue(spec, scope = {}) {
+    if (!spec)
+        return undefined;
+    switch (spec.kind) {
+        case 'item':
+            return scope.item;
+        case 'literal':
+            return spec.value;
+        case 'source': {
+            const data = scope.resolvedData?.[spec.source];
+            if (data == null)
+                return undefined;
+            return spec.path ? resolvePath(data, spec.path) : data;
+        }
+        default:
+            return undefined;
+    }
+}
+/**
+ * The value each slot holds before any interaction.
+ *
+ * `'first'` pre-fills from the resolved source so the page is never empty; `'none'` (the default)
+ * leaves the key ABSENT — not set to undefined — so `resolvedData` looks exactly as it does for a
+ * source that returned nothing, and bindings simply don't resolve.
+ */
+function initialSlotValues(slots, resolvedData = {}) {
+    const out = {};
+    for (const slot of slots ?? []) {
+        if (slot?.default !== 'first')
+            continue;
+        const items = resolvedData[slot.source];
+        if (Array.isArray(items) && items.length)
+            out[slot.key] = items[0];
+    }
+    return out;
+}
+/**
+ * Merge live slot values over the page's resolved data, producing the map bindings resolve against.
+ *
+ * Slot keys share the data-source namespace, so a slot deliberately shadows a source of the same
+ * name — the same way a repeater row shadows its own source alias with the single item.
+ */
+function withContextSlots(resolvedData, slotValues) {
+    return { ...(resolvedData ?? {}), ...(slotValues ?? {}) };
+}
+/** The set of declared slot keys — what marks a binding as "live". */
+function contextSlotKeys(slots) {
+    return new Set((slots ?? []).map(s => s?.key).filter((k) => !!k));
+}
+/**
+ * Does this node read a context slot? Nodes that do must be REGISTERED at render time and
+ * re-applied when the store changes — they are the only ones whose props are not final after the
+ * first render.
+ */
+function nodeUsesContext(node, slotKeys) {
+    if (!slotKeys.size)
+        return false;
+    const bindings = node?.bindings;
+    if (!Array.isArray(bindings))
+        return false;
+    return bindings.some(b => !!b?.source && slotKeys.has(b.source));
+}
+/**
+ * Is a slot key a legal user alias?
+ *
+ * Slots live in the page's data-source alias namespace, so uniqueness is the existing rule. The one
+ * extra constraint is the reserved `$` prefix (system aliases — `$route`, `$current`, …).
+ */
+function isValidSlotKey(key) {
+    if (!key)
+        return false;
+    const trimmed = key.trim();
+    if (!trimmed || trimmed.startsWith('$'))
+        return false;
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(trimmed);
+}
+
+/**
+ * The runtime context channel: named slots an interaction writes and bindings read.
+ *
+ * Signal-backed because writes are HOT — a hover fires on every row crossing. A write must cost a
+ * signal set and re-apply one input on the registered nodes; it must never re-clone a repeater or
+ * re-render the loop. See element-context-state-plan.md (trap T2).
+ *
+ * Provided in root and reset by the consumer on page navigation — slots are page-level state.
+ */
+class ContextStore {
+    constructor() {
+        this._values = signal({}, ...(ngDevMode ? [{ debugName: "_values" }] : /* istanbul ignore next */ []));
+        /** All live slot values. Merge over `resolvedData` with `withContextSlots` to resolve bindings. */
+        this.values = this._values.asReadonly();
+        /** The keys currently holding a value — what the "is this slot populated?" CSS state keys off. */
+        this.populatedKeys = computed(() => new Set(Object.keys(this._values())), ...(ngDevMode ? [{ debugName: "populatedKeys" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * Write a slot. An `undefined` value is IGNORED rather than stored: a spec that could not be
+     * satisfied (e.g. `$item` outside a loop) must not silently blank a populated slot.
+     */
+    set(key, value) {
+        if (!key || value === undefined)
+            return;
+        const current = this._values();
+        if (Object.is(current[key], value))
+            return; // no-op writes must not wake subscribers
+        this._values.set({ ...current, [key]: value });
+    }
+    /** Remove a slot's value entirely, so the key is ABSENT (not undefined) for binding resolution. */
+    clear(key) {
+        if (!key)
+            return;
+        const current = this._values();
+        if (!(key in current))
+            return;
+        const next = { ...current };
+        delete next[key];
+        this._values.set(next);
+    }
+    /** Drop every slot — call on page navigation; context is page-level state. */
+    resetAll() {
+        if (!Object.keys(this._values()).length)
+            return;
+        this._values.set({});
+    }
+    /** Seed the initial values (from `initialSlotValues`) without clobbering later writes. */
+    seed(values) {
+        const incoming = Object.entries(values ?? {}).filter(([, v]) => v !== undefined);
+        if (!incoming.length)
+            return;
+        this._values.set({ ...Object.fromEntries(incoming), ...this._values() });
+    }
+    /** Non-reactive read — for imperative code that must not create a dependency. */
+    peek(key) {
+        return this._values()[key];
+    }
+    /** Whether a slot currently holds a value. */
+    has(key) {
+        return key in this._values();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: ContextStore, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: ContextStore, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: ContextStore, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/** Action types this module handles. Anything else is not a context action. */
+const CONTEXT_ACTION_TYPES = ['setContext', 'clearContext'];
+function isContextAction(action) {
+    return !!action?.type && CONTEXT_ACTION_TYPES.includes(action.type);
+}
+/**
+ * Resolve an action + pass into the store operation to perform, or `null` for "do nothing".
+ *
+ * Returning `null` (rather than throwing or guessing) is what lets a runtime call this for every
+ * action on every pass and simply skip the misses.
+ */
+function contextActionEffect(action, pass = 'forward') {
+    if (!isContextAction(action))
+        return null;
+    const params = (action.params ?? {});
+    const slot = typeof params.slot === 'string' ? params.slot.trim() : '';
+    if (!slot)
+        return null;
+    if (action.type === 'clearContext') {
+        // A clear has no meaningful reverse — leaving the element must not re-populate the slot.
+        return pass === 'forward' ? { op: 'clear', slot } : null;
+    }
+    // setContext
+    if (pass === 'forward') {
+        return params.value ? { op: 'set', slot, value: params.value } : null;
+    }
+    return params.noReverse ? null : { op: 'clear', slot };
+}
+
 /**
  * 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
@@ -3694,5 +3914,5 @@ function effectiveTransitionId(anim) {
  * Generated bundle index. Do not edit.
  */
 
-export { AOSService, AnalyticsService, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, 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, dataSourcePlanToRequest, declaredInputNames, effectiveTransitionId, excludeSelf, feelFor, getByPath, isReservedAlias, legacyEnterToTransition, matchRouteParams, nearestCommonAncestorId, nodeCssId, normalizeCollectionResult, parseUrlList, planDataSource, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolvePageTransition, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, rewriteViewportUnits, safeSetInput, stripSuppressedProps, styleKeyToKebab };
+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 };
 //# sourceMappingURL=vectoriox-iox-ui.mjs.map