manim-web 0.2.0

package/dist/core/Mobject.d.ts

@@ -0,0 +1,488 @@
+import * as THREE from 'three';
+/**
+ * Vector3 type as a tuple for external API
+ */
+export type Vector3Tuple = [number, number, number];
+export declare const UP: Vector3Tuple;
+export declare const DOWN: Vector3Tuple;
+export declare const LEFT: Vector3Tuple;
+export declare const RIGHT: Vector3Tuple;
+export declare const OUT: Vector3Tuple;
+export declare const IN: Vector3Tuple;
+export declare const ORIGIN: Vector3Tuple;
+export declare const UL: Vector3Tuple;
+export declare const UR: Vector3Tuple;
+export declare const DL: Vector3Tuple;
+export declare const DR: Vector3Tuple;
+/**
+ * Updater function type that runs every frame
+ * @param mobject - The mobject being updated
+ * @param dt - Delta time in seconds since last frame
+ */
+export type UpdaterFunction = (mobject: Mobject, dt: number) => void;
+/**
+ * Style properties for mobjects
+ */
+export interface MobjectStyle {
+    fillColor?: string;
+    fillOpacity?: number;
+    strokeColor?: string;
+    strokeOpacity?: number;
+    strokeWidth?: number;
+}
+/**
+ * Base mathematical object class.
+ * All visible objects in manimweb inherit from this class.
+ */
+export declare abstract class Mobject {
+    /** Unique identifier for this mobject */
+    readonly id: string;
+    /** Parent mobject in hierarchy */
+    parent: Mobject | null;
+    /** Child mobjects */
+    children: Mobject[];
+    /** Position in 3D space */
+    position: THREE.Vector3;
+    /** Rotation as Euler angles */
+    rotation: THREE.Euler;
+    /** Scale factors (named scaleVector to avoid conflict with scale method) */
+    scaleVector: THREE.Vector3;
+    /** Color as CSS color string (syncs stroke and fill via setter) */
+    protected _color: string;
+    get color(): string;
+    set color(value: string);
+    /** Overall opacity (0-1) - protected for backward compatibility */
+    protected _opacity: number;
+    /** Stroke width for outlines (default 4, matching Manim's thicker strokes) */
+    strokeWidth: number;
+    /** Fill opacity (0-1) */
+    fillOpacity: number;
+    /** When true, children skip the 2D z-layering offset in _syncToThree.
+     *  Set this on 3D container objects (e.g. ThreeDAxes) where z-offsets
+     *  would shift objects away from their intended 3D positions. */
+    protected _disableChildZLayering: boolean;
+    /** Style properties for backward compatibility */
+    protected _style: MobjectStyle;
+    /** Three.js backing object */
+    _threeObject: THREE.Object3D | null;
+    /** Dirty flag indicating transforms need sync */
+    _dirty: boolean;
+    /** Updater functions that run every frame */
+    private _updaters;
+    /**
+     * Saved mobject copy (used by Restore animation in TransformExtensions).
+     * Set by saveState().
+     */
+    savedState: Mobject | null;
+    /**
+     * Target copy used by generateTarget() / MoveToTarget animation.
+     * Call generateTarget() to create a copy, modify targetCopy, then
+     * play MoveToTarget to interpolate from current to target state.
+     */
+    targetCopy: Mobject | null;
+    /**
+     * JSON-serializable saved state (used by restoreState()).
+     * Set by saveState() -- typed as `unknown` here to avoid circular import;
+     * actual type is MobjectState from StateManager.ts.
+     */
+    __savedMobjectState: unknown;
+    private static _idCounter;
+    private static _tempVec3;
+    private static _tempBox3;
+    private static _tempQuaternion;
+    constructor();
+    /**
+     * Get the overall opacity of the mobject
+     */
+    get opacity(): number;
+    /**
+     * Set the overall opacity of the mobject
+     */
+    set opacity(value: number);
+    /**
+     * Get the style properties
+     */
+    get style(): MobjectStyle;
+    /**
+     * Set style properties
+     */
+    setStyle(style: Partial<MobjectStyle>): this;
+    /**
+     * Get all submobjects (alias for children)
+     */
+    get submobjects(): Mobject[];
+    /**
+     * Translate the mobject by a delta
+     * @param delta - Translation vector [x, y, z]
+     * @returns this for chaining
+     */
+    shift(delta: Vector3Tuple): this;
+    /**
+     * Move the mobject to an absolute position, or align with another Mobject.
+     * @param target - Target position [x, y, z] or Mobject to align with
+     * @param alignedEdge - Optional edge direction to align (e.g., UL aligns upper-left edges)
+     * @returns this for chaining
+     */
+    moveTo(target: Vector3Tuple | Mobject, alignedEdge?: Vector3Tuple): this;
+    /**
+     * Rotate the mobject around an axis
+     * Uses object pooling to avoid allocations in hot paths (performance optimization).
+     * @param angle - Rotation angle in radians
+     * @param axisOrOptions - Axis of rotation [x, y, z] (defaults to Z axis), or options object
+     * @returns this for chaining
+     */
+    rotate(angle: number, axisOrOptions?: Vector3Tuple | {
+        axis?: Vector3Tuple;
+        aboutPoint?: Vector3Tuple;
+    }): this;
+    /**
+     * Rotate the mobject about the coordinate origin [0, 0, 0].
+     * @param angle - Rotation angle in radians
+     * @param axis - Axis of rotation (defaults to Z axis [0, 0, 1])
+     * @returns this for chaining
+     */
+    rotateAboutOrigin(angle: number, axis?: Vector3Tuple): this;
+    /**
+     * Flip the mobject along an axis (mirror reflection).
+     * @param axis - Axis to flip across, defaults to RIGHT ([1,0,0]) for horizontal flip
+     * @returns this for chaining
+     */
+    flip(axis?: Vector3Tuple): this;
+    /**
+     * Scale the mobject uniformly or non-uniformly
+     * @param factor - Scale factor (number for uniform, tuple for non-uniform)
+     * @returns this for chaining
+     */
+    scale(factor: number | Vector3Tuple): this;
+    /**
+     * Set the mobject's color
+     * Only marks dirty if value actually changed (performance optimization).
+     * @param color - CSS color string
+     * @returns this for chaining
+     */
+    setColor(color: string): this;
+    /**
+     * Set the mobject's overall opacity
+     * Only marks dirty if value actually changed (performance optimization).
+     * @param opacity - Opacity value (0-1)
+     * @returns this for chaining
+     */
+    setOpacity(opacity: number): this;
+    /**
+     * Set the stroke width for outlines
+     * Only marks dirty if value actually changed (performance optimization).
+     * @param width - Stroke width in pixels
+     * @returns this for chaining
+     */
+    setStrokeWidth(width: number): this;
+    /**
+     * Set the fill opacity
+     * Only marks dirty if value actually changed (performance optimization).
+     * @param opacity - Fill opacity (0-1)
+     * @returns this for chaining
+     */
+    setFillOpacity(opacity: number): this;
+    /**
+     * Set the fill color and/or opacity (Manim Python parity: set_fill)
+     * @param color - CSS color string (optional)
+     * @param opacity - Fill opacity 0-1 (optional)
+     * @returns this for chaining
+     */
+    setFill(color?: string, opacity?: number): this;
+    /**
+     * Get the fill color
+     */
+    get fillColor(): string | undefined;
+    /**
+     * Set the fill color
+     */
+    set fillColor(color: string);
+    /**
+     * Add a child mobject (supports multiple arguments for backward compatibility)
+     * @param mobjects - Child mobjects to add
+     * @returns this for chaining
+     */
+    add(...mobjects: Mobject[]): this;
+    /**
+     * Remove a child mobject (supports multiple arguments for backward compatibility)
+     * @param mobjects - Child mobjects to remove
+     * @returns this for chaining
+     */
+    remove(...mobjects: Mobject[]): this;
+    /**
+     * Create a deep copy of this mobject
+     * @returns New mobject with copied properties
+     */
+    copy(): Mobject;
+    /**
+     * Replace this mobject's visual properties with those of another mobject.
+     * Preserves identity (updaters, scene membership) but copies appearance.
+     * @param other - The mobject to copy appearance from
+     * @returns this for chaining
+     */
+    become(other: Mobject): this;
+    /**
+     * Scale and reposition this mobject to match another mobject's bounding box.
+     * Matches Manim Python's replace() behavior.
+     * @param target - The mobject whose bounding box to match
+     * @param stretch - If true, stretch per-axis to match exactly; if false (default), uniform scale to match width
+     * @returns this for chaining
+     */
+    replace(target: Mobject, stretch?: boolean): this;
+    /**
+     * Create a new instance for copying. Subclasses must implement this.
+     */
+    protected abstract _createCopy(): Mobject;
+    /**
+     * Get the center point of this mobject
+     * @returns Center position as [x, y, z]
+     */
+    getCenter(): Vector3Tuple;
+    /**
+     * Get the bounding box of this mobject in world coordinates.
+     * @returns Object with min and max Vector3Tuple
+     */
+    getBounds(): {
+        min: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        max: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    };
+    /**
+     * Position this mobject next to another mobject
+     * @param target The mobject to position next to
+     * @param direction Direction from target (e.g., RIGHT, UP)
+     * @param buff Buffer distance between mobjects, default 0.25
+     * @returns this for chaining
+     */
+    nextTo(target: Mobject | Vector3Tuple, direction?: Vector3Tuple, buff?: number): this;
+    /**
+     * Align this mobject with another along an edge
+     * @param target The mobject or point to align with
+     * @param direction The direction/edge to align (e.g., LEFT aligns left edges)
+     * @returns this for chaining
+     */
+    alignTo(target: Mobject | Vector3Tuple, direction: Vector3Tuple): this;
+    /**
+     * Move this mobject to align its center with a point or mobject center
+     * @param target Target mobject or point to align with
+     * @param alignedEdge Optional edge to align instead of centers
+     * @returns this for chaining
+     */
+    moveToAligned(target: Mobject | Vector3Tuple, alignedEdge?: Vector3Tuple): this;
+    /**
+     * Get the edge point of the bounding box in a direction
+     * @param direction Direction to get edge in
+     * @returns Edge point as [x, y, z]
+     */
+    _getEdgeInDirection(direction: Vector3Tuple): Vector3Tuple;
+    /**
+     * Get bounding box dimensions
+     * Uses object pooling to avoid allocations in hot paths (performance optimization).
+     * @returns Object with width, height, and depth
+     */
+    protected _getBoundingBox(): {
+        width: number;
+        height: number;
+        depth: number;
+    };
+    /**
+     * Get a specific edge point of the bounding box in a direction
+     * @param direction Direction to the edge point
+     * @returns Edge point as [x, y, z]
+     */
+    getEdge(direction: Vector3Tuple): Vector3Tuple;
+    /**
+     * Get the top edge center
+     * @returns Top edge center as [x, y, z]
+     */
+    getTop(): Vector3Tuple;
+    /**
+     * Get the bottom edge center
+     * @returns Bottom edge center as [x, y, z]
+     */
+    getBottom(): Vector3Tuple;
+    /**
+     * Get the left edge center
+     * @returns Left edge center as [x, y, z]
+     */
+    getLeft(): Vector3Tuple;
+    /**
+     * Get the right edge center
+     * @returns Right edge center as [x, y, z]
+     */
+    getRight(): Vector3Tuple;
+    /**
+     * Set the x-coordinate of this mobject's center, preserving y and z.
+     * Matches Manim Python's set_x() behavior.
+     */
+    setX(x: number): this;
+    /**
+     * Set the y-coordinate of this mobject's center, preserving x and z.
+     * Matches Manim Python's set_y() behavior.
+     */
+    setY(y: number): this;
+    /**
+     * Set the z-coordinate of this mobject's center, preserving x and y.
+     * Matches Manim Python's set_z() behavior.
+     */
+    setZ(z: number): this;
+    /**
+     * Center this mobject at origin
+     * @returns this for chaining
+     */
+    center(): this;
+    /**
+     * Move to the edge of the frame
+     * @param direction Direction to move towards
+     * @param buff Buffer from edge
+     * @returns this for chaining
+     */
+    toEdge(direction: Vector3Tuple, buff?: number): this;
+    /**
+     * Move to a corner of the frame
+     * @param direction Corner direction (e.g., UR for upper right)
+     * @param buff Buffer from edges
+     * @returns this for chaining
+     */
+    toCorner(direction?: Vector3Tuple, buff?: number): this;
+    /**
+     * Sync transform properties to the Three.js object
+     */
+    _syncToThree(): void;
+    /**
+     * Sync material-specific properties. Override in subclasses.
+     */
+    protected _syncMaterialToThree(): void;
+    /**
+     * Mark this mobject as needing sync
+     */
+    _markDirty(): void;
+    /**
+     * Mark this mobject and all ancestors as needing sync.
+     * Use when a deep child's geometry changes and the parent tree must re-traverse.
+     * Short-circuits if this node is already dirty (ancestors must be dirty too).
+     */
+    _markDirtyUpward(): void;
+    /**
+     * Check if this mobject needs sync
+     */
+    get isDirty(): boolean;
+    /**
+     * Get the Three.js object, creating it if necessary
+     */
+    getThreeObject(): THREE.Object3D;
+    /**
+     * Create the Three.js backing object. Subclasses must implement.
+     */
+    protected abstract _createThreeObject(): THREE.Object3D;
+    /**
+     * Apply a function to this mobject and all descendants
+     */
+    applyToFamily(func: (mobject: Mobject) => void): this;
+    /**
+     * Get all mobjects in the family (this mobject and all descendants)
+     */
+    getFamily(): Mobject[];
+    /**
+     * Add an updater function that runs every frame
+     * @param updater Function called with (mobject, dt) each frame
+     * @param callOnAdd Whether to call immediately, default false
+     * @returns this for chaining
+     */
+    addUpdater(updater: UpdaterFunction, callOnAdd?: boolean): this;
+    /**
+     * Remove an updater function
+     * @param updater The updater function to remove
+     * @returns this for chaining
+     */
+    removeUpdater(updater: UpdaterFunction): this;
+    /**
+     * Remove all updaters
+     * @returns this for chaining
+     */
+    clearUpdaters(): this;
+    /**
+     * Check if this mobject has any updaters
+     * @returns true if the mobject has updaters
+     */
+    hasUpdaters(): boolean;
+    /**
+     * Get all updaters (for internal use)
+     * @returns A copy of the updaters array
+     */
+    getUpdaters(): UpdaterFunction[];
+    /**
+     * Run all updaters with given dt
+     * Called by Scene during render loop
+     * @param dt Delta time in seconds since last frame
+     */
+    update(dt: number): void;
+    /**
+     * Apply a point-wise function to every VMobject descendant's control points.
+     * Uses duck-type check for getPoints/setPoints to avoid circular imports.
+     * @param fn - Function mapping [x, y, z] to [x', y', z']
+     * @returns this for chaining
+     */
+    applyFunction(fn: (point: number[]) => number[]): this;
+    /**
+     * Subdivide every VMobject descendant's cubic Bezier curves so that non-linear
+     * transforms produce smooth results. Each cubic segment is split into n sub-segments
+     * via de Casteljau evaluation.
+     * @param numPieces - Number of sub-segments per original cubic segment (default 50)
+     * @returns this for chaining
+     */
+    prepareForNonlinearTransform(numPieces?: number): this;
+    /**
+     * Create a copy of this mobject as a target for MoveToTarget animation.
+     * Modify the returned copy, then play `new MoveToTarget(this)` to
+     * smoothly interpolate from the current state to the target.
+     *
+     * @returns The target copy for modification
+     *
+     * @example
+     * ```ts
+     * mob.generateTarget();
+     * mob.targetCopy!.shift([2, 0, 0]);
+     * mob.targetCopy!.setColor('red');
+     * await scene.play(new MoveToTarget(mob));
+     * ```
+     */
+    generateTarget(): Mobject;
+    /**
+     * Save the current state of this mobject so it can be restored later.
+     * Stores a deep copy on `this.savedState` (for Restore animation
+     * compatibility) and a serializable snapshot on `this.__savedMobjectState`
+     * (for restoreState).
+     *
+     * @returns this for chaining
+     *
+     * @example
+     * ```ts
+     * mob.saveState();
+     * mob.shift([2, 0, 0]);
+     * mob.setColor('red');
+     * mob.restoreState(); // back to original position and color
+     * ```
+     */
+    saveState(): this;
+    /**
+     * Restore this mobject to its previously saved state (from saveState).
+     * Uses the deep copy stored on `this.savedState` to restore all properties.
+     *
+     * @returns true if state was restored, false if no saved state exists
+     */
+    restoreState(): boolean;
+    /**
+     * Clean up Three.js resources.
+     */
+    dispose(): void;
+}
+export default Mobject;
+//# sourceMappingURL=Mobject.d.ts.map

package/dist/core/Mobject.d.ts.map

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

package/dist/core/Renderer.d.ts

@@ -0,0 +1,84 @@
+import * as THREE from 'three';
+/**
+ * Options for configuring the Renderer.
+ */
+export interface RendererOptions {
+    /** Canvas width in pixels. Defaults to container width. */
+    width?: number;
+    /** Canvas height in pixels. Defaults to container height. */
+    height?: number;
+    /** Background color as CSS color string. Defaults to '#000000'. */
+    backgroundColor?: string;
+    /** Enable antialiasing. Defaults to true. */
+    antialias?: boolean;
+    /** Device pixel ratio. Defaults to window.devicePixelRatio (capped at 2x for performance). */
+    pixelRatio?: number;
+    /** GPU power preference. Defaults to 'high-performance'. */
+    powerPreference?: 'default' | 'high-performance' | 'low-power';
+    /** Enable alpha channel. Defaults to false. */
+    alpha?: boolean;
+    /** Preserve drawing buffer for export. Defaults to true for video/image export support. */
+    preserveDrawingBuffer?: boolean;
+    /** Existing canvas element to reuse. If not provided, a new canvas is created. */
+    canvas?: HTMLCanvasElement;
+}
+/**
+ * Three.js WebGLRenderer wrapper for manimweb.
+ * Handles canvas creation, rendering, and lifecycle management.
+ */
+export declare class Renderer {
+    private _renderer;
+    private _width;
+    private _height;
+    private _backgroundColor;
+    /**
+     * Create a new Renderer and append it to the container.
+     * @param container - DOM element to append the canvas to
+     * @param options - Renderer configuration options
+     */
+    constructor(container: HTMLElement, options?: RendererOptions);
+    /**
+     * Get the current width.
+     */
+    get width(): number;
+    /**
+     * Get the current height.
+     */
+    get height(): number;
+    /**
+     * Get the background color.
+     */
+    get backgroundColor(): THREE.Color;
+    /**
+     * Set the background color.
+     */
+    set backgroundColor(color: THREE.Color | string);
+    /**
+     * Render a frame.
+     * @param scene - Three.js scene to render
+     * @param camera - Three.js camera to use
+     */
+    render(scene: THREE.Scene, camera: THREE.Camera): void;
+    /**
+     * Handle resize events.
+     * @param width - New width in pixels
+     * @param height - New height in pixels
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Get the underlying canvas element.
+     * @returns The HTMLCanvasElement used for rendering
+     */
+    getCanvas(): HTMLCanvasElement;
+    /**
+     * Get the underlying Three.js WebGLRenderer.
+     * @returns The WebGLRenderer instance
+     */
+    getThreeRenderer(): THREE.WebGLRenderer;
+    /**
+     * Clean up resources.
+     * Removes canvas from DOM and disposes WebGL resources.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=Renderer.d.ts.map

package/dist/core/Renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../src/core/Renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,SAAS,GAAG,kBAAkB,GAAG,WAAW,CAAC;IAC/D,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2FAA2F;IAC3F,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kFAAkF;IAClF,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAc;IAEtC;;;;OAIG;gBACS,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,eAAoB;IAqCjE;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,KAAK,CAAC,KAAK,CAEjC;IAED;;OAEG;IACH,IAAI,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,MAAM,EAG9C;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI;IAItD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3C;;;OAGG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;;OAGG;IACH,gBAAgB,IAAI,KAAK,CAAC,aAAa;IAIvC;;;OAGG;IACH,OAAO,IAAI,IAAI;CAOhB"}