@vectoriox/iox-ui 4.14.0 → 4.15.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -2434,21 +2434,27 @@ function referencedDataSources(nodes, all) {
     const aliases = collectReferencedAliases(nodes);
     return (all ?? []).filter(ds => aliases.has(ds?.alias));
 }
-/** Like `referencedDataSources`, but also pulls in the DERIVED dependencies (transitively): a
- *  referenced `derived` alias needs its `request.derived.from` source resolved too, even though the
- *  layout never names the parent directly. Use this when RESOLVING (the engine) so derived views
- *  don't resolve to nothing. */
+/** Like `referencedDataSources`, but also pulls in a referenced source's DEPENDENCIES (transitively),
+ *  none of which the layout names directly:
+ *   - a `derived` alias needs its `request.derived.from` parent;
+ *   - a `relative` (route-context) alias needs its `request.relative.subjectFrom` (the current item)
+ *     and `request.relative.from` (the collection it navigates).
+ *  Use this when RESOLVING (the engine) so derived views and siblings/related don't resolve to nothing. */
 function referencedDataSourcesDeep(nodes, all) {
     const byAlias = new Map((all ?? []).map(d => [d?.alias, d]));
     const wanted = collectReferencedAliases(nodes);
     const queue = [...wanted];
+    const enqueue = (alias) => {
+        if (alias && !wanted.has(alias)) {
+            wanted.add(alias);
+            queue.push(alias);
+        }
+    };
     while (queue.length) {
         const ds = byAlias.get(queue.pop());
-        const from = ds?.request?.derived?.from;
-        if (from && !wanted.has(from)) {
-            wanted.add(from);
-            queue.push(from);
-        }
+        enqueue(ds?.request?.derived?.from);
+        enqueue(ds?.request?.relative?.subjectFrom);
+        enqueue(ds?.request?.relative?.from);
     }
     return (all ?? []).filter(d => wanted.has(d?.alias));
 }
@@ -2647,6 +2653,106 @@ function resolveRelativeInto(dataSources, resolved, routeParams = {}) {
     return resolved;
 }
 
+/**
+ * Binding pipes — render-time value transforms (UI label: "Filters").
+ *
+ * A binding resolves a raw value (`resolvePath(sourceData, path)`); a pipe chain then reshapes it for
+ * display (format a timestamp, upper-case, truncate, …). This is the SINGLE shared implementation used
+ * by BOTH the builder canvas and the SSR engine — the engine renders layout JSON to a STRING and can't
+ * use Angular pipes, and `resolvePath` is already duplicated across the apply points, so the transform
+ * MUST be one pure, transport-agnostic function applied identically everywhere. Never fork it.
+ *
+ * See iox-ai-guidance/architecture/builder/binding-filters-plan.md.
+ */
+// ── Date / time (Intl locale presets — locale-aware, zero-dep, browser + Node identical) ──────────
+const DATE_PRESETS = {
+    short: { dateStyle: 'short' },
+    medium: { dateStyle: 'medium' },
+    long: { dateStyle: 'long' },
+    full: { dateStyle: 'full' },
+};
+const DATETIME_PRESETS = {
+    short: { dateStyle: 'short', timeStyle: 'short' },
+    medium: { dateStyle: 'medium', timeStyle: 'short' },
+    long: { dateStyle: 'long', timeStyle: 'medium' },
+    full: { dateStyle: 'full', timeStyle: 'long' },
+};
+/** Coerce an ISO string / epoch number / Date to a valid Date, or null (→ pipes pass the value through). */
+function toDate(value) {
+    if (value instanceof Date)
+        return isNaN(value.getTime()) ? null : value;
+    if (typeof value === 'number') {
+        const d = new Date(value);
+        return isNaN(d.getTime()) ? null : d;
+    }
+    if (typeof value === 'string' && value.trim() !== '') {
+        const d = new Date(value);
+        return isNaN(d.getTime()) ? null : d;
+    }
+    return null;
+}
+function formatDate(value, args, ctx, presets) {
+    const d = toDate(value);
+    if (!d)
+        return value; // never throw — unparseable input passes through unchanged
+    const preset = args[0] || 'medium';
+    return new Intl.DateTimeFormat(ctx.locale, presets[preset] ?? presets['medium']).format(d);
+}
+/** The registry — adding a pipe here (+ a descriptor below) makes it work on both sides and appear in
+ *  the authoring UI. Keyed by name; unknown names are passed through by `applyBindingPipes`. */
+const PIPE_REGISTRY = {
+    date: (v, args, ctx) => formatDate(v, args, ctx, DATE_PRESETS),
+    datetime: (v, args, ctx) => formatDate(v, args, ctx, DATETIME_PRESETS),
+    uppercase: (v) => (v == null ? v : String(v).toUpperCase()),
+    lowercase: (v) => (v == null ? v : String(v).toLowerCase()),
+    truncate: (v, args) => {
+        if (v == null)
+            return v;
+        const s = String(v);
+        const len = Number(args[0]) || 100;
+        const suffix = args[1] != null ? String(args[1]) : '…';
+        return s.length > len ? s.slice(0, len) + suffix : s;
+    },
+    number: (v, args, ctx) => {
+        const n = typeof v === 'number' ? v : parseFloat(v);
+        if (!Number.isFinite(n))
+            return v;
+        const opts = {};
+        if (args[0] != null && args[0] !== '') {
+            opts.minimumFractionDigits = Number(args[0]);
+            opts.maximumFractionDigits = Number(args[0]);
+        }
+        return new Intl.NumberFormat(ctx.locale, opts).format(n);
+    },
+};
+/**
+ * Apply a binding's pipe chain to a resolved value, LEFT→RIGHT. Pure. An empty/undefined chain returns
+ * the value untouched; an unknown pipe name is skipped (forward-compatible with newer authored pipes).
+ * Call this at every binding-resolution point (builder canvas + engine SSR + engine hydration).
+ */
+function applyBindingPipes(value, pipes, ctx = {}) {
+    if (!pipes?.length)
+        return value;
+    return pipes.reduce((v, p) => {
+        const fn = p && PIPE_REGISTRY[p.name];
+        return fn ? fn(v, p.args ?? [], ctx) : v;
+    }, value);
+}
+const PRESET_OPTIONS = [
+    { label: 'Short', value: 'short' },
+    { label: 'Medium', value: 'medium' },
+    { label: 'Long', value: 'long' },
+    { label: 'Full', value: 'full' },
+];
+const PIPE_DESCRIPTORS = [
+    { name: 'date', label: 'Date', args: [{ key: 'preset', label: 'Format', control: 'select', options: PRESET_OPTIONS, default: 'medium' }] },
+    { name: 'datetime', label: 'Date & time', args: [{ key: 'preset', label: 'Format', control: 'select', options: PRESET_OPTIONS, default: 'medium' }] },
+    { name: 'uppercase', label: 'UPPERCASE', args: [] },
+    { name: 'lowercase', label: 'lowercase', args: [] },
+    { name: 'truncate', label: 'Truncate', args: [{ key: 'length', label: 'Max length', control: 'number', default: 100 }] },
+    { name: 'number', label: 'Number', args: [{ key: 'decimals', label: 'Decimals', control: 'number', default: null }] },
+];
+
 /**
  * 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
@@ -3081,5 +3187,5 @@ function effectiveTransitionId(anim) {
  * Generated bundle index. Do not edit.
  */
 
-export { AOSService, AnalyticsService, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CardComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, ENVIRONMENT, IOX_BUILDER_EVENTS, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxPageComponent, IoxPageModule, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, applyFeel, buildDataSourceFilter, buildRelatedFilter, buildTransitionTimeline, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, dataSourcePlanToRequest, effectiveTransitionId, excludeSelf, feelFor, getByPath, isReservedAlias, legacyEnterToTransition, matchRouteParams, normalizeCollectionResult, planDataSource, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveDerivedInto, resolvePageTransition, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, rewriteViewportUnits, stripSuppressedProps, styleKeyToKebab };
+export { AOSService, AnalyticsService, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CardComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, ENVIRONMENT, 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, buildTransitionTimeline, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, dataSourcePlanToRequest, effectiveTransitionId, excludeSelf, feelFor, getByPath, isReservedAlias, legacyEnterToTransition, matchRouteParams, normalizeCollectionResult, planDataSource, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveDerivedInto, resolvePageTransition, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, rewriteViewportUnits, stripSuppressedProps, styleKeyToKebab };
 //# sourceMappingURL=vectoriox-iox-ui.mjs.map