@danything/arib 1.2.0 → 1.2.1

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 {

package/dist/service-filter.js

@@ -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 も (掛かったまま
  *   録れたものを後から復号するのに要る)
@@ -25,7 +25,7 @@ const PID_NULL = 0x1fff;
 /**
  * 局に関係なく残す PID。**どれも数十バイト/秒**で、落として得るものが無い。
  *
- * CDT (ロゴ) はここに入れない。録画に要らないうえ、衛星では数百KBのカルーセルが
+ * CDT (ロゴ) はここに入れない。録画に要らないうえ、衛星では数百 KB のカルーセルが
  * 流れてくる。ロゴを取得するのは録画の外でやる (denpa の logo.ts)
  */
 const KEEP = new Set([
@@ -43,7 +43,7 @@ const DESC_CA = 0x09;
  * BS の中継丸ごと (52Mbit/s) でも 7,000 個ほど。来ない (局を読み違えた) ときに抱え込み続けないよう、超えたら古いほうから捨てる
  */
 const HOLD_MOST = 8192;
-/** 1つの局に絞った PAT を組み立てる */
+/** 1 つの局に絞った PAT を組み立てる */
 function buildPat(transportStreamId, version, serviceId, pmtPid) {
     const body = [
         TABLE_PAT,
@@ -66,7 +66,7 @@ function buildPat(transportStreamId, version, serviceId, pmtPid) {
     ];
     return withCrc(body);
 }
-/** セクション1本を TS パケット1つに詰める。PAT は小さいので必ず収まる */
+/** セクション 1 本を TS パケット 1 つに詰める。PAT は小さいので必ず収まる */
 function packet(pid, section, counter) {
     const out = new Uint8Array(PACKET).fill(0xff);
     out[0] = SYNC;
@@ -83,7 +83,7 @@ function packet(pid, section, counter) {
  */
 const MEDIA_STREAMS = new Set([0x02, 0x1b, 0x24, 0x03, 0x04, 0x0f, 0x11, 0x06]);
 /**
- * 局1つぶんに絞る。
+ * 局 1 つぶんに絞る。
  *
  * PAT と PMT を読むまでは**何も出さない**。どの PID がその局のものか決まらないためで、
  * どちらも 100ms ごとに流れてくるので待つのは一瞬。**待つ間に届いたものは取っておき**、PMT を読んだら
@@ -109,17 +109,17 @@ export class ServiceFilter {
     constructor(serviceId) {
         this.serviceId = serviceId;
     }
-    /** その局の PMT を読めたか。読めるまで映像は1バイトも出ない (届いたものは取っておく) */
+    /** その局の PMT を読めたか。読めるまで映像は 1 バイトも出ない (届いたものは取っておく) */
     get ready() {
         return this.own.size > 0;
     }
     /**
      * **いま流れているものがコピー禁止か** (最後に読んだ PMT のデジタルコピー制御記述子)。
-     * 番組全体 (1つめのループ) と ES ごと (2つめのループ) のどちらかが禁止なら禁止。
+     * 番組全体 (1 つめのループ) と ES ごと (2 つめのループ) のどちらかが禁止なら禁止。
      * PMT を読むまでは false。
      *
      * 録画はこれを見て、禁止のあいだは保存しない (denpa の `recorder.ts`)。番組表が古い・無いときの備え。
-     * 絞り方には効かせない — ライブは保存しないので、禁止の番組もそのまま観られる
+     * 絞り方には効かせない。ライブは保存しないので、禁止の番組もそのまま観られる
      */
     get copyNever() {
         return this.copyNeverNow;
@@ -129,7 +129,7 @@ export class ServiceFilter {
      *
      * これが変わったら ffmpeg を作り直す (`StreamsWatch`)。ffmpeg は起きたときの並びのまま
      * 音声・字幕を選んでいるので、番組が替わって音声の本数や字幕の PID が変わると追従しない。
-     * データ放送などのセクション (0x0D など) は入れない — 番組ごとに増減しても ffmpeg には関係ない
+     * データ放送などのセクション (0x0D など) は入れない。番組ごとに増減しても ffmpeg には関係ない
      */
     get streams() {
         return this.streamsNow;
@@ -138,7 +138,7 @@ export class ServiceFilter {
      * **中継の番号 (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`)
@@ -147,7 +147,7 @@ export class ServiceFilter {
         return this.tsid;
     }
     /**
-     * 任意の長さのバイト列を食わせて、残すぶんを返す。
+     * 任意の長さのバイト列を渡すと、残すぶんを返す。
      *
      * 落とした PID の連続性カウンタは飛ぶが、**残す PID は元のまま**なので
      * 読む側から見て抜けは無い。自分で作るのは PAT だけで、そこは自前で数える。
@@ -185,7 +185,7 @@ export class ServiceFilter {
     /** PMT を読む前のパケットを取っておく。**写す** (パケットは届いた塊の上の窓。`PacketStream`) */
     hold(ts) {
         this.held.push(ts.slice());
-        // 溢れたら古い半分を捨てる (1つずつ捨てると、来ないあいだずっと詰め直すことになる)
+        // 溢れたら古い半分を捨てる (1 つずつ捨てると、来ないあいだずっと詰め直すことになる)
         if (this.held.length > HOLD_MOST)
             this.held = this.held.slice(this.held.length - HOLD_MOST / 2);
     }
@@ -246,10 +246,10 @@ export 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 class StreamsWatch {

package/dist/synth-av.d.ts

@@ -1,7 +1,7 @@
 /**
  * **本物の MPEG-2 映像と AAC 音声を、ffmpeg 無しで組み立てる** (試験用)。
  *
- * denpa のライブを変換せずに送る経路 (docs/stream.md#放送そのままmpeg-2を送る) は、ブラウザが MPEG-2 をデコードして映像を出す
+ * denpa のライブを変換せずに送る経路 (docs/stream.md#放送そのまま mpeg-2 を送る) は、ブラウザが MPEG-2 をデコードして映像を出す
  * ところまでが仕事で、そこを試すには**本当にデコードできる放送**が要る。偽エージェントの
  * 放送は中身を 0xFF で埋めていて、デコードするものが無い。E2E のイメージには本物の ffmpeg も
  * 入っていない (数十分かかる組み立てを避けている) ので、ここで小さく作る。
@@ -9,17 +9,17 @@
  * - 映像 … 256x144 の**I フレームだけ**。マクロブロックごとに色 (DC) だけを置き、
  *   AC は持たない (EOB だけ)。コマごとに縞が流れるので、**映像が進んでいるか**を
  *   画素で見分けられる。インタレの印も立て、輝度は上下のフィールドで別の時刻の映像にする (フィールド DCT)
- * - 音声 … 48kHz ステレオの AAC-LC の**無音**を ADTS で。1コマ 7 バイト
+ * - 音声 … 48kHz ステレオの AAC-LC の**無音**を ADTS で。1 コマ 7 バイト
  *
  * 規格は ISO/IEC 13818-2 (映像) と 13818-7 / 14496-3 (AAC)。表の出どころは
  * 各関数の頭に書いてある。
  */
-/** 29.97 コマ/秒の1コマ (90kHz)。放送と同じ */
+/** 29.97 コマ/秒の 1 コマ (90kHz)。放送と同じ */
 export declare const FRAME_TICKS = 3003;
-/** AAC の1コマ (1024 標本 @48kHz を 90kHz で) */
+/** AAC の 1 コマ (1024 標本 @48kHz を 90kHz で) */
 export declare const AUDIO_TICKS = 1920;
 /**
- * I フレームを1枚。**毎枚、系列ヘッダから書く** — どこから受け取っても頭からデコードできる
+ * I フレームを 1 枚。**毎枚、系列ヘッダから書く。** どこから受け取っても頭からデコードできる
  * (放送は GOP ごとに書く。試験ではその手間を省く)。
  *
  * @param n 何枚目か。色と time_code に使う
@@ -27,10 +27,10 @@ export declare const AUDIO_TICKS = 1920;
  */
 export declare function mpeg2Frame(n: number, color?: (col: number, row: number, n: number, field: 0 | 1) => [number, number, number]): Uint8Array;
 /**
- * AAC-LC の無音を1コマ、ADTS の頭付きで。48kHz・ステレオ (channel_configuration 2)。
+ * AAC-LC の無音を 1 コマ、ADTS の頭付きで。48kHz・ステレオ (channel_configuration 2)。
  *
- * 中身は CPE が1つ: 両耳とも `max_sfb = 0` (係数を1つも持たない) で、あとは END。
- * 55 ビットなので7バイトに収まる (14496-3 の raw_data_block)
+ * 中身は CPE が 1 つ: 両耳とも `max_sfb = 0` (係数を 1 つも持たない) で、あとは END。
+ * 55 ビットなので 7 バイトに収まる (14496-3 の raw_data_block)
  */
 export declare function silentAac(): Uint8Array;
 /**