@motion.page/sdk 1.2.1 → 1.2.3

package/dist/render/CSSRenderer.d.ts

@@ -18,6 +18,12 @@ import type { ParsedClipPath } from '../utils/ClipPathParser';
  * Automatically batches during animation tick, writes immediately otherwise
  */
 export declare function setCSSProperty(element: Element, property: string, value: number, unit: string): void;
+/**
+ * Set a regular CSS property whose explicit start/end values use different
+ * units. Endpoints are emitted as authored; intermediate frames use CSS calc()
+ * so the browser resolves mixed units natively.
+ */
+export declare function setCSSMixedUnitProperty(element: Element, property: string, startValue: number, startUnit: string, endValue: number, endUnit: string, progress: number): void;
 /**
  * Set a CSS color property value on an element
  * Takes RGBA values directly for performance (avoids string formatting in hot path)

package/dist/triggers/CursorTrigger.d.ts

@@ -34,6 +34,12 @@ export declare class CursorTrigger extends BaseTrigger<CursorConfig> {
     private _isHoveringCursorTarget;
     private _boundHoverTargetMoveHandler;
     private _hoverPointerMoveTarget;
+    private _boundTextAttributeMoveHandler;
+    private _textPointerMoveTarget;
+    private _activeTextAttributeElement;
+    private _hasTextAttributeElements;
+    private _textAttributeObserver;
+    private _textAttributeObserverActive;
     private _cursorStyleTag;
     private _attributeListeners;
     constructor(timeline: Timeline, config: CursorConfig);
@@ -75,6 +81,27 @@ export declare class CursorTrigger extends BaseTrigger<CursorConfig> {
     private _setupEventListeners;
     private _setupHoverTargets;
     private _setupTextCursor;
+    private _setupTextAttributeHitTesting;
+    /** Recompute whether any tooltip/text attribute elements currently exist. */
+    private _updateHasTextAttributeElements;
+    /**
+     * Watch the DOM for tooltip/text attribute elements being added, removed, or
+     * toggled so the hit-test fast path stays correct without polling. The
+     * callback only runs a single querySelector per mutation batch — far cheaper
+     * than an elementsFromPoint call on every pointer-move frame.
+     */
+    private _observeTextAttributeElements;
+    private _findTextAttributeTarget;
+    private _showTextCursor;
+    /**
+     * Drop the cursor back to its default state only when neither hover source is
+     * active. Both the hover-selector hit-test and the text-attribute hit-test can
+     * hold the 'hover' state; releasing requires both to be inactive so the two
+     * handlers don't fight each other across pointer-move frames. The `'hover'`
+     * guard preserves an in-progress 'click' state.
+     */
+    private _releaseHoverIfInactive;
+    private _hideTextCursor;
     private _setupMediaCursor;
     private _removeEventListeners;
     private _setState;

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/triggers/PinManager.d.ts

@@ -174,6 +174,7 @@ export declare class PinManager {
      * collapsing the spacer below its needed size (GSAP-compatible).
      */
     private _resolvePinSpacing;
+    private _applyFixedState;
     /**
      * Fixed positioning for window scroller (seamless pinning)
      *

package/dist/utils/ColorParser.d.ts

@@ -6,7 +6,7 @@
  * - RGB/RGBA: rgb(255, 0, 0), rgba(255, 0, 0, 0.5)
  * - HSL/HSLA: hsl(0, 100%, 50%), hsla(0, 100%, 50%, 0.5)
  * - Named colors: red, coral, transparent
- * - CSS variables: var(--color)
+ * - CSS variables: var(--color), --color
  */
 /**
  * Parse any color format to RGBA Float32Array

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

@@ -24,6 +24,8 @@ export interface ParsedScalarProperty extends ParsedPropertyBase {
     startValue: number;
     endValue: number;
     unit: string;
+    startUnit?: string;
+    endUnit?: string;
 }
 /**
  * Color property (RGBA values)
@@ -76,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.1",
+  "version": "1.2.3",
   "description": "High-performance CSS animation SDK with scroll, hover, gesture, and cursor triggers",
   "type": "module",
   "main": "dist/index.js",