@motion.page/sdk 1.2.2 → 1.2.3

package/dist/triggers/MouseMoveTrigger.d.ts

@@ -40,6 +40,20 @@ export declare class MouseMoveTrigger extends BaseTrigger<MouseMoveConfig> {
      * Called by TriggerManager on resize.
      */
     refresh(): void;
+    private _scrollX;
+    private _scrollY;
+    /**
+     * Capture an element's layout rect in DOCUMENT coordinates (viewport rect at
+     * rest + current scroll). getLayoutRect strips transforms so an animating
+     * target doesn't feed back into the measurement.
+     */
+    private _captureDocRect;
+    /**
+     * Convert a document-space rect to the current viewport position using the
+     * live scroll offset. This is what makes a target captured below the fold
+     * become hittable once it scrolls into view.
+     */
+    private _viewportRect;
     private _addTargetListeners;
     private _handleTargetPointerMove;
     private _findTargetAtPoint;

package/dist/utils/PathParser.d.ts

@@ -65,6 +65,26 @@ export declare function calculateElementOffset(element: string | Element | undef
     x: number;
     y: number;
 };
+/**
+ * Resolve the user-unit -> screen-pixel scale of an SVG path target.
+ *
+ * A `<path>` inside an `<svg viewBox="0 0 227 1358">` that renders 400px wide is
+ * scaled ~1.76x on X: its `d` coordinates are in viewBox user units, not CSS px.
+ * `getPointAtLength` returns user units, so an HTML element translated by those
+ * raw values drifts off the visible line. This returns the per-axis scale so the
+ * sampled trajectory can be converted into the same pixel space the path renders
+ * in (mirrors what GSAP's MotionPathPlugin did via the path's CTM).
+ *
+ * Raw path-data strings and off-DOM targets have no rendered geometry, so they
+ * return {1, 1} (no scaling — unchanged legacy behavior).
+ *
+ * @param target - The path `target` (CSS selector, Element, or raw "d" string)
+ * @returns Per-axis scale factor; {x:1, y:1} when not an on-DOM SVG element
+ */
+export declare function resolvePathScreenScale(target: string | Element): {
+    x: number;
+    y: number;
+};
 /**
  * Calculate offset to position path relative to an align element
  * The path's first point (M command) will be positioned at the align element's center
@@ -72,9 +92,13 @@ export declare function calculateElementOffset(element: string | Element | undef
  * @param align - Element or selector to align the path to
  * @param pathData - SVG path data string
  * @param animatedElement - The element being animated (to calculate relative offset)
+ * @param pathScale - User-unit -> screen-px scale applied to the path's first point
  * @returns Offset to add to path coordinates
  */
-export declare function calculatePathAlignOffset(align: string | Element | undefined, pathData: string, animatedElement?: Element): {
+export declare function calculatePathAlignOffset(align: string | Element | undefined, pathData: string, animatedElement?: Element, pathScale?: {
+    x: number;
+    y: number;
+}): {
     x: number;
     y: number;
 };

package/dist/utils/PropertyParser/types.d.ts

@@ -78,6 +78,10 @@ export interface ParsedPathProperty extends ParsedPropertyBase {
         x: number;
         y: number;
     };
+    pathScale: {
+        x: number;
+        y: number;
+    };
 }
 /**
  * Discriminated union of all parsed property types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motion.page/sdk",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "High-performance CSS animation SDK with scroll, hover, gesture, and cursor triggers",
   "type": "module",
   "main": "dist/index.js",