framer-motion 7.2.0 → 7.3.1

package/dist/index.d.ts

@@ -683,9 +683,12 @@ interface LayoutProps {
      * If `layout` is set to `"size"`, the position of the component will change instantly and
      * only its size will animate.
      *
+     * If `layout` is set to `"preserve-aspect"`, the component will animate size & position if
+     * the aspect ratio remains the same between renders, and just position if the ratio changes.
+     *
      * @public
      */
-    layout?: boolean | "position" | "size";
+    layout?: boolean | "position" | "size" | "preserve-aspect";
     /**
      * Enable shared layout transitions between different components with the same `layoutId`.
      *
@@ -2489,7 +2492,7 @@ interface ProjectionNodeOptions {
     alwaysMeasureLayout?: boolean;
     scheduleRender?: VoidFunction;
     onExitComplete?: VoidFunction;
-    animationType?: "size" | "position" | "both";
+    animationType?: "size" | "position" | "both" | "preserve-aspect";
     layoutId?: string;
     layout?: boolean | string;
     visualElement?: VisualElement;
@@ -2498,6 +2501,7 @@ interface ProjectionNodeOptions {
     initialPromotionConfig?: InitialPromotionConfig;
 }
 
+declare type ReducedMotionConfig = "always" | "never" | "user";
 /**
  * @public
  */
@@ -2523,7 +2527,7 @@ interface MotionConfigContext {
      *
      * @public
      */
-    reducedMotion?: "always" | "never" | "user";
+    reducedMotion?: ReducedMotionConfig;
 }
 /**
  * @public
@@ -2556,6 +2560,55 @@ interface MotionConfigProps extends Partial<MotionConfigContext> {
  */
 declare function MotionConfig({ children, isValidProp, ...config }: MotionConfigProps): JSX.Element;
 
+/**
+ * @public
+ */
+interface FeatureProps extends MotionProps {
+    visualElement: VisualElement;
+}
+declare type FeatureNames = {
+    animation: true;
+    exit: true;
+    drag: true;
+    tap: true;
+    focus: true;
+    hover: true;
+    pan: true;
+    inView: true;
+    measureLayout: true;
+};
+declare type FeatureComponent = React$1.ComponentType<React$1.PropsWithChildren<FeatureProps>>;
+/**
+ * @public
+ */
+interface FeatureDefinition {
+    isEnabled: (props: MotionProps) => boolean;
+    Component?: FeatureComponent;
+}
+interface FeatureComponents {
+    animation?: FeatureComponent;
+    exit?: FeatureComponent;
+    drag?: FeatureComponent;
+    tap?: FeatureComponent;
+    focus?: FeatureComponent;
+    hover?: FeatureComponent;
+    pan?: FeatureComponent;
+    inView?: FeatureComponent;
+    measureLayout?: FeatureComponent;
+}
+interface FeatureBundle extends FeatureComponents {
+    renderer: CreateVisualElement<any>;
+    projectionNodeConstructor?: any;
+}
+declare type LazyFeatureBundle$1 = () => Promise<FeatureBundle>;
+declare type FeatureDefinitions = {
+    [K in keyof FeatureNames]: FeatureDefinition;
+};
+declare type LoadedFeatures = FeatureDefinitions & {
+    projectionNodeConstructor?: any;
+};
+declare type RenderComponent<Instance, RenderState> = (Component: string | React$1.ComponentType<React$1.PropsWithChildren<unknown>>, props: MotionProps, projectionId: number | undefined, ref: React$1.Ref<Instance>, visualState: VisualState<Instance, RenderState>, isStatic: boolean, visualElement?: VisualElement) => any;
+
 interface VisualElement<Instance = any, RenderState = any> extends LifecycleManager {
     treeType: string;
     depth: number;
@@ -2577,6 +2630,7 @@ interface VisualElement<Instance = any, RenderState = any> extends LifecycleMana
     getClosestVariantNode(): VisualElement | undefined;
     shouldReduceMotion?: boolean | null;
     animateMotionValue?: typeof startAnimation;
+    loadFeatures(props: MotionProps, isStrict?: boolean, preloadedFeatures?: FeatureBundle, projectionId?: number, ProjectionNodeConstructor?: any, initialPromotionConfig?: SwitchLayoutGroupContext): JSX.Element[];
     projection?: IProjectionNode;
     /**
      * Visibility
@@ -2644,7 +2698,7 @@ declare type VisualElementOptions<Instance, RenderState = any> = {
     presenceId?: string | undefined;
     props: MotionProps;
     blockInitialAnimation?: boolean;
-    shouldReduceMotion?: boolean | null;
+    reducedMotionConfig?: ReducedMotionConfig;
 };
 declare type CreateVisualElement<Instance> = (Component: string | React$1.ComponentType<React$1.PropsWithChildren<unknown>>, options: VisualElementOptions<Instance>) => VisualElement<Instance>;
 /**
@@ -2709,55 +2763,6 @@ declare type SVGMotionComponents = {
     [K in SVGElements]: ForwardRefComponent<UnwrapSVGFactoryElement<JSX.IntrinsicElements[K]>, SVGMotionProps<UnwrapSVGFactoryElement<JSX.IntrinsicElements[K]>>>;
 };
 
-/**
- * @public
- */
-interface FeatureProps extends MotionProps {
-    visualElement: VisualElement;
-}
-declare type FeatureNames = {
-    animation: true;
-    exit: true;
-    drag: true;
-    tap: true;
-    focus: true;
-    hover: true;
-    pan: true;
-    inView: true;
-    measureLayout: true;
-};
-declare type FeatureComponent = React$1.ComponentType<React$1.PropsWithChildren<FeatureProps>>;
-/**
- * @public
- */
-interface FeatureDefinition {
-    isEnabled: (props: MotionProps) => boolean;
-    Component?: FeatureComponent;
-}
-interface FeatureComponents {
-    animation?: FeatureComponent;
-    exit?: FeatureComponent;
-    drag?: FeatureComponent;
-    tap?: FeatureComponent;
-    focus?: FeatureComponent;
-    hover?: FeatureComponent;
-    pan?: FeatureComponent;
-    inView?: FeatureComponent;
-    measureLayout?: FeatureComponent;
-}
-interface FeatureBundle extends FeatureComponents {
-    renderer: CreateVisualElement<any>;
-    projectionNodeConstructor?: any;
-}
-declare type LazyFeatureBundle$1 = () => Promise<FeatureBundle>;
-declare type FeatureDefinitions = {
-    [K in keyof FeatureNames]: FeatureDefinition;
-};
-declare type LoadedFeatures = FeatureDefinitions & {
-    projectionNodeConstructor?: any;
-};
-declare type RenderComponent<Instance, RenderState> = (Component: string | React$1.ComponentType<React$1.PropsWithChildren<unknown>>, props: MotionProps, projectionId: number | undefined, ref: React$1.Ref<Instance>, visualState: VisualState<Instance, RenderState>, isStatic: boolean, visualElement?: VisualElement) => any;
-
 interface MotionComponentConfig<Instance, RenderState> {
     preloadedFeatures?: FeatureBundle;
     createVisualElement?: CreateVisualElement<Instance>;
@@ -3985,6 +3990,7 @@ declare function useWillChange(): WillChange;
  * @public
  */
 declare function useReducedMotion(): boolean | null;
+
 declare function useReducedMotionConfig(): boolean | null;
 
 /**
@@ -4163,7 +4169,7 @@ declare function useInView(ref: RefObject<Element>, { root, margin, amount, once
  */
 declare function useDomEvent(ref: RefObject<EventTarget>, eventName: string, handler?: EventListener | undefined, options?: AddEventListenerOptions): void;
 
-declare const visualElement: <Instance, MutableState, Options>({ treeType, build, getBaseTarget, makeTargetAnimatable, measureViewportBox, render: renderInstance, readValueFromInstance, removeValueFromRenderState, sortNodePosition, scrapeMotionValuesFromProps, }: VisualElementConfig<Instance, MutableState, Options>) => ({ parent, props, presenceId, blockInitialAnimation, visualState, shouldReduceMotion, }: VisualElementOptions<Instance, any>, options?: Options) => VisualElement<Instance, any>;
+declare const visualElement: <Instance, MutableState, Options>({ treeType, build, getBaseTarget, makeTargetAnimatable, measureViewportBox, render: renderInstance, readValueFromInstance, removeValueFromRenderState, sortNodePosition, scrapeMotionValuesFromProps, }: VisualElementConfig<Instance, MutableState, Options>) => ({ parent, props, presenceId, blockInitialAnimation, visualState, reducedMotionConfig, }: VisualElementOptions<Instance, any>, options?: Options) => VisualElement<Instance, any>;
 
 declare type ScaleCorrector = (latest: string | number, node: IProjectionNode) => string | number;
 interface ScaleCorrectorDefinition {