@danything/arib 0.0.0-stage → 0.1.0

package/dist/caption-text.js

@@ -0,0 +1,39 @@
+import { LANGUAGE } from "./language.js";
+/**
+ * **字幕の文字の配置** (第1版)。サーバが放送の字幕 (ARIB STD-B24) をデコードして置き場所まで
+ * 決め、受け側 (ブラウザ・テレビのアプリ) はこれを**描くだけ**にする。形式の取り決めは
+ * [api.md](https://github.com/danything/denpa/blob/main/docs/api.md#字幕の文字の配置) に書いてある (ここと同じものを、Kotlin でも読む)。
+ *
+ * 座標はすべて**字幕の面の単位** (`plane`。ふつう 960x540)。受け側は映像の枠に
+ * 合わせて縦横それぞれ伸ばす。色は `#rrggbbaa`。
+ */
+/** 形式の版。**互換の無い変え方をしたら上げる** (受け側は知らない版を描かない) */
+export const CAPTION_TEXT_VERSION = 1;
+/** 縁取り (ORN) の太さ。面の単位で、字の輪郭の外側へ。libaribcaption の既定 (ffmpeg の `outline_width`) と同じ */
+export const STROKE_WIDTH = 1.5;
+/** 点滅 (FLC) の間 (ms)。出ている時間と消えている時間 */
+export const FLASH_MS = 500;
+/** 空白として字を描かない (背景だけ塗る) 字。libaribcaption の IsSpaceCharacter と同じ */
+export function isSpace(code) {
+    return (code === 0x09 ||
+        code === 0x20 ||
+        code === 0xa0 ||
+        code === 0x1680 ||
+        code === 0x3000 ||
+        code === 0x202f ||
+        code === 0x205f ||
+        (code >= 0x2000 && code <= 0x200a));
+}
+/** 第何言語かと ISO 639 の符号から、画面に出す名前を付ける */
+export function captionLanguage(index, code) {
+    return {
+        index,
+        code,
+        label: LANGUAGE[code] ?? (code === "" ? `字幕${index}` : code),
+    };
+}
+/** `?language=` を読む (1〜8)。省いた・読めないときは第1言語 */
+export function parseCaptionLanguage(value) {
+    const number = Number(value);
+    return Number.isInteger(number) && number >= 1 && number <= 8 ? number : 1;
+}

package/dist/drcs-smooth.d.ts

@@ -0,0 +1,52 @@
+/**
+ * **字幕の外字 (DRCS) の画像を、送る前になめらかにする** ([b24caption.ts](b24caption.ts) が JSON に入れるところで使う)。
+ *
+ * 放送は置き換え表で字にできない外字を、16〜36 画素の白黒の画像で送ってくる。受け側はそれを字の枠いっぱい
+ * (1920x1080 の全画面で 72 画素ほど) に引き伸ばすので、そのまま渡すと 1 点が 4x4 の階段になり、
+ * なめらかに引き伸ばしても階段がぼやけて残る (スピーカー 🔊 の外字など)。
+ *
+ * 以前は libaribcaption の描き手にパッチを当てて同じことをしていた (#554)。描くのを受け側に移したとき (#571〜#586)
+ * にその直しが落ちたので、**サーバで1回だけ** やって、濃淡の画像 (`bits: 4`・`depth: 16`) で送る。受け側は
+ * もともと `bits` 1・2・4・8 を読み、濃さを字の色の不透明度に掛けて引き伸ばすので変えなくてよい。
+ *
+ * 1. **水増しを畳む** (`collapseDoubled`)。放送はよく 18x18 の字を縦横 2 倍の 36x36 で送ってくる。
+ *    同じ並びが 2 つずつ続く行・列を 1 つにする (失うものは無い)。そうしないと次の段で階段を階段と見られない
+ * 2. **Scale2x (EPX) で斜めを丸める** (`scale2x`)。斜めの階段を細かくする。縦横の線はまっすぐのまま残るが、
+ *    塗りの出っ張った角は元の1点ぶんほど丸まる (EPX の性質。#554 のパッチも同じで、フォントの字に近い見た目になる)
+ * 3. **縮めて濃淡にする** (`boxDown`・`pack4`)。細かくした画像を 4x4 ずつ平均し、縁に中間の濃さを付ける。
+ *    縦横の線は元の画素の境目に落ちるので、ぼけずにくっきり残る
+ *
+ * **置き換え表の MD5 は元の画像から取る** (b24caption.ts)。ここで作った画像は送るためだけのもの。
+ */
+import type { CaptionDrcs } from "./caption-text.js";
+/** 濃さ 0〜255 の画像 (左上から1画素1バイト) */
+export interface Grey {
+    width: number;
+    height: number;
+    pixels: Uint8Array;
+}
+/** 放送の詰め方 (左上から1画素 `bits` ビット、上の桁から) を開いて、濃さ 0〜255 にする */
+export declare function decodeGrey(width: number, height: number, depth: number, bits: number, data: Uint8Array): Grey;
+/**
+ * 縦横に水増しされた画像を畳む。偶数の幅で、どの行も (0,1) (2,3)… の列が同じなら列を半分に、
+ * 行も同じように見る。畳めなくなるまで繰り返す (4 倍で送ってきても畳める)
+ */
+export declare function collapseDoubled(src: Grey): Grey;
+/**
+ * Scale2x (EPX)。縦横 2 倍にしながら、斜めに接する点どうしの間を埋めて階段を細かくする。
+ * 画像の外は縁で折り返した内側と同じと見る。縁に接した塗りは角が欠けず (隣の字とつながる線が切れない)、
+ * 縁へ抜ける斜めの線にも余計な点が付かない
+ */
+export declare function scale2x(src: Grey): Grey;
+/** `n`x`n` ずつ平均して 1/n に縮める (幅・高さは n の倍数であること) */
+export declare function boxDown(src: Grey, n: number): Grey;
+/**
+ * 外字の画像を、送る濃淡の画像にする。畳んだ画像の一辺が `TARGET` に届くまで 2 倍ずつ (一辺 `MAX` まで) 大きくする。
+ * 畳んだ 18x18 なら 72x72、36x36 (水増しなし) なら 72x72
+ */
+export declare function smoothDrcs(width: number, height: number, depth: number, bits: number, data: Uint8Array): CaptionDrcs;
+/**
+ * 濃さを 16 階調にして1画素4ビットで詰める (左の画素が上の桁)。4x4 の平均は白黒の画像からだと 17 階調しか
+ * 出ないので、8 ビットで送っても見た目は変わらず倍の大きさになるだけ (外字の画像は字幕の1枚ごとに付く)
+ */
+export declare function pack4(g: Grey): Uint8Array;

package/dist/drcs-smooth.js

@@ -0,0 +1,163 @@
+/**
+ * **字幕の外字 (DRCS) の画像を、送る前になめらかにする** ([b24caption.ts](b24caption.ts) が JSON に入れるところで使う)。
+ *
+ * 放送は置き換え表で字にできない外字を、16〜36 画素の白黒の画像で送ってくる。受け側はそれを字の枠いっぱい
+ * (1920x1080 の全画面で 72 画素ほど) に引き伸ばすので、そのまま渡すと 1 点が 4x4 の階段になり、
+ * なめらかに引き伸ばしても階段がぼやけて残る (スピーカー 🔊 の外字など)。
+ *
+ * 以前は libaribcaption の描き手にパッチを当てて同じことをしていた (#554)。描くのを受け側に移したとき (#571〜#586)
+ * にその直しが落ちたので、**サーバで1回だけ** やって、濃淡の画像 (`bits: 4`・`depth: 16`) で送る。受け側は
+ * もともと `bits` 1・2・4・8 を読み、濃さを字の色の不透明度に掛けて引き伸ばすので変えなくてよい。
+ *
+ * 1. **水増しを畳む** (`collapseDoubled`)。放送はよく 18x18 の字を縦横 2 倍の 36x36 で送ってくる。
+ *    同じ並びが 2 つずつ続く行・列を 1 つにする (失うものは無い)。そうしないと次の段で階段を階段と見られない
+ * 2. **Scale2x (EPX) で斜めを丸める** (`scale2x`)。斜めの階段を細かくする。縦横の線はまっすぐのまま残るが、
+ *    塗りの出っ張った角は元の1点ぶんほど丸まる (EPX の性質。#554 のパッチも同じで、フォントの字に近い見た目になる)
+ * 3. **縮めて濃淡にする** (`boxDown`・`pack4`)。細かくした画像を 4x4 ずつ平均し、縁に中間の濃さを付ける。
+ *    縦横の線は元の画素の境目に落ちるので、ぼけずにくっきり残る
+ *
+ * **置き換え表の MD5 は元の画像から取る** (b24caption.ts)。ここで作った画像は送るためだけのもの。
+ */
+/** 送る画像の一辺。これに届くまで倍にする (全画面の字の枠と同じくらい) */
+const TARGET = 64;
+/** 送る画像の一辺の上限。受け側 (denpa-tv) もこれより大きい画像は読まない */
+const MAX = 256;
+/** 最後に平均する一辺。Scale2x をこのぶん余計にかけておく (4 なら 2 回) */
+const BOX = 4;
+/** 放送の詰め方 (左上から1画素 `bits` ビット、上の桁から) を開いて、濃さ 0〜255 にする */
+export function decodeGrey(width, height, depth, bits, data) {
+    const pixels = new Uint8Array(width * height);
+    const mask = (1 << bits) - 1;
+    for (let i = 0; i < width * height; i++) {
+        const bit = i * bits;
+        const value = ((data[bit >> 3] ?? 0) >> (8 - (bit & 7) - bits)) & mask;
+        pixels[i] = Math.round((Math.min(value, depth - 1) * 255) / (depth - 1));
+    }
+    return { width, height, pixels };
+}
+/**
+ * 縦横に水増しされた画像を畳む。偶数の幅で、どの行も (0,1) (2,3)… の列が同じなら列を半分に、
+ * 行も同じように見る。畳めなくなるまで繰り返す (4 倍で送ってきても畳める)
+ */
+export function collapseDoubled(src) {
+    let g = src;
+    for (;;) {
+        const { width, height, pixels } = g;
+        let cols = width % 2 === 0;
+        let rows = height % 2 === 0;
+        for (let y = 0; y < height && (cols || rows); y++) {
+            for (let x = 0; x < width; x++) {
+                const p = pixels[y * width + x];
+                if (cols && x % 2 === 0 && p !== pixels[y * width + x + 1])
+                    cols = false;
+                if (rows && y % 2 === 0 && p !== pixels[(y + 1) * width + x])
+                    rows = false;
+            }
+        }
+        if (!cols && !rows)
+            return g;
+        const w = cols ? width / 2 : width;
+        const h = rows ? height / 2 : height;
+        const out = new Uint8Array(w * h);
+        for (let y = 0; y < h; y++) {
+            for (let x = 0; x < w; x++)
+                out[y * w + x] =
+                    pixels[(rows ? y * 2 : y) * width + (cols ? x * 2 : x)];
+        }
+        g = { width: w, height: h, pixels: out };
+    }
+}
+/**
+ * Scale2x (EPX)。縦横 2 倍にしながら、斜めに接する点どうしの間を埋めて階段を細かくする。
+ * 画像の外は縁で折り返した内側と同じと見る。縁に接した塗りは角が欠けず (隣の字とつながる線が切れない)、
+ * 縁へ抜ける斜めの線にも余計な点が付かない
+ */
+export function scale2x(src) {
+    const { width, height, pixels } = src;
+    const w = width * 2;
+    const out = new Uint8Array(w * height * 2);
+    const at = (x, y) => {
+        const cx = x < 0 ? Math.min(1, width - 1) : x >= width ? Math.max(0, width - 2) : x;
+        const cy = y < 0
+            ? Math.min(1, height - 1)
+            : y >= height
+                ? Math.max(0, height - 2)
+                : y;
+        return pixels[cy * width + cx];
+    };
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const p = pixels[y * width + x];
+            const a = at(x, y - 1); // 上
+            const b = at(x + 1, y); // 右
+            const c = at(x - 1, y); // 左
+            const d = at(x, y + 1); // 下
+            const top = y * 2 * w + x * 2;
+            out[top] = c === a && c !== d && a !== b ? a : p;
+            out[top + 1] = a === b && a !== c && b !== d ? b : p;
+            out[top + w] = d === c && d !== b && c !== a ? c : p;
+            out[top + w + 1] = b === d && b !== a && d !== c ? d : p;
+        }
+    }
+    return { width: w, height: height * 2, pixels: out };
+}
+/** `n`x`n` ずつ平均して 1/n に縮める (幅・高さは n の倍数であること) */
+export function boxDown(src, n) {
+    const w = src.width / n;
+    const h = src.height / n;
+    const out = new Uint8Array(w * h);
+    for (let y = 0; y < h; y++) {
+        for (let x = 0; x < w; x++) {
+            let sum = 0;
+            for (let dy = 0; dy < n; dy++) {
+                const row = (y * n + dy) * src.width + x * n;
+                for (let dx = 0; dx < n; dx++)
+                    sum += src.pixels[row + dx];
+            }
+            out[y * w + x] = Math.round(sum / (n * n));
+        }
+    }
+    return { width: w, height: h, pixels: out };
+}
+/**
+ * 外字の画像を、送る濃淡の画像にする。畳んだ画像の一辺が `TARGET` に届くまで 2 倍ずつ (一辺 `MAX` まで) 大きくする。
+ * 畳んだ 18x18 なら 72x72、36x36 (水増しなし) なら 72x72
+ */
+export function smoothDrcs(width, height, depth, bits, data) {
+    if (width <= 0 || height <= 0 || depth < 2 || ![1, 2, 4, 8].includes(bits)) {
+        // 読めない画像はそのまま渡す (受け側も読まない)
+        return {
+            w: width,
+            h: height,
+            depth,
+            bits,
+            data: Buffer.from(data).toString("base64"),
+        };
+    }
+    let g = collapseDoubled(decodeGrey(width, height, depth, bits, data));
+    const side = Math.max(g.width, g.height);
+    let scale = 1;
+    while (side * scale < TARGET && side * scale * 2 <= MAX)
+        scale *= 2;
+    for (let s = 1; s < scale * BOX; s *= 2)
+        g = scale2x(g);
+    g = boxDown(g, BOX);
+    return {
+        w: g.width,
+        h: g.height,
+        depth: 16,
+        bits: 4,
+        data: Buffer.from(pack4(g)).toString("base64"),
+    };
+}
+/**
+ * 濃さを 16 階調にして1画素4ビットで詰める (左の画素が上の桁)。4x4 の平均は白黒の画像からだと 17 階調しか
+ * 出ないので、8 ビットで送っても見た目は変わらず倍の大きさになるだけ (外字の画像は字幕の1枚ごとに付く)
+ */
+export function pack4(g) {
+    const out = new Uint8Array(Math.ceil(g.pixels.length / 2));
+    g.pixels.forEach((v, i) => {
+        out[i >> 1] |= Math.round((v * 15) / 255) << (i & 1 ? 0 : 4);
+    });
+    return out;
+}

package/dist/dsmcc.d.ts

@@ -0,0 +1,92 @@
+/**
+ * データカルーセル (DSM-CC) をデコードする。**放送が同じものを何度も回してくる**中から、
+ * ブロックを集めて1つのモジュールに組み立て直すところまで。
+ *
+ * 使う側が2つある。**中身の読み方だけが違って、運び方は同じ**なので、ここに寄せる。
+ *
+ * - [logo-dsmcc.ts](https://github.com/danything/denpa/blob/main/src/lib/ts/logo-dsmcc.ts) … 衛星の局ロゴ (ARIB STD-B21)
+ * - [bml.ts](bml.ts) … データ放送 (ARIB STD-B24 / TR-B14・TR-B15)
+ *
+ * ## 流れ
+ *
+ * 1. **DII** (table_id 0x3B) が「どのモジュールが何バイトで、何ブロックか」を伝える
+ * 2. **DDB** (0x3C) がそのモジュールを `blockSize` ごとに割って何度も流す
+ * 3. 全ブロック揃うとモジュールになる
+ *
+ * セクションを取り出すのは [psi.ts](psi.ts) の `SectionAssembler`。**`'syntax'` を
+ * 渡すこと** — DSM-CC は `section_syntax_indicator` が立たないことがあり、そのときは
+ * 末尾4バイトが CRC ではなく Checksum なので、いつも確かめると全部捨ててしまう。
+ */
+export declare const TABLE_DII = 59;
+/** ストリーム記述子。NPT と イベントメッセージが載る (データ放送だけが使う) */
+export declare const TABLE_STREAM_DESCRIPTOR = 61;
+/**
+ * 同じカルーセルの中の「回」。**downloadId の上位4ビットに入っている**
+ * (下位28ビットは常に1で運用される)。
+ *
+ * 番組が変わるとここが変わるので、**前の番組のモジュールを捨てる合図**になる。
+ */
+export declare function dataEventIdOf(downloadId: number): number;
+export interface DiiModule {
+    moduleId: number;
+    moduleSize: number;
+    moduleVersion: number;
+    /** モジュール記述子の名前。ロゴかどうかの見分けに使う */
+    name: string | null;
+    /** Type 記述子。`multipart/mixed` など。データ放送だけが使う */
+    contentType: string | null;
+    /** Compression Type 記述子。**0 が zlib**。伸ばしたあとの大きさ付き */
+    compression: {
+        type: number;
+        originalSize: number;
+    } | null;
+}
+export interface Dii {
+    downloadId: number;
+    /** カルーセルの版。**変わっていなければ組み立て直さない** */
+    transactionId: number;
+    blockSize: number;
+    modules: DiiModule[];
+    /**
+     * ARIB の private データ記述子 (0xF0) の入口フラグ。
+     * データ放送で「次に入口へ戻すか」を伝える。無ければ null
+     */
+    returnToEntry: boolean | null;
+}
+export interface Ddb {
+    downloadId: number;
+    moduleId: number;
+    moduleVersion: number;
+    blockNumber: number;
+    block: Uint8Array;
+}
+/**
+ * DII (Download Info Indication)。
+ *
+ * 頭は共通で protocolDiscriminator/dsmccType/messageId/transaction_id と続き、
+ * adaptationLength ぶん飛ばした先に本体が入っている。
+ */
+export declare function parseDii(section: Uint8Array): Dii | null;
+/** DDB (Download Data Block)。モジュールを割ったブロックが1つ入っている */
+export declare function parseDdb(section: Uint8Array): Ddb | null;
+/**
+ * 組み立て中のモジュール。**DII が言った大きさぶんの入れ物を先に用意して**、
+ * DDB が来るたびに然るべき位置へ置く。
+ *
+ * 順番は保証されない (途中から見れば真ん中から始まる) ので、
+ * **受け取ったブロック番号を数えて**揃ったかを見る。
+ */
+export declare class ModuleBuilder {
+    readonly moduleVersion: number;
+    private readonly blockSize;
+    readonly data: Uint8Array;
+    private readonly received;
+    private readonly total;
+    constructor(moduleVersion: number, moduleSize: number, blockSize: number);
+    /** 受け取ったブロックの数 (同じブロックを2度受けても1つ) */
+    get blocks(): number;
+    /** 揃ったか。**大きさ 0 のモジュールは初めから揃っている** (運ぶブロックが無いので DDB を待たない) */
+    get complete(): boolean;
+    /** ブロックを1つ置く。**揃ったら true** */
+    add(blockNumber: number, block: Uint8Array): boolean;
+}

package/dist/dsmcc.js

@@ -0,0 +1,191 @@
+/**
+ * データカルーセル (DSM-CC) をデコードする。**放送が同じものを何度も回してくる**中から、
+ * ブロックを集めて1つのモジュールに組み立て直すところまで。
+ *
+ * 使う側が2つある。**中身の読み方だけが違って、運び方は同じ**なので、ここに寄せる。
+ *
+ * - [logo-dsmcc.ts](https://github.com/danything/denpa/blob/main/src/lib/ts/logo-dsmcc.ts) … 衛星の局ロゴ (ARIB STD-B21)
+ * - [bml.ts](bml.ts) … データ放送 (ARIB STD-B24 / TR-B14・TR-B15)
+ *
+ * ## 流れ
+ *
+ * 1. **DII** (table_id 0x3B) が「どのモジュールが何バイトで、何ブロックか」を伝える
+ * 2. **DDB** (0x3C) がそのモジュールを `blockSize` ごとに割って何度も流す
+ * 3. 全ブロック揃うとモジュールになる
+ *
+ * セクションを取り出すのは [psi.ts](psi.ts) の `SectionAssembler`。**`'syntax'` を
+ * 渡すこと** — DSM-CC は `section_syntax_indicator` が立たないことがあり、そのときは
+ * 末尾4バイトが CRC ではなく Checksum なので、いつも確かめると全部捨ててしまう。
+ */
+import { u16, u32 } from "./bytes.js";
+import { descriptors } from "./psi.js";
+export const TABLE_DII = 0x3b;
+const TABLE_DDB = 0x3c;
+/** ストリーム記述子。NPT と イベントメッセージが載る (データ放送だけが使う) */
+export const TABLE_STREAM_DESCRIPTOR = 0x3d;
+/** モジュール記述子 (STD-B24 第三分冊 第三編 6.2.3) */
+const MODULE_DESC_TYPE = 0x01;
+const MODULE_DESC_NAME = 0x02;
+const MODULE_DESC_COMPRESSION = 0xc2;
+/** DII が blockSize を持っていないときの既定 (ARIB TR-B15) */
+const DEFAULT_BLOCK_SIZE = 4066;
+/**
+ * 同じカルーセルの中の「回」。**downloadId の上位4ビットに入っている**
+ * (下位28ビットは常に1で運用される)。
+ *
+ * 番組が変わるとここが変わるので、**前の番組のモジュールを捨てる合図**になる。
+ */
+export function dataEventIdOf(downloadId) {
+    return (downloadId >>> 28) & 0x0f;
+}
+/** DSM-CC セクションの中身 (メッセージ本体) を切り出す */
+function messageOf(section) {
+    const length = u16(section, 1) & 0x0fff;
+    const end = 3 + length - 4;
+    if (end <= 8 || end > section.length)
+        return null;
+    return section.subarray(8, end);
+}
+/**
+ * DII (Download Info Indication)。
+ *
+ * 頭は共通で protocolDiscriminator/dsmccType/messageId/transaction_id と続き、
+ * adaptationLength ぶん飛ばした先に本体が入っている。
+ */
+export function parseDii(section) {
+    if (section[0] !== TABLE_DII)
+        return null;
+    const message = messageOf(section);
+    if (message === null || message.length < 20)
+        return null;
+    const transactionId = u32(message, 4);
+    const adaptationLength = message[9];
+    let at = 12 + adaptationLength;
+    if (at + 20 > message.length)
+        return null;
+    const downloadId = u32(message, at);
+    const blockSize = u16(message, at + 4) || DEFAULT_BLOCK_SIZE;
+    at += 4 + 2 + 1 + 1 + 4 + 4;
+    // compatibilityDescriptor。中身は使わないので長さぶん飛ばす
+    if (at + 2 > message.length)
+        return null;
+    at += 2 + u16(message, at);
+    if (at + 2 > message.length)
+        return null;
+    const count = u16(message, at);
+    at += 2;
+    const modules = [];
+    for (let i = 0; i < count; i++) {
+        if (at + 8 > message.length)
+            return null;
+        const moduleId = u16(message, at);
+        const moduleSize = u32(message, at + 2);
+        const moduleVersion = message[at + 6];
+        const infoLength = message[at + 7];
+        const info = message.subarray(at + 8, at + 8 + infoLength);
+        at += 8 + infoLength;
+        let name = null;
+        let contentType = null;
+        let compression = null;
+        for (const [tag, descriptor] of descriptors(info)) {
+            if (tag === MODULE_DESC_NAME)
+                name = new TextDecoder().decode(descriptor);
+            else if (tag === MODULE_DESC_TYPE)
+                contentType = new TextDecoder("ascii").decode(descriptor);
+            else if (tag === MODULE_DESC_COMPRESSION && descriptor.length >= 5) {
+                // 先頭1バイトは符号付き。運用されるのは 0 (zlib) だけ
+                compression = {
+                    type: (descriptor[0] << 24) >> 24,
+                    originalSize: u32(descriptor, 1),
+                };
+            }
+        }
+        modules.push({
+            moduleId,
+            moduleSize,
+            moduleVersion,
+            name,
+            contentType,
+            compression,
+        });
+    }
+    /*
+     * privateData。長さの手前まで飛ばしたところに記述子が並ぶ。
+     * **無いほうがふつう**なので、読めなければ null のまま進む
+     */
+    let returnToEntry = null;
+    if (at + 2 <= message.length) {
+        const length = u16(message, at);
+        for (const [tag, descriptor] of descriptors(message.subarray(at + 2, at + 2 + length))) {
+            // arib_bxml_privatedata_descriptor (STD-B24 第二分冊 (1/2) 第二編 9.3.4)
+            if (tag === 0xf0 && descriptor.length >= 1)
+                returnToEntry = (descriptor[0] & 0x80) !== 0;
+        }
+    }
+    return { downloadId, transactionId, blockSize, modules, returnToEntry };
+}
+/** DDB (Download Data Block)。モジュールを割ったブロックが1つ入っている */
+export function parseDdb(section) {
+    if (section[0] !== TABLE_DDB)
+        return null;
+    const message = messageOf(section);
+    if (message === null || message.length < 12)
+        return null;
+    const downloadId = u32(message, 4);
+    const adaptationLength = message[9];
+    const messageLength = u16(message, 10);
+    let at = 12 + adaptationLength;
+    if (at + 6 > message.length)
+        return null;
+    const moduleId = u16(message, at);
+    const moduleVersion = message[at + 2];
+    const blockNumber = u16(message, at + 4);
+    at += 6;
+    const size = messageLength - adaptationLength - 6;
+    if (size < 0 || at + size > message.length)
+        return null;
+    return {
+        downloadId,
+        moduleId,
+        moduleVersion,
+        blockNumber,
+        block: message.subarray(at, at + size),
+    };
+}
+/**
+ * 組み立て中のモジュール。**DII が言った大きさぶんの入れ物を先に用意して**、
+ * DDB が来るたびに然るべき位置へ置く。
+ *
+ * 順番は保証されない (途中から見れば真ん中から始まる) ので、
+ * **受け取ったブロック番号を数えて**揃ったかを見る。
+ */
+export class ModuleBuilder {
+    moduleVersion;
+    blockSize;
+    data;
+    received = new Set();
+    total;
+    constructor(moduleVersion, moduleSize, blockSize) {
+        this.moduleVersion = moduleVersion;
+        this.blockSize = blockSize;
+        this.data = new Uint8Array(moduleSize);
+        this.total = Math.ceil(moduleSize / blockSize);
+    }
+    /** 受け取ったブロックの数 (同じブロックを2度受けても1つ) */
+    get blocks() {
+        return this.received.size;
+    }
+    /** 揃ったか。**大きさ 0 のモジュールは初めから揃っている** (運ぶブロックが無いので DDB を待たない) */
+    get complete() {
+        return this.received.size >= this.total;
+    }
+    /** ブロックを1つ置く。**揃ったら true** */
+    add(blockNumber, block) {
+        const at = this.blockSize * blockNumber;
+        if (at + block.length > this.data.length)
+            return false;
+        this.data.set(block, at);
+        this.received.add(blockNumber);
+        return this.complete;
+    }
+}