@wandelbots/wandelbots-js-react-components 2.26.0-pr.feature-update-to-react-19.361.0d1640d → 2.26.0-pr.feature-update-to-react-19.361.49c57ce

package/dist/components/robots/RobotAnimator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RobotAnimator.d.ts","sourceRoot":"","sources":["../../../src/components/robots/RobotAnimator.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAA4B,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,OAAO,CAAA;AAK5C,KAAK,kBAAkB,GAAG;IACxB,0BAA0B,EAAE,wBAAwB,CAAA;IACpD,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACvE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,0BAA0B,EAC1B,YAAY,EACZ,iBAAiB,EACjB,QAAQ,GACT,EAAE,kBAAkB,2CAyEpB"}
+{"version":3,"file":"RobotAnimator.d.ts","sourceRoot":"","sources":["../../../src/components/robots/RobotAnimator.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAA4B,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,OAAO,CAAA;AAK5C,KAAK,kBAAkB,GAAG;IACxB,0BAA0B,EAAE,wBAAwB,CAAA;IACpD,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACvE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,0BAA0B,EAC1B,YAAY,EACZ,iBAAiB,EACjB,QAAQ,GACT,EAAE,kBAAkB,2CA2EpB"}

package/dist/components/utils/interpolation.d.ts

@@ -2,11 +2,16 @@
  * Smooth value interpolation utility for animating between values
  * even with rapid updates. Uses THREE.MathUtils.lerp for optimized interpolation.
  *
+ * Follows React Three Fiber best practices:
+ * - Uses frame deltas for refresh-rate independence
+ * - Avoids object creation in animation loops
+ * - Direct mutation for performance
+ *
  * @example
  * ```tsx
  * // Basic usage with spring-like animation (similar to react-spring)
  * const interpolator = new ValueInterpolator([0, 0, 0], {
- *   speed: 0.1, // Interpolation speed (0-1)
+ *   alpha: 0.1, // Interpolation alpha (0-1, frame-rate independent)
  *   easing: 'spring', // Spring-like animation with slight overshoot
  *   onChange: (values) => {
  *     // Update your objects with interpolated values
@@ -25,26 +30,30 @@
  * // Set new target values
  * interpolator.setTarget([1.5, -0.8, 2.1])
  *
- * // React hook usage
+ * // React hook usage with useFrame
  * function MyComponent() {
- *   const [interpolator, currentValues] = useInterpolation([0, 0, 0], {
- *     speed: 0.15,
- *     easing: 'spring',
- *     onChange: (values) => console.log('Values updated:', values)
+ *   const [interpolator] = useInterpolation([0, 0, 0], {
+ *     alpha: 0.1,
+ *     easing: 'spring'
+ *   })
+ *
+ *   useFrame((state, delta) => {
+ *     // Frame-rate independent updates
+ *     interpolator.update(delta)
  *   })
  *
  *   useEffect(() => {
  *     interpolator.setTarget([1, 2, 3])
  *   }, [])
  *
- *   return <div>Current values: {currentValues.join(', ')}</div>
+ *   return <mesh position={interpolator.getCurrentValues()} />
  * }
  * ```
  */
 export type EasingFunction = "linear" | "spring" | "easeOut" | "easeInOut";
 export interface InterpolationOptions {
-    /** Interpolation speed factor (0-1, where 1 is instant) */
-    speed?: number;
+    /** Interpolation alpha factor (0-1, frame-rate independent) */
+    alpha?: number;
     /** Minimum threshold to consider interpolation complete */
     threshold?: number;
     /** Easing function to use for interpolation */
@@ -60,6 +69,11 @@ export declare class ValueInterpolator {
     private animationId;
     private options;
     constructor(initialValues?: number[], options?: InterpolationOptions);
+    /**
+     * Update interpolation (call this in useFrame for frame-rate independence)
+     * @param delta - Frame delta time for smooth animation
+     */
+    update(delta?: number): boolean;
     /**
      * Set new target values to interpolate towards
      */
@@ -93,14 +107,33 @@ export declare class ValueInterpolator {
      */
     destroy(): void;
     /**
-     * Apply easing function to the interpolation
+     * Apply easing function to the interpolation with frame-rate independence
      */
     private applyEasing;
     private startInterpolation;
     private animate;
 }
 /**
- * React hook for using the ValueInterpolator
+ * React hook for using the ValueInterpolator with useFrame
+ *
+ * @example
+ * ```tsx
+ * function AnimatedMesh() {
+ *   const [interpolator] = useInterpolation([0, 0, 0], { alpha: 0.1 })
+ *   const meshRef = useRef()
+ *
+ *   useFrame((state, delta) => {
+ *     if (interpolator.update(delta)) {
+ *       // Animation complete
+ *     }
+ *     // Apply current values directly to mesh
+ *     const [x, y, z] = interpolator.getCurrentValues()
+ *     meshRef.current.position.set(x, y, z)
+ *   })
+ *
+ *   return <mesh ref={meshRef} />
+ * }
+ * ```
  */
-export declare function useInterpolation(initialValues?: number[], options?: InterpolationOptions): [ValueInterpolator, number[]];
+export declare function useInterpolation(initialValues?: number[], options?: InterpolationOptions): [ValueInterpolator];
 //# sourceMappingURL=interpolation.d.ts.map

package/dist/components/utils/interpolation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../../src/components/utils/interpolation.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;AAE1E,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACrC,wDAAwD;IACxD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;CACxC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,OAAO,CAAgC;gBAG7C,aAAa,GAAE,MAAM,EAAO,EAC5B,OAAO,GAAE,oBAAyB;IAepC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAcpC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAOpC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,OAAO,CA+Bd;CACF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,GAAE,MAAM,EAAO,EAC5B,OAAO,GAAE,oBAAyB,GACjC,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC,CA6B/B"}
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../../src/components/utils/interpolation.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;AAE1E,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACrC,wDAAwD;IACxD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;CACxC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,OAAO,CAAgC;gBAG7C,aAAa,GAAE,MAAM,EAAO,EAC5B,OAAO,GAAE,oBAAyB;IAepC;;;OAGG;IACH,MAAM,CAAC,KAAK,GAAE,MAAe,GAAG,OAAO;IAsCvC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAcpC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAOpC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,OAAO,CAAC,WAAW;IAqCnB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,OAAO,CA+Bd;CACF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,GAAE,MAAM,EAAO,EAC5B,OAAO,GAAE,oBAAyB,GACjC,CAAC,iBAAiB,CAAC,CAqBrB"}