@danything/arib 1.0.2 → 1.2.1

package/dist/psi.js

@@ -1,10 +1,12 @@
 /**
  * TS の土台 (パケットの切り出し・セクションの組み立て・PAT/PMT) と、局の一覧。
  * 局の一覧はチャンネルスキャンで「この物理チャンネルに何が入っているか」を知るために使い、
- * 読むのは NIT と SDT の2つ。
+ * 読むのは NIT と SDT の 2 つ。
  *
- * - NIT (PID 0x0010) … ネットワークID と、地上波ならリモコン番号
- * - SDT (PID 0x0011) … その TS に入っているサービスのIDと種別
+ * - NIT (PID 0x0010) … ネットワーク ID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
+ *   (TSID・周波数・サービスの一覧) が載っている (`NitReader`)
+ * - SDT (PID 0x0011) … その TS に入っているサービスの ID と種別。衛星はほかの TS のぶん
+ *   (SDT[other]) も流れている (`SdtReader`)
  *
  * 局名も SDT から読む。ARIB の文字符号は独自だが、番組表を自分で集めるなら
  * どのみち要るので [aribtext.ts](aribtext.ts) に寄せてある。
@@ -19,13 +21,17 @@ export function packetPid(packet) {
 }
 /** PAT。どの PID に PMT があるかを持つ。**入口はいつもここ** */
 export const PID_PAT = 0x0000;
-const PID_NIT = 0x0010;
+export const PID_NIT = 0x0010;
 export const PID_SDT = 0x0011;
 export const TABLE_PAT = 0x00;
 export const TABLE_PMT = 0x02;
-const TABLE_NIT_ACTUAL = 0x40;
+export const TABLE_NIT_ACTUAL = 0x40;
+export const TABLE_NIT_OTHER = 0x41;
 export const TABLE_SDT_ACTUAL = 0x42;
+export const TABLE_SDT_OTHER = 0x46;
 const DESC_SERVICE_LIST = 0x41;
+const DESC_SATELLITE_DELIVERY = 0x43;
+const DESC_TERRESTRIAL_DELIVERY = 0xfa;
 const DESC_SERVICE = 0x48;
 const DESC_TS_INFORMATION = 0xcd;
 /**
@@ -33,7 +39,9 @@ const DESC_TS_INFORMATION = 0xcd;
  * ラジオ (0x02) とデータ (0xc0) も入る。映像の無いものを番組表に並べないのは
  * 取り込むほう (denpa の epg.ts の DIGITAL_TV)
  */
-const SERVICE_TYPES = new Set([0x01, 0x02, 0xa1, 0xa4, 0xa5, 0xad, 0xc0]);
+export const SERVICE_TYPES = new Set([
+    0x01, 0x02, 0xa1, 0xa4, 0xa5, 0xad, 0xc0,
+]);
 const CRC32_TABLE = (() => {
     const table = new Uint32Array(256);
     for (let i = 0; i < 256; i++) {
@@ -46,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) {
@@ -58,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);
@@ -79,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 なので、
      *     いつも確かめると**全部捨ててしまう**
@@ -98,10 +106,10 @@ export class SectionAssembler {
         this.crc = crc;
     }
     /**
-     * パケットを1つ食わせる。組み上がったセクションを返す。
+     * パケットを 1 つ渡す。組み上がったセクションを返す。
      *
      * 返りは**読むだけ**にすること。何も組み上がらないとき (ほとんどのパケット) は
-     * 使い回しの空配列を返す — 関係ないパケットのたびに配列を作っていた
+     * 使い回しの空配列を返す (関係ないパケットのたびに配列を作っていた)
      */
     feed(packet) {
         // トランスポートエラーが立っているものは信用しない
@@ -165,7 +173,7 @@ export class SectionAssembler {
 }
 /**
  * 同期が取れているとみなすのに必要な連続パケット数。
- * 1つだけでは中身のたまたまの 0x47 を頭と誤認する
+ * 1 つだけでは中身のたまたまの 0x47 を頭と誤認する
  */
 const CONFIRM = 3;
 /** `from` 以降 `until` の手前までで、188 間隔に 0x47 が続くところを探す。無ければ -1 (denpa の `seek.ts` も使う) */
@@ -183,7 +191,7 @@ export function findSync(data, from = 0, until = data.length) {
  * 任意の長さで届くバイト列を 188 バイトのパケットに切り分ける。
  *
  * 頭が必ずパケットの先頭とは限らず、電波が弱いと途中で数バイト落ちる。
- * ずれたままだと**以降ずっと1パケットも読めなくなる**ので、頭が 0x47 でなければ
+ * ずれたままだと**以降ずっと 1 パケットも読めなくなる**ので、頭が 0x47 でなければ
  * 取り直す。普段は先頭が 0x47 なので、探しに行くのはずれたときだけ。
  *
  * **出すパケットは渡された塊の上の窓** (写しではない。写すと録画の処理の 1/3 を食う)。
@@ -197,7 +205,7 @@ export class PacketStream {
         /*
          * 前の残り (`rest`) と塊を繋いだ並びの上を歩く。位置 `at` はその並びでの位置。
          * 繋ぐのは**残りに頭があるパケットを読むのに要るぶんだけ** (頭を探すのに
-         * 3パケットぶん先まで見る)
+         * 3 パケットぶん先まで見る)
          */
         const split = this.rest.length;
         const total = split + chunk.length;
@@ -259,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;
@@ -271,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)) {
@@ -306,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) {
@@ -343,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)
@@ -360,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;
@@ -373,10 +381,8 @@ export function* sdtServices(section) {
         at += 5 + loop;
     }
 }
-/** SDT からサービスの一覧を読む。自分の TS のものだけ */
-export function parseSdt(section) {
-    if (section[0] !== TABLE_SDT_ACTUAL)
-        return null;
+/** SDT のサービスの並び。自分の TS (actual) とほかの TS (other) で形式は同じ */
+function sdtTransport(section) {
     const services = [];
     for (const [serviceId, body] of sdtServices(section)) {
         for (const [tag, descriptor] of descriptors(body)) {
@@ -404,9 +410,69 @@ export function parseSdt(section) {
         services,
     };
 }
-/** NIT からネットワークIDとリモコン番号、他の TS の顔ぶれを読む */
-export function parseNit(section) {
-    if (section[0] !== TABLE_NIT_ACTUAL)
+/** SDT からサービスの一覧を読む。自分の TS のものだけ */
+export function parseSdt(section) {
+    return section[0] === TABLE_SDT_ACTUAL ? sdtTransport(section) : null;
+}
+/**
+ * SDT[other] からサービスの一覧を読む。**ほかの TS のもの。**
+ *
+ * 衛星は、どの TS にもネットワークのほかの TS の局名を流している (番組表の EIT[other] と同じ考え)。
+ * 開いていない TS の局名をこれで知る。TS ごとに別のセクションで来るので、集めるのは `SdtReader`
+ */
+export function parseSdtOther(section) {
+    return section[0] === TABLE_SDT_OTHER ? sdtTransport(section) : null;
+}
+/** BCD の桁を左から `digits` 桁ぶん読んで、10 進の整数にする */
+function bcdDigits(data, at, digits) {
+    let value = 0;
+    for (let i = 0; i < digits; i++) {
+        const byte = data[at + (i >> 1)] ?? 0;
+        value = value * 10 + ((i & 1) === 0 ? byte >> 4 : byte & 0x0f);
+    }
+    return value;
+}
+/**
+ * 衛星の分配の記述子を読む。周波数は 8 桁の BCD で、上から 3 桁が GHz (011.72748 GHz)。
+ * シンボルレートは 7 桁で、上から 3 桁が Msym/s
+ */
+function satelliteDelivery(descriptor) {
+    if (descriptor.length < 11)
+        return null;
+    return {
+        kind: "satellite",
+        frequency: bcdDigits(descriptor, 0, 8) * 10,
+        orbitalPosition: bcdDigits(descriptor, 4, 4),
+        east: (descriptor[6] & 0x80) !== 0,
+        polarization: (descriptor[6] >> 5) & 0x03,
+        modulation: descriptor[6] & 0x1f,
+        symbolRate: bcdDigits(descriptor, 7, 7) * 100,
+        fec: descriptor[10] & 0x0f,
+    };
+}
+/** 地上の分配の記述子を読む。周波数は 16 ビットずつ、1/7 MHz 単位 */
+function terrestrialDelivery(descriptor) {
+    if (descriptor.length < 2)
+        return null;
+    const head = u16(descriptor, 0);
+    const frequencies = [];
+    for (let at = 2; at + 2 <= descriptor.length; at += 2) {
+        frequencies.push(Math.round((u16(descriptor, at) * 1_000_000) / 7));
+    }
+    return {
+        kind: "terrestrial",
+        areaCode: head >> 4,
+        guardInterval: (head >> 2) & 0x03,
+        transmissionMode: head & 0x03,
+        frequencies,
+    };
+}
+/** NIT のセクションを 1 つ読む。actual (0x40) と other (0x41) のどちらも */
+export function parseNitSection(section) {
+    const tableId = section[0];
+    if (tableId !== TABLE_NIT_ACTUAL && tableId !== TABLE_NIT_OTHER)
+        return null;
+    if (section.length < 16)
         return null;
     const networkLength = u16(section, 8) & 0x0fff;
     let at = 10 + networkLength;
@@ -420,9 +486,10 @@ export function parseNit(section) {
         const transportStreamId = u16(section, at);
         const originalNetworkId = u16(section, at + 2);
         const loop = u16(section, at + 4) & 0x0fff;
-        const body = section.subarray(at + 6, at + 6 + loop);
+        const body = section.subarray(at + 6, Math.min(at + 6 + loop, end));
         at += 6 + loop;
         const services = [];
+        let delivery = null;
         for (const [tag, descriptor] of descriptors(body)) {
             if (tag === DESC_TS_INFORMATION &&
                 descriptor.length > 0 &&
@@ -438,17 +505,222 @@ export function parseNit(section) {
                     });
                 }
             }
+            else if (tag === DESC_SATELLITE_DELIVERY) {
+                delivery = satelliteDelivery(descriptor) ?? delivery;
+            }
+            else if (tag === DESC_TERRESTRIAL_DELIVERY) {
+                delivery = terrestrialDelivery(descriptor) ?? delivery;
+            }
         }
-        transportStreams.push({ transportStreamId, originalNetworkId, services });
+        transportStreams.push({
+            transportStreamId,
+            originalNetworkId,
+            services,
+            delivery,
+        });
     }
     return {
+        other: tableId === TABLE_NIT_OTHER,
         networkId: u16(section, 3),
+        version: (section[5] >> 1) & 0x1f,
+        current: (section[5] & 0x01) !== 0,
+        sectionNumber: section[6],
+        lastSectionNumber: section[7],
         remoteControlKeyId,
         transportStreams,
     };
 }
 /**
- * 流れてくる TS を食べて、NIT と SDT が揃うまで待つ。
+ * NIT からネットワーク ID とリモコン番号、他の TS の顔ぶれを読む。**セクション 1 つぶん。**
+ * スキャンで「どのネットワークか」を知るにはこれで足りる。ネットワークの全部の TS が要るなら `NitReader`
+ */
+export function parseNit(section) {
+    if (section[0] !== TABLE_NIT_ACTUAL)
+        return null;
+    const parsed = parseNitSection(section);
+    if (parsed === null)
+        return null;
+    const { networkId, remoteControlKeyId, transportStreams } = parsed;
+    return { networkId, remoteControlKeyId, transportStreams };
+}
+/**
+ * 1 つの表のセクションを集める。**version が変わったら集め直す。**
+ *
+ * 表は何本かのセクション (section_number 0〜last_section_number) に分かれて来る。
+ * 違う version のものを混ぜると、書き換わる前と後の TS が 1 つの表に並ぶ
+ */
+class SectionSet {
+    version = -1;
+    last = -1;
+    parts = new Map();
+    /** 足す。そろったら true */
+    add(version, number, last, part) {
+        if (version !== this.version || last !== this.last) {
+            this.version = version;
+            this.last = last;
+            this.parts = new Map();
+        }
+        if (number <= last)
+            this.parts.set(number, part);
+        return this.parts.size === last + 1;
+    }
+    /** section_number の順に */
+    ordered() {
+        return [...this.parts.entries()]
+            .sort(([a], [b]) => a - b)
+            .map(([, part]) => part);
+    }
+}
+/**
+ * NIT を**全部のセクション**そろえて読む。
+ *
+ * 衛星の NIT[actual] には、そのネットワークの全部の TS (TSID・周波数・サービスの一覧) が載っている。
+ * TS が多いと 1 セクション (1024 バイトまで) に収まらないので、ネットワークごとに (actual と other を
+ * 分けて) 集め、そろったものを返す。
+ *
+ * **version が変わっても、新しい表がそろうまでは前の表を返す。** 読む側が見るのは、いつも 1 つの
+ * version でそろった表。全部のセクションが 1 回りするまで (NIT は 10 秒に 1 回は流れるので、長くて 10 秒ほど) は何も返らない。
+ *
+ * 置き換えた 1 つ前の version のセクションが遅れて届いても読まない。読むと、そろったときに表が前に戻る。
+ *
+ * 1 つの中継を読む前提で作ってある。別の中継へ移るときは作り直す。`actual` は、最初にそろった自分のネットワークの表を返す
+ */
+export class NitReader {
+    assembler = new SectionAssembler(PID_NIT);
+    packets = new PacketStream();
+    pending = new Map();
+    done = new Map();
+    /** 置き換えた表の version (表ごと) */
+    replaced = new Map();
+    /** 任意の長さのバイト列を渡す。そろった表が増えたか変わったら true */
+    feed(chunk) {
+        let changed = false;
+        for (const packet of this.packets.feed(chunk)) {
+            for (const section of this.assembler.feed(packet)) {
+                const tableId = section[0];
+                if (tableId !== TABLE_NIT_ACTUAL && tableId !== TABLE_NIT_OTHER)
+                    continue;
+                // current_next_indicator が 0 (これから使う表) のものは読まない
+                if (section.length < 16 || (section[5] & 0x01) === 0)
+                    continue;
+                const key = `${tableId === TABLE_NIT_OTHER ? "other" : "actual"}:${u16(section, 3)}`;
+                // そろっている表と同じ version なら、繰り返し流れてきただけ。中身を読む前に見る (同じものが何度も来る)
+                const version = (section[5] >> 1) & 0x1f;
+                if (this.done.get(key)?.version === version ||
+                    this.replaced.get(key) === version)
+                    continue;
+                const parsed = parseNitSection(section);
+                if (parsed !== null && this.add(key, parsed))
+                    changed = true;
+            }
+        }
+        return changed;
+    }
+    add(key, section) {
+        const set = this.pending.get(key) ?? new SectionSet();
+        this.pending.set(key, set);
+        const complete = set.add(section.version, section.sectionNumber, section.lastSectionNumber, section);
+        if (!complete)
+            return false;
+        const parts = set.ordered();
+        this.pending.delete(key);
+        const before = this.done.get(key);
+        if (before !== undefined)
+            this.replaced.set(key, before.version);
+        this.done.set(key, {
+            other: section.other,
+            networkId: section.networkId,
+            version: section.version,
+            remoteControlKeyId: parts.find((part) => part.remoteControlKeyId !== null)
+                ?.remoteControlKeyId ?? null,
+            transportStreams: parts.flatMap((part) => part.transportStreams),
+        });
+        return true;
+    }
+    /** 自分のネットワークの表 (NIT[actual])。まだそろっていなければ null */
+    get actual() {
+        for (const network of this.done.values()) {
+            if (!network.other)
+                return network;
+        }
+        return null;
+    }
+    /** そろった表を全部。actual が先 */
+    networks() {
+        return [...this.done.values()].sort((a, b) => Number(a.other) - Number(b.other) || a.networkId - b.networkId);
+    }
+}
+/**
+ * SDT を TS ごとに**全部のセクション**そろえて読む。自分の TS (actual) とほかの TS (other) の両方。
+ *
+ * 衛星はほかの TS の局名も流しているので、1 つの TS を開けばネットワークの局名がそろう
+ * (そろうかは放送しだい。来なかった TS は返らない)。version の扱いと、1 つの中継を読む前提は `NitReader` と同じ
+ */
+export class SdtReader {
+    assembler = new SectionAssembler(PID_SDT);
+    packets = new PacketStream();
+    pending = new Map();
+    done = new Map();
+    /** 置き換えた表の version (TS ごと) */
+    replaced = new Map();
+    /** 任意の長さのバイト列を渡す。そろった表が増えたか変わったら true */
+    feed(chunk) {
+        let changed = false;
+        for (const packet of this.packets.feed(chunk)) {
+            for (const section of this.assembler.feed(packet)) {
+                const tableId = section[0];
+                if (tableId !== TABLE_SDT_ACTUAL && tableId !== TABLE_SDT_OTHER)
+                    continue;
+                // current_next_indicator が 0 (これから使う表) のものは読まない
+                if (section.length < 15 || (section[5] & 0x01) === 0)
+                    continue;
+                if (this.add(section, tableId === TABLE_SDT_OTHER))
+                    changed = true;
+            }
+        }
+        return changed;
+    }
+    add(section, other) {
+        const version = (section[5] >> 1) & 0x1f;
+        const key = `${other ? "other" : "actual"}:${u16(section, 8)}:${u16(section, 3)}`;
+        // そろっている表と同じ version なら、繰り返し流れてきただけ。局名を読む前に見る (2 秒おきに同じものが来る)
+        if (this.done.get(key)?.version === version ||
+            this.replaced.get(key) === version)
+            return false;
+        const transport = sdtTransport(section);
+        const set = this.pending.get(key) ?? new SectionSet();
+        this.pending.set(key, set);
+        if (!set.add(version, section[6], section[7], transport))
+            return false;
+        this.pending.delete(key);
+        const before = this.done.get(key);
+        if (before !== undefined)
+            this.replaced.set(key, before.version);
+        this.done.set(key, {
+            ...transport,
+            services: set.ordered().flatMap((part) => part.services),
+            other,
+            version,
+        });
+        return true;
+    }
+    /** 自分の TS の表 (SDT[actual])。まだそろっていなければ null */
+    get actual() {
+        for (const table of this.done.values()) {
+            if (!table.other)
+                return table;
+        }
+        return null;
+    }
+    /** そろった表を全部。actual が先、あとはネットワーク・TSID の順 */
+    tables() {
+        return [...this.done.values()].sort((a, b) => Number(a.other) - Number(b.other) ||
+            a.originalNetworkId - b.originalNetworkId ||
+            a.transportStreamId - b.transportStreamId);
+    }
+}
+/**
+ * 流れてくる TS を読んで、NIT と SDT が揃うまで待つ。
  *
  * Mirakurun のスキャンと同じで、**両方**揃って初めてそのチャンネルを
  * 「受信できた」とみなす。SDT だけ取れても、どのネットワークのものか
@@ -463,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 {