@vectoriox/iox-ui 4.14.1 → 4.15.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -2653,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
@@ -3087,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