@danything/arib 1.3.0 → 2.0.0

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;

package/dist/synth.js

@@ -2,7 +2,7 @@
  * 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 { joinBytes } from "./bytes.js";
 import { PACKET, SYNC, withCrc } from "./psi.js";
@@ -10,7 +10,7 @@ import { PACKET, SYNC, withCrc } from "./psi.js";
 export { withCrc };
 const be = (value) => [(value >> 8) & 0xff, value & 0xff];
 const be32 = (value) => [...be(value >>> 16), ...be(value & 0xffff)];
-/** セクションの頭 8 バイト (長さは `withCrc` が埋める) */
+/** セクションの先頭 8 バイト (長さは `withCrc` が埋める) */
 function head(tableId, extension, part = {}) {
     return [
         tableId,
@@ -22,7 +22,7 @@ function head(tableId, extension, part = {}) {
         part.lastSectionNumber ?? 0,
     ];
 }
-/** PCR の基準部 (90kHz) を適応フィールドに書く (旗は呼ぶ側)。拡張部 (27MHz の端数) は読む側が見ていないので 0 */
+/** PCR の基準部 (90kHz) を適応フィールドに書く (フラグは呼ぶ側が立てる)。拡張部 (27MHz の端数) は読む側が見ていないので 0 */
 export function putPcr(packet, pcr) {
     const base = Math.round(pcr) % 2 ** 33;
     packet[6] = Math.floor(base / 2 ** 25) & 0xff;
@@ -96,7 +96,7 @@ function encodeSiText(text) {
 }
 /** 言語の符号 "jpn" (ISO 639-2) */
 const JPN = [0x6a, 0x70, 0x6e];
-/** 長さ 1 バイトを頭に付けた文字列。SI の記述子はどこもこの形式 */
+/** 長さ 1 バイトを先頭に付けた文字列。SI の記述子はどこもこの形式 */
 const sized = (text) => {
     const body = encodeSiText(text);
     return [body.length, ...body];
@@ -305,7 +305,7 @@ export function terrestrialDeliveryDescriptor(areaCode, frequencies) {
     ];
     return [0xfa, body.length, ...body];
 }
-/** セクションを TS パケットに詰める。頭のパケットには pointer_field が付く */
+/** セクションを TS パケットに詰める。最初のパケットには pointer_field が付く */
 export function packetize(pid, section, counter = 0) {
     const packets = [];
     let data = [0x00, ...section]; // pointer_field = 0
@@ -320,7 +320,7 @@ export function packetize(pid, section, counter = 0) {
     }
     return Uint8Array.from(packets);
 }
-/** 部品を 1 本のバイト列に繋ぐ。組んだパケットを流し込むときの糊 */
+/** 部品を 1 本のバイト列に繋ぐ。組んだパケットを流し込むときに使う */
 export function stream(...parts) {
     return joinBytes(parts);
 }
@@ -350,7 +350,7 @@ export function patSection(programs, transportStreamId = 1) {
     return withCrc(body);
 }
 /**
- * PMT。ロゴのカルーセルが乗る ES を 1 つだけ持たせる。
+ * PMT。ロゴのカルーセルを運ぶ ES を 1 つだけ持たせる。
  * 目印は stream_identifier_descriptor (0x52) の component_tag
  */
 export function pmtSection(serviceId, esPid, componentTag) {
@@ -538,7 +538,7 @@ export function bmlPmt() {
         ],
     ]);
 }
-/** PAT と PMT。データ放送のストリームの頭 */
+/** PAT と PMT。データ放送のストリームの先頭 */
 export function bmlHead() {
     return [
         packetize(0x0000, patSection([[BML_TS.service, BML_TS.pmtPid]])),
@@ -547,7 +547,7 @@ export function bmlHead() {
 }
 /**
  * モジュール 1 つぶんの中身。**放送は multipart/mixed で複数のファイルを詰める。**
- * 本物と同じく、頭に Content-Type、境界で区切って各ファイルに Content-Location
+ * 本物と同じく、先頭に Content-Type、境界で区切って各ファイルに Content-Location
  */
 export function multipartModule(files) {
     const boundary = "denpa";
@@ -565,7 +565,7 @@ export function aitSignallingDescriptor(applicationType = 0x0010, version = 1) {
 /**
  * AIT (table_id 0x74)。**Hybridcast のアプリのアドレス (URL) が載っている表。**
  *
- * 中身そのものは電波に乗っていないので、ここに入るのは URL と名前だけ
+ * アプリそのものは放送では送られていないので、ここに入るのは URL と名前だけ
  */
 export function aitSection(applications, applicationType = 0x0010) {
     const loop = [];
@@ -578,7 +578,7 @@ export function aitSection(applications, applicationType = 0x0010) {
         }
         if (app.base !== undefined) {
             const base = [...new TextEncoder().encode(app.base)];
-            // transport_protocol_descriptor: protocol_id=3 (通信路)、label、URL の頭
+            // transport_protocol_descriptor: protocol_id=3 (通信路)、label、URL の先頭部分
             info.push(0x02, 5 + base.length, ...be(0x0003), 0x01, base.length, ...base, 0x00);
         }
         if (app.path !== undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danything/arib",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "description": "日本のデジタル放送 (ARIB) の TS を読む: PSI・PES・EIT・ARIB の文字・字幕・データ放送",
   "license": "MIT",
   "repository": {