@vectoriox/iox-ui 5.42.0 → 5.44.0

package/generation-core/index.d.ts

@@ -36,6 +36,9 @@ declare const SPEC_SITE_PLAN_SHAPE: {
         readonly mode: "'light' | 'dark' | 'auto'";
         readonly "tint?": "string — axes.tints (DS9 neutral tint)";
         readonly "fonts?": "object — uploaded font families per role (DS5)";
+        readonly "scroll?": "string — axes.scrolls: how the site scrolls (rev 3.1; absent = axes.motionChoices.pre)";
+        readonly "animate?": "string — axes.animations: how much the sections move in as they scroll into view";
+        readonly "between?": "string — axes.betweens: what plays between pages";
     };
     readonly contentType: {
         readonly name: "string — unique";

package/index.d.ts

@@ -1,15 +1,17 @@
 import * as i0 from '@angular/core';
-import { AfterViewInit, EventEmitter, ElementRef, SimpleChanges, OnDestroy, OnInit, Renderer2, ModuleWithProviders, InjectionToken, ChangeDetectorRef, ViewContainerRef, OnChanges, Type, ComponentRef } from '@angular/core';
+import { AfterViewInit, EventEmitter, ElementRef, SimpleChanges, OnDestroy, OnInit, Renderer2, ModuleWithProviders, OnChanges, InjectionToken, ChangeDetectorRef, ViewContainerRef, Type, ComponentRef } from '@angular/core';
 import { AnimationPlayer, AnimationBuilder } from '@angular/animations';
 import { Observable } from 'rxjs';
 import * as i3 from '@angular/platform-browser/animations';
-import Lenis from 'lenis';
+import { ScrollId } from '@vectoriox/iox-ui/design-core';
+export * from '@vectoriox/iox-ui/design-core';
+import Lenis, { LenisOptions } from 'lenis';
 import * as i2 from '@angular/common';
 import { SafeHtml, DomSanitizer } from '@angular/platform-browser';
 import { VideoPlan } from '@vectoriox/iox-ui/media-core';
 import { SliderWords } from '@vectoriox/iox-ui/composite-core';
 import { OpenerNodeLike } from '@vectoriox/iox-ui/actions-core';
-export * from '@vectoriox/iox-ui/design-core';
+export * from '@vectoriox/iox-ui/data-core';
 
 declare class ViewPositionDirective implements AfterViewInit {
     private _elr;
@@ -99,11 +101,27 @@ declare class IoxAosModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<IoxAosModule>;
 }
 
+/** Where the page scrolls, and how. `lenis: null` = the browser's own scrolling (planScroll's Normal). */
+interface PageScrollStart {
+    /** The scrolling element; absent = the document (the live site scrolls the window, CC1). */
+    wrapper?: HTMLElement;
+    content?: HTMLElement;
+    lenis: LenisOptions | null;
+}
+/**
+ * The ONE page scroller (AI plan rev 3.1 §3p). `IoxPageComponent` starts it with the plan of the look's
+ * Scrolling choice (`planScroll`); `scrollTo` actions and the dialog lock go through it whether or not
+ * Lenis runs. Never on the server: there is no window to scroll.
+ */
 declare class PageScrollProvider {
     private zone;
-    private lenis?;
+    private lenis;
     private rafId?;
-    init(options?: ConstructorParameters<typeof Lenis>[0]): void;
+    private wrapper;
+    private lockedOverflow;
+    init(start: PageScrollStart): void;
+    /** Stop Lenis and its loop; the page falls back to the browser's own scrolling. */
+    destroy(): void;
     /** Hard-stop page scroll (dialog open, A1b): wheel/touch frozen until start(). */
     stop(): void;
     /** Resume after stop() — the dialog's close path, incl. native Esc/backdrop closes. */
@@ -116,17 +134,23 @@ declare class PageScrollProvider {
         duration?: number;
         immediate?: boolean;
     }): void;
-    get instance(): Lenis;
+    /** The running Lenis, or null when the page scrolls natively (Normal, reduced motion, the server). */
+    get instance(): Lenis | null;
+    private scrollElement;
+    private unlock;
     private startLoop;
     static ɵfac: i0.ɵɵFactoryDeclaration<PageScrollProvider, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PageScrollProvider>;
 }
 
-declare class IoxPageComponent implements AfterViewInit, OnDestroy {
+declare class IoxPageComponent implements AfterViewInit, OnChanges, OnDestroy {
     private pageScrollProvider;
     class: string;
+    /** The look's Scrolling choice (`designMotion.scroll`); absent = Smooth, what every page did before rev 3.1. */
+    scroll?: ScrollId | string | null;
     page: ElementRef<HTMLDivElement>;
     private scrollSubscription;
+    private started;
     scrollEvent: EventEmitter<{
         scrollTop: number;
         scrollLeft: number;
@@ -138,10 +162,12 @@ declare class IoxPageComponent implements AfterViewInit, OnDestroy {
     }>;
     constructor(pageScrollProvider: PageScrollProvider);
     ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     onScroll(event: Event): void;
     ngOnDestroy(): void;
+    private startScroller;
     static ɵfac: i0.ɵɵFactoryDeclaration<IoxPageComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IoxPageComponent, "iox-page-component", never, { "class": { "alias": "class"; "required": false; }; }, { "scrollEvent": "scrollEvent"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxPageComponent, "iox-page-component", never, { "class": { "alias": "class"; "required": false; }; "scroll": { "alias": "scroll"; "required": false; }; }, { "scrollEvent": "scrollEvent"; }, never, ["*"], false, never>;
 }
 
 declare class IoxPageModule {
@@ -2140,6 +2166,23 @@ declare function prefersReducedMotion(host?: MatchMediaHost | null | undefined):
 /** True when script may animate. The ONE question every runtime asks before moving anything. */
 declare function motionAllowed(host?: MatchMediaHost | null | undefined): boolean;
 
+/**
+ * Scrolling (AI plan rev 3.1 §3p, MO-D1/MO-D7): the look's `scroll` choice → the options the ONE page
+ * scroller starts Lenis with, or `null` for the browser's own scrolling. The table is the contract's
+ * `axes.scrolls`; this only turns its named easing into the function Lenis wants. Pure: the caller asks the
+ * visitor's reduced-motion preference (`prefersReducedMotion`) and passes the answer in.
+ */
+declare enum ScrollEasing {
+    ExpoOut = "expo-out"
+}
+/** The curves `axes.scrolls[].lenis.easing` may name. Expo-out is Lenis's own default curve. */
+declare const SCROLL_EASINGS: Readonly<Record<ScrollEasing, (t: number) => number>>;
+interface ScrollPlanContext {
+    /** The visitor asked for reduced motion: the page always scrolls natively. */
+    reducedMotion: boolean;
+}
+declare function planScroll(scroll: string | null | undefined, ctx: ScrollPlanContext): LenisOptions | null;
+
 /**
  * THE interaction keyframes (composite plan T2 · CC1 N5). Both runtimes — the builder's
  * InteractionEngineService and the live site's ClientInteractionService — animate an element action
@@ -2274,364 +2317,6 @@ declare function resetPageStyleField<T extends Partial<PageStyleSettings>>(style
  */
 declare function compilePageStyle(style: Partial<PageStyleSettings> | null | undefined, options?: PageStyleOptions): Record<string, string>;
 
-/**
- * Shared data-source resolving pattern — the SINGLE source of truth for how an IoxDataSource
- * becomes a backend fetch, consumed by BOTH the page builder (iox-cms-client bindings panel) and
- * the SSR client engine (iox-client-engine DataSourceResolverService). There must be no second
- * copy of this decision logic; only the transport differs between the two:
- *
- *   builder → authenticated org-scoped controllers (admin session):
- *              single by id → GET admin.../resources/:type/:id   (ContentService.getContentById)
- *              collection    → GET admin.../resources/:type        (ContentService.getContent)
- *   engine  → @Public() controllers (no auth, isPublished filter applied server-side):
- *              single by id → GET api/:type/:id                    (UserResourcesController)
- *              collection    → GET api/:type?filters                (UserResourcesController)
- *
- * The DECISION (by-id vs collection, which id, which filters, how to pick the single result) is
- * identical for both — that's what this module owns. Each app maps the returned {@link DataSourcePlan}
- * onto its own transport. A single item is ALWAYS fetched by its id as a path segment — never a
- * `?_id=` query — to match the builder's getContentById.
- */
-type DataSourceMode = 'single' | 'list';
-type DataSourceDomain = 'cms' | 'shop';
-interface DataSourceRouteFilter {
-    field?: string;
-    routeParam?: string;
-    defaultId?: string;
-}
-interface DataSourceQueryFilter {
-    field?: string;
-    /** URL query param the value is read from. OMIT for a CONSTANT filter — then `defaultValue`
-     *  alone is the value, so `isReviewShow=true` filters identically in preview and on the site. */
-    queryParam?: string;
-    /** Value used when the query param is absent — i.e. always, for a constant filter, and in the
-     *  builder preview, where there are no live query params. NOT preview-only: it is the runtime
-     *  fallback too. An empty default with no query-param value means the filter is DROPPED. */
-    defaultValue?: string;
-}
-/** The order a query source returns its rows in (CC2, board 4 "Sort" — the data source popover). */
-declare enum DataSourceSortDir {
-    Asc = "asc",
-    Desc = "desc"
-}
-interface DataSourceSort {
-    /** A field of the content type (a dot path into a nested object is allowed). */
-    field?: string;
-    dir?: DataSourceSortDir | `${DataSourceSortDir}`;
-}
-/** The query parameter carrying the order: `sort=order` ascending, `sort=-order` descending. A CONTROL like
- *  `limit`, not a field filter — the public controllers split it out (iox-cms `query-controls.ts`). */
-declare const SORT_PARAM = "sort";
-/** `sort`'s wire value, or null when the source sets no (valid) order. */
-declare function sortParamValue(sort: DataSourceSort | null | undefined): string | null;
-interface DataSourceRequestSpec {
-    contentType?: string;
-    limit?: number;
-    /** A query source's order (CC2). Absent = the backend's natural order, as before. */
-    sort?: DataSourceSort;
-    filterByRouteParam?: DataSourceRouteFilter;
-    filterByQueryParams?: DataSourceQueryFilter[];
-}
-/** Structural (duck-typed) view of an IoxDataSource — kept free of the editor model so both libs
- *  can depend on it without pulling in iox-builder. */
-interface DataSourceSpec {
-    alias?: string;
-    type?: string;
-    mode?: DataSourceMode;
-    request?: {
-        cms?: DataSourceRequestSpec;
-        shop?: DataSourceRequestSpec;
-        endpoint?: string;
-        data?: any;
-        /** `derived` alias: a VIEW into another variable — resolve `from` then getByPath(value, path)
-         *  (e.g. galleryImages = product.gallery). See repeater-binding-ux-plan.md. */
-        derived?: {
-            from: string;
-            path: string;
-        };
-    };
-}
-type DataSourcePlan = {
-    kind: 'by-id';
-    domain: DataSourceDomain;
-    resource: string;
-    id: string;
-    mode: DataSourceMode;
-} | {
-    kind: 'collection';
-    domain: DataSourceDomain;
-    resource: string;
-    filter: Record<string, any>;
-    limit?: number;
-    sort?: string;
-    mode: DataSourceMode;
-} | {
-    kind: 'external';
-    endpoint: string;
-    mode: DataSourceMode;
-} | {
-    kind: 'static';
-    data: any;
-    mode: DataSourceMode;
-} | {
-    kind: 'derived';
-    from: string;
-    path: string;
-    mode: DataSourceMode;
-} | {
-    kind: 'none';
-};
-/**
- * Match a page route template against an actual path and extract named params.
- *   matchRouteParams('/project/:projectId', 'project/68abc') → { projectId: '68abc' }
- * Both sides are normalised (leading slash stripped) and split on '/'; values are URL-decoded.
- */
-declare function matchRouteParams(template: string | undefined, actual: string | undefined): Record<string, string>;
-/**
- * Build the query filter for a data-source request from its filterByRouteParam / filterByQueryParams
- * config. `field` is filtered by the route-param value (falling back to `defaultId`); query filters
- * map each `field` to a query-param value (falling back to `defaultValue`), and a filter with NO
- * `queryParam` is a constant on `defaultValue`. Empty values are omitted so the source isn't
- * accidentally filtered to nothing.
- */
-declare function buildDataSourceFilter(req: DataSourceRequestSpec | undefined, routeParams?: Record<string, any>, queryParams?: Record<string, any>): Record<string, any>;
-/**
- * Mirrors the builder's getContentById decision. When a SINGLE source is filtered by the item id
- * (`_id`) via a route param, the item is fetched by PATH (`.../:type/:id`), not a `?_id=` query.
- * Returns that id (route-param value, else `defaultId`), or `null` when the source isn't a
- * single-by-id fetch — in which case the caller uses the collection endpoint + filters. The
- * path-based form only applies to the id field; a single source filtered by any other field still
- * goes through the collection endpoint.
- */
-declare function resolveSingleItemId(req: DataSourceRequestSpec | undefined, routeParams?: Record<string, any>): string | null;
-/**
- * Resolve an IoxDataSource into a transport-agnostic {@link DataSourcePlan}. This is the shared
- * decision both the builder and the SSR engine run; each then executes the plan with its own
- * HTTP layer. Single sources with a route-param id resolve to a `by-id` (path) fetch — exactly like
- * the builder's getContentById.
- */
-declare function planDataSource(ds: DataSourceSpec | undefined, routeParams?: Record<string, any>, queryParams?: Record<string, any>): DataSourcePlan;
-/**
- * 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.
- */
-declare function variableAliases(dataSources: readonly {
-    alias?: string;
-    type?: string;
-}[] | undefined): Set<string>;
-/** The source alias whose items a variable holds, if it declares one (for field suggestions). */
-declare function variableItemsFrom(dataSources: readonly {
-    alias?: string;
-    type?: string;
-    request?: any;
-}[] | undefined, alias: string): string | 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`.
- * A `by-id` response is already the item, so callers pass it through unchanged.
- */
-declare function normalizeCollectionResult(mode: DataSourceMode, data: any): any;
-/** Navigate a dot/bracket path into an object, e.g. `gallery`, `details.images`, `variants[0].skus`.
- *  Returns undefined if any segment is missing. Kept minimal + self-contained so it is shareable by
- *  both the builder and the SSR engine (the two have divergent local `resolvePath` copies). */
-declare function getByPath(obj: any, path: string): any;
-/**
- * The array a Repeater (or a repeating Slider) iterates over — the SHARED decision so the builder
- * canvas and the SSR engine agree (see data-source-resolving.md).
- * - No `sourcePath`: the resolved source IS the list. An array passes through; a lone object degrades
- *   to a single-row list (back-compat with the old `fetchItems`); null/undefined → `[]`.
- * - With `sourcePath`: the source resolved to a SINGLE resource (e.g. a product); dive into the
- *   nested array property (e.g. `gallery`). Non-array / missing → `[]`.
- */
-/**
- * Fill in `derived` aliases in an already-resolved map. Given the data sources and a map of resolved
- * NON-derived values (by alias), compute each `type:'derived'` alias as `getByPath(parent, path)` in
- * dependency order (chains resolved by iterating until stable). Mutates + returns the map. Used by the
- * SSR engine after it resolves the root sources; the builder resolves derived lazily per alias.
- */
-declare function resolveDerivedInto(dataSources: DataSourceSpec[], resolved: Record<string, any>): Record<string, any>;
-declare function resolveRepeaterItems(resolved: any, sourcePath?: string | null): any[];
-/** Aliases referenced anywhere in a node tree: a repeater/slider `source` (a `bindings` entry with
- *  `prop === 'source'`, or `props.source` for the slider) plus every binding's `source`. */
-declare function collectReferencedAliases(nodes: any[], acc?: Set<string>): Set<string>;
-/** The subset of `all` whose `alias` is referenced by `nodes` (shallow — direct references only). */
-declare function referencedDataSources(nodes: any[], all: any[]): any[];
-/** 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. */
-declare function referencedDataSourcesDeep(nodes: any[], all: any[]): any[];
-/** Base URLs for the PUBLIC content controllers. Both must end with `/`. The builder and the SSR
- *  engine pass their own host (they proxy `/api` differently) but MUST target the public
- *  (`@Public()`) controllers, never the authed admin ones — data resolving is storefront data. */
-interface DataSourceEndpoints {
-    /** cms resources, e.g. `${HOST}` (engine, HOST ends `/api/`) or `${HOST}api/` (builder). */
-    cmsBase: string;
-    /** shop resources, e.g. `${HOST}shop/` (engine) or `${HOST}api/shop/` (builder). */
-    shopBase: string;
-}
-interface DataSourceRequest {
-    url: string;
-    params: Record<string, any>;
-}
-/**
- * Turn a resolved {@link DataSourcePlan} into the concrete public HTTP request (url + params) — the
- * SINGLE place that decides the URL shape, shared by the builder binding preview and the SSR engine
- * so both hit the SAME public endpoints (no admin, no duplication). Returns `null` for `static` /
- * `none` plans (no HTTP call). A single item is a PATH segment (`/:resource/:id`), never `?_id=`.
- */
-declare function dataSourcePlanToRequest(plan: DataSourcePlan, endpoints: DataSourceEndpoints): DataSourceRequest | null;
-
-/**
- * Shared RELATIVE (route-context) data resolving — the SINGLE source of truth for how a detail page
- * derives values FROM its current route item, consumed by BOTH the page builder (iox-cms-client) and
- * the SSR client engine (iox-client-engine). Companion to `data-source-resolver.ts`.
- *
- * These are the pure, transport-agnostic pieces behind the Route binding scope
- * (`$route` / `$current` / `$siblings` / `$related`). Resolution is a DEPENDENT SECOND PASS: the
- * consumer resolves `$current` first (the existing single by-id fetch via `planDataSource`), then
- * calls these to derive the relative values — there is NO new `DataSourcePlan` kind (`$related` still
- * feeds a normal `collection` plan built from {@link buildRelatedFilter}). See
- * `architecture/builder/relative-data-sources-plan.md`.
- *
- * There must be no second copy of this decision logic; only the transport (which HTTP layer fetches
- * the ordered collection / related list) differs between the two consumers.
- */
-/** Aliases in the Route scope are platform-owned and start with this prefix; a USER alias may never
- *  start with it, which keeps the Route scope structurally collision-proof with Local/Global. Used to
- *  validate new/renamed aliases and to render the reserved (read-only) item state in the bind picker. */
-declare const RESERVED_ALIAS_PREFIX = "$";
-/** True for a platform-owned Route-scope alias (`$route`, `$current`, `$siblings`, `$related`, …). */
-declare function isReservedAlias(alias: string | null | undefined): boolean;
-/** The `$siblings` value: the current item's neighbours within an ordered set. */
-interface SiblingsResult<T = any> {
-    /** The item before the current one (`null` at the start, unless `wrap`). */
-    prev: T | null;
-    /** The item after the current one (`null` at the end, unless `wrap`). */
-    next: T | null;
-    /** Zero-based position of the current item in the ordered set; `-1` when not found. */
-    index: number;
-    /** Total items in the set. */
-    count: number;
-    /** `true` when the current item is the first in the set. */
-    isFirst: boolean;
-    /** `true` when the current item is the last in the set. */
-    isLast: boolean;
-}
-interface ResolveSiblingsOptions {
-    /** Field identifying the current item within the list. Default `_id`. */
-    idField?: string;
-    /** Dot/bracket path to sort by BEFORE locating neighbours (e.g. `order`, `date`). Omit to use the
-     *  list's existing order. The same item neighbours differently per ordering, so this is the one
-     *  choice `$siblings` requires. */
-    sortBy?: string;
-    /** Sort direction when `sortBy` is set. Default `asc`. */
-    sortDir?: 'asc' | 'desc';
-    /** Wrap around the ends (`last.next` → first, `first.prev` → last). Only applies when `count > 1`.
-     *  Default `false`. */
-    wrap?: boolean;
-}
-/**
- * Locate the current item within an ordered set and return its neighbours + position. Pure: the input
- * list is never mutated (sorting works on a shallow copy). `currentId` is compared to each item's
- * `idField` via string equality (route-param values are strings). When the current id isn't found,
- * `index` is `-1` and `prev`/`next` are `null` (but `count` still reflects the set size).
- */
-declare function resolveSiblings<T = any>(items: T[] | null | undefined, currentId: string | number | null | undefined, options?: ResolveSiblingsOptions): SiblingsResult<T>;
-interface BuildRelatedFilterOptions {
-    /** Field(s) on the current item whose value(s) the related items must match (e.g. `category`,
-     *  or `['category', 'brand']`). Each contributes an equality filter on that field. */
-    matchFields: string | string[];
-}
-/**
- * Build the collection filter for `$related` from the resolved current item: an equality match on
- * each `matchField`'s value (e.g. same `category`). Feeds a normal `collection` plan — no new plan
- * kind. Fields whose value is not a scalar (or is empty) are omitted, matching
- * `buildDataSourceFilter`'s "don't over-filter" rule. Exclude-self is applied to the RESULT via
- * {@link excludeSelf} (the public query controllers are equality-only, so it can't be a `$ne` param).
- */
-declare function buildRelatedFilter(current: any, options: BuildRelatedFilterOptions): Record<string, any>;
-/**
- * Drop the current item from a list by `idField` (default `_id`). Used to exclude self from a
- * `$related` result after fetch. A nullish/empty `currentId` leaves the list unchanged.
- */
-declare function excludeSelf<T = any>(items: T[] | null | undefined, currentId: string | number | null | undefined, idField?: string): T[];
-/** The resolved Route-scope context bound values read from (`$route.projectId`, `$current.title`,
- *  `$siblings.next`, `$related`). Assembled by each consumer during its dependent second pass. */
-interface RouteContext {
-    /** Route path params for the current URL (from `matchRouteParams`). */
-    $route: Record<string, string>;
-    /** The resolved current item (the page's single by-id source). */
-    $current: any;
-    /** Neighbours of the current item within a chosen ordered set. */
-    $siblings?: SiblingsResult;
-    /** Items related to the current one (same-attribute), excluding self. */
-    $related?: any[];
-}
-type RelativeSourceKind = 'route' | 'current' | 'siblings' | 'related';
-interface RelativeSourceSpec {
-    kind: RelativeSourceKind;
-    /** The source alias this derives from: for `current` the subject single-source; for
-     *  `siblings`/`related` the COLLECTION alias to locate within / search. Unused for `route`. */
-    from?: string;
-    /** `siblings`/`related`: the SUBJECT source alias (the current item) whose id / field values drive
-     *  the computation. Defaults to `from` when omitted. May reference `$current`. */
-    subjectFrom?: string;
-    /** Field identifying an item. Default `_id`. */
-    idField?: string;
-    /** `siblings`: sort the set before locating neighbours. */
-    sortBy?: string;
-    sortDir?: 'asc' | 'desc';
-    wrap?: boolean;
-    /** `siblings`: resolve to a SINGLE neighbour ITEM (`next`/`prev`) instead of the whole
-     *  `{prev,next,index,count,…}` object — so a source can be named e.g. `nextProject` and bound
-     *  directly (`nextProject.route`). Omit for the whole-object shape. */
-    pick?: 'next' | 'prev';
-    /** `related`: field(s) on the subject the results must match. */
-    matchFields?: string | string[];
-    /** `related`: drop the subject from its own results. Default `true`. */
-    excludeSelf?: boolean;
-}
-/** Duck-typed view of a data source carrying an optional relative descriptor (avoids a hard dep on
- *  the full editor model / a circular type import). */
-interface RelativeCapableSource {
-    alias?: string;
-    type?: string;
-    request?: {
-        relative?: RelativeSourceSpec;
-    };
-}
-/** The already-resolved inputs a single relative source computes from. Assembled by each consumer:
- *  the batch pass reads them from the resolved map; the builder resolves them async per alias. */
-interface RelativeInputs {
-    /** The subject item (the current resource) — for `current`/`siblings`/`related`. */
-    subject?: any;
-    /** The collection to locate within / search — for `siblings`/`related`. */
-    collection?: any;
-    /** Route path params — for `route`. */
-    routeParams?: Record<string, any>;
-}
-/**
- * Compute ONE relative source's value from its already-resolved {@link RelativeInputs} — the SHARED
- * kind→computation decision, so the batch pass ({@link resolveRelativeInto}) and the builder's async
- * per-alias resolver produce identical results with no forked switch. `route` → the route params;
- * `current` → the subject; `siblings` → {@link resolveSiblings} over the collection; `related` → the
- * collection filtered by {@link buildRelatedFilter}'s predicate (+ {@link excludeSelf}).
- */
-declare function computeRelative(spec: RelativeSourceSpec, inputs: RelativeInputs): any;
-/**
- * Compute every `type:'relative'` source into `resolved` (keyed by alias), IN PLACE. Pure w.r.t. HTTP
- * — it only reads already-resolved roots + the route params, so both consumers run it identically as
- * a second pass. Delegates each source to {@link computeRelative}. `current`'s subject is `from`;
- * `siblings`/`related` take `collection` = `from` and `subject` = `subjectFrom ?? from`. Mutates and
- * returns `resolved`.
- */
-declare function resolveRelativeInto(dataSources: RelativeCapableSource[], resolved: Record<string, any>, routeParams?: Record<string, any>): Record<string, any>;
-
 /**
  * Binding pipes — render-time value transforms (UI label: "Filters").
  *
@@ -3156,19 +2841,6 @@ declare function isActionEnabled(action: ToggleableAction | null | undefined): b
 /** The actions that should actually run, preserving order. */
 declare function activeActions<T extends ToggleableAction>(actions: readonly T[] | undefined): T[];
 
-/**
- * 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
- * describes WAAPI keyframe pairs + timing/ordering. It never touches the DOM.
- *
- * A page transition plays TWO synchronized WAAPI animations at once — an `out` animation on a
- * snapshot of the outgoing page and an `in` animation on the incoming page — inside a shared
- * `perspective` container, gated on BOTH finishing (the "cinematic" feel, à la Codrops
- * PageTransitions). The consumer supplies the DOM (snapshot layer + live page) and calls
- * `element.animate(frames, options)`; it does NOT redefine the frames.
- *
- * @see architecture/builder/page-transitions.md
- */
 /** Perspective (px) applied to the transition container unless a preset overrides it. */
 declare const DEFAULT_PAGE_TRANSITION_PERSPECTIVE = 1200;
 /**
@@ -3302,6 +2974,65 @@ declare function effectiveTransitionId(anim: {
     transition?: string | null;
     enter?: string | null;
 } | null | undefined): string;
+/** The settings a page's own `routeAnimation` carries (Page ▸ Design ▸ Route animation). */
+interface RouteAnimationLike {
+    transition?: string | null;
+    enter?: string | null;
+    duration?: number | string;
+    easing?: string;
+    perspective?: number | string;
+    curtainColor?: string;
+}
+interface PageTransitionContext {
+    /** `pageSettings.designSystem` — only a design-system page follows the look. */
+    designSystem?: boolean;
+    /** The look's Between pages choice (`designMotion.between`); absent = `PRE_MOTION.between`. */
+    between?: string | null;
+    /** The viewport is a phone (`PHONE_TRANSITION_QUERY`): Slide and Cinematic play their `phone` choice. */
+    phone?: boolean;
+    /** The page reads right to left: a Slide pushes from the other side. */
+    rtl?: boolean;
+    /** The page's initial (hydrated) load — no outgoing page. */
+    initial?: boolean;
+}
+/** What `resolvePageTransition` is asked for. `transition: 'none'` is a valid, silent choice. */
+interface PlannedPageTransition {
+    transition: string;
+    duration?: number | string;
+    easing?: string;
+    perspective?: number | string;
+    curtainColor?: string;
+    /** The page follows the look (rather than its own Route animation). */
+    fromLook: boolean;
+}
+declare const NO_PAGE_TRANSITION = "none";
+/** The widest viewport a page change treats as a phone (MO-D5): the Mobile landscape breakpoint. */
+declare const PHONE_TRANSITION_QUERY: string;
+/** What a window can tell `pageTransitionOf`: the media query and the computed direction. */
+interface TransitionViewport {
+    matchMedia?: (query: string) => {
+        matches: boolean;
+    };
+    getComputedStyle?: (el: Element) => {
+        direction?: string;
+    };
+}
+/**
+ * The part of the context only the browser knows — is this a phone, does the page read right to left —
+ * read the same way by every runtime that plays a page change (the engine, Preview). No window → neither.
+ */
+declare function viewportTransitionContext(view: TransitionViewport | null | undefined, el: Element | null | undefined): Pick<PageTransitionContext, 'phone' | 'rtl'>;
+/** The page set its own transition (a preset id, or a legacy `enter` that migrates to one). */
+declare function hasOwnPageTransition(anim: RouteAnimationLike | null | undefined): boolean;
+/**
+ * The ONE decision of what plays when a page arrives, for the engine and every builder preview:
+ *  • a page with its own Route animation plays it, exactly as before (an unflagged page too: with none set
+ *    it keeps the platform default, `effectiveTransitionId`);
+ *  • a design-system page with none follows the look's Between pages — never on its initial load (MO-D6:
+ *    no IN half, no server pre-state), as Fade on a phone for Slide and Cinematic (MO-D5), mirrored in RTL.
+ * Reduced motion is the runtime's own question (`motionAllowed`), asked before anything plays.
+ */
+declare function pageTransitionOf(anim: RouteAnimationLike | null | undefined, ctx?: PageTransitionContext): PlannedPageTransition;
 
 /**
  * Gallery effect registry — the SHARED, effect-agnostic description of how each gallery slide looks
@@ -3425,5 +3156,5 @@ declare class GalleryLoop {
     private emit;
 }
 
-export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DataSourceSortDir, DeclarationContext, ENTRANCE_ACTION_TYPES, EXIT_ACTION_TYPES, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HOVER_DEFAULT_TRANSITION, HOVER_STATES, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, IoxVideoComponent, LAST_EMITTED_STATES, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION, LEGACY_SWIPER_CONTROLS, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, NAMED_GROUP_ROLES, ON_STATE_ROLES, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PART_PAGINATION_MODIFIER, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PageStyleField, PageStyleSource, REDUCED_MOTION_QUERY, RESERVED_ALIAS_PREFIX, SLIDER_INPUTS_ATTRIBUTE, SLIDER_INPUT_NAMES, SORT_PARAM, STATE_PSEUDO_CLASS, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SWIPER_TRIGGER_EVENTS, SectionComponent, SwiperModuleName, TARGETED_STATE_SUFFIX, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TRANSITION_FEELS, TextAlign, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, applyBindingPipes, applyFeel, bootSlider, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildInteractionKeyframes, buildPartSelector, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTargetedSuffixSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, closeAboveMediaQuery, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, computeRelative, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, decomposeBackdropFilter, defaultHoverTransition, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, domHasSliderParts, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, excludeSelf, feelFor, finalKeyframe, getByPath, getSeoValue, hasHoverState, hasOwnTransition, initialSlotValues, isActionEnabled, isContextAction, isCurrentLink, isExternalOrFragment, isGradientPaint, isInputOverriddenAt, isLastEmittedStateKey, isOverriddenAt, isReservedAlias, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, needsGroupName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeCollectionResult, normalizeGalleryImage, normalizeIconClass, orderStatesForEmit, parentBreakpoint, parseUrlList, partClassName, planDataSource, planResponsiveRules, planSwiperOptions, prefersReducedMotion, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSeo, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, sliderControlElements, sliderInputsFromProps, sliderInputsOf, sortParamValue, stateNamesIn, statePseudoClass, stateSelectorSuffix, stripSuppressedProps, swiperAutoplayAllowed, swiperLoopOptions, swiperModuleNames, syncNodeA11yAttributes, targetedStateSelector, variableAliases, variableItemsFrom, withContextSlots, withDefaultHoverTransition, wrapInBreakpointQuery, wrapInMediaQuery };
-export type { A11yNodeSource, BoundValueSpec, BreakpointDef, BuildRelatedFilterOptions, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSort, DataSourceSpec, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, RelativeInputs, RelativeSourceKind, RelativeSourceSpec, ResolveSiblingsOptions, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteContext, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SiblingsResult, SliderBootOptions, SliderControlElements, SliderInputs, StateStyleMap, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, SwiperPlan, SwiperPlanContext, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, ValueSource, VirtualTraitGroup };
+export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DeclarationContext, ENTRANCE_ACTION_TYPES, EXIT_ACTION_TYPES, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HOVER_DEFAULT_TRANSITION, HOVER_STATES, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, IoxVideoComponent, LAST_EMITTED_STATES, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION, LEGACY_SWIPER_CONTROLS, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, NAMED_GROUP_ROLES, NO_PAGE_TRANSITION, ON_STATE_ROLES, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PART_PAGINATION_MODIFIER, PHONE_TRANSITION_QUERY, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PageStyleField, PageStyleSource, REDUCED_MOTION_QUERY, SCROLL_EASINGS, SLIDER_INPUTS_ATTRIBUTE, SLIDER_INPUT_NAMES, STATE_PSEUDO_CLASS, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SWIPER_TRIGGER_EVENTS, ScrollEasing, SectionComponent, SwiperModuleName, TARGETED_STATE_SUFFIX, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TRANSITION_FEELS, TextAlign, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, applyBindingPipes, applyFeel, bootSlider, breakpointDef, breakpointForWidth, breakpointQueryFor, buildInteractionKeyframes, buildPartSelector, buildSwiperBreakpoints, buildTargetedStateSelector, buildTargetedSuffixSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, closeAboveMediaQuery, collectContextSlotKeys, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, declaredInputNames, decomposeBackdropFilter, defaultHoverTransition, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, domHasSliderParts, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, feelFor, finalKeyframe, getSeoValue, hasHoverState, hasOwnPageTransition, hasOwnTransition, initialSlotValues, isActionEnabled, isContextAction, isCurrentLink, isExternalOrFragment, isGradientPaint, isInputOverriddenAt, isLastEmittedStateKey, isOverriddenAt, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, legacyEnterToTransition, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, needsGroupName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeGalleryImage, normalizeIconClass, orderStatesForEmit, pageTransitionOf, parentBreakpoint, parseUrlList, partClassName, planResponsiveRules, planScroll, planSwiperOptions, prefersReducedMotion, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveSeo, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, sliderControlElements, sliderInputsFromProps, sliderInputsOf, stateNamesIn, statePseudoClass, stateSelectorSuffix, stripSuppressedProps, swiperAutoplayAllowed, swiperLoopOptions, swiperModuleNames, syncNodeA11yAttributes, targetedStateSelector, viewportTransitionContext, withContextSlots, withDefaultHoverTransition, wrapInBreakpointQuery, wrapInMediaQuery };
+export type { A11yNodeSource, BoundValueSpec, BreakpointDef, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageScrollStart, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionContext, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, PlannedPageTransition, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteAnimationLike, ScrollPlanContext, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SliderBootOptions, SliderControlElements, SliderInputs, StateStyleMap, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, SwiperPlan, SwiperPlanContext, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, TransitionViewport, ValueSource, VirtualTraitGroup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.42.0",
+  "version": "5.44.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",
@@ -31,6 +31,10 @@
       "types": "./consent-core/index.d.ts",
       "default": "./fesm2022/vectoriox-iox-ui-consent-core.mjs"
     },
+    "./data-core": {
+      "types": "./data-core/index.d.ts",
+      "default": "./fesm2022/vectoriox-iox-ui-data-core.mjs"
+    },
     "./design-core": {
       "types": "./design-core/index.d.ts",
       "default": "./fesm2022/vectoriox-iox-ui-design-core.mjs"