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

package/protocol/textmode-document/2.0/fixtures/textmode-document-create-integration-v2.json

@@ -0,0 +1,112 @@
+{
+	"format": "textmode.document",
+	"formatVersion": "2.0.0",
+	"target": "selected",
+	"metadata": {
+		"createdAt": "2026-09-21T12:00:00.000Z",
+		"generator": {
+			"name": "textmode.export.js",
+			"version": "1.8.1"
+		}
+	},
+	"canvas": {
+		"width": 24,
+		"height": 16
+	},
+	"grid": {
+		"cols": 3,
+		"rows": 2,
+		"cellWidth": 8,
+		"cellHeight": 8
+	},
+	"layer": {
+		"id": "base",
+		"cells": {
+			"encoding": "object-rows-v1",
+			"rows": [
+				[
+					{
+						"x": 0,
+						"y": 0,
+						"character": "A",
+						"foreground": "#ff000080",
+						"background": "#00000000",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": false,
+							"rotation": 0
+						}
+					},
+					{
+						"x": 1,
+						"y": 0,
+						"character": "😀",
+						"foreground": { "r": 0, "g": 255, "b": 0, "a": 255 },
+						"background": { "r": 0, "g": 0, "b": 255, "a": 96 },
+						"transform": {
+							"invert": false,
+							"flipX": true,
+							"flipY": false,
+							"rotation": 360
+						}
+					},
+					{
+						"x": 2,
+						"y": 0,
+						"character": "é",
+						"foreground": "#ffffffff",
+						"background": "#223344cc",
+						"transform": {
+							"invert": false,
+							"flipX": true,
+							"flipY": true,
+							"rotation": 45
+						}
+					}
+				],
+				[
+					{
+						"x": 0,
+						"y": 1,
+						"character": " ",
+						"foreground": "#00000000",
+						"background": "#123456ff",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": true,
+							"rotation": 90
+						}
+					},
+					{
+						"x": 1,
+						"y": 1,
+						"character": "X",
+						"foreground": "#00000000",
+						"background": "#00000000",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": false,
+							"rotation": 0
+						}
+					},
+					{
+						"x": 2,
+						"y": 1,
+						"character": "Z",
+						"foreground": "#abcdef40",
+						"background": "#10203020",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": true,
+							"rotation": 270
+						}
+					}
+				]
+			]
+		}
+	}
+}

package/protocol/textmode-document/2.0/fixtures/textmode-document-selected-v2.json

@@ -0,0 +1,86 @@
+{
+	"format": "textmode.document",
+	"formatVersion": "2.0.0",
+	"target": "selected",
+	"metadata": {
+		"createdAt": "2026-08-28T12:00:00.000Z",
+		"generator": {
+			"name": "textmode.export.js",
+			"version": "1.8.1"
+		}
+	},
+	"canvas": {
+		"width": 16,
+		"height": 16
+	},
+	"grid": {
+		"cols": 2,
+		"rows": 2,
+		"cellWidth": 8,
+		"cellHeight": 8
+	},
+	"layer": {
+		"id": "base",
+		"cells": {
+			"encoding": "object-rows-v1",
+			"rows": [
+				[
+					{
+						"x": 0,
+						"y": 0,
+						"character": "A",
+						"foreground": "#ff0000ff",
+						"background": "#000000ff",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": false,
+							"rotation": 0
+						}
+					},
+					{
+						"x": 1,
+						"y": 0,
+						"character": "😀",
+						"foreground": { "r": 0, "g": 255, "b": 0, "a": 255 },
+						"background": { "r": 0, "g": 0, "b": 255, "a": 128 },
+						"transform": {
+							"invert": false,
+							"flipX": true,
+							"flipY": false,
+							"rotation": 360
+						}
+					}
+				],
+				[
+					{
+						"x": 0,
+						"y": 1,
+						"character": " ",
+						"foreground": "#00000000",
+						"background": "#123456ff",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": true,
+							"rotation": 90
+						}
+					},
+					{
+						"x": 1,
+						"y": 1,
+						"character": "X",
+						"foreground": "#00000000",
+						"background": "#00000000",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": false,
+							"rotation": 0
+						}
+					}
+				]
+			]
+		}
+	}
+}

package/protocol/textmode-document/2.0/fixtures/textmode-layer-all-v1.1.json

@@ -0,0 +1,46 @@
+{
+	"$schema": "https://textmode.art/schemas/textmode-layer-1.0.schema.json",
+	"format": "textmode.layer",
+	"formatVersion": "1.1.0",
+	"canvas": {
+		"width": 8,
+		"height": 8
+	},
+	"layers": [
+		{
+			"id": "base",
+			"visible": true,
+			"opacity": 1,
+			"blendMode": "normal",
+			"offsetX": 0,
+			"offsetY": 0,
+			"rotationZ": 0,
+			"grid": {
+				"cols": 1,
+				"rows": 1,
+				"cellWidth": 8,
+				"cellHeight": 8
+			},
+			"cells": {
+				"encoding": "object-rows-v1",
+				"rows": [
+					[
+						{
+							"x": 0,
+							"y": 0,
+							"character": "A",
+							"foreground": "#ffffffff",
+							"background": "#000000ff",
+							"transform": {
+								"invert": false,
+								"flipX": false,
+								"flipY": false,
+								"rotation": 0
+							}
+						}
+					]
+				]
+			}
+		}
+	]
+}

package/protocol/textmode-document/2.0/fixtures/textmode-layer-selected-v1.json

@@ -0,0 +1,38 @@
+{
+	"$schema": "https://textmode.art/schemas/textmode-layer-1.0.schema.json",
+	"format": "textmode.layer",
+	"formatVersion": "1.0.0",
+	"canvas": {
+		"width": 8,
+		"height": 8
+	},
+	"grid": {
+		"cols": 1,
+		"rows": 1,
+		"cellWidth": 8,
+		"cellHeight": 8
+	},
+	"layer": {
+		"id": "base",
+		"cells": {
+			"encoding": "object-rows-v1",
+			"rows": [
+				[
+					{
+						"x": 0,
+						"y": 0,
+						"character": "A",
+						"foreground": "#ffffffff",
+						"background": "#000000ff",
+						"transform": {
+							"invert": false,
+							"flipX": false,
+							"flipY": false,
+							"rotation": 0
+						}
+					}
+				]
+			]
+		}
+	}
+}

package/protocol/textmode-document/2.0/textmode-document-2.0.schema.d.ts

@@ -0,0 +1,3 @@
+declare const schema: Readonly<Record<string, unknown>>;
+
+export default schema;

package/protocol/textmode-document/2.0/textmode-document-2.0.schema.json

@@ -0,0 +1,171 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://textmode.art/schemas/textmode-document-2.0.schema.json",
+	"title": "Textmode document 2.0",
+	"description": "Editable textmode cell snapshots and layer stacks.",
+	"oneOf": [{ "$ref": "#/$defs/selectedDocument" }, { "$ref": "#/$defs/allDocument" }],
+	"$defs": {
+		"positiveSafeInteger": {
+			"type": "integer",
+			"minimum": 1,
+			"maximum": 9007199254740991
+		},
+		"canvas": {
+			"type": "object",
+			"required": ["width", "height"],
+			"properties": {
+				"width": { "$ref": "#/$defs/positiveSafeInteger" },
+				"height": { "$ref": "#/$defs/positiveSafeInteger" }
+			},
+			"additionalProperties": true
+		},
+		"grid": {
+			"type": "object",
+			"required": ["cols", "rows", "cellWidth", "cellHeight"],
+			"properties": {
+				"cols": { "$ref": "#/$defs/positiveSafeInteger" },
+				"rows": { "$ref": "#/$defs/positiveSafeInteger" },
+				"cellWidth": { "$ref": "#/$defs/positiveSafeInteger" },
+				"cellHeight": { "$ref": "#/$defs/positiveSafeInteger" }
+			},
+			"additionalProperties": true
+		},
+		"rgba": {
+			"type": "object",
+			"required": ["r", "g", "b", "a"],
+			"properties": {
+				"r": { "type": "integer", "minimum": 0, "maximum": 255 },
+				"g": { "type": "integer", "minimum": 0, "maximum": 255 },
+				"b": { "type": "integer", "minimum": 0, "maximum": 255 },
+				"a": { "type": "integer", "minimum": 0, "maximum": 255 }
+			},
+			"additionalProperties": true
+		},
+		"color": {
+			"oneOf": [
+				{ "type": "string", "pattern": "^#[0-9A-Fa-f]{6}(?:[0-9A-Fa-f]{2})?$" },
+				{ "$ref": "#/$defs/rgba" }
+			]
+		},
+		"transform": {
+			"type": "object",
+			"required": ["invert", "flipX", "flipY", "rotation"],
+			"properties": {
+				"invert": { "type": "boolean" },
+				"flipX": { "type": "boolean" },
+				"flipY": { "type": "boolean" },
+				"rotation": { "type": "number" }
+			},
+			"additionalProperties": true
+		},
+		"cell": {
+			"type": "object",
+			"required": ["x", "y", "character", "foreground", "background", "transform"],
+			"properties": {
+				"x": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+				"y": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+				"character": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 64
+				},
+				"foreground": { "$ref": "#/$defs/color" },
+				"background": { "$ref": "#/$defs/color" },
+				"transform": { "$ref": "#/$defs/transform" }
+			},
+			"additionalProperties": true
+		},
+		"cells": {
+			"type": "object",
+			"required": ["encoding", "rows"],
+			"properties": {
+				"encoding": { "const": "object-rows-v1" },
+				"rows": {
+					"type": "array",
+					"items": {
+						"type": "array",
+						"items": { "$ref": "#/$defs/cell" }
+					}
+				}
+			},
+			"additionalProperties": true
+		},
+		"metadata": {
+			"type": "object",
+			"required": ["createdAt", "generator"],
+			"properties": {
+				"createdAt": {
+					"type": "string",
+					"format": "date-time",
+					"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$"
+				},
+				"generator": {
+					"type": "object",
+					"required": ["name", "version"],
+					"properties": {
+						"name": { "type": "string", "minLength": 1 },
+						"version": { "type": "string", "minLength": 1 }
+					},
+					"additionalProperties": true
+				}
+			},
+			"additionalProperties": true
+		},
+		"selectedLayer": {
+			"type": "object",
+			"required": ["id", "cells"],
+			"properties": {
+				"id": { "type": "string", "minLength": 1 },
+				"cells": { "$ref": "#/$defs/cells" }
+			},
+			"additionalProperties": true
+		},
+		"stackLayer": {
+			"type": "object",
+			"required": ["id", "visible", "opacity", "blendMode", "offsetX", "offsetY", "rotationZ", "grid", "cells"],
+			"properties": {
+				"id": { "type": "string", "minLength": 1 },
+				"visible": { "type": "boolean" },
+				"opacity": { "type": "number", "minimum": 0, "maximum": 1 },
+				"blendMode": { "type": "string", "minLength": 1 },
+				"offsetX": { "type": "number" },
+				"offsetY": { "type": "number" },
+				"rotationZ": { "type": "number" },
+				"grid": { "$ref": "#/$defs/grid" },
+				"cells": { "$ref": "#/$defs/cells" }
+			},
+			"additionalProperties": true
+		},
+		"selectedDocument": {
+			"type": "object",
+			"required": ["format", "formatVersion", "target", "canvas", "grid", "layer"],
+			"properties": {
+				"format": { "const": "textmode.document" },
+				"formatVersion": { "const": "2.0.0" },
+				"target": { "const": "selected" },
+				"metadata": { "$ref": "#/$defs/metadata" },
+				"canvas": { "$ref": "#/$defs/canvas" },
+				"grid": { "$ref": "#/$defs/grid" },
+				"layer": { "$ref": "#/$defs/selectedLayer" }
+			},
+			"additionalProperties": true
+		},
+		"allDocument": {
+			"type": "object",
+			"required": ["format", "formatVersion", "target", "canvas", "layers"],
+			"properties": {
+				"format": { "const": "textmode.document" },
+				"formatVersion": { "const": "2.0.0" },
+				"target": { "const": "all" },
+				"metadata": { "$ref": "#/$defs/metadata" },
+				"canvas": { "$ref": "#/$defs/canvas" },
+				"layers": {
+					"type": "array",
+					"minItems": 1,
+					"items": { "$ref": "#/$defs/stackLayer" }
+				}
+			},
+			"additionalProperties": true
+		}
+	}
+}

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

@@ -1,23 +0,0 @@
-import type { PostDrawSubscription } from '../video/VideoFrameDriver';
-import type { GIFExportProgress, GIFFrame, GIFGenerationOptions } from './types';
-/**
- * Records frames from a canvas for GIF generation.
- * Captures frames at specified intervals using textmode.js post-draw hooks.
- */
-export declare class GIFRecorder {
-    /** Reusable canvas for frame scaling */
-    private _canvas?;
-    /** Reusable 2D context for frame scaling */
-    private _ctx?;
-    /**
-     * Records a sequence of frames from the provided canvas.
-     *
-     * @param canvas - Source canvas to capture frames from
-     * @param options - Frame generation options (rate, count, scale)
-     * @param registerPostDrawHook - Hook registration function from textmode.js API
-     * @param onProgress - Optional callback for recording progress updates
-     * @returns Promise resolving to array of captured frames
-     * @throws {Error} If frame capture fails
-     */
-    $record(canvas: HTMLCanvasElement, options: GIFGenerationOptions, registerPostDrawHook: PostDrawSubscription, onProgress?: (progress: GIFExportProgress) => void): Promise<GIFFrame[]>;
-}