textmode.export.js 1.8.1 → 1.9.0-beta.2

package/dist/types/document/constants.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Canonical format discriminator for textmode document files.
+ *
+ * @see {@link https://code.textmode.art/api/textmode.export.js/variables/TEXTMODE_DOCUMENT_FORMAT | TEXTMODE_DOCUMENT_FORMAT API reference}
+ */
+export declare const TEXTMODE_DOCUMENT_FORMAT: "textmode.document";
+/**
+ * Current textmode document schema revision.
+ *
+ * @see {@link https://code.textmode.art/api/textmode.export.js/variables/TEXTMODE_DOCUMENT_FORMAT_VERSION | TEXTMODE_DOCUMENT_FORMAT_VERSION API reference}
+ */
+export declare const TEXTMODE_DOCUMENT_FORMAT_VERSION: "2.0.0";
+/** Legacy format discriminator accepted by the compatibility decoder. */
+export declare const LEGACY_TEXTMODE_LAYER_FORMAT: "textmode.layer";
+/** Legacy selected-layer schema revision. */
+export declare const LEGACY_TEXTMODE_SELECTED_VERSION: "1.0.0";
+/** Legacy layer-stack schema revision. */
+export declare const LEGACY_TEXTMODE_ALL_VERSION: "1.1.0";
+/**
+ * Canonical dense row encoding used by textmode document v2.
+ *
+ * @see {@link https://code.textmode.art/api/textmode.export.js/variables/TEXTMODE_OBJECT_ROWS_ENCODING | TEXTMODE_OBJECT_ROWS_ENCODING API reference}
+ */
+export declare const TEXTMODE_OBJECT_ROWS_ENCODING: "object-rows-v1";
+/** Default protocol safety limits. Product-specific limits belong to callers. */
+export declare const DEFAULT_TEXTMODE_DOCUMENT_LIMITS: {
+    readonly maxCells: 16777216;
+    readonly maxLayers: 4096;
+    readonly maxLayerIdLength: 1024;
+    readonly maxCharacterLength: 64;
+    readonly maxMetadataStringLength: 4096;
+};

package/dist/types/document/decode-shapes.d.ts

@@ -0,0 +1,4 @@
+import type { DecodeContext, UnknownRecord } from './validation';
+import type { CanonicalTextmodeAllDocument, CanonicalTextmodeSelectedDocument } from './types';
+export declare function decodeSelectedDocument(root: UnknownRecord, context: DecodeContext): CanonicalTextmodeSelectedDocument;
+export declare function decodeAllDocument(root: UnknownRecord, context: DecodeContext): CanonicalTextmodeAllDocument;

package/dist/types/document/decode.d.ts

@@ -0,0 +1,5 @@
+import type { TextmodeDocumentDecodeOptions, TextmodeDocumentDecodeResult, TextmodeDocumentParseResult } from './types';
+/** Decode a parsed JSON value into the canonical textmode document union. */
+export declare function decodeTextmodeDocument(value: unknown, options?: TextmodeDocumentDecodeOptions): TextmodeDocumentDecodeResult;
+/** Parse JSON syntax and decode its value in one convenience call. */
+export declare function parseTextmodeDocumentJSON(json: string, options?: TextmodeDocumentDecodeOptions): TextmodeDocumentParseResult;

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

@@ -0,0 +1,13 @@
+/**
+ * Dependency-free textmode document protocol codec.
+ *
+ * This entry point contains no DOM, renderer, textmode.js, or media encoder
+ * dependencies. It decodes every valid v2 document variant; product-specific
+ * import policy belongs to callers.
+ *
+ * @packageDocumentation
+ */
+export { DEFAULT_TEXTMODE_DOCUMENT_LIMITS, LEGACY_TEXTMODE_ALL_VERSION, LEGACY_TEXTMODE_LAYER_FORMAT, LEGACY_TEXTMODE_SELECTED_VERSION, TEXTMODE_DOCUMENT_FORMAT, TEXTMODE_DOCUMENT_FORMAT_VERSION, TEXTMODE_OBJECT_ROWS_ENCODING, } from './constants';
+export { decodeTextmodeDocument, parseTextmodeDocumentJSON } from './decode';
+export { parseJSON } from './parse';
+export type { CanonicalTextmodeAllDocument, CanonicalTextmodeCell, CanonicalTextmodeCellCollection, CanonicalTextmodeDocument, CanonicalTextmodeDocumentLayer, CanonicalTextmodeSelectedDocument, JSONCellCollection, JSONCellTransform, JSONColorValue, JSONDocumentFormat, JSONDocumentVersion, JSONExportMetadata, JSONExportTarget, JSONLayerGrid, JSONObjectRowCell, JSONObjectRowsCellCollection, JSONParseResult, JSONRGBAColor, LegacyTextmodeAllDocumentJSON, LegacyTextmodeSelectedDocumentJSON, TextmodeAllDocumentJSON, TextmodeDocumentDecodeOptions, TextmodeDocumentDecodeResult, TextmodeDocumentCell, TextmodeDocumentCellCollection, TextmodeDocumentCellTransform, TextmodeDocumentColor, TextmodeDocumentError, TextmodeDocumentErrorCode, TextmodeDocumentFormat, TextmodeDocumentGrid, TextmodeDocumentJSON, TextmodeDocumentLayer, TextmodeDocumentLimits, TextmodeDocumentMetadata, TextmodeDocumentParseResult, TextmodeDocumentRGBAColor, TextmodeDocumentTarget, TextmodeDocumentVersion, TextmodeDocumentWarning, TextmodeSelectedDocumentJSON, TextmodeSelectedDocumentLayer, } from './types';

package/dist/types/document/parse.d.ts

@@ -0,0 +1,3 @@
+import type { JSONParseResult } from './types';
+/** Parse JSON syntax once before routing the resulting value by discriminator. */
+export declare function parseJSON(json: string): JSONParseResult;

package/dist/types/document/types.d.ts

@@ -0,0 +1,209 @@
+import type { LEGACY_TEXTMODE_ALL_VERSION, LEGACY_TEXTMODE_LAYER_FORMAT, LEGACY_TEXTMODE_SELECTED_VERSION, TEXTMODE_DOCUMENT_FORMAT, TEXTMODE_DOCUMENT_FORMAT_VERSION, TEXTMODE_OBJECT_ROWS_ENCODING } from './constants';
+/**
+ * Scope encoded by a textmode document.
+ *
+ * @see {@link https://code.textmode.art/api/textmode.export.js/type-aliases/TextmodeDocumentTarget | TextmodeDocumentTarget API reference}
+ */
+export type TextmodeDocumentTarget = 'selected' | 'all';
+/** Format discriminator encoded in a document. */
+export type TextmodeDocumentFormat = typeof TEXTMODE_DOCUMENT_FORMAT;
+/** Current on-disk format version, independent of the npm package version. */
+export type TextmodeDocumentVersion = typeof TEXTMODE_DOCUMENT_FORMAT_VERSION;
+/** RGBA color channels, each an integer from 0 through 255. */
+export interface TextmodeDocumentRGBAColor {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** On-disk color notation; decoded colors use RGBA channels. */
+export type TextmodeDocumentColor = string | TextmodeDocumentRGBAColor;
+/** Per-cell transform in degrees. */
+export interface TextmodeDocumentCellTransform {
+    invert: boolean;
+    flipX: boolean;
+    flipY: boolean;
+    rotation: number;
+}
+/** Cell at its redundant row-major x/y coordinates. */
+export interface TextmodeDocumentCell {
+    x: number;
+    y: number;
+    character: string;
+    foreground: TextmodeDocumentColor;
+    background: TextmodeDocumentColor;
+    transform: TextmodeDocumentCellTransform;
+}
+/** Dense row-major cell collection. */
+export interface TextmodeDocumentCellCollection {
+    encoding: typeof TEXTMODE_OBJECT_ROWS_ENCODING;
+    rows: TextmodeDocumentCell[][];
+}
+/** Logical grid dimensions and pixel extent of each cell. */
+export interface TextmodeDocumentGrid {
+    cols: number;
+    rows: number;
+    cellWidth: number;
+    cellHeight: number;
+}
+/** Optional producer information; it does not control decoding behavior. */
+export interface TextmodeDocumentMetadata {
+    createdAt: string;
+    generator: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * Scope selected by the JSON exporter.
+ *
+ * @deprecated Use TextmodeDocumentTarget.
+ * @see {@link https://code.textmode.art/api/textmode.export.js/type-aliases/JSONExportTarget | JSONExportTarget API reference}
+ */
+export type JSONExportTarget = TextmodeDocumentTarget;
+/** @deprecated Use TextmodeDocumentFormat. */
+export type JSONDocumentFormat = TextmodeDocumentFormat;
+/** @deprecated Use TextmodeDocumentVersion. */
+export type JSONDocumentVersion = TextmodeDocumentVersion;
+/** @deprecated Use TextmodeDocumentRGBAColor. */
+export type JSONRGBAColor = TextmodeDocumentRGBAColor;
+/** @deprecated Use TextmodeDocumentColor. */
+export type JSONColorValue = TextmodeDocumentColor;
+/** @deprecated Use TextmodeDocumentCellTransform. */
+export type JSONCellTransform = TextmodeDocumentCellTransform;
+/** @deprecated Use TextmodeDocumentCell. */
+export type JSONObjectRowCell = TextmodeDocumentCell;
+/** @deprecated Use TextmodeDocumentCellCollection. */
+export type JSONObjectRowsCellCollection = TextmodeDocumentCellCollection;
+/** @deprecated Use TextmodeDocumentCellCollection. */
+export type JSONCellCollection = TextmodeDocumentCellCollection;
+/** @deprecated Use TextmodeDocumentGrid. */
+export type JSONLayerGrid = TextmodeDocumentGrid;
+/** @deprecated Use TextmodeDocumentMetadata. */
+export type JSONExportMetadata = TextmodeDocumentMetadata;
+export interface TextmodeSelectedDocumentLayer {
+    id: string;
+    cells: JSONCellCollection;
+}
+export interface TextmodeSelectedDocumentJSON {
+    format: JSONDocumentFormat;
+    formatVersion: JSONDocumentVersion;
+    target: 'selected';
+    metadata?: JSONExportMetadata;
+    canvas: {
+        width: number;
+        height: number;
+    };
+    grid: JSONLayerGrid;
+    layer: TextmodeSelectedDocumentLayer;
+}
+export interface TextmodeDocumentLayer {
+    id: string;
+    visible: boolean;
+    opacity: number;
+    blendMode: string;
+    offsetX: number;
+    offsetY: number;
+    rotationZ: number;
+    grid: JSONLayerGrid;
+    cells: JSONCellCollection;
+}
+export interface TextmodeAllDocumentJSON {
+    format: JSONDocumentFormat;
+    formatVersion: JSONDocumentVersion;
+    target: 'all';
+    metadata?: JSONExportMetadata;
+    canvas: {
+        width: number;
+        height: number;
+    };
+    layers: TextmodeDocumentLayer[];
+}
+/**
+ * JSON document produced by the selected-layer or layer-stack exporter.
+ *
+ * @see {@link https://code.textmode.art/api/textmode.export.js/type-aliases/TextmodeDocumentJSON | TextmodeDocumentJSON API reference}
+ */
+export type TextmodeDocumentJSON = TextmodeSelectedDocumentJSON | TextmodeAllDocumentJSON;
+export interface CanonicalTextmodeCell extends Omit<JSONObjectRowCell, 'foreground' | 'background' | 'transform'> {
+    foreground: JSONRGBAColor;
+    background: JSONRGBAColor;
+    transform: JSONCellTransform;
+}
+export interface CanonicalTextmodeCellCollection {
+    encoding: typeof TEXTMODE_OBJECT_ROWS_ENCODING;
+    rows: CanonicalTextmodeCell[][];
+}
+export interface CanonicalTextmodeSelectedDocument extends Omit<TextmodeSelectedDocumentJSON, 'layer'> {
+    layer: {
+        id: string;
+        cells: CanonicalTextmodeCellCollection;
+    };
+}
+export interface CanonicalTextmodeDocumentLayer extends Omit<TextmodeDocumentLayer, 'cells'> {
+    cells: CanonicalTextmodeCellCollection;
+}
+export interface CanonicalTextmodeAllDocument extends Omit<TextmodeAllDocumentJSON, 'layers'> {
+    layers: CanonicalTextmodeDocumentLayer[];
+}
+export type CanonicalTextmodeDocument = CanonicalTextmodeSelectedDocument | CanonicalTextmodeAllDocument;
+export interface TextmodeDocumentLimits {
+    maxCells?: number;
+    maxLayers?: number;
+    maxLayerIdLength?: number;
+    maxCharacterLength?: number;
+    maxMetadataStringLength?: number;
+}
+export interface TextmodeDocumentDecodeOptions {
+    limits?: TextmodeDocumentLimits;
+    acceptLegacy?: boolean;
+}
+export type TextmodeDocumentErrorCode = 'INVALID_JSON' | 'INVALID_DOCUMENT' | 'UNSUPPORTED_FORMAT' | 'UNSUPPORTED_VERSION' | 'UNSUPPORTED_TARGET' | 'UNSUPPORTED_ENCODING' | 'LIMIT_EXCEEDED';
+export interface TextmodeDocumentError {
+    code: TextmodeDocumentErrorCode;
+    message: string;
+    path?: string;
+}
+export interface TextmodeDocumentWarning {
+    code: 'LEGACY_DOCUMENT_MIGRATED';
+    message: string;
+}
+export type JSONParseResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: TextmodeDocumentError;
+};
+export type TextmodeDocumentDecodeResult = {
+    ok: true;
+    document: CanonicalTextmodeDocument;
+    warnings: TextmodeDocumentWarning[];
+} | {
+    ok: false;
+    error: TextmodeDocumentError;
+};
+export type TextmodeDocumentParseResult = TextmodeDocumentDecodeResult;
+export interface LegacyTextmodeSelectedDocumentJSON {
+    $schema?: string;
+    format: typeof LEGACY_TEXTMODE_LAYER_FORMAT;
+    formatVersion: typeof LEGACY_TEXTMODE_SELECTED_VERSION;
+    metadata?: JSONExportMetadata;
+    canvas: {
+        width: number;
+        height: number;
+    };
+    grid: JSONLayerGrid;
+    layer: TextmodeSelectedDocumentLayer;
+}
+export interface LegacyTextmodeAllDocumentJSON {
+    $schema?: string;
+    format: typeof LEGACY_TEXTMODE_LAYER_FORMAT;
+    formatVersion: typeof LEGACY_TEXTMODE_ALL_VERSION;
+    metadata?: JSONExportMetadata;
+    canvas: {
+        width: number;
+        height: number;
+    };
+    layers: TextmodeDocumentLayer[];
+}

package/dist/types/document/validation.d.ts

@@ -0,0 +1,37 @@
+import type { JSONExportMetadata, JSONLayerGrid, JSONRGBAColor, TextmodeDocumentDecodeResult, TextmodeDocumentError, TextmodeDocumentErrorCode, TextmodeDocumentLimits } from './types';
+export type UnknownRecord = Record<string, unknown>;
+export type ResolvedLimits = Required<TextmodeDocumentLimits>;
+export type DecodeContext = {
+    limits: ResolvedLimits;
+    remainingCells: number;
+};
+export declare class DocumentDecodeFailure extends Error {
+    readonly detail: TextmodeDocumentError;
+    constructor(detail: TextmodeDocumentError);
+}
+export declare function decodeColor(value: unknown, path: string): JSONRGBAColor;
+export declare function decodeCanvas(value: unknown, path: string): {
+    width: number;
+    height: number;
+};
+export declare function decodeGrid(value: unknown, path: string): JSONLayerGrid;
+export declare function decodeMetadata(value: unknown, path: string, limits: ResolvedLimits): JSONExportMetadata;
+export declare function decodeLayerId(value: unknown, path: string, limits: ResolvedLimits): string;
+export declare function assertCanvasMatchesGrid(canvas: {
+    width: number;
+    height: number;
+}, grid: JSONLayerGrid, path: string): void;
+export declare function resolveLimits(limits: TextmodeDocumentLimits | undefined): ResolvedLimits;
+export declare function checkedProduct(left: number, right: number, path: string): number;
+export declare function normalizeRotation(rotation: number): number;
+export declare function requireRecord(value: unknown, path: string): UnknownRecord;
+export declare function requireArray(value: unknown, path: string): unknown[];
+export declare function requireString(value: unknown, path: string): string;
+export declare function requireBoundedString(value: unknown, path: string, maxLength: number): string;
+export declare function requireCharacter(value: unknown, path: string, limits: ResolvedLimits): string;
+export declare function requireBoolean(value: unknown, path: string): boolean;
+export declare function requireFiniteNumber(value: unknown, path: string): number;
+export declare function requireNumberInRange(value: unknown, path: string, minimum: number, maximum: number): number;
+export declare function requireSafeInteger(value: unknown, path: string): number;
+export declare function failure(code: TextmodeDocumentErrorCode, message: string, path?: string): TextmodeDocumentDecodeResult;
+export declare function fail(code: TextmodeDocumentErrorCode, message: string, path?: string): never;

package/dist/types/exporters/base/FileHandler.d.ts

@@ -9,18 +9,5 @@ export declare class FileHandler {
      * @param blob The content to download
      * @param filename The filename to use for the downloaded file
      */
-    $downloadFile(blob: Blob, filename: string | undefined): void;
-    /**
-     * Validates and sanitizes filename for safety and compatibility
-     *
-     * @param filename The filename to validate
-     * @returns Sanitized filename
-     */
-    private _sanitizeFilename;
-    /**
-     * Generates a default filename with timestamp
-     *
-     * @returns Generated filename
-     */
-    private _generateDefaultFilename;
+    $downloadFile(blob: Blob, filename: string | undefined, extension?: `.${string}`): void;
 }

package/dist/types/exporters/base/FilenamePolicy.d.ts

@@ -0,0 +1,6 @@
+/** Central filename normalization and canonical-extension policy. */
+export declare class FilenamePolicy {
+    $resolve(filename: string | undefined, extension: `.${string}`, createdAt?: Date): string;
+    $sanitizeStem(filename: string | undefined, createdAt?: Date, maximumBytes?: number): string;
+    $defaultStem(createdAt?: Date): string;
+}

package/dist/types/exporters/base/LayerTarget.d.ts

@@ -4,8 +4,6 @@ import type { TextmodeLayer } from 'textmode.js';
 /**
  * Shared option for exporters that read layer framebuffer data.
  *
- * @category Layer data export
- *
  * @see {@link https://code.textmode.art/api/textmode.export.js/interfaces/LayerExportOptions | LayerExportOptions API reference}
  */
 export interface LayerExportOptions {

package/dist/types/exporters/base/frame-sequence/ExclusiveCaptureGate.d.ts

@@ -0,0 +1,7 @@
+/** Rejects overlapping deterministic captures for one installed plugin instance. */
+export declare class ExclusiveCaptureGate {
+    private _active;
+    private _disposed;
+    acquire(): () => void;
+    dispose(): void;
+}

package/dist/types/exporters/{video/VideoFrameSchedule.d.ts → base/frame-sequence/FrameSchedule.d.ts}

@@ -1,8 +1,8 @@
-export interface VideoFrameTiming {
+export interface FrameTiming {
     startSeconds: number;
     centerSeconds: number;
     endSeconds: number;
     durationSeconds: number;
 }
 /** Produces one stable microsecond-rounded interval for an output frame. */
-export declare function videoFrameTiming(frameIndex: number, frameRate: number): VideoFrameTiming;
+export declare function frameTiming(frameIndex: number, frameRate: number): FrameTiming;

package/dist/types/exporters/{video/VideoFrameDriver.d.ts → base/frame-sequence/FrameSequenceDriver.d.ts}

@@ -1,13 +1,7 @@
 import type { Textmodifier } from 'textmode.js';
-import type { VideoRenderFrameOptions } from './types';
-export type PostDrawSubscription = (callback: () => void) => () => void;
-/**
- * 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 {
+import type { FrameSequenceRenderOptions, FrameSequenceStagingSurface, PostDrawSubscription } from './types';
+/** Drives deterministic export frames through public textmode.js lifecycle APIs. */
+export declare class FrameSequenceDriver {
     readonly canvas: HTMLCanvasElement;
     private readonly _textmodifier;
     private readonly _registerPostDrawHook;
@@ -16,8 +10,8 @@ export declare class VideoFrameDriver {
     private _pendingFrame;
     private _syntheticFrameCount;
     private _syntheticMillis;
-    constructor(textmodifier: Textmodifier, registerPostDrawHook: PostDrawSubscription, width: number, height: number);
-    $render(options: VideoRenderFrameOptions): Promise<void>;
+    constructor(textmodifier: Textmodifier, registerPostDrawHook: PostDrawSubscription, stagingSurface?: FrameSequenceStagingSurface);
+    $render(options: FrameSequenceRenderOptions): Promise<void>;
     private _renderOneFrame;
     private _capturePendingFrame;
     private _createStagingCanvas;

package/dist/types/exporters/base/frame-sequence/errors.d.ts

@@ -0,0 +1,12 @@
+export type FrameSequenceErrorCode = 'FRAME_SEQUENCE_ABORTED' | 'FRAME_SEQUENCE_TIMEOUT' | 'FRAME_SEQUENCE_BUSY' | 'FRAME_SEQUENCE_DISPOSED';
+/** Internal error used by deterministic capture infrastructure. */
+export declare class FrameSequenceError extends Error {
+    readonly code: FrameSequenceErrorCode;
+    readonly cause?: unknown;
+    constructor(code: FrameSequenceErrorCode, message: string, cause?: unknown);
+}
+export declare function createFrameSequenceAbortError(): FrameSequenceError;
+export declare function createFrameSequenceTimeoutError(message: string, cause?: unknown): FrameSequenceError;
+export declare function createFrameSequenceBusyError(): FrameSequenceError;
+export declare function createFrameSequenceDisposedError(): FrameSequenceError;
+export declare function isFrameSequenceAbortError(error: unknown): boolean;

package/dist/types/exporters/base/frame-sequence/index.d.ts

@@ -0,0 +1,5 @@
+export { ExclusiveCaptureGate } from './ExclusiveCaptureGate';
+export { FrameSequenceDriver } from './FrameSequenceDriver';
+export { frameTiming } from './FrameSchedule';
+export { FrameSequenceError, createFrameSequenceAbortError, isFrameSequenceAbortError } from './errors';
+export type { FrameSequenceDriverLike, FrameSequenceRenderOptions, FrameSequenceStagingSurface, PostDrawSubscription, } from './types';

package/dist/types/exporters/base/frame-sequence/types.d.ts

@@ -0,0 +1,20 @@
+import type { PrepareExportFrame } from '../FramePreparation';
+export type PostDrawSubscription = (callback: () => void) => () => void;
+export interface FrameSequenceStagingSurface {
+    width: number;
+    height: number;
+}
+export interface FrameSequenceRenderOptions {
+    frameCount: number;
+    frameRate: number;
+    signal?: AbortSignal;
+    prepareFrame?: PrepareExportFrame;
+    onFrame(frame: {
+        frameIndex: number;
+        canvas: HTMLCanvasElement;
+    }): Promise<void> | void;
+}
+export interface FrameSequenceDriverLike {
+    readonly canvas: HTMLCanvasElement;
+    $render(options: FrameSequenceRenderOptions): Promise<void>;
+}

package/dist/types/exporters/base/frame-sequence/withAbortableTimeout.d.ts

@@ -0,0 +1 @@
+export declare function withAbortableFrameTimeout<T>(promise: Promise<T>, message: string, signal: AbortSignal | undefined, timeoutMs: number): Promise<T>;

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

@@ -1,6 +1,9 @@
 export { DataExtractor } from './DataExtractor';
 export { FileHandler } from './FileHandler';
+export { FilenamePolicy } from './FilenamePolicy';
 export { getEncodedGlyphValueFromColor, resolveGlyphByEncodedValue } from './CharacterResolver';
 export { createLayerTargetProvider, getLayerTargetId, getLayerTargetOptions, resolveLayerExportTarget, resolveLayerStackExportTargets, } from './LayerTarget';
 export type { LayerExportOptions, LayerTargetOption, LayerTargetProvider, ResolvedLayerExportTarget, ResolvedLayerStackExportTarget, } from './LayerTarget';
 export type { ExportFrameContext, PrepareExportFrame } from './FramePreparation';
+export { ExclusiveCaptureGate, FrameSequenceDriver, FrameSequenceError, createFrameSequenceAbortError, frameTiming, isFrameSequenceAbortError, } from './frame-sequence';
+export type { FrameSequenceDriverLike, FrameSequenceRenderOptions, FrameSequenceStagingSurface, PostDrawSubscription, } from './frame-sequence';

package/dist/types/exporters/gif/GIFExporter.d.ts

@@ -1,5 +1,5 @@
 import type { Textmodifier } from 'textmode.js';
-import { type PostDrawSubscription } from '../video/VideoFrameDriver';
+import { type PostDrawSubscription } from '../base';
 import type { GIFExportOptions } from './types';
 /** Deterministic, bounded-memory GIF exporter. */
 export declare class GIFExporter {

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

@@ -1,3 +1,2 @@
 export { GIFExporter } from './GIFExporter';
-export { GIFRecorder } from './GIFRecorder';
 export type { GIFExportOptions, GIFExportProgress, GIFGenerationOptions, GIFRecordingState } from './types';

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

@@ -3,8 +3,6 @@ export type GIFRecordingState = 'idle' | 'recording' | 'encoding' | 'completed'
 /**
  * Progress information emitted while deterministic frames are captured and encoded as an animated GIF.
  *
- * @category GIF export
- *
  * @see {@link https://code.textmode.art/api/textmode.export.js/type-aliases/GIFExportProgress | GIFExportProgress API reference}
  */
 export type GIFExportProgress = {
@@ -36,8 +34,6 @@ export type GIFExportProgress = {
 /**
  * Options for capturing deterministic textmode frames as an animated GIF.
  *
- * @category GIF export
- *
  * @see {@link https://code.textmode.art/api/textmode.export.js/type-aliases/GIFExportOptions | GIFExportOptions API reference}
  */
 export type GIFExportOptions = {
@@ -103,9 +99,3 @@ export interface GIFGenerationOptions {
     signal?: AbortSignal;
     prepareFrame?: PrepareExportFrame;
 }
-export interface GIFFrame {
-    imageData: ImageData;
-    width: number;
-    height: number;
-    delayMs?: number;
-}

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

@@ -8,8 +8,6 @@ export type ImageFormat = 'png' | 'jpg' | 'webp';
 /**
  * Options for exporting the textmode content to image format.
  *
- * @category Canvas capture
- *
  * @see {@link https://code.textmode.art/api/textmode.export.js/type-aliases/ImageExportOptions | ImageExportOptions API reference}
  */
 export type ImageExportOptions = {

package/dist/types/exporters/json/JSONExporter.d.ts

@@ -41,7 +41,7 @@ export declare class JSONExporter {
      * @param options Export options
      * @returns Structured JSON document for the selected layer or layer stack
      */
-    $generateJSONData(textmodifier: Textmodifier, options?: JSONExportOptions): TextmodeDocumentJSON;
+    $generateJSONData(textmodifier: Textmodifier, options?: JSONExportOptions, createdAt?: Date): TextmodeDocumentJSON;
     /**
      * Generates the serialized JSON string for the selected layer or layer stack.
      *
@@ -49,7 +49,7 @@ export declare class JSONExporter {
      * @param options Export options
      * @returns Serialized JSON string
      */
-    $generateJSONString(textmodifier: Textmodifier, options?: JSONExportOptions): string;
+    $generateJSONString(textmodifier: Textmodifier, options?: JSONExportOptions, createdAt?: Date): string;
     /**
      * Exports the generated JSON to a downloadable file.
      *