@danything/arib 1.2.0 → 1.2.1

package/dist/eit.js

@@ -5,7 +5,7 @@
  * 空いているだけ並列に回せる**し、録画で開いているチャンネルのぶんはただで
  * 手に入る ([agent.md](https://github.com/danything/denpa/blob/main/docs/agent.md))。
  *
- * 扱うのは2種類。
+ * 扱うのは 2 種類。
  *
  * - **EIT[p/f]** (table_id 0x4E) … いま流れている番組と次の番組。**放送に追従する。**
  *   野球で延びた終了時刻はここに出る
@@ -22,9 +22,9 @@ const SCHEDULE_ACTUAL_MIN = 0x50;
 /** 詳細 (extended) の表はここから。基本と同じ並びがもう一度始まる */
 const SCHEDULE_ACTUAL_EXTENDED = 0x58;
 const SCHEDULE_ACTUAL_MAX = 0x5f;
-/** セグメント1つが受け持つ時間。0:00 から3時間ずつ、1日8つ */
+/** セグメント 1 つが受け持つ時間。0:00 から 3 時間ずつ、1 日 8 つ */
 const SEGMENT_SPAN = 3 * 3600_000;
-/** 1つの table_id が持つセグメントの数 (= 4日ぶん) */
+/** 1 つの table_id が持つセグメントの数 (= 4 日ぶん) */
 const SEGMENTS_PER_TABLE = 32;
 const DESC_SHORT_EVENT = 0x4d;
 const DESC_EXTENDED_EVENT = 0x4e;
@@ -42,7 +42,7 @@ function isEitActual(tableId) {
  * 並びは自局のもの (0x50〜0x5F) と同じで、`OTHER_SHIFT` だけずれている。
  *
  * BS・CS はどの中継にもネットワーク全局ぶんが流れているが、**詳細はほぼ付かない**
- * (実測で BS 45 局のうち2局ぶん。denpa の docs/data.md)。いま/次 (0x4F) は読まない
+ * (実測で BS 45 局のうち 2 局ぶん。denpa の docs/data.md)。いま/次 (0x4F) は読まない
  */
 const SCHEDULE_OTHER_MIN = 0x60;
 const SCHEDULE_OTHER_MAX = 0x6f;
@@ -59,7 +59,7 @@ const TABLE_TOT = 0x73;
 /**
  * TDT / TOT のセクションから**放送の実時刻**を読む。別のテーブルなら null。
  *
- * 頭3バイトのあとに MJD + BCD が5バイト。**TOT も同じ並び**で、後ろに
+ * 頭 3 バイトのあとに MJD + BCD が 5 バイト。**TOT も同じ並び**で、後ろに
  * 時差の記述子が付くだけなので同じに読める。
  *
  * データ放送 (`bml.ts` の `onTime`) が読み、BML の時計にします
@@ -70,9 +70,9 @@ export function parseTimeTable(section) {
     return parseMjdTime(section, 3);
 }
 /**
- * MJD + BCD の5バイトを epoch ms に直す。
+ * MJD + BCD の 5 バイトを epoch ms に直す。
  *
- * 全ビットが1なら「未定」。開始時刻が未定の番組は番組表に置けないので null で返す。
+ * 全ビットが 1 なら「未定」。開始時刻が未定の番組は番組表に置けないので null で返す。
  */
 export function parseMjdTime(data, at) {
     if ([0, 1, 2, 3, 4].every((i) => data[at + i] === 0xff))
@@ -85,7 +85,7 @@ export function parseMjdTime(data, at) {
         JST_OFFSET;
     return seconds * 1000;
 }
-/** BCD 3バイトの尺 (時分秒) を ms に。全ビット1なら「終了未定」 */
+/** BCD 3 バイトの尺 (時分秒) を ms に。全ビット 1 なら「終了未定」 */
 export function parseBcdDuration(data, at) {
     if (data[at] === 0xff && data[at + 1] === 0xff && data[at + 2] === 0xff)
         return null;
@@ -115,7 +115,7 @@ const VIDEO_CODEC = {
     5: "h.264",
     9: "h.265",
 };
-/** audio_component_descriptor の sampling_rate。3ビットの符号 */
+/** audio_component_descriptor の sampling_rate。3 ビットの符号 */
 const SAMPLING_RATE = {
     1: 16000,
     2: 22050,
@@ -137,13 +137,22 @@ const lang = (data, at) => ascii(data, at, 3).toLowerCase();
  * 正しくは「音楽制作:ONE MUSIC」)。分割点は
  *
  * - **二バイト文字の途中**に来ることがある (片割れだけでは字にならない)
- * - **文字集合の状態を持ち越す** — G0〜G3 の指示も GL/GR の呼び出しも、
+ * - **文字集合の状態を持ち越す。** G0〜G3 の指示も GL/GR の呼び出しも、
  *   続きの側には書き直されない。前の状態のまま読む前提で送られてくる
  *
  * ので、部分だけを単独でデコードすると、そこから先が崩れます。
+ *
+ * **ただし見出しのある項目は、同じ見出しでも別の項目として最初の状態から読む。** 見出しが同じ
+ * 項目が 2 つ続けて来る局があり (BS日テレの「番組内容」)、2 つ目は最初の状態 (漢字) から読む前提で
+ * 送られている。1 つ目が英数字に切り替えたまま (`0e 21 3f` = LS1 のあと「!?」) 終わっていると、
+ * バイトのまま繋いだ頃は 2 つ目の漢字が英数字で出ていた (実機の「いずれ「６＇ＭｐＮａ＞ｎ」と８Ｆばれる」。
+ * 正しくは「いずれ「凶乱令嬢」と呼ばれる」)。項目ごとにデコードして、文字で繋ぐ
  */
 function readDescriptors(event, body) {
-    /** 見出しごとの生バイト。**全部揃ってからデコードする** (Map なので見出しの出てきた順に並ぶ) */
+    /**
+     * 見出しごとの項目。項目はバイト列の部分の並びで、**項目の部分が全部揃ってからデコードする**
+     * (Map なので見出しの出てきた順に並ぶ)
+     */
     const pending = new Map();
     let lastHeading = "";
     for (const [tag, data] of descriptors(body)) {
@@ -166,16 +175,19 @@ function readDescriptors(event, body) {
                     const textLength = data[at];
                     const text = data.subarray(at + 1, at + 1 + textLength);
                     at += 1 + textLength;
-                    // 見出しが空なら前の項目の続き。改行を挟まずそのまま繋ぐ
-                    const key = heading === "" ? lastHeading : heading;
-                    if (key === "")
+                    // 見出しが空なら前の項目の続き (バイトのまま繋ぐ)。見出しがあれば、同じ見出しでも新しい項目
+                    if (heading === "") {
+                        if (lastHeading === "")
+                            continue;
+                        pending.get(lastHeading).at(-1).push(text);
                         continue;
-                    const parts = pending.get(key);
-                    if (parts === undefined)
-                        pending.set(key, [text]);
+                    }
+                    const items = pending.get(heading);
+                    if (items === undefined)
+                        pending.set(heading, [[text]]);
                     else
-                        parts.push(text);
-                    lastHeading = key;
+                        items.push([text]);
+                    lastHeading = heading;
                 }
                 break;
             }
@@ -195,7 +207,7 @@ function readDescriptors(event, body) {
                 break;
             }
             /*
-             * audio_component_descriptor (ARIB STD-B10 第2部)。
+             * audio_component_descriptor (ARIB STD-B10 第 2 部)。
              *
              *     [0] reserved(4) stream_content(4)
              *     [1] component_type          … ステレオ・デュアルモノ…
@@ -230,7 +242,7 @@ function readDescriptors(event, body) {
                 break;
             }
             /*
-             * series_descriptor (ARIB STD-B10 第2部)。
+             * series_descriptor (ARIB STD-B10 第 2 部)。
              *
              *     [0..1] series_id
              *     [2]    repeat_label(4) program_pattern(3) expire_date_valid_flag(1)
@@ -257,12 +269,14 @@ function readDescriptors(event, body) {
                 break;
         }
     }
-    // 全部揃ってからデコードする (分割点が二バイト文字や文字集合の途中に来るため)
-    for (const [heading, parts] of pending)
-        event.extended[heading] = decodeAribText(joinBytes(parts));
+    // 項目ごとに、部分が全部揃ってからデコードする (分割点が二バイト文字や文字集合の途中に来るため)
+    for (const [heading, items] of pending)
+        event.extended[heading] = items
+            .map((parts) => decodeAribText(joinBytes(parts)))
+            .join("");
 }
 /**
- * EIT のセクションを1本読む。自局のもの以外は null。
+ * EIT のセクションを 1 本読む。自局のもの以外は null。
  *
  * 壊れたセクションは `SectionAssembler` が CRC で落としているので、ここに来るのは
  * 中身が揃っているものだけ。それでも長さの辻褄が合わないことはあるので、
@@ -335,13 +349,13 @@ export function parseEit(section, options = {}) {
  * 早く揃った局でも待たされ、遅い局は取りこぼす。EIT は自分がどこまであるかを
  * セクションの中で言っているので、それを数えれば足りる。
  *
- * セクションは**8本ずつのセグメント**に分かれていて、セグメントの中で実際に
+ * セクションは**8 本ずつのセグメント**に分かれていて、セグメントの中で実際に
  * 使われている最後の番号が `segment_last_section_number`。使われていない番号は
  * 永久に来ないので、そこまで揃えばそのセグメントは終わり。
  *
- * **過ぎた時間帯のセグメントは流れてこない** (`stale`)。空でも先頭の1本は必ず
+ * **過ぎた時間帯のセグメントは流れてこない** (`stale`)。空でも先頭の 1 本は必ず
  * 来るものとして待っていた頃は、**どのチャンネルも例外なく上限まで
- * 開きっぱなし**になっていた (実機14チャンネル、揃って離せたのは0本)。
+ * 開きっぱなし**になっていた (実機 14 チャンネル、揃って離せたのは 0 本)。
  */
 export class ScheduleProgress {
     now;
@@ -355,11 +369,11 @@ export class ScheduleProgress {
     /**
      * `table_id` → バージョン。変わったらその表だけ数え直す。
      *
-     * **バージョンは `table_id` ごとに別々に振られる。** 番組表の1つの表 (sub_table) は
+     * **バージョンは `table_id` ごとに別々に振られる。** 番組表の 1 つの表 (sub_table) は
      * `table_id` + 局 + TS で決まり、`version_number` はその単位で動く。
-     * 局に1つだけ持っていた頃は、**基本 (0x50〜) と詳細 (0x58〜) を行き来する
+     * 局に 1 つだけ持っていた頃は、**基本 (0x50〜) と詳細 (0x58〜) を行き来する
      * たびにバージョンが違って数えたものを全部捨てて**いた。揃ったと分かることが
-     * 二度と無いので、どのチャンネルも上限の10分 (denpa の `epgChannelTimeout`) まで開きっぱなしになる。
+     * 二度と無いので、どのチャンネルも上限の 10 分 (denpa の `epgChannelTimeout`) まで開きっぱなしになる。
      */
     version = new Map();
     /**
@@ -370,7 +384,7 @@ export class ScheduleProgress {
         this.now = now;
     }
     add(section) {
-        // p/f は番組表の完成度とは関係ない (いつでも2番組しか無い)
+        // p/f は番組表の完成度とは関係ない (いつでも 2 番組しか無い)
         if (section.tableId < SCHEDULE_ACTUAL_MIN)
             return;
         if (section.version !== this.version.get(section.tableId)) {
@@ -392,13 +406,13 @@ export class ScheduleProgress {
     /**
      * 使われている table_id を全部揃えられたか。
      *
-     * **番号が飛ぶ。** 1つの `table_id` が受け持つのは4日ぶんで、基本は
-     * `0x50` から、詳細は `0x58` から始まる。日本の放送は8日ぶんなので、
+     * **番号が飛ぶ。** 1 つの `table_id` が受け持つのは 4 日ぶんで、基本は
+     * `0x50` から、詳細は `0x58` から始まる。日本の放送は 8 日ぶんなので、
      * 実際に流れてくるのは `0x50` `0x51` と `0x58` `0x59` あたりだけで、
      * **`0x52`〜`0x57` は永久に来ません**。
      *
      * `0x50` から `last_table_id` まで全部を待っていた頃は、詳細を積んでいる局が
-     * **一度も「揃った」にならず**、どのチャンネルも上限の10分 (denpa の `epgChannelTimeout`) まで開きっぱなしに
+     * **一度も「揃った」にならず**、どのチャンネルも上限の 10 分 (denpa の `epgChannelTimeout`) まで開きっぱなしに
      * なっていました (実機で、詳細の無い BS11 だけが早く閉じていた)。
      *
      * 見かけた表と、`last_table_id` が指す表だけを見ます。
@@ -438,9 +452,9 @@ export class ScheduleProgress {
     /**
      * そのセグメントの時間帯がもう過ぎているか。**過ぎたものは待たない。**
      *
-     * セグメントは 0:00 から3時間ずつの枠で、`table_id` と節番号から
-     * それがいつの枠なのかが決まる — 基本は `0x50` が当日 0:00 から4日ぶん、
-     * `0x51` がその次の4日ぶん。詳細 (`0x58`〜) も同じ並びをもう一度たどる。
+     * セグメントは 0:00 から 3 時間ずつの枠で、`table_id` と節番号から
+     * それがいつの枠なのかが決まる。基本は `0x50` が当日 0:00 から 4 日ぶん、
+     * `0x51` がその次の 4 日ぶん。詳細 (`0x58`〜) も同じ並びをもう一度たどる。
      * 終わった枠は放送に乗らない (クラスの説明)。そのぶんの番組は、そこが未来だった数日前に取り込んである。
      */
     stale(tableId, start) {
@@ -457,7 +471,7 @@ export class ScheduleProgress {
      * 何が足りないか。**上限まで開いても揃わなかったときに出す。**
      *
      * 揃ったかどうかしか分からなかった頃は、上限まで開きっぱなしになっている局を
-     * 見つけても**その先を追えなかった** — 電波が弱くて欠けているのか、
+     * 見つけても**その先を追えなかった。** 電波が弱くて欠けているのか、
      * こちらが来ない表を待っているのかで、直し方がまるで違う。
      */
     report() {
@@ -482,7 +496,7 @@ export class ScheduleProgress {
 }
 const hex = (value) => `0x${value.toString(16)}`;
 /**
- * 流れてくる TS を食べて番組を溜める。
+ * 流れてくる TS を読んで番組を溜める。
  *
  * 局ごとに `ScheduleProgress` を持ち、**その物理チャンネルに入っている局が
  * 全部揃ったら**読むのをやめられる。同じ番組が何度も来る (カルーセルなので) ので、
@@ -505,7 +519,7 @@ export class EpgReader {
     /**
      * @param now いまの時刻。局ごとの `ScheduleProgress` にそのまま渡す
      * @param options.other ほかの TS の局の番組表も読む。ネットワーク全局ぶんを
-     *   1つの中継から先に入れるときに使う (denpa の `epg-collect.ts` の初回)
+     *   1 つの中継から先に入れるときに使う (denpa の `epg-collect.ts` の初回)
      * @param options.settle `other` のとき、新しい局が出てこなくなってから閉じるまで (ms)
      * @param options.expect `other` のとき、来るはずの局 (service_id)。全部見えて揃えば
      *   `settle` を待たずに閉じる。受信できない局が混ざっていれば `settle` で閉じる
@@ -514,7 +528,7 @@ export class EpgReader {
         this.now = now;
         this.options = options;
     }
-    /** 任意の長さのバイト列を食わせる。番組が1つでも増えたら true */
+    /** 任意の長さのバイト列を渡す。番組が 1 つでも増えたら true */
     feed(chunk) {
         let added = false;
         for (const packet of this.packets.feed(chunk)) {
@@ -547,7 +561,7 @@ export class EpgReader {
     /**
      * 溜めてあるものと混ぜる。**別の表で来るものを消し合わせない。**
      *
-     * 番組表は2つの表に分かれて流れてくる。同じ event_id が両方に載っていて、
+     * 番組表は 2 つの表に分かれて流れてくる。同じ event_id が両方に載っていて、
      * **それぞれ自分のぶんの記述子しか持っていない**。
      *
      * - **基本** (table_id 0x50〜0x57) … タイトルと短い説明 (short_event_descriptor)
@@ -555,7 +569,7 @@ export class EpgReader {
      *
      * あとから来たもので丸ごと置き換えていた頃は、**詳細のほうが後に届いた番組の
      * タイトルが空になっていた**。実機では番組 23,000 件のうち 11,000 件が名無しで、
-     * うち 2,700 件は「タイトルは無いのに番組内容だけある」状態 — 詳細に上書きされた
+     * うち 2,700 件は「タイトルは無いのに番組内容だけある」状態で、詳細に上書きされた
      * 跡そのもの。番組表には「(番組情報なし)」の列が並んでいた。
      *
      * **中身のあるほうを残す。** 書き換え (「[新]」が付く、誤字が直る) は
@@ -589,7 +603,7 @@ export class EpgReader {
      * p/f で「いま流れている」と言えるか。
      *
      * **`running_status` を当てにしきれない。** 4 (放送中) を入れてくる局も
-     * あれば、**0 (未定義) しか入れてこない局もある** — 実機の NHK は 74 節
+     * あれば、**0 (未定義) しか入れてこない局もある。** 実機の NHK は 74 節
      * ぜんぶ 0 だった。4 だけを見ていると、そういう局では延長追従が丸ごと
      * 効かなくなる (denpa の docs/data.md)。
      *
@@ -621,14 +635,14 @@ export class EpgReader {
     all() {
         return [...this.events.values()].sort((a, b) => (a.startAt ?? 0) - (b.startAt ?? 0));
     }
-    /** 番組表を1つでも見かけた局 */
+    /** 番組表を 1 つでも見かけた局 */
     services() {
         return [...this.progress.keys()];
     }
     /**
      * 見かけた局が**全部**揃ったか。
      *
-     * 「1局でも揃えば閉じる」にはしない。1つの物理チャンネルには複数の局が
+     * 「1 局でも揃えば閉じる」にはしない。1 つの物理チャンネルには複数の局が
      * 入っていて (地上波なら MX1 と MX2)、先に揃ったほうで閉じると残りが
      * 永久に埋まらない。
      */
@@ -638,7 +652,7 @@ export class EpgReader {
         /*
          * ほかの TS の局まで読むときは、**来るはずの局が全部見えるか、しばらく新しい局が
          * 出てこないことも待つ。** 局ごとに流れてくる順はばらばらで、見かけた局が
-         * 揃っただけではまだ1度も来ていない局を置いていく。来るはずの局を知っていれば
+         * 揃っただけではまだ 1 度も来ていない局を置いていく。来るはずの局を知っていれば
          * すぐ閉じられる (WebTS.app・Mirakurun と同じ)
          */
         if (this.options.other === true &&
@@ -652,7 +666,7 @@ export class EpgReader {
         }
         return true;
     }
-    /** 来るはずの局を教わっていて、それが全部見えたか */
+    /** 来るはずの局 (`expect`) が渡されていて、それが全部見えたか */
     sawExpected() {
         const expect = this.options.expect ?? [];
         return (expect.length > 0 &&
@@ -661,7 +675,7 @@ export class EpgReader {
     /**
      * 揃っていない局と、その理由。**上限まで開いてしまったときに出す。**
      *
-     * 1局でも揃わなければチャンネルごと上限まで開き続けるので、
+     * 1 局でも揃わなければチャンネルごと上限まで開き続けるので、
      * 「どの局のせいか」が分からないと直しようがない。
      */
     shortfall() {
@@ -674,7 +688,7 @@ export class EpgReader {
     }
 }
 /**
- * **1局の「いま」と「次」(EIT[p/f]) を追う。** ライブで番組の切り替わりを知るのに使う。
+ * **1 局の「いま」と「次」(EIT[p/f]) を追う。** ライブで番組の切り替わりを知るのに使う。
  *
  * 番組表 (schedule) は数日先までの予定で、**延長や繰り下げには追いつかない**
  * (局が送り直してくるのは後になってから)。p/f は放送そのものに追従していて、
@@ -683,7 +697,7 @@ export class EpgReader {
  * section 0 が「いま」、section 1 が「次」と決まっている (`EpgReader.onAir` と同じ)。
  *
  * **中身で比べる。** 書き換われば version が上がるはずだが、上げずに中身だけ替える
- * 送り手を当てにしないよう、番組の番号・時刻・尺・タイトルで比べる。p/f は1局ぶん数百バイトが
+ * 送り手を当てにしないよう、番組の番号・時刻・尺・タイトルで比べる。p/f は 1 局ぶん数百バイトが
  * 数秒おきに来るだけなので、毎回読んでも軽い
  */
 export class PresentFollowing {
@@ -706,7 +720,7 @@ export class PresentFollowing {
         return this.held[1];
     }
     /**
-     * 188 バイトのパケットを1つ。**いまか次のどちらかが変わったら true**。
+     * 188 バイトのパケットを 1 つ。**いまか次のどちらかが変わったら true**。
      * 最初に読めたときも true (知らなかったものが分かった)
      */
     feedPacket(packet) {
@@ -732,7 +746,7 @@ export class PresentFollowing {
         return changed;
     }
 }
-/** 変わったかどうかを見る中身。**番号・時刻・尺・タイトルだけ** — 番組表に写して画面に出るもの */
+/** 変わったかどうかを見る中身。**番号・時刻・尺・タイトルだけ** (番組表に写して画面に出るもの) */
 function markOf(event) {
     return `${event.eventId}:${event.startAt}:${event.duration}:${event.name}`;
 }

package/dist/language.d.ts

@@ -1,7 +1,7 @@
 /**
  * ISO 639-2 のうち日本の放送で出てくるもの。
  *
- * **音声も字幕も同じ表を使う** — 字幕と音声で別に持っていた頃は
- * 4つ足りず、同じ放送の音声が「イタリア語」、字幕が「ita」と出る形になっていた
+ * **音声も字幕も同じ表を使う。** 字幕と音声で別に持っていた頃は
+ * 4 つ足りず、同じ放送の音声が「イタリア語」、字幕が「ita」と出る形になっていた
  */
 export declare const LANGUAGE: Record<string, string>;

package/dist/language.js

@@ -1,8 +1,8 @@
 /**
  * ISO 639-2 のうち日本の放送で出てくるもの。
  *
- * **音声も字幕も同じ表を使う** — 字幕と音声で別に持っていた頃は
- * 4つ足りず、同じ放送の音声が「イタリア語」、字幕が「ita」と出る形になっていた
+ * **音声も字幕も同じ表を使う。** 字幕と音声で別に持っていた頃は
+ * 4 つ足りず、同じ放送の音声が「イタリア語」、字幕が「ita」と出る形になっていた
  */
 export const LANGUAGE = {
     jpn: "日本語",

package/dist/multipart.d.ts

@@ -1,5 +1,5 @@
 /**
- * モジュールの中身を読む。**ヘッダ + 空行 + 本体** の形式 (STD-B24 第二編 第9章) で、
+ * モジュールの中身を読む。**ヘッダ + 空行 + 本体** の形式 (STD-B24 第二編 第 9 章) で、
  * 多くは `multipart/mixed` に BML と画像がまとめて入っている。
  *
  *     Content-Type: multipart/mixed; boundary=XXX
@@ -21,7 +21,7 @@ export interface EntityHeader {
     name: string;
     value: string;
 }
-/** 読んだ中身。`multipart/mixed` なら `parts` に1つずつ入る */
+/** 読んだ中身。`multipart/mixed` なら `parts` に 1 つずつ入る */
 export interface Entity {
     headers: EntityHeader[];
     body: Uint8Array;
@@ -30,12 +30,12 @@ export interface Entity {
 /**
  * `type/subtype; a=b; c="d"` を読む。名前は小文字にそろえ、元の綴りも残す。
  *
- * **引数の途中で崩れていても、読めたところまでは返す** — 型と下位型が分かれば
+ * **引数の途中で崩れていても、読めたところまでは返す。** 型と下位型が分かれば
  * 読み方は決まる。型すら読めなければ null
  */
 export declare function parseMediaType(text: string): MediaType | null;
 /**
- * 中身を1つ読む。**ヘッダの終わり (空行) が無いものは null** — どこからが本体か
+ * 中身を 1 つ読む。**ヘッダの終わり (空行) が無いものは null。** どこからが本体か
  * 分からない。`multipart/mixed` なら中までデコードする (入れ子も同じ形式)。
  *
  * @param part multipart の中の部品か。部品はヘッダの行でちょうど終わってよい (下の説明)

package/dist/multipart.js

@@ -1,5 +1,5 @@
 /**
- * モジュールの中身を読む。**ヘッダ + 空行 + 本体** の形式 (STD-B24 第二編 第9章) で、
+ * モジュールの中身を読む。**ヘッダ + 空行 + 本体** の形式 (STD-B24 第二編 第 9 章) で、
  * 多くは `multipart/mixed` に BML と画像がまとめて入っている。
  *
  *     Content-Type: multipart/mixed; boundary=XXX
@@ -29,7 +29,7 @@ function isTokenChar(char) {
 /**
  * `type/subtype; a=b; c="d"` を読む。名前は小文字にそろえ、元の綴りも残す。
  *
- * **引数の途中で崩れていても、読めたところまでは返す** — 型と下位型が分かれば
+ * **引数の途中で崩れていても、読めたところまでは返す。** 型と下位型が分かれば
  * 読み方は決まる。型すら読めなければ null
  */
 export function parseMediaType(text) {
@@ -112,7 +112,7 @@ function find(haystack, needle, from) {
     return -1;
 }
 /**
- * 中身を1つ読む。**ヘッダの終わり (空行) が無いものは null** — どこからが本体か
+ * 中身を 1 つ読む。**ヘッダの終わり (空行) が無いものは null。** どこからが本体か
  * 分からない。`multipart/mixed` なら中までデコードする (入れ子も同じ形式)。
  *
  * @param part multipart の中の部品か。部品はヘッダの行でちょうど終わってよい (下の説明)
@@ -160,8 +160,8 @@ export function readEntity(data, part = false) {
     return { headers, body, parts };
 }
 /**
- * 区切りで切る。**閉じの区切り (`--XXX--`) まで揃っていないものは捨てる** —
- * 最後の1つがどこで終わるか分からない
+ * 区切りで切る。**閉じの区切り (`--XXX--`) まで揃っていないものは捨てる。**
+ * 最後の 1 つがどこで終わるか分からない
  */
 function splitParts(body, boundary) {
     const open = encoder.encode(`--${boundary}\r\n`);
@@ -176,7 +176,7 @@ function splitParts(body, boundary) {
         if (end === -1)
             return null;
         const after = end + next.length;
-        // `--` が続けば閉じ、CRLF なら次の1つ。どちらでもなければ本体の中の似た並び
+        // `--` が続けば閉じ、CRLF なら次の 1 つ。どちらでもなければ本体の中の似た並び
         const close = body[after] === 0x2d && body[after + 1] === 0x2d;
         if (!close && (body[after] !== CR || body[after + 1] !== LF)) {
             from = end + 1;

package/dist/pes.d.ts

@@ -1,16 +1,16 @@
 /**
- * **1局に絞った TS から、映像と音声の PES を取り出す** (denpa のライブを変換せずに送る経路。docs/stream.md#放送そのままmpeg-2を送る)。
+ * **1 局に絞った TS から、映像と音声の PES を取り出す** (denpa のライブを変換せずに送る経路。docs/stream.md#放送そのまま mpeg-2 を送る)。
  *
  * エンコードする経路ではここを ffmpeg がやっていた。変換せずに送ると TS がそのままブラウザへ来るので、
  * 映像も音声も WASM のデコーダ (denpa の `wasm/decoder.c`) に渡す前に、
- * こちらで PES に戻す。サーバが1局に絞ってある (`ServiceFilter`) ので、PAT に
- * 載っている局は1つだけ — その PMT を読んで、映像1本と音声 (並んだ順) を取り出す。
+ * こちらで PES に戻す。サーバが 1 局に絞ってある (`ServiceFilter`) ので、PAT に
+ * 載っている局は 1 つだけなので、その PMT を読んで、映像 1 本と音声 (並んだ順) を取り出す。
  *
  * DOM も WASM も触らないので、ここだけ単体で確かめられる (`pes.test.ts`)。
  */
 /** PTS・PCR の刻み (90kHz)。denpa の取り決めの時刻もこの刻み (docs/stream.md#websocket-プロトコル) */
 export declare const CLOCK = 90000;
-/** PTS の一周 (33ビット)。26.5 時間 */
+/** PTS の一周 (33 ビット)。26.5 時間 */
 export declare const WRAP: number;
 export interface Pes {
     pid: number;
@@ -22,12 +22,12 @@ export interface Pes {
     /** PES の中身 (ES) */
     data: Uint8Array;
 }
-/** PMT から分かったこと。**音声は並んだ順** — 画面の「何本目の音声」(`AudioTrack.stream`) と揃う */
+/** PMT から分かったこと。**音声は並んだ順** (画面の「何本目の音声」`AudioTrack.stream` と揃う) */
 export interface Streams {
     video: number | null;
     audio: number[];
 }
-/** 5バイトの PTS / DTS を読む (ISO/IEC 13818-1 2.4.3.7) */
+/** 5 バイトの PTS / DTS を読む (ISO/IEC 13818-1 2.4.3.7) */
 export declare function readStamp(data: Uint8Array, at: number): number;
 /** PES の頭を読んで中身を切り出す。**壊れていれば null** (頭の 00 00 01 が無いなど) */
 export declare function parsePes(data: Uint8Array): {
@@ -36,19 +36,19 @@ export declare function parsePes(data: Uint8Array): {
     data: Uint8Array;
 } | null;
 /**
- * TS を食わせて PES を吐く。**選局し直したら作り直す** (前の局の切れ端を持ち越さない)。
+ * TS を渡すと PES を返す。**選局し直したら作り直す** (前の局の切れ端を持ち越さない)。
  *
- * 映像は長さ 0 (次の頭で終わりが分かる) なので1枚ぶん遅れて出るが、貯めの中に収まる。
+ * 映像は長さ 0 (次の頭で終わりが分かる) なので 1 枚ぶん遅れて出るが、貯めの中に収まる。
  * 音声は長さが書いてあるので揃った時点で出す
  */
 export declare class PesDemuxer {
     private readonly packets;
-    /** 絞ってあるので局は1つだけのはず。万一複数あっても先頭を採る */
+    /** 絞ってあるので局は 1 つだけのはず。万一複数あっても先頭を採る */
     private readonly pmt;
     private readonly partial;
     /** いま分かっている ES。**変わったら `feed` の返りで知らせる** */
     streams: Streams;
-    /** デコードする音声の PID。**選ばれた1本だけ**組み立てる (他は捨てる) */
+    /** デコードする音声の PID。**選ばれた 1 本だけ**組み立てる (他は捨てる) */
     audioPid: number | null;
     /** 何本目の音声を取り出すか (`AudioTrack.stream`)。無ければ先頭に落とす */
     audioIndex: number;
@@ -71,13 +71,13 @@ export interface AdtsFrame {
     pts: number;
     sampleRate: number;
     channels: number;
-    /** このコマの長さ (90kHz)。AAC は1コマ 1024 標本 */
+    /** このコマの長さ (90kHz)。AAC は 1 コマ 1024 標本 */
     duration: number;
 }
 /**
  * PES の中身を ADTS のコマに割る。**コマは PES をまたぐことがある**ので、余りは持ち越す。
  *
- * 時刻は PES の PTS を頭のコマに付け、続くコマには1コマぶんずつ足す。持ち越した
+ * 時刻は PES の PTS を頭のコマに付け、続くコマには 1 コマぶんずつ足す。持ち越した
  * 余りから始まるコマは、前の続きの時刻になる
  */
 export declare class AdtsSplitter {
@@ -87,7 +87,7 @@ export declare class AdtsSplitter {
     reset(): void;
 }
 /**
- * **33ビットで一周する時刻を、手元の物差しの近くへ伸ばす。**
+ * **33 ビットで一周する時刻を、手元の物差しの近くへ伸ばす。**
  *
  * PTS は 26.5 時間で 0 に戻る。受け側は「いま鳴らしている時刻」を一周をまたいでも
  * 増え続ける数で持つので、届いた時刻は**それにいちばん近い周**に置き直して比べる

package/dist/pes.js

@@ -1,10 +1,10 @@
 /**
- * **1局に絞った TS から、映像と音声の PES を取り出す** (denpa のライブを変換せずに送る経路。docs/stream.md#放送そのままmpeg-2を送る)。
+ * **1 局に絞った TS から、映像と音声の PES を取り出す** (denpa のライブを変換せずに送る経路。docs/stream.md#放送そのまま mpeg-2 を送る)。
  *
  * エンコードする経路ではここを ffmpeg がやっていた。変換せずに送ると TS がそのままブラウザへ来るので、
  * 映像も音声も WASM のデコーダ (denpa の `wasm/decoder.c`) に渡す前に、
- * こちらで PES に戻す。サーバが1局に絞ってある (`ServiceFilter`) ので、PAT に
- * 載っている局は1つだけ — その PMT を読んで、映像1本と音声 (並んだ順) を取り出す。
+ * こちらで PES に戻す。サーバが 1 局に絞ってある (`ServiceFilter`) ので、PAT に
+ * 載っている局は 1 つだけなので、その PMT を読んで、映像 1 本と音声 (並んだ順) を取り出す。
  *
  * DOM も WASM も触らないので、ここだけ単体で確かめられる (`pes.test.ts`)。
  */
@@ -12,12 +12,12 @@ import { concatBytes, u16 } from "./bytes.js";
 import { PACKET, packetPid, PacketStream, PID_PAT, pmtStreams, PmtTracker, } from "./psi.js";
 /** PTS・PCR の刻み (90kHz)。denpa の取り決めの時刻もこの刻み (docs/stream.md#websocket-プロトコル) */
 export const CLOCK = 90_000;
-/** PTS の一周 (33ビット)。26.5 時間 */
+/** PTS の一周 (33 ビット)。26.5 時間 */
 export const WRAP = 2 ** 33;
 /** PMT の stream_type。**放送の映像は MPEG-2、音声は ADTS の AAC** (ARIB STD-B32) */
 const STREAM_MPEG2 = 0x02;
 const STREAM_AAC = 0x0f;
-/** 5バイトの PTS / DTS を読む (ISO/IEC 13818-1 2.4.3.7) */
+/** 5 バイトの PTS / DTS を読む (ISO/IEC 13818-1 2.4.3.7) */
 export function readStamp(data, at) {
     return (((data[at] >> 1) & 0x07) * 2 ** 30 +
         (data[at + 1] << 22) +
@@ -44,19 +44,19 @@ export function parsePes(data) {
 /** 長さの分からない PES (映像) の入れ物の最初の大きさ。1 コマの多くはこれに収まる */
 const PES_START = 64 * 1024;
 /**
- * TS を食わせて PES を吐く。**選局し直したら作り直す** (前の局の切れ端を持ち越さない)。
+ * TS を渡すと PES を返す。**選局し直したら作り直す** (前の局の切れ端を持ち越さない)。
  *
- * 映像は長さ 0 (次の頭で終わりが分かる) なので1枚ぶん遅れて出るが、貯めの中に収まる。
+ * 映像は長さ 0 (次の頭で終わりが分かる) なので 1 枚ぶん遅れて出るが、貯めの中に収まる。
  * 音声は長さが書いてあるので揃った時点で出す
  */
 export class PesDemuxer {
     packets = new PacketStream();
-    /** 絞ってあるので局は1つだけのはず。万一複数あっても先頭を採る */
+    /** 絞ってあるので局は 1 つだけのはず。万一複数あっても先頭を採る */
     pmt = new PmtTracker();
     partial = new Map();
     /** いま分かっている ES。**変わったら `feed` の返りで知らせる** */
     streams = { video: null, audio: [] };
-    /** デコードする音声の PID。**選ばれた1本だけ**組み立てる (他は捨てる) */
+    /** デコードする音声の PID。**選ばれた 1 本だけ**組み立てる (他は捨てる) */
     audioPid = null;
     /** 何本目の音声を取り出すか (`AudioTrack.stream`)。無ければ先頭に落とす */
     audioIndex = 0;
@@ -173,7 +173,7 @@ export const ADTS_RATES = [
 /**
  * PES の中身を ADTS のコマに割る。**コマは PES をまたぐことがある**ので、余りは持ち越す。
  *
- * 時刻は PES の PTS を頭のコマに付け、続くコマには1コマぶんずつ足す。持ち越した
+ * 時刻は PES の PTS を頭のコマに付け、続くコマには 1 コマぶんずつ足す。持ち越した
  * 余りから始まるコマは、前の続きの時刻になる
  */
 export class AdtsSplitter {
@@ -208,7 +208,7 @@ export class AdtsSplitter {
                     data: buffer.slice(at, at + length),
                     pts: this.next,
                     sampleRate: rate,
-                    // 0 は「中身に書いてある」(PCE)。放送のデュアルモノはここに来るので、2本とみなす
+                    // 0 は「中身に書いてある」(PCE)。放送のデュアルモノはここに来るので、2 本とみなす
                     channels: channels === 0 ? 2 : channels,
                     duration,
                 });
@@ -230,7 +230,7 @@ export class AdtsSplitter {
     }
 }
 /**
- * **33ビットで一周する時刻を、手元の物差しの近くへ伸ばす。**
+ * **33 ビットで一周する時刻を、手元の物差しの近くへ伸ばす。**
  *
  * PTS は 26.5 時間で 0 に戻る。受け側は「いま鳴らしている時刻」を一周をまたいでも
  * 増え続ける数で持つので、届いた時刻は**それにいちばん近い周**に置き直して比べる