@vectoriox/iox-ui 4.5.2 → 4.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "4.5.2",
+  "version": "4.7.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/types/vectoriox-iox-ui.d.ts

@@ -827,9 +827,19 @@ declare function dataSourcePlanToRequest(plan: DataSourcePlan, endpoints: DataSo
  */
 /** Perspective (px) applied to the transition container unless a preset overrides it. */
 declare const DEFAULT_PAGE_TRANSITION_PERSPECTIVE = 1200;
-/** Default transition duration (ms) when the page does not specify one. */
-declare const DEFAULT_PAGE_TRANSITION_DURATION = 600;
-type PageTransitionCategory = 'move' | 'fade' | 'scale' | 'rotate';
+/**
+ * Default transition duration (ms). Deliberately long — a slow, settled transition is most of what
+ * makes a page change read as "premium"; the same motion at ~400ms feels like a snap.
+ */
+declare const DEFAULT_PAGE_TRANSITION_DURATION = 1500;
+/**
+ * Default easing: a strong symmetric in-out. Paired with the long duration this is the "smoothness"
+ * — slow to leave, quick through the middle, gentle to settle.
+ */
+declare const DEFAULT_PAGE_TRANSITION_EASING = "cubic-bezier(0.76, 0, 0.24, 1)";
+/** Default preset used when a page has no transition configured at all. */
+declare const DEFAULT_PAGE_TRANSITION = "parallax-up";
+type PageTransitionCategory = 'parallax' | 'reveal' | 'curtain' | 'move' | 'fade' | 'scale' | 'rotate';
 interface PageTransitionPreset {
     category: PageTransitionCategory;
     label: string;
@@ -849,8 +859,36 @@ interface PageTransitionPreset {
     outDelayRatio?: number;
     /** Delay before the IN animation starts, as a fraction (0..1) of the duration. */
     inDelayRatio?: number;
+    /**
+     * Optional full-screen overlay panel (curtain / wipe). When present the transition plays as
+     * COVER → swap → UNCOVER instead of the two page layers animating against each other: the panel
+     * sweeps in to hide the screen, the outgoing page is dropped behind it, then the panel sweeps
+     * out to reveal the incoming page. Each half gets HALF the total duration.
+     *
+     * Trade-off: the swap is hidden, so you lose the "both pages visible at once" depth of the
+     * parallax family — this is drama rather than spatial continuity.
+     */
+    overlay?: {
+        coverKeyframes: Keyframe[];
+        uncoverKeyframes: Keyframe[];
+    };
 }
 declare const PAGE_TRANSITION_PRESETS: Record<string, PageTransitionPreset>;
+interface TransitionFeel {
+    value: string;
+    label: string;
+    duration: number;
+    easing: string;
+    description: string;
+}
+declare const TRANSITION_FEELS: TransitionFeel[];
+/** The feel matching this duration+easing exactly, else 'custom'. Drives the panel's selector. */
+declare function feelFor(duration: number | string | undefined, easing: string | undefined): string;
+/** The duration+easing patch for a feel id (undefined for 'custom' / unknown). */
+declare function applyFeel(feel: string): {
+    duration: number;
+    easing: string;
+} | undefined;
 interface PageTransitionCategoryMeta {
     value: PageTransitionCategory;
     label: string;
@@ -877,6 +915,13 @@ interface ResolvedPageTransition {
     perspective: number;
     outTransformOrigin?: string;
     inTransformOrigin?: string;
+    /** Present only for curtain presets — each half runs for HALF the total duration. */
+    overlay?: {
+        coverFrames: Keyframe[];
+        uncoverFrames: Keyframe[];
+        coverOptions: KeyframeAnimationOptions;
+        uncoverOptions: KeyframeAnimationOptions;
+    };
 }
 /**
  * Resolve a persisted preset id + timing into the two WAAPI animations the consumer runs.
@@ -914,5 +959,5 @@ declare function effectiveTransitionId(anim: {
     enter?: string | null;
 } | null | undefined): string;
 
-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_DURATION, 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, SectionComponent, TextBlockComponent, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, buildDataSourceFilter, buildTransitionTimeline, compileDeclarations, composeVirtualTraits, dataSourcePlanToRequest, effectiveTransitionId, legacyEnterToTransition, matchRouteParams, normalizeCollectionResult, planDataSource, renderDefaultDeclarations, resolvePageTransition, resolveSingleItemId, rewriteViewportUnits, styleKeyToKebab };
-export type { DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSpec, IBuilderEventEmitter, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionOptions, PageTransitionPreset, ResolvedPageTransition, TransitionPhase, TransitionTimelineInput };
+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, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, applyFeel, buildDataSourceFilter, buildTransitionTimeline, compileDeclarations, composeVirtualTraits, dataSourcePlanToRequest, effectiveTransitionId, feelFor, legacyEnterToTransition, matchRouteParams, normalizeCollectionResult, planDataSource, renderDefaultDeclarations, resolvePageTransition, resolveSingleItemId, rewriteViewportUnits, styleKeyToKebab };
+export type { DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSpec, IBuilderEventEmitter, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionOptions, PageTransitionPreset, ResolvedPageTransition, TransitionFeel, TransitionPhase, TransitionTimelineInput };