@danything/arib 1.2.0 → 1.2.2

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 に戻る。受け側は「いま鳴らしている時刻」を一周をまたいでも
  * 増え続ける数で持つので、届いた時刻は**それにいちばん近い周**に置き直して比べる

package/dist/psi.d.ts

@@ -1,11 +1,11 @@
 /**
  * TS の土台 (パケットの切り出し・セクションの組み立て・PAT/PMT) と、局の一覧。
  * 局の一覧はチャンネルスキャンで「この物理チャンネルに何が入っているか」を知るために使い、
- * 読むのは NIT と SDT の2つ。
+ * 読むのは NIT と SDT の 2 つ。
  *
- * - NIT (PID 0x0010) … ネットワークID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
+ * - NIT (PID 0x0010) … ネットワーク ID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
  *   (TSID・周波数・サービスの一覧) が載っている (`NitReader`)
- * - SDT (PID 0x0011) … その TS に入っているサービスのIDと種別。衛星はほかの TS のぶん
+ * - SDT (PID 0x0011) … その TS に入っているサービスの ID と種別。衛星はほかの TS のぶん
  *   (SDT[other]) も流れている (`SdtReader`)
  *
  * 局名も SDT から読む。ARIB の文字符号は独自だが、番組表を自分で集めるなら
@@ -34,9 +34,9 @@ export declare const SERVICE_TYPES: Set<number>;
 /**
  * セクション本体に CRC32 を付けて仕上げる。`section_length` も実長に直す。
  *
- * **書く側が2つある。** PAT を書き直して流す `service-filter.ts` と、
+ * **書く側が 2 つある。** PAT を書き直して流す `service-filter.ts` と、
  * 偽の放送を組み立てる `synth.ts`。長さの直し方を間違えると読む側が黙って
- * 捨てるだけなので、1箇所に置く。
+ * 捨てるだけなので、1 箇所に置く。
  */
 export declare function withCrc(body: number[]): Uint8Array;
 export interface Service {
@@ -60,26 +60,26 @@ export interface NetworkInfo {
  *
  * セクションは TS パケットをまたいで運ばれ、パケットの切れ目とは無関係な
  * 位置で終わる。payload_unit_start_indicator と pointer_field を見て
- * 頭を合わせ、section_length ぶん溜まったら1本として吐く。
+ * 頭を合わせ、section_length ぶん溜まったら 1 本として返す。
  */
 export declare class SectionAssembler {
     private readonly pid;
     private readonly crc;
     private buffer;
     /**
-     * @param pid 読むPID
+     * @param pid 読む PID
      * @param crc CRC の見方。
-     *   `always` … 末尾4バイトを CRC32 とみなして必ず確かめる (PSI はこちら)
+     *   `always` … 末尾 4 バイトを CRC32 とみなして必ず確かめる (PSI はこちら)
      *   `syntax` … `section_syntax_indicator` が立っているときだけ確かめる。
      *     DSM-CC は立っていないと末尾が CRC ではなく Checksum なので、
      *     いつも確かめると**全部捨ててしまう**
      */
     constructor(pid: number, crc?: "always" | "syntax");
     /**
-     * パケットを1つ食わせる。組み上がったセクションを返す。
+     * パケットを 1 つ渡す。組み上がったセクションを返す。
      *
      * 返りは**読むだけ**にすること。何も組み上がらないとき (ほとんどのパケット) は
-     * 使い回しの空配列を返す — 関係ないパケットのたびに配列を作っていた
+     * 使い回しの空配列を返す (関係ないパケットのたびに配列を作っていた)
      */
     feed(packet: Uint8Array): readonly Uint8Array[];
     private append;
@@ -91,7 +91,7 @@ export declare function findSync(data: Uint8Array, from?: number, until?: number
  * 任意の長さで届くバイト列を 188 バイトのパケットに切り分ける。
  *
  * 頭が必ずパケットの先頭とは限らず、電波が弱いと途中で数バイト落ちる。
- * ずれたままだと**以降ずっと1パケットも読めなくなる**ので、頭が 0x47 でなければ
+ * ずれたままだと**以降ずっと 1 パケットも読めなくなる**ので、頭が 0x47 でなければ
  * 取り直す。普段は先頭が 0x47 なので、探しに行くのはずれたときだけ。
  *
  * **出すパケットは渡された塊の上の窓** (写しではない。写すと録画の処理の 1/3 を食う)。
@@ -104,8 +104,8 @@ export declare class PacketStream {
     feed(chunk: Uint8Array): Generator<Uint8Array>;
 }
 /**
- * PAT から1つの局の PMT を追う。`serviceId` を渡さなければ PAT の最初の局
- * (1局に絞った TS を食わせるところ)。PAT で PMT の PID が替われば組み立て直す
+ * PAT から 1 つの局の PMT を追う。`serviceId` を渡さなければ PAT の最初の局
+ * (1 局に絞った TS を渡すところ)。PAT で PMT の PID が替われば組み立て直す
  */
 export declare class PmtTracker {
     private readonly serviceId?;
@@ -114,7 +114,7 @@ export declare class PmtTracker {
     /** 追っている PMT の PID。PAT を読むまでは null。替わったかは呼ぶ前後で比べる */
     pid: number | null;
     constructor(serviceId?: number | undefined);
-    /** パケットを1つ (`pid` はその PID)。組み上がった PMT のセクションを返す */
+    /** パケットを 1 つ (`pid` はその PID)。組み上がった PMT のセクションを返す */
     feed(packet: Uint8Array, pid: number): readonly Uint8Array[];
 }
 /** 記述子の並びを (tag, 中身) に切り分ける */
@@ -124,8 +124,8 @@ export declare const DESC_DIGITAL_COPY_CONTROL = 193;
 /**
  * デジタルコピー制御記述子の中身 (タグと長さを除いたもの) から、**コピー禁止か**を読む。
  *
- * 先頭2ビットの digital_recording_control_data が 11 なら禁止
- * (00 コピー可、01 事業者定義、10 1世代のみ)。禁止の番組は録らない
+ * 先頭 2 ビットの digital_recording_control_data が 11 なら禁止
+ * (00 コピー可、01 事業者定義、10 1 世代のみ)。禁止の番組は録らない
  * ([data.md](https://github.com/danything/denpa/blob/main/docs/data.md)「コピー禁止の番組は録らない」)
  */
 export declare function isCopyNever(data: Uint8Array): boolean;
@@ -142,13 +142,13 @@ export declare function pmtProgramInfo(section: Uint8Array): Uint8Array;
  * だけ**にして、選り分けは呼ぶ側に置いてあります。
  */
 export declare function pmtStreams(section: Uint8Array): Generator<[number, number, Uint8Array]>;
-/** PAT から `サービスID → PMT の PID`。サービス0 は NIT なので飛ばす */
+/** PAT から `サービスID → PMT の PID`。サービス 0 は NIT なので飛ばす */
 export declare function parsePat(section: Uint8Array): Map<number, number>;
 /**
  * SDT のサービスの並びを (service_id, 記述子の並び) に切り分ける。
  *
- * **読む側が2つある。** 局名 (`parseSdt`) とロゴの対応 (denpa の `ts/logo.ts`) で、
- * 欲しい記述子が違うだけで歩き方は同じ。並びの読み方をここ1箇所に置く。
+ * **読む側が 2 つある。** 局名 (`parseSdt`) とロゴの対応 (denpa の `ts/logo.ts`) で、
+ * 欲しい記述子が違うだけで歩き方は同じ。並びの読み方をここ 1 箇所に置く。
  */
 export declare function sdtServices(section: Uint8Array): Generator<[number, Uint8Array]>;
 /** SDT からサービスの一覧を読む。自分の TS のものだけ */
@@ -212,7 +212,7 @@ export interface NitSection {
 /** NIT のセクションを 1 つ読む。actual (0x40) と other (0x41) のどちらも */
 export declare function parseNitSection(section: Uint8Array): NitSection | null;
 /**
- * NIT からネットワークIDとリモコン番号、他の TS の顔ぶれを読む。**セクション 1 つぶん。**
+ * NIT からネットワーク ID とリモコン番号、他の TS の顔ぶれを読む。**セクション 1 つぶん。**
  * スキャンで「どのネットワークか」を知るにはこれで足りる。ネットワークの全部の TS が要るなら `NitReader`
  */
 export declare function parseNit(section: Uint8Array): NetworkInfo | null;
@@ -287,7 +287,7 @@ export interface FoundService extends Service {
     remoteControlKeyId: number | null;
 }
 /**
- * 流れてくる TS を食べて、NIT と SDT が揃うまで待つ。
+ * 流れてくる TS を読んで、NIT と SDT が揃うまで待つ。
  *
  * Mirakurun のスキャンと同じで、**両方**揃って初めてそのチャンネルを
  * 「受信できた」とみなす。SDT だけ取れても、どのネットワークのものか
@@ -300,7 +300,7 @@ export declare class ServiceReader {
     network: NetworkInfo | null;
     transport: TransportInfo | null;
     get complete(): boolean;
-    /** 任意の長さのバイト列を食わせる。揃ったら true */
+    /** 任意の長さのバイト列を渡す。揃ったら true */
     feed(chunk: Uint8Array): boolean;
     /** 録るに値するサービスだけ。リモコン番号は NIT のものを配る */
     services(): FoundService[];

package/dist/psi.js

@@ -1,11 +1,11 @@
 /**
  * TS の土台 (パケットの切り出し・セクションの組み立て・PAT/PMT) と、局の一覧。
  * 局の一覧はチャンネルスキャンで「この物理チャンネルに何が入っているか」を知るために使い、
- * 読むのは NIT と SDT の2つ。
+ * 読むのは NIT と SDT の 2 つ。
  *
- * - NIT (PID 0x0010) … ネットワークID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
+ * - NIT (PID 0x0010) … ネットワーク ID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
  *   (TSID・周波数・サービスの一覧) が載っている (`NitReader`)
- * - SDT (PID 0x0011) … その TS に入っているサービスのIDと種別。衛星はほかの TS のぶん
+ * - SDT (PID 0x0011) … その TS に入っているサービスの ID と種別。衛星はほかの TS のぶん
  *   (SDT[other]) も流れている (`SdtReader`)
  *
  * 局名も SDT から読む。ARIB の文字符号は独自だが、番組表を自分で集めるなら
@@ -54,7 +54,7 @@ const CRC32_TABLE = (() => {
     }
     return table;
 })();
-/** MPEG-2 の CRC32。セクション末尾の4バイトを含めて回すと 0 になる */
+/** MPEG-2 の CRC32。セクション末尾の 4 バイトを含めて回すと 0 になる */
 function crc32(data) {
     let crc = 0xffffffff;
     for (const byte of data) {
@@ -66,9 +66,9 @@ function crc32(data) {
 /**
  * セクション本体に CRC32 を付けて仕上げる。`section_length` も実長に直す。
  *
- * **書く側が2つある。** PAT を書き直して流す `service-filter.ts` と、
+ * **書く側が 2 つある。** PAT を書き直して流す `service-filter.ts` と、
  * 偽の放送を組み立てる `synth.ts`。長さの直し方を間違えると読む側が黙って
- * 捨てるだけなので、1箇所に置く。
+ * 捨てるだけなので、1 箇所に置く。
  */
 export function withCrc(body) {
     const section = Uint8Array.from(body);
@@ -87,16 +87,16 @@ const NONE = Object.freeze([]);
  *
  * セクションは TS パケットをまたいで運ばれ、パケットの切れ目とは無関係な
  * 位置で終わる。payload_unit_start_indicator と pointer_field を見て
- * 頭を合わせ、section_length ぶん溜まったら1本として吐く。
+ * 頭を合わせ、section_length ぶん溜まったら 1 本として返す。
  */
 export class SectionAssembler {
     pid;
     crc;
     buffer = new Uint8Array(0);
     /**
-     * @param pid 読むPID
+     * @param pid 読む PID
      * @param crc CRC の見方。
-     *   `always` … 末尾4バイトを CRC32 とみなして必ず確かめる (PSI はこちら)
+     *   `always` … 末尾 4 バイトを CRC32 とみなして必ず確かめる (PSI はこちら)
      *   `syntax` … `section_syntax_indicator` が立っているときだけ確かめる。
      *     DSM-CC は立っていないと末尾が CRC ではなく Checksum なので、
      *     いつも確かめると**全部捨ててしまう**
@@ -106,10 +106,10 @@ export class SectionAssembler {
         this.crc = crc;
     }
     /**
-     * パケットを1つ食わせる。組み上がったセクションを返す。
+     * パケットを 1 つ渡す。組み上がったセクションを返す。
      *
      * 返りは**読むだけ**にすること。何も組み上がらないとき (ほとんどのパケット) は
-     * 使い回しの空配列を返す — 関係ないパケットのたびに配列を作っていた
+     * 使い回しの空配列を返す (関係ないパケットのたびに配列を作っていた)
      */
     feed(packet) {
         // トランスポートエラーが立っているものは信用しない
@@ -173,7 +173,7 @@ export class SectionAssembler {
 }
 /**
  * 同期が取れているとみなすのに必要な連続パケット数。
- * 1つだけでは中身のたまたまの 0x47 を頭と誤認する
+ * 1 つだけでは中身のたまたまの 0x47 を頭と誤認する
  */
 const CONFIRM = 3;
 /** `from` 以降 `until` の手前までで、188 間隔に 0x47 が続くところを探す。無ければ -1 (denpa の `seek.ts` も使う) */
@@ -191,7 +191,7 @@ export function findSync(data, from = 0, until = data.length) {
  * 任意の長さで届くバイト列を 188 バイトのパケットに切り分ける。
  *
  * 頭が必ずパケットの先頭とは限らず、電波が弱いと途中で数バイト落ちる。
- * ずれたままだと**以降ずっと1パケットも読めなくなる**ので、頭が 0x47 でなければ
+ * ずれたままだと**以降ずっと 1 パケットも読めなくなる**ので、頭が 0x47 でなければ
  * 取り直す。普段は先頭が 0x47 なので、探しに行くのはずれたときだけ。
  *
  * **出すパケットは渡された塊の上の窓** (写しではない。写すと録画の処理の 1/3 を食う)。
@@ -205,7 +205,7 @@ export class PacketStream {
         /*
          * 前の残り (`rest`) と塊を繋いだ並びの上を歩く。位置 `at` はその並びでの位置。
          * 繋ぐのは**残りに頭があるパケットを読むのに要るぶんだけ** (頭を探すのに
-         * 3パケットぶん先まで見る)
+         * 3 パケットぶん先まで見る)
          */
         const split = this.rest.length;
         const total = split + chunk.length;
@@ -267,8 +267,8 @@ export class PacketStream {
     }
 }
 /**
- * PAT から1つの局の PMT を追う。`serviceId` を渡さなければ PAT の最初の局
- * (1局に絞った TS を食わせるところ)。PAT で PMT の PID が替われば組み立て直す
+ * PAT から 1 つの局の PMT を追う。`serviceId` を渡さなければ PAT の最初の局
+ * (1 局に絞った TS を渡すところ)。PAT で PMT の PID が替われば組み立て直す
  */
 export class PmtTracker {
     serviceId;
@@ -279,7 +279,7 @@ export class PmtTracker {
     constructor(serviceId) {
         this.serviceId = serviceId;
     }
-    /** パケットを1つ (`pid` はその PID)。組み上がった PMT のセクションを返す */
+    /** パケットを 1 つ (`pid` はその PID)。組み上がった PMT のセクションを返す */
     feed(packet, pid) {
         if (pid === PID_PAT) {
             for (const section of this.pat.feed(packet)) {
@@ -314,8 +314,8 @@ export const DESC_DIGITAL_COPY_CONTROL = 0xc1;
 /**
  * デジタルコピー制御記述子の中身 (タグと長さを除いたもの) から、**コピー禁止か**を読む。
  *
- * 先頭2ビットの digital_recording_control_data が 11 なら禁止
- * (00 コピー可、01 事業者定義、10 1世代のみ)。禁止の番組は録らない
+ * 先頭 2 ビットの digital_recording_control_data が 11 なら禁止
+ * (00 コピー可、01 事業者定義、10 1 世代のみ)。禁止の番組は録らない
  * ([data.md](https://github.com/danything/denpa/blob/main/docs/data.md)「コピー禁止の番組は録らない」)
  */
 export function isCopyNever(data) {
@@ -351,7 +351,7 @@ export function* pmtStreams(section) {
         at += 5 + infoLength;
     }
 }
-/** PAT から `サービスID → PMT の PID`。サービス0 は NIT なので飛ばす */
+/** PAT から `サービスID → PMT の PID`。サービス 0 は NIT なので飛ばす */
 export function parsePat(section) {
     const programs = new Map();
     if (section[0] !== TABLE_PAT)
@@ -368,8 +368,8 @@ export function parsePat(section) {
 /**
  * SDT のサービスの並びを (service_id, 記述子の並び) に切り分ける。
  *
- * **読む側が2つある。** 局名 (`parseSdt`) とロゴの対応 (denpa の `ts/logo.ts`) で、
- * 欲しい記述子が違うだけで歩き方は同じ。並びの読み方をここ1箇所に置く。
+ * **読む側が 2 つある。** 局名 (`parseSdt`) とロゴの対応 (denpa の `ts/logo.ts`) で、
+ * 欲しい記述子が違うだけで歩き方は同じ。並びの読み方をここ 1 箇所に置く。
  */
 export function* sdtServices(section) {
     let at = 11;
@@ -531,7 +531,7 @@ export function parseNitSection(section) {
     };
 }
 /**
- * NIT からネットワークIDとリモコン番号、他の TS の顔ぶれを読む。**セクション 1 つぶん。**
+ * NIT からネットワーク ID とリモコン番号、他の TS の顔ぶれを読む。**セクション 1 つぶん。**
  * スキャンで「どのネットワークか」を知るにはこれで足りる。ネットワークの全部の TS が要るなら `NitReader`
  */
 export function parseNit(section) {
@@ -720,7 +720,7 @@ export class SdtReader {
     }
 }
 /**
- * 流れてくる TS を食べて、NIT と SDT が揃うまで待つ。
+ * 流れてくる TS を読んで、NIT と SDT が揃うまで待つ。
  *
  * Mirakurun のスキャンと同じで、**両方**揃って初めてそのチャンネルを
  * 「受信できた」とみなす。SDT だけ取れても、どのネットワークのものか
@@ -735,7 +735,7 @@ export class ServiceReader {
     get complete() {
         return this.network !== null && this.transport !== null;
     }
-    /** 任意の長さのバイト列を食わせる。揃ったら true */
+    /** 任意の長さのバイト列を渡す。揃ったら true */
     feed(chunk) {
         for (const packet of this.packets.feed(chunk)) {
             if (this.network === null) {

package/dist/service-filter.d.ts

@@ -1,16 +1,16 @@
 /**
- * 物理チャンネル丸ごとの TS から、1つの局のぶんだけを抜き出す。
+ * 物理チャンネル丸ごとの TS から、1 つの局のぶんだけを抜き出す。
  *
  * エージェントは**中身を読まずに素の TS を流す**ので
  * ([agent.md](https://github.com/danything/denpa/blob/main/docs/agent.md))、選り分けるのは denpa の仕事。
  *
- * **これをやらないと1つの録画に複数の番組が入る。** 実機の TOKYO MX は
- * 1本の TS に MX1 と MX2 を載せていて、丸ごと保存すると ffprobe が2つの
+ * **これをやらないと 1 つの録画に複数の番組が入る。** 実機の TOKYO MX は
+ * 1 本の TS に MX1 と MX2 を載せていて、丸ごと保存すると ffprobe が 2 つの
  * プログラムを返す (これで CM 検出の fps を読み違えたことがある)。
  *
- * 残すもの:
+ * 残すものは次のとおり。
  *
- * - **PAT** … その局1つだけに**書き直して**出す。丸ごと通すと ffmpeg には
+ * - **PAT** … その局 1 つだけに**書き直して**出す。丸ごと通すと ffmpeg には
  *   相変わらず複数のプログラムが見える
  * - **PMT と、そこに載っている ES** … 映像・音声・字幕。ECM も (掛かったまま
  *   録れたものを後から復号するのに要る)
@@ -20,7 +20,7 @@
  * 落とすもの: 他局の PMT と ES、そして詰め物 (PID 0x1FFF)。
  */
 /**
- * 局1つぶんに絞る。
+ * 局 1 つぶんに絞る。
  *
  * PAT と PMT を読むまでは**何も出さない**。どの PID がその局のものか決まらないためで、
  * どちらも 100ms ごとに流れてくるので待つのは一瞬。**待つ間に届いたものは取っておき**、PMT を読んだら
@@ -44,15 +44,15 @@ export declare class ServiceFilter {
     /** PMT を読む前に届いた、局の分からないパケット (写したもの)。届いた順 */
     private held;
     constructor(serviceId: number);
-    /** その局の PMT を読めたか。読めるまで映像は1バイトも出ない (届いたものは取っておく) */
+    /** その局の PMT を読めたか。読めるまで映像は 1 バイトも出ない (届いたものは取っておく) */
     get ready(): boolean;
     /**
      * **いま流れているものがコピー禁止か** (最後に読んだ PMT のデジタルコピー制御記述子)。
-     * 番組全体 (1つめのループ) と ES ごと (2つめのループ) のどちらかが禁止なら禁止。
+     * 番組全体 (1 つめのループ) と ES ごと (2 つめのループ) のどちらかが禁止なら禁止。
      * PMT を読むまでは false。
      *
      * 録画はこれを見て、禁止のあいだは保存しない (denpa の `recorder.ts`)。番組表が古い・無いときの備え。
-     * 絞り方には効かせない — ライブは保存しないので、禁止の番組もそのまま観られる
+     * 絞り方には効かせない。ライブは保存しないので、禁止の番組もそのまま観られる
      */
     get copyNever(): boolean;
     /**
@@ -60,21 +60,21 @@ export declare class ServiceFilter {
      *
      * これが変わったら ffmpeg を作り直す (`StreamsWatch`)。ffmpeg は起きたときの並びのまま
      * 音声・字幕を選んでいるので、番組が替わって音声の本数や字幕の PID が変わると追従しない。
-     * データ放送などのセクション (0x0D など) は入れない — 番組ごとに増減しても ffmpeg には関係ない
+     * データ放送などのセクション (0x0D など) は入れない。番組ごとに増減しても ffmpeg には関係ない
      */
     get streams(): string | null;
     /**
      * **中継の番号 (transport_stream_id)。** PAT を読むまでは null。
      *
      * 絞るのに要るわけではありません。**データ放送が受信機に訊いてくる**ので
-     * 覚えておきます — テレ朝の TVerリンクは `browser.getProgramID(4)` で
+     * 覚えておきます。テレ朝の TVer リンクは `browser.getProgramID(4)` で
      * これを取り、TVer のサーバへそのまま送る。`null` のまま渡すと文字の
      * "null" が飛んで、あちらが断り、画面には `DT-RE` とだけ出ます
      * ([server/live.ts](https://github.com/danything/denpa/blob/main/src/lib/server/live.ts) の `programInfo`)
      */
     get transportStreamId(): number | null;
     /**
-     * 任意の長さのバイト列を食わせて、残すぶんを返す。
+     * 任意の長さのバイト列を渡すと、残すぶんを返す。
      *
      * 落とした PID の連続性カウンタは飛ぶが、**残す PID は元のまま**なので
      * 読む側から見て抜けは無い。自分で作るのは PAT だけで、そこは自前で数える。
@@ -93,10 +93,10 @@ export declare class ServiceFilter {
 }
 /**
  * **映像・音声・字幕の並びが変わったか** (`ServiceFilter.streams`) を見る。最初に読んだ並びを覚え、変わったら
- * 1回だけ true を返して新しい並びを覚え直す。
+ * 1 回だけ true を返して新しい並びを覚え直す。
  *
  * 並びを決め打ちで起こした ffmpeg (`-map`) は、番組が替わって音声の本数や字幕の PID が変わっても追従しない。
- * 変わったら起こし直す — ライブと追っかけのエンコード (denpa の `server/live.ts` の `Session.pump`)、MPEG-2 をそのまま
+ * 変わったら起こし直す。使うのはライブと追っかけのエンコード (denpa の `server/live.ts` の `Session.pump`)、MPEG-2 をそのまま
  * 流す経路の字幕 (`Session.runRaw`・`recordingCaptions`)
  */
 export declare class StreamsWatch {