@danything/arib 1.2.0 → 1.2.2

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`)。衛星はネットワークの全部の TS の NIT と、ほかの TS の SDT もそろえて読む
-- **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,15 +37,15 @@ const MOSAIC = { bytes: 1, kind: "blank" };
  * 終端バイト → 符号表。ESC の指示で使う。
  *
  * モザイク (0x32〜0x35) は図形なので読めるものが無い。**捨てずに空へ倒す**のは、
- * 1バイト表として字数を数え続けないと以降がずれるため。
+ * 1 バイト表として字数を数え続けないと以降がずれるため。
  *
- * **オブジェクトではなく Map。** 数値のキーは書式が10進に直されてしまい、
+ * **オブジェクトではなく Map。** 数値のキーは書式が 10 進に直されてしまい、
  * 規格に載っている終端バイトと突き合わせられなくなる (この下も同じ)。
  */
 const CHARSETS = new Map([
     [0x42, KANJI],
-    [0x39, { bytes: 2, kind: "plane1" }], // JIS互換漢字1面
-    [0x3a, { bytes: 2, kind: "plane2" }], // JIS互換漢字2面
+    [0x39, { bytes: 2, kind: "plane1" }], // JIS 互換漢字 1 面
+    [0x3a, { bytes: 2, kind: "plane2" }], // JIS 互換漢字 2 面
     [0x3b, KANJI], // 追加記号 (漢字集合と同じ表を引く)
     [0x4a, ALNUM],
     [0x30, HIRAGANA],
@@ -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;
@@ -186,7 +186,7 @@ export function decodeAribText(data) {
         if (byte <= 0x20 || byte === 0x7f || byte === 0xa0 || byte === 0xff) {
             at++;
             switch (byte) {
-                case 0x0d: // APR。改行。直後の LF は同じ1回として畳む
+                case 0x0d: // APR。改行。直後の LF は同じ 1 回として畳む
                     out += "\n";
                     if (data[at] === 0x0a)
                         at++;
@@ -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,17 +10,17 @@
  * **表の名前と `export const` の形は変えない。** danything/denpa-font の道具がこのファイルを
  * 名前で読んでフォントに入れる字を決める (`ADDITIONAL_ROWS`・`PLANE1_HIGH_ROWS` も。`aribtext-gaiji.ts`・`fold.ts` も同じ)。
  *
- * - 漢字は 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) が
+ * - 漢字は 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) が
  *   x0213.org の対応表から書く。手で直さない
  * - U+FFFD は規格で空いているところ
  *
  * ## 外字 (DRCS) の置き換えを足す
  *
  * 放送は字幕の外字を小さな画像で送ってくる。画像の MD5 (`b24caption.ts` が中身の画素から取る) が
- * `DRCS_REPLACE` にあれば、その字に置き換えて描く (無ければ画像のまま)。足すときは:
+ * `DRCS_REPLACE` にあれば、その字に置き換えて描く (無ければ画像のまま)。足すときは次の手順。
  *
  * 1. 字幕の JSON (`/api/recordings/<id>/captions.json` の `drcs`) の `md5` を読み取る。`data` の画像は送るために
  *    なめらかにしたもの (drcs-smooth.ts) なので、`data` から MD5 を取っても表と合わない
@@ -41,11 +41,11 @@ export declare const JISX0201_HALF = "\uFF61\uFF62\uFF63\uFF64\uFF65\uFF66\uFF67
 export declare const ALNUM_FULL = "\uFF01\uFF02\uFF03\uFF04\uFF05\uFF06\uFF07\uFF08\uFF09\uFF0A\uFF0B\uFF0C\uFF0D\uFF0E\uFF0F\uFF10\uFF11\uFF12\uFF13\uFF14\uFF15\uFF16\uFF17\uFF18\uFF19\uFF1A\uFF1B\uFF1C\uFF1D\uFF1E\uFF1F\uFF20\uFF21\uFF22\uFF23\uFF24\uFF25\uFF26\uFF27\uFF28\uFF29\uFF2A\uFF2B\uFF2C\uFF2D\uFF2E\uFF2F\uFF30\uFF31\uFF32\uFF33\uFF34\uFF35\uFF36\uFF37\uFF38\uFF39\uFF3A\uFF3B\uFFE5\uFF3D\uFF3E\uFF3F\uFF40\uFF41\uFF42\uFF43\uFF44\uFF45\uFF46\uFF47\uFF48\uFF49\uFF4A\uFF4B\uFF4C\uFF4D\uFF4E\uFF4F\uFF50\uFF51\uFF52\uFF53\uFF54\uFF55\uFF56\uFF57\uFF58\uFF59\uFF5A\uFF5B\uFF5C\uFF5D\uFFE3";
 /** 同じものの半角 (中くらいのとき)。0x5C は ¥、0x7E は ‾ (番組表は ASCII のまま。バックスラッシュとチルダ) */
 export declare const ALNUM_HALF = "!\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\u00A5]^_`abcdefghijklmnopqrstuvwxyz{|}\u203E";
-/** 漢字の表の1・2区を、中くらいのときに半角へ寄せたもの */
+/** 漢字の表の 1・2 区を、中くらいのときに半角へ寄せたもの */
 export declare const KANJI_SYMBOLS_HALF = " \uFF64\uFF61,.\uFF65:;?!\uFF9E\uFF9F\u00B4`\u00A8^\u00AF_\u30FD\u30FE\u309D\u309E\u3003\u4EDD\u3005\u3006\u3007\uFF70\u2015\u2010/\\~\u2016|\u2026\u2025\u2018\u2019\u201C\u201D()\u3014\u3015[]{}\u3008\u3009\u300A\u300B\uFF62\uFF63\u300E\u300F\u3010\u3011+\u2212\u00B1\u00D7\u00F7=\u2260<>\u2266\u2267\u221E\u2234\u2642\u2640\u00B0\u2032\u2033\u2103\u00A5$\u00A2\u00A3%#&*@\u00A7\u2606\u2605\uFFEE\u25CF\u25CE\u25C7\u25C6\u25A1\uFFED\u25B3\u25B2\u25BD\u25BC\u203B\u3012\uFFEB\uFFE9\uFFEA\uFFEC\u3013'\"-~\u3033\u3034\u3035\u303B\u303C\u30FF\u309F\u2208\u220B\u2286\u2287\u2282\u2283\u222A\u2229\u2284\u2285\u228A\u228B\u2209\u2205\u2305\u2306\u2227\u2228\u00AC\u21D2\u21D4\u2200\u2203\u2295\u2296\u2297\u2225\u2226\u2985\u2986\u3018\u3019\u3016\u3017\u2220\u22A5\u2312\u2202\u2207\u2261\u2252\u226A\u226B\u221A\u223D\u221D\u2235\u222B\u222C\u2262\u2243\u2245\u2248\u2276\u2277\u2194\u212B\u2030\u266F\u266D\u266A\u2020\u2021\u00B6\u266E\u266B\u266C\u2669\u25EF";
-/** 漢字の表 (1〜84区) のうち、EUC-JP で読んだものと違うところ。[区×94+点 (0 から), そこから続く字] の並び。85区から先は `ADDITIONAL` */
+/** 漢字の表 (1〜84 区) のうち、EUC-JP で読んだものと違うところ。[区×94+点 (0 から), そこから続く字] の並び。85 区から先は `ADDITIONAL` */
 export declare const KANJI_DIFF: [number, string][];
-/** 追加記号・追加漢字を1つの文字列にしたもの。(区 − 85) × 94 + (点 − 1) 番目のコードポイント */
+/** 追加記号・追加漢字を 1 つの文字列にしたもの。(区 − 85) × 94 + (点 − 1) 番目のコードポイント */
 export declare const ADDITIONAL: string;
 /**
  * JIS X 0213:2004 の1面で、2つのコードポイントで表す字 (半濁点の付いたかな・発音記号と、声調の組)。
@@ -59,7 +59,7 @@ export declare const PLANE1_HIGH: string;
  */
 export declare const PLANE2: [number, string][];
 /**
- * 色の表 (CLUT)。8つの組 × 16色、RGBA の16進。後ろの4組 (65〜127) は 64 を引いた番号の色を半分透かしたもの (65〜72 だけは 0〜7 番の基本の色)。
+ * 色の表 (CLUT)。8 つの組 × 16 色、RGBA の 16 進。後ろの 4 組 (65〜127) は 64 を引いた番号の色を半分透かしたもの (65〜72 だけは 0〜7 番の基本の色)。
  * libaribcaption の表は 101 番と 119 番の青が `09` になっていたが、
  * 元の 37 番・55 番 (`55ff00`・`ff5500`) を透かしたものなので `00`
  */