manim-web 0.2.0

package/dist/integrations/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

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

package/dist/integrations/react.d.ts

@@ -0,0 +1,144 @@
+import { ReactNode, RefObject, DependencyList, CSSProperties, ReactElement } from 'react';
+import { Scene, SceneOptions, Mobject, Animation } from '../index';
+export * from '../index';
+/**
+ * Hook to create and manage a ManimWeb scene
+ * @param containerRef - Reference to the container element
+ * @param options - Scene configuration options
+ * @returns The created Scene instance or null if not ready
+ */
+export declare function useScene(containerRef: RefObject<HTMLElement | null>, options?: SceneOptions): Scene | null;
+/**
+ * Hook to manage mobjects in a scene
+ * @param scene - The scene to add the mobject to
+ * @param createMobject - Factory function to create the mobject
+ * @param deps - Dependencies that trigger mobject recreation
+ * @returns The created mobject or null if not ready
+ */
+export declare function useMobject<T extends Mobject>(scene: Scene | null, createMobject: () => T, deps?: DependencyList): T | null;
+/**
+ * Hook to play animations with loading state tracking
+ * @param scene - The scene to play animations in
+ * @returns Object with play, playAll functions and isPlaying state
+ */
+export declare function useAnimation(scene: Scene | null): {
+    play: (...animations: Animation[]) => Promise<void>;
+    playAll: (...animations: Animation[]) => Promise<void>;
+    isPlaying: boolean;
+};
+/**
+ * Props for ManimScene component
+ */
+export interface ManimSceneProps {
+    /** Canvas width in pixels. Defaults to 800. */
+    width?: number;
+    /** Canvas height in pixels. Defaults to 450. */
+    height?: number;
+    /** Background color as CSS color string. Defaults to '#1a1a2e'. */
+    backgroundColor?: string;
+    /** Callback when scene is ready */
+    onSceneReady?: (scene: Scene) => void;
+    /** Child elements to render (overlay content) */
+    children?: ReactNode;
+    /** CSS class name for the container */
+    className?: string;
+    /** Inline styles for the container */
+    style?: CSSProperties;
+}
+/**
+ * React component that wraps a ManimWeb scene
+ *
+ * @example
+ * ```tsx
+ * <ManimScene
+ *   width={800}
+ *   height={450}
+ *   onSceneReady={async (scene) => {
+ *     const circle = new Circle({ radius: 1, color: '#ff0000' });
+ *     scene.add(circle);
+ *     await scene.play(new FadeIn(circle));
+ *   }}
+ * />
+ * ```
+ */
+export declare function ManimScene({ width, height, backgroundColor, onSceneReady, children, className, style, }: ManimSceneProps): ReactElement;
+/**
+ * Context for sharing scene across components
+ */
+export declare const SceneContext: import('react').Context<Scene | null>;
+/**
+ * Hook to access the scene from context
+ * @returns The scene from context or null
+ */
+export declare function useSceneContext(): Scene | null;
+/**
+ * Props for ManimProvider component
+ */
+export interface ManimProviderProps {
+    /** Child components that can access the scene via useSceneContext */
+    children: ReactNode;
+    /** Canvas width in pixels. Defaults to 800. */
+    width?: number;
+    /** Canvas height in pixels. Defaults to 450. */
+    height?: number;
+    /** Background color as CSS color string. Defaults to '#1a1a2e'. */
+    backgroundColor?: string;
+    /** CSS class name for the container */
+    className?: string;
+    /** Inline styles for the container */
+    style?: CSSProperties;
+}
+/**
+ * Provider component that creates a scene and shares it via context
+ *
+ * @example
+ * ```tsx
+ * <ManimProvider width={800} height={450}>
+ *   <MyAnimationComponent />
+ * </ManimProvider>
+ *
+ * function MyAnimationComponent() {
+ *   const scene = useSceneContext();
+ *   // Use scene to add mobjects and play animations
+ * }
+ * ```
+ */
+export declare function ManimProvider({ children, width, height, backgroundColor, className, style, }: ManimProviderProps): ReactElement;
+/**
+ * Hook to use updaters with React state
+ * Automatically adds/removes the updater when dependencies change
+ *
+ * @param mobject - The mobject to add the updater to
+ * @param updater - The updater function (receives mobject and dt)
+ * @param deps - Dependencies that trigger updater recreation
+ *
+ * @example
+ * ```tsx
+ * const circle = useMobject(scene, () => new Circle({ radius: 1 }));
+ *
+ * useUpdater(circle, (m, dt) => {
+ *   m.rotate(dt * Math.PI); // Rotate continuously
+ * });
+ * ```
+ */
+export declare function useUpdater(mobject: Mobject | null, updater: (m: Mobject, dt: number) => void, deps?: DependencyList): void;
+/**
+ * Hook to wait for a duration within an async effect
+ * @param scene - The scene to use for waiting
+ * @returns A wait function that returns a promise
+ */
+export declare function useWait(scene: Scene | null): (duration: number) => Promise<void>;
+/**
+ * Hook to get scene playback controls
+ * @param scene - The scene to control
+ * @returns Playback control functions and state
+ */
+export declare function usePlaybackControls(scene: Scene | null): {
+    pause: () => void;
+    resume: () => void;
+    stop: () => void;
+    seek: (time: number) => void;
+    isPlaying: boolean;
+    currentTime: number;
+};
+//# sourceMappingURL=react.d.ts.map

package/dist/integrations/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/integrations/react.tsx"],"names":[],"mappings":"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"}