@danything/arib 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,82 @@
+MIT License
+
+Copyright (c) 2026 denpa contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+This package includes material derived from the following works.
+
+## libaribcaption
+
+The caption character tables (src/b24-tables.ts) are derived from libaribcaption
+(b24_conv_tables.hpp, b24_gaiji_table.hpp, b24_colors.cpp, b24_drcs_conv.cpp),
+and the caption decoder (src/b24caption.ts) is a TypeScript port of its
+decoder_impl.cpp. https://github.com/xqq/libaribcaption
+
+MIT License
+
+Copyright (c) 2022 magicxqq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## ariblib
+
+A few EPG-only entries of the ARIB gaiji table (src/aribtext-gaiji.ts) follow
+the table that ariblib inherited from epgdump_py (Yasumasa Murakami, 2011).
+https://github.com/youzaka/ariblib
+
+The MIT License (MIT)
+
+Copyright (c) 2013 youzaka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,66 @@
-# Temporary Holding Version
+# @danything/arib
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+日本のデジタル放送 (ISDB-T / ISDB-S、ARIB 規格) の MPEG-TS を TypeScript で読むライブラリです。
+録画サーバー [denpa](https://github.com/danything/denpa) の中で使っているものを切り出しました。
+
+- **PSI** — パケットの切り出し、セクションの組み立て、PAT / PMT / SDT / NIT (`psi`)
+- **PES** — 映像・音声の PES と ADTS (`pes`)
+- **番組表** — EIT[p/f] と EIT[schedule]。ジャンル・音声・拡張形式イベント記述子まで (`eit`)
+- **ARIB の文字** — STD-B24 の8単位符号と ARIB 外字 (`aribtext`、`aribtext-gaiji`)
+- **字幕** — STD-B24 の字幕文を、字の置き場所まで決めた JSON にする (`b24caption`、形式は `caption-text`)
+- **データ放送** — DSM-CC のカルーセルからモジュールとファイルを組み立てる (`dsmcc`、`multipart`、`bml`)
+- **Hybridcast の AIT** (`ait`)、**1つの局だけを抜き出す** (`service-filter`)
+
+依存するパッケージはありません。
+
+## 入れ方
+
+```sh
+npm install @danything/arib
+```
+
+ES モジュールだけです。`bml` と `b24caption` は `node:zlib` / `node:crypto` を使うので、
+Node.js・Bun・Deno で動きます。ほかのモジュールはブラウザでも動きます。型は TypeScript 5.7 以降で読めます。
+
+## 使い方
+
+モジュールごとに読み込みます (`@danything/arib/<名前>`)。
+
+```ts
+import { EpgReader } from "@danything/arib/eit";
+
+const epg = new EpgReader();
+for await (const chunk of stream) {
+  // 長さはそろっていなくてよい
+  if (epg.feed(chunk)) {
+    for (const event of epg.takeChanged()) {
+      console.log(event.serviceId, new Date(event.startAt), event.name);
+    }
+  }
+}
+```
+
+```ts
+import { decodeAribText } from "@danything/arib/aribtext";
+
+decodeAribText(bytes); // "🈟ニュース"
+```
+
+```ts
+import { B24CaptionDecoder } from "@danything/arib/b24caption";
+
+const captions = new B24CaptionDecoder();
+// 字幕の PES の中身 (データ識別 0x80 から) を1つずつ渡す
+const page = captions.decode(pesPayload);
+if (page !== null) draw(page); // 形式は caption-text.ts の CaptionPage
+```
+
+## 版
+
+0.x の間は、小さい版 (0.1 → 0.2) で互換のない変更をすることがあります。
+
+## ライセンス
+
+MIT。字幕の表とデコードの方法は [libaribcaption](https://github.com/xqq/libaribcaption) (MIT)、
+外字表の一部は [ariblib](https://github.com/youzaka/ariblib) (MIT) から来ています。
+著作権表示は [LICENSE](LICENSE) にあります。

package/dist/ait.d.ts

@@ -0,0 +1,97 @@
+/**
+ * AIT (Application Information Table) を読む。**Hybridcast の在り処。**
+ *
+ * データ放送 (BML) と違って、**Hybridcast のアプリは電波に乗っていません**。
+ * 乗っているのはこの表だけで、中身は「どこにアプリがあるか」のアドレス (URL) です。
+ * アプリそのものは放送局のサーバから HTTPS で取ってきます。
+ *
+ * ```
+ * PMT ─ ES に application_signalling_descriptor (0x6F) ─→ その PID に AIT
+ * AIT ─ transport_protocol_descriptor (URL の頭)
+ *     └ simple_application_location_descriptor (その先のパス)  →  アプリのURL
+ * ```
+ *
+ * ここは読んで在ることを言うだけです。開くのはデータ放送が起動を求めたときで
+ * (画面の `HybridcastFrame`)、受信機の API は用意できる範囲だけ。放送局のサーバが
+ * 認証された受信機を期待するものは、denpa 側の努力では越えられません
+ * ([docs/stream.md](https://github.com/danything/denpa/blob/main/docs/stream.md#hybridcast))。
+ */
+/**
+ * HTML5 のアプリ。**Hybridcast はこれ** (ARIB STD-B23)。
+ *
+ * 他の値は DVB のもの (DVB-J は 1、DVB-HTML は 2) で、日本の放送には出てきません
+ */
+export declare const APPLICATION_TYPE_HTML5 = 16;
+/**
+ * 起動のしかた (application_control_code)。
+ *
+ * **`autostart` は「選局したら勝手に始めよ」**で、テレビは黙って動かします。
+ * `present` は「用意はあるが、人が呼ぶまで始めるな」。denpa は選局しただけでは
+ * どちらも動かさない (開くのはデータ放送が求めたとき) ので、**画面に出すときの言い方と、
+ * どれを開くかの手がかりが変わるだけ**です
+ */
+export declare const CONTROL: {
+    readonly autostart: 1;
+    readonly present: 2;
+    readonly destroy: 3;
+    readonly kill: 4;
+    readonly prefetch: 5;
+    readonly remote: 6;
+    readonly disabled: 7;
+    readonly playbackAutostart: 8;
+};
+interface HybridcastApp {
+    /** 放送局を表す番号 (organisation_id) */
+    organisationId: number;
+    applicationId: number;
+    /** `CONTROL` のどれか。生の値をそのまま持つ (知らない値でも捨てない) */
+    controlCode: number;
+    /** アプリの名前。放送が入れていなければ空 */
+    name: string;
+    /** 取得先。`transport_protocol` と `location` を繋いだもの */
+    url: string;
+}
+export interface Ait {
+    /** `APPLICATION_TYPE_HTML5` なら Hybridcast */
+    applicationType: number;
+    applications: HybridcastApp[];
+}
+/**
+ * PMT から「AIT が流れている PID」を読み取る。
+ *
+ * **記述子が付いている ES を見るだけ。** `stream_type` では決められません —
+ * AIT は DSM-CC セクション (0x0D) で運ばれ、データ放送のカルーセルと同じ型を
+ * 名乗るので、型だけでは見分けが付きません
+ */
+export declare function aitPidsFromPmt(section: Uint8Array): number[];
+/**
+ * AIT のセクションを1つ読む。**壊れていたら `null`** (放送は途中から読むので、
+ * 読めないものが来るのは普通のこと)
+ */
+export declare function parseAit(section: Uint8Array): Ait | null;
+/**
+ * TS から Hybridcast のアプリを見つける。
+ *
+ * **PMT を見てから AIT を読む** という2段なので、繋いだ直後は何も返しません。
+ * 局を変えたら作り直します (`reset`)。
+ *
+ * 局に Hybridcast が無ければ、**PMT に印が無い**ので AIT を待つこともしません
+ * — その局では永久に何も返さないのが正しい振る舞いです。
+ */
+export declare class AitReader {
+    private readonly packets;
+    private readonly pmt;
+    /** AIT を組み立てるもの。PID ごとに1つ */
+    private aits;
+    constructor(serviceId: number);
+    /**
+     * TS を食べて、見つかったものを返す。**見つからない間は空**。
+     *
+     * 同じものが何度も返るのは呼ぶ側で畳んでください — 放送は同じ表を
+     * 繰り返し流すので、ここで覚えると「局を変えても消えない」になります
+     */
+    feed(chunk: Uint8Array): Ait[];
+    /** 切り分け済みのパケットを1つ。見つかったものは `found` に足す (`BmlDecoder.feedPacket` と同じ事情) */
+    feedPacket(packet: Uint8Array, found: Ait[]): void;
+}
+export {};

package/dist/ait.js

@@ -0,0 +1,205 @@
+/**
+ * AIT (Application Information Table) を読む。**Hybridcast の在り処。**
+ *
+ * データ放送 (BML) と違って、**Hybridcast のアプリは電波に乗っていません**。
+ * 乗っているのはこの表だけで、中身は「どこにアプリがあるか」のアドレス (URL) です。
+ * アプリそのものは放送局のサーバから HTTPS で取ってきます。
+ *
+ * ```
+ * PMT ─ ES に application_signalling_descriptor (0x6F) ─→ その PID に AIT
+ * AIT ─ transport_protocol_descriptor (URL の頭)
+ *     └ simple_application_location_descriptor (その先のパス)  →  アプリのURL
+ * ```
+ *
+ * ここは読んで在ることを言うだけです。開くのはデータ放送が起動を求めたときで
+ * (画面の `HybridcastFrame`)、受信機の API は用意できる範囲だけ。放送局のサーバが
+ * 認証された受信機を期待するものは、denpa 側の努力では越えられません
+ * ([docs/stream.md](https://github.com/danything/denpa/blob/main/docs/stream.md#hybridcast))。
+ */
+import { decodeAribText } from "./aribtext.js";
+import { u16, u32 } from "./bytes.js";
+import { descriptors, packetPid, PacketStream, pmtStreams, PmtTracker, SectionAssembler, } from "./psi.js";
+/** AIT のセクション */
+const TABLE_AIT = 0x74;
+/** PMT の ES に付く。**その PID に AIT が流れている**という印 */
+const DESC_APPLICATION_SIGNALLING = 0x6f;
+/** AIT の中の記述子 */
+const DESC_APPLICATION_NAME = 0x01;
+const DESC_TRANSPORT_PROTOCOL = 0x02;
+const DESC_SIMPLE_APPLICATION_LOCATION = 0x15;
+/** 通信路で運ぶ (HTTP/HTTPS)。1 は放送のカルーセルで運ぶもの */
+const PROTOCOL_HTTP = 0x0003;
+/**
+ * HTML5 のアプリ。**Hybridcast はこれ** (ARIB STD-B23)。
+ *
+ * 他の値は DVB のもの (DVB-J は 1、DVB-HTML は 2) で、日本の放送には出てきません
+ */
+export const APPLICATION_TYPE_HTML5 = 0x0010;
+/**
+ * 起動のしかた (application_control_code)。
+ *
+ * **`autostart` は「選局したら勝手に始めよ」**で、テレビは黙って動かします。
+ * `present` は「用意はあるが、人が呼ぶまで始めるな」。denpa は選局しただけでは
+ * どちらも動かさない (開くのはデータ放送が求めたとき) ので、**画面に出すときの言い方と、
+ * どれを開くかの手がかりが変わるだけ**です
+ */
+export const CONTROL = {
+    autostart: 0x01,
+    present: 0x02,
+    destroy: 0x03,
+    kill: 0x04,
+    prefetch: 0x05,
+    remote: 0x06,
+    disabled: 0x07,
+    playbackAutostart: 0x08,
+};
+/**
+ * PMT から「AIT が流れている PID」を読み取る。
+ *
+ * **記述子が付いている ES を見るだけ。** `stream_type` では決められません —
+ * AIT は DSM-CC セクション (0x0D) で運ばれ、データ放送のカルーセルと同じ型を
+ * 名乗るので、型だけでは見分けが付きません
+ */
+export function aitPidsFromPmt(section) {
+    const pids = [];
+    for (const [, pid, info] of pmtStreams(section)) {
+        for (const [tag] of descriptors(info)) {
+            if (tag === DESC_APPLICATION_SIGNALLING) {
+                pids.push(pid);
+                break;
+            }
+        }
+    }
+    return pids;
+}
+/**
+ * URL の頭を取り出す (transport_protocol_descriptor)。
+ *
+ * **通信路で運ぶものだけ見ます。** `protocol_id` が 1 のものは放送のカルーセルで
+ * 運ぶアプリ (データ放送と同じ経路) で、Hybridcast の話ではありません
+ */
+function transportUrl(body) {
+    if (body.length < 4)
+        return null;
+    if (u16(body, 0) !== PROTOCOL_HTTP)
+        return null;
+    // [0..1] protocol_id, [2] transport_protocol_label, [3] URL_base_length
+    const baseLength = body[3];
+    if (body.length < 4 + baseLength)
+        return null;
+    return new TextDecoder().decode(body.subarray(4, 4 + baseLength));
+}
+/**
+ * 名前を取り出す (application_name_descriptor)。
+ *
+ * 言語ごとに何本も入っていることがあるので**最初の1本**を採ります。中身は
+ * ARIB の8単位符号なので、番組名と同じ方法で読みます (`aribtext.ts`)
+ */
+function applicationName(body) {
+    // [0..2] ISO_639_language_code, [3] application_name_length
+    if (body.length < 4)
+        return "";
+    const length = body[3];
+    if (body.length < 4 + length)
+        return "";
+    return decodeAribText(body.subarray(4, 4 + length)).trim();
+}
+/**
+ * AIT のセクションを1つ読む。**壊れていたら `null`** (放送は途中から読むので、
+ * 読めないものが来るのは普通のこと)
+ */
+export function parseAit(section) {
+    if (section[0] !== TABLE_AIT || section.length < 16)
+        return null;
+    const applicationType = u16(section, 3) & 0x7fff;
+    const commonLength = u16(section, 8) & 0x0fff;
+    let at = 10 + commonLength;
+    const end = section.length - 4;
+    if (at + 2 > end)
+        return null;
+    const loopLength = u16(section, at) & 0x0fff;
+    at += 2;
+    const stop = Math.min(at + loopLength, end);
+    const applications = [];
+    while (at + 9 <= stop) {
+        const organisationId = u32(section, at);
+        const applicationId = u16(section, at + 4);
+        const controlCode = section[at + 6];
+        const infoLength = u16(section, at + 7) & 0x0fff;
+        const info = section.subarray(at + 9, at + 9 + infoLength);
+        at += 9 + infoLength;
+        let base = null;
+        let path = "";
+        let name = "";
+        for (const [tag, descriptor] of descriptors(info)) {
+            if (tag === DESC_TRANSPORT_PROTOCOL)
+                base = transportUrl(descriptor) ?? base;
+            else if (tag === DESC_SIMPLE_APPLICATION_LOCATION)
+                path = new TextDecoder().decode(descriptor);
+            else if (tag === DESC_APPLICATION_NAME)
+                name = applicationName(descriptor);
+            // application_descriptor (優先度と可視性) は読まない。動かさないので使い道がない
+        }
+        // **URL の無いものは出さない。** 在ることだけ言われても行き先が無い
+        if (base === null)
+            continue;
+        applications.push({
+            organisationId,
+            applicationId,
+            controlCode,
+            name,
+            url: base + path,
+        });
+    }
+    return { applicationType, applications };
+}
+/**
+ * TS から Hybridcast のアプリを見つける。
+ *
+ * **PMT を見てから AIT を読む** という2段なので、繋いだ直後は何も返しません。
+ * 局を変えたら作り直します (`reset`)。
+ *
+ * 局に Hybridcast が無ければ、**PMT に印が無い**ので AIT を待つこともしません
+ * — その局では永久に何も返さないのが正しい振る舞いです。
+ */
+export class AitReader {
+    packets = new PacketStream();
+    pmt;
+    /** AIT を組み立てるもの。PID ごとに1つ */
+    aits = new Map();
+    constructor(serviceId) {
+        this.pmt = new PmtTracker(serviceId);
+    }
+    /**
+     * TS を食べて、見つかったものを返す。**見つからない間は空**。
+     *
+     * 同じものが何度も返るのは呼ぶ側で畳んでください — 放送は同じ表を
+     * 繰り返し流すので、ここで覚えると「局を変えても消えない」になります
+     */
+    feed(chunk) {
+        const found = [];
+        for (const packet of this.packets.feed(chunk))
+            this.feedPacket(packet, found);
+        return found;
+    }
+    /** 切り分け済みのパケットを1つ。見つかったものは `found` に足す (`BmlDecoder.feedPacket` と同じ事情) */
+    feedPacket(packet, found) {
+        const pid = packetPid(packet);
+        const before = this.pmt.pid;
+        const sections = this.pmt.feed(packet, pid);
+        // 局が変わった。AIT も読み直す
+        if (this.pmt.pid !== before)
+            this.aits = new Map();
+        for (const section of sections) {
+            for (const ait of aitPidsFromPmt(section)) {
+                if (!this.aits.has(ait))
+                    this.aits.set(ait, new SectionAssembler(ait));
+            }
+        }
+        for (const section of this.aits.get(pid)?.feed(packet) ?? []) {
+            const ait = parseAit(section);
+            if (ait !== null)
+                found.push(ait);
+        }
+    }
+}

package/dist/aribtext-gaiji.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ARIB 外字。放送で使われる、JIS X 0208 の外にある文字の対応表 (85区から先)。
+ *
+ * 番組名の「🈟」「🈑」「🈞」([新][字][再]) はここにある。読めないと、番組表から
+ * その印が丸ごと消えるか、化けた文字が並ぶ。
+ *
+ * **市販のテレビと同じく、規格の字そのままを出す。** 𠮷 を「吉」に、🈟 を「[新]」に
+ * 寄せたりはしない。「吉」や「[新]」で探して当たるようにするのは検索の側
+ * ([fold.ts](https://github.com/danything/denpa/blob/main/src/lib/fold.ts))。
+ *
+ * **字は字幕と同じ表を引く** ([b24-tables.ts](b24-tables.ts) の `ADDITIONAL`。ARIB STD-B24 表 7-19 /
+ * STD-B62 表 5-2)。番組表で違えるのは下の `EPG_ONLY` だけ:
+ *
+ * - 92区56〜85点 (楽器の略号) は規格でも私用領域 (U+E2A5〜) にしか字が無い。どこでも読めるよう
+ *   「(vn)」のような文字列に開く (字幕は私用領域のまま。フォントがその字形を持つ)
+ * - 93区46・47点と87点は規格で空き。昔の表 (epgdump_py から ariblib に引き継がれた表) のとおり
+ *   中黒と全角の空白で埋める (字幕では空きのまま)
+ *
+ * 表で空き (U+FFFD) の点は持たない。`aribtext.ts` が「□」にする。
+ *
+ * 鍵は区点そのまま — 第1バイトが 0x20+区、第2バイトが 0x20+点。
+ */
+/** 番組表だけで違える字。区点 → 字 (上の説明) */
+export declare const EPG_ONLY: Map<number, string>;
+export declare const GAIJI: Map<number, string>;

package/dist/aribtext-gaiji.js

@@ -0,0 +1,69 @@
+/**
+ * ARIB 外字。放送で使われる、JIS X 0208 の外にある文字の対応表 (85区から先)。
+ *
+ * 番組名の「🈟」「🈑」「🈞」([新][字][再]) はここにある。読めないと、番組表から
+ * その印が丸ごと消えるか、化けた文字が並ぶ。
+ *
+ * **市販のテレビと同じく、規格の字そのままを出す。** 𠮷 を「吉」に、🈟 を「[新]」に
+ * 寄せたりはしない。「吉」や「[新]」で探して当たるようにするのは検索の側
+ * ([fold.ts](https://github.com/danything/denpa/blob/main/src/lib/fold.ts))。
+ *
+ * **字は字幕と同じ表を引く** ([b24-tables.ts](b24-tables.ts) の `ADDITIONAL`。ARIB STD-B24 表 7-19 /
+ * STD-B62 表 5-2)。番組表で違えるのは下の `EPG_ONLY` だけ:
+ *
+ * - 92区56〜85点 (楽器の略号) は規格でも私用領域 (U+E2A5〜) にしか字が無い。どこでも読めるよう
+ *   「(vn)」のような文字列に開く (字幕は私用領域のまま。フォントがその字形を持つ)
+ * - 93区46・47点と87点は規格で空き。昔の表 (epgdump_py から ariblib に引き継がれた表) のとおり
+ *   中黒と全角の空白で埋める (字幕では空きのまま)
+ *
+ * 表で空き (U+FFFD) の点は持たない。`aribtext.ts` が「□」にする。
+ *
+ * 鍵は区点そのまま — 第1バイトが 0x20+区、第2バイトが 0x20+点。
+ */
+import { ADDITIONAL } from "./b24-tables.js";
+/** 番組表だけで違える字。区点 → 字 (上の説明) */
+export const EPG_ONLY = new Map([
+    // 92区56〜85点。規格でも私用領域
+    [0x7c58, "(vn)"],
+    [0x7c59, "(ob)"],
+    [0x7c5a, "(cb)"],
+    [0x7c5b, "(ce"],
+    [0x7c5c, "mb)"],
+    [0x7c5d, "(hp)"],
+    [0x7c5e, "(br)"],
+    [0x7c5f, "(p)"],
+    [0x7c60, "(s)"],
+    [0x7c61, "(ms)"],
+    [0x7c62, "(t)"],
+    [0x7c63, "(bs)"],
+    [0x7c64, "(b)"],
+    [0x7c65, "(tb)"],
+    [0x7c66, "(tp)"],
+    [0x7c67, "(ds)"],
+    [0x7c68, "(ag)"],
+    [0x7c69, "(eg)"],
+    [0x7c6a, "(vo)"],
+    [0x7c6b, "(fl)"],
+    [0x7c6c, "(ke"],
+    [0x7c6d, "y)"],
+    [0x7c6e, "(sa"],
+    [0x7c6f, "x)"],
+    [0x7c70, "(sy"],
+    [0x7c71, "n)"],
+    [0x7c72, "(or"],
+    [0x7c73, "g)"],
+    [0x7c74, "(pe"],
+    [0x7c75, "r)"],
+    // 93区46・47点・87点。規格で空き
+    [0x7d4e, "・"],
+    [0x7d4f, "・"],
+    [0x7d77, "　"],
+]);
+export const GAIJI = new Map();
+[...ADDITIONAL].forEach((char, i) => {
+    if (char === "�")
+        return;
+    GAIJI.set(((0x20 + 85 + Math.floor(i / 94)) << 8) | (0x21 + (i % 94)), char);
+});
+for (const [code, text] of EPG_ONLY)
+    GAIJI.set(code, text);

package/dist/aribtext.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ARIB STD-B24 の8単位符号を読む。番組名・概要・局名はこの形式で流れてくる。
+ *
+ * ## 仕組み
+ *
+ * 符号表を4つ (G0〜G3) 持ち、**どの表を今使うか**を切り替えながら読む。
+ * 0x21〜0x7E は GL に、0xA1〜0xFE は GR に割り当てられた表で引く。
+ * SI の初期状態は G0=漢字 / G1=英数 / G2=ひらがな / G3=カタカナ、GL=G0・GR=G2。
+ *
+ * ## 英数の幅は文字の大きさで決まる
+ *
+ * 英数集合 (と空白) は**いまの文字の大きさ**で描く。SI の初期状態は標準 (NSZ) で、
+ * テレビはこれを全角で描く。半角にしたい局は中型 (MSZ) を挟んでくる (ARIB TR-B14)。
+ * 番組名の「Ｖｅｎｕｅ１０１」は英数集合を標準のまま送ったもの。**放送のとおりに出す** —
+ * 探すときや比べるときに半角へ寄せるのは使う側 (`fold.toHalfWidth` / `title.searchable`)。
+ * 全角は `toHalfWidth` でそのまま戻る字 (U+FF01〜U+FF5E) にする (0x5C は ＼、0x7E は ～)
+ *
+ * ## 漢字は EUC-JP に押し付ける
+ *
+ * 2バイトの漢字集合は JIS X 0208 そのもので、区点は (第1-0x20, 第2-0x20)。
+ * **各バイトの最上位を立てれば EUC-JP になる**ので、変換表を抱え込まずに
+ * `TextDecoder('euc-jp')` に渡せる。自前で持つのは規格の外にある外字だけ
+ * ([aribtext-gaiji.ts](aribtext-gaiji.ts))。
+ */
+/**
+ * 8単位符号を読んで文字列にする。
+ *
+ * 壊れた並びで例外を投げない。放送波は落ちるもので、1つの記述子が読めなくても
+ * 番組表全体を落とすほうが害が大きい。**読めたところまで返す。**
+ */
+export declare function decodeAribText(data: Uint8Array): string;