@wandelbots/wandelbots-js-react-components 2.27.1 → 2.28.0

package/README.md

@@ -42,7 +42,7 @@ See the [Storybook](https://wandelbotsgmbh.github.io/wandelbots-js-react-compone
 </table>
 
 ### UI
- 
+
 #### JoggingPanel
 
 <a href="https://wandelbotsgmbh.github.io/wandelbots-js-react-components/?path=/docs/jogging-joggingpanel--docs">

package/dist/Setup.d.ts

@@ -1,4 +1,4 @@
-import { type Props as CanvasProps } from "@react-three/fiber";
+import { type CanvasProps } from "@react-three/fiber";
 import * as React from "react";
 import { Vector3 } from "three";
 type Props = React.PropsWithChildren<CanvasProps & {

package/dist/Setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Setup.d.ts","sourceRoot":"","sources":["../src/Setup.tsx"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,KAAK,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAG/B,KAAK,KAAK,GAAG,KAAK,CAAC,iBAAiB,CAClC,WAAW,GAAG;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CACF,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,yEAOnB,KAAK,4CAcP,CAAA"}
+{"version":3,"file":"Setup.d.ts","sourceRoot":"","sources":["../src/Setup.tsx"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAG/B,KAAK,KAAK,GAAG,KAAK,CAAC,iBAAiB,CAClC,WAAW,GAAG;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CACF,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,yEAOnB,KAAK,4CAcP,CAAA"}

package/dist/components/3d-viewport/SafetyZonesRenderer.d.ts

@@ -1,7 +1,7 @@
-import { type GroupProps } from "@react-three/fiber";
+import { type ThreeElements } from "@react-three/fiber";
 import type { SafetySetupSafetyZone } from "@wandelbots/nova-js/v1";
 export type SafetyZonesRendererProps = {
     safetyZones: SafetySetupSafetyZone[];
-} & GroupProps;
+} & ThreeElements["group"];
 export declare function SafetyZonesRenderer({ safetyZones, ...props }: SafetyZonesRendererProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SafetyZonesRenderer.d.ts.map

package/dist/components/3d-viewport/SafetyZonesRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SafetyZonesRenderer.d.ts","sourceRoot":"","sources":["../../../src/components/3d-viewport/SafetyZonesRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAInE,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,qBAAqB,EAAE,CAAA;CACrC,GAAG,UAAU,CAAA;AAqCd,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,GAAG,KAAK,EACT,EAAE,wBAAwB,2CA6D1B"}
+{"version":3,"file":"SafetyZonesRenderer.d.ts","sourceRoot":"","sources":["../../../src/components/3d-viewport/SafetyZonesRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAInE,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,qBAAqB,EAAE,CAAA;CACrC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;AAqC1B,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,GAAG,KAAK,EACT,EAAE,wBAAwB,2CA6D1B"}

package/dist/components/3d-viewport/TrajectoryRenderer.d.ts

@@ -1,6 +1,6 @@
 import type { GetTrajectoryResponse } from "@wandelbots/nova-js/v1";
 export type TrajectoryRendererProps = {
     trajectory: GetTrajectoryResponse;
-} & JSX.IntrinsicElements["group"];
+} & React.JSX.IntrinsicElements["group"];
 export declare function TrajectoryRenderer({ trajectory, ...props }: TrajectoryRendererProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=TrajectoryRenderer.d.ts.map

package/dist/components/3d-viewport/TrajectoryRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrajectoryRenderer.d.ts","sourceRoot":"","sources":["../../../src/components/3d-viewport/TrajectoryRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAGnE,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,qBAAqB,CAAA;CAClC,GAAG,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;AAElC,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,GAAG,KAAK,EACT,EAAE,uBAAuB,2CA4BzB"}
+{"version":3,"file":"TrajectoryRenderer.d.ts","sourceRoot":"","sources":["../../../src/components/3d-viewport/TrajectoryRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAGnE,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,qBAAqB,CAAA;CAClC,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;AAExC,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,GAAG,KAAK,EACT,EAAE,uBAAuB,2CA4BzB"}

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

@@ -1 +1 @@
-{"version":3,"file":"DHRobot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/DHRobot.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAKpD,wBAAgB,OAAO,CAAC,EACtB,0BAA0B,EAC1B,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,YAAY,2CA0Gd"}
+{"version":3,"file":"DHRobot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/DHRobot.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAKpD,wBAAgB,OAAO,CAAC,EACtB,0BAA0B,EAC1B,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,YAAY,2CAoId"}

package/dist/components/robots/GenericRobot.d.ts

@@ -1,4 +1,4 @@
-import type { GroupProps } from "@react-three/fiber";
+import type { ThreeElements } from "@react-three/fiber";
 import React from "react";
 import type { Group } from "three";
 export type RobotModelProps = {
@@ -9,6 +9,6 @@ export type RobotModelProps = {
      */
     postModelRender?: () => void;
     flangeRef?: React.Ref<Group>;
-} & GroupProps;
+} & ThreeElements["group"];
 export declare function GenericRobot({ modelURL, flangeRef, postModelRender, ...props }: RobotModelProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=GenericRobot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GenericRobot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/GenericRobot.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAsB,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,OAAO,CAAA;AAIxC,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;CAC7B,GAAG,UAAU,CAAA;AAMd,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,SAAS,EACT,eAAe,EACf,GAAG,KAAK,EACT,EAAE,eAAe,2CA+CjB"}
+{"version":3,"file":"GenericRobot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/GenericRobot.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAsB,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,OAAO,CAAA;AAIxC,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;CAC7B,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;AAM1B,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,SAAS,EACT,eAAe,EACf,GAAG,KAAK,EACT,EAAE,eAAe,2CA+CjB"}

package/dist/components/robots/Robot.d.ts

@@ -1,4 +1,4 @@
-import { type GroupProps } from "@react-three/fiber";
+import { type ThreeElements } from "@react-three/fiber";
 import type { ConnectedMotionGroup } from "@wandelbots/nova-js/v1";
 import type { Group } from "three";
 export type RobotProps = {
@@ -6,7 +6,7 @@ export type RobotProps = {
     getModel?: (modelFromController: string) => string;
     flangeRef?: React.Ref<Group>;
     transparentColor?: string;
-} & GroupProps;
+} & ThreeElements["group"];
 /**
  * The Robot component is a wrapper around the SupportedRobot component
  * for usage with @wandelbots/nova-js ConnectedMotionGroup object.

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

@@ -1 +1 @@
-{"version":3,"file":"Robot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/Robot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAIlC,MAAM,MAAM,UAAU,GAAG;IACvB,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,QAAQ,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAA;IAClD,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,UAAU,CAAA;AAEd;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,EACpB,oBAAoB,EACpB,QAA0B,EAC1B,SAAS,EACT,gBAAgB,EAChB,GAAG,KAAK,EACT,EAAE,UAAU,kDAkBZ"}
+{"version":3,"file":"Robot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/Robot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAIlC,MAAM,MAAM,UAAU,GAAG;IACvB,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,QAAQ,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAA;IAClD,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;AAE1B;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,EACpB,oBAAoB,EACpB,QAA0B,EAC1B,SAAS,EACT,gBAAgB,EAChB,GAAG,KAAK,EACT,EAAE,UAAU,kDAkBZ"}

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":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAiB,MAAM,OAAO,CAAA;AACrC,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,OAAO,CAAA;AAI5C,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,2CAgEpB"}
+{"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,2CA+EpB"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RobotAnimator.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RobotAnimator.test.d.ts","sourceRoot":"","sources":["../../../src/components/robots/RobotAnimator.test.tsx"],"names":[],"mappings":""}

package/dist/components/robots/SupportedRobot.d.ts

@@ -1,10 +1,10 @@
-import type { GroupProps } from "@react-three/fiber";
+import type { ThreeElements } from "@react-three/fiber";
 import type { DHParameter, MotionGroupStateResponse } from "@wandelbots/nova-api/v1";
 import type * as THREE from "three";
 export type DHRobotProps = {
     rapidlyChangingMotionState: MotionGroupStateResponse;
     dhParameters: Array<DHParameter>;
-} & GroupProps;
+} & ThreeElements["group"];
 export type SupportedRobotProps = {
     rapidlyChangingMotionState: MotionGroupStateResponse;
     modelFromController: string;
@@ -13,6 +13,6 @@ export type SupportedRobotProps = {
     getModel?: (modelFromController: string) => string;
     postModelRender?: () => void;
     transparentColor?: string;
-} & GroupProps;
+} & ThreeElements["group"];
 export declare const SupportedRobot: ({ rapidlyChangingMotionState, modelFromController, dhParameters, getModel, flangeRef, postModelRender, transparentColor, ...props }: SupportedRobotProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SupportedRobot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SupportedRobot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/SupportedRobot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAKhC,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAQnC,MAAM,MAAM,YAAY,GAAG;IACzB,0BAA0B,EAAE,wBAAwB,CAAA;IACpD,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;CACjC,GAAG,UAAU,CAAA;AAEd,MAAM,MAAM,mBAAmB,GAAG;IAChC,0BAA0B,EAAE,wBAAwB,CAAA;IACpD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAA;IAClD,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,UAAU,CAAA;AAEd,eAAO,MAAM,cAAc,wIAUtB,mBAAmB,4CAoDvB,CAAA"}
+{"version":3,"file":"SupportedRobot.d.ts","sourceRoot":"","sources":["../../../src/components/robots/SupportedRobot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAKhC,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAQnC,MAAM,MAAM,YAAY,GAAG;IACzB,0BAA0B,EAAE,wBAAwB,CAAA;IACpD,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;CACjC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;AAE1B,MAAM,MAAM,mBAAmB,GAAG;IAChC,0BAA0B,EAAE,wBAAwB,CAAA;IACpD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAA;IAClD,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;AAE1B,eAAO,MAAM,cAAc,wIAUtB,mBAAmB,4CAoDvB,CAAA"}

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

@@ -0,0 +1,159 @@
+/**
+ * Smooth value interpolation utility using spring physics with tension and friction.
+ * Designed for React Three Fiber applications with smooth, natural animations.
+ *
+ * Features:
+ * - Spring physics with configurable tension and friction
+ * - Frame-rate independent using delta timing
+ * - Handles irregular frame timing and rapid target updates
+ * - Manual update() calls for useFrame integration (no automatic RAF loop)
+ * - Direct mutation for performance
+ *
+ * @example
+ * ```tsx
+ * // Basic spring animation
+ * const interpolator = new ValueInterpolator([0, 0, 0], {
+ *   tension: 120, // Higher = faster, stiffer spring (default: 120)
+ *   friction: 20, // Higher = more damping, less oscillation (default: 20)
+ *   onChange: (values) => {
+ *     robot.joints.forEach((joint, i) => {
+ *       joint.rotation.y = values[i]
+ *     })
+ *   }
+ * })
+ *
+ * interpolator.setTarget([1.5, -0.8, 2.1])
+ *
+ * // React Three Fiber usage
+ * function MyComponent() {
+ *   const [interpolator] = useInterpolation([0, 0, 0])
+ *
+ *   useFrame((state, delta) => {
+ *     interpolator.update(delta)
+ *   })
+ *
+ *   useEffect(() => {
+ *     interpolator.setTarget([1, 2, 3])
+ *   }, [])
+ *
+ *   return <mesh position={interpolator.getCurrentValues()} />
+ * }
+ * ```
+ */
+export interface InterpolationOptions {
+    /** Spring tension (higher = faster, stiffer spring) - default: 120 */
+    tension?: number;
+    /** Spring friction (higher = more damping, less oscillation) - default: 20 */
+    friction?: number;
+    /** Minimum threshold to consider interpolation complete - default: 0.001 */
+    threshold?: number;
+    /** Callback when values change during interpolation */
+    onChange?: (values: number[]) => void;
+    /** Callback when interpolation reaches target values */
+    onComplete?: (values: number[]) => void;
+}
+export declare class ValueInterpolator {
+    private currentValues;
+    private targetValues;
+    private previousTargetValues;
+    private targetUpdateTime;
+    private animationId;
+    private options;
+    private updateCount;
+    private velocities;
+    constructor(initialValues?: number[], options?: InterpolationOptions);
+    /**
+     * Update interpolation using spring physics
+     *
+     * Call this method every frame for smooth animation. In React Three Fiber,
+     * call from within useFrame callback with the provided delta time.
+     *
+     * @param delta - Time elapsed since last update in seconds (e.g., 1/60 ≈ 0.0167 for 60fps)
+     * @returns true when interpolation is complete (all values reached their targets)
+     */
+    update(delta?: number): boolean;
+    /**
+     * Set new target values for the interpolation to move towards
+     *
+     * Includes smart blending for very rapid target updates (faster than 120fps)
+     * to prevent jarring movements when targets change frequently.
+     */
+    setTarget(newValues: number[]): void;
+    /**
+     * Get a copy of all current interpolated values
+     */
+    getCurrentValues(): number[];
+    /**
+     * Get a single interpolated value by its array index
+     */
+    getValue(index: number): number;
+    /**
+     * Check if automatic interpolation is currently running
+     *
+     * This only tracks auto-interpolation started with startAutoInterpolation().
+     * Manual update() calls are not tracked by this method.
+     */
+    isInterpolating(): boolean;
+    /**
+     * Stop automatic interpolation if it's running
+     *
+     * This cancels the internal animation frame loop but does not affect
+     * manual update() calls.
+     */
+    stop(): void;
+    /**
+     * Instantly set values without interpolation
+     */
+    setImmediate(values: number[]): void;
+    /**
+     * Update interpolation options
+     */
+    updateOptions(newOptions: Partial<InterpolationOptions>): void;
+    /**
+     * Start automatic interpolation with an animation loop
+     *
+     * This begins a requestAnimationFrame loop that calls update() automatically.
+     * For React Three Fiber components, prefer using manual update() calls
+     * within useFrame hooks instead.
+     */
+    startAutoInterpolation(): void;
+    /**
+     * Clean up all resources and stop any running animations
+     *
+     * This cancels any active animation frames and resets internal state.
+     * Call this when the component unmounts or is no longer needed.
+     */
+    destroy(): void;
+    private startInterpolation;
+    private animate;
+}
+/**
+ * React hook for using the ValueInterpolator with useFrame
+ *
+ * This hook creates a ValueInterpolator that uses spring physics for smooth,
+ * natural animations. Call interpolator.update(delta) in your useFrame callback.
+ *
+ * @example
+ * ```tsx
+ * function AnimatedMesh() {
+ *   const [interpolator] = useInterpolation([0, 0, 0], {
+ *     tension: 120, // Higher = faster spring
+ *     friction: 20  // Higher = more damping
+ *   })
+ *   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];
+//# sourceMappingURL=interpolation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../../src/components/utils/interpolation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,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,oBAAoB,CAAe;IAC3C,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAY;IAG/B,OAAO,CAAC,UAAU,CAAe;gBAG/B,aAAa,GAAE,MAAM,EAAO,EAC5B,OAAO,GAAE,oBAAyB;IAmBpC;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,GAAE,MAAe,GAAG,OAAO;IAmEvC;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAsDpC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B;;;;;OAKG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAWpC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAI9D;;;;;;OAMG;IACH,sBAAsB,IAAI,IAAI;IAI9B;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,OAAO,CASd;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,GAAE,MAAM,EAAO,EAC5B,OAAO,GAAE,oBAAyB,GACjC,CAAC,iBAAiB,CAAC,CAqBrB"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interpolation.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpolation.test.d.ts","sourceRoot":"","sources":["../../../src/components/utils/interpolation.test.ts"],"names":[],"mappings":""}

package/dist/externalizeComponent.d.ts

@@ -3,5 +3,5 @@
  * be provided by the user application; this wrapper ensures
  * they can be used either way.
  */
-export declare function externalizeComponent<T extends JSX.ElementType>(Component: T): T;
+export declare function externalizeComponent<T extends React.JSX.ElementType>(Component: T): T;
 //# sourceMappingURL=externalizeComponent.d.ts.map

package/dist/externalizeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"externalizeComponent.d.ts","sourceRoot":"","sources":["../src/externalizeComponent.tsx"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,GAAG,CAAC,WAAW,EAC5D,SAAS,EAAE,CAAC,GACX,CAAC,CAQH"}
+{"version":3,"file":"externalizeComponent.d.ts","sourceRoot":"","sources":["../src/externalizeComponent.tsx"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,WAAW,EAClE,SAAS,EAAE,CAAC,GACX,CAAC,CAQH"}