manim-web 0.13.0 → 0.14.0

package/dist/mobjects/three-d/Line3D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Line3D.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/Line3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,GAAG,EAAE,YAAY,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,SAAS;IACnC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC;IAK7B,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,iBAAiB,CAAoC;gBAEjD,OAAO,EAAE,aAAa;IAelC,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cAmB3B,oBAAoB,IAAI,IAAI;IAc/C,SAAS,CAAC,eAAe,IAAI,IAAI;IASjC,OAAO,CAAC,eAAe;IAWvB,gBAAgB;IACP,gBAAgB,CACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,IAAI;IASP,QAAQ,IAAI,YAAY;IAIxB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMnC,MAAM,IAAI,YAAY;IAItB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjC,YAAY,IAAI,MAAM;IAItB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,IAAI,MAAM;IAOnB,YAAY,IAAI,YAAY;IAY5B,WAAW,IAAI,YAAY;IAQ3B,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY;IAQhC,IAAI,IAAI,MAAM;CAWxB"}
+{"version":3,"file":"Line3D.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/Line3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,GAAG,EAAE,YAAY,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,SAAS;IACnC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC;IAK7B,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,iBAAiB,CAAoC;gBAEjD,OAAO,EAAE,aAAa;IAelC,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cA6B3B,oBAAoB,IAAI,IAAI;IAc/C,SAAS,CAAC,eAAe,IAAI,IAAI;IASjC,OAAO,CAAC,eAAe;IAWvB,gBAAgB;IACP,gBAAgB,CACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,IAAI;IASP,QAAQ,IAAI,YAAY;IAIxB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMnC,MAAM,IAAI,YAAY;IAItB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjC,YAAY,IAAI,MAAM;IAItB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,IAAI,MAAM;IAOnB,YAAY,IAAI,YAAY;IAY5B,WAAW,IAAI,YAAY;IAQ3B,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY;IAQhC,IAAI,IAAI,MAAM;CAWxB"}

package/dist/player/ExportSettingsUI.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ExportSettingsUI - opt-in export options for the PlayerUI export menu.
+ *
+ * Lets the user choose frame rate, output resolution and quality before
+ * exporting, instead of subclassing Player/PlayerUI. The panel is pure DOM and
+ * lives in this sibling file so PlayerUI.ts stays within its line budget.
+ */
+/** Concrete, resolved export settings handed to the exporter. */
+export interface ExportSettings {
+    /** Frames per second. */
+    fps: number;
+    /** Output width in pixels. */
+    width: number;
+    /** Output height in pixels. */
+    height: number;
+    /** 0-1; higher is better quality (maps to a higher video bitrate). */
+    quality: number;
+}
+/** A named output resolution. `null` width/height means "use the current size". */
+export interface ResolutionPreset {
+    id: string;
+    label: string;
+    width: number | null;
+    height: number | null;
+}
+/** A named quality level mapped to a 0-1 value. */
+export interface QualityPreset {
+    id: string;
+    label: string;
+    value: number;
+}
+/** The player's current output size and frame rate, used for defaults. */
+export interface ExportDefaults {
+    width: number;
+    height: number;
+    fps: number;
+}
+/** Selectable output resolutions. The first entry tracks the current size. */
+export declare const RESOLUTION_PRESETS: ResolutionPreset[];
+/** Selectable frame rates. */
+export declare const FPS_PRESETS: number[];
+/** Selectable quality levels. */
+export declare const QUALITY_PRESETS: QualityPreset[];
+/**
+ * Convert a 0-1 quality to a WebCodecs bitrate in bits per second.
+ * @param quality - Quality from 0 to 1 (clamped).
+ * @returns The target bitrate.
+ */
+export declare function qualityToBitrate(quality: number): number;
+/**
+ * Resolve a resolution preset id to concrete pixel dimensions.
+ * An unknown id, or the "current" preset, resolves to the current size.
+ * @param presetId - The preset id.
+ * @param currentWidth - The current output width.
+ * @param currentHeight - The current output height.
+ * @returns The resolved width and height.
+ */
+export declare function resolveResolution(presetId: string, currentWidth: number, currentHeight: number): {
+    width: number;
+    height: number;
+};
+/**
+ * The settings panel shown inside the export menu when `exportControls` is on.
+ * Renders fps, resolution and quality selectors and resolves the current choice
+ * to concrete {@link ExportSettings} on demand.
+ */
+export declare class ExportSettingsPanel {
+    private _element;
+    private _fpsSelect;
+    private _resolutionSelect;
+    private _qualitySelect;
+    private _defaults;
+    constructor(defaults: ExportDefaults);
+    /** The panel's root element, to insert into the export menu. */
+    get element(): HTMLElement;
+    /** Resolve the current selection to concrete export settings. */
+    getSettings(): ExportSettings;
+    /** Snap an arbitrary fps to the closest available preset. */
+    private _nearestFps;
+    private _buildSelect;
+}
+//# sourceMappingURL=ExportSettingsUI.d.ts.map

package/dist/player/ExportSettingsUI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportSettingsUI.d.ts","sourceRoot":"","sources":["../../src/player/ExportSettingsUI.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EAOhD,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,WAAW,EAAE,MAAM,EAAiB,CAAC;AAElD,iCAAiC;AACjC,eAAO,MAAM,eAAe,EAAE,aAAa,EAI1C,CAAC;AAKF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMnC;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,SAAS,CAAiB;gBAEtB,QAAQ,EAAE,cAAc;IA8BpC,gEAAgE;IAChE,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED,iEAAiE;IACjE,WAAW,IAAI,cAAc;IAW7B,6DAA6D;IAC7D,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;CAiDrB"}

package/dist/player/Player.d.ts

@@ -1,6 +1,7 @@
 import { Scene, SceneOptions } from '../core/Scene';
 import { MasterTimeline } from '../animation/MasterTimeline';
 import { RecordingScene } from './RecordingScene';
+import { ExportSettings } from './ExportSettingsUI';
 export interface PlayerOptions extends SceneOptions {
     /** Auto-hide controls after this many ms. 0 = never. Default 2500. */
     autoHideMs?: number;
@@ -10,6 +11,18 @@ export interface PlayerOptions extends SceneOptions {
     loop?: boolean;
     /** Slides mode: arrows play/pause at slide boundaries like a presentation. Default false. */
     slidesMode?: boolean;
+    /**
+     * Keep the scene interactive while paused. When true, a Draggable,
+     * Clickable or Hoverable object responds on a paused slide: a pointer event
+     * triggers one scene render without advancing the timeline. Default false,
+     * so normal slides keep their cheap paused behavior (no extra renders).
+     */
+    interactiveSlides?: boolean;
+    /**
+     * Show an fps/resolution/quality panel in the export menu, so viewers can
+     * pick export settings without subclassing the Player. Default false.
+     */
+    exportControls?: boolean;
 }
 export declare class Player {
     private _scene;
@@ -24,6 +37,11 @@ export declare class Player {
     private _loop;
     private _autoPlay;
     private _slidesMode;
+    private _interactiveSlides;
+    /** Idle-render path that keeps a paused slide interactive. Null when off. */
+    private _slideInteraction;
+    private _exportControls;
+    private _exportFps;
     /**
      * Index of the slide that slidesMode playback should stop (or loop / advance)
      * at when its endTime is reached. -1 means no target armed.
@@ -39,6 +57,11 @@ export declare class Player {
     private _origHeight;
     private _onFullscreenChange;
     constructor(container: HTMLElement, options?: PlayerOptions);
+    /**
+     * Attach the idle-render path. Renders happen only while the Player is
+     * paused (not playing), so this never fights the active render loop.
+     */
+    private _enableSlideInteraction;
     /**
      * Define the animation sequence. The callback receives a recording proxy
      * that captures all play()/wait() calls to build the master timeline.
@@ -90,8 +113,33 @@ export declare class Player {
     setPlaybackRate(rate: number): void;
     /** Enable or disable slides (presentation) mode at runtime. */
     setSlidesMode(enabled: boolean): void;
-    /** Export the animation in the given format (gif, webm, mp4). */
-    exportAs(format: string): Promise<void>;
+    /** Whether the scene stays interactive while paused on a slide. */
+    get interactiveSlides(): boolean;
+    /**
+     * Enable or disable interactive slides at runtime. When enabled, a paused
+     * slide renders on pointer interaction (drag/click/hover) without advancing
+     * the timeline. When disabled, the idle-render path is removed.
+     */
+    setInteractiveSlides(enabled: boolean): void;
+    /**
+     * Export the animation in the given format (gif, webm, mp4).
+     *
+     * For video (webm/mp4) the frame-accurate {@link WebCodecsExporter} is used
+     * when the browser supports it; otherwise it falls back to the MediaRecorder
+     * VideoExporter via `Scene.export`. GIF always uses `Scene.export`.
+     *
+     * @param format - Output format: `gif`, `webm` or `mp4`.
+     * @param settings - Optional fps/resolution/quality from the export panel.
+     *   When omitted, the exporter keeps its format defaults.
+     */
+    exportAs(format: string, settings?: ExportSettings): Promise<void>;
+    /** Run a frame-accurate WebCodecs video export and download the result. */
+    private _exportWithWebCodecs;
+    /**
+     * Build `Scene.export` options. With no `settings`, only the base options are
+     * set so each format keeps its own defaults (e.g. GIF fps 30, quality 10).
+     */
+    private _buildSceneExportOptions;
     /** Toggle browser fullscreen on the player container. */
     toggleFullscreen(): void;
     /** Clean up all resources. */

package/dist/player/Player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../../src/player/Player.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,WAAW,CAAU;IAC7B;;;OAGG;IACH,OAAO,CAAC,uBAAuB,CAAc;IAC7C;;;;OAIG;IACH,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,mBAAmB,CAAa;gBAE5B,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB;IAmE/D;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BhF,wDAAwD;IACxD,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,+BAA+B;IAC/B,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,kCAAkC;IAClC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,4EAA4E;IAC5E,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,uEAAuE;IACvE,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAEtB;IAED,4CAA4C;IAC5C,IAAI,IAAI,IAAI;IAgBZ,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAOb,qCAAqC;IACrC,eAAe,IAAI,IAAI;IAQvB;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBxB;;;;;;;;OAQG;IACH,WAAW,IAAI,IAAI;IAgBnB,qFAAqF;IACrF,SAAS,IAAI,IAAI;IAIjB,qFAAqF;IACrF,SAAS,IAAI,IAAI;IAIjB,mFAAmF;IACnF,WAAW,IAAI,IAAI;IAgBnB,OAAO,CAAC,eAAe;IA4CvB,OAAO,CAAC,eAAe;IA+BvB,yCAAyC;IACzC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,+DAA+D;IAC/D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASrC,iEAAiE;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7C,yDAAyD;IACzD,gBAAgB,IAAI,IAAI;IAmBxB,8BAA8B;IAC9B,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,UAAU;IA4GlB,OAAO,CAAC,SAAS;CAMlB"}
+{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../../src/player/Player.ts"],"names":[],"mappings":"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"}

package/dist/player/PlayerUI.d.ts

@@ -1,4 +1,5 @@
 import { MasterTimeline } from '../animation/MasterTimeline';
+import { ExportSettings, ExportDefaults } from './ExportSettingsUI';
 export interface PlayerUICallbacks {
     onPlayPause: () => void;
     onSeek: (time: number) => void;
@@ -6,12 +7,23 @@ export interface PlayerUICallbacks {
     onNext: () => void;
     onSpeedChange: (rate: number) => void;
     onFullscreen: () => void;
-    onExport: (format: string) => void;
+    /**
+     * Export in the given format. When the export settings panel is enabled
+     * (`exportControls`), the chosen fps/resolution/quality are passed too.
+     */
+    onExport: (format: string, settings?: ExportSettings) => void;
     onSlidesToggle: (enabled: boolean) => void;
+    /** Current output size and frame rate, used to seed the settings panel. */
+    getExportDefaults?: () => ExportDefaults;
 }
 export interface PlayerUIOptions {
     /** Auto-hide controls after this many ms of inactivity. 0 = never hide. Default 2500. */
     autoHideMs?: number;
+    /**
+     * Show an fps/resolution/quality panel in the export menu. Default false, so
+     * the export menu is unchanged unless opted in.
+     */
+    exportControls?: boolean;
 }
 export declare class PlayerUI {
     private _container;
@@ -33,6 +45,8 @@ export declare class PlayerUI {
     private _exportBtnWrapper;
     private _callbacks;
     private _autoHideMs;
+    private _exportControls;
+    private _exportPanel;
     private _hideTimeout;
     private _isVisible;
     private _isDragging;

package/dist/player/PlayerUI.d.ts.map

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

package/dist/player/SlideInteractionRenderer.d.ts

@@ -0,0 +1,32 @@
+import { Scene } from '../core/Scene';
+export declare class SlideInteractionRenderer {
+    private _target;
+    private _scene;
+    private _isIdle;
+    private _onEvent;
+    private _attached;
+    private _renderScheduled;
+    private _renderCount;
+    /**
+     * @param target - Element that pointer events bubble to (the Player
+     *   container). The canvas is a child of this element, so canvas events reach
+     *   it. The container exists even for a headless Scene, where `getCanvas()`
+     *   throws.
+     * @param scene - The scene to render.
+     * @param isIdle - Returns true when the Player is paused (no render loop
+     *   running). A render is requested only then; during playback the Player
+     *   loop already draws every frame.
+     */
+    constructor(target: HTMLElement, scene: Scene, isIdle: () => boolean);
+    /** Whether listeners are currently attached. */
+    get isAttached(): boolean;
+    /** Number of idle renders performed. Exposed for tests and introspection. */
+    get renderCount(): number;
+    /** Start listening for pointer events. Idempotent. */
+    attach(): void;
+    /** Stop listening and drop any pending render. */
+    dispose(): void;
+    private _handleEvent;
+    private _scheduleRender;
+}
+//# sourceMappingURL=SlideInteractionRenderer.d.ts.map

package/dist/player/SlideInteractionRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlideInteractionRenderer.d.ts","sourceRoot":"","sources":["../../src/player/SlideInteractionRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAgBtC,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;;;;;;OASG;gBACS,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO;IAOpE,gDAAgD;IAChD,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,6EAA6E;IAC7E,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,sDAAsD;IACtD,MAAM,IAAI,IAAI;IAQd,kDAAkD;IAClD,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,eAAe;CAYxB"}

package/dist/player/index.d.ts

@@ -1,4 +1,5 @@
 export { Player, type PlayerOptions } from './Player';
 export { PlayerUI, type PlayerUIOptions, type PlayerUICallbacks } from './PlayerUI';
 export { PlayerController, type PlayerControllerCallbacks } from './PlayerController';
+export { ExportSettingsPanel, resolveResolution, qualityToBitrate, RESOLUTION_PRESETS, FPS_PRESETS, QUALITY_PRESETS, type ExportSettings, type ResolutionPreset, type QualityPreset, type ExportDefaults, } from './ExportSettingsUI';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/serialization/defaults.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Default serializers for the common mobjects.
+ *
+ * Each serializer captures only the type-specific, constructor-relevant
+ * (unscaled) props. The framework (`serialize.ts`) captures transform, style,
+ * and children generically, so these never repeat them. Reading an unscaled
+ * base value (e.g. `_radius`, not `getRadius()`) keeps scale in the transform
+ * only, which is what makes serialize→deserialize→serialize stable.
+ *
+ * Registering runs once as an import side effect from the folder entry point.
+ */
+export declare function registerDefaultSerializers(): void;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/serialization/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/serialization/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsDH,wBAAgB,0BAA0B,IAAI,IAAI,CAuHjD"}

package/dist/serialization/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Scene serialization (best-manim).
+ *
+ * Serialize a scene or a single mobject to a plain, JSON-safe document, store
+ * or deep-link it, and reload it in another session. The format is open: new
+ * mobject types register their own serializer, so the schema grows without a
+ * central union to edit.
+ *
+ * Importing this module registers the default serializers (common geometry,
+ * groups, and text) as a side effect.
+ */
+export { serializeScene, deserializeScene, serializeMobject, deserializeMobject, } from './serialize';
+export { registerSerializableMobject, unregisterSerializableMobject, getSerializer, getSerializableTypes, } from './registry';
+export type { SerializedScene, SerializedMobject, SerializedTransform, SerializedStyle, MobjectSerializer, SceneLike, ContainerLike, Vec3, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serialization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,IAAI,GACL,MAAM,SAAS,CAAC"}

package/dist/serialization/props.d.ts

@@ -0,0 +1,16 @@
+import { Vec3 } from './types';
+/** Read a number, or `fallback` when the value is not a finite number. */
+export declare function readNumber(value: unknown, fallback: number): number;
+/** Read a string, or `fallback` when the value is not a string. */
+export declare function readString(value: unknown, fallback: string): string;
+/** Read a boolean, or `fallback` when the value is not a boolean. */
+export declare function readBoolean(value: unknown, fallback: boolean): boolean;
+/** Read an optional string: a string, or `undefined`. */
+export declare function readOptionalString(value: unknown): string | undefined;
+/** Read a `[x, y, z]` triple, or `fallback` when the value is not one. */
+export declare function readVec3(value: unknown, fallback: Vec3): Vec3;
+/** Read an array of `[x, y, z]` triples, dropping any malformed entries. */
+export declare function readVec3Array(value: unknown): Vec3[];
+/** True when `value` is a non-null, non-array object (a props/record bag). */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=props.d.ts.map

package/dist/serialization/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/serialization/props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAErE;AAWD,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAE7D;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,CAOpD;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/serialization/registry.d.ts

@@ -0,0 +1,17 @@
+import { Mobject } from '../core/Mobject';
+import { MobjectSerializer } from './types';
+/**
+ * Register a serializer for a mobject type.
+ *
+ * @param name - The type name, which must match the mobject's class name
+ *   (`mobject.constructor.name`) so instances can be looked up at capture time.
+ * @param serializer - The serialize/deserialize pair for this type.
+ */
+export declare function registerSerializableMobject<T extends Mobject>(name: string, serializer: MobjectSerializer<T>): void;
+/** Remove a registration. Mainly for tests and hot-swapping. */
+export declare function unregisterSerializableMobject(name: string): void;
+/** Look up a serializer by type name, or `undefined` when none is registered. */
+export declare function getSerializer(name: string): MobjectSerializer | undefined;
+/** The names of every registered type, sorted for stable output. */
+export declare function getSerializableTypes(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/serialization/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/serialization/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIjD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,OAAO,EAC3D,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC/B,IAAI,CAIN;AAED,gEAAgE;AAChE,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEzE;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/serialization/serialize.d.ts

@@ -0,0 +1,24 @@
+import { Mobject } from '../core/Mobject';
+import { ContainerLike, SceneLike, SerializedMobject, SerializedScene } from './types';
+/**
+ * Capture a single mobject (and its submobject tree) as a JSON-safe object.
+ *
+ * An unregistered type is captured with `unknown: true` and empty `props`, so
+ * the document still records its position in the tree for debugging, while a
+ * restore skips it.
+ */
+export declare function serializeMobject(mob: Mobject): SerializedMobject;
+/**
+ * Reconstruct a single mobject from a serialized node, or `null` when the type
+ * is unknown (unregistered or marked `unknown`). Known children are attached;
+ * unknown children are dropped.
+ */
+export declare function deserializeMobject(json: unknown): Mobject | null;
+/** Capture a whole scene (its top-level mobjects) as a JSON document. */
+export declare function serializeScene(scene: SceneLike): SerializedScene;
+/**
+ * Reconstruct the mobjects of a document and add each one to `container`.
+ * Returns the created top-level mobjects. A malformed document yields `[]`.
+ */
+export declare function deserializeScene(json: unknown, container: ContainerLike): Mobject[];
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialization/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/serialization/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGrB,MAAM,SAAS,CAAC;AAmDjB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAYhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAqBhE;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAIhE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,EAAE,CAWnF"}

package/dist/serialization/types.d.ts

@@ -0,0 +1,70 @@
+import { Mobject } from '../core/Mobject';
+/** A plain, JSON-safe triple. */
+export type Vec3 = [number, number, number];
+/** Position, rotation (Euler XYZ, radians), and scale of a mobject. */
+export interface SerializedTransform {
+    position: Vec3;
+    rotation: Vec3;
+    scale: Vec3;
+}
+/** Stroke and fill of a mobject. Only defined fields are written. */
+export interface SerializedStyle {
+    strokeColor?: string;
+    fillColor?: string;
+    strokeOpacity?: number;
+    fillOpacity?: number;
+    strokeWidth?: number;
+}
+/**
+ * One serialized mobject.
+ *
+ * `props` is `Record<string, unknown>` on purpose: each registered type owns
+ * the shape of its own props and narrows them on restore, so the schema stays
+ * open for new types without a central union to edit.
+ */
+export interface SerializedMobject {
+    /** Registered type name (its class name), e.g. `Circle`. */
+    type: string;
+    /** Constructor-relevant, unscaled properties for this type. */
+    props: Record<string, unknown>;
+    /** Position/rotation/scale, applied after construction. */
+    transform: SerializedTransform;
+    /** Stroke/fill, applied after construction. */
+    style: SerializedStyle;
+    /** Submobject tree. */
+    children: SerializedMobject[];
+    /**
+     * Present and `true` when the type had no registered serializer at capture
+     * time. Such a node is skipped (not reconstructed) on restore.
+     */
+    unknown?: boolean;
+}
+/** Current document version. Bump when the schema changes incompatibly. */
+export declare const SCENE_FORMAT = "manim-web-scene";
+export declare const SCENE_VERSION = 1;
+/** A full serialized scene document. */
+export interface SerializedScene {
+    format: typeof SCENE_FORMAT;
+    version: number;
+    mobjects: SerializedMobject[];
+}
+/**
+ * A pair of functions that convert between a concrete mobject and its `props`.
+ *
+ * `serialize` returns only the type-specific, constructor-relevant props. The
+ * transform, style, and children are captured generically by the framework, so
+ * a serializer never repeats them.
+ */
+export interface MobjectSerializer<T extends Mobject = Mobject> {
+    serialize: (mobject: T) => Record<string, unknown>;
+    deserialize: (props: Record<string, unknown>) => T;
+}
+/** Anything the framework can read top-level mobjects from (e.g. a Scene). */
+export interface SceneLike {
+    mobjects: Iterable<Mobject>;
+}
+/** Anything the framework can add reconstructed mobjects to (e.g. a Scene). */
+export interface ContainerLike {
+    add: (...mobjects: Mobject[]) => unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/serialization/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/serialization/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,iCAAiC;AACjC,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,EAAE,IAAI,CAAC;CACb;AAED,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,mBAAmB,CAAC;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,eAAe,CAAC;IACvB,uBAAuB;IACvB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAC9C,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,YAAY,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC5D,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACpD;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CAC1C"}