@teletext/react 0.1.1

package/README.md

@@ -0,0 +1,175 @@
+# @teletext/react
+
+Embed ASCII art animations in any React app. One component, zero config.
+
+## Install
+
+```bash
+npm install @teletext/react
+```
+
+## Usage
+
+Export a `.teletext` file from [teletext.com](https://teletext.com), drop it in your `public/` directory, and point at it:
+
+```tsx
+import { TeletextEmbed } from '@teletext/react'
+
+<TeletextEmbed data="/animation.teletext" autoPlay loop />
+```
+
+Or pass raw bytes:
+
+```tsx
+const bytes = new Uint8Array(await fetch('/animation.teletext').then(r => r.arrayBuffer()))
+<TeletextEmbed data={bytes} autoPlay loop />
+```
+
+## Examples
+
+**Full-screen background**
+
+```tsx
+<TeletextEmbed
+  data="/bg.teletext"
+  autoPlay
+  loop
+  backgroundColor="#000"
+  style={{ position: 'fixed', inset: 0, opacity: 0.3, zIndex: -1 }}
+/>
+```
+
+**Hero section**
+
+```tsx
+<TeletextEmbed
+  data="/animation.teletext"
+  autoPlay
+  loop
+  fontFamily="'Fira Code', monospace"
+  className="w-full h-[400px]"
+/>
+```
+
+**SSR-safe rendering**
+
+The `dom` renderer outputs `<pre>` and `<span>` elements — no canvas, works with SSR, accessible to screen readers.
+
+```tsx
+<TeletextEmbed data="/animation.teletext" renderer="dom" autoPlay loop />
+```
+
+**Pause / resume**
+
+```tsx
+const [paused, setPaused] = useState(false)
+
+<TeletextEmbed data="/animation.teletext" autoPlay loop paused={paused} />
+<button onClick={() => setPaused(p => !p)}>
+  {paused ? 'Play' : 'Pause'}
+</button>
+```
+
+**Single frame (low-level)**
+
+```tsx
+import { TeletextCanvas, TeletextDom, loadTeletext } from '@teletext/react'
+
+const data = await loadTeletext('/animation.teletext')
+<TeletextCanvas frame={data.frames[0]} cellSize={12} />
+<TeletextDom frame={data.frames[0]} />
+```
+
+## API
+
+### `<TeletextEmbed>`
+
+| Prop | Type | Default | |
+|------|------|---------|---|
+| `data` | `Uint8Array \| string` | *required* | Binary bytes or URL to `.teletext` file |
+| `renderer` | `"canvas" \| "dom"` | `"canvas"` | Canvas = fast. DOM = SSR + accessible. |
+| `autoPlay` | `boolean` | `false` | Play on mount |
+| `loop` | `boolean` | `false` | Loop the animation |
+| `paused` | `boolean` | `false` | External pause control |
+| `fps` | `number` | from export | Override frame rate |
+| `fontFamily` | `string` | `"monospace"` | Any monospace font |
+| `backgroundColor` | `string` | `"#111"` | Background color |
+| `className` | `string` | — | Wrapper CSS class |
+| `style` | `CSSProperties` | — | Wrapper inline styles |
+| `aria-label` | `string` | `"ASCII art animation"` | Accessibility label |
+
+The canvas scales to fill its container. Animations automatically pause when off-screen via `IntersectionObserver`.
+
+### `<TeletextCanvas>`
+
+Renders a single frame to `<canvas>`. Scales to fill its container.
+
+| Prop | Type | Default | |
+|------|------|---------|---|
+| `frame` | `TeletextFrame` | *required* | Single frame to render |
+| `cellSize` | `number` | `10` | Character size in px |
+| `fontFamily` | `string` | `"monospace"` | Font |
+| `backgroundColor` | `string` | `"#111"` | Background |
+
+Ref: `getCanvas()` returns the `<canvas>` element.
+
+### `<TeletextDom>`
+
+Renders a single frame as `<pre>` + colored `<span>` elements.
+
+| Prop | Type | Default | |
+|------|------|---------|---|
+| `frame` | `TeletextFrame` | *required* | Single frame to render |
+| `fontFamily` | `string` | `"monospace"` | Font |
+| `backgroundColor` | `string` | `"#111"` | Background |
+
+### Codec
+
+Encode and decode `.teletext` binary files directly:
+
+```ts
+import { encode, decode, loadTeletext } from '@teletext/react'
+
+// Decode from URL
+const data = await loadTeletext('/animation.teletext')
+
+// Decode from bytes
+const data = await decode(bytes)
+
+// Encode TeletextData to compressed binary
+const bytes = await encode(data)
+```
+
+### Utilities
+
+For custom renderers or playback logic:
+
+```ts
+import { renderCanvasFrame, renderDomFrame, getFrameIndex } from '@teletext/react'
+
+// Draw to any canvas context
+renderCanvasFrame(ctx, frame, { cellSize: 10 })
+
+// Get React elements
+const elements = renderDomFrame(frame)
+
+// Frame timing math
+const index = getFrameIndex(elapsedMs, frameCount, fps, loop)
+```
+
+## `.teletext` binary format
+
+Compressed binary — each cell is 1 byte (space) or 4 bytes (char index + RGB), gzipped with browser-native `CompressionStream`. Typical compression results:
+
+| Content | JSON | `.teletext` | Reduction |
+|---------|------|-------------|-----------|
+| 51x91, 85 frames | 13 MB | 201 KB | 98.5% |
+| 90x160, 85 frames | 43 MB | 1.6 MB | 96.3% |
+
+## Requirements
+
+React 18+. No other dependencies.
+
+## License
+
+MIT

package/dist/codec-CwTlBC1h.d.cts

@@ -0,0 +1,45 @@
+interface TeletextCell {
+    char: string;
+    r: number;
+    g: number;
+    b: number;
+}
+type TeletextFrame = TeletextCell[][];
+interface TeletextData {
+    version: number;
+    settings: {
+        palette: string;
+        density: string;
+        colorMode: string;
+        invert: boolean;
+        cellSize: number;
+    };
+    fps: number;
+    frames: TeletextFrame[];
+}
+
+/**
+ * Encode TeletextData into the compressed .teletext binary format.
+ *
+ * Binary layout (before gzip):
+ *   HEADER
+ *     [0..3]   Magic "TLTX"
+ *     [4]      Version 0x02
+ *     [5..6]   Rows (uint16 BE)
+ *     [7..8]   Cols (uint16 BE)
+ *     [9]      FPS (uint8)
+ *     [10..11] Frame count (uint16 BE)
+ *     [12]     Char count N (uint8)
+ *     [13..]   Char table: N × [len:uint8, ...utf8]
+ *     [..]     Settings JSON length (uint16 BE) + UTF-8 bytes
+ *   PAYLOAD (per frame, per row, per col)
+ *     char_index: uint8
+ *     if char_index != space_index: r g b (uint8 each)
+ */
+declare function encode(data: TeletextData): Promise<Uint8Array>;
+/**
+ * Decode a compressed .teletext binary into TeletextData.
+ */
+declare function decode(bytes: Uint8Array): Promise<TeletextData>;
+
+export { type TeletextFrame as T, type TeletextData as a, type TeletextCell as b, decode as d, encode as e };

package/dist/codec-CwTlBC1h.d.ts

@@ -0,0 +1,45 @@
+interface TeletextCell {
+    char: string;
+    r: number;
+    g: number;
+    b: number;
+}
+type TeletextFrame = TeletextCell[][];
+interface TeletextData {
+    version: number;
+    settings: {
+        palette: string;
+        density: string;
+        colorMode: string;
+        invert: boolean;
+        cellSize: number;
+    };
+    fps: number;
+    frames: TeletextFrame[];
+}
+
+/**
+ * Encode TeletextData into the compressed .teletext binary format.
+ *
+ * Binary layout (before gzip):
+ *   HEADER
+ *     [0..3]   Magic "TLTX"
+ *     [4]      Version 0x02
+ *     [5..6]   Rows (uint16 BE)
+ *     [7..8]   Cols (uint16 BE)
+ *     [9]      FPS (uint8)
+ *     [10..11] Frame count (uint16 BE)
+ *     [12]     Char count N (uint8)
+ *     [13..]   Char table: N × [len:uint8, ...utf8]
+ *     [..]     Settings JSON length (uint16 BE) + UTF-8 bytes
+ *   PAYLOAD (per frame, per row, per col)
+ *     char_index: uint8
+ *     if char_index != space_index: r g b (uint8 each)
+ */
+declare function encode(data: TeletextData): Promise<Uint8Array>;
+/**
+ * Decode a compressed .teletext binary into TeletextData.
+ */
+declare function decode(bytes: Uint8Array): Promise<TeletextData>;
+
+export { type TeletextFrame as T, type TeletextData as a, type TeletextCell as b, decode as d, encode as e };

package/dist/codec.cjs

@@ -0,0 +1,141 @@
+'use strict';
+
+// src/codec.ts
+var MAGIC = new Uint8Array([84, 76, 84, 88]);
+var FORMAT_VERSION = 2;
+async function compress(bytes) {
+  const stream = new Blob([bytes]).stream().pipeThrough(new CompressionStream("gzip"));
+  return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+async function decompress(bytes) {
+  const stream = new Blob([bytes]).stream().pipeThrough(new DecompressionStream("gzip"));
+  return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+async function encode(data) {
+  const { frames, fps, settings } = data;
+  if (frames.length === 0) throw new Error("No frames to encode");
+  const rows = frames[0].length;
+  const cols = rows > 0 ? frames[0][0].length : 0;
+  const charSet = /* @__PURE__ */ new Set();
+  charSet.add(" ");
+  for (const frame of frames) {
+    for (const row of frame) {
+      for (const cell of row) {
+        charSet.add(cell.char);
+      }
+    }
+  }
+  const chars = Array.from(charSet);
+  if (chars.length > 255) throw new Error("Too many unique characters (max 255)");
+  const charToIndex = /* @__PURE__ */ new Map();
+  for (let i = 0; i < chars.length; i++) {
+    charToIndex.set(chars[i], i);
+  }
+  const spaceIndex = charToIndex.get(" ");
+  const encoder = new TextEncoder();
+  const charEntries = chars.map((c) => encoder.encode(c));
+  const settingsBytes = encoder.encode(JSON.stringify(settings));
+  let headerSize = 13;
+  for (const entry of charEntries) {
+    headerSize += 1 + entry.length;
+  }
+  headerSize += 2 + settingsBytes.length;
+  const buf = new Uint8Array(headerSize + frames.length * rows * cols * 4);
+  const view = new DataView(buf.buffer);
+  let off = 0;
+  buf.set(MAGIC, off);
+  off += 4;
+  buf[off++] = FORMAT_VERSION;
+  view.setUint16(off, rows);
+  off += 2;
+  view.setUint16(off, cols);
+  off += 2;
+  buf[off++] = fps;
+  view.setUint16(off, frames.length);
+  off += 2;
+  buf[off++] = chars.length;
+  for (const entry of charEntries) {
+    buf[off++] = entry.length;
+    buf.set(entry, off);
+    off += entry.length;
+  }
+  view.setUint16(off, settingsBytes.length);
+  off += 2;
+  buf.set(settingsBytes, off);
+  off += settingsBytes.length;
+  for (const frame of frames) {
+    for (const row of frame) {
+      for (const cell of row) {
+        const idx = charToIndex.get(cell.char);
+        buf[off++] = idx;
+        if (idx !== spaceIndex) {
+          buf[off++] = cell.r;
+          buf[off++] = cell.g;
+          buf[off++] = cell.b;
+        }
+      }
+    }
+  }
+  return compress(buf.subarray(0, off));
+}
+async function decode(bytes) {
+  const buf = await decompress(bytes);
+  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+  let off = 0;
+  if (buf[0] !== 84 || buf[1] !== 76 || buf[2] !== 84 || buf[3] !== 88) {
+    throw new Error("Invalid .teletext file: bad magic bytes");
+  }
+  off += 4;
+  const version = buf[off++];
+  if (version !== FORMAT_VERSION) {
+    throw new Error(`Unsupported .teletext version: ${version}`);
+  }
+  const rows = view.getUint16(off);
+  off += 2;
+  const cols = view.getUint16(off);
+  off += 2;
+  const fps = buf[off++];
+  const frameCount = view.getUint16(off);
+  off += 2;
+  const charCount = buf[off++];
+  const chars = [];
+  const td = new TextDecoder();
+  for (let i = 0; i < charCount; i++) {
+    const len = buf[off++];
+    chars.push(td.decode(buf.subarray(off, off + len)));
+    off += len;
+  }
+  const spaceIndex = chars.indexOf(" ");
+  const settingsLen = view.getUint16(off);
+  off += 2;
+  const settings = JSON.parse(td.decode(buf.subarray(off, off + settingsLen)));
+  off += settingsLen;
+  const frames = [];
+  for (let f = 0; f < frameCount; f++) {
+    const frame = [];
+    for (let r = 0; r < rows; r++) {
+      const row = [];
+      for (let c = 0; c < cols; c++) {
+        const ci = buf[off++];
+        if (ci === spaceIndex) {
+          row.push({ char: " ", r: 0, g: 0, b: 0 });
+        } else {
+          row.push({
+            char: chars[ci],
+            r: buf[off++],
+            g: buf[off++],
+            b: buf[off++]
+          });
+        }
+      }
+      frame.push(row);
+    }
+    frames.push(frame);
+  }
+  return { version: 1, settings, fps, frames };
+}
+
+exports.decode = decode;
+exports.encode = encode;
+//# sourceMappingURL=codec.cjs.map
+//# sourceMappingURL=codec.cjs.map

package/dist/codec.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codec.ts"],"names":[],"mappings":"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","file":"codec.cjs","sourcesContent":["import type { TeletextData, TeletextCell, TeletextFrame } from \"./types\";\n\nconst MAGIC = new Uint8Array([0x54, 0x4c, 0x54, 0x58]); // \"TLTX\"\nconst FORMAT_VERSION = 0x02;\n\nasync function compress(bytes: Uint8Array): Promise<Uint8Array> {\n  const stream = new Blob([bytes as BlobPart])\n    .stream()\n    .pipeThrough(new CompressionStream(\"gzip\"));\n  return new Uint8Array(await new Response(stream).arrayBuffer());\n}\n\nasync function decompress(bytes: Uint8Array): Promise<Uint8Array> {\n  const stream = new Blob([bytes as BlobPart])\n    .stream()\n    .pipeThrough(new DecompressionStream(\"gzip\"));\n  return new Uint8Array(await new Response(stream).arrayBuffer());\n}\n\n/**\n * Encode TeletextData into the compressed .teletext binary format.\n *\n * Binary layout (before gzip):\n *   HEADER\n *     [0..3]   Magic \"TLTX\"\n *     [4]      Version 0x02\n *     [5..6]   Rows (uint16 BE)\n *     [7..8]   Cols (uint16 BE)\n *     [9]      FPS (uint8)\n *     [10..11] Frame count (uint16 BE)\n *     [12]     Char count N (uint8)\n *     [13..]   Char table: N × [len:uint8, ...utf8]\n *     [..]     Settings JSON length (uint16 BE) + UTF-8 bytes\n *   PAYLOAD (per frame, per row, per col)\n *     char_index: uint8\n *     if char_index != space_index: r g b (uint8 each)\n */\nexport async function encode(data: TeletextData): Promise<Uint8Array> {\n  const { frames, fps, settings } = data;\n  if (frames.length === 0) throw new Error(\"No frames to encode\");\n\n  const rows = frames[0].length;\n  const cols = rows > 0 ? frames[0][0].length : 0;\n\n  // Build char table from all frames\n  const charSet = new Set<string>();\n  charSet.add(\" \");\n  for (const frame of frames) {\n    for (const row of frame) {\n      for (const cell of row) {\n        charSet.add(cell.char);\n      }\n    }\n  }\n\n  const chars = Array.from(charSet);\n  if (chars.length > 255) throw new Error(\"Too many unique characters (max 255)\");\n\n  const charToIndex = new Map<string, number>();\n  for (let i = 0; i < chars.length; i++) {\n    charToIndex.set(chars[i], i);\n  }\n  const spaceIndex = charToIndex.get(\" \")!;\n\n  const encoder = new TextEncoder();\n  const charEntries = chars.map((c) => encoder.encode(c));\n  const settingsBytes = encoder.encode(JSON.stringify(settings));\n\n  // Calculate header size\n  let headerSize = 13; // magic(4)+ver(1)+rows(2)+cols(2)+fps(1)+frames(2)+charCount(1)\n  for (const entry of charEntries) {\n    headerSize += 1 + entry.length;\n  }\n  headerSize += 2 + settingsBytes.length;\n\n  // Allocate max possible size (4 bytes per cell)\n  const buf = new Uint8Array(headerSize + frames.length * rows * cols * 4);\n  const view = new DataView(buf.buffer);\n  let off = 0;\n\n  // Header\n  buf.set(MAGIC, off);\n  off += 4;\n  buf[off++] = FORMAT_VERSION;\n  view.setUint16(off, rows);\n  off += 2;\n  view.setUint16(off, cols);\n  off += 2;\n  buf[off++] = fps;\n  view.setUint16(off, frames.length);\n  off += 2;\n  buf[off++] = chars.length;\n\n  // Char table\n  for (const entry of charEntries) {\n    buf[off++] = entry.length;\n    buf.set(entry, off);\n    off += entry.length;\n  }\n\n  // Settings JSON\n  view.setUint16(off, settingsBytes.length);\n  off += 2;\n  buf.set(settingsBytes, off);\n  off += settingsBytes.length;\n\n  // Payload\n  for (const frame of frames) {\n    for (const row of frame) {\n      for (const cell of row) {\n        const idx = charToIndex.get(cell.char)!;\n        buf[off++] = idx;\n        if (idx !== spaceIndex) {\n          buf[off++] = cell.r;\n          buf[off++] = cell.g;\n          buf[off++] = cell.b;\n        }\n      }\n    }\n  }\n\n  return compress(buf.subarray(0, off));\n}\n\n/**\n * Decode a compressed .teletext binary into TeletextData.\n */\nexport async function decode(bytes: Uint8Array): Promise<TeletextData> {\n  const buf = await decompress(bytes);\n  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n  let off = 0;\n\n  // Magic\n  if (\n    buf[0] !== 0x54 ||\n    buf[1] !== 0x4c ||\n    buf[2] !== 0x54 ||\n    buf[3] !== 0x58\n  ) {\n    throw new Error(\"Invalid .teletext file: bad magic bytes\");\n  }\n  off += 4;\n\n  const version = buf[off++];\n  if (version !== FORMAT_VERSION) {\n    throw new Error(`Unsupported .teletext version: ${version}`);\n  }\n\n  const rows = view.getUint16(off);\n  off += 2;\n  const cols = view.getUint16(off);\n  off += 2;\n  const fps = buf[off++];\n  const frameCount = view.getUint16(off);\n  off += 2;\n\n  // Char table\n  const charCount = buf[off++];\n  const chars: string[] = [];\n  const td = new TextDecoder();\n  for (let i = 0; i < charCount; i++) {\n    const len = buf[off++];\n    chars.push(td.decode(buf.subarray(off, off + len)));\n    off += len;\n  }\n  const spaceIndex = chars.indexOf(\" \");\n\n  // Settings\n  const settingsLen = view.getUint16(off);\n  off += 2;\n  const settings = JSON.parse(td.decode(buf.subarray(off, off + settingsLen)));\n  off += settingsLen;\n\n  // Payload\n  const frames: TeletextFrame[] = [];\n  for (let f = 0; f < frameCount; f++) {\n    const frame: TeletextCell[][] = [];\n    for (let r = 0; r < rows; r++) {\n      const row: TeletextCell[] = [];\n      for (let c = 0; c < cols; c++) {\n        const ci = buf[off++];\n        if (ci === spaceIndex) {\n          row.push({ char: \" \", r: 0, g: 0, b: 0 });\n        } else {\n          row.push({\n            char: chars[ci],\n            r: buf[off++],\n            g: buf[off++],\n            b: buf[off++],\n          });\n        }\n      }\n      frame.push(row);\n    }\n    frames.push(frame);\n  }\n\n  return { version: 1, settings, fps, frames };\n}\n"]}

package/dist/codec.d.cts

@@ -0,0 +1 @@
+export { d as decode, e as encode } from './codec-CwTlBC1h.cjs';

package/dist/codec.d.ts

@@ -0,0 +1 @@
+export { d as decode, e as encode } from './codec-CwTlBC1h.js';

package/dist/codec.js

@@ -0,0 +1,138 @@
+// src/codec.ts
+var MAGIC = new Uint8Array([84, 76, 84, 88]);
+var FORMAT_VERSION = 2;
+async function compress(bytes) {
+  const stream = new Blob([bytes]).stream().pipeThrough(new CompressionStream("gzip"));
+  return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+async function decompress(bytes) {
+  const stream = new Blob([bytes]).stream().pipeThrough(new DecompressionStream("gzip"));
+  return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+async function encode(data) {
+  const { frames, fps, settings } = data;
+  if (frames.length === 0) throw new Error("No frames to encode");
+  const rows = frames[0].length;
+  const cols = rows > 0 ? frames[0][0].length : 0;
+  const charSet = /* @__PURE__ */ new Set();
+  charSet.add(" ");
+  for (const frame of frames) {
+    for (const row of frame) {
+      for (const cell of row) {
+        charSet.add(cell.char);
+      }
+    }
+  }
+  const chars = Array.from(charSet);
+  if (chars.length > 255) throw new Error("Too many unique characters (max 255)");
+  const charToIndex = /* @__PURE__ */ new Map();
+  for (let i = 0; i < chars.length; i++) {
+    charToIndex.set(chars[i], i);
+  }
+  const spaceIndex = charToIndex.get(" ");
+  const encoder = new TextEncoder();
+  const charEntries = chars.map((c) => encoder.encode(c));
+  const settingsBytes = encoder.encode(JSON.stringify(settings));
+  let headerSize = 13;
+  for (const entry of charEntries) {
+    headerSize += 1 + entry.length;
+  }
+  headerSize += 2 + settingsBytes.length;
+  const buf = new Uint8Array(headerSize + frames.length * rows * cols * 4);
+  const view = new DataView(buf.buffer);
+  let off = 0;
+  buf.set(MAGIC, off);
+  off += 4;
+  buf[off++] = FORMAT_VERSION;
+  view.setUint16(off, rows);
+  off += 2;
+  view.setUint16(off, cols);
+  off += 2;
+  buf[off++] = fps;
+  view.setUint16(off, frames.length);
+  off += 2;
+  buf[off++] = chars.length;
+  for (const entry of charEntries) {
+    buf[off++] = entry.length;
+    buf.set(entry, off);
+    off += entry.length;
+  }
+  view.setUint16(off, settingsBytes.length);
+  off += 2;
+  buf.set(settingsBytes, off);
+  off += settingsBytes.length;
+  for (const frame of frames) {
+    for (const row of frame) {
+      for (const cell of row) {
+        const idx = charToIndex.get(cell.char);
+        buf[off++] = idx;
+        if (idx !== spaceIndex) {
+          buf[off++] = cell.r;
+          buf[off++] = cell.g;
+          buf[off++] = cell.b;
+        }
+      }
+    }
+  }
+  return compress(buf.subarray(0, off));
+}
+async function decode(bytes) {
+  const buf = await decompress(bytes);
+  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+  let off = 0;
+  if (buf[0] !== 84 || buf[1] !== 76 || buf[2] !== 84 || buf[3] !== 88) {
+    throw new Error("Invalid .teletext file: bad magic bytes");
+  }
+  off += 4;
+  const version = buf[off++];
+  if (version !== FORMAT_VERSION) {
+    throw new Error(`Unsupported .teletext version: ${version}`);
+  }
+  const rows = view.getUint16(off);
+  off += 2;
+  const cols = view.getUint16(off);
+  off += 2;
+  const fps = buf[off++];
+  const frameCount = view.getUint16(off);
+  off += 2;
+  const charCount = buf[off++];
+  const chars = [];
+  const td = new TextDecoder();
+  for (let i = 0; i < charCount; i++) {
+    const len = buf[off++];
+    chars.push(td.decode(buf.subarray(off, off + len)));
+    off += len;
+  }
+  const spaceIndex = chars.indexOf(" ");
+  const settingsLen = view.getUint16(off);
+  off += 2;
+  const settings = JSON.parse(td.decode(buf.subarray(off, off + settingsLen)));
+  off += settingsLen;
+  const frames = [];
+  for (let f = 0; f < frameCount; f++) {
+    const frame = [];
+    for (let r = 0; r < rows; r++) {
+      const row = [];
+      for (let c = 0; c < cols; c++) {
+        const ci = buf[off++];
+        if (ci === spaceIndex) {
+          row.push({ char: " ", r: 0, g: 0, b: 0 });
+        } else {
+          row.push({
+            char: chars[ci],
+            r: buf[off++],
+            g: buf[off++],
+            b: buf[off++]
+          });
+        }
+      }
+      frame.push(row);
+    }
+    frames.push(frame);
+  }
+  return { version: 1, settings, fps, frames };
+}
+
+export { decode, encode };
+//# sourceMappingURL=codec.js.map
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codec.ts"],"names":[],"mappings":"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","file":"codec.js","sourcesContent":["import type { TeletextData, TeletextCell, TeletextFrame } from \"./types\";\n\nconst MAGIC = new Uint8Array([0x54, 0x4c, 0x54, 0x58]); // \"TLTX\"\nconst FORMAT_VERSION = 0x02;\n\nasync function compress(bytes: Uint8Array): Promise<Uint8Array> {\n  const stream = new Blob([bytes as BlobPart])\n    .stream()\n    .pipeThrough(new CompressionStream(\"gzip\"));\n  return new Uint8Array(await new Response(stream).arrayBuffer());\n}\n\nasync function decompress(bytes: Uint8Array): Promise<Uint8Array> {\n  const stream = new Blob([bytes as BlobPart])\n    .stream()\n    .pipeThrough(new DecompressionStream(\"gzip\"));\n  return new Uint8Array(await new Response(stream).arrayBuffer());\n}\n\n/**\n * Encode TeletextData into the compressed .teletext binary format.\n *\n * Binary layout (before gzip):\n *   HEADER\n *     [0..3]   Magic \"TLTX\"\n *     [4]      Version 0x02\n *     [5..6]   Rows (uint16 BE)\n *     [7..8]   Cols (uint16 BE)\n *     [9]      FPS (uint8)\n *     [10..11] Frame count (uint16 BE)\n *     [12]     Char count N (uint8)\n *     [13..]   Char table: N × [len:uint8, ...utf8]\n *     [..]     Settings JSON length (uint16 BE) + UTF-8 bytes\n *   PAYLOAD (per frame, per row, per col)\n *     char_index: uint8\n *     if char_index != space_index: r g b (uint8 each)\n */\nexport async function encode(data: TeletextData): Promise<Uint8Array> {\n  const { frames, fps, settings } = data;\n  if (frames.length === 0) throw new Error(\"No frames to encode\");\n\n  const rows = frames[0].length;\n  const cols = rows > 0 ? frames[0][0].length : 0;\n\n  // Build char table from all frames\n  const charSet = new Set<string>();\n  charSet.add(\" \");\n  for (const frame of frames) {\n    for (const row of frame) {\n      for (const cell of row) {\n        charSet.add(cell.char);\n      }\n    }\n  }\n\n  const chars = Array.from(charSet);\n  if (chars.length > 255) throw new Error(\"Too many unique characters (max 255)\");\n\n  const charToIndex = new Map<string, number>();\n  for (let i = 0; i < chars.length; i++) {\n    charToIndex.set(chars[i], i);\n  }\n  const spaceIndex = charToIndex.get(\" \")!;\n\n  const encoder = new TextEncoder();\n  const charEntries = chars.map((c) => encoder.encode(c));\n  const settingsBytes = encoder.encode(JSON.stringify(settings));\n\n  // Calculate header size\n  let headerSize = 13; // magic(4)+ver(1)+rows(2)+cols(2)+fps(1)+frames(2)+charCount(1)\n  for (const entry of charEntries) {\n    headerSize += 1 + entry.length;\n  }\n  headerSize += 2 + settingsBytes.length;\n\n  // Allocate max possible size (4 bytes per cell)\n  const buf = new Uint8Array(headerSize + frames.length * rows * cols * 4);\n  const view = new DataView(buf.buffer);\n  let off = 0;\n\n  // Header\n  buf.set(MAGIC, off);\n  off += 4;\n  buf[off++] = FORMAT_VERSION;\n  view.setUint16(off, rows);\n  off += 2;\n  view.setUint16(off, cols);\n  off += 2;\n  buf[off++] = fps;\n  view.setUint16(off, frames.length);\n  off += 2;\n  buf[off++] = chars.length;\n\n  // Char table\n  for (const entry of charEntries) {\n    buf[off++] = entry.length;\n    buf.set(entry, off);\n    off += entry.length;\n  }\n\n  // Settings JSON\n  view.setUint16(off, settingsBytes.length);\n  off += 2;\n  buf.set(settingsBytes, off);\n  off += settingsBytes.length;\n\n  // Payload\n  for (const frame of frames) {\n    for (const row of frame) {\n      for (const cell of row) {\n        const idx = charToIndex.get(cell.char)!;\n        buf[off++] = idx;\n        if (idx !== spaceIndex) {\n          buf[off++] = cell.r;\n          buf[off++] = cell.g;\n          buf[off++] = cell.b;\n        }\n      }\n    }\n  }\n\n  return compress(buf.subarray(0, off));\n}\n\n/**\n * Decode a compressed .teletext binary into TeletextData.\n */\nexport async function decode(bytes: Uint8Array): Promise<TeletextData> {\n  const buf = await decompress(bytes);\n  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n  let off = 0;\n\n  // Magic\n  if (\n    buf[0] !== 0x54 ||\n    buf[1] !== 0x4c ||\n    buf[2] !== 0x54 ||\n    buf[3] !== 0x58\n  ) {\n    throw new Error(\"Invalid .teletext file: bad magic bytes\");\n  }\n  off += 4;\n\n  const version = buf[off++];\n  if (version !== FORMAT_VERSION) {\n    throw new Error(`Unsupported .teletext version: ${version}`);\n  }\n\n  const rows = view.getUint16(off);\n  off += 2;\n  const cols = view.getUint16(off);\n  off += 2;\n  const fps = buf[off++];\n  const frameCount = view.getUint16(off);\n  off += 2;\n\n  // Char table\n  const charCount = buf[off++];\n  const chars: string[] = [];\n  const td = new TextDecoder();\n  for (let i = 0; i < charCount; i++) {\n    const len = buf[off++];\n    chars.push(td.decode(buf.subarray(off, off + len)));\n    off += len;\n  }\n  const spaceIndex = chars.indexOf(\" \");\n\n  // Settings\n  const settingsLen = view.getUint16(off);\n  off += 2;\n  const settings = JSON.parse(td.decode(buf.subarray(off, off + settingsLen)));\n  off += settingsLen;\n\n  // Payload\n  const frames: TeletextFrame[] = [];\n  for (let f = 0; f < frameCount; f++) {\n    const frame: TeletextCell[][] = [];\n    for (let r = 0; r < rows; r++) {\n      const row: TeletextCell[] = [];\n      for (let c = 0; c < cols; c++) {\n        const ci = buf[off++];\n        if (ci === spaceIndex) {\n          row.push({ char: \" \", r: 0, g: 0, b: 0 });\n        } else {\n          row.push({\n            char: chars[ci],\n            r: buf[off++],\n            g: buf[off++],\n            b: buf[off++],\n          });\n        }\n      }\n      frame.push(row);\n    }\n    frames.push(frame);\n  }\n\n  return { version: 1, settings, fps, frames };\n}\n"]}