@textmode/document 1.0.0 → 1.1.0

package/README.md

@@ -4,18 +4,18 @@
 
 <img alt="@textmode/document, portable textmode documents" src=".github/assets/readme-og.png" />
 
-| [![Node.js 24](https://img.shields.io/badge/Node.js-24-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![JSON Schema Draft 2020-12](https://img.shields.io/badge/JSON_Schema-Draft_2020--12-85EA2D?logo=json&logoColor=white)](https://json-schema.org/draft/2020-12) | [![docs](https://img.shields.io/badge/docs-vitepress-646cff?logo=vitepress&logoColor=white)](https://code.textmode.art/) [![Discord](https://img.shields.io/discord/1357070706181017691?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/sjrw8QXNks) | [![Ko-fi](https://shields.io/badge/ko--fi-donate-ff5f5f?logo=ko-fi)](https://ko-fi.com/V7V8JG2FY) [![GitHub Sponsors](https://img.shields.io/badge/sponsor-30363D?logo=GitHub-Sponsors&logoColor=%23EA4AAA)](https://github.com/sponsors/humanbydefinition) |
-| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![JSON Schema Draft 2020-12](https://img.shields.io/badge/JSON_Schema-Draft_2020--12-85EA2D?logo=json&logoColor=white)](https://json-schema.org/draft/2020-12) | [![docs](https://img.shields.io/badge/docs-vitepress-646cff?logo=vitepress&logoColor=white)](https://code.textmode.art/) [![Discord](https://img.shields.io/discord/1357070706181017691?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/sjrw8QXNks) | [![Ko-fi](https://shields.io/badge/ko--fi-donate-ff5f5f?logo=ko-fi)](https://ko-fi.com/V7V8JG2FY) [![GitHub Sponsors](https://img.shields.io/badge/sponsor-30363D?logo=GitHub-Sponsors&logoColor=%23EA4AAA)](https://github.com/sponsors/humanbydefinition) |
+| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 
 </div>
 
 `@textmode/document` defines a portable, versioned JSON format for textmode artwork. It provides a language-neutral specification, JSON Schema, TypeScript types, and a dependency-free decoder for browsers and Node.js.
 
-The package reads `textmode.document@2.0.0` and migrates `textmode.layer@1.0.0` and `textmode.layer@1.1.0`. The package version and document format version are independent. Updating this library does not change existing files.
+The package defines a unified `textmode.document@3.0.0` structure and reads v2 plus `textmode.layer@1.0.0` and `textmode.layer@1.1.0`. The package version and document format version are independent. Updating this library does not change existing files.
 
 ## Install
 
-Install the package from npm:
+Install the published package from npm:
 
 ```sh
 npm install @textmode/document
@@ -35,7 +35,7 @@ const result = parseTextmodeDocumentJSON(jsonText, {
 if (!result.ok) {
 	console.error(result.error.code, result.error.path, result.error.message);
 } else {
-	console.log(result.document.target, result.warnings);
+	console.log(result.document.layers.length, result.warnings);
 }
 ```
 
@@ -44,9 +44,10 @@ Successful decoding returns a new canonical document. Colors use RGBA objects, c
 ## Documentation
 
 - [Consumer guide](docs/consumer-guide.md): parsing, schema imports, error handling, resource budgets, and complete examples.
-- [Format 2.0 specification](docs/specification-2.0.md): the language-neutral contract for producers and consumers.
-- [Maintenance guide](docs/maintenance.md): ownership, compatibility, tests, and release policy.
-- [JSON Schema](schemas/2.0/schema.json): also available from `@textmode/document/schema/2.0`.
+- [Format 3.0 specification](docs/specification-3.0.md): the language-neutral contract for producers and consumers.
+- [JSON Schema visual guide](docs/schema-3.0.md): diagrams of document shapes, layers, cells, and validation responsibilities.
+- [Format 2.0 reference](docs/specification-2.0.md) and [visual guide](docs/schema-2.0.md): the older wire format.
+- [JSON Schema](schemas/3.0/schema.json): also available from `@textmode/document/schema/3.0`.
 
 The schema identifier is an identifier. It does not promise that the schema is hosted at that URL. Test fixtures are private test data. They are not package exports and are excluded from npm packages.
 

package/dist/constants.d.ts

@@ -7,7 +7,7 @@ export declare const TEXTMODE_DOCUMENT_FORMAT: "textmode.document";
  * Current textmode document schema revision.
  *
  */
-export declare const TEXTMODE_DOCUMENT_FORMAT_VERSION: "2.0.0";
+export declare const TEXTMODE_DOCUMENT_FORMAT_VERSION: "3.0.0";
 /** Legacy format discriminator accepted by the compatibility decoder. */
 export declare const LEGACY_TEXTMODE_LAYER_FORMAT: "textmode.layer";
 /** Legacy selected-layer schema revision. */

package/dist/constants.js

@@ -7,7 +7,7 @@ export const TEXTMODE_DOCUMENT_FORMAT = 'textmode.document';
  * Current textmode document schema revision.
  *
  */
-export const TEXTMODE_DOCUMENT_FORMAT_VERSION = '2.0.0';
+export const TEXTMODE_DOCUMENT_FORMAT_VERSION = '3.0.0';
 /** Legacy format discriminator accepted by the compatibility decoder. */
 export const LEGACY_TEXTMODE_LAYER_FORMAT = 'textmode.layer';
 /** Legacy selected-layer schema revision. */

package/dist/decode-shapes.d.ts

@@ -1,4 +1,6 @@
 import type { DecodeContext, UnknownRecord } from './validation.js';
-import type { CanonicalTextmodeAllDocument, CanonicalTextmodeSelectedDocument } from './types/index.js';
-export declare function decodeSelectedDocument(root: UnknownRecord, context: DecodeContext): CanonicalTextmodeSelectedDocument;
-export declare function decodeAllDocument(root: UnknownRecord, context: DecodeContext): CanonicalTextmodeAllDocument;
+import type { CanonicalTextmodeDocument } from './types/index.js';
+export declare function decodeSelectedDocument(root: UnknownRecord, context: DecodeContext): CanonicalTextmodeDocument;
+export declare function decodeAllDocument(root: UnknownRecord, context: DecodeContext): CanonicalTextmodeDocument;
+/** Decode the current unified shape; obsolete structural fields are reserved. */
+export declare function decodeV3Document(root: UnknownRecord, context: DecodeContext): CanonicalTextmodeDocument;

package/dist/decode-shapes.js

@@ -8,16 +8,22 @@ export function decodeSelectedDocument(root, context) {
     return {
         format: TEXTMODE_DOCUMENT_FORMAT,
         formatVersion: TEXTMODE_DOCUMENT_FORMAT_VERSION,
-        target: 'selected',
         ...(root.metadata === undefined
             ? {}
             : { metadata: decodeMetadata(root.metadata, '$.metadata', context.limits) }),
-        canvas,
-        grid,
-        layer: {
-            id: decodeLayerId(layer.id, '$.layer.id', context.limits),
-            cells: decodeCells(layer.cells, grid, '$.layer.cells', context),
-        },
+        layers: [
+            {
+                visible: true,
+                opacity: 1,
+                blendMode: 'normal',
+                offsetX: 0,
+                offsetY: 0,
+                rotationZ: 0,
+                grid,
+                id: decodeLayerId(layer.id, '$.layer.id', context.limits),
+                cells: decodeCells(layer.cells, grid, '$.layer.cells', context),
+            },
+        ],
     };
 }
 export function decodeAllDocument(root, context) {
@@ -29,22 +35,24 @@ export function decodeAllDocument(root, context) {
     if (layersValue.length > context.limits.maxLayers) {
         fail('LIMIT_EXCEEDED', `Layer count ${layersValue.length} exceeds the configured limit ${context.limits.maxLayers}.`, '$.layers');
     }
-    const layers = layersValue.map((value, index) => decodeLayer(value, `$.layers[${index}]`, context));
-    assertCanvasMatchesGrid(canvas, layers[0].grid, '$.canvas');
+    const decodedLayers = layersValue.map((value, index) => decodeLayer(value, `$.layers[${index}]`, context, false));
+    assertCanvasMatchesGrid(canvas, decodedLayers[0].grid, '$.canvas');
     return {
         format: TEXTMODE_DOCUMENT_FORMAT,
         formatVersion: TEXTMODE_DOCUMENT_FORMAT_VERSION,
-        target: 'all',
         ...(root.metadata === undefined
             ? {}
             : { metadata: decodeMetadata(root.metadata, '$.metadata', context.limits) }),
-        canvas,
-        layers,
+        layers: decodedLayers,
     };
 }
-function decodeLayer(value, path, context) {
+function decodeLayer(value, path, context, validatePixelExtent) {
     const layer = requireRecord(value, path);
     const grid = decodeGrid(layer.grid, `${path}.grid`);
+    if (validatePixelExtent) {
+        checkedProduct(grid.cols, grid.cellWidth, `${path}.grid.cellWidth`);
+        checkedProduct(grid.rows, grid.cellHeight, `${path}.grid.cellHeight`);
+    }
     return {
         id: decodeLayerId(layer.id, `${path}.id`, context.limits),
         visible: requireBoolean(layer.visible, `${path}.visible`),
@@ -106,3 +114,23 @@ function decodeCell(value, expectedX, expectedY, path, context) {
         },
     };
 }
+/** Decode the current unified shape; obsolete structural fields are reserved. */
+export function decodeV3Document(root, context) {
+    for (const key of ['target', 'layer', 'grid', 'canvas']) {
+        if (Object.prototype.hasOwnProperty.call(root, key))
+            fail('INVALID_DOCUMENT', `Obsolete v3 root field: ${key}.`, `$.${key}`);
+    }
+    const values = requireArray(root.layers, '$.layers');
+    if (values.length === 0)
+        fail('INVALID_DOCUMENT', 'A document must contain at least one layer.', '$.layers');
+    if (values.length > context.limits.maxLayers)
+        fail('LIMIT_EXCEEDED', `Layer count ${values.length} exceeds the configured limit ${context.limits.maxLayers}.`, '$.layers');
+    return {
+        format: TEXTMODE_DOCUMENT_FORMAT,
+        formatVersion: TEXTMODE_DOCUMENT_FORMAT_VERSION,
+        ...(root.metadata === undefined
+            ? {}
+            : { metadata: decodeMetadata(root.metadata, '$.metadata', context.limits) }),
+        layers: values.map((value, index) => decodeLayer(value, `$.layers[${index}]`, context, true)),
+    };
+}

package/dist/decode.js

@@ -1,5 +1,5 @@
 import { LEGACY_TEXTMODE_ALL_VERSION, LEGACY_TEXTMODE_LAYER_FORMAT, LEGACY_TEXTMODE_SELECTED_VERSION, TEXTMODE_DOCUMENT_FORMAT, TEXTMODE_DOCUMENT_FORMAT_VERSION, } from './constants.js';
-import { decodeAllDocument, decodeSelectedDocument } from './decode-shapes.js';
+import { decodeAllDocument, decodeSelectedDocument, decodeV3Document } from './decode-shapes.js';
 import { parseJSON } from './parse.js';
 import { DocumentDecodeFailure, fail, failure, requireRecord, requireString, resolveLimits } from './validation.js';
 /**
@@ -26,7 +26,9 @@ export function decodeTextmodeDocument(value, options = {}) {
             return {
                 ok: true,
                 document: decodeCurrentDocument(root, context),
-                warnings: [],
+                warnings: root.formatVersion === '2.0.0'
+                    ? [{ code: 'DOCUMENT_VERSION_MIGRATED', message: 'Migrated textmode.document 2.0.0 to 3.0.0.' }]
+                    : [],
             };
         }
         if (format === LEGACY_TEXTMODE_LAYER_FORMAT && (options.acceptLegacy ?? true)) {
@@ -36,7 +38,7 @@ export function decodeTextmodeDocument(value, options = {}) {
                 warnings: [
                     {
                         code: 'LEGACY_DOCUMENT_MIGRATED',
-                        message: 'Migrated a legacy textmode.layer document to textmode.document 2.0.0.',
+                        message: 'Migrated a legacy textmode.layer document to textmode.document 3.0.0.',
                     },
                 ],
             };
@@ -68,7 +70,9 @@ export function parseTextmodeDocumentJSON(json, options = {}) {
 }
 function decodeCurrentDocument(root, context) {
     const version = requireString(root.formatVersion, '$.formatVersion');
-    if (version !== TEXTMODE_DOCUMENT_FORMAT_VERSION) {
+    if (version === TEXTMODE_DOCUMENT_FORMAT_VERSION)
+        return decodeV3Document(root, context);
+    if (version !== '2.0.0') {
         fail('UNSUPPORTED_VERSION', `Unsupported textmode.document version: ${version}.`, '$.formatVersion');
     }
     const target = requireString(root.target, '$.target');

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * 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
+ * dependencies. It decodes v3 and migrates supported v1/v2 documents; product-specific
  * import policy belongs to callers.
  *
  * @packageDocumentation
@@ -10,4 +10,4 @@
 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.js';
 export { decodeTextmodeDocument, parseTextmodeDocumentJSON } from './decode.js';
 export { parseJSON } from './parse.js';
-export type { CanonicalTextmodeAllDocument, CanonicalTextmodeCell, CanonicalTextmodeCellCollection, CanonicalTextmodeDocument, CanonicalTextmodeDocumentLayer, CanonicalTextmodeSelectedDocument, JSONParseResult, 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/index.js';
+export type { CanonicalTextmodeCell, CanonicalTextmodeCellCollection, CanonicalTextmodeDocument, CanonicalTextmodeDocumentLayer, JSONParseResult, TextmodeV2SelectedDocumentLayer, TextmodeV2SelectedDocumentJSON, TextmodeV2AllDocumentJSON, TextmodeV2DocumentLayer, LegacyTextmodeAllDocumentJSON, LegacyTextmodeSelectedDocumentJSON, TextmodeDocumentDecodeOptions, TextmodeDocumentDecodeResult, TextmodeDocumentCell, TextmodeDocumentCellCollection, TextmodeDocumentCellTransform, TextmodeDocumentColor, TextmodeDocumentError, TextmodeDocumentErrorCode, TextmodeDocumentFormat, TextmodeDocumentGrid, TextmodeDocumentJSON, TextmodeDocumentLayer, TextmodeDocumentLimits, TextmodeDocumentMetadata, TextmodeDocumentParseResult, TextmodeDocumentRGBAColor, TextmodeDocumentVersion, TextmodeDocumentWarning, } from './types/index.js';

package/dist/index.js

@@ -2,7 +2,7 @@
  * 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
+ * dependencies. It decodes v3 and migrates supported v1/v2 documents; product-specific
  * import policy belongs to callers.
  *
  * @packageDocumentation

package/dist/types/canonical.d.ts

@@ -1,24 +1,16 @@
-import type { TextmodeDocumentCell, TextmodeDocumentRGBAColor, TextmodeDocumentCellTransform, TextmodeSelectedDocumentJSON, TextmodeDocumentLayer, TextmodeAllDocumentJSON } from './wire.js';
+import type { TextmodeDocumentCell, TextmodeDocumentRGBAColor, TextmodeDocumentLayer, TextmodeDocumentJSON } from './wire.js';
 import type { TEXTMODE_OBJECT_ROWS_ENCODING } from '../constants.js';
-export interface CanonicalTextmodeCell extends Omit<TextmodeDocumentCell, 'foreground' | 'background' | 'transform'> {
+export interface CanonicalTextmodeCell extends Omit<TextmodeDocumentCell, 'foreground' | 'background'> {
     foreground: TextmodeDocumentRGBAColor;
     background: TextmodeDocumentRGBAColor;
-    transform: TextmodeDocumentCellTransform;
 }
 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'> {
+export interface CanonicalTextmodeDocument extends Omit<TextmodeDocumentJSON, 'layers'> {
     layers: CanonicalTextmodeDocumentLayer[];
 }
-export type CanonicalTextmodeDocument = CanonicalTextmodeSelectedDocument | CanonicalTextmodeAllDocument;

package/dist/types/decode.d.ts

@@ -8,6 +8,7 @@ export interface TextmodeDocumentLimits {
 }
 export interface TextmodeDocumentDecodeOptions {
     limits?: TextmodeDocumentLimits;
+    /** Accept textmode.layer v1; supported textmode.document v2 is always readable. */
     acceptLegacy?: boolean;
 }
 export type TextmodeDocumentErrorCode = 'INVALID_JSON' | 'INVALID_DOCUMENT' | 'UNSUPPORTED_FORMAT' | 'UNSUPPORTED_VERSION' | 'UNSUPPORTED_TARGET' | 'UNSUPPORTED_ENCODING' | 'LIMIT_EXCEEDED';
@@ -17,7 +18,7 @@ export interface TextmodeDocumentError {
     path?: string;
 }
 export interface TextmodeDocumentWarning {
-    code: 'LEGACY_DOCUMENT_MIGRATED';
+    code: 'LEGACY_DOCUMENT_MIGRATED' | 'DOCUMENT_VERSION_MIGRATED';
     message: string;
 }
 export type JSONParseResult = {

package/dist/types/index.d.ts

@@ -2,3 +2,4 @@ export type * from './wire.js';
 export type * from './canonical.js';
 export type * from './decode.js';
 export type * from './legacy.js';
+export type * from './v2.js';

package/dist/types/legacy.d.ts

@@ -1,5 +1,6 @@
 import type { LEGACY_TEXTMODE_ALL_VERSION, LEGACY_TEXTMODE_LAYER_FORMAT, LEGACY_TEXTMODE_SELECTED_VERSION } from '../constants.js';
-import type { TextmodeDocumentMetadata, TextmodeDocumentGrid, TextmodeSelectedDocumentLayer, TextmodeDocumentLayer } from './wire.js';
+import type { TextmodeDocumentMetadata, TextmodeDocumentGrid } from './wire.js';
+import type { TextmodeV2DocumentLayer, TextmodeV2SelectedDocumentLayer } from './v2.js';
 export interface LegacyTextmodeSelectedDocumentJSON {
     $schema?: string;
     format: typeof LEGACY_TEXTMODE_LAYER_FORMAT;
@@ -10,7 +11,7 @@ export interface LegacyTextmodeSelectedDocumentJSON {
         height: number;
     };
     grid: TextmodeDocumentGrid;
-    layer: TextmodeSelectedDocumentLayer;
+    layer: TextmodeV2SelectedDocumentLayer;
 }
 export interface LegacyTextmodeAllDocumentJSON {
     $schema?: string;
@@ -21,5 +22,5 @@ export interface LegacyTextmodeAllDocumentJSON {
         width: number;
         height: number;
     };
-    layers: TextmodeDocumentLayer[];
+    layers: TextmodeV2DocumentLayer[];
 }

package/dist/types/v2.d.ts

@@ -0,0 +1,34 @@
+import type { TextmodeDocumentFormat, TextmodeDocumentMetadata, TextmodeDocumentGrid, TextmodeDocumentCellCollection, TextmodeDocumentLayer } from './wire.js';
+export interface TextmodeV2SelectedDocumentLayer {
+    id: string;
+    cells: TextmodeDocumentCellCollection;
+}
+/** Layer fields required by the v2 wire format and validated during migration. */
+export interface TextmodeV2DocumentLayer extends TextmodeDocumentLayer {
+    offsetX: number;
+    offsetY: number;
+    rotationZ: number;
+}
+export interface TextmodeV2SelectedDocumentJSON {
+    format: TextmodeDocumentFormat;
+    formatVersion: '2.0.0';
+    target: 'selected';
+    metadata?: TextmodeDocumentMetadata;
+    canvas: {
+        width: number;
+        height: number;
+    };
+    grid: TextmodeDocumentGrid;
+    layer: TextmodeV2SelectedDocumentLayer;
+}
+export interface TextmodeV2AllDocumentJSON {
+    format: TextmodeDocumentFormat;
+    formatVersion: '2.0.0';
+    target: 'all';
+    metadata?: TextmodeDocumentMetadata;
+    canvas: {
+        width: number;
+        height: number;
+    };
+    layers: TextmodeV2DocumentLayer[];
+}

package/dist/types/v2.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wire.d.ts

@@ -1,10 +1,4 @@
 import type { TEXTMODE_DOCUMENT_FORMAT, TEXTMODE_DOCUMENT_FORMAT_VERSION, TEXTMODE_OBJECT_ROWS_ENCODING } from '../constants.js';
-/**
- * Scope encoded by a textmode document.
- *
- * @category JSON document data
- */
-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. */
@@ -54,22 +48,6 @@ export interface TextmodeDocumentMetadata {
         version: string;
     };
 }
-export interface TextmodeSelectedDocumentLayer {
-    id: string;
-    cells: TextmodeDocumentCellCollection;
-}
-export interface TextmodeSelectedDocumentJSON {
-    format: TextmodeDocumentFormat;
-    formatVersion: TextmodeDocumentVersion;
-    target: 'selected';
-    metadata?: TextmodeDocumentMetadata;
-    canvas: {
-        width: number;
-        height: number;
-    };
-    grid: TextmodeDocumentGrid;
-    layer: TextmodeSelectedDocumentLayer;
-}
 export interface TextmodeDocumentLayer {
     id: string;
     visible: boolean;
@@ -81,20 +59,10 @@ export interface TextmodeDocumentLayer {
     grid: TextmodeDocumentGrid;
     cells: TextmodeDocumentCellCollection;
 }
-export interface TextmodeAllDocumentJSON {
+/** One portable document with one or more ordered layers, bottom first. */
+export interface TextmodeDocumentJSON {
     format: TextmodeDocumentFormat;
     formatVersion: TextmodeDocumentVersion;
-    target: 'all';
     metadata?: TextmodeDocumentMetadata;
-    canvas: {
-        width: number;
-        height: number;
-    };
     layers: TextmodeDocumentLayer[];
 }
-/**
- * JSON document produced by the selected-layer or layer-stack exporter.
- *
- * @category JSON document data
- */
-export type TextmodeDocumentJSON = TextmodeSelectedDocumentJSON | TextmodeAllDocumentJSON;