textmode.export.js 1.4.0 → 1.5.0

package/dist/types/exporters/video/VideoExporter.d.ts

@@ -3,32 +3,28 @@ import type { TextmodePluginContext } from 'textmode.js';
 import type { VideoExportOptions } from './types';
 /**
  * Main video exporter for the textmode.js library.
- * Orchestrates the video export process by coordinating canvas capture,
- * frame processing, and file handling.
  */
 export declare class VideoExporter {
     private readonly _recorder;
     private readonly _textmodifier;
     private readonly _registerPostDrawHook;
-    /**
-     * Creates an instance of VideoExporter.
-     *
-     * @param textmodifier The Textmodifier instance to extract data from
-     * @param registerPostDrawHook The function to register post-draw hooks
-     */
     constructor(textmodifier: Textmodifier, registerPostDrawHook: TextmodePluginContext['registerPostDrawHook']);
     /**
-     * Captures frames and saves them as a WEBM file
+     * Captures deterministic frames and saves them as a video file.
      *
      * @param options Export options
      */
-    $saveWEBM(options?: VideoExportOptions): Promise<void>;
-    /**
-     * Applies default values to video export options
-     *
-     * @param options User-provided options
-     * @returns Complete options with defaults applied
-     */
+    $saveVideo(options?: VideoExportOptions): Promise<void>;
+    private _saveVideo;
     private _applyDefaultOptions;
+    private _positiveInteger;
+    private _positiveNumber;
+    private _bitrate;
+    private _bitrateMode;
+    private _latencyMode;
+    private _hardwareAcceleration;
+    private _keyFrameInterval;
+    private _currentPixelDensity;
+    private _withExtension;
 }
 //# sourceMappingURL=VideoExporter.d.ts.map

package/dist/types/exporters/video/VideoExporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoExporter.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/VideoExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,SAAS,CAAC;AAG1E;;;;GAIG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgD;IAEtF;;;;;OAKG;gBACS,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,CAAC,sBAAsB,CAAC;IAM3G;;;;OAIG;IACU,SAAS,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAU5B"}
+{"version":3,"file":"VideoExporter.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/VideoExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,KAAK,EAIX,kBAAkB,EAIlB,MAAM,SAAS,CAAC;AAWjB;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgD;gBAE1E,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,CAAC,sBAAsB,CAAC;IAM3G;;;;OAIG;IACU,UAAU,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YAI1D,UAAU;IAqBxB,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,cAAc;CAUtB"}

package/dist/types/exporters/video/VideoExporter.test.d.ts

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

package/dist/types/exporters/video/VideoExporter.test.d.ts.map

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

package/dist/types/exporters/video/VideoFrameDriver.d.ts

@@ -0,0 +1,32 @@
+import type { Textmodifier, TextmodePluginContext } from 'textmode.js';
+import type { VideoRenderFrameOptions } from './types';
+/**
+ * Drives deterministic video export frames through public textmode APIs.
+ *
+ * The visible textmode canvas remains untouched. Each presented frame is copied
+ * into a staging canvas sized for the requested video output.
+ */
+export declare class VideoFrameDriver {
+    readonly canvas: HTMLCanvasElement;
+    private readonly _textmodifier;
+    private readonly _registerPostDrawHook;
+    private readonly _context;
+    private readonly _sourceCanvas;
+    private _pendingFrame;
+    private _syntheticFrameCount;
+    private _syntheticMillis;
+    constructor(textmodifier: Textmodifier, registerPostDrawHook: TextmodePluginContext['registerPostDrawHook'], width: number, height: number);
+    $render(options: VideoRenderFrameOptions): Promise<void>;
+    private _renderOneFrame;
+    private _capturePendingFrame;
+    private _createStagingCanvas;
+    private _captureMethodSnapshots;
+    private _capturePropertySnapshots;
+    private _shadowTimingProperties;
+    private _shadowTimingMethods;
+    private _shadowResizeCanvas;
+    private _restoreMethods;
+    private _restoreProperties;
+    private _throwIfAborted;
+}
+//# sourceMappingURL=VideoFrameDriver.d.ts.map

package/dist/types/exporters/video/VideoFrameDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameDriver.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/VideoFrameDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAoCvD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC5B,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgD;IACtF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,gBAAgB,CAAa;gBAGpC,YAAY,EAAE,YAAY,EAC1B,oBAAoB,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,EACnE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;IAeF,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDrE,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,eAAe;CAKvB"}

package/dist/types/exporters/video/VideoFrameDriver.test.d.ts

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

package/dist/types/exporters/video/VideoFrameDriver.test.d.ts.map

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

package/dist/types/exporters/video/VideoRecorder.d.ts

@@ -1,28 +1,15 @@
-import type { TextmodePluginContext } from 'textmode.js';
-import type { VideoExportProgress, VideoGenerationOptions } from './types';
+import type { VideoExportProgress, VideoFrameDriverLike, VideoGenerationOptions } from './types';
 /**
- * Records frames from a canvas to create WEBM video files.
- * Captures frames at specified intervals using textmode.js post-draw hooks
- * and encodes them into a WEBM video format.
+ * Records deterministic textmode frames through WebCodecs and muxes them with Mediabunny.
  */
 export declare class VideoRecorder {
-    /**
-     * Records a sequence of frames from the provided canvas and encodes them as a WEBM video.
-     *
-     * @param canvas - Source canvas to capture frames from
-     * @param options - Video generation options
-     * @param registerPostDrawHook - Hook registration function from textmode.js API
-     * @param onProgress - Optional callback for recording progress updates
-     * @returns Promise resolving to a Blob containing the encoded WEBM video
-     * @throws {Error} If frame capture or encoding fails
-     */
-    $record(canvas: HTMLCanvasElement, options: VideoGenerationOptions, registerPostDrawHook: TextmodePluginContext['registerPostDrawHook'], onProgress?: (progress: VideoExportProgress) => void): Promise<Blob>;
-    /**
-     * Creates a reusable snapshot function for capturing canvas frames.
-     * Uses a cached canvas and context to avoid repeated allocations.
-     *
-     * @returns Function that takes a canvas and returns a snapshot canvas
-     */
-    private _createSnapshotSurface;
+    $record(options: VideoGenerationOptions, frameDriver: VideoFrameDriverLike, onProgress?: (progress: VideoExportProgress) => void): Promise<Blob>;
+    private _createEncodingPlan;
+    private _assertWebCodecsAvailable;
+    private _resolveBitrate;
+    private _throwIfAborted;
+    private _emitProgress;
+    private _normalizeError;
+    private _log;
 }
 //# sourceMappingURL=VideoRecorder.d.ts.map

package/dist/types/exporters/video/VideoRecorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/VideoRecorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAG3E;;;;GAIG;AACH,qBAAa,aAAa;IACzB;;;;;;;;;OASG;IACU,OAAO,CACnB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,sBAAsB,EAC/B,oBAAoB,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,EACnE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAClD,OAAO,CAAC,IAAI,CAAC;IAyIhB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;CAsD9B"}
+{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/VideoRecorder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAIX,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CACnB,OAAO,EAAE,sBAAsB,EAC/B,WAAW,EAAE,oBAAoB,EACjC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAClD,OAAO,CAAC,IAAI,CAAC;YAsDF,mBAAmB;IAgDjC,OAAO,CAAC,yBAAyB;IAcjC,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,IAAI;CAKZ"}

package/dist/types/exporters/video/VideoRecorder.test.d.ts

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

package/dist/types/exporters/video/VideoRecorder.test.d.ts.map

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

package/dist/types/exporters/video/errors.d.ts

@@ -0,0 +1,9 @@
+import type { VideoExportErrorCode } from './types';
+export declare class VideoExportError extends Error {
+    readonly code: VideoExportErrorCode;
+    readonly cause?: unknown;
+    constructor(code: VideoExportErrorCode, message: string, cause?: unknown);
+}
+export declare function createAbortError(): VideoExportError;
+export declare function isAbortError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/exporters/video/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,SAAgB,IAAI,EAAE,oBAAoB,CAAC;IAC3C,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAMxE;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD"}

package/dist/types/exporters/video/index.d.ts

@@ -1,4 +1,6 @@
 export { VideoExporter } from './VideoExporter';
+export { VideoFrameDriver } from './VideoFrameDriver';
 export { VideoRecorder } from './VideoRecorder';
-export type { VideoExportOptions, VideoExportProgress, VideoGenerationOptions, VideoRecordingState } from './types';
+export { VideoExportError } from './errors';
+export type { VideoBitrateMode, VideoBitratePreset, VideoEncodingPlan, VideoExportErrorCode, VideoExportFormat, VideoExportOptions, VideoExportPhase, VideoFrameDriverLike, VideoHardwareAcceleration, VideoLatencyMode, VideoExportProgress, VideoGenerationOptions, VideoRecordingState, VideoRenderFrameOptions, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/exporters/video/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EACX,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,GACvB,MAAM,SAAS,CAAC"}

package/dist/types/exporters/video/types.d.ts

@@ -1,4 +1,51 @@
+/**
+ * Lifecycle state reported while a video export is being prepared, recorded, encoded, or completed.
+ */
 export type VideoRecordingState = 'idle' | 'recording' | 'encoding' | 'completed' | 'error';
+/**
+ * More granular phase information for progress UIs that need to distinguish setup, rendering, and finalization.
+ */
+export type VideoExportPhase = 'probing' | 'rendering' | 'encoding' | 'finalizing';
+export type VideoCodec = 'vp8' | 'vp9' | 'avc' | (string & {});
+/**
+ * Subjective bitrate preset used when an exact bits-per-second value is not supplied.
+ *
+ * Higher presets produce larger files with more detail. For exact control, pass a numeric
+ * `bitrate` value in bits per second instead.
+ */
+export type VideoBitratePreset = 'low' | 'medium' | 'high';
+/**
+ * Video container format written by `saveVideo`.
+ */
+export type VideoExportFormat = 'webm' | 'mp4';
+/**
+ * Bitrate allocation strategy for the native encoder.
+ *
+ * - `'variable'`: lets the encoder spend more bits on visually complex frames and fewer bits on simple frames.
+ *   This is usually the best default for generative animations.
+ * - `'constant'`: asks the encoder to keep the bitrate steadier throughout the export. This can make file size
+ *   more predictable, but may waste bits on simple frames or reduce detail on complex frames.
+ */
+export type VideoBitrateMode = 'variable' | 'constant';
+/**
+ * Encoder scheduling mode.
+ *
+ * - `'quality'`: prioritizes complete, stable export output. Mediabunny notes that this mode prevents dropped frames.
+ * - `'realtime'`: prioritizes low-latency encoding. It is intended for live streams and may drop frames when overloaded,
+ *   so it is usually not recommended for frame-perfect exports.
+ */
+export type VideoLatencyMode = 'quality' | 'realtime';
+/**
+ * WebCodecs hardware acceleration preference.
+ *
+ * This is a browser hint rather than a guarantee:
+ * - `'no-preference'`: let the browser choose the best available encoder.
+ * - `'prefer-hardware'`: prefer GPU/ASIC encoding when available, often faster and more power-efficient, but codec
+ *   availability and output characteristics vary by device.
+ * - `'prefer-software'`: prefer CPU encoding, often more consistent across machines, but usually slower.
+ */
+export type VideoHardwareAcceleration = 'no-preference' | 'prefer-hardware' | 'prefer-software';
+export type VideoExportErrorCode = 'VIDEO_EXPORT_UNSUPPORTED' | 'VIDEO_CODEC_UNSUPPORTED' | 'VIDEO_EXPORT_ABORTED' | 'VIDEO_EXPORT_FAILED' | 'VIDEO_TRANSPARENCY_UNSUPPORTED';
 /**
  * Progress information emitted during the video export process.
  */
@@ -6,15 +53,27 @@ export type VideoExportProgress = {
     /**
      * Current state of the recording process.
      */
-    state: 'idle' | 'recording' | 'encoding' | 'completed' | 'error';
+    state: VideoRecordingState;
+    /**
+     * Current export phase for newer progress UIs.
+     */
+    phase?: VideoExportPhase;
     /**
      * Number of frames that have been recorded so far.
      */
     frameIndex?: number;
+    /**
+     * Alias for {@link frameIndex}. Prefer this field in new code.
+     */
+    frame?: number;
     /**
      * Total number of frames planned for the recording.
      */
     totalFrames?: number;
+    /**
+     * Export completion ratio between `0` and `1`.
+     */
+    progress?: number;
     /**
      * Optional status message for UI consumption.
      */
@@ -28,6 +87,10 @@ export type VideoExportOptions = {
      * Target filename without extension. Defaults to an auto-generated value.
      */
     filename?: string;
+    /**
+     * Video container format. Defaults to `'mp4'`.
+     */
+    format?: VideoExportFormat;
     /**
      * Desired total number of frames to capture. Defaults to `300`.
      */
@@ -37,11 +100,52 @@ export type VideoExportOptions = {
      */
     frameRate?: number;
     /**
-     * Encoder quality between 0.0 and 1.0. Higher values request higher fidelity. Defaults to `1.0` *(lossless)*.
+     * Target bitrate in bits per second or a bitrate preset. Defaults to `'medium'`.
+     *
+     * Bitrate controls how much encoded data is available per second of video. Higher values can preserve more detail
+     * in noisy or fast-changing sketches, but create larger files. Presets are resolved from the export dimensions and
+     * frame rate; numeric values are passed directly to the encoder.
+     */
+    bitrate?: number | VideoBitratePreset;
+    /**
+     * Encoder bitrate allocation mode. Defaults to `'variable'`.
+     *
+     * Use `'variable'` for most exports so simple frames can compress efficiently and complex frames can receive more
+     * bits. Use `'constant'` only when a steadier data rate is more important than compression efficiency.
+     */
+    bitrateMode?: VideoBitrateMode;
+    /**
+     * Encoder latency mode. Defaults to `'quality'`.
+     *
+     * Use `'quality'` for deterministic exports; it prioritizes completed output and avoids dropped frames. Use
+     * `'realtime'` only for low-latency use cases where dropped frames are acceptable.
+     */
+    latencyMode?: VideoLatencyMode;
+    /**
+     * WebCodecs hardware acceleration hint. Defaults to `'no-preference'`.
+     *
+     * Browsers may ignore this hint. `'prefer-hardware'` can be faster on supported devices; `'prefer-software'` can be
+     * more predictable but slower. `'no-preference'` lets the browser choose.
+     */
+    hardwareAcceleration?: VideoHardwareAcceleration;
+    /**
+     * Key frame interval in seconds. Defaults to `2`.
+     *
+     * Key frames are independently decodable frames used for seeking and recovery. Shorter intervals improve seeking
+     * responsiveness but increase file size. Longer intervals can shrink files but make seeking less precise.
+     * Use `0` to request every frame as a key frame.
+     */
+    keyFrameInterval?: number;
+    /**
+     * Pixel density used during export. Defaults to `1` so video dimensions match the live canvas.
      */
-    quality?: number;
+    pixelDensity?: number;
     /**
-     * When true, attempts to preserve alpha data in the recording *(experimental)*. Defaults to `false`.
+     * Abort signal for cancelling an in-progress export.
+     */
+    signal?: AbortSignal;
+    /**
+     * When true, attempts to preserve alpha data in WebM recordings. MP4 exports reject this option.
      */
     transparent?: boolean;
     /**
@@ -55,10 +159,48 @@ export type VideoExportOptions = {
 };
 export interface VideoGenerationOptions {
     filename?: string;
+    format: VideoExportFormat;
     frameRate: number;
     frameCount: number;
-    quality: number;
+    bitrate: number | VideoBitratePreset;
+    bitrateMode: VideoBitrateMode;
+    latencyMode: VideoLatencyMode;
+    hardwareAcceleration: VideoHardwareAcceleration;
+    keyFrameInterval: number;
+    pixelDensity: number;
+    width: number;
+    height: number;
     transparent: boolean;
     debugLogging: boolean;
+    signal?: AbortSignal;
+}
+export interface VideoEncodingPlan {
+    format: VideoExportFormat;
+    extension: '.webm' | '.mp4';
+    mimeType: string;
+    codec: VideoCodec;
+    bitrate: number;
+    bitrateMode: VideoBitrateMode;
+    latencyMode: VideoLatencyMode;
+    hardwareAcceleration: VideoHardwareAcceleration;
+    keyFrameInterval: number;
+    frameRate: number;
+    frameCount: number;
+    width: number;
+    height: number;
+    transparent: boolean;
+}
+export interface VideoRenderFrameOptions {
+    frameCount: number;
+    frameRate: number;
+    signal?: AbortSignal;
+    onFrame(frame: {
+        frameIndex: number;
+        canvas: HTMLCanvasElement;
+    }): Promise<void> | void;
+}
+export interface VideoFrameDriverLike {
+    readonly canvas: HTMLCanvasElement;
+    $render(options: VideoRenderFrameOptions): Promise<void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types/exporters/video/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IACjE;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACrD;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/types.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -21,7 +21,7 @@
  *
  * ### Animation formats
  * - {@link GIFExportOptions | GIF} - Save as animated GIF
- * - {@link VideoExportOptions | WEBM} - Save as video file
+ * - {@link VideoExportOptions | Video} - Save as WebM or MP4 video
  *
  * @module textmode.export.js
  */
@@ -33,7 +33,7 @@ export type { SVGExportOptions } from './exporters/svg';
 export type { TXTExportOptions } from './exporters/txt';
 export type { JSONCellCollection, JSONCellTransform, JSONColorValue, JSONDocumentFormat, JSONDocumentVersion, JSONExportColorMode, JSONExportMetadata, JSONExportOptions, JSONExportTarget, JSONLayerGrid, JSONObjectRowCell, JSONObjectRowsCellCollection, JSONRGBAColor, TextmodeAllDocumentJSON, TextmodeDocumentJSON, TextmodeDocumentLayer, TextmodeSelectedDocumentJSON, TextmodeSelectedDocumentLayer, } from './exporters/json';
 export type { GIFExportOptions, GIFExportProgress } from './exporters/gif';
-export type { VideoExportOptions, VideoExportProgress } from './exporters/video';
+export type { VideoBitrateMode, VideoBitratePreset, VideoExportErrorCode, VideoExportFormat, VideoExportOptions, VideoExportPhase, VideoExportProgress, VideoHardwareAcceleration, VideoLatencyMode, VideoRecordingState, } from './exporters/video';
 export type { LayerExportOptions } from './exporters/base';
 /**
  * Export plugin for textmode.js.
@@ -43,31 +43,7 @@ export type { LayerExportOptions } from './exporters/base';
  * access to all export options, which can be controlled at runtime.
  *
  * @example
- * ```js
- * import { textmode } from 'textmode.js';
- * import { ExportPlugin } from 'textmode.export.js';
- *
- * const t = textmode.create({
- *     plugins: [ExportPlugin]
- * });
- *
- * t.draw(() => {
- *     t.background(0);
- *     t.char('A');
- *     t.rotateZ(t.frameCount);
- *     t.rect(16, 16);
- * });
- *
- * // Export methods are now available
- * t.saveCanvas({ format: 'png', scale: 2.0 });
- * t.saveSVG({ filename: 'my-artwork' });
- * t.saveGIF({ duration: 3, fps: 30 });
- *
- * // Control overlay visibility at runtime
- * t.exportOverlay.hide();  // Hide the overlay
- * t.exportOverlay.show();  // Show the overlay
- * t.exportOverlay.toggle(); // Toggle visibility
- * ```
+ * {@includeCode ../examples/ExportPlugin/init/sketch.js}
  */
 export declare const ExportPlugin: TextmodePlugin;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,aAAa,CAAC;AASzE,OAAO,KAAK,EAAqB,2BAA2B,EAA2B,MAAM,SAAS,CAAC;AAIvG,YAAY,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvG,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EACX,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,4BAA4B,EAC5B,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAO3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,YAAY,EAAE,cAqL1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,0BAA0B,GAAI,UAAS,2BAAgC,KAAG,cAkBtF,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,0BAA0B,CAAC,EAAE,OAAO,0BAA0B,CAAC;KAC/D;CACD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,aAAa,CAAC;AASzE,OAAO,KAAK,EAAqB,2BAA2B,EAA2B,MAAM,SAAS,CAAC;AAIvG,YAAY,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvG,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EACX,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,4BAA4B,EAC5B,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EACX,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAO3D;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,EAAE,cAqL1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,0BAA0B,GAAI,UAAS,2BAAgC,KAAG,cAkBtF,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,0BAA0B,CAAC,EAAE,OAAO,0BAA0B,CAAC;KAC/D;CACD"}

package/dist/types/overlay/blades/VideoBlade.d.ts

@@ -2,9 +2,15 @@ import type { VideoExportOptions, VideoExportProgress, VideoRecordingState } fro
 import type { BladeConfig } from './Blade';
 import { Blade } from './Blade';
 export declare class VideoBlade extends Blade<VideoExportOptions> {
+    private formatSelect;
+    private bitrateSelect;
     private frameRateInput;
     private frameCountInput;
-    private qualityInput;
+    private bitrateModeSelect;
+    private latencyModeSelect;
+    private hardwareAccelerationSelect;
+    private keyFrameIntervalInput;
+    private transparencyInput;
     private status;
     private recordingState;
     constructor(config: BladeConfig<VideoExportOptions>);
@@ -18,5 +24,8 @@ export declare class VideoBlade extends Blade<VideoExportOptions> {
     private syncStatus;
     private resolvePlannedFrameCount;
     private applyDefaults;
+    private resolveBitratePreset;
+    private readonly handleFormatChange;
+    private syncTransparencyAvailability;
 }
 //# sourceMappingURL=VideoBlade.d.ts.map

package/dist/types/overlay/blades/VideoBlade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoBlade.d.ts","sourceRoot":"","sources":["../../../../src/overlay/blades/VideoBlade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAO1G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AA+ChC,qBAAa,UAAW,SAAQ,KAAK,CAAC,kBAAkB,CAAC;IACxD,OAAO,CAAC,cAAc,CAMpB;IAEF,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,YAAY,CAMlB;IAEF,OAAO,CAAC,MAAM,CAOZ;IAEF,OAAO,CAAC,cAAc,CAA+B;gBAEzC,MAAM,EAAE,WAAW,CAAC,kBAAkB,CAAC;IAInD,MAAM,IAAI,WAAW;IAuCrB,UAAU,IAAI,kBAAkB;IAahC,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI,OAAO;IAWnB,WAAW,IAAI,OAAO;IAItB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAUnF,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAInD,OAAO,CAAC,UAAU;IA+BlB,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,aAAa;CAarB"}
+{"version":3,"file":"VideoBlade.d.ts","sourceRoot":"","sources":["../../../../src/overlay/blades/VideoBlade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIX,kBAAkB,EAClB,mBAAmB,EAGnB,mBAAmB,EACnB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAehC,qBAAa,UAAW,SAAQ,KAAK,CAAC,kBAAkB,CAAC;IACxD,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,aAAa,CAUnB;IAEF,OAAO,CAAC,cAAc,CAMpB;IAEF,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,iBAAiB,CASvB;IAEF,OAAO,CAAC,iBAAiB,CASvB;IAEF,OAAO,CAAC,0BAA0B,CAUhC;IAEF,OAAO,CAAC,qBAAqB,CAM3B;IAEF,OAAO,CAAC,iBAAiB,CAMvB;IAEF,OAAO,CAAC,MAAM,CAOZ;IAEF,OAAO,CAAC,cAAc,CAA+B;gBAEzC,MAAM,EAAE,WAAW,CAAC,kBAAkB,CAAC;IAInD,MAAM,IAAI,WAAW;IA4FrB,UAAU,IAAI,kBAAkB;IA2BhC,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI,OAAO;IAcnB,WAAW,IAAI,OAAO;IAItB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAgBnF,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAInD,OAAO,CAAC,UAAU;IAmClB,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAEjC;IAEF,OAAO,CAAC,4BAA4B;CAYpC"}

package/dist/types/overlay/formatRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatRegistry.d.ts","sourceRoot":"","sources":["../../../src/overlay/formatRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,wBAAgB,0BAA0B,CACzC,mBAAmB,CAAC,EAAE,mBAAmB,GACvC,aAAa,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAgG/C"}
+{"version":3,"file":"formatRegistry.d.ts","sourceRoot":"","sources":["../../../src/overlay/formatRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,wBAAgB,0BAA0B,CACzC,mBAAmB,CAAC,EAAE,mBAAmB,GACvC,aAAa,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAsG/C"}

package/dist/types/types.d.ts

@@ -47,6 +47,9 @@ export interface ExportOverlayController {
 }
 /**
  * Runtime export helpers that `createExportPlugin` attaches to the `Textmodifier` instance.
+ *
+ * @example
+ * {@includeCode ../examples/ExportPlugin/layerTargets/sketch.js}
  */
 export interface TextmodeExportAPI {
     /**
@@ -171,16 +174,25 @@ export interface TextmodeExportAPI {
      */
     saveGIF(options?: GIFExportOptions): Promise<void>;
     /**
-     * Captures a WEBM video and saves it to disk.
+     * Captures a video and saves it to disk *(`'mp4'` by default)*.
      *
      * @param options Export options.
      *
      * @example
      * ```ts
-     * await t.saveWEBM({ frameCount: 240, frameRate: 60, filename: 'capture' });
+     * await t.saveVideo({ frameCount: 240, frameRate: 60, filename: 'capture' });
+     * await t.saveVideo({
+     *     format: 'webm',
+     *     bitrate: 'high',
+     *     bitrateMode: 'variable',
+     *     latencyMode: 'quality',
+     *     keyFrameInterval: 2,
+     *     frameCount: 240,
+     *     filename: 'capture',
+     * });
      * ```
      */
-    saveWEBM(options?: VideoExportOptions): Promise<void>;
+    saveVideo(options?: VideoExportOptions): Promise<void>;
 }
 /**
  * Options for configuring the export plugin.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;;;;;;OAOG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;;;;;;OAOG;IACH,SAAS,IAAI,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,aAAa,EAAE,uBAAuB,CAAC;IAEvC;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE1C;;;;;;;;;OASG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE9C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAE7C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;IAE1D;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAElD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;;;;;;OAOG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;;;;;;OAOG;IACH,SAAS,IAAI,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,aAAa,EAAE,uBAAuB,CAAC;IAEvC;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE1C;;;;;;;;;OASG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE9C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAE7C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;IAE1D;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAElD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "textmode.export.js",
-	"version": "1.4.0",
+	"version": "1.5.0",
 	"description": "Export plugin for textmode.js - Save your creations as images, GIFs, videos, SVG, JSON, and plain text.",
 	"type": "module",
 	"main": "./dist/textmode.export.umd.js",
@@ -47,7 +47,7 @@
 	},
 	"dependencies": {
 		"gifenc": "^1.0.1",
-		"webm-writer": "^1.0.0"
+		"mediabunny": "^1.45.4"
 	},
 	"devDependencies": {
 		"@commitlint/cli": "^20.5.0",
@@ -73,7 +73,7 @@
 		"prettier": "^3.8.3",
 		"semantic-release": "^25.0.3",
 		"terser": "^5.44.0",
-		"textmode.js": "^0.13.0",
+		"textmode.js": "^0.16.0",
 		"typedoc": "^0.28.19",
 		"typedoc-plugin-frontmatter": "^1.3.1",
 		"typedoc-plugin-markdown": "^4.11.0",