@danything/arib 0.0.0-stage → 0.1.0

package/dist/synth-av.js

@@ -0,0 +1,298 @@
+/**
+ * **本物の MPEG-2 映像と AAC 音声を、ffmpeg 無しで組み立てる** (試験用)。
+ *
+ * ライブを変換せずに送る経路 (docs/stream.md#放送そのままmpeg-2を送る) は、ブラウザが MPEG-2 をデコードして映像を出す
+ * ところまでが仕事で、そこを試すには**本当にデコードできる放送**が要る。偽エージェントの
+ * 放送は中身を 0xFF で埋めていて、デコードするものが無い。E2E のイメージには本物の ffmpeg も
+ * 入っていない (数十分かかる組み立てを避けている) ので、ここで小さく作る。
+ *
+ * - 映像 … 256x144 の**I フレームだけ**。マクロブロックごとに色 (DC) だけを置き、
+ *   AC は持たない (EOB だけ)。コマごとに縞が流れるので、**映像が進んでいるか**を
+ *   画素で見分けられる。インタレの印も立て、輝度は上下のフィールドで別の時刻の映像にする (フィールド DCT)
+ * - 音声 … 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";
+import { putPcr } from "./synth.js";
+/** 29.97 コマ/秒の1コマ (90kHz)。放送と同じ */
+export const FRAME_TICKS = 3003;
+/** AAC の1コマ (1024 標本 @48kHz を 90kHz で) */
+export const AUDIO_TICKS = 1920;
+/** 映像の大きさ。**16 の倍数** (マクロブロックで割り切る) */
+const WIDTH = 256;
+const HEIGHT = 144;
+class Bits {
+    out = [];
+    acc = 0;
+    used = 0;
+    put(value, width) {
+        for (let i = width - 1; i >= 0; i--) {
+            this.acc = (this.acc << 1) | ((value >>> i) & 1);
+            if (++this.used === 8) {
+                this.out.push(this.acc);
+                this.acc = 0;
+                this.used = 0;
+            }
+        }
+    }
+    /** 0 で詰めてバイトの切れ目に揃える (next_start_code / byte_alignment) */
+    align() {
+        if (this.used > 0)
+            this.put(0, 8 - this.used);
+    }
+    startCode(code) {
+        this.align();
+        this.out.push(0x00, 0x00, 0x01, code);
+    }
+    bytes() {
+        this.align();
+        return Uint8Array.from(this.out);
+    }
+}
+/** dct_dc_size の符号 (表 B-12 輝度 / B-13 色差)。`[符号, 長さ]` */
+const DC_LUMA = [
+    [0b100, 3],
+    [0b00, 2],
+    [0b01, 2],
+    [0b101, 3],
+    [0b110, 3],
+    [0b1110, 4],
+    [0b11110, 5],
+    [0b111110, 6],
+    [0b1111110, 7],
+];
+const DC_CHROMA = [
+    [0b00, 2],
+    [0b01, 2],
+    [0b10, 2],
+    [0b110, 3],
+    [0b1110, 4],
+    [0b11110, 5],
+    [0b111110, 6],
+    [0b1111110, 7],
+    [0b11111110, 8],
+];
+/** 1ブロック。**DC の差分だけ書いて、すぐ EOB** (表 B-14 の '10') */
+function block(bits, diff, table) {
+    const size = diff === 0 ? 0 : Math.floor(Math.log2(Math.abs(diff))) + 1;
+    const [code, length] = table[size];
+    bits.put(code, length);
+    // 負の差分は「足して (2^size − 1)」を書く (7.2.1)
+    if (size > 0)
+        bits.put(diff > 0 ? diff : diff + (1 << size) - 1, size);
+    bits.put(0b10, 2);
+}
+/**
+ * n コマ目の色 (Y, Cb, Cr)。**列と時刻で縞を流す** — 進んでいれば画素が変わる。
+ * 輝度は**フィールドごとの時刻で**流す (下のフィールドは上の 1/59.94 秒後の位置)。フィールドごとに
+ * 出せているか (bob) と、出す間合いを画素で見分けられる。1フィールドで 16 進み、30 コマ (60 フィールド)
+ * でちょうど一周するので、偽の放送が 30 コマを繰り返しても段差が出ない
+ */
+function colorAt(col, row, n, field) {
+    const y = 32 + ((col * 12 + (2 * n + field) * 16) % 192);
+    return [y, 96 + ((row * 16) % 64), 160 - ((col * 4) % 64)];
+}
+/**
+ * I フレームを1枚。**毎枚、系列ヘッダから書く** — どこから受け取っても頭からデコードできる
+ * (放送は GOP ごとに書く。試験ではその手間を省く)。
+ *
+ * @param n 何枚目か。色と time_code に使う
+ * @param color マクロブロック (16x16) ごとの色。既定は流れる縞 (スクリーンショットを撮るときはカラーバー。`tests/fake/docs.ts`)
+ */
+export function mpeg2Frame(n, color = colorAt) {
+    const bits = new Bits();
+    const mbWidth = WIDTH / 16;
+    const mbHeight = HEIGHT / 16;
+    // sequence_header (6.2.2.1)。16:9、29.97、intra/non-intra の量子化表は既定
+    bits.startCode(0xb3);
+    bits.put(WIDTH, 12);
+    bits.put(HEIGHT, 12);
+    bits.put(3, 4); // aspect_ratio_information = 16:9
+    bits.put(4, 4); // frame_rate_code = 30000/1001
+    bits.put(0x3ffff, 18); // bit_rate_value
+    bits.put(1, 1); // marker
+    bits.put(112, 10); // vbv_buffer_size_value
+    bits.put(0, 3); // constrained / load_intra / load_non_intra
+    // sequence_extension (6.2.2.3)。Main@Main、4:2:0、インタレ系列、B 無し
+    bits.startCode(0xb5);
+    bits.put(1, 4);
+    bits.put(0x48, 8);
+    bits.put(0, 1); // progressive_sequence = 0 (インタレ)
+    bits.put(1, 2); // chroma_format = 4:2:0
+    bits.put(0, 4); // horizontal / vertical_size_extension
+    bits.put(0, 12); // bit_rate_extension
+    bits.put(1, 1); // marker
+    bits.put(0, 8); // vbv_buffer_size_extension
+    bits.put(1, 1); // low_delay
+    bits.put(0, 7); // frame_rate_extension_n / _d
+    // group_of_pictures_header (6.2.2.6)。閉じた GOP
+    bits.startCode(0xb8);
+    const seconds = Math.floor(n / 30);
+    bits.put(0, 1); // drop_frame_flag
+    bits.put(Math.floor(seconds / 3600) % 24, 5);
+    bits.put(Math.floor(seconds / 60) % 60, 6);
+    bits.put(1, 1); // marker
+    bits.put(seconds % 60, 6);
+    bits.put(n % 30, 6);
+    bits.put(1, 1); // closed_gop
+    bits.put(0, 1); // broken_link
+    // picture_header (6.2.3)
+    bits.startCode(0x00);
+    bits.put(0, 10); // temporal_reference (GOP ごとに1枚なので 0)
+    bits.put(1, 3); // picture_coding_type = I
+    bits.put(0xffff, 16); // vbv_delay
+    bits.put(0, 1); // extra_bit_picture
+    // picture_coding_extension (6.2.3.1)。フレーム構造・上が先・インタレのコマ
+    bits.startCode(0xb5);
+    bits.put(8, 4);
+    bits.put(0xffff, 16); // f_code (I では使わない = 15)
+    bits.put(0, 2); // intra_dc_precision = 8bit
+    bits.put(3, 2); // picture_structure = frame
+    bits.put(1, 1); // top_field_first
+    bits.put(0, 1); // frame_pred_frame_dct = 0 (マクロブロックごとに dct_type を書く。フィールドで分ける)
+    bits.put(0, 1); // concealment_motion_vectors
+    bits.put(0, 1); // q_scale_type
+    bits.put(0, 1); // intra_vlc_format
+    bits.put(0, 1); // alternate_scan
+    bits.put(0, 1); // repeat_first_field
+    bits.put(0, 1); // chroma_420_type
+    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)
+        bits.startCode(row + 1);
+        bits.put(8, 5); // quantiser_scale_code (DC だけなので効かない)
+        bits.put(0, 1); // extra_bit_slice
+        const predictor = [128, 128, 128];
+        for (let col = 0; col < mbWidth; col++) {
+            bits.put(1, 1); // macroblock_address_increment = 1
+            bits.put(1, 1); // macroblock_type = intra
+            bits.put(1, 1); // dct_type = 1 (フィールド DCT: 輝度の上2ブロックが上のフィールド、下2つが下)
+            const [top, cb, cr] = color(col, row, n, 0);
+            const [bottom] = color(col, row, n, 1);
+            for (let i = 0; i < 4; i++) {
+                const y = i < 2 ? top : bottom;
+                block(bits, y - predictor[0], DC_LUMA);
+                predictor[0] = y;
+            }
+            block(bits, cb - predictor[1], DC_CHROMA);
+            predictor[1] = cb;
+            block(bits, cr - predictor[2], DC_CHROMA);
+            predictor[2] = cr;
+        }
+    }
+    return bits.bytes();
+}
+/**
+ * AAC-LC の無音を1コマ、ADTS の頭付きで。48kHz・ステレオ (channel_configuration 2)。
+ *
+ * 中身は CPE が1つ: 両耳とも `max_sfb = 0` (係数を1つも持たない) で、あとは END。
+ * 55 ビットなので7バイトに収まる (14496-3 の raw_data_block)
+ */
+export function silentAac() {
+    const body = new Bits();
+    body.put(1, 3); // id_syn_ele = CPE
+    body.put(0, 4); // element_instance_tag
+    body.put(0, 1); // common_window
+    for (let ch = 0; ch < 2; ch++) {
+        body.put(100, 8); // global_gain
+        body.put(0, 1); // ics_reserved_bit
+        body.put(0, 2); // window_sequence = ONLY_LONG
+        body.put(0, 1); // window_shape
+        body.put(0, 6); // max_sfb = 0
+        body.put(0, 1); // predictor_data_present
+        body.put(0, 3); // pulse / tns / gain_control
+    }
+    body.put(7, 3); // END
+    const payload = body.bytes();
+    const head = new Bits();
+    const length = 7 + payload.length;
+    head.put(0xfff, 12);
+    head.put(0, 1); // ID = MPEG-4
+    head.put(0, 2); // layer
+    head.put(1, 1); // protection_absent
+    head.put(1, 2); // profile = LC
+    head.put(3, 4); // sampling_frequency_index = 48kHz
+    head.put(0, 1);
+    head.put(2, 3); // channel_configuration
+    head.put(0, 4);
+    head.put(length, 13);
+    head.put(0x7ff, 11); // buffer fullness = VBR
+    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 だけ) */
+function stamp(pts) {
+    const value = pts % 2 ** 33;
+    const high = Math.floor(value / 2 ** 30) & 0x07;
+    const mid = Math.floor(value / 2 ** 15) & 0x7fff;
+    const low = value & 0x7fff;
+    return [
+        0x21 | (high << 1),
+        mid >> 7,
+        ((mid & 0x7f) << 1) | 1,
+        low >> 7,
+        ((low & 0x7f) << 1) | 1,
+    ];
+}
+/**
+ * PES にする。映像は長さ 0 (「次の頭まで」。放送もそう書く)、音声は長さを書く
+ *
+ * @param streamId 0xE0 (映像) / 0xC0 (音声)
+ */
+export function pes(streamId, pts, data) {
+    const header = [0x80, 0x80, 5, ...stamp(pts)];
+    const length = streamId >= 0xe0 ? 0 : header.length + data.length;
+    return Uint8Array.from([
+        0x00,
+        0x00,
+        0x01,
+        streamId,
+        length >> 8,
+        length & 0xff,
+        ...header,
+        ...data,
+    ]);
+}
+/**
+ * PES を TS パケットに割る。**最後のパケットは適応フィールドで詰める** (中身を 0xFF で
+ * 埋めると PES の続きに見える)。頭のパケットに PCR を載せることもできる
+ *
+ * @param counter 連続性カウンタの続き。返り値の `counter` を次に渡す
+ */
+export function packetizePes(pid, data, counter, pcr = null) {
+    const out = [];
+    let at = 0;
+    while (at < data.length) {
+        const packet = new Uint8Array(PACKET).fill(0xff);
+        const withPcr = at === 0 && pcr !== null;
+        const rest = data.length - at;
+        /*
+         * 適応フィールドの長さ。PCR を載せるなら旗1バイト + 6バイト。**中身が
+         * 足りないときもここを伸ばして詰める** (中身を 0xFF で埋めると PES の続きに見える)
+         */
+        const least = withPcr ? 7 : 0;
+        const adapted = withPcr || rest < PACKET - 4;
+        const take = adapted ? Math.min(rest, PACKET - 5 - least) : PACKET - 4;
+        packet[0] = SYNC;
+        packet[1] = (at === 0 ? 0x40 : 0) | ((pid >> 8) & 0x1f);
+        packet[2] = pid & 0xff;
+        packet[3] = (adapted ? 0x30 : 0x10) | (counter & 0x0f);
+        if (adapted) {
+            const length = PACKET - 5 - take;
+            packet[4] = length;
+            if (length > 0)
+                packet[5] = withPcr ? 0x10 : 0x00;
+            if (withPcr)
+                putPcr(packet, pcr);
+        }
+        packet.set(data.subarray(at, at + take), PACKET - take);
+        at += take;
+        counter = (counter + 1) & 0x0f;
+        out.push(packet);
+    }
+    return { packets: concatBytes(out), counter };
+}

package/dist/synth-caption.d.ts

@@ -0,0 +1,38 @@
+/**
+ * **放送の字幕 (ARIB STD-B24) を組み立てる** (試験用)。読む側は [b24caption.ts](../../../packages/arib/src/b24caption.ts)。
+ *
+ * 出来るのは字幕の PES の中身 (データ識別 0x80 から) で、ffmpeg が `-c:s copy` で
+ * Matroska に入れたコマと同じ形式。TS に載せるなら `synth-av.ts` の `pes(0xbd, …)` で包む。
+ */
+import { encodeAribText } from "./synth.js";
+export { encodeAribText };
+/** データユニット。0x20 本文・0x30 1バイト DRCS・0x31 2バイト DRCS */
+export declare function unit(parameter: number, data: number[]): number[];
+/**
+ * 字幕管理データ。言語は `languages` (ISO 639 の3文字。既定は日本語1つ)・書式は `format` (SWF+1。既定 8 = 960x540 横書き)。
+ * 言語の順に第1言語・第2言語…になる (言語タグ 0, 1, …)
+ */
+export declare function management(options?: {
+    format?: number;
+    formats?: number[];
+    group?: number;
+    units?: number[];
+    languages?: string[];
+}): Uint8Array;
+/** 字幕文。`units` はデータユニットを並べたもの。本文だけなら `text(...)` を使う。`language` は第何言語か (1〜8) */
+export declare function statement(units: number[], language?: number): Uint8Array;
+/** 本文1つだけの字幕文 (`language` は第何言語か) */
+export declare function text(body: number[], language?: number): Uint8Array;
+/**
+ * 1バイト DRCS (DRCS-1 の面) の定義。`rows` は '#' を点にした図 (白黒)
+ *
+ * @param code 符号 (0x21〜0x7E)。呼び出すときは `ESC ( 0x20 0x41` で G0 に載せて、この符号を書く
+ */
+export declare function drcsUnit(code: number, rows: string[]): number[];
+/**
+ * ffmpeg が `-c:s copy -f matroska` で書くのと同じ骨組みの Matroska (トラック1本・コマごとに塊1つ)。
+ * 中身は字幕の PES の中身 (`text(...)` など) をそのまま入れる
+ *
+ * @param frames [時刻 (ミリ秒。65535 まで), 中身] の並び
+ */
+export declare function captionMkv(frames: [ms: number, data: Uint8Array][], codec?: string): Uint8Array;

package/dist/synth-caption.js

@@ -0,0 +1,115 @@
+/**
+ * **放送の字幕 (ARIB STD-B24) を組み立てる** (試験用)。読む側は [b24caption.ts](../../../packages/arib/src/b24caption.ts)。
+ *
+ * 出来るのは字幕の PES の中身 (データ識別 0x80 から) で、ffmpeg が `-c:s copy` で
+ * Matroska に入れたコマと同じ形式。TS に載せるなら `synth-av.ts` の `pes(0xbd, …)` で包む。
+ */
+import { encodeAribText } from "./synth.js";
+export { encodeAribText };
+/** CRC-16 (ITU-T。データグループの末尾) */
+function crc16(data) {
+    let crc = 0;
+    for (const byte of data) {
+        crc ^= byte << 8;
+        for (let i = 0; i < 8; i++)
+            crc = crc & 0x8000 ? ((crc << 1) ^ 0x1021) & 0xffff : (crc << 1) & 0xffff;
+    }
+    return crc;
+}
+const u24 = (n) => [(n >> 16) & 0xff, (n >> 8) & 0xff, n & 0xff];
+/** データユニット。0x20 本文・0x30 1バイト DRCS・0x31 2バイト DRCS */
+export function unit(parameter, data) {
+    return [0x1f, parameter, ...u24(data.length), ...data];
+}
+/** データグループで包んで PES の中身にする。`id` は 0 (管理) / 1〜8 (第何言語か)、`group` は 0 (A) / 1 (B) */
+function dataGroup(id, group, body) {
+    const groupId = (group << 5) | id;
+    const head = [
+        groupId << 2,
+        0x00,
+        0x00,
+        (body.length >> 8) & 0xff,
+        body.length & 0xff,
+        ...body,
+    ];
+    const crc = crc16(head);
+    // データ識別 0x80 / 私的ストリーム識別 0xFF / PES データパケットヘッダ長 0 (上位は予約で 1)
+    return Uint8Array.from([0x80, 0xff, 0xf0, ...head, crc >> 8, crc & 0xff]);
+}
+/**
+ * 字幕管理データ。言語は `languages` (ISO 639 の3文字。既定は日本語1つ)・書式は `format` (SWF+1。既定 8 = 960x540 横書き)。
+ * 言語の順に第1言語・第2言語…になる (言語タグ 0, 1, …)
+ */
+export function management(options = {}) {
+    const { format = 8, formats = [], group = 0, units = [], languages = ["jpn"], } = options;
+    const body = [
+        0x3f, // TMD 00 (自由)
+        languages.length, // 言語の数
+        ...languages.flatMap((code, tag) => [
+            (tag << 5) | 0x10, // 言語タグ / DMF 0000 (予約ビット 1)
+            ...[...code].map((c) => c.charCodeAt(0)),
+            ((formats[tag] ?? format) << 4) | 0x00, // 書式 (言語ごと。`formats` で替えられる) / TCS 0 (8単位符号) / ロールアップ無し
+        ]),
+        ...u24(units.length),
+        ...units,
+    ];
+    return dataGroup(0, group, body);
+}
+/** 字幕文。`units` はデータユニットを並べたもの。本文だけなら `text(...)` を使う。`language` は第何言語か (1〜8) */
+export function statement(units, language = 1) {
+    return dataGroup(language, 0, [0x3f, ...u24(units.length), ...units]);
+}
+/** 本文1つだけの字幕文 (`language` は第何言語か) */
+export function text(body, language = 1) {
+    return statement(unit(0x20, body), language);
+}
+/**
+ * 1バイト DRCS (DRCS-1 の面) の定義。`rows` は '#' を点にした図 (白黒)
+ *
+ * @param code 符号 (0x21〜0x7E)。呼び出すときは `ESC ( 0x20 0x41` で G0 に載せて、この符号を書く
+ */
+export function drcsUnit(code, rows) {
+    const height = rows.length;
+    const width = rows[0]?.length ?? 0;
+    const bits = [];
+    for (const row of rows)
+        for (const cell of row)
+            bits.push(cell === "#" ? 1 : 0);
+    const bytes = [];
+    for (let i = 0; i < bits.length; i += 8) {
+        let byte = 0;
+        for (let b = 0; b < 8; b++)
+            byte = (byte << 1) | (bits[i + b] ?? 0);
+        bytes.push(byte);
+    }
+    return unit(0x30, [
+        1, // 符号の数
+        0x41, // DRCS-1 の面 (上位) と
+        code, // 符号
+        1, // 字体の数
+        0x00, // 字体番号 0 / 方式 0000 (2階調)
+        0, // 階調 - 2
+        width,
+        height,
+        ...bytes,
+    ]);
+}
+/** EBML の要素1つ。大きさは8バイトで書く (読む側はどの長さでも読める) */
+function element(id, body) {
+    const size = body.length;
+    return [...id, 0x01, 0, 0, 0, (size >>> 24) & 0xff, ...u24(size), ...body];
+}
+/**
+ * ffmpeg が `-c:s copy -f matroska` で書くのと同じ骨組みの Matroska (トラック1本・コマごとに塊1つ)。
+ * 中身は字幕の PES の中身 (`text(...)` など) をそのまま入れる
+ *
+ * @param frames [時刻 (ミリ秒。65535 まで), 中身] の並び
+ */
+export function captionMkv(frames, codec = "S_ARIBSUB") {
+    const tracks = element([0x16, 0x54, 0xae, 0x6b], element([0xae], element([0x86], [...new TextEncoder().encode(codec)])));
+    const clusters = frames.flatMap(([ms, data]) => element([0x1f, 0x43, 0xb6, 0x75], [
+        ...element([0xe7], [(ms >> 8) & 0xff, ms & 0xff]),
+        ...element([0xa3], [0x81, 0x00, 0x00, 0x80, ...data]),
+    ]));
+    return Uint8Array.from(element([0x18, 0x53, 0x80, 0x67], [...tracks, ...clusters]));
+}

package/dist/synth.d.ts

@@ -0,0 +1,183 @@
+/**
+ * TS のセクションを組み立てる。
+ *
+ * 実チューナーが無いので、解析のテストにも偽エージェントにも「それらしい TS」が要る。
+ * 読む側 (psi.ts・eit.ts・dsmcc.ts・logo.ts・ait.ts など) と対になる書く側で、ここだけが仕様の写し。
+ */
+import { withCrc } from "./psi.js";
+export { withCrc };
+/** PCR の基準部 (90kHz) を適応フィールドに書く (旗は呼ぶ側)。拡張部 (27MHz の端数) は読む側が見ていないので 0 */
+export declare function putPcr(packet: Uint8Array, pcr: number): void;
+/**
+ * 文字列を ARIB STD-B24 の8単位符号にする。
+ *
+ * 初期状態 (G0=漢字) から始めて、ASCII のところだけ英数集合へ切り替える。
+ * 本物の放送はもっと凝った切り替え方をするが、**読む側が同じ経路を通れば足りる**。
+ * 文字の大きさは触らない (字幕は呼ぶ側が MSZ などを前に置く)。SI に書くなら `encodeSiText`
+ */
+export declare function encodeAribText(text: string, half?: boolean): number[];
+export declare function sdtSection(transportStreamId: number, originalNetworkId: number, services: [number, number, string?][]): Uint8Array;
+export interface SynthEvent {
+    eventId: number;
+    /** epoch ms */
+    startAt: number;
+    /** ms */
+    duration: number;
+    name: string;
+    description?: string;
+    extended?: Record<string, string>;
+    /**
+     * 記述子をそのまま足す。**実際の放送から取ったバイトを試験に使うため。**
+     * `extended` は文字列から組み立てるので、分割して送られてきたものや
+     * 文字集合の切り替えが混ざったものを再現できない
+     */
+    rawDescriptors?: number[];
+    genres?: [number, number][];
+    /** 音声。並べたぶんだけ audio_component_descriptor を積む */
+    audios?: SynthAudio[];
+    /** component_descriptor の [stream_content, component_type] */
+    video?: [number, number];
+    isFree?: boolean;
+    /** 4 = 放送中。EIT[p/f] で「いま」を表すのに使う */
+    runningStatus?: number;
+    /**
+     * デジタルコピー制御記述子の digital_recording_control_data (2ビット)。
+     * 3 がコピー禁止、2 が1世代のみ。省くと記述子を載せない ({@link copyControlDescriptor})
+     */
+    copyControl?: number;
+}
+/**
+ * デジタルコピー制御記述子 (0xC1)。EIT の番組と PMT に載る。
+ * 中身は1バイトだけ: 記録制御 (2) 最大ビットレートの有無 (1) 部品ごとの制御の有無 (1) 出力の制御 (4)
+ */
+export declare function copyControlDescriptor(control: number): number[];
+/** 音声1本ぶん。**放送が付けた名前まで持てる** (解説放送の見分けに要る) */
+interface SynthAudio {
+    /** audio_component_descriptor の component_type (3 = ステレオ) */
+    type: number;
+    /** ISO 639-2。省くと jpn */
+    lang?: string;
+    /** 「主音声ステレオ」「解説ステレオ」。省くと名乗らない */
+    text?: string;
+    /** 主音声か。省くと主音声 */
+    main?: boolean;
+}
+export interface EitOptions {
+    tableId: number;
+    serviceId: number;
+    transportStreamId: number;
+    originalNetworkId: number;
+    version?: number;
+    sectionNumber?: number;
+    lastSectionNumber?: number;
+    segmentLastSectionNumber?: number;
+    lastTableId?: number;
+    events: SynthEvent[];
+}
+/** EIT。番組表そのもの。table_id で p/f (0x4E) と schedule (0x50〜) が分かれる */
+export declare function eitSection(options: EitOptions): Uint8Array;
+export declare function nitSection(networkId: number, remoteControlKeyId: number | null, streams: [number, number, [number, number][]][]): Uint8Array;
+/** セクションを TS パケットに詰める。頭のパケットには pointer_field が付く */
+export declare function packetize(pid: number, section: Uint8Array, counter?: number): Uint8Array;
+/** 部品を1本のバイト列に繋ぐ。組んだパケットを流し込むときの糊 */
+export declare function stream(...parts: Uint8Array[]): Uint8Array;
+/** PCR を1つ運ぶだけのパケット */
+export declare function pcrPacket(pid: number, seconds: number, counter?: number): Uint8Array;
+/** 放送の実時刻 (TDT) を1パケットに。BML の `getCurrentDateTime` が見る */
+export declare function tdtPacket(unixMs: number): Uint8Array;
+/** PAT。サービスID → PMT の PID */
+export declare function patSection(programs: [number, number][], transportStreamId?: number): Uint8Array;
+/**
+ * PMT。ロゴのカルーセルが乗る ES を1つだけ持たせる。
+ * 目印は stream_identifier_descriptor (0x52) の component_tag
+ */
+export declare function pmtSection(serviceId: number, esPid: number, componentTag: number): Uint8Array;
+/**
+ * ふつうの PMT。映像・音声のような ES を並べる。
+ *
+ * ロゴ用の `pmtSection` と違って中身を選べる。局を選り分ける
+ * [service-filter.ts](../../../packages/arib/src/service-filter.ts) を試すのに要る
+ */
+export declare function programMap(serviceId: number, pcrPid: number, 
+/** `[種別, PID]`。**3つ目は記述子**の並び (字幕の部品タグなど) */
+streams: ([number, number] | [number, number, number[]])[], ecmPid?: number, 
+/** 番組ぜんたいに掛かる記述子 (program_info) に足すもの。コピー制御 ({@link copyControlDescriptor}) など */
+extra?: number[]): Uint8Array;
+/**
+ * データ符号化方式記述子 (0xFD)。**BML が載っている ES の目印。**
+ *
+ * 中身は「入口かどうか」と、カルーセルの回 (dataEventId)。
+ * 既定は地上波 (0x0C) の入口つき・960x540
+ */
+export declare function bxmlDescriptor(options?: {
+    dataComponentId?: number;
+    entryPoint?: boolean;
+}): number[];
+export interface DiiModuleSpec {
+    moduleId: number;
+    moduleSize: number;
+    moduleVersion: number;
+    /** 名前 (記述子 0x02)。**ロゴだけが使う** */
+    name?: string;
+    /** Type 記述子 (0x01)。**データ放送だけが使う** */
+    contentType?: string;
+    /** Compression Type 記述子 (0xC2)。0 が zlib */
+    compression?: {
+        type: number;
+        originalSize: number;
+    };
+}
+/**
+ * DII。「このモジュールは何バイトで、名前は何か」を伝える。
+ *
+ * **複数のモジュールを載せられる。** 本物の BS はここに `LOGO-05` と
+ * `CS_LOGO-05` を並べて流していて (実機の `BS15_0` で確認)、1つしか
+ * 載せられない作りでは CS を取りこぼす経路を試せない。
+ */
+export declare function diiSection(downloadId: number, blockSize: number, modules: DiiModuleSpec | DiiModuleSpec[], 
+/** カルーセルの版。**同じ番号で送り直しても組み立て直されない** */
+transactionId?: number): Uint8Array;
+/** DDB。モジュールを割ったブロックを1つ運ぶ */
+export declare function ddbSection(downloadId: number, moduleId: number, moduleVersion: number, blockNumber: number, block: Uint8Array): Uint8Array;
+/** ロゴデータモジュール (ARIB STD-B21)。カルーセルで運ばれる中身 */
+export declare function logoModule(logoType: number, logos: {
+    logoId: number;
+    services: [number, number][];
+    data: Uint8Array;
+}[]): Uint8Array;
+export declare const BML_TS: {
+    readonly service: 1024;
+    readonly pmtPid: 496;
+    readonly videoPid: 273;
+    readonly bmlPid: 2048;
+    readonly downloadId: 4026531841;
+    readonly componentTag: 64;
+};
+/** BML の ES が1本だけ載った PMT (`BML_TS` の割り振り) */
+export declare function bmlPmt(): Uint8Array;
+/** PAT と PMT。データ放送のストリームの頭 */
+export declare function bmlHead(): Uint8Array[];
+/**
+ * モジュール1つぶんの中身。**放送は multipart/mixed で複数のファイルを詰める。**
+ * 本物と同じく、頭に Content-Type、境界で区切って各ファイルに Content-Location
+ */
+export declare function multipartModule(files: [location: string, type: string, body: string][]): Uint8Array;
+/** PMT の ES に付ける application_signalling_descriptor (0x6F)。**AIT の在り処の印** */
+export declare function aitSignallingDescriptor(applicationType?: number, version?: number): number[];
+export interface SynthHybridcastApp {
+    organisationId: number;
+    applicationId: number;
+    /** `CONTROL` の値。既定は autostart */
+    controlCode?: number;
+    name?: string;
+    /** URL の頭。**通信路で運ぶもの** (protocol_id = 3) として入れる */
+    base?: string;
+    /** その先のパス */
+    path?: string;
+}
+/**
+ * AIT (table_id 0x74)。**Hybridcast のアプリのアドレス (URL) が載っている表。**
+ *
+ * 中身そのものは電波に乗っていないので、ここに入るのは URL と名前だけ
+ */
+export declare function aitSection(applications: SynthHybridcastApp[], applicationType?: number): Uint8Array;