@wandelbots/wandelbots-js-react-components 2.27.1-pr.feature-update-to-react-19.361.57aba09 → 2.27.1-pr.feature-add-program-control-component.367.8730636

package/src/i18n/locales/de/translations.json

@@ -43,5 +43,9 @@
   "Jogging.CoordinateSystem.hlb": "Koordinatensystem",
   "Jogging.Cartesian.bt": "Kartesisch",
   "Jogging.Joints.bt": "Gelenke",
-  "Jogging.Velocity.bt": "Geschwindigkeit"
+  "Jogging.Velocity.bt": "Geschwindigkeit",
+  "ProgramControl.Run.bt": "Starten",
+  "ProgramControl.Resume.bt": "Fortsetzen",
+  "ProgramControl.Pause.bt": "Pausieren",
+  "ProgramControl.Stop.bt": "Stoppen"
 }

package/src/i18n/locales/en/translations.json

@@ -44,5 +44,9 @@
   "Jogging.CoordinateSystem.hlb": "Coordinate system",
   "Jogging.Cartesian.bt": "Cartesian",
   "Jogging.Joints.bt": "Joints",
-  "Jogging.Velocity.bt": "Velocity"
+  "Jogging.Velocity.bt": "Velocity",
+  "ProgramControl.Run.bt": "Run",
+  "ProgramControl.Resume.bt": "Resume",
+  "ProgramControl.Pause.bt": "Pause",
+  "ProgramControl.Stop.bt": "Stop"
 }

package/src/index.ts

@@ -9,6 +9,7 @@ export * from "./components/jogging/PoseCartesianValues"
 export * from "./components/jogging/PoseJointValues"
 export * from "./components/LoadingCover"
 export * from "./components/modal/NoMotionGroupModal"
+export * from "./components/ProgramControl"
 export * from "./components/robots/AxisConfig"
 export * from "./components/robots/Robot"
 export { defaultGetModel } from "./components/robots/robotModelLogic"
@@ -16,7 +17,6 @@ export * from "./components/robots/SupportedRobot"
 export * from "./components/safetyBar/SafetyBar"
 export * from "./components/SelectableFab"
 export * from "./components/utils/hooks"
-export * from "./components/utils/interpolation"
 export * from "./components/VelocitySlider"
 export * from "./components/wandelscript-editor/WandelscriptEditor"
 export * from "./i18n/config"

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

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

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

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

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

@@ -1,159 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

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

package/dist/test/setup.d.ts

@@ -1,2 +0,0 @@
-import "@testing-library/jest-dom";
-//# sourceMappingURL=setup.d.ts.map

package/dist/test/setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/test/setup.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAA"}

package/src/components/robots/RobotAnimator.test.tsx

@@ -1,113 +0,0 @@
-import type {
-  DHParameter,
-  MotionGroupStateResponse,
-} from "@wandelbots/nova-api/v1"
-import { describe, expect, it, vi } from "vitest"
-import RobotAnimator from "./RobotAnimator"
-
-// Mock the dependencies
-vi.mock("./robotModelLogic", () => ({
-  collectJoints: vi.fn(),
-}))
-
-vi.mock("../utils/interpolation", () => ({
-  ValueInterpolator: vi.fn().mockImplementation(() => ({
-    setTarget: vi.fn(),
-    getCurrentValues: vi.fn(() => []),
-    destroy: vi.fn(),
-  })),
-}))
-
-describe("RobotAnimator", () => {
-  it("should export the component correctly", () => {
-    expect(RobotAnimator).toBeDefined()
-    expect(typeof RobotAnimator).toBe("function")
-  })
-
-  it("should handle props with different numbers of joints", () => {
-    // Test that the component accepts different numbers of DH parameters
-    const mockMotionState4Joints: MotionGroupStateResponse = {
-      state: {
-        joint_position: {
-          joints: [0.1, 0.2, 0.3, 0.4],
-        },
-      },
-    } as any
-
-    const mockDHParameters4Joints: DHParameter[] = [
-      { theta: 0, reverse_rotation_direction: false },
-      { theta: 0, reverse_rotation_direction: false },
-      { theta: 0, reverse_rotation_direction: false },
-      { theta: 0, reverse_rotation_direction: false },
-    ]
-
-    const mockMotionState7Joints: MotionGroupStateResponse = {
-      state: {
-        joint_position: {
-          joints: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7],
-        },
-      },
-    } as any
-
-    const mockDHParameters7Joints: DHParameter[] = Array(7).fill({
-      theta: 0,
-      reverse_rotation_direction: false,
-    })
-
-    // These should not throw TypeScript errors
-    expect(() => {
-      const props4 = {
-        rapidlyChangingMotionState: mockMotionState4Joints,
-        dhParameters: mockDHParameters4Joints,
-        children: null,
-      }
-      // Verify props are correctly typed
-      expect(props4.dhParameters).toHaveLength(4)
-      expect(
-        props4.rapidlyChangingMotionState.state.joint_position.joints,
-      ).toHaveLength(4)
-    }).not.toThrow()
-
-    expect(() => {
-      const props7 = {
-        rapidlyChangingMotionState: mockMotionState7Joints,
-        dhParameters: mockDHParameters7Joints,
-        children: null,
-      }
-      expect(props7.dhParameters).toHaveLength(7)
-      expect(
-        props7.rapidlyChangingMotionState.state.joint_position.joints,
-      ).toHaveLength(7)
-    }).not.toThrow()
-  })
-
-  it("should use custom interpolation for smooth value transitions", () => {
-    // Test the rotation calculation logic
-    const dhParam1 = { theta: 0.1, reverse_rotation_direction: false }
-    const dhParam2 = { theta: -0.2, reverse_rotation_direction: true }
-    const jointValue1 = 0.5
-    const jointValue2 = 1.0
-
-    // Calculate expected rotations
-    const expectedRotation1 = 1 * jointValue1 + 0.1 // 0.6
-    const expectedRotation2 = -1 * jointValue2 + -0.2 // -1.2
-
-    expect(expectedRotation1).toBe(0.6)
-    expect(expectedRotation2).toBe(-1.2)
-
-    // Test edge cases
-    const dhParamReverse = { theta: 0, reverse_rotation_direction: true }
-    const jointValueZero = 0
-    const expectedRotationReverse = -1 * jointValueZero + 0 // 0
-
-    expect(expectedRotationReverse).toBe(0)
-
-    // Test rotation direction logic
-    const testValue = 1.5
-    const normalParam = { theta: 0, reverse_rotation_direction: false }
-    const reversedParam = { theta: 0, reverse_rotation_direction: true }
-
-    expect(1 * testValue + 0).toBe(1.5) // Normal direction
-    expect(-1 * testValue + 0).toBe(-1.5) // Reversed direction
-  })
-})