manim-web 0.19.0 → 0.21.0

package/dist/audio/AudioAnalyzer.d.ts

@@ -0,0 +1,132 @@
+import { Mobject, UpdaterFunction } from '../core/Mobject';
+import { ValueTracker } from '../mobjects/value-tracker/ValueTracker';
+import { AudioManager } from '../core/AudioManager';
+/**
+ * The subset of `AnalyserNode` the analyzer reads from.
+ *
+ * A real `AnalyserNode` satisfies this interface. Tests inject a stub that
+ * implements only these members, so no real `AudioContext` is required.
+ */
+export interface SpectrumAnalyser {
+    /** FFT window size (power of two). */
+    readonly fftSize: number;
+    /** Number of frequency bins (`fftSize / 2`). */
+    readonly frequencyBinCount: number;
+    /** The owning context; only its sample rate is read. */
+    readonly context: Pick<BaseAudioContext, 'sampleRate'>;
+    /** Fill `array` with the current byte frequency spectrum. */
+    getByteFrequencyData(array: Uint8Array): void;
+    /** Fill `array` with the current byte time-domain waveform. */
+    getByteTimeDomainData(array: Uint8Array): void;
+}
+/** Options for constructing an {@link AudioAnalyzer}. */
+export interface AudioAnalyzerOptions {
+    /** FFT window size (power of two, 32..32768). Defaults to 2048. */
+    fftSize?: number;
+    /** Smoothing between frames [0, 1]. Defaults to 0.8. */
+    smoothingTimeConstant?: number;
+    /** Pre-built analyser to read from (dependency injection / testing). */
+    analyser?: SpectrumAnalyser;
+}
+/** Options for mapping an audio read onto a {@link ValueTracker} value. */
+export interface AudioReactiveBindOptions {
+    /** Multiplier applied to the raw read. Defaults to 1. */
+    scale?: number;
+    /** Constant added after scaling. Defaults to 0. */
+    offset?: number;
+}
+/** Whether the Web Audio analysis API is available in this environment. */
+export declare function isAudioAnalysisSupported(): boolean;
+/**
+ * Reads a live frequency spectrum and feeds it into manim-web animations.
+ */
+export declare class AudioAnalyzer {
+    private _analyser;
+    private readonly _fftSize;
+    private readonly _smoothing;
+    private _freqBuffer;
+    private _timeBuffer;
+    /** Context this analyzer created itself (closed on {@link dispose}). */
+    private _ownedContext;
+    constructor(options?: AudioAnalyzerOptions);
+    /**
+     * Create an analyzer tapping an `<audio>` / `<video>` element.
+     * The element stays audible (the analyser is wired to the destination).
+     * No-op (silent, returns zeros) when Web Audio is unavailable.
+     */
+    static fromMediaElement(element: HTMLMediaElement, options?: AudioAnalyzerOptions): AudioAnalyzer;
+    /**
+     * Create an analyzer tapping the master output of an {@link AudioManager}.
+     * No-op (silent, returns zeros) when Web Audio is unavailable.
+     */
+    static fromAudioManager(manager: AudioManager, options?: AudioAnalyzerOptions): AudioAnalyzer;
+    /**
+     * Tap an `<audio>` / `<video>` element. Creates an owned `AudioContext`.
+     * @returns this for chaining
+     */
+    connectMediaElement(element: HTMLMediaElement): this;
+    /**
+     * Tap an existing `AudioNode` (for example a `BufferSource` or `GainNode`).
+     * The node's own `AudioContext` is used; no new context is created.
+     * @returns this for chaining
+     */
+    connectSource(node: AudioNode): this;
+    /**
+     * Fill `target` (or an internal buffer) with the byte frequency spectrum.
+     * Returns a zero-filled buffer when no analyser is connected.
+     * @returns The buffer that was written
+     */
+    getByteFrequencyData(target?: Uint8Array): Uint8Array;
+    /** Alias of {@link getByteFrequencyData} that returns the internal buffer. */
+    getFrequencyData(): Uint8Array;
+    /**
+     * Average the normalized energy [0, 1] across the band `[lowHz, highHz]`.
+     * Returns 0 when no analyser is connected or the band is empty.
+     */
+    getBand(lowHz: number, highHz: number): number;
+    /** Normalized bass energy [0, 1] (20-250 Hz). */
+    getBass(): number;
+    /** Normalized mid energy [0, 1] (250-4000 Hz). */
+    getMid(): number;
+    /** Normalized treble energy [0, 1] (4000-20000 Hz). */
+    getTreble(): number;
+    /**
+     * Overall loudness as the RMS [0, 1] of the time-domain waveform.
+     * Returns 0 when no analyser is connected.
+     */
+    getLevel(): number;
+    /**
+     * Drive a {@link ValueTracker} from an audio read each frame.
+     *
+     * Adds an updater to the tracker that sets its value to
+     * `offset + read() * scale` on every `update(dt)`. Other mobjects follow the
+     * tracker through their own updaters.
+     *
+     * @param tracker - The tracker to drive
+     * @param read - Audio read to sample (defaults to {@link getLevel})
+     * @param options - Scale and offset applied to the read
+     * @returns The updater, so it can be removed with `tracker.removeUpdater`
+     */
+    bindToTracker(tracker: ValueTracker, read?: () => number, options?: AudioReactiveBindOptions): UpdaterFunction;
+    /**
+     * Build an updater that maps the spectrum onto any mobject property.
+     *
+     * The returned updater passes the mobject, this analyzer, and `dt` to
+     * `apply`, so `apply` can read bands and set any property. Add it with
+     * `mobject.addUpdater(analyzer.createUpdater(...))`.
+     */
+    createUpdater<M extends Mobject>(apply: (mobject: M, analyzer: AudioAnalyzer, dt: number) => void): UpdaterFunction;
+    /** Whether an analyser is connected (reads return live data). */
+    get connected(): boolean;
+    /** The number of frequency bins the spectrum reads produce. */
+    get frequencyBinCount(): number;
+    /** The connected analyser, or `null` when unavailable. */
+    get analyser(): SpectrumAnalyser | null;
+    /** Release the owned `AudioContext`, if this analyzer created one. */
+    dispose(): void;
+    /** Create and configure a real `AnalyserNode` on `ctx`. */
+    private _createAnalyser;
+    /** Adopt an analyser and resize the read buffers to match it. */
+    private _setAnalyser;
+}
+//# sourceMappingURL=AudioAnalyzer.d.ts.map

package/dist/audio/AudioAnalyzer.d.ts.map

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

package/dist/core/AudioManager.d.ts

@@ -183,6 +183,14 @@ export declare class AudioManager {
      * @returns MediaStreamAudioDestinationNode connected to the master gain
      */
     createStreamDestination(): MediaStreamAudioDestinationNode;
+    /**
+     * Connect the master output to an external node (for example an
+     * `AnalyserNode` used for audio-reactive visualization). The node keeps
+     * receiving the mixed output until the context is closed.
+     *
+     * @param node - The destination node to feed from the master gain
+     */
+    connectOutput(node: AudioNode): void;
     /**
      * Encode an AudioBuffer as a WAV Blob (PCM 16-bit).
      */

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

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

package/dist/export/FrameExporter.d.ts

@@ -1,18 +1,9 @@
-/**
- * FrameExporter - in-browser PNG frame export for manim-web scenes.
- *
- * Captures the scene's WebGL canvas as PNG image data with no ffmpeg and no
- * server round-trip. It uses `canvas.toBlob` when available and falls back to
- * `canvas.toDataURL` so it also works where `toBlob` is missing.
- *
- * Two capture modes are provided:
- *  - `exportFramePNG` captures one frame (the current frame, or a seeked time).
- *  - `exportPNGSequence` seeks and captures one frame per timeline step, the
- *    same frame loop VideoExporter uses.
- */
+import { AlphaRenderer } from './alphaBackground';
 /**
  * Duck-type interface for Scene, used to avoid a circular import.
  * FrameExporter only needs canvas access, seek, and the timeline duration.
+ *
+ * `renderer` and `render` are optional and used only for transparent export.
  */
 interface ExportableScene {
     getCanvas(): HTMLCanvasElement;
@@ -20,6 +11,12 @@ interface ExportableScene {
     getHeight(): number;
     seek(time: number): void;
     getTimelineDuration(): number | null;
+    /** The WebGL renderer, used only for transparent export. */
+    renderer?: {
+        getThreeRenderer(): AlphaRenderer;
+    } | null;
+    /** Re-render the current frame, used only for transparent single-frame export. */
+    render?(): void;
 }
 /** Options for a single-frame PNG capture. */
 export interface FrameExportOptions {
@@ -29,6 +26,14 @@ export interface FrameExportOptions {
     type?: string;
     /** Quality from 0-1 for lossy types such as 'image/jpeg'. Ignored for PNG. */
     quality?: number;
+    /**
+     * Render with a transparent background, so the PNG carries a real alpha
+     * channel (RGBA, transparent where nothing is drawn). Defaults to false.
+     * Needs a Scene created with `{ alpha: true }` (or `backgroundOpacity < 1`);
+     * otherwise the export throws a clear error instead of producing an opaque
+     * image. Use a lossless type such as 'image/png' to keep the alpha channel.
+     */
+    transparent?: boolean;
 }
 /** Options for a PNG frame-sequence capture. */
 export interface PNGSequenceOptions {
@@ -44,6 +49,14 @@ export interface PNGSequenceOptions {
     quality?: number;
     /** Progress callback (0-1). */
     onProgress?: (progress: number) => void;
+    /**
+     * Render with a transparent background, so each PNG carries a real alpha
+     * channel (RGBA, transparent where nothing is drawn). Defaults to false.
+     * Needs a Scene created with `{ alpha: true }` (or `backgroundOpacity < 1`);
+     * otherwise the export throws a clear error instead of producing opaque
+     * frames. Use a lossless type such as 'image/png' to keep the alpha channel.
+     */
+    transparent?: boolean;
 }
 /**
  * Export a single frame as a PNG Blob.

package/dist/export/FrameExporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrameExporter.d.ts","sourceRoot":"","sources":["../../src/export/FrameExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,UAAU,eAAe;IACvB,SAAS,IAAI,iBAAiB,CAAC;IAC/B,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AA+CD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,EAAE,CAAC,CAoBjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS/D;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,eAAe,EACtB,QAAQ,GAAE,MAAoB,EAC9B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"FrameExporter.d.ts","sourceRoot":"","sources":["../../src/export/FrameExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA8C,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnG;;;;;GAKG;AACH,UAAU,eAAe;IACvB,SAAS,IAAI,iBAAiB,CAAC;IAC/B,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE;QAAE,gBAAgB,IAAI,aAAa,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,kFAAkF;IAClF,MAAM,CAAC,IAAI,IAAI,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA+CD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf;AA6BD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,EAAE,CAAC,CA4BjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS/D;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,eAAe,EACtB,QAAQ,GAAE,MAAoB,EAC9B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/export/SvgExporter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * SvgExporter - in-browser scene-to-SVG vector export for manim-web.
+ *
+ * Walks the scene's VMobjects and writes each one as an SVG `<path>` with the
+ * correct fill (color, opacity, fill-rule) and stroke (color, width, opacity).
+ * The output is a complete, standalone `<svg>` string with a `viewBox` that
+ * matches the raster exporters' pixel aspect, so the vector result lines up
+ * with a PNG of the same frame. Unlike GIF/Video/PNG/WebCodecs export, the
+ * result is resolution-independent and editable in a vector tool.
+ *
+ * Scope: 2D VMobjects. The scene camera is treated as the orthographic 2D
+ * frame, so each point maps through its world transform and then flattens onto
+ * the x/y plane (z is dropped). True 3D mobjects (meshes such as Surface) are
+ * not VMobjects and are skipped. A VMobject authored in a 3D/perspective scene
+ * is projected with the same 2D frame mapping, which is only exact for the 2D
+ * orthographic case.
+ *
+ * Three capture entry points are provided, mirroring FrameExporter:
+ *  - `sceneToSVG` returns the SVG markup as a string.
+ *  - `exportSVG` returns the SVG as a Blob.
+ *  - `exportAndDownloadSVG` triggers a browser download (guards the DOM).
+ */
+/**
+ * Duck-type interface for the scene camera the exporter needs.
+ *
+ * It matches Camera2D: a frame width/height in world units and a world-space
+ * center position. The frame is the orthographic box the raster exporters use.
+ */
+export interface SvgExportableCamera {
+    /** Frame width in world units. */
+    frameWidth: number;
+    /** Frame height in world units. */
+    frameHeight: number;
+    /** World-space camera center (only x and y are read). */
+    position: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Duck-type interface for Scene, used to avoid a circular import.
+ *
+ * The exporter needs the pixel dimensions (to match the raster aspect), the
+ * camera frame, and the top-level mobjects in draw order.
+ */
+export interface SvgExportableScene {
+    /** Canvas width in pixels. */
+    getWidth(): number;
+    /** Canvas height in pixels. */
+    getHeight(): number;
+    /** The scene camera (orthographic 2D frame). */
+    camera: SvgExportableCamera;
+    /** Top-level mobjects, in insertion (draw) order. */
+    mobjects: Iterable<{
+        getFamily(): unknown[];
+        userId?: string;
+    }>;
+}
+/** Options for an SVG export. */
+export interface SvgExportOptions {
+    /**
+     * Decimal places for coordinates and numeric attributes. Defaults to 3.
+     * Fewer places give smaller output; more give higher precision.
+     */
+    precision?: number;
+    /**
+     * Background color for the `<svg>` (a solid `<rect>` behind everything).
+     * Omit for a transparent background.
+     */
+    background?: string;
+}
+/**
+ * Convert a scene to a complete, standalone SVG string.
+ *
+ * Each top-level mobject becomes a `<g>` group holding the `<path>` elements of
+ * its VMobject family, in draw order. World coordinates map to the pixel
+ * viewBox through the camera frame, matching the raster exporters' aspect.
+ * An empty scene yields a valid, empty `<svg>`.
+ *
+ * @param scene - The scene to export
+ * @param options - Export options
+ * @returns The SVG markup
+ */
+export declare function sceneToSVG(scene: SvgExportableScene, options?: SvgExportOptions): string;
+/**
+ * Export a scene as an SVG Blob.
+ *
+ * @param scene - The scene to export
+ * @param options - Export options
+ * @returns A Blob of type `image/svg+xml`
+ */
+export declare function exportSVG(scene: SvgExportableScene, options?: SvgExportOptions): Blob;
+/**
+ * Convenience helper: export a scene as SVG and download it.
+ *
+ * Guards the DOM: it throws a clear error when no `document` is available
+ * (for example in a worker or during server-side use).
+ *
+ * @param scene - The scene to export
+ * @param filename - The target filename. Defaults to 'scene.svg'.
+ * @param options - Export options
+ */
+export declare function exportAndDownloadSVG(scene: SvgExportableScene, filename?: string, options?: SvgExportOptions): void;
+//# sourceMappingURL=SvgExporter.d.ts.map

package/dist/export/SvgExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgExporter.d.ts","sourceRoot":"","sources":["../../src/export/SvgExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,IAAI,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,IAAI,MAAM,CAAC;IACpB,gDAAgD;IAChD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,QAAQ,CAAC;QAAE,SAAS,IAAI,OAAO,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwKD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAgCxF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAGrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,GAAE,MAAoB,EAC9B,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAKN"}

package/dist/export/WebCodecsExporter.d.ts

@@ -1,3 +1,4 @@
+import { AlphaRenderer } from './alphaBackground';
 /**
  * WebCodecsExporter - deterministic, high-quality video export for manim-web.
  *
@@ -25,6 +26,10 @@ interface ExportableScene {
     getHeight(): number;
     seek(time: number): void;
     getTimelineDuration(): number | null;
+    /** The WebGL renderer, used only for transparent (alpha) export. */
+    renderer?: {
+        getThreeRenderer(): AlphaRenderer;
+    } | null;
 }
 /** Video codec, shared by the encoder and the container track. */
 export type WebCodecsVideoCodec = 'avc' | 'hevc' | 'vp9' | 'av1';
@@ -48,6 +53,18 @@ export interface WebCodecsExportOptions {
     keyFrameInterval?: number;
     /** Progress callback (0-1). */
     onProgress?: (progress: number) => void;
+    /**
+     * Export with a transparent background, so the video carries an alpha
+     * channel to composite over other footage. Defaults to false.
+     *
+     * Alpha needs the 'webm' format with the 'vp9' codec, because only that path
+     * carries an alpha side channel. When `alpha` is set and `format`/`codec` are
+     * not given, they default to 'webm' and 'vp9'. It also needs a Scene created
+     * with `{ alpha: true }` (or `backgroundOpacity < 1`) and a browser that can
+     * encode VP9 with alpha. When any requirement is unmet, `export()` throws a
+     * clear error instead of producing opaque video that claims transparency.
+     */
+    alpha?: boolean;
 }
 interface ResolvedWebCodecsExportOptions {
     fps: number;
@@ -59,6 +76,7 @@ interface ResolvedWebCodecsExportOptions {
     duration: number;
     keyFrameInterval: number;
     onProgress: (progress: number) => void;
+    alpha: boolean;
 }
 /**
  * Deterministic WebCodecs-based video exporter for manim-web scenes.
@@ -87,6 +105,27 @@ export declare class WebCodecsExporter {
      * @throws Error if WebCodecs is unavailable (use VideoExporter instead)
      */
     export(): Promise<Blob>;
+    /**
+     * Validate that the configured codec and format can carry an alpha channel.
+     *
+     * Only webm with vp9 carries an alpha side channel, so any other combination
+     * cannot produce a transparent video.
+     *
+     * @throws Error when the format or codec cannot carry alpha
+     */
+    private _assertAlphaCodec;
+    /**
+     * Check that the browser can encode the codec with an alpha channel.
+     *
+     * Uses `VideoEncoder.isConfigSupported` when available. When the browser
+     * reports the alpha config as unsupported, this throws rather than silently
+     * producing opaque video. When detection is unavailable, it proceeds and
+     * lets the encoder's error callback surface any failure.
+     *
+     * @param mapping - The codec mapping for the configured codec
+     * @throws Error when the browser cannot encode the codec with alpha
+     */
+    private _assertAlphaEncodeSupport;
     /**
      * Lazily import the muxer for the configured container and wrap it in a
      * container-agnostic handle.

package/dist/export/WebCodecsExporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebCodecsExporter.d.ts","sourceRoot":"","sources":["../../src/export/WebCodecsExporter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,UAAU,eAAe;IACvB,SAAS,IAAI,iBAAiB,CAAC;IAC/B,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,kEAAkE;AAClE,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjE,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,iEAAiE;IACjE,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,UAAU,8BAA8B;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAyBD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;;;OAIG;gBACS,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAiBpE;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;IAI7B;;;;;;;;;OASG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD7B;;;OAGG;YACW,YAAY;IAsC1B;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,8BAA8B,CAAC;CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,CAEnB"}
+{"version":3,"file":"WebCodecsExporter.d.ts","sourceRoot":"","sources":["../../src/export/WebCodecsExporter.ts"],"names":[],"mappings":"AACA,OAAO,EAA8C,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnG;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,UAAU,eAAe;IACvB,SAAS,IAAI,iBAAiB,CAAC;IAC/B,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,EAAE;QAAE,gBAAgB,IAAI,aAAa,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD;AAED,kEAAkE;AAClE,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjE,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,iEAAiE;IACjE,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,8BAA8B;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB;AAyBD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;;;OAIG;gBACS,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAoBpE;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;IAI7B;;;;;;;;;OASG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA8E7B;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;;;;;;;OAUG;YACW,yBAAyB;IAuBvC;;;OAGG;YACW,YAAY;IAuC1B;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,8BAA8B,CAAC;CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,CAEnB"}

package/dist/export/alphaBackground.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Shared helpers for transparent / alpha background export.
+ *
+ * Both the PNG frame exporter and the WebCodecs video exporter can render the
+ * scene with a transparent background, so the exported frames carry a real
+ * alpha channel instead of the opaque background color. The pixels are
+ * transparent where nothing is drawn, so the result composites over other
+ * footage.
+ *
+ * A transparent export has two requirements:
+ *  1. The WebGL context was created with an alpha channel. The Scene enables it
+ *     with `{ alpha: true }` (or `backgroundOpacity < 1`). Without it the canvas
+ *     has no alpha to export, so a transparent export would silently produce an
+ *     opaque image. This module detects that and throws a clear error instead.
+ *  2. The renderer clears to a transparent color while it captures the frames.
+ *     `withTransparentClear` sets the clear alpha to 0 for the capture, then
+ *     restores the previous clear alpha, so normal rendering is unchanged.
+ */
+/**
+ * Minimal duck-type of `THREE.WebGLRenderer`, limited to the alpha controls the
+ * exporters need. It avoids a direct dependency on three.js in the exporters.
+ */
+export interface AlphaRenderer {
+    /** Get the current clear alpha (0 = transparent, 1 = opaque). */
+    getClearAlpha(): number;
+    /** Set the clear alpha used on the next render. */
+    setClearAlpha(alpha: number): void;
+    /** Get the WebGL context, used to read its context attributes. */
+    getContext(): {
+        getContextAttributes(): WebGLContextAttributes | null;
+    };
+}
+/**
+ * Minimal duck-type of a Scene that can expose its WebGL renderer for alpha
+ * export. The real Scene satisfies this through its `renderer` getter.
+ */
+export interface AlphaCapableScene {
+    renderer?: {
+        getThreeRenderer(): AlphaRenderer;
+    } | null;
+}
+/** Error message when the WebGL context has no alpha channel to export. */
+export declare const ALPHA_CONTEXT_ERROR: string;
+/** Error message when the scene does not expose a WebGL renderer. */
+export declare const ALPHA_RENDERER_ERROR: string;
+/**
+ * Resolve the underlying WebGL renderer from a scene.
+ * @param scene - The scene to read the renderer from
+ * @returns The WebGL renderer, or null when the scene exposes none
+ */
+export declare function resolveAlphaRenderer(scene: AlphaCapableScene): AlphaRenderer | null;
+/**
+ * Report whether the WebGL context was created with an alpha channel.
+ * @param renderer - The WebGL renderer to inspect
+ * @returns True when the context has an alpha channel
+ */
+export declare function hasAlphaChannel(renderer: AlphaRenderer): boolean;
+/**
+ * Resolve the WebGL renderer for a transparent export, or throw a clear error.
+ *
+ * @param scene - The scene to export
+ * @returns The WebGL renderer, ready for a transparent capture
+ * @throws Error when the scene exposes no renderer, or the context has no alpha
+ */
+export declare function requireAlphaRenderer(scene: AlphaCapableScene): AlphaRenderer;
+/**
+ * Run a capture with a transparent clear color, then restore the previous one.
+ *
+ * The clear alpha is set to 0 for the duration of `fn`, so frames rendered
+ * inside it clear to transparent. The previous clear alpha is restored even
+ * when `fn` throws, so normal rendering is unchanged after the export.
+ *
+ * @param renderer - The WebGL renderer to control
+ * @param fn - The capture function to run under a transparent clear
+ * @returns The value `fn` resolves to
+ */
+export declare function withTransparentClear<T>(renderer: AlphaRenderer, fn: () => Promise<T> | T): Promise<T>;
+//# sourceMappingURL=alphaBackground.d.ts.map

package/dist/export/alphaBackground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphaBackground.d.ts","sourceRoot":"","sources":["../../src/export/alphaBackground.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,aAAa,IAAI,MAAM,CAAC;IACxB,mDAAmD;IACnD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kEAAkE;IAClE,UAAU,IAAI;QAAE,oBAAoB,IAAI,sBAAsB,GAAG,IAAI,CAAA;KAAE,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE;QAAE,gBAAgB,IAAI,aAAa,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD;AAED,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,QAGkB,CAAC;AAEnD,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,QACgE,CAAC;AAElG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAMnF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAGhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,CAS5E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,QAAQ,EAAE,aAAa,EACvB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/export/index.d.ts

@@ -3,4 +3,5 @@ export { VideoExporter, createVideoExporter, type VideoExportOptions } from './V
 export { exportFramePNG, exportPNGSequence, downloadBlob, exportAndDownloadPNG, type FrameExportOptions, type PNGSequenceOptions, } from './FrameExporter';
 export { WebCodecsExporter, createWebCodecsExporter, type WebCodecsExportOptions, type WebCodecsVideoCodec, } from './WebCodecsExporter';
 export { chooseVideoExporterStrategy, type VideoExporterStrategy } from './chooseExporter';
+export { sceneToSVG, exportSVG, exportAndDownloadSVG, type SvgExportOptions, type SvgExportableScene, type SvgExportableCamera, } from './SvgExporter';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EACL,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC"}

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export { Voiceover, type VoiceoverOptions, type VoiceoverCallback, type Voiceove
 export { VoiceoverScene, type VoiceoverSceneOptions, type VoiceoverSceneAudioOptions, } from './audio/VoiceoverScene';
 export { setSpeechSynthesizer, getSpeechSynthesizer, isSpeechSupported, WebSpeechSynthesizer, type SpeechSynthesizer, type SpeechUtteranceHandle, type SpeechOptions, type SpeechBoundaryInfo, } from './audio/speechSynthesizer';
 export { parseBookmarks, type Bookmark, type ParsedTranscript } from './audio/bookmarks';
+export { AudioAnalyzer, isAudioAnalysisSupported, type AudioAnalyzerOptions, type AudioReactiveBindOptions, type SpectrumAnalyser, } from './audio/AudioAnalyzer';
 export { attachCaptionTrack, formatVttTimestamp, voiceoverToVTT, type CaptionTrackHandle, type CaptionTrackOptions, type VoiceoverCaptionCue, } from './a11y/captions';
 export { applyReducedMotion, getReducedMotionRunTime, isReducedMotionEnabled, prefersReducedMotion, reducedRunTime, resetReducedMotion, setReducedMotion, shouldReduceMotion, type ReducedMotionOptions, } from './a11y/reducedMotion';
 export { announceMobject, AriaNarrator, createLiveRegion, describeMobject, type AriaDescribable, type LiveRegionOptions, } from './a11y/ariaNarration';
@@ -35,10 +36,10 @@ export { MovingCamera, ThreeDCamera, MultiCamera, MappingCamera, SplitScreenCame
 export { CameraFrame, CameraAnimateProxy, type CameraFrameOptions, type CameraFrameState, type CameraAnimationOptions, } from './core/CameraFrame';
 export { Lighting, type AmbientLightOptions, type DirectionalLightOptions, type PointLightOptions, type SpotLightOptions, } from './core/Lighting';
 export { Circle, type CircleOptions, Line, type LineOptions, Rectangle, Square, type RectangleOptions, Polygon, Triangle, RegularPolygon, Hexagon, Pentagon, type PolygonOptions, Polygram, type PolygramOptions, TipableVMobject, type TipableVMobjectOptions, type TipOptions, Arrow, DoubleArrow, Vector, type ArrowOptions, Arc, type ArcOptions, ArcBetweenPoints, type ArcBetweenPointsOptions, Ellipse, type EllipseOptions, Annulus, type AnnulusOptions, AnnularSector, type AnnularSectorOptions, Sector, type SectorOptions, ArcPolygon, type ArcPolygonOptions, type ArcConfig, CurvedArrow, CurvedDoubleArrow, type CurvedArrowOptions, TangentialArc, type TangentialArcOptions, DashedLine, type DashedLineOptions, DashedVMobject, type DashedVMobjectOptions, CubicBezier, type CubicBezierOptions, Dot, SmallDot, LargeDot, type DotOptions, BackgroundRectangle, SurroundingRectangle, Underline, Cross, type BackgroundRectangleOptions, type SurroundingRectangleOptions, type UnderlineOptions, type CrossOptions, Label, type LabelOptions, RoundedRectangle, type RoundedRectangleOptions, Star, type StarOptions, RegularPolygram, type RegularPolygramOptions, Cutout, type CutoutOptions, ConvexHull, type ConvexHullOptions, Angle, RightAngle, Elbow, TangentLine, type AngleOptions, type AngleInput, type RightAngleOptions, type ElbowOptions, type TangentLineOptions, ArrowTip, ArrowTriangleTip, ArrowTriangleFilledTip, ArrowCircleTip, ArrowCircleFilledTip, ArrowSquareTip, ArrowSquareFilledTip, StealthTip, type ArrowTipOptions, type CubicBezierPoints, Union, Intersection, Difference, Exclusion, BooleanResult, union, intersection, difference, exclusion, type BooleanOperationOptions, LabeledPolygram, type LabeledPolygramOptions, LabeledLine, LabeledArrow, LabeledDot, AnnotationDot, type LabeledLineOptions, type LabeledArrowOptions, type LabeledDotOptions, type AnnotationDotOptions, type LabelDirection, type LabelOrientation, } from './mobjects/geometry';
-export { NumberLine, type NumberLineOptions, UnitInterval, type UnitIntervalOptions, Axes, type AxesOptions, NumberPlane, type NumberPlaneOptions, type BackgroundLineStyle, FunctionGraph, type FunctionGraphOptions, ImplicitFunction, type ImplicitFunctionOptions, ParametricFunction, type ParametricFunctionOptions, VectorFieldVector, type VectorFieldVectorOptions, ComplexPlane, type ComplexPlaneOptions, PolarPlane, type PolarPlaneOptions, BarChart, type BarChartOptions, VectorField, ArrowVectorField, StreamLines, stepVectorField, type Integrator, type VectorFunction, type ColorFunction, type VectorFieldBaseOptions, type ArrowVectorFieldOptions, type StreamLinesOptions, type ContinuousMotionOptions, } from './mobjects/graphing';
+export { NumberLine, type NumberLineOptions, UnitInterval, type UnitIntervalOptions, Axes, type AxesOptions, NumberPlane, type NumberPlaneOptions, type BackgroundLineStyle, FunctionGraph, type FunctionGraphOptions, ImplicitFunction, type ImplicitFunctionOptions, ParametricFunction, type ParametricFunctionOptions, VectorFieldVector, type VectorFieldVectorOptions, ComplexPlane, type ComplexPlaneOptions, PolarPlane, type PolarPlaneOptions, BarChart, type BarChartOptions, PieChart, type PieChartOptions, DonutChart, type DonutChartOptions, computeSliceGeometry, type SliceGeometry, type LabelPosition, VectorField, ArrowVectorField, StreamLines, stepVectorField, type Integrator, type VectorFunction, type ColorFunction, type VectorFieldBaseOptions, type ArrowVectorFieldOptions, type StreamLinesOptions, type ContinuousMotionOptions, } from './mobjects/graphing';
 export { type CoordinateSystem, ScaleBase, LinearBase, LogBase, type GetCustomLabelsOptions, } from './mobjects/graphing';
 export { HeatMap, type HeatMapOptions, type ScalarField2D, ContourPlot, type ContourPlotOptions, type ContourField, sampleColormap, valueToColor, VIRIDIS, INFERNO, COOLWARM, marchingSquares, type ContourSegment, } from './mobjects/graphing';
-export { Text, type TextOptions, Paragraph, type ParagraphOptions, MarkupText, type MarkupTextOptions, MathTex, type MathTexOptions, MathTexSVG, type MathTexSVGOptions, MathTexImage, type MathTexImageOptions, type TexRenderer, Tex, type TexOptions, ensureKatexStyles, areKatexStylesLoaded, setKatexStylesheetUrl, renderLatexToSVG, preloadMathJax, isMathJaxLoaded, katexCanRender, setMathJaxScriptUrl, type MathJaxRenderOptions, type MathJaxRenderResult, parseSVGPathData, svgToVMobjects, type SVGToVMobjectOptions, DecimalNumber, Integer, type DecimalNumberOptions, Variable, type VariableOptions, GlyphVMobject, type GlyphVMobjectOptions, TextGlyphGroup, type TextGlyphGroupOptions, Code, type CodeOptions, type CodeColorScheme, type CodeToken, type Token, type TokenType, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, SingleStringMathTex, type SingleStringMathTexOptions, MathTexPart, type MathTexPartOptions, BulletedList, Title, MarkdownText, type BulletedListOptions, type TitleOptions, type MarkdownTextOptions, type StyledTextSegment, type TextStyleMaps, type TextStyleRun, buildStyledTextLines, Typst, MathTypst, type TypstOptions, type MathTypstOptions, renderTypstToSVG, preloadTypst, isTypstLoaded, setTypstCompiler, type TypstRenderOptions, type TypstRenderResult, type TypstSvgCompiler, } from './mobjects/text';
+export { Text, type TextOptions, Paragraph, type ParagraphOptions, MarkupText, type MarkupTextOptions, MathTex, type MathTexOptions, MathTexSVG, type MathTexSVGOptions, MathTexImage, type MathTexImageOptions, type TexRenderer, Tex, type TexOptions, ensureKatexStyles, areKatexStylesLoaded, setKatexStylesheetUrl, renderLatexToSVG, preloadMathJax, isMathJaxLoaded, katexCanRender, setMathJaxScriptUrl, type MathJaxRenderOptions, type MathJaxRenderResult, parseSVGPathData, svgToVMobjects, type SVGToVMobjectOptions, DecimalNumber, Integer, type DecimalNumberOptions, Variable, type VariableOptions, GlyphVMobject, type GlyphVMobjectOptions, TextGlyphGroup, type TextGlyphGroupOptions, TextOnPath, type TextOnPathOptions, type TextOnPathGlyph, type TextOnPathSource, computeGlyphPlacements, sampledPathFromPoints, sampledPathFromFunction, visibleGlyphChars, alignmentToOffset, type SampledPath, type GlyphLayoutEntry, type GlyphLayoutOptions, type GlyphPlacement, type TextOnPathAlignment, type TextOnPathOverflow, type PathPoint, Code, type CodeOptions, type CodeColorScheme, type CodeToken, type Token, type TokenType, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, SingleStringMathTex, type SingleStringMathTexOptions, MathTexPart, type MathTexPartOptions, BulletedList, Title, MarkdownText, type BulletedListOptions, type TitleOptions, type MarkdownTextOptions, type StyledTextSegment, type TextStyleMaps, type TextStyleRun, buildStyledTextLines, Typst, MathTypst, type TypstOptions, type MathTypstOptions, renderTypstToSVG, preloadTypst, isTypstLoaded, setTypstCompiler, type TypstRenderOptions, type TypstRenderResult, type TypstSvgCompiler, } from './mobjects/text';
 export { Mobject3D, Sphere, type SphereOptions, Cube, Box3D, type CubeOptions, type Box3DOptions, Cylinder, Cone, type CylinderOptions, type ConeOptions, Torus, type TorusOptions, Line3D, type Line3DOptions, Arrow3D, Vector3D, type Arrow3DOptions, Surface3D, Surface3D as Surface, type Surface3DOptions, ParametricSurface, SurfacePresets, type ParametricSurfaceOptions, TexturedSurface, texturedSphere, type TexturedSurfaceOptions, type TexturedSphereOptions, ThreeDAxes, type ThreeDAxesOptions, Polyhedron, Tetrahedron, Octahedron, Icosahedron, Dodecahedron, type PolyhedronOptions, type TetrahedronOptions, type OctahedronOptions, type IcosahedronOptions, type DodecahedronOptions, Prism, Dot3D, ThreeDVMobject, type PrismOptions, type Dot3DOptions, type ThreeDVMobjectOptions, ConvexHull3D, type ConvexHull3DOptions, ImplicitSurface, type ImplicitSurfaceOptions, marchingCubes, type MarchingCubesOptions, type MarchingCubesResult, type ScalarField3D, InstancedMobject, type InstancedMobjectOptions, type InstanceTransform, } from './mobjects/three-d';
 export { ModelMobject, setModelLoaderFactory, detectModelFormat, type ModelMobjectOptions, type ModelFormat, type ModelUpAxis, type ModelLoader, type ModelLoaderFactory, } from './mobjects/three-d/ModelMobject';
 export { applyObjMaterials, setMtlLoaderFactory, deriveMtlUrl, deriveBasePath, type MtlLoader, type MtlLoaderFactory, type MtlMaterials, type ObjMaterialSink, type ObjMaterialOptions, } from './mobjects/three-d/objMaterials';
@@ -53,6 +54,7 @@ export { VideoMobject, type VideoMobjectOptions } from './mobjects/video';
 export { AnimatedImageMobject, setGifDecoder, type AnimatedImageMobjectOptions, type DecodedGif, type DecodedGifFrame, type GifDecoder, } from './mobjects/image/AnimatedImageMobject';
 export { ScreenRectangle, type ScreenRectangleOptions, FullScreenRectangle, type FullScreenRectangleOptions, FullScreenFadeRectangle, type FullScreenFadeRectangleOptions, createFadeToBlack, createFadeToWhite, DEFAULT_ASPECT_RATIO, } from './mobjects/frame';
 export { PMobject, PGroup, PointMobject, PointCloudDot, type PMobjectOptions, type PGroupOptions, type PointMobjectOptions, type PointCloudDotOptions, type PointData, Mobject1D, type Mobject1DOptions, Mobject2D, type Mobject2DOptions, type Distribution2D, } from './mobjects/point';
+export { ParticleSystem, type ParticleSystemOptions, type ParticleForces, type ParticleSnapshot, } from './mobjects/particles';
 export { MandelbrotSet, type MandelbrotSetOptions, NewtonFractal, type NewtonFractalOptions, } from './mobjects/fractals';
 export { SampleSpace, type SampleSpaceOptions, type Partition, type DivideOptions, type BraceAnnotationOptions, DiceFace, createDiceRow, type DiceFaceOptions, } from './mobjects/probability';
 export { Animation, type AnimationOptions, type RateFunction } from './animation/Animation';
@@ -103,7 +105,7 @@ export { OrbitControls, type OrbitControlsOptions } from './interaction';
 export { MovablePoint, makeMovablePoint, type MovablePointOptions, Slider, makeSlider, type SliderOptions, } from './interaction';
 export { MatrixTracker, makeMatrixTracker, applyMatrixLive, type Matrix2x2, type MatrixSource, type BasisVectorSource, type DependentPoint, type DynamicMatrixOptions, type LiveMatrixBinding, } from './interaction';
 export { GifExporter, createGifExporter, type GifExportOptions, VideoExporter, createVideoExporter, type VideoExportOptions, } from './export';
-export { exportFramePNG, exportPNGSequence, downloadBlob, exportAndDownloadPNG, type FrameExportOptions, type PNGSequenceOptions, WebCodecsExporter, createWebCodecsExporter, type WebCodecsExportOptions, type WebCodecsVideoCodec, chooseVideoExporterStrategy, type VideoExporterStrategy, } from './export';
+export { exportFramePNG, exportPNGSequence, downloadBlob, exportAndDownloadPNG, type FrameExportOptions, type PNGSequenceOptions, WebCodecsExporter, createWebCodecsExporter, type WebCodecsExportOptions, type WebCodecsVideoCodec, chooseVideoExporterStrategy, type VideoExporterStrategy, sceneToSVG, exportSVG, exportAndDownloadSVG, type SvgExportOptions, type SvgExportableScene, type SvgExportableCamera, } from './export';
 export { scaleVec, addVec, subVec, linspace, dotVec, crossVec, lengthVec, normalizeVec, unitPerpendicularTo, orthonormalFrame, orientation2D, } from './utils/vectors';
 export { Player, type PlayerOptions } from './player';
 export { PlayerUI, type PlayerUIOptions, type PlayerUICallbacks } from './player';