libaribhtml5 0.1.0 → 0.1.2

package/dist/types/broadcast-document.d.ts

@@ -6,6 +6,14 @@ export type BroadcastDocumentOptions = {
     /** Inline bootstrap inserted at the start of head, including its script tag. */
     bootstrap?: string;
 };
+/**
+ * Bootstrap a receiver-managed document before broadcaster deferred scripts run.
+ *
+ * A restored iframe can be parsed before the parent application's module has
+ * installed its host callback.  Keep the receiver identity query usable during
+ * that short window and retry the full installation once the parent is ready.
+ */
+export declare function createRuntimeBootstrap(scopePath?: string): string;
 export declare function rewriteBroadcastObjectMarkup(source: string): string;
 export declare function prefixBroadcastRootAttributes(source: string, basePath?: string, scopePath?: string): string;
 export declare function prepareBroadcastStylesheet(source: string, options?: BroadcastDocumentOptions): string;

package/docs/broadcast-resources-and-fonts.md

@@ -124,20 +124,24 @@ and therefore follow the Worker route. A font explicitly retained through
 
 `src/runtime/fonts/arib-symbols.svg` is the auditable SVG Font source for the
 television-symbol block `U+1F19B..U+1F1AC`, including `U+1F19E SQUARED FOUR K`
-(`🆞`). They are a minimal subset of the OFL-licensed Noto Sans Symbols font
-used by the reference receiver. See `src/runtime/fonts/NOTICE.md` and
-`src/runtime/fonts/OFL.txt`; no commercial font outline is included.
+(`🆞`). `arib-enclosed-cjk.svg` covers the defined enclosed CJK television
+symbols in `U+1F200..U+1F251`, including `🈑` and `🈔`. They are minimal
+subsets of the OFL-licensed Noto Sans Symbols and Noto Sans CJK JP fonts. See
+`src/runtime/fonts/NOTICE.md` and `src/runtime/fonts/OFL.txt`; no commercial
+font outline is included.
 
 Modern browsers no longer reliably render SVG Fonts, so the same script emits
-`arib-symbols.woff` for runtime use. The runtime registers the sparse font only
-for its 18 code points under `ARIB Symbols` and the ARIB generic family names
-`丸ゴシック`, `太丸ゴシック`, and `角ゴシック`. Ordinary Japanese glyphs continue
-through the page's next fallback font. Dynamic DRCS and broadcaster-delivered
-SVG/WOFF fonts stay separate from this static receiver font.
+the corresponding WOFF files for runtime use. The runtime registers the sparse
+fonts only for those code points under `ARIB Symbols` and the ARIB generic
+family names `丸ゴシック`, `太丸ゴシック`, and `角ゴシック`. Ordinary Japanese
+glyphs continue through the page's next fallback font. Dynamic DRCS and
+broadcaster-delivered SVG/WOFF fonts stay separate from these static receiver
+fonts.
 
 Regenerate both assets with:
 
 ```sh
 nix-shell -p python313Packages.fonttools --run \
-  'python scripts/build-arib-symbol-font.py /path/to/NotoSansSymbols.ttf'
+  'python scripts/build-arib-symbol-font.py /path/to/NotoSansSymbols.ttf \
+    --cjk-source /path/to/NotoSansCJK-VF.otf.ttc'
 ```

package/docs/media-plane-integration.md

@@ -13,6 +13,47 @@
 caption ページを正しく表示するなら、1 番目または 2 番目が必要です。
 `BehindIframeMediaPlaneAdapter` では実現できません。
 
+## 背景プレーンの制約
+
+BS4K/BS8K の背景は、データ放送ページが任意に選ぶ壁紙ではありません。受信機は
+マルチメディアプレーンより後ろに、画面全体を覆う単色の背景プレーンを持ちます。
+前面のプレーンが透明、または何も描画していない画素だけに、この色が見えます。
+
+MMT の source of truth は LCT です。実装時の優先順位は次の通りです。
+
+1. LCT の `Background_Color_Descriptor` があれば、その RGB 各 8 bit の値を使う。
+2. LCT の色をまだ受け取っていない間は、アプリケーションが報告した stage の単色を互換
+   fallback として使ってよい。ただし、これはアプリケーション CSS を LCT と解釈するものではない。
+3. どちらも得られない間の receiver-owned fallback は黒 (`#000`) とする。
+
+この fallback は規格上の既定色ではありません。白いブラウザ canvas の露出を避けるための
+実装上の選択です。確認に使った NHK BS8K の `8k.mmts` から抽出したファイルも、
+`top/source/top.css` の `body` と `#vstream`、および
+`caption/source/caption.css` の `#backscreen` と `.bs8k #container` に黒を指定しています。
+したがって、このサンプル用に背景画像やグラデーションを追加しません。
+
+背景の実装には、さらに次の制約があります。
+
+- 背景プレーンは viewport 全体を覆い、映像、アプリケーション、字幕、文字スーパーより後ろに置く。
+- LCT の色はアプリケーションやサービスの切り替え時に引き継がない。新しい LCT を受け取るまでは
+  fallback に戻す。
+- アプリケーションの `html` / `body` を透明化して映像を見せる場合でも、透明部分の下には
+  receiver-owned background plane を残す。
+- 放送アプリケーション内の背景画像、要素背景、半透明 UI は multimedia plane の描画であり、
+  LCT の背景色を置き換えない。
+- native compositor でも DOM 実装でも、LCT の単色を iframe 内の装飾要素として実装しない。
+  動画領域の切り抜きや iframe のページ遷移から独立した、受信機所有の最背面レイヤーにする。
+
+根拠は `../ARIB-docs` の次の条項です。
+
+- ARIB STD-B62 1.5版 第一編 第1部 5.2(4): 背景プレーンは最背面で、前面が透明または
+  未描画の部分に指定色を表示する。
+- 同 5.3: MMT 方式の受信機は LCT で指定された色を背景プレーンへ描画して合成する。
+- 同 6.1.1: 背景プレーンは 7680x4320、BT.2020 系の RGB 各 8 bit として定義される。
+- ARIB STD-B60 1.5版 7.3.3.3 および 7.4.3.3: LCT と
+  `Background_Color_Descriptor` (`descriptor_tag=0x8002`) を定義し、24 bit を RGB 各 8 bit
+  の背景色として扱う。
+
 ## ブラウザへ組み込む最小コード
 
 普通の動画表示領域とデータ放送 iframe を同じ viewport に置きます。
@@ -22,10 +63,17 @@ caption ページを正しく表示するなら、1 番目または 2 番目が
   <div id="normal-player">
     <video id="video" autoplay muted playsinline></video>
   </div>
-  <iframe id="broadcast" sandbox="allow-scripts allow-same-origin"></iframe>
+  <iframe id="broadcast"></iframe>
 </div>
 ```
 
+この iframe は受信機が管理する同一 origin のコンテンツです。
+`sandbox="allow-scripts allow-same-origin"` は指定しないでください。同一 origin の
+script は sandbox 属性を除去できるため、ブラウザも security boundary にならないと
+警告します。一方で `allow-same-origin` を外すと、host から受信機 API を導入できません。
+受信機が信頼しないアプリケーションには、この in-process runtime ではなく別 origin の
+integration が必要です。
+
 `DomObjectMediaPlaneAdapter` に既存の video と、データ放送を終了した時に video を戻す
 通常プレーヤー container を渡します。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libaribhtml5",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Browser runtime and receiver host for ARIB HTML5 data broadcasting",
   "keywords": [
     "arib",