textmode.export.js 0.0.1

package/dist/types/exporters/svg/SVGDataExtractor.d.ts

@@ -0,0 +1,34 @@
+import type { FramebufferData, SVGCellData } from './types';
+import { DataExtractor } from '../base';
+import type { TextmodeGrid } from 'textmode.js';
+/**
+ * Extracts and processes data from framebuffers for SVG generation.
+ * This class handles the conversion of raw pixel data into structured data objects.
+ */
+export declare class SVGDataExtractor extends DataExtractor {
+    /**
+     * Extracts transform data from transform pixels
+     * @param transformPixels Transform framebuffer pixels
+     * @param rotationPixels Rotation framebuffer pixels
+     * @param pixelIndex Pixel index in the array
+     * @returns Transform data object
+     */
+    private _extractTransformData;
+    /**
+     * Calculates cell position information
+     * @param x Grid X coordinate
+     * @param y Grid Y coordinate
+     * @param gridInfo Grid information
+     * @returns Position data object
+     */
+    private _calculateCellPosition;
+    /**
+     * Processes all grid cells and extracts SVG cell data
+     * @param framebufferData Raw pixel data from framebuffers
+     * @param grid Grid information
+     * @param font Font information
+     * @returns Array of SVG cell data objects
+     */
+    $extractSVGCellData(framebufferData: FramebufferData, grid: TextmodeGrid): SVGCellData[];
+}
+//# sourceMappingURL=SVGDataExtractor.d.ts.map

package/dist/types/exporters/svg/SVGDataExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SVGDataExtractor.d.ts","sourceRoot":"","sources":["../../../../src/exporters/svg/SVGDataExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAA+B,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IAE/C;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;;;;OAMG;IACI,mBAAmB,CACtB,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,YAAY,GACnB,WAAW,EAAE;CAiDnB"}

package/dist/types/exporters/svg/SVGExporter.d.ts

@@ -0,0 +1,29 @@
+import type { SVGExportOptions } from './types';
+import type { Textmodifier } from 'textmode.js';
+/**
+ * Main SVG exporter for the textmode.js library.
+ * Orchestrates the SVG export process by coordinating data extraction,
+ * content generation, and file handling.
+ */
+export declare class SVGExporter {
+    /**
+     * Applies default values to SVG export options
+     * @param options User-provided options
+     * @returns Complete options with defaults applied
+     */
+    private _applyDefaultOptions;
+    /**
+     * Generates SVG content from textmode rendering data without saving to file
+     * @param textmodifier The Textmodifier instance to extract data from
+     * @param options Export options
+     * @returns SVG content as string
+     */
+    $generateSVG(textmodifier: Textmodifier, options?: SVGExportOptions): string;
+    /**
+     * Exports SVG content to a downloadable file
+     * @param textmodifier The Textmodifier instance to extract data from
+     * @param options Export options
+     */
+    $saveSVG(textmodifier: Textmodifier, options?: SVGExportOptions): void;
+}
+//# sourceMappingURL=SVGExporter.d.ts.map

package/dist/types/exporters/svg/SVGExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SVGExporter.d.ts","sourceRoot":"","sources":["../../../../src/exporters/svg/SVGExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,SAAS,CAAC;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD;;;;GAIG;AACH,qBAAa,WAAW;IAEpB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;;;;OAKG;IACI,YAAY,CACf,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,gBAAqB,GAC/B,MAAM;IAsBT;;;;OAIG;IACI,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI;CAMpF"}

package/dist/types/exporters/svg/SVGPathGenerator.d.ts

@@ -0,0 +1,50 @@
+import type { TextmodeFont } from 'textmode.js';
+/**
+ * Handles SVG path generation for character glyphs.
+ * This class is responsible for converting font glyph data into SVG path strings.
+ */
+export declare class SVGPathGenerator {
+    /**
+     * Creates a path object for a glyph
+     * @param fontData Font data object
+     * @param glyphData Glyph data from font
+     * @param x X position
+     * @param y Y position
+     * @param fontSize Font size
+     * @returns Path object with bounding box and SVG methods
+     */
+    private _createGlyphPath;
+    /**
+     * Converts glyph data to SVG path string
+     * @param glyphData Glyph data from font
+     * @param x X position
+     * @param y Y position
+     * @param scale Scale factor
+     * @returns SVG path data string
+     */
+    private _glyphToSVGPath;
+    /**
+     * Generates an SVG path for a character glyph
+     * @param character The character to generate a path for
+     * @param fontData The font data object
+     * @param x X position
+     * @param y Y position
+     * @param fontSize Font size
+     * @returns Path object with SVG generation methods
+     */
+    private _generateCharacterPath;
+    /**
+     * Generates SVG path data for a character with positioning calculations
+     * @param character The character to render
+     * @param fontData The font data
+     * @param cellX Cell X position
+     * @param cellY Cell Y position
+     * @param cellWidth Cell width
+     * @param cellHeight Cell height
+     * @param fontSize Font size
+     * @param advanceWidth Character advance width
+     * @returns SVG path data string or null if generation fails
+     */
+    $generatePositionedCharacterPath(character: string, font: TextmodeFont, cellX: number, cellY: number, cellWidth: number, cellHeight: number, fontSize: number, advanceWidth: number): string | null;
+}
+//# sourceMappingURL=SVGPathGenerator.d.ts.map

package/dist/types/exporters/svg/SVGPathGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SVGPathGenerator.d.ts","sourceRoot":"","sources":["../../../../src/exporters/svg/SVGPathGenerator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoChD;;;GAGG;AACH,qBAAa,gBAAgB;IACzB;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAwDvB;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;;;;;;;OAWG;IACI,gCAAgC,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI;CAmBnB"}

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

@@ -0,0 +1,6 @@
+export { SVGExporter } from './SVGExporter';
+export { SVGDataExtractor } from './SVGDataExtractor';
+export { SVGContentGenerator } from './SVGContentGenerator';
+export { SVGPathGenerator } from './SVGPathGenerator';
+export type { SVGExportOptions, SVGGenerationOptions, SVGCellData, FramebufferData, RGBA, Position, CellPosition, CellTransform, GlyphPath } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/exporters/svg/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EACR,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,SAAS,EACZ,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,111 @@
+/**
+ * RGBA color representation.
+ */
+export interface RGBA {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/**
+ * 2D position coordinates.
+ */
+export interface Position {
+    x: number;
+    y: number;
+}
+/**
+ * Cell position in grid coordinates.
+ */
+export interface CellPosition {
+    x: number;
+    y: number;
+    cellX: number;
+    cellY: number;
+}
+/**
+ * Cell transformation data.
+ */
+export interface CellTransform {
+    isInverted: boolean;
+    flipHorizontal: boolean;
+    flipVertical: boolean;
+    rotation: number;
+}
+/**
+ * Complete data for a single SVG cell.
+ */
+export interface SVGCellData {
+    charIndex: number;
+    primaryColor: RGBA;
+    secondaryColor: RGBA;
+    transform: CellTransform;
+    position: CellPosition;
+}
+/**
+ * Framebuffer data extracted for SVG generation.
+ */
+export interface FramebufferData {
+    characterPixels: Uint8Array;
+    primaryColorPixels: Uint8Array;
+    secondaryColorPixels: Uint8Array;
+    transformPixels: Uint8Array;
+    rotationPixels: Uint8Array;
+}
+/**
+ * Options for exporting the textmode content to SVG format.
+ */
+export type SVGExportOptions = {
+    /**
+     * The filename to save the SVG file as.
+     *
+     * If not provided, a default filename is used.
+     */
+    filename?: string;
+    /**
+     * Whether to include cell background rectangles in the SVG output.
+     *
+     * When `false`, only the character paths are included.
+     *
+     * Defaults to `true`.
+     */
+    includeBackgroundRectangles?: boolean;
+    /**
+     * The drawing mode for ASCII characters.
+     *
+     * When set to `'fill'`, characters are rendered as filled shapes.
+     *
+     * When set to `'stroke'`, characters are rendered as outlines.
+     *
+     * Defaults to `'fill'`.
+     */
+    drawMode?: 'fill' | 'stroke';
+    /**
+     * The stroke width to use when drawMode is set to `'stroke'`.
+     *
+     * Defaults to `1.0`.
+     */
+    strokeWidth?: number;
+};
+/**
+ * Path object interface for character glyphs.
+ */
+export interface GlyphPath {
+    getBoundingBox(): {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    toSVG(): string;
+}
+/**
+ * Internal options used by SVG generation (with all defaults applied).
+ */
+export interface SVGGenerationOptions {
+    includeBackgroundRectangles: boolean;
+    drawMode: 'fill' | 'stroke';
+    strokeWidth: number;
+    filename?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/exporters/svg/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,IAAI;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,IAAI,CAAC;IACnB,cAAc,EAAE,IAAI,CAAC;IACrB,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,eAAe,EAAE,UAAU,CAAC;IAC5B,kBAAkB,EAAE,UAAU,CAAC;IAC/B,oBAAoB,EAAE,UAAU,CAAC;IACjC,eAAe,EAAE,UAAU,CAAC;IAC5B,cAAc,EAAE,UAAU,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE7B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,cAAc,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,KAAK,IAAI,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,2BAA2B,EAAE,OAAO,CAAC;IACrC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/exporters/txt/TXTExporter.d.ts

@@ -0,0 +1,36 @@
+import type { TXTExportOptions } from './types';
+import type { Textmodifier } from 'textmode.js';
+/**
+ * TXT exporter for the textmode.js library.
+ * Orchestrates the TXT export process by coordinating data extraction,
+ * content generation, and file handling.
+ */
+export declare class TXTExporter {
+    /**
+     * Applies default values to TXT export options
+     * @param options User-provided options
+     * @returns Complete options with defaults applied
+     */
+    private _applyDefaultOptions;
+    /**
+     * Generates TXT content from textmode rendering data
+     * @param textmodifier The Textmodifier instance to extract data from
+     * @param options Export options with defaults applied
+     * @returns TXT content as string
+     */
+    private _createTXTContent;
+    /**
+     * Generates TXT content from textmode rendering data without saving to file
+     * @param textmodifier The Textmodifier instance to extract data from
+     * @param options Export options
+     * @returns TXT content as string
+     */
+    $generateTXT(textmodifier: Textmodifier, options?: TXTExportOptions): string;
+    /**
+     * Exports TXT content to a downloadable file
+     * @param textmodifier The Textmodifier instance to extract data from
+     * @param options Export options
+     */
+    $saveTXT(textmodifier: Textmodifier, options?: TXTExportOptions): void;
+}
+//# sourceMappingURL=TXTExporter.d.ts.map

package/dist/types/exporters/txt/TXTExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TXTExporter.d.ts","sourceRoot":"","sources":["../../../../src/exporters/txt/TXTExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,SAAS,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD;;;;GAIG;AACH,qBAAa,WAAW;IACpB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;;;;OAKG;IACI,YAAY,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM;IAIvF;;;;OAIG;IACI,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI;CAOpF"}

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

@@ -0,0 +1,3 @@
+export { TXTExporter } from './TXTExporter';
+export type { TXTExportOptions, TXTGenerationOptions, FramebufferData } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/exporters/txt/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,YAAY,EACR,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EAClB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Options for exporting the textmode content to TXT format.
+ */
+export type TXTExportOptions = {
+    /**
+     * The filename to save the TXT file as.
+     *
+     * If not provided, a default filename is used.
+     */
+    filename?: string;
+    /**
+     * Whether to preserve trailing spaces on each line.
+     *
+     * When `false`, trailing spaces are trimmed from each line.
+     *
+     * Defaults to `false`.
+     */
+    preserveTrailingSpaces?: boolean;
+    /**
+     * Character to use for empty cells *(when no character is rendered in it)*.
+     * Defaults to space `' '`.
+     */
+    emptyCharacter?: string;
+};
+/**
+ * Internal options used by TXT generation (with all defaults applied).
+ */
+export interface TXTGenerationOptions {
+    preserveTrailingSpaces: boolean;
+    emptyCharacter: string;
+    filename?: string;
+}
+/**
+ * Re-export shared types from SVG module that are also used by TXT exporter
+ */
+export type { FramebufferData } from '../svg/types';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/exporters/txt/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,sBAAsB,EAAE,OAAO,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,YAAY,EAAG,eAAe,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { TextmodePluginAPI, Textmodifier } 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: TextmodePluginAPI['registerPostDrawHook']);
+    /**
+     * Captures frames and saves them as a WEBM 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
+     */
+    private _applyDefaultOptions;
+}
+//# sourceMappingURL=VideoExporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VideoExporter.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/VideoExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,SAAS,CAAC;AAG1E;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA4C;IAElF;;;;OAIG;gBACS,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,sBAAsB,CAAC;IAMvG;;;OAGG;IACU,SAAS,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;CAW7B"}

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

@@ -0,0 +1,28 @@
+import type { TextmodePluginAPI } from 'textmode.js';
+import type { VideoExportProgress, 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.
+ */
+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: TextmodePluginAPI['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;
+}
+//# sourceMappingURL=VideoRecorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/VideoRecorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAG3E;;;;GAIG;AACH,qBAAa,aAAa;IACxB;;;;;;;;;OASG;IACU,OAAO,CAClB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,sBAAsB,EAC/B,oBAAoB,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,EAC/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GACnD,OAAO,CAAC,IAAI,CAAC;IAuIhB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;CAsD/B"}

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

@@ -0,0 +1,4 @@
+export { VideoExporter } from './VideoExporter';
+export { VideoRecorder } from './VideoRecorder';
+export type { VideoExportOptions, VideoExportProgress, VideoGenerationOptions, VideoRecordingState, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,EACV,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,64 @@
+export type VideoRecordingState = 'idle' | 'recording' | 'encoding' | 'completed' | 'error';
+/**
+ * Progress information emitted during the video export process.
+ */
+export type VideoExportProgress = {
+    /**
+     * Current state of the recording process.
+     */
+    state: 'idle' | 'recording' | 'encoding' | 'completed' | 'error';
+    /**
+     * Number of frames that have been recorded so far.
+     */
+    frameIndex?: number;
+    /**
+     * Total number of frames planned for the recording.
+     */
+    totalFrames?: number;
+    /**
+     * Optional status message for UI consumption.
+     */
+    message?: string;
+};
+/**
+ * Options for exporting the textmode content to video format.
+ */
+export type VideoExportOptions = {
+    /**
+     * Target filename without extension. Defaults to an auto-generated value.
+     */
+    filename?: string;
+    /**
+     * Desired total number of frames to capture. Defaults to `300`.
+     */
+    frameCount?: number;
+    /**
+     * Target frame rate for the export, in frames per second. Defaults to `60`.
+     */
+    frameRate?: number;
+    /**
+     * Encoder quality between 0.0 and 1.0. Higher values request higher fidelity. Defaults to `1.0` *(lossless)*.
+     */
+    quality?: number;
+    /**
+    * When true, attempts to preserve alpha data in the recording *(experimental)*. Defaults to `false`.
+    */
+    transparent?: boolean;
+    /**
+     * Progress callback invoked throughout the recording lifecycle.
+     */
+    onProgress?: (progress: VideoExportProgress) => void;
+    /**
+     * Enables verbose logging. Defaults to `false`.
+     */
+    debugLogging?: boolean;
+};
+export interface VideoGenerationOptions {
+    filename?: string;
+    frameRate: number;
+    frameCount: number;
+    quality: number;
+    transparent: boolean;
+    debugLogging: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/exporters/video/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,WAAW,GACX,UAAU,GACV,WAAW,GACX,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;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;CAClB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;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;;MAEE;IACF,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;CACxB,CAAA;AAED,MAAM,WAAW,sBAAsB;IACrC,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;CACvB"}

package/dist/types/index.d.ts

@@ -0,0 +1,35 @@
+import type { TextmodePlugin } from 'textmode.js';
+import type { TextmodeExportPluginOptions } from './types';
+/**
+ * Initializes the export plugin for `textmode.js` use.
+ * @param options Plugin options
+ * @returns The export plugin instance to pass to `textmode.js`.
+ *
+ * @example
+ * ```typescript
+ * import { textmode } from 'textmode.js';
+ * import { createExportPlugin } from 'textmode.export.js';
+ *
+ * const exportPlugin = createExportPlugin({ overlay: true });
+ *
+ * const textmodifier = textmode.create({
+ *  plugins: [exportPlugin],
+ * });
+ *
+ * // Now textmodifier has export methods like saveSVG, saveCanvas, etc.
+ * // textmodifier.saveSVG({ filename: 'my-artwork' });
+ * // textmodifier.saveCanvas({ format: 'png', scale: 2.0 });
+ * ```
+ */
+/**
+ * Creates and returns a textmode export plugin instance.
+ * In UMD builds, this is also available globally as `createTextmodeExportPlugin`.
+ */
+export declare const createTextmodeExportPlugin: (options?: TextmodeExportPluginOptions) => TextmodePlugin;
+export type { TextmodeExportAPI, TextmodeExportPluginOptions } from './types';
+export type { ImageExportOptions } from './exporters/image';
+export type { SVGExportOptions } from './exporters/svg';
+export type { TXTExportOptions } from './exporters/txt';
+export type { GIFExportOptions, GIFExportProgress } from './exporters/gif';
+export type { VideoExportOptions, VideoExportProgress } from './exporters/video';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,aAAa,CAAC;AAQnF,OAAO,KAAK,EAAqB,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAS,2BAAgC,KACxC,cA4HF,CAAC;AAEF,YAAY,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC9E,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,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { ExportFormat } from '../types';
+import { Component } from '../components/base/Component';
+export interface BladeConfig<TOptions> {
+    label: string;
+    supportsClipboard: boolean;
+    format: ExportFormat;
+    defaultOptions: TOptions;
+}
+export declare abstract class Blade<TOptions> extends Component<void> {
+    protected readonly _config: BladeConfig<TOptions>;
+    private readonly _managedComponents;
+    constructor(config: BladeConfig<TOptions>);
+    abstract getOptions(): TOptions;
+    abstract reset(): void;
+    abstract validate(): boolean;
+    protected _manageComponent<TComponent extends Component<any>>(component: TComponent): TComponent;
+    protected _onUnmount(): void;
+    protected _onDestroy(): void;
+}
+//# sourceMappingURL=Blade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Blade.d.ts","sourceRoot":"","sources":["../../../../src/overlay/blades/Blade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,MAAM,WAAW,WAAW,CAAC,QAAQ;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,QAAQ,CAAC;CAC1B;AAED,8BAAsB,KAAK,CAAC,QAAQ,CAAE,SAAQ,SAAS,CAAC,IAAI,CAAC;IAC3D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;gBAEpD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;IAKzC,QAAQ,CAAC,UAAU,IAAI,QAAQ;IAC/B,QAAQ,CAAC,KAAK,IAAI,IAAI;IACtB,QAAQ,CAAC,QAAQ,IAAI,OAAO;IAE5B,SAAS,CAAC,gBAAgB,CAAC,UAAU,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU;IAKhG,SAAS,CAAC,UAAU,IAAI,IAAI;IAM5B,SAAS,CAAC,UAAU,IAAI,IAAI;CAM7B"}

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

@@ -0,0 +1,23 @@
+import type { GIFExportOptions, GIFExportProgress, GIFRecordingState } from '../../exporters/gif';
+import type { BladeConfig } from './Blade';
+import { Blade } from './Blade';
+export declare class GIFBlade extends Blade<GIFExportOptions> {
+    private frameCountInput;
+    private frameRateInput;
+    private scaleInput;
+    private repeatInput;
+    private status;
+    private recordingState;
+    constructor(config: BladeConfig<GIFExportOptions>);
+    render(): HTMLElement;
+    getOptions(): GIFExportOptions;
+    reset(): void;
+    validate(): boolean;
+    isRecording(): boolean;
+    setRecordingState(state: GIFRecordingState, progress?: GIFExportProgress): void;
+    handleProgress(progress: GIFExportProgress): void;
+    private applyDefaults;
+    private safeParseInt;
+    private safeParseFloat;
+}
+//# sourceMappingURL=GIFBlade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GIFBlade.d.ts","sourceRoot":"","sources":["../../../../src/overlay/blades/GIFBlade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMlG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAShC,qBAAa,QAAS,SAAQ,KAAK,CAAC,gBAAgB,CAAC;IACnD,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,cAAc,CAKpB;IAEF,OAAO,CAAC,UAAU,CAKhB;IAEF,OAAO,CAAC,WAAW,CAWjB;IAEF,OAAO,CAAC,MAAM,CAOZ;IAEF,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC;IAIjD,MAAM,IAAI,WAAW;IAmDrB,UAAU,IAAI,gBAAgB;IAU9B,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI,OAAO;IAWnB,WAAW,IAAI,OAAO;IAItB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAiC/E,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAUjD,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;CAIvB"}

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

@@ -0,0 +1,14 @@
+import type { ImageExportOptions } from '../../exporters/image';
+import type { BladeConfig } from './Blade';
+import { Blade } from './Blade';
+export declare class ImageBlade extends Blade<ImageExportOptions> {
+    private formatSelect;
+    private scaleInput;
+    constructor(config: BladeConfig<ImageExportOptions>);
+    render(): HTMLElement;
+    getOptions(): ImageExportOptions;
+    reset(): void;
+    validate(): boolean;
+    private applyDefaults;
+}
+//# sourceMappingURL=ImageBlade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImageBlade.d.ts","sourceRoot":"","sources":["../../../../src/overlay/blades/ImageBlade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,uBAAuB,CAAC;AAO7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,UAAW,SAAQ,KAAK,CAAC,kBAAkB,CAAC;IACvD,OAAO,CAAC,YAAY,CAUlB;IAEF,OAAO,CAAC,UAAU,CAKhB;gBAEU,MAAM,EAAE,WAAW,CAAC,kBAAkB,CAAC;IAInD,MAAM,IAAI,WAAW;IA2BrB,UAAU,IAAI,kBAAkB;IAQhC,KAAK,IAAI,IAAI;IAKb,QAAQ,IAAI,OAAO;IAKnB,OAAO,CAAC,aAAa;CAMtB"}

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

@@ -0,0 +1,16 @@
+import type { SVGExportOptions } from '../../exporters/svg';
+import type { BladeConfig } from './Blade';
+import { Blade } from './Blade';
+export declare class SVGBlade extends Blade<SVGExportOptions> {
+    private includeBackground;
+    private drawMode;
+    private strokeWidth;
+    constructor(config: BladeConfig<SVGExportOptions>);
+    render(): HTMLElement;
+    getOptions(): SVGExportOptions;
+    reset(): void;
+    validate(): boolean;
+    private updateStrokeControls;
+    private applyDefaults;
+}
+//# sourceMappingURL=SVGBlade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SVGBlade.d.ts","sourceRoot":"","sources":["../../../../src/overlay/blades/SVGBlade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAO5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,QAAS,SAAQ,KAAK,CAAC,gBAAgB,CAAC;IACnD,OAAO,CAAC,iBAAiB,CAMvB;IAEF,OAAO,CAAC,QAAQ,CASd;IAEF,OAAO,CAAC,WAAW,CAKjB;gBAEU,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC;IAIjD,MAAM,IAAI,WAAW;IAgCrB,UAAU,IAAI,gBAAgB;IAQ9B,KAAK,IAAI,IAAI;IAKb,QAAQ,IAAI,OAAO;IAQnB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,aAAa;CAQtB"}

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

@@ -0,0 +1,14 @@
+import type { TXTExportOptions } from '../../exporters/txt';
+import type { BladeConfig } from './Blade';
+import { Blade } from './Blade';
+export declare class TextBlade extends Blade<TXTExportOptions> {
+    private trailingSpaces;
+    private emptyCharacter;
+    constructor(config: BladeConfig<TXTExportOptions>);
+    render(): HTMLElement;
+    getOptions(): TXTExportOptions;
+    reset(): void;
+    validate(): boolean;
+    private applyDefaults;
+}
+//# sourceMappingURL=TextBlade.d.ts.map