manim-web 0.12.0 → 0.14.0

package/dist/mobjects/image/AnimatedImageMobject.d.ts

@@ -0,0 +1,141 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { TexturedMobject } from '../../core/TexturedMobject';
+import { GifDecoder } from './gifDecoder';
+import * as THREE from 'three';
+export type { DecodedGif, DecodedGifFrame, GifDecoder } from './gifDecoder';
+/**
+ * Options for creating an {@link AnimatedImageMobject}.
+ */
+export interface AnimatedImageMobjectOptions {
+    /** GIF source: URL or base64 data URI. Required. */
+    source: string;
+    /** Loop back to the first frame after the last. Default: true */
+    loop?: boolean;
+    /** Start playing as soon as the GIF decodes. Default: false */
+    autoplay?: boolean;
+    /** Override the GIF frame rate (frames per second). Default: use GIF delays */
+    fps?: number;
+    /** Width of the image in scene units. Default: auto from aspect ratio */
+    width?: number;
+    /** Height of the image in scene units. Default: auto from aspect ratio */
+    height?: number;
+    /** If both width and height given, fit inside the box preserving aspect. Default: true */
+    scaleToFit?: boolean;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Render both sides of the plane. Default: false */
+    doubleSided?: boolean;
+}
+/**
+ * Inject a GIF decoder, replacing the lazy-loaded `gifuct-js` decoder. Pass
+ * `null` to restore the default. Tests use this to decode a mock GIF with no
+ * network or `gifuct-js` dependency.
+ */
+export declare function setGifDecoder(decoder: GifDecoder | null): void;
+/**
+ * AnimatedImageMobject - play an animated GIF as a movable, scalable mobject.
+ *
+ * The GIF is decoded to RGBA frames (see {@link gifDecoder}) and each frame is
+ * drawn through a `THREE.DataTexture` on a `THREE.PlaneGeometry`, mirroring how
+ * `ImageMobject` draws a still image. It therefore participates in the standard
+ * mobject transforms, z-index/depth, opacity, and `scene.add`. During play an
+ * updater advances the frame by elapsed time; call {@link syncToTime} on scrub
+ * or seek so the displayed frame follows the scene time.
+ *
+ * @example
+ * ```typescript
+ * const gif = new AnimatedImageMobject({ source: 'spin.gif', width: 4, loop: true });
+ * scene.add(gif);
+ * await gif.waitForLoad();
+ * gif.play();
+ * ```
+ */
+export declare class AnimatedImageMobject extends TexturedMobject {
+    protected _source: string;
+    protected _loop: boolean;
+    protected _autoplay: boolean;
+    protected _fps: number | undefined;
+    protected _width: number | undefined;
+    protected _height: number | undefined;
+    protected _scaleToFit: boolean;
+    protected _centerPoint: Vector3Tuple;
+    protected _doubleSided: boolean;
+    protected _frames: Uint8ClampedArray[];
+    protected _frameDurations: number[];
+    protected _frameTextures: (THREE.DataTexture | null)[];
+    protected _totalDurationMs: number;
+    protected _currentFrame: number;
+    protected _accumulatorMs: number;
+    protected _playing: boolean;
+    protected _texture: THREE.DataTexture | null;
+    protected _loaded: boolean;
+    protected _loadError: Error | null;
+    protected _naturalWidth: number;
+    protected _naturalHeight: number;
+    private _mesh;
+    private _loadPromise;
+    private _loadResolve;
+    private _loadReject;
+    constructor(options: AnimatedImageMobjectOptions);
+    /** Decode the GIF, then ingest its frames. Node/SSR-safe: never throws. */
+    private _startLoad;
+    /** Store decoded frames, compute durations, and show the first frame. */
+    private _ingest;
+    /** Record a load error and reject the ready promise once. */
+    private _failLoad;
+    /** Advance playback by `deltaMs`, honouring per-frame delays and loop. */
+    private _advance;
+    /** Build (or reuse) the texture for `index` and show it. */
+    private _setFrame;
+    /** Create an upright RGBA DataTexture from a full-canvas frame buffer. */
+    private _createFrameTexture;
+    /** Promise that resolves once the GIF decodes and rejects on decode error. */
+    waitForLoad(): Promise<void>;
+    /** The captured load error, or null when no error occurred. */
+    getLoadError(): Error | null;
+    /** Whether the GIF has decoded and the first frame is ready. */
+    isLoaded(): boolean;
+    /** The GIF source URL or data URI. */
+    getSource(): string;
+    /** Number of decoded frames (0 until the GIF loads). */
+    get frameCount(): number;
+    /** Index of the frame currently displayed. */
+    get currentFrame(): number;
+    /** Total play time of one loop, in seconds (0 until loaded). */
+    get duration(): number;
+    /** Whether playback is currently running. */
+    isPlaying(): boolean;
+    /** Start or resume playback. */
+    play(): this;
+    /** Pause playback on the current frame. */
+    pause(): this;
+    /** Jump to a frame index, clamped to [0, frameCount - 1]. */
+    seek(frame: number): this;
+    /** Enable or disable looping. */
+    setLoop(loop: boolean): this;
+    /**
+     * Follow the Player clock: show the frame at `sceneTime` seconds. Use this on
+     * scrub and seek so the displayed frame tracks the timeline position.
+     */
+    syncToTime(sceneTime: number): this;
+    /** Display dimensions from width/height options and the natural size. */
+    private _calculateDimensions;
+    protected _createThreeObject(): THREE.Object3D;
+    getDisplayMeshLength(): number;
+    getDisplayMeshes(): THREE.Mesh[];
+    applyTextureFrom(other: TexturedMobject): void;
+    applyVisualSize(width: number, height: number): void;
+    applyContentFrom(other: TexturedMobject): void;
+    protected _updateGeometry(): void;
+    protected _syncMaterialToThree(): void;
+    getBoundingBox(): {
+        width: number;
+        height: number;
+        depth: number;
+    };
+    copy(): AnimatedImageMobject;
+    dispose(): void;
+}
+//# sourceMappingURL=AnimatedImageMobject.d.ts.map

package/dist/mobjects/image/AnimatedImageMobject.d.ts.map

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

package/dist/mobjects/image/gifDecoder.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GIF decoding seam for {@link AnimatedImageMobject}.
+ *
+ * The browser decodes a multi-frame GIF to an array of fully composited RGBA
+ * frames plus per-frame delays. Decoding is done with the small, well
+ * maintained `gifuct-js` library, which is LAZY-LOADED through a dynamic
+ * `import()`. The static module graph never references `gifuct-js`, so the base
+ * bundle stays small and SSR / Node never pull the decoder in for users who do
+ * not touch animated GIFs. The dynamic import specifier is a literal, so
+ * bundlers emit a separate chunk and static analysers (knip) still see the
+ * dependency as used.
+ *
+ * Tests inject a mock decoder through `AnimatedImageMobject.setGifDecoder`,
+ * which bypasses the dynamic import and the network entirely.
+ */
+/** One decoded GIF frame: a full-canvas RGBA buffer and its display delay. */
+export interface DecodedGifFrame {
+    /** Row-major RGBA pixels for the whole canvas (length = width * height * 4). */
+    data: Uint8ClampedArray;
+    /** How long this frame stays on screen, in milliseconds. */
+    delay: number;
+}
+/** A decoded animated GIF: canvas size and the composited frames. */
+export interface DecodedGif {
+    /** Canvas width in pixels. */
+    width: number;
+    /** Canvas height in pixels. */
+    height: number;
+    /** Composited frames in play order. */
+    frames: DecodedGifFrame[];
+}
+/**
+ * A function that decodes a GIF source (URL or data URI) to {@link DecodedGif}.
+ * This is the dependency-injection seam: tests set a mock decoder so the real
+ * `gifuct-js` decoder and the network are never used.
+ */
+export type GifDecoder = (source: string) => Promise<DecodedGif>;
+/**
+ * Default browser GIF decoder: fetch the bytes, then decode with `gifuct-js`.
+ *
+ * Node/SSR-safe: it refuses when there is no DOM instead of throwing at import
+ * time. The decode itself is pure data work, but requiring a browser keeps this
+ * a browser-only feature and makes the Node path fail fast and deterministically.
+ */
+export declare const defaultGifDecoder: GifDecoder;
+//# sourceMappingURL=gifDecoder.d.ts.map

package/dist/mobjects/image/gifDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gifDecoder.d.ts","sourceRoot":"","sources":["../../../src/mobjects/image/gifDecoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,IAAI,EAAE,iBAAiB,CAAC;IACxB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAuFjE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAkB/B,CAAC"}

package/dist/mobjects/text/Code.d.ts

@@ -1,6 +1,7 @@
 import { VMobject } from '../../core/VMobject';
 import { Vector3Tuple } from '../../core/Mobject';
-import { Token, CodeColorScheme } from './CodeHighlighting';
+import { Token, TokenType, CodeColorScheme } from './CodeHighlighting';
+import { CodeToken } from './CodeTokenLayout';
 import * as THREE from 'three';
 export { type Token, type TokenType, type CodeColorScheme, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, } from './CodeHighlighting';
 /**
@@ -142,6 +143,27 @@ export declare class Code extends VMobject {
         position: Vector3Tuple;
         tokens: Token[];
     } | null;
+    /**
+     * Get a flat list of tokens with their world-space positions.
+     *
+     * The positions come from the same layout as the rendered block, computed
+     * without a 2D canvas so this also works in a headless environment.
+     * `TransformMatchingCode` uses this to match unchanged tokens between two
+     * Code blocks and animate only the difference.
+     *
+     * @returns One {@link CodeToken} per token, in reading order.
+     */
+    getCodeTokens(): CodeToken[];
+    /**
+     * Build a standalone Code mobject that renders a single token, styled like
+     * this block. The token keeps its syntax color, has no line numbers and no
+     * background. `TransformMatchingCode` uses this to animate single tokens.
+     *
+     * @param text - The token text.
+     * @param type - The syntax type that selects the color.
+     * @returns A new single-token Code mobject.
+     */
+    makeTokenMobject(text: string, type: TokenType): Code;
     /**
      * Highlight a range of lines with a background color
      * @param startLine - Starting line number (1-based)

package/dist/mobjects/text/Code.d.ts.map

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

package/dist/mobjects/text/CodeTokenLayout.d.ts

@@ -0,0 +1,44 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { Token, TokenType } from './CodeHighlighting';
+/**
+ * A single token of a Code block with its position.
+ */
+export interface CodeToken {
+    /** The token text. */
+    text: string;
+    /** The syntax type of the token. */
+    type: TokenType;
+    /** Zero-based index of the line that holds the token. */
+    line: number;
+    /** Zero-based index of the token within its line. */
+    tokenIndex: number;
+    /** World-space position of the left edge of the token. */
+    position: Vector3Tuple;
+}
+/**
+ * Inputs for {@link computeCodeTokens}. These mirror the Code mobject fields.
+ */
+export interface CodeTokenLayoutParams {
+    /** Parsed lines (tabs already expanded to spaces). */
+    lines: string[];
+    /** Tokens for each line. */
+    tokenizedLines: Token[][];
+    /** Font size in pixels. */
+    fontSize: number;
+    /** Line height multiplier. */
+    lineHeight: number;
+    /** Background padding in pixels. */
+    backgroundPadding: number;
+    /** Whether line numbers take horizontal space. */
+    lineNumbers: boolean;
+    /** World-space position (center) of the Code block. */
+    position: Vector3Tuple;
+}
+/**
+ * Compute the flat list of tokens with world-space positions.
+ *
+ * @param params - The Code block layout inputs.
+ * @returns One {@link CodeToken} per token, in reading order.
+ */
+export declare function computeCodeTokens(params: CodeTokenLayoutParams): CodeToken[];
+//# sourceMappingURL=CodeTokenLayout.d.ts.map

package/dist/mobjects/text/CodeTokenLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeTokenLayout.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/CodeTokenLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAWtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,cAAc,EAAE,KAAK,EAAE,EAAE,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,EAAE,CAiD5E"}

package/dist/mobjects/text/index.d.ts

@@ -21,6 +21,7 @@ export { renderTypstToSVG, preloadTypst, isTypstLoaded, setTypstCompiler, type T
 export { DecimalNumber, Integer, type DecimalNumberOptions } from './DecimalNumber';
 export { Variable, type VariableOptions } from './Variable';
 export { Code, type CodeOptions, type CodeColorScheme, type Token, type TokenType, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, } from './Code';
+export { type CodeToken, type CodeTokenLayoutParams } from './CodeTokenLayout';
 export { SingleStringMathTex, type SingleStringMathTexOptions, MathTexPart, type MathTexPartOptions, } from './MathTexParts';
 export { BulletedList, Title, MarkdownText, type BulletedListOptions, type TitleOptions, type MarkdownTextOptions, } from './TextExtensions';
 //# sourceMappingURL=index.d.ts.map

package/dist/mobjects/text/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG1F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAI7C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG1F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAI7C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}

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"}