manim-web 0.2.0

package/dist/animation/utility/index.d.ts

@@ -0,0 +1,171 @@
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+import { Animation, AnimationOptions } from '../Animation';
+export interface AddOptions extends AnimationOptions {
+}
+/**
+ * Instant animation that adds a mobject to the scene.
+ * Duration is 0 - just marks the mobject as visible at animation time.
+ * Useful for sequencing when you want to add objects at specific points in a timeline.
+ */
+export declare class Add extends Animation {
+    constructor(mobject: Mobject, options?: AddOptions);
+    /**
+     * Set up the animation - ensure mobject is visible
+     */
+    begin(): void;
+    /**
+     * No interpolation needed for instant add
+     */
+    interpolate(_alpha: number): void;
+}
+/**
+ * Create an Add animation for a mobject.
+ * Instantly adds/shows the mobject at the scheduled time.
+ * @param mobject The mobject to add
+ * @param options Animation options
+ */
+export declare function add(mobject: Mobject, options?: AddOptions): Add;
+export interface RemoveOptions extends AnimationOptions {
+}
+/**
+ * Instant animation that removes a mobject from visibility.
+ * Duration is 0 - just marks the mobject as invisible at animation time.
+ * Note: This doesn't remove from the scene, it sets opacity to 0.
+ * For actual scene removal, use scene.remove() directly.
+ */
+export declare class Remove extends Animation {
+    constructor(mobject: Mobject, options?: RemoveOptions);
+    /**
+     * Set up the animation - hide the mobject
+     */
+    begin(): void;
+    /**
+     * No interpolation needed for instant remove
+     */
+    interpolate(_alpha: number): void;
+}
+/**
+ * Create a Remove animation for a mobject.
+ * Instantly hides the mobject at the scheduled time.
+ * @param mobject The mobject to remove/hide
+ * @param options Animation options
+ */
+export declare function remove(mobject: Mobject, options?: RemoveOptions): Remove;
+export interface WaitOptions extends AnimationOptions {
+    /** Duration to wait in seconds. Default: 1 */
+    duration?: number;
+}
+/**
+ * Wait/pause animation that holds for a specified duration.
+ * No visual change occurs - useful for timing and sequencing.
+ */
+export declare class Wait extends Animation {
+    constructor(mobject: Mobject, options?: WaitOptions);
+    /**
+     * No interpolation - just wait
+     */
+    interpolate(_alpha: number): void;
+}
+/**
+ * Create a Wait animation.
+ * Pauses for the specified duration with no visual change.
+ * @param mobject A mobject (required by Animation base, but not modified)
+ * @param duration Duration to wait in seconds (default: 1)
+ * @param options Additional animation options
+ */
+export declare function wait(mobject: Mobject, duration?: number, options?: Omit<WaitOptions, 'duration'>): Wait;
+export interface RotatingOptions extends AnimationOptions {
+    /** Total angle to rotate in radians. Default: 2*PI (full revolution, matching Manim's TAU) */
+    angle?: number;
+    /** Axis of rotation [x, y, z]. Default: Z axis [0, 0, 1] */
+    axis?: Vector3Tuple;
+    /** Point to rotate about. Default: mobject center */
+    aboutPoint?: Vector3Tuple;
+}
+/**
+ * Continuous rotation animation that rotates by a total angle over the duration.
+ * Matches Manim Python's Rotating: default angle=TAU (full revolution),
+ * default run_time=5, default rate_func=linear.
+ */
+export declare class Rotating extends Animation {
+    /** Total angle to rotate in radians */
+    readonly angle: number;
+    /** Axis of rotation */
+    readonly axis: Vector3Tuple;
+    /** Point to rotate about */
+    readonly aboutPoint: Vector3Tuple | null;
+    /** Initial rotation stored as quaternion */
+    private _initialQuaternion;
+    /** Initial position (for rotation about a point) */
+    private _initialPosition;
+    /** Rotation axis as THREE.Vector3 */
+    private _axisVector;
+    /** About point as THREE.Vector3 */
+    private _aboutPointVector;
+    constructor(mobject: Mobject, options?: RotatingOptions);
+    /**
+     * Set up the animation - store initial state
+     */
+    begin(): void;
+    /**
+     * Interpolate the rotation at the given alpha
+     * Total rotation = angle * alpha (at alpha=1, full angle is reached)
+     */
+    interpolate(alpha: number): void;
+}
+/**
+ * Create a Rotating animation for a mobject.
+ * Rotates the mobject by the specified angle over the animation duration.
+ * @param mobject The mobject to rotate
+ * @param options Rotating options (angle, axis, aboutPoint, duration)
+ */
+export declare function rotating(mobject: Mobject, options?: RotatingOptions): Rotating;
+export interface BroadcastOptions extends AnimationOptions {
+    /** Color of the broadcast rings. Default: YELLOW */
+    color?: string;
+    /** Number of rings to broadcast. Default: 3 */
+    numRings?: number;
+    /** Maximum radius the rings expand to. Default: 2 */
+    maxRadius?: number;
+    /** Stroke width of rings. Default: DEFAULT_STROKE_WIDTH */
+    strokeWidth?: number;
+    /** Time offset between rings (0-1). Default: 0.3 */
+    lagRatio?: number;
+}
+/**
+ * Broadcast/ripple animation that creates expanding rings from the mobject center.
+ * Useful for emphasis or drawing attention to an object.
+ * Rings expand outward and fade as they grow.
+ */
+export declare class Broadcast extends Animation {
+    /** Ring color */
+    readonly ringColor: string;
+    /** Number of rings */
+    readonly numRings: number;
+    /** Maximum radius */
+    readonly maxRadius: number;
+    /** Stroke width */
+    readonly strokeWidth: number;
+    /** Lag ratio between rings */
+    readonly lagRatio: number;
+    /** Rings group */
+    private _ringsGroup;
+    /** Parent object */
+    private _parentObject;
+    /** Center point */
+    private _center;
+    constructor(mobject: Mobject, options?: BroadcastOptions);
+    begin(): void;
+    private _createRing;
+    private _updateRing;
+    interpolate(alpha: number): void;
+    finish(): void;
+}
+/**
+ * Create a Broadcast animation for a mobject.
+ * Creates expanding rings that radiate from the mobject's center.
+ * @param mobject The mobject to broadcast from
+ * @param options Broadcast options (color, numRings, maxRadius, strokeWidth, lagRatio)
+ */
+export declare function broadcast(mobject: Mobject, options?: BroadcastOptions): Broadcast;
+//# sourceMappingURL=index.d.ts.map

package/dist/animation/utility/index.d.ts.map

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

package/dist/constants/colors.d.ts

@@ -0,0 +1,72 @@
+export declare const WHITE = "#FFFFFF";
+export declare const GRAY_A = "#DDDDDD";
+export declare const GRAY_B = "#BBBBBB";
+export declare const GRAY_C = "#888888";
+export declare const GRAY_D = "#444444";
+export declare const GRAY_E = "#222222";
+export declare const BLACK = "#000000";
+export declare const LIGHTER_GRAY = "#DDDDDD";
+export declare const LIGHT_GRAY = "#BBBBBB";
+export declare const GRAY = "#888888";
+export declare const DARK_GRAY = "#444444";
+export declare const DARKER_GRAY = "#222222";
+export declare const BLUE_A = "#C7E9F1";
+export declare const BLUE_B = "#9CDCEB";
+export declare const BLUE_C = "#58C4DD";
+export declare const BLUE_D = "#29ABCA";
+export declare const BLUE_E = "#236B8E";
+export declare const PURE_BLUE = "#0000FF";
+export declare const BLUE = "#58C4DD";
+export declare const DARK_BLUE = "#236B8E";
+export declare const TEAL_A = "#ACEAD7";
+export declare const TEAL_B = "#76DDC0";
+export declare const TEAL_C = "#5CD0B3";
+export declare const TEAL_D = "#55C1A7";
+export declare const TEAL_E = "#49A88F";
+export declare const TEAL = "#5CD0B3";
+export declare const GREEN_A = "#C9E2AE";
+export declare const GREEN_B = "#A6CF8C";
+export declare const GREEN_C = "#83C167";
+export declare const GREEN_D = "#77B05D";
+export declare const GREEN_E = "#699C52";
+export declare const PURE_GREEN = "#00FF00";
+export declare const GREEN = "#83C167";
+export declare const YELLOW_A = "#FFF1B6";
+export declare const YELLOW_B = "#FFEA94";
+export declare const YELLOW_C = "#FFFF00";
+export declare const YELLOW_D = "#F4D345";
+export declare const YELLOW_E = "#E8C11C";
+export declare const YELLOW = "#FFFF00";
+export declare const GOLD_A = "#F7C797";
+export declare const GOLD_B = "#F9B775";
+export declare const GOLD_C = "#F0AC5F";
+export declare const GOLD_D = "#E1A158";
+export declare const GOLD_E = "#C78D46";
+export declare const GOLD = "#F0AC5F";
+export declare const RED_A = "#F7A1A3";
+export declare const RED_B = "#FF8080";
+export declare const RED_C = "#FC6255";
+export declare const RED_D = "#E65A4C";
+export declare const RED_E = "#CF5044";
+export declare const PURE_RED = "#FF0000";
+export declare const RED = "#FC6255";
+export declare const MAROON_A = "#ECABC1";
+export declare const MAROON_B = "#EC92AB";
+export declare const MAROON_C = "#C55F73";
+export declare const MAROON_D = "#A24D61";
+export declare const MAROON_E = "#94424F";
+export declare const MAROON = "#C55F73";
+export declare const PURPLE_A = "#CAA3E8";
+export declare const PURPLE_B = "#B189C6";
+export declare const PURPLE_C = "#9A72AC";
+export declare const PURPLE_D = "#715582";
+export declare const PURPLE_E = "#644172";
+export declare const PURPLE = "#9A72AC";
+export declare const PINK = "#D147BD";
+export declare const LIGHT_PINK = "#DC75CD";
+export declare const ORANGE = "#FF862F";
+export declare const LIGHT_BROWN = "#CD853F";
+export declare const DARK_BROWN = "#8B4513";
+export declare const MANIM_BACKGROUND = "#1C1C1C";
+export type ManimColor = string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/constants/colors.d.ts.map

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

package/dist/constants/colors.test.d.ts

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

package/dist/constants/colors.test.d.ts.map

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

package/dist/constants/directions.test.d.ts

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

package/dist/constants/directions.test.d.ts.map

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

package/dist/constants/index.d.ts

@@ -0,0 +1,16 @@
+export * from './colors';
+export declare const DEFAULT_STROKE_WIDTH = 4;
+export declare const DEFAULT_FONT_SIZE = 48;
+export declare const DEFAULT_ANIMATION_DURATION = 1;
+export declare const DEFAULT_FRAME_WIDTH = 14.222;
+export declare const DEFAULT_FRAME_HEIGHT = 8;
+export declare const DEFAULT_PIXEL_WIDTH = 1920;
+export declare const DEFAULT_PIXEL_HEIGHT = 1080;
+export declare const DEFAULT_FPS = 60;
+export declare const SMALL_BUFF = 0.1;
+export declare const MED_SMALL_BUFF = 0.25;
+export declare const MED_LARGE_BUFF = 0.5;
+export declare const LARGE_BUFF = 1;
+export declare const DEFAULT_MOBJECT_TO_EDGE_BUFFER = 0.5;
+export declare const DEFAULT_MOBJECT_TO_MOBJECT_BUFFER = 0.25;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AAGzB,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,WAAW,KAAK,CAAC;AAG9B,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,8BAA8B,MAAiB,CAAC;AAC7D,eAAO,MAAM,iCAAiC,OAAiB,CAAC"}

package/dist/core/AudioManager.d.ts

@@ -0,0 +1,203 @@
+import { Animation } from '../animation/Animation';
+/**
+ * Options when adding a sound to the audio manager.
+ */
+export interface AddSoundOptions {
+    /** Absolute time (in seconds) when the sound should start playing. Defaults to 0. */
+    time?: number;
+    /** Volume gain (0 = silent, 1 = full). Defaults to 1. */
+    gain?: number;
+    /** Whether to loop the clip. Defaults to false. */
+    loop?: boolean;
+    /** Fade-in duration in seconds. Defaults to 0. */
+    fadeIn?: number;
+    /** Fade-out duration in seconds. Defaults to 0. */
+    fadeOut?: number;
+    /** Offset into the audio buffer to start playback from (seconds). Defaults to 0. */
+    offset?: number;
+    /** Duration to play (seconds). Defaults to the full buffer length. */
+    duration?: number;
+}
+/**
+ * Represents a single audio clip scheduled on the timeline.
+ */
+export interface AudioTrack {
+    /** Unique identifier for this track. */
+    id: number;
+    /** URL the audio was loaded from. */
+    url: string;
+    /** Decoded audio buffer (null until loaded). */
+    buffer: AudioBuffer | null;
+    /** When the track starts on the timeline (seconds). */
+    startTime: number;
+    /** How long the clip plays (seconds). Derived from buffer or explicit option. */
+    duration: number;
+    /** Volume gain [0, 1]. */
+    gain: number;
+    /** Whether the clip loops. */
+    loop: boolean;
+    /** Fade-in duration (seconds). */
+    fadeIn: number;
+    /** Fade-out duration (seconds). */
+    fadeOut: number;
+    /** Offset into the buffer (seconds). */
+    offset: number;
+    /** Whether this track is currently playing. */
+    playing: boolean;
+    /** Whether this track is paused. */
+    paused: boolean;
+}
+/**
+ * Manages audio playback synchronized with the manim-js Scene timeline.
+ *
+ * Usage:
+ * ```ts
+ * const audio = new AudioManager();
+ * await audio.addSound('/sounds/click.wav', { time: 0.5 });
+ * audio.play();             // start playback
+ * audio.seek(2.0);          // jump to 2 s
+ * const wav = await audio.exportWAV();
+ * ```
+ */
+export declare class AudioManager {
+    private _ctx;
+    private _masterGain;
+    private _tracks;
+    private _nextId;
+    private _bufferCache;
+    private _isPlaying;
+    private _startedAt;
+    private _pauseOffset;
+    private _activeSources;
+    private _activeGains;
+    /**
+     * Lazily create (or resume) the AudioContext.
+     * Must be triggered by a user gesture in most browsers.
+     */
+    private _ensureContext;
+    /**
+     * Get the underlying AudioContext (creates one if needed).
+     */
+    get context(): AudioContext;
+    /**
+     * Load and decode an audio file, with caching.
+     * @param url - URL of the audio resource
+     * @returns Decoded AudioBuffer
+     */
+    loadBuffer(url: string): Promise<AudioBuffer>;
+    /**
+     * Add a sound to the timeline.
+     *
+     * @param url - URL of the audio file
+     * @param options - Scheduling and playback options
+     * @returns The created AudioTrack (buffer may still be loading)
+     */
+    addSound(url: string, options?: AddSoundOptions): Promise<AudioTrack>;
+    /**
+     * Add a sound that starts when a given animation begins on the timeline.
+     *
+     * The animation must already be scheduled (i.e. have a non-null `startTime`).
+     * If the animation has not been scheduled yet, `time` falls back to 0.
+     *
+     * @param animation - Animation whose start time to sync with
+     * @param url - URL of the audio file
+     * @param options - Additional options (time is overridden by animation)
+     * @returns The created AudioTrack
+     */
+    addSoundAtAnimation(animation: Animation, url: string, options?: Omit<AddSoundOptions, 'time'> & {
+        timeOffset?: number;
+    }): Promise<AudioTrack>;
+    /**
+     * Start (or resume) audio playback from the current position.
+     */
+    play(): void;
+    /**
+     * Pause audio playback, remembering the current position.
+     */
+    pause(): void;
+    /**
+     * Seek to an absolute time on the timeline (seconds).
+     * If currently playing, audio restarts from the new position.
+     */
+    seek(time: number): void;
+    /**
+     * Stop playback and reset to the beginning.
+     */
+    stop(): void;
+    /**
+     * Get the current playback position on the timeline (seconds).
+     */
+    getCurrentTime(): number;
+    /**
+     * Set the master output volume.
+     * @param value - Gain value (0 = silent, 1 = unity)
+     */
+    setGlobalGain(value: number): void;
+    /**
+     * Set the gain for a specific track.
+     * @param trackId - Track identifier
+     * @param value - Gain value (0 = silent, 1 = unity)
+     */
+    setTrackGain(trackId: number, value: number): void;
+    /**
+     * Remove a track by id.
+     */
+    removeTrack(trackId: number): void;
+    /**
+     * Remove all tracks and stop playback.
+     */
+    clearTracks(): void;
+    /**
+     * Get a readonly copy of the current track list.
+     */
+    get tracks(): ReadonlyArray<AudioTrack>;
+    /**
+     * Whether audio is currently playing.
+     */
+    get isPlaying(): boolean;
+    /**
+     * Get the total duration of the audio timeline (end of the latest track).
+     */
+    getDuration(): number;
+    /**
+     * Render all audio tracks into a single stereo AudioBuffer (offline).
+     *
+     * @param duration - Total duration to render (seconds). Defaults to getDuration().
+     * @param sampleRate - Output sample rate. Defaults to 44100.
+     * @returns Mixed-down AudioBuffer
+     */
+    mixdown(duration?: number, sampleRate?: number): Promise<AudioBuffer>;
+    /**
+     * Export all audio tracks as a WAV Blob.
+     *
+     * @param duration - Total duration (seconds). Defaults to getDuration().
+     * @param sampleRate - Sample rate. Defaults to 44100.
+     * @returns WAV Blob
+     */
+    exportWAV(duration?: number, sampleRate?: number): Promise<Blob>;
+    /**
+     * Get an AudioNode destination suitable for muxing with a MediaRecorder.
+     * This creates a MediaStreamAudioDestinationNode that can be combined with
+     * a video stream for video+audio export.
+     *
+     * @returns MediaStreamAudioDestinationNode connected to the master gain
+     */
+    createStreamDestination(): MediaStreamAudioDestinationNode;
+    /**
+     * Encode an AudioBuffer as a WAV Blob (PCM 16-bit).
+     */
+    static audioBufferToWAV(buffer: AudioBuffer): Blob;
+    /**
+     * Release all audio resources.
+     */
+    dispose(): void;
+    /**
+     * Schedule all tracks from the current timeline position.
+     */
+    private _scheduleAllTracks;
+    /**
+     * Stop and disconnect all currently playing source nodes.
+     */
+    private _stopAllSources;
+}
+//# sourceMappingURL=AudioManager.d.ts.map

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

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

package/dist/core/Camera.d.ts

@@ -0,0 +1,172 @@
+import { Camera2DFrame } from './Camera2DFrame';
+import * as THREE from 'three';
+/**
+ * Options for configuring a Camera3D.
+ */
+export interface Camera3DOptions {
+    /** Field of view in degrees. Defaults to 45. */
+    fov?: number;
+    /** Near clipping plane. Defaults to 0.1. */
+    near?: number;
+    /** Far clipping plane. Defaults to 1000. */
+    far?: number;
+    /** Initial camera position [x, y, z]. Defaults to [0, 0, 10]. */
+    position?: [number, number, number];
+    /** Initial look-at target [x, y, z]. Defaults to origin [0, 0, 0]. */
+    lookAt?: [number, number, number];
+}
+/**
+ * 3D camera for manimweb scenes.
+ * Wraps Three.js PerspectiveCamera with orbit controls support.
+ */
+export declare class Camera3D {
+    private _camera;
+    private _fov;
+    private _position;
+    private _lookAt;
+    /**
+     * Create a new 3D camera.
+     * @param aspectRatio - Width / height ratio. Defaults to 16/9.
+     * @param options - Camera configuration options
+     */
+    constructor(aspectRatio?: number, options?: Camera3DOptions);
+    /**
+     * Get the underlying Three.js PerspectiveCamera.
+     * @returns The PerspectiveCamera instance
+     */
+    getCamera(): THREE.PerspectiveCamera;
+    /**
+     * Get the camera position.
+     */
+    get position(): THREE.Vector3;
+    /**
+     * Get the look-at target.
+     */
+    get lookAtTarget(): THREE.Vector3;
+    /**
+     * Get the field of view.
+     */
+    get fov(): number;
+    /**
+     * Move the camera to a specific position.
+     * @param position - Target position [x, y, z]
+     * @returns this for chaining
+     */
+    moveTo(position: [number, number, number]): this;
+    /**
+     * Set the look-at target.
+     * @param target - Target point [x, y, z]
+     * @returns this for chaining
+     */
+    setLookAt(target: [number, number, number]): this;
+    /**
+     * Set the field of view.
+     * @param fov - Field of view in degrees
+     * @returns this for chaining
+     */
+    setFov(fov: number): this;
+    /**
+     * Update the aspect ratio.
+     * @param ratio - Width / height ratio
+     * @returns this for chaining
+     */
+    setAspectRatio(ratio: number): this;
+    /**
+     * Orbit the camera around the look-at point using Python Manim convention.
+     * Manim rotation: R = Rx(-phi) @ Rz(-theta - PI/2), applied to scene points.
+     * Camera position in Manim space: (d*sin(phi)*cos(theta), d*sin(phi)*sin(theta), d*cos(phi))
+     * @param phi - Polar angle from Z axis (0 = top, PI/2 = side, PI = bottom)
+     * @param theta - Azimuthal angle around Z axis
+     * @param distance - Optional distance from look-at point
+     * @returns this for chaining
+     */
+    orbit(phi: number, theta: number, distance?: number): this;
+    /**
+     * Get spherical coordinates relative to the look-at point.
+     * @returns Object with phi (polar), theta (azimuthal), and distance
+     */
+    getOrbitAngles(): {
+        phi: number;
+        theta: number;
+        distance: number;
+    };
+}
+/**
+ * Options for configuring a Camera2D.
+ */
+export interface CameraOptions {
+    /** Width of the visible frame in world units. Defaults to 14 (Manim standard). */
+    frameWidth?: number;
+    /** Height of the visible frame in world units. Defaults to 8 (Manim standard). */
+    frameHeight?: number;
+    /** Initial camera position [x, y, z]. Defaults to [0, 0, 10]. */
+    position?: [number, number, number];
+}
+/**
+ * 2D camera for manimweb scenes.
+ * Wraps Three.js OrthographicCamera with Manim-style frame dimensions.
+ */
+export declare class Camera2D {
+    private _camera;
+    private _frameWidth;
+    private _frameHeight;
+    private _frame;
+    /**
+     * Create a new 2D camera.
+     * @param options - Camera configuration options
+     */
+    constructor(options?: CameraOptions);
+    /**
+     * Get the frame width in world units.
+     */
+    get frameWidth(): number;
+    /**
+     * Set the frame width in world units.
+     */
+    set frameWidth(width: number);
+    /**
+     * Get the frame height in world units.
+     */
+    get frameHeight(): number;
+    /**
+     * Set the frame height in world units.
+     */
+    set frameHeight(height: number);
+    /**
+     * Get the camera position.
+     */
+    get position(): THREE.Vector3;
+    /**
+     * Move the camera to a specific point.
+     * @param point - Target position [x, y, z]
+     */
+    moveTo(point: [number, number, number]): void;
+    /**
+     * Get the underlying Three.js OrthographicCamera.
+     * @returns The OrthographicCamera instance
+     */
+    getCamera(): THREE.OrthographicCamera;
+    /**
+     * Update the frame dimensions to match an aspect ratio.
+     * Useful for responsive layouts.
+     * @param aspectRatio - Width / height ratio
+     */
+    setAspectRatio(aspectRatio: number): void;
+    /**
+     * Lazy-created Camera2DFrame for Manim-style camera.frame API.
+     * The frame is a VMobject whose position and scale drive the camera,
+     * enabling animations like Restore, MoveToTarget, and updaters.
+     */
+    get frame(): Camera2DFrame;
+    /**
+     * Run updaters on the camera frame (if it exists).
+     * Called by Scene after the timeline update so camera updaters
+     * see the latest positions set by animations.
+     */
+    updateFrame(dt: number): void;
+    /**
+     * Update projection matrix after frame dimension changes.
+     */
+    private _updateProjection;
+}
+//# sourceMappingURL=Camera.d.ts.map