@danything/arib 1.0.2 → 1.2.1

package/README.md

@@ -1,17 +1,17 @@
 # @danything/arib
 
 日本のデジタル放送 (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単位符号 (JIS X 0213 の1面・2面まで) と ARIB 外字 (`aribtext`、`aribtext-gaiji`)
-- **字幕** — STD-B24 の字幕文を、字の置き場所まで決めた JSON にする (`b24caption`、形式は `caption-text`)
-- **データ放送** — DSM-CC のカルーセルからモジュールとファイルを組み立てる (`dsmcc`、`multipart`、`bml`、形式は `bml-protocol`)
-- **Hybridcast の AIT** (`ait`)、**1つの局だけを抜き出す** (`service-filter`)
-- **試験用の TS を組み立てる** — PSI・EIT・字幕・カルーセル・映像と音声 (`synth`、`synth-caption`、`synth-av`)
-- 下で使う道具 — バイト列 (`bytes`)、言語の名前 (`language`)、文字の表 (`b24-tables`)、字幕の外字の画像をなめらかにする (`drcs-smooth`)
+録画サーバ [denpa](https://github.com/danything/denpa) の中で使っているものを切り出しました。
+
+- PSI (`psi`): パケットの切り出し、セクションの組み立て、PAT / PMT / SDT / NIT。衛星はネットワークの全部の TS の NIT と、ほかの TS の SDT もそろえて読む
+- 映像・音声の PES と ADTS を取り出す (`pes`)
+- 番組表の EIT[p/f] と EIT[schedule] を、ジャンル・音声・拡張形式イベント・シリーズ記述子まで読む。放送の時刻 (TDT / TOT) もここ (`eit`)
+- ARIB STD-B24 の 8 単位符号 (JIS X 0213 の 1 面・2 面まで) と ARIB 外字を文字列にする (`aribtext`、`aribtext-gaiji`)
+- 字幕は STD-B24 の字幕文を、字の置き場所まで決めた JSON にする (`b24caption`、形式は `caption-text`)
+- データ放送は DSM-CC のカルーセルからモジュールとファイルを組み立てる (`dsmcc`、`multipart`、`bml`、形式は `bml-protocol`)
+- Hybridcast の AIT を読む (`ait`)。1 つの局だけを抜き出す (`service-filter`)
+- 試験用の TS (PSI・EIT・字幕・カルーセル・映像と音声) を組み立てる (`synth`、`synth-caption`、`synth-av`)
+- ほかのモジュールが使う道具として、バイト列 (`bytes`)、言語の名前 (`language`)、文字の表 (`b24-tables`)、字幕の外字の画像をなめらかにする処理 (`drcs-smooth`)
 
 依存するパッケージはありません。
 
@@ -35,7 +35,7 @@ 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);
     }
@@ -53,7 +53,7 @@ decodeAribText(bytes); // "🈟ニュース"
 import { B24CaptionDecoder } from "@danything/arib/b24caption";
 
 const captions = new B24CaptionDecoder();
-// 字幕の PES の中身 (データ識別 0x80 から) を1つずつ渡す
+// 字幕の PES の中身 (データ識別 0x80 から) を 1 つずつ渡す
 const page = captions.decode(pesPayload);
 if (page !== null) draw(page); // 形式は caption-text.ts の CaptionPage
 ```

package/dist/ait.d.ts

@@ -8,7 +8,7 @@
  * ```
  * PMT ─ ES に application_signalling_descriptor (0x6F) ─→ その PID に AIT
  * AIT ─ transport_protocol_descriptor (URL の頭)
- *     └ simple_application_location_descriptor (その先のパス)  →  アプリのURL
+ *     └ simple_application_location_descriptor (その先のパス)  →  アプリの URL
  * ```
  *
  * ここは読んで在ることを言うだけです。開くのはデータ放送が起動を求めたときで
@@ -59,39 +59,39 @@ export interface Ait {
 /**
  * PMT から「AIT が流れている PID」を読み取る。
  *
- * **記述子が付いている ES を見るだけ。** `stream_type` では決められません —
+ * **記述子が付いている ES を見るだけ。** `stream_type` では決められません。
  * AIT は DSM-CC セクション (0x0D) で運ばれ、データ放送のカルーセルと同じ型を
  * 名乗るので、型だけでは見分けが付きません
  */
 export declare function aitPidsFromPmt(section: Uint8Array): number[];
 /**
- * AIT のセクションを1つ読む。**壊れていたら `null`** (放送は途中から読むので、
+ * AIT のセクションを 1 つ読む。**壊れていたら `null`** (放送は途中から読むので、
  * 読めないものが来るのは普通のこと)
  */
 export declare function parseAit(section: Uint8Array): Ait | null;
 /**
  * TS から Hybridcast のアプリを見つける。
  *
- * **PMT を見てから AIT を読む** という2段なので、繋いだ直後は何も返しません。
+ * **PMT を見てから AIT を読む** という 2 段なので、繋いだ直後は何も返しません。
  * 局を変えたら作り直します。
  *
- * 局に Hybridcast が無ければ、**PMT に印が無い**ので AIT を待つこともしません
- * — その局では永久に何も返さないのが正しい振る舞いです。
+ * 局に Hybridcast が無ければ、**PMT に印が無い**ので AIT を待つこともしません。
+ * その局では永久に何も返さないのが正しい振る舞いです。
  */
 export declare class AitReader {
     private readonly packets;
     private readonly pmt;
-    /** AIT を組み立てるもの。PID ごとに1つ */
+    /** AIT を組み立てるもの。PID ごとに 1 つ */
     private aits;
     constructor(serviceId: number);
     /**
-     * TS を食べて、見つかったものを返す。**見つからない間は空**。
+     * TS を読んで、見つかったものを返す。**見つからない間は空**。
      *
-     * 同じものが何度も返るのは呼ぶ側で畳んでください — 放送は同じ表を
+     * 同じものが何度も返るのは呼ぶ側で畳んでください。放送は同じ表を
      * 繰り返し流すので、ここで覚えると「局を変えても消えない」になります
      */
     feed(chunk: Uint8Array): Ait[];
-    /** 切り分け済みのパケットを1つ。見つかったものは `found` に足す (`BmlDecoder.feedPacket` と同じ事情) */
+    /** 切り分け済みのパケットを 1 つ。見つかったものは `found` に足す (`BmlDecoder.feedPacket` と同じ事情) */
     feedPacket(packet: Uint8Array, found: Ait[]): void;
 }
 export {};

package/dist/ait.js

@@ -8,7 +8,7 @@
  * ```
  * PMT ─ ES に application_signalling_descriptor (0x6F) ─→ その PID に AIT
  * AIT ─ transport_protocol_descriptor (URL の頭)
- *     └ simple_application_location_descriptor (その先のパス)  →  アプリのURL
+ *     └ simple_application_location_descriptor (その先のパス)  →  アプリの URL
  * ```
  *
  * ここは読んで在ることを言うだけです。開くのはデータ放送が起動を求めたときで
@@ -56,7 +56,7 @@ export const CONTROL = {
 /**
  * PMT から「AIT が流れている PID」を読み取る。
  *
- * **記述子が付いている ES を見るだけ。** `stream_type` では決められません —
+ * **記述子が付いている ES を見るだけ。** `stream_type` では決められません。
  * AIT は DSM-CC セクション (0x0D) で運ばれ、データ放送のカルーセルと同じ型を
  * 名乗るので、型だけでは見分けが付きません
  */
@@ -92,8 +92,8 @@ function transportUrl(body) {
 /**
  * 名前を取り出す (application_name_descriptor)。
  *
- * 言語ごとに何本も入っていることがあるので**最初の1本**を採ります。中身は
- * ARIB の8単位符号なので、番組名と同じ方法で読みます (`aribtext.ts`)
+ * 言語ごとに何本も入っていることがあるので**最初の 1 本**を採ります。中身は
+ * ARIB の 8 単位符号なので、番組名と同じ方法で読みます (`aribtext.ts`)
  */
 function applicationName(body) {
     // [0..2] ISO_639_language_code, [3] application_name_length
@@ -105,7 +105,7 @@ function applicationName(body) {
     return decodeAribText(body.subarray(4, 4 + length)).trim();
 }
 /**
- * AIT のセクションを1つ読む。**壊れていたら `null`** (放送は途中から読むので、
+ * AIT のセクションを 1 つ読む。**壊れていたら `null`** (放送は途中から読むので、
  * 読めないものが来るのは普通のこと)
  */
 export function parseAit(section) {
@@ -159,24 +159,24 @@ export function parseAit(section) {
 /**
  * TS から Hybridcast のアプリを見つける。
  *
- * **PMT を見てから AIT を読む** という2段なので、繋いだ直後は何も返しません。
+ * **PMT を見てから AIT を読む** という 2 段なので、繋いだ直後は何も返しません。
  * 局を変えたら作り直します。
  *
- * 局に Hybridcast が無ければ、**PMT に印が無い**ので AIT を待つこともしません
- * — その局では永久に何も返さないのが正しい振る舞いです。
+ * 局に Hybridcast が無ければ、**PMT に印が無い**ので AIT を待つこともしません。
+ * その局では永久に何も返さないのが正しい振る舞いです。
  */
 export class AitReader {
     packets = new PacketStream();
     pmt;
-    /** AIT を組み立てるもの。PID ごとに1つ */
+    /** AIT を組み立てるもの。PID ごとに 1 つ */
     aits = new Map();
     constructor(serviceId) {
         this.pmt = new PmtTracker(serviceId);
     }
     /**
-     * TS を食べて、見つかったものを返す。**見つからない間は空**。
+     * TS を読んで、見つかったものを返す。**見つからない間は空**。
      *
-     * 同じものが何度も返るのは呼ぶ側で畳んでください — 放送は同じ表を
+     * 同じものが何度も返るのは呼ぶ側で畳んでください。放送は同じ表を
      * 繰り返し流すので、ここで覚えると「局を変えても消えない」になります
      */
     feed(chunk) {
@@ -185,7 +185,7 @@ export class AitReader {
             this.feedPacket(packet, found);
         return found;
     }
-    /** 切り分け済みのパケットを1つ。見つかったものは `found` に足す (`BmlDecoder.feedPacket` と同じ事情) */
+    /** 切り分け済みのパケットを 1 つ。見つかったものは `found` に足す (`BmlDecoder.feedPacket` と同じ事情) */
     feedPacket(packet, found) {
         const pid = packetPid(packet);
         const before = this.pmt.pid;

package/dist/aribtext-gaiji.d.ts

@@ -1,5 +1,5 @@
 /**
- * ARIB 外字。放送で使われる、JIS X 0208 の外にある文字の対応表 (85区から先)。
+ * ARIB 外字。放送で使われる、JIS X 0208 の外にある文字の対応表 (85 区から先)。
  *
  * 番組名の「🈟」「🈑」「🈞」([新][字][再]) はここにある。読めないと、番組表から
  * その印が丸ごと消えるか、化けた文字が並ぶ。
@@ -9,16 +9,16 @@
  * ([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` だけ:
+ * STD-B62 表 5-2)。番組表で違えるのは下の `EPG_ONLY` だけで、次の 2 つ。
  *
- * - 92区56〜85点 (楽器の略号) は規格でも私用領域 (U+E2A5〜) にしか字が無い。どこでも読めるよう
+ * - 92 区 56〜85 点 (楽器の略号) は規格でも私用領域 (U+E2A5〜) にしか字が無い。どこでも読めるよう
  *   「(vn)」のような文字列に開く (字幕は私用領域のまま。フォントがその字形を持つ)
- * - 93区46・47点と87点は規格で空き。昔の表 (epgdump_py から ariblib に引き継がれた表) のとおり
+ * - 93 区 46・47 点と 87 点は規格で空き。昔の表 (epgdump_py から ariblib に引き継がれた表) のとおり
  *   中黒と全角の空白で埋める (字幕では空きのまま)
  *
  * 表で空き (U+FFFD) の点は持たない。`aribtext.ts` が「□」にする。
  *
- * 鍵は区点そのまま — 第1バイトが 0x20+区、第2バイトが 0x20+点。
+ * 鍵は区点そのまま (第 1 バイトが 0x20+区、第 2 バイトが 0x20+点)。
  */
 /** 番組表だけで違える字。区点 → 字 (上の説明) */
 export declare const EPG_ONLY: Map<number, string>;

package/dist/aribtext-gaiji.js

@@ -1,5 +1,5 @@
 /**
- * ARIB 外字。放送で使われる、JIS X 0208 の外にある文字の対応表 (85区から先)。
+ * ARIB 外字。放送で使われる、JIS X 0208 の外にある文字の対応表 (85 区から先)。
  *
  * 番組名の「🈟」「🈑」「🈞」([新][字][再]) はここにある。読めないと、番組表から
  * その印が丸ごと消えるか、化けた文字が並ぶ。
@@ -9,21 +9,21 @@
  * ([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` だけ:
+ * STD-B62 表 5-2)。番組表で違えるのは下の `EPG_ONLY` だけで、次の 2 つ。
  *
- * - 92区56〜85点 (楽器の略号) は規格でも私用領域 (U+E2A5〜) にしか字が無い。どこでも読めるよう
+ * - 92 区 56〜85 点 (楽器の略号) は規格でも私用領域 (U+E2A5〜) にしか字が無い。どこでも読めるよう
  *   「(vn)」のような文字列に開く (字幕は私用領域のまま。フォントがその字形を持つ)
- * - 93区46・47点と87点は規格で空き。昔の表 (epgdump_py から ariblib に引き継がれた表) のとおり
+ * - 93 区 46・47 点と 87 点は規格で空き。昔の表 (epgdump_py から ariblib に引き継がれた表) のとおり
  *   中黒と全角の空白で埋める (字幕では空きのまま)
  *
  * 表で空き (U+FFFD) の点は持たない。`aribtext.ts` が「□」にする。
  *
- * 鍵は区点そのまま — 第1バイトが 0x20+区、第2バイトが 0x20+点。
+ * 鍵は区点そのまま (第 1 バイトが 0x20+区、第 2 バイトが 0x20+点)。
  */
 import { ADDITIONAL } from "./b24-tables.js";
 /** 番組表だけで違える字。区点 → 字 (上の説明) */
 export const EPG_ONLY = new Map([
-    // 92区56〜85点。規格でも私用領域
+    // 92 区 56〜85 点。規格でも私用領域
     [0x7c58, "(vn)"],
     [0x7c59, "(ob)"],
     [0x7c5a, "(cb)"],
@@ -54,7 +54,7 @@ export const EPG_ONLY = new Map([
     [0x7c73, "g)"],
     [0x7c74, "(pe"],
     [0x7c75, "r)"],
-    // 93区46・47点・87点。規格で空き
+    // 93 区 46・47 点・87 点。規格で空き
     [0x7d4e, "・"],
     [0x7d4f, "・"],
     [0x7d77, "　"],

package/dist/aribtext.d.ts

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

package/dist/aribtext.js

@@ -1,9 +1,9 @@
 /**
- * ARIB STD-B24 の8単位符号を読む。番組名・概要・局名はこの形式で流れてくる。
+ * ARIB STD-B24 の 8 単位符号を読む。番組名・概要・局名はこの形式で流れてくる。
  *
  * ## 仕組み
  *
- * 符号表を4つ (G0〜G3) 持ち、**どの表を今使うか**を切り替えながら読む。
+ * 符号表を 4 つ (G0〜G3) 持ち、**どの表を今使うか**を切り替えながら読む。
  * 0x21〜0x7E は GL に、0xA1〜0xFE は GR に割り当てられた表で引く。
  * SI の初期状態は G0=漢字 / G1=英数 / G2=ひらがな / G3=カタカナ、GL=G0・GR=G2。
  *
@@ -11,19 +11,19 @@
  *
  * 英数集合 (と空白) は**いまの文字の大きさ**で描く。SI の初期状態は標準 (NSZ) で、
  * テレビはこれを全角で描く。半角にしたい局は中型 (MSZ) を挟んでくる (ARIB TR-B14)。
- * 番組名の「Ｖｅｎｕｅ１０１」は英数集合を標準のまま送ったもの。**放送のとおりに出す** —
+ * 番組名の「Ｖｅｎｕｅ１０１」は英数集合を標準のまま送ったもの。**放送のとおりに出す。**
  * 探すときや比べるときに半角へ寄せるのは使う側 (denpa なら `fold.toHalfWidth` / `title.searchable`)。
  * 全角は `toHalfWidth` でそのまま戻る字 (U+FF01〜U+FF5E) にする (0x5C は ＼、0x7E は ～)
  *
- * ## 漢字は EUC-JP に押し付ける
+ * ## 漢字は EUC-JP として読む
  *
- * 2バイトの漢字集合は JIS X 0208 の並びで、区点は (第1-0x20, 第2-0x20)。
+ * 2 バイトの漢字集合は JIS X 0208 の並びで、区点は (第 1-0x20, 第 2-0x20)。
  * **各バイトの最上位を立てれば EUC-JP になる**ので、ほとんどの字は
- * `TextDecoder('euc-jp')` に渡せる。自前の表を引くのは:
+ * `TextDecoder('euc-jp')` に渡せる。自前の表を引くのは次の字だけ。
  *
- * - 85区から先の外字 ([aribtext-gaiji.ts](aribtext-gaiji.ts))
- * - EUC-JP に無い JIS X 0213 の1面の字 (字幕と同じ表。▷ や ⓐ、か゚ のような2つのコードポイントの字も)
- * - JIS互換漢字1面 (終端 0x39) の 85〜94区と、2面 (0x3A) 全部 (`PLANE1_HIGH`・`PLANE2`)
+ * - 85 区から先の外字 ([aribtext-gaiji.ts](aribtext-gaiji.ts))
+ * - EUC-JP に無い JIS X 0213 の 1 面の字 (字幕と同じ表。▷ や ⓐ、か゚ のような 2 つのコードポイントの字も)
+ * - JIS 互換漢字 1 面 (終端 0x39) の 85〜94 区と、2 面 (0x3A) 全部 (`PLANE1_HIGH`・`PLANE2`)
  */
 import { GAIJI } from "./aribtext-gaiji.js";
 import { HIRAGANA as HIRAGANA_TABLE, JISX0201_HALF, KANJI_DIFF, KANJI_SEQUENCES, KATAKANA as KATAKANA_TABLE, PLANE1_HIGH, PLANE2, } from "./b24-tables.js";
@@ -37,9 +37,9 @@ const MOSAIC = { bytes: 1, kind: "blank" };
  * 終端バイト → 符号表。ESC の指示で使う。
  *
  * モザイク (0x32〜0x35) は図形なので読めるものが無い。**捨てずに空へ倒す**のは、
- * 1バイト表として字数を数え続けないと以降がずれるため。
+ * 1 バイト表として字数を数え続けないと以降がずれるため。
  *
- * **オブジェクトではなく Map。** 数値のキーは書式が10進に直されてしまい、
+ * **オブジェクトではなく Map。** 数値のキーは書式が 10 進に直されてしまい、
  * 規格に載っている終端バイトと突き合わせられなくなる (この下も同じ)。
  */
 const CHARSETS = new Map([
@@ -59,22 +59,22 @@ const CHARSETS = new Map([
     [0x34, MOSAIC],
     [0x35, MOSAIC],
 ]);
-/** 外字にも JIS にも無い文字を出すときの印。消すとタイトルから1文字黙って落ちる */
+/** 外字にも JIS にも無い文字を出すときの印。消すとタイトルから 1 文字黙って落ちる */
 const UNKNOWN = "□";
 /**
- * 1バイトの集合は字幕と同じ表 ([b24-tables.ts](b24-tables.ts)) を引く。**番組表で違えるところ**:
+ * 1 バイトの集合は字幕と同じ表 ([b24-tables.ts](b24-tables.ts)) を引く。**字幕と違えるところは次のとおり。**
  *
  * - ひらがなの 0x74〜0x76 は規格で空き。字幕は全角の空白で埋めるが、番組表では何も出さない
  * - JIS X 0201 カタカナはいつも半角 (字幕は大きさで全角と半角を描き分ける)
  * - 英数は大きさに従って全角か ASCII (字幕の半角の表は 0x5C が ¥、0x7E が ‾。番組表は検索で打つ字に合わせる)
- * - 漢字は EUC-JP のまま読む (字幕は 1区33点の 〜・34点の ‖・61点の − などを差し替える。`KANJI_DIFF`)。
+ * - 漢字は EUC-JP のまま読む (字幕は 1 区 33 点の 〜・34 点の ‖・61 点の − などを差し替える。`KANJI_DIFF`)。
  *   EUC-JP に無い点だけ字幕と同じ JIS X 0213 の字を引く
  */
 const HIRA = [...HIRAGANA_TABLE];
 const KATA = [...KATAKANA_TABLE];
 const ANK = [...JISX0201_HALF];
 const eucjp = new TextDecoder("euc-jp");
-/** EUC-JP に無い JIS X 0213 の1面の字 (区×94+点 → 字)。字幕と同じ表 */
+/** EUC-JP に無い JIS X 0213 の 1 面の字 (区×94+点 → 字)。字幕と同じ表 */
 const x0213 = new Map(KANJI_SEQUENCES);
 for (const [start, chars] of KANJI_DIFF) {
     let i = start;
@@ -85,17 +85,17 @@ for (const [start, chars] of KANJI_DIFF) {
     }
 }
 const PLANE1_HIGH_CHARS = [...PLANE1_HIGH];
-/** 2面の区 (1〜94) → 94 字 */
+/** 2 面の区 (1〜94) → 94 字 */
 const PLANE2_ROWS = new Map(PLANE2.map(([ku, row]) => [ku, [...row]]));
 /**
- * 2バイト文字の変換結果を覚えておく。
+ * 2 バイト文字の変換結果を覚えておく。
  *
- * 番組表は同じ字が何万回も出てくるので、1文字ごとに `TextDecoder` を
+ * 番組表は同じ字が何万回も出てくるので、1 文字ごとに `TextDecoder` を
  * 呼び直すと配列の確保だけで効いてくる。
  */
 const cache = new Map();
 function twoByte(code, kind) {
-    // 2面と、1面の 85区から先は同じ区点でも別の字。覚えるときも漢字集合と混ぜない
+    // 2 面と、1 面の 85 区から先は同じ区点でも別の字。覚えるときも漢字集合と混ぜない
     const high = code >> 8;
     const low = code & 0xff;
     const key = kind === "plane2"
@@ -116,7 +116,7 @@ function twoByte(code, kind) {
         decoded = PLANE2_ROWS.get(ku)?.[low - 0x21] ?? "";
     }
     else if (ku >= 85) {
-        // 85区から先は自前の表だけで引く。EUC-JP に渡すと 89〜92区が IBM 拡張の漢字になる
+        // 85 区から先は自前の表だけで引く。EUC-JP に渡すと 89〜92 区が IBM 拡張の漢字になる
         decoded =
             kind === "plane1"
                 ? (PLANE1_HIGH_CHARS[cell - 84 * 94] ?? "")
@@ -147,7 +147,7 @@ const SZX = 0x8b;
 const SZX_TINY = 0x60;
 /** 標準の大きさの空白 (U+3000) */
 const WIDE_SPACE = String.fromCharCode(0x3000);
-/** C1 も同じ。COL/CDC は最初の引数が 0x20 のときだけもう1つ増える */
+/** C1 も同じ。COL/CDC は最初の引数が 0x20 のときだけもう 1 つ増える */
 const C1_PARAMS = new Map([
     [0x8b, 1], // SZX
     [0x90, 1], // COL
@@ -160,16 +160,16 @@ const C1_PARAMS = new Map([
     [0x9d, 2], // TIME
 ]);
 /**
- * 8単位符号を読んで文字列にする。
+ * 8 単位符号を読んで文字列にする。
  *
- * 壊れた並びで例外を投げない。放送波は落ちるもので、1つの記述子が読めなくても
+ * 壊れた並びで例外を投げない。放送波は落ちるもので、1 つの記述子が読めなくても
  * 番組表全体を落とすほうが害が大きい。**読めたところまで返す。**
  */
 export function decodeAribText(data) {
     const g = [KANJI, ALNUM, HIRAGANA, KATAKANA];
     let gl = 0;
     let gr = 2;
-    /** 単発シフト (SS2/SS3)。1文字だけ別の表を使ったら元に戻す */
+    /** 単発シフト (SS2/SS3)。1 文字だけ別の表を使ったら元に戻す */
     let single = null;
     /** 英数と空白を半角で描く大きさか (MSZ/SSZ)。SI の初期状態は標準 (NSZ) で全角 */
     let half = false;
@@ -248,7 +248,7 @@ export function decodeAribText(data) {
             else if (byte === SZX)
                 half = data[at] === SZX_TINY;
             let params = C1_PARAMS.get(byte) ?? 0;
-            // COL と CDC は「色を直に指定する」形式のときだけ引数が1つ増える
+            // COL と CDC は「色を直に指定する」形式のときだけ引数が 1 つ増える
             if ((byte === 0x90 || byte === 0x92) && data[at] === 0x20)
                 params = 2;
             at += params;
@@ -302,7 +302,7 @@ const LOCKING = new Map([
 ]);
 /**
  * ESC のあとを読む。**指示 (どの表を G0〜G3 に載せるか) と
- * 呼び出し (どの G を GL/GR に出すか) の2種類がある。**
+ * 呼び出し (どの G を GL/GR に出すか) の 2 種類がある。**
  *
  * @returns 次に読むべき位置
  */
@@ -315,13 +315,13 @@ function afterEscape(data, at, designate, invoke) {
         invoke(shift[0], shift[1]);
         return at + 1;
     }
-    // 2バイト集合の指示。ESC 0x24 F は G0 への指示の略記
+    // 2 バイト集合の指示。ESC 0x24 F は G0 への指示の略記
     if (byte === 0x24) {
         const next = data[at + 1];
         if (next === undefined)
             return at + 2;
         if (next >= 0x28 && next <= 0x2b) {
-            // ESC 0x24 0x2x 0x20 F は2バイトDRCS。読めないので空へ倒す
+            // ESC 0x24 0x2x 0x20 F は 2 バイト DRCS。読めないので空へ倒す
             if (data[at + 2] === 0x20) {
                 designate(next - 0x28, { bytes: 2, kind: "blank" });
                 return at + 4;
@@ -332,17 +332,17 @@ function afterEscape(data, at, designate, invoke) {
         designate(0, CHARSETS.get(next));
         return at + 2;
     }
-    // 1バイト集合の指示
+    // 1 バイト集合の指示
     if (byte >= 0x28 && byte <= 0x2b) {
         const target = byte - 0x28;
         if (data[at + 1] === 0x20) {
-            // 1バイトDRCS
+            // 1 バイト DRCS
             designate(target, MOSAIC);
             return at + 3;
         }
         designate(target, CHARSETS.get(data[at + 1]));
         return at + 2;
     }
-    // 知らない指示。1バイトだけ飛ばして読み進める (止めるより取り返しがつく)
+    // 知らない指示。1 バイトだけ飛ばして読み進める (止めるより取り返しがつく)
     return at + 1;
 }

package/dist/b24-tables.d.ts

@@ -10,7 +10,7 @@
  * **表の名前と `export const` の形は変えない。** danything/denpa-font の道具がこのファイルを
  * 名前で読んでフォントに入れる字を決める (`ADDITIONAL_ROWS`・`PLANE1_HIGH_ROWS` も。`aribtext-gaiji.ts`・`fold.ts` も同じ)。
  *
- * - 漢字は EUC-JP で読んだものと違うところだけ持つ (`KANJI_DIFF`。番組表は EUC-JP のまま読む —
+ * - 漢字は EUC-JP で読んだものと違うところだけ持つ (`KANJI_DIFF`。番組表は EUC-JP のまま読むので、
  *   1区33点の 〜 / ～ などは字幕と番組表で違えてある。aribtext.ts の説明)。1〜84区は JIS X 0213:2004 の1面と
  *   同じ字 (全角の形を選んだ点と、1区17点の ￣ など libaribcaption のとおりの数点を除く)
  * - JIS X 0213 の表 (2つのコードポイントの字・1面の 85〜94区・2面) は [scripts/jisx0213.ts](../scripts/jisx0213.ts) が
@@ -20,7 +20,7 @@
  * ## 外字 (DRCS) の置き換えを足す
  *
  * 放送は字幕の外字を小さな画像で送ってくる。画像の MD5 (`b24caption.ts` が中身の画素から取る) が
- * `DRCS_REPLACE` にあれば、その字に置き換えて描く (無ければ画像のまま)。足すときは:
+ * `DRCS_REPLACE` にあれば、その字に置き換えて描く (無ければ画像のまま)。足すときは次の手順。
  *
  * 1. 字幕の JSON (`/api/recordings/<id>/captions.json` の `drcs`) の `md5` を読み取る。`data` の画像は送るために
  *    なめらかにしたもの (drcs-smooth.ts) なので、`data` から MD5 を取っても表と合わない

package/dist/b24-tables.js

@@ -10,7 +10,7 @@
  * **表の名前と `export const` の形は変えない。** danything/denpa-font の道具がこのファイルを
  * 名前で読んでフォントに入れる字を決める (`ADDITIONAL_ROWS`・`PLANE1_HIGH_ROWS` も。`aribtext-gaiji.ts`・`fold.ts` も同じ)。
  *
- * - 漢字は EUC-JP で読んだものと違うところだけ持つ (`KANJI_DIFF`。番組表は EUC-JP のまま読む —
+ * - 漢字は EUC-JP で読んだものと違うところだけ持つ (`KANJI_DIFF`。番組表は EUC-JP のまま読むので、
  *   1区33点の 〜 / ～ などは字幕と番組表で違えてある。aribtext.ts の説明)。1〜84区は JIS X 0213:2004 の1面と
  *   同じ字 (全角の形を選んだ点と、1区17点の ￣ など libaribcaption のとおりの数点を除く)
  * - JIS X 0213 の表 (2つのコードポイントの字・1面の 85〜94区・2面) は [scripts/jisx0213.ts](../scripts/jisx0213.ts) が
@@ -20,7 +20,7 @@
  * ## 外字 (DRCS) の置き換えを足す
  *
  * 放送は字幕の外字を小さな画像で送ってくる。画像の MD5 (`b24caption.ts` が中身の画素から取る) が
- * `DRCS_REPLACE` にあれば、その字に置き換えて描く (無ければ画像のまま)。足すときは:
+ * `DRCS_REPLACE` にあれば、その字に置き換えて描く (無ければ画像のまま)。足すときは次の手順。
  *
  * 1. 字幕の JSON (`/api/recordings/<id>/captions.json` の `drcs`) の `md5` を読み取る。`data` の画像は送るために
  *    なめらかにしたもの (drcs-smooth.ts) なので、`data` から MD5 を取っても表と合わない

package/dist/b24caption.d.ts

@@ -1,21 +1,21 @@
 /**
  * 放送の字幕 (ARIB STD-B24 の字幕文) をデコードして、**字の置き場所まで決める** ([caption-text.ts](caption-text.ts))。
  *
- * libaribcaption の「デコードする (decoder)」側を写したもの — 置き場所・大きさ・色・外字の置き換えまでは
+ * libaribcaption の「デコードする (decoder)」側を写したもの。置き場所・大きさ・色・外字の置き換えまでは
  * 同じ計算で、描く (renderer) 手前で止める。描くのは受け側 (ブラウザ・アプリ)。
  *
- * 写したのは日本の放送で要るところだけ: 8単位符号 (JIS)・Profile A (フルセグ)。言語は1つを選んで読む
- * (既定は第1言語。`new B24CaptionDecoder(2)` で第2言語)。
+ * 写したのは日本の放送で要るところだけ: 8 単位符号 (JIS)・Profile A (フルセグ)。言語は 1 つを選んで読む
+ * (既定は第 1 言語。`new B24CaptionDecoder(2)` で第 2 言語)。
  * ブラジルの Latin・UTF-8・ワンセグ (Profile C) は持たない。
  *
  * ## libaribcaption と違えたところ
  *
  * - **字幕管理データの「送り直し」の見分け。** あちらは群 (A/B) を `(id & 0xF0) >> 8` で
- *   取っていて常に 0 になり、最初の1回しか読まない。ここは群を正しく見る
+ *   取っていて常に 0 になり、最初の 1 回しか読まない。ここは群を正しく見る
  *   (番組が変わって群が替わったときに書式を読み直す)
  * - **点滅 (FLC) を読み取る。** あちらは読み捨てている
- * - **JIS X 0213 を最後まで読む。** JIS互換漢字2面 (0x3A) を2面の表で、1面 (0x39) の 85〜94区を
- *   第3水準の漢字で引く。か゚ のような2つのコードポイントの字も出す (あちらは空き)
+ * - **JIS X 0213 を最後まで読む。** JIS 互換漢字 2 面 (0x3A) を 2 面の表で、1 面 (0x39) の 85〜94 区を
+ *   第 3 水準の漢字で引く。か゚ のような 2 つのコードポイントの字も出す (あちらは空き)
  * - **表で空いている点 (U+FFFD) はゲタ (〓) にする。** 「�」は Denpa Font に無く、端末の字の
  *   「?」の印で出る。定義されていない外字と同じ扱い
  *
@@ -24,11 +24,11 @@
  */
 import { type CaptionLanguage, type CaptionPage } from "./caption-text.js";
 /**
- * 字幕のストリーム1本ぶんのデコーダ。**状態を持つ** (書式・位置・色・外字は字幕文を跨いで続く) ので、
- * ストリームごとに1つ作って、届いた順に食わせる。
+ * 字幕のストリーム 1 本ぶんのデコーダ。**状態を持つ** (書式・位置・色・外字は字幕文を跨いで続く) ので、
+ * ストリームごとに 1 つ作って、届いた順に渡す。
  *
- * **読むのは1つの言語だけ** (`language`。1〜8)。言語ごとに書式も位置も別に続くので、2つの言語を出し分けるなら
- * 言語ごとに1つ作って、同じコマを両方に食わせる (denpa の `server/captions.ts` の `CaptionText`)
+ * **読むのは 1 つの言語だけ** (`language`。1〜8)。言語ごとに書式も位置も別に続くので、2 つの言語を出し分けるなら
+ * 言語ごとに 1 つ作って、同じコマを両方に渡す (denpa の `server/captions.ts` の `CaptionText`)
  */
 export declare class B24CaptionDecoder {
     readonly language: number;
@@ -68,9 +68,9 @@ export declare class B24CaptionDecoder {
     /** @param language 読む言語 (1〜8。データグループの番号) */
     constructor(language?: number);
     /**
-     * 字幕の PES の中身を1つ食わせる。
+     * 字幕の PES の中身を 1 つ渡す。
      *
-     * @returns 出す1枚。出すものが無ければ (字幕管理データ・送り直し・待ちだけの字幕文) null
+     * @returns 出す 1 枚。出すものが無ければ (字幕管理データ・送り直し・待ちだけの字幕文) null
      */
     decode(data: Uint8Array): CaptionPage | null;
     private resetGraphicSets;