@vectoriox/iox-ui 4.6.0 → 4.7.0

package/package.json

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

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

@@ -839,7 +839,7 @@ declare const DEFAULT_PAGE_TRANSITION_DURATION = 1500;
 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' | 'move' | 'fade' | 'scale' | 'rotate';
+type PageTransitionCategory = 'parallax' | 'reveal' | 'curtain' | 'move' | 'fade' | 'scale' | 'rotate';
 interface PageTransitionPreset {
     category: PageTransitionCategory;
     label: string;
@@ -859,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;
@@ -887,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.
@@ -924,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, 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, 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 };