@danything/arib 1.3.1 → 2.1.0

package/dist/psi.js

@@ -1,7 +1,7 @@
 /**
  * TS の土台 (パケットの切り出し・セクションの組み立て・PAT/PMT) と、局の一覧。
  * 局の一覧はチャンネルスキャンで「この物理チャンネルに何が入っているか」を知るために使い、
- * 読むのは NIT と SDT の 2 つ。
+ * 読むのは NIT と SDT の 2 つ。ケーブルでは、局の無い TS を見分けるのに PAT も読む (`ServiceReader`)。
  *
  * - NIT (PID 0x0010) … ネットワーク ID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
  *   (TSID・周波数・サービスの一覧) が載っている (`NitReader`)
@@ -21,14 +21,14 @@ export function packetPid(packet) {
 }
 /** PAT。どの PID に PMT があるかを持つ。**入口はいつもここ** */
 export const PID_PAT = 0x0000;
-export const PID_NIT = 0x0010;
+const PID_NIT = 0x0010;
 export const PID_SDT = 0x0011;
 export const TABLE_PAT = 0x00;
 export const TABLE_PMT = 0x02;
-export const TABLE_NIT_ACTUAL = 0x40;
-export const TABLE_NIT_OTHER = 0x41;
+const TABLE_NIT_ACTUAL = 0x40;
+const TABLE_NIT_OTHER = 0x41;
 export const TABLE_SDT_ACTUAL = 0x42;
-export const TABLE_SDT_OTHER = 0x46;
+const TABLE_SDT_OTHER = 0x46;
 const DESC_SERVICE_LIST = 0x41;
 const DESC_SATELLITE_DELIVERY = 0x43;
 const DESC_TERRESTRIAL_DELIVERY = 0xfa;
@@ -80,14 +80,14 @@ export function withCrc(body) {
     new DataView(out.buffer).setUint32(section.length, crc32(section));
     return out;
 }
-/** 何も組み上がらなかったときの返り。使い回すので凍らせてある */
+/** 何も組み上がらなかったときの返り。使い回すので `Object.freeze` してある */
 const NONE = Object.freeze([]);
 /**
  * PSI セクションを組み立てる。
  *
  * セクションは TS パケットをまたいで運ばれ、パケットの切れ目とは無関係な
  * 位置で終わる。payload_unit_start_indicator と pointer_field を見て
- * 頭を合わせ、section_length ぶん溜まったら 1 本として返す。
+ * 先頭を合わせ、section_length ぶん溜まったら 1 本として返す。
  */
 export class SectionAssembler {
     pid;
@@ -133,7 +133,7 @@ export class SectionAssembler {
             // pointer_field の手前は前のセクションの続き
             this.append(payload.subarray(1, 1 + pointer));
             const done = this.flush();
-            // 写す。パケットは届いた塊の上の窓で、塊は使い回される (PacketStream)
+            // コピーする。パケットは届いたチャンクの一部を指し、チャンクのバッファは使い回される (PacketStream)
             this.buffer = payload.slice(1 + pointer);
             const next = this.flush();
             if (done.length === 0)
@@ -173,7 +173,7 @@ export class SectionAssembler {
 }
 /**
  * 同期が取れているとみなすのに必要な連続パケット数。
- * 1 つだけでは中身のたまたまの 0x47 を頭と誤認する
+ * 1 つだけでは中身にたまたまある 0x47 をパケットの先頭と誤認する
  */
 const CONFIRM = 3;
 /** `from` 以降 `until` の手前までで、188 間隔に 0x47 が続くところを探す。無ければ -1 (denpa の `seek.ts` も使う) */
@@ -190,21 +190,21 @@ export function findSync(data, from = 0, until = data.length) {
 /**
  * 任意の長さで届くバイト列を 188 バイトのパケットに切り分ける。
  *
- * 頭が必ずパケットの先頭とは限らず、電波が弱いと途中で数バイト落ちる。
- * ずれたままだと**以降ずっと 1 パケットも読めなくなる**ので、頭が 0x47 でなければ
+ * 渡されたバイト列の先頭がパケットの先頭とは限らず、電波が弱いと途中で数バイト落ちる。
+ * ずれたままだと**以降ずっと 1 パケットも読めなくなる**ので、先頭が 0x47 でなければ
  * 取り直す。普段は先頭が 0x47 なので、探しに行くのはずれたときだけ。
  *
- * **出すパケットは渡された塊の上の窓** (写しではない。写すと録画の処理の 1/3 を食う)。
- * 塊の入れ物を使い回す呼び出し側がある
- * (denpa の `server/recorded-bml.ts`) ので、**次の `feed` より後まで持つなら写すこと**。
- * いまのパーサ (`SectionAssembler`・`PesDemuxer`) は溜めるときに写している
+ * **出すパケットは渡されたチャンクの一部を指す** (コピーではない。コピーすると録画の処理時間の 1/3 を使う)。
+ * チャンクのバッファを使い回す呼び出し側がある
+ * (denpa の `server/recorded-bml.ts`) ので、**次の `feed` より後まで持つならコピーすること**。
+ * いまのパーサ (`SectionAssembler`・`PesDemuxer`) は溜めるときにコピーしている
  */
 export class PacketStream {
     rest = new Uint8Array(0);
     *feed(chunk) {
         /*
-         * 前の残り (`rest`) と塊を繋いだ並びの上を歩く。位置 `at` はその並びでの位置。
-         * 繋ぐのは**残りに頭があるパケットを読むのに要るぶんだけ** (頭を探すのに
+         * 前の残り (`rest`) とチャンクを繋いだ並びを順に読む。位置 `at` はその並びでの位置。
+         * 繋ぐのは**残りに先頭があるパケットを読むのに要るぶんだけ** (先頭を探すのに
          * 3 パケットぶん先まで見る)
          */
         const split = this.rest.length;
@@ -218,7 +218,7 @@ export class PacketStream {
             while (at < split && at + PACKET <= total) {
                 if (head[at] !== SYNC) {
                     const found = findSync(head, at, split);
-                    // 残りの中には無い。塊のほうを探す
+                    // 残りの中には無い。チャンクのほうを探す
                     if (found < 0) {
                         lost = true;
                         break;
@@ -252,13 +252,13 @@ export class PacketStream {
             }
             at = split + offset;
         }
-        // 同期が取れないまま溜め込まないよう、頭を探せるぶんだけ残す
+        // 同期が取れないまま溜め込まないよう、先頭を探せるぶんだけ残す
         const from = Math.max(at, total - PACKET * CONFIRM);
         if (from >= split) {
             this.rest = chunk.slice(from - split);
         }
         else {
-            // 塊が短くて、前の残りにまだ食い込んでいる
+            // チャンクが短くて、前の残りの途中から残す
             const rest = new Uint8Array(total - from);
             rest.set(this.rest.subarray(from));
             rest.set(chunk, split - from);
@@ -333,10 +333,10 @@ export function pmtProgramInfo(section) {
 /**
  * PMT の ES の並びを `[stream_type, PID, 記述子]` で返す。
  *
- * **`stream_type` では物を見分けられません。** データ放送も AIT もロゴも同じ
+ * **`stream_type` では中身を見分けられない。** データ放送も AIT もロゴも同じ
  * DSM-CC セクション (0x0D) を名乗るので、見分けるのは記述子のほう
- * (component_tag や application_signalling) です。だからここは**素通しで並べる
- * だけ**にして、選り分けは呼ぶ側に置いてあります。
+ * (component_tag や application_signalling)。だからここは**素通しで並べる
+ * だけ**にして、選り分けは呼ぶ側に置いてある。
  */
 export function* pmtStreams(section) {
     if (section[0] !== TABLE_PMT || section.length < 16)
@@ -368,7 +368,7 @@ export function parsePat(section) {
 /**
  * SDT のサービスの並びを (service_id, 記述子の並び) に切り分ける。
  *
- * **読む側が 2 つある。** 局名 (`parseSdt`) とロゴの対応 (denpa の `ts/logo.ts`) で、
+ * **読む側が 2 つある。** 局名 (`sdtTransport`) とロゴの対応 (denpa の `ts/logo.ts`) で、
  * 欲しい記述子が違うだけで歩き方は同じ。並びの読み方をここ 1 箇所に置く。
  */
 export function* sdtServices(section) {
@@ -411,18 +411,9 @@ function sdtTransport(section) {
     };
 }
 /** SDT からサービスの一覧を読む。自分の TS のものだけ */
-export function parseSdt(section) {
+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;
@@ -468,7 +459,7 @@ function terrestrialDelivery(descriptor) {
     };
 }
 /** NIT のセクションを 1 つ読む。actual (0x40) と other (0x41) のどちらも */
-export function parseNitSection(section) {
+function parseNitSection(section) {
     const tableId = section[0];
     if (tableId !== TABLE_NIT_ACTUAL && tableId !== TABLE_NIT_OTHER)
         return null;
@@ -490,11 +481,11 @@ export function parseNitSection(section) {
         at += 6 + loop;
         const services = [];
         let delivery = null;
+        let remote = null;
         for (const [tag, descriptor] of descriptors(body)) {
-            if (tag === DESC_TS_INFORMATION &&
-                descriptor.length > 0 &&
-                remoteControlKeyId === null) {
-                remoteControlKeyId = descriptor[0];
+            if (tag === DESC_TS_INFORMATION && descriptor.length > 0) {
+                remote ??= descriptor[0];
+                remoteControlKeyId ??= remote;
             }
             else if (tag === DESC_SERVICE_LIST) {
                 for (let i = 0; i + 3 <= descriptor.length; i += 3) {
@@ -517,13 +508,13 @@ export function parseNitSection(section) {
             originalNetworkId,
             services,
             delivery,
+            remoteControlKeyId: remote,
         });
     }
     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,
@@ -534,7 +525,7 @@ export function parseNitSection(section) {
  * NIT からネットワーク ID とリモコン番号、他の TS の顔ぶれを読む。**セクション 1 つぶん。**
  * スキャンで「どのネットワークか」を知るにはこれで足りる。ネットワークの全部の TS が要るなら `NitReader`
  */
-export function parseNit(section) {
+function parseNit(section) {
     if (section[0] !== TABLE_NIT_ACTUAL)
         return null;
     const parsed = parseNitSection(section);
@@ -725,15 +716,30 @@ export class SdtReader {
  * Mirakurun のスキャンと同じで、**両方**揃って初めてそのチャンネルを
  * 「受信できた」とみなす。SDT だけ取れても、どのネットワークのものか
  * 分からないと設定に書けない。
+ *
+ * **ケーブル (`requireNit: false`) は SDT[actual] だけで揃ったとみなす。** 1 つのネットワークが
+ * 地上波・BS の再送信と自主放送の TS をまとめて流していて、NIT は CATV のネットワークのもの
+ * (局の元の放送とは別)。どの放送の局かは SDT の original_network_id で分かる。
+ * NIT が先に来ていれば、その TS のリモコン番号だけを使う。
+ * PAT に局が 1 つも無い TS (データだけの TS) も揃ったとみなし、局は返さない (`empty`)
  */
 export class ServiceReader {
     nit = new SectionAssembler(PID_NIT);
     sdt = new SectionAssembler(PID_SDT);
+    pat = new SectionAssembler(PID_PAT);
     packets = new PacketStream();
+    requireNit;
     network = null;
     transport = null;
+    /** PAT に局が 1 つも無かった (`requireNit: false` のときだけ読む) */
+    empty = false;
+    constructor({ requireNit = true } = {}) {
+        this.requireNit = requireNit;
+    }
     get complete() {
-        return this.network !== null && this.transport !== null;
+        return this.requireNit
+            ? this.network !== null && this.transport !== null
+            : this.transport !== null || this.empty;
     }
     /** 任意の長さのバイト列を渡す。揃ったら true */
     feed(chunk) {
@@ -748,16 +754,22 @@ export class ServiceReader {
                     this.transport = parseSdt(section) ?? this.transport;
                 }
             }
+            if (!this.requireNit && !this.empty && this.transport === null) {
+                for (const section of this.pat.feed(packet)) {
+                    if (section[0] === TABLE_PAT && parsePat(section).size === 0)
+                        this.empty = true;
+                }
+            }
         }
         return this.complete;
     }
     /** 録るに値するサービスだけ。リモコン番号は NIT のものを配る */
     services() {
-        if (this.network === null || this.transport === null)
+        const transport = this.transport;
+        if (transport === null)
             return [];
-        const { networkId, remoteControlKeyId } = this.network;
-        const { transportStreamId } = this.transport;
-        return this.transport.services
+        const { transportStreamId, originalNetworkId } = transport;
+        const found = (networkId, remoteControlKeyId) => transport.services
             .filter((service) => SERVICE_TYPES.has(service.serviceType))
             .map((service) => ({
             ...service,
@@ -765,5 +777,13 @@ export class ServiceReader {
             transportStreamId,
             remoteControlKeyId,
         }));
+        if (this.requireNit) {
+            if (this.network === null)
+                return [];
+            return found(this.network.networkId, this.network.remoteControlKeyId);
+        }
+        const own = this.network?.transportStreams.find((ts) => ts.transportStreamId === transportStreamId &&
+            ts.originalNetworkId === originalNetworkId);
+        return found(originalNetworkId, own?.remoteControlKeyId ?? null);
     }
 }

package/dist/service-filter.d.ts

@@ -5,8 +5,8 @@
  * ([agent.md](https://github.com/danything/denpa/blob/main/docs/agent.md))、選り分けるのは denpa の仕事。
  *
  * **これをやらないと 1 つの録画に複数の番組が入る。** 実機の TOKYO MX は
- * 1 本の TS に MX1 と MX2 を載せていて、丸ごと保存すると ffprobe が 2 つの
- * プログラムを返す (これで CM 検出の fps を読み違えたことがある)。
+ * 1 本の TS に MX1 と MX2 が入っていて、丸ごと保存すると ffprobe が 2 つの
+ * プログラムを返す。
  *
  * 残すものは次のとおり。
  *
@@ -41,7 +41,7 @@ export declare class ServiceFilter {
     private tsid;
     private copyNeverNow;
     private streamsNow;
-    /** PMT を読む前に届いた、局の分からないパケット (写したもの)。届いた順 */
+    /** PMT を読む前に届いた、局の分からないパケット (コピーしたもの)。届いた順 */
     private held;
     constructor(serviceId: number);
     /** その局の PMT を読めたか。読めるまで映像は 1 バイトも出ない (届いたものは取っておく) */
@@ -66,10 +66,10 @@ export declare class ServiceFilter {
     /**
      * **中継の番号 (transport_stream_id)。** PAT を読むまでは null。
      *
-     * 絞るのに要るわけではありません。**データ放送が受信機に訊いてくる**ので
-     * 覚えておきます。テレ朝の TVer リンクは `browser.getProgramID(4)` で
-     * これを取り、TVer のサーバへそのまま送る。`null` のまま渡すと文字の
-     * "null" が飛んで、あちらが断り、画面には `DT-RE` とだけ出ます
+     * 絞るのに要るわけではない。**データ放送が受信機に訊いてくる**ので
+     * 覚えておく。テレ朝の 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;
@@ -84,7 +84,7 @@ export declare class ServiceFilter {
      * その局のぶんだけを PMT の後ろに足す (並びは届いた順のまま。読む側は PAT・PMT を先に知る)
      */
     filter(chunk: Uint8Array): Uint8Array;
-    /** PMT を読む前のパケットを取っておく。**写す** (パケットは届いた塊の上の窓。`PacketStream`) */
+    /** PMT を読む前のパケットを取っておく。**コピーする** (パケットは届いたチャンクの一部を指す。`PacketStream`) */
     private hold;
     /** 取っておいたもののうち、その局のぶんを出す */
     private release;
@@ -101,6 +101,6 @@ export declare class ServiceFilter {
  */
 export declare class StreamsWatch {
     private seen;
-    /** `filter` に塊を通したあとに呼ぶ */
+    /** `filter` にチャンクを通したあとに呼ぶ */
     changed(filter: ServiceFilter): boolean;
 }

package/dist/service-filter.js

@@ -5,8 +5,8 @@
  * ([agent.md](https://github.com/danything/denpa/blob/main/docs/agent.md))、選り分けるのは denpa の仕事。
  *
  * **これをやらないと 1 つの録画に複数の番組が入る。** 実機の TOKYO MX は
- * 1 本の TS に MX1 と MX2 を載せていて、丸ごと保存すると ffprobe が 2 つの
- * プログラムを返す (これで CM 検出の fps を読み違えたことがある)。
+ * 1 本の TS に MX1 と MX2 が入っていて、丸ごと保存すると ffprobe が 2 つの
+ * プログラムを返す。
  *
  * 残すものは次のとおり。
  *
@@ -37,7 +37,7 @@ const KEEP = new Set([
 ]);
 const DESC_CA = 0x09;
 /**
- * PMT を読むまで取っておくパケットの数の上限。**選局したての頭を捨てない** (`ServiceFilter.filter`)。
+ * PMT を読むまで取っておくパケットの数の上限。**選局したての先頭を捨てない** (`ServiceFilter.filter`)。
  *
  * PAT と PMT はそれぞれ 100ms ごとに来るので、待つのはふつう 0.2 秒まで。地上波 (17Mbit/s) なら 2,300 個、
  * BS の中継丸ごと (52Mbit/s) でも 7,000 個ほど。来ない (局を読み違えた) ときに抱え込み続けないよう、超えたら古いほうから捨てる
@@ -104,7 +104,7 @@ export class ServiceFilter {
     tsid = null;
     copyNeverNow = false;
     streamsNow = null;
-    /** PMT を読む前に届いた、局の分からないパケット (写したもの)。届いた順 */
+    /** PMT を読む前に届いた、局の分からないパケット (コピーしたもの)。届いた順 */
     held = [];
     constructor(serviceId) {
         this.serviceId = serviceId;
@@ -137,10 +137,10 @@ export class ServiceFilter {
     /**
      * **中継の番号 (transport_stream_id)。** PAT を読むまでは null。
      *
-     * 絞るのに要るわけではありません。**データ放送が受信機に訊いてくる**ので
-     * 覚えておきます。テレ朝の TVer リンクは `browser.getProgramID(4)` で
-     * これを取り、TVer のサーバへそのまま送る。`null` のまま渡すと文字の
-     * "null" が飛んで、あちらが断り、画面には `DT-RE` とだけ出ます
+     * 絞るのに要るわけではない。**データ放送が受信機に訊いてくる**ので
+     * 覚えておく。テレ朝の 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() {
@@ -182,7 +182,7 @@ export class ServiceFilter {
         }
         return concatBytes(out);
     }
-    /** PMT を読む前のパケットを取っておく。**写す** (パケットは届いた塊の上の窓。`PacketStream`) */
+    /** PMT を読む前のパケットを取っておく。**コピーする** (パケットは届いたチャンクの一部を指す。`PacketStream`) */
     hold(ts) {
         this.held.push(ts.slice());
         // 溢れたら古い半分を捨てる (1 つずつ捨てると、来ないあいだずっと詰め直すことになる)
@@ -254,7 +254,7 @@ export class ServiceFilter {
  */
 export class StreamsWatch {
     seen = null;
-    /** `filter` に塊を通したあとに呼ぶ */
+    /** `filter` にチャンクを通したあとに呼ぶ */
     changed(filter) {
         const now = filter.streams;
         if (now === null)

package/dist/synth-av.d.ts

@@ -12,14 +12,14 @@
  * - 音声 … 48kHz ステレオの AAC-LC の**無音**を ADTS で。1 コマ 7 バイト
  *
  * 規格は ISO/IEC 13818-2 (映像) と 13818-7 / 14496-3 (AAC)。表の出どころは
- * 各関数の頭に書いてある。
+ * 各関数の冒頭に書いてある。
  */
 /** 29.97 コマ/秒の 1 コマ (90kHz)。放送と同じ */
 export declare const FRAME_TICKS = 3003;
 /** AAC の 1 コマ (1024 標本 @48kHz を 90kHz で) */
 export declare const AUDIO_TICKS = 1920;
 /**
- * I フレームを 1 枚。**毎枚、系列ヘッダから書く。** どこから受け取っても頭からデコードできる
+ * I フレームを 1 枚。**毎枚、系列ヘッダから書く。** どこから受け取っても先頭からデコードできる
  * (放送は GOP ごとに書く。試験ではその手間を省く)。
  *
  * @param n 何枚目か。色と time_code に使う
@@ -27,21 +27,21 @@ 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)
  */
 export declare function silentAac(): Uint8Array;
 /**
- * PES にする。映像は長さ 0 (「次の頭まで」。放送もそう書く)、音声は長さを書く
+ * PES にする。映像は長さ 0 (「次の PES の先頭まで」。放送もそう書く)、音声は長さを書く
  *
  * @param streamId 0xE0 (映像) / 0xC0 (音声) / 0xBD (字幕。`synth-caption.ts`)
  */
 export declare function pes(streamId: number, pts: number, data: Uint8Array): Uint8Array;
 /**
  * PES を TS パケットに割る。**最後のパケットは適応フィールドで詰める** (中身を 0xFF で
- * 埋めると PES の続きに見える)。頭のパケットに PCR を載せることもできる
+ * 埋めると PES の続きに見える)。最初のパケットに PCR を載せることもできる
  *
  * @param counter 連続性カウンタの続き。返り値の `counter` を次に渡す
  */

package/dist/synth-av.js

@@ -12,7 +12,7 @@
  * - 音声 … 48kHz ステレオの AAC-LC の**無音**を ADTS で。1 コマ 7 バイト
  *
  * 規格は ISO/IEC 13818-2 (映像) と 13818-7 / 14496-3 (AAC)。表の出どころは
- * 各関数の頭に書いてある。
+ * 各関数の冒頭に書いてある。
  */
 import { concatBytes } from "./bytes.js";
 import { PACKET, SYNC } from "./psi.js";
@@ -96,7 +96,7 @@ function colorAt(col, row, n, field) {
     return [y, 96 + ((row * 16) % 64), 160 - ((col * 4) % 64)];
 }
 /**
- * I フレームを 1 枚。**毎枚、系列ヘッダから書く。** どこから受け取っても頭からデコードできる
+ * I フレームを 1 枚。**毎枚、系列ヘッダから書く。** どこから受け取っても先頭からデコードできる
  * (放送は GOP ごとに書く。試験ではその手間を省く)。
  *
  * @param n 何枚目か。色と time_code に使う
@@ -162,7 +162,7 @@ export function mpeg2Frame(n, color = colorAt) {
     bits.put(0, 1); // progressive_frame = 0
     bits.put(0, 1); // composite_display_flag
     for (let row = 0; row < mbHeight; row++) {
-        // 1 行を 1 スライスに。予測は行の頭で 128 に戻る (7.2.1)
+        // 1 行を 1 スライスに。予測は行の先頭で 128 に戻る (7.2.1)
         bits.startCode(row + 1);
         bits.put(8, 5); // quantiser_scale_code (DC だけなので効かない)
         bits.put(0, 1); // extra_bit_slice
@@ -187,7 +187,7 @@ export function mpeg2Frame(n, color = colorAt) {
     return bits.bytes();
 }
 /**
- * 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)
@@ -224,7 +224,7 @@ export function silentAac() {
     head.put(0, 2); // number_of_raw_data_blocks - 1
     return Uint8Array.from([...head.bytes(), ...payload]);
 }
-/** PTS/DTS の 5 バイト (2.4.3.7)。頭の 4 ビットは '0010' (PTS だけ) */
+/** PTS/DTS の 5 バイト (2.4.3.7)。先頭の 4 ビットは '0010' (PTS だけ) */
 function stamp(pts) {
     const value = pts % 2 ** 33;
     const high = Math.floor(value / 2 ** 30) & 0x07;
@@ -239,7 +239,7 @@ function stamp(pts) {
     ];
 }
 /**
- * PES にする。映像は長さ 0 (「次の頭まで」。放送もそう書く)、音声は長さを書く
+ * PES にする。映像は長さ 0 (「次の PES の先頭まで」。放送もそう書く)、音声は長さを書く
  *
  * @param streamId 0xE0 (映像) / 0xC0 (音声) / 0xBD (字幕。`synth-caption.ts`)
  */
@@ -259,7 +259,7 @@ export function pes(streamId, pts, data) {
 }
 /**
  * PES を TS パケットに割る。**最後のパケットは適応フィールドで詰める** (中身を 0xFF で
- * 埋めると PES の続きに見える)。頭のパケットに PCR を載せることもできる
+ * 埋めると PES の続きに見える)。最初のパケットに PCR を載せることもできる
  *
  * @param counter 連続性カウンタの続き。返り値の `counter` を次に渡す
  */
@@ -271,7 +271,7 @@ export function packetizePes(pid, data, counter, pcr = null) {
         const withPcr = at === 0 && pcr !== null;
         const rest = data.length - at;
         /*
-         * 適応フィールドの長さ。PCR を載せるなら旗 1 バイト + 6 バイト。**中身が
+         * 適応フィールドの長さ。PCR を載せるならフラグ 1 バイト + 6 バイト。**中身が
          * 足りないときもここを伸ばして詰める** (中身を 0xFF で埋めると PES の続きに見える)
          */
         const least = withPcr ? 7 : 0;

package/dist/synth-caption.d.ts

@@ -30,7 +30,7 @@ export declare function text(body: number[], language?: number): Uint8Array;
  */
 export declare function drcsUnit(code: number, rows: string[]): number[];
 /**
- * ffmpeg が `-c:s copy -f matroska` で書くのと同じ骨組みの Matroska (トラック 1 本・コマごとに塊 1 つ)。
+ * ffmpeg が `-c:s copy -f matroska` で書くのと同じ骨組みの Matroska (トラック 1 本・コマごとに SimpleBlock 1 つ)。
  * 中身は字幕の PES の中身 (`text(...)` など) をそのまま入れる
  *
  * @param frames [時刻 (ミリ秒。65535 まで), 中身] の並び

package/dist/synth-caption.js

@@ -100,7 +100,7 @@ function element(id, body) {
     return [...id, 0x01, 0, 0, 0, (size >>> 24) & 0xff, ...u24(size), ...body];
 }
 /**
- * ffmpeg が `-c:s copy -f matroska` で書くのと同じ骨組みの Matroska (トラック 1 本・コマごとに塊 1 つ)。
+ * ffmpeg が `-c:s copy -f matroska` で書くのと同じ骨組みの Matroska (トラック 1 本・コマごとに SimpleBlock 1 つ)。
  * 中身は字幕の PES の中身 (`text(...)` など) をそのまま入れる
  *
  * @param frames [時刻 (ミリ秒。65535 まで), 中身] の並び

package/dist/synth.d.ts

@@ -2,17 +2,17 @@
  * TS のセクションを組み立てる。
  *
  * 実チューナーが無いので、解析のテストにも偽エージェントにも「それらしい TS」が要る。
- * 読む側 (psi.ts・eit.ts・dsmcc.ts・ait.ts、denpa の logo.ts など) と対になる書く側で、ここだけが仕様の写し。
+ * 読む側 (psi.ts・eit.ts・dsmcc.ts・ait.ts、denpa の logo.ts など) と対になる書く側で、仕様を書き写しているのはここだけ。
  */
 import { withCrc } from "./psi.js";
 export { withCrc };
-/** 表のバージョンと、何本に分けたうちのどれか。指定しなければバージョン 0・節 0/0 */
+/** 表のバージョンと、何本に分けたうちのどれか。指定しなければバージョン 0・セクション 0/0 */
 export interface SectionPart {
     version?: number;
     sectionNumber?: number;
     lastSectionNumber?: number;
 }
-/** PCR の基準部 (90kHz) を適応フィールドに書く (旗は呼ぶ側)。拡張部 (27MHz の端数) は読む側が見ていないので 0 */
+/** PCR の基準部 (90kHz) を適応フィールドに書く (フラグは呼ぶ側が立てる)。拡張部 (27MHz の端数) は読む側が見ていないので 0 */
 export declare function putPcr(packet: Uint8Array, pcr: number): void;
 /**
  * 文字列を ARIB STD-B24 の 8 単位符号にする。
@@ -113,9 +113,9 @@ options?: SectionPart & {
 export declare function satelliteDeliveryDescriptor(frequency: number, symbolRate?: number): number[];
 /** 地上の分配の記述子 (0xFA)。周波数は Hz で渡す (1/7 MHz 単位に丸める) */
 export declare function terrestrialDeliveryDescriptor(areaCode: number, frequencies: number[]): number[];
-/** セクションを TS パケットに詰める。頭のパケットには pointer_field が付く */
+/** セクションを TS パケットに詰める。最初のパケットには pointer_field が付く */
 export declare function packetize(pid: number, section: Uint8Array, counter?: number): Uint8Array;
-/** 部品を 1 本のバイト列に繋ぐ。組んだパケットを流し込むときの糊 */
+/** 部品を 1 本のバイト列に繋ぐ。組んだパケットを流し込むときに使う */
 export declare function stream(...parts: Uint8Array[]): Uint8Array;
 /** PCR を 1 つ運ぶだけのパケット */
 export declare function pcrPacket(pid: number, seconds: number, counter?: number): Uint8Array;
@@ -124,7 +124,7 @@ export declare function tdtPacket(unixMs: number): Uint8Array;
 /** PAT。サービス ID → PMT の PID */
 export declare function patSection(programs: [number, number][], transportStreamId?: number): Uint8Array;
 /**
- * PMT。ロゴのカルーセルが乗る ES を 1 つだけ持たせる。
+ * PMT。ロゴのカルーセルを運ぶ ES を 1 つだけ持たせる。
  * 目印は stream_identifier_descriptor (0x52) の component_tag
  */
 export declare function pmtSection(serviceId: number, esPid: number, componentTag: number): Uint8Array;
@@ -198,11 +198,11 @@ export declare const BML_TS: {
 };
 /** BML の ES が 1 本だけ載った PMT (`BML_TS` の割り振り) */
 export declare function bmlPmt(): Uint8Array;
-/** PAT と PMT。データ放送のストリームの頭 */
+/** PAT と PMT。データ放送のストリームの先頭 */
 export declare function bmlHead(): Uint8Array[];
 /**
  * モジュール 1 つぶんの中身。**放送は multipart/mixed で複数のファイルを詰める。**
- * 本物と同じく、頭に Content-Type、境界で区切って各ファイルに Content-Location
+ * 本物と同じく、先頭に Content-Type、境界で区切って各ファイルに Content-Location
  */
 export declare function multipartModule(files: [location: string, type: string, body: string][]): Uint8Array;
 /** PMT の ES に付ける application_signalling_descriptor (0x6F)。**AIT の在り処の印** */
@@ -213,7 +213,7 @@ export interface SynthHybridcastApp {
     /** `CONTROL` の値。既定は autostart */
     controlCode?: number;
     name?: string;
-    /** URL の頭。**通信路で運ぶもの** (protocol_id = 3) として入れる */
+    /** URL の先頭部分。**通信路で運ぶもの** (protocol_id = 3) として入れる */
     base?: string;
     /** その先のパス */
     path?: string;
@@ -221,6 +221,6 @@ export interface SynthHybridcastApp {
 /**
  * AIT (table_id 0x74)。**Hybridcast のアプリのアドレス (URL) が載っている表。**
  *
- * 中身そのものは電波に乗っていないので、ここに入るのは URL と名前だけ
+ * アプリそのものは放送では送られていないので、ここに入るのは URL と名前だけ
  */
 export declare function aitSection(applications: SynthHybridcastApp[], applicationType?: number): Uint8Array;