libaribhtml5 0.1.5 → 0.1.8

package/dist/types/vfs/service-worker-backend.d.ts

@@ -0,0 +1,27 @@
+import type { BroadcastVfsResource, ServiceWorkerBroadcastVfsOptions } from './types.js';
+export declare class ServiceWorkerBroadcastVfs {
+    private readonly workerUrl;
+    private readonly scopeUrl;
+    private readonly uniqueBasenameFallback;
+    private registration;
+    private ready;
+    private readonly inFlight;
+    private disposing;
+    private disposed;
+    constructor(options: ServiceWorkerBroadcastVfsOptions);
+    initialize(): Promise<ServiceWorkerRegistration>;
+    begin(): Promise<void>;
+    put(resource: BroadcastVfsResource): Promise<void>;
+    canRead(path: string): Promise<boolean>;
+    reset(): Promise<void>;
+    /**
+     * Clear the receiver-owned VFS session after outstanding requests finish.
+     * The shared Service Worker registration is intentionally retained so other
+     * tabs and future receiver instances keep a stable scoped fetch handler.
+     */
+    dispose(): Promise<void>;
+    private request;
+    private performRequest;
+    private performRequestWithRegistration;
+    private waitForActivation;
+}

package/dist/types/vfs/session.d.ts

@@ -0,0 +1,36 @@
+import type { BroadcastVfsBackend, BroadcastVfsResource, BroadcastVfsSessionOptions } from './types.js';
+/**
+ * Ordered, recoverable write session above a VFS backend. enqueue() copies
+ * callback-lifetime data synchronously and returns a revision barrier.
+ */
+export declare class BroadcastVfsSession {
+    private readonly backend;
+    private readonly onError?;
+    private readonly scheduleTask;
+    private readonly mirror;
+    private readonly queue;
+    private waiters;
+    private generation;
+    private nextRevision;
+    private completedRevision;
+    private drainScheduled;
+    private ioTail;
+    private sessionReady;
+    private disposed;
+    constructor(backend: BroadcastVfsBackend, options?: BroadcastVfsSessionOptions);
+    beginSession(): Promise<void>;
+    enqueue(resource: BroadcastVfsResource): number;
+    waitFor(revision: number): Promise<void>;
+    /** Ensure a staged path is readable, replaying the page-owned mirror if needed. */
+    ensure(path: string, revision?: number): Promise<void>;
+    /**
+     * Stop accepting resources, discard queued writes, and wait for the one
+     * backend operation which may already be running. The backend itself remains
+     * owned by the caller and can be reset or disposed after this resolves.
+     */
+    dispose(): Promise<void>;
+    private appendIo;
+    private scheduleDrain;
+    private drainOne;
+    private resolveWaiters;
+}

package/dist/types/vfs/types.d.ts

@@ -0,0 +1,23 @@
+export type BroadcastVfsResource = {
+    path: string;
+    contentType?: string;
+    data: Uint8Array | ArrayBuffer;
+};
+export type ServiceWorkerBroadcastVfsOptions = {
+    workerUrl: string | URL;
+    /** Same-origin scope used to expose broadcast files. */
+    baseUrl?: string | URL;
+    /** Compatibility fallback for applications which omit a carousel directory. */
+    uniqueBasenameFallback?: boolean;
+};
+export type BroadcastVfsBackend = {
+    begin(): Promise<void>;
+    put(resource: BroadcastVfsResource): Promise<void>;
+    canRead(path: string): Promise<boolean>;
+};
+export type BroadcastVfsSessionOptions = {
+    /** Report background write failures; ensure() still rejects to its caller. */
+    onError?: (error: unknown) => void;
+    /** Override background scheduling, primarily for embedded hosts and tests. */
+    schedule?: (task: () => void) => void;
+};

package/docs/application-lifecycle.md

@@ -35,6 +35,23 @@
 別 application へ切り替える必要がある場合、実行中のページが
 `navigator.applicationManager.getOwnerApplication().replaceApplication(...)` を呼びます。
 
+## BML から Hybridcast への状態移行
+
+BML engine が AIT 制御 HTML application へ制御を渡す場合、general register は receiver host が
+所有します。BML 側から受け取った register snapshot を、HTML document を読み込む前に
+`host.setBmlGreg()` で渡してください。runtime は同じ receiver-owned array を
+`navigator.bmlCompat.browserPseudo.Greg` として公開します。
+
+```ts
+host.setBmlGreg(bmlTransition.greg)
+host.setApplicationInformation(aitApplication)
+host.loadApplication(htmlEntryPoint)
+```
+
+`setBmlGreg()` は active runtime が参照する array identity を維持するため、document を残したまま
+更新しても state が分断されません。受信機識別子や operator policy は別の receiver API が所有し、
+general register を識別子として扱ってはいけません。
+
 ## replaceApplication
 
 ARIB STD-B62 第二編 3.3.7–3.3.8 は `ApplicationManager` と `Application` を定義します。
@@ -65,6 +82,15 @@ const host = new AribReceiverHost({
 許可境界と外部 network policy を receiver 側で検証し、対応する場合だけ
 `onExitManagedState` で処理します。
 
+## BML ブラウザへの復帰
+
+Hybridcast HTML application は
+`navigator.applicationManager.launchDataBroadcastingBrowser()` で、起動元の
+BML data-broadcasting browser への復帰を receiver に要求できます。runtime はこの要求を
+`AribReceiverHostOptions.onLaunchDataBroadcastingBrowser` に渡します。host は BML session を
+保持したまま HTML application plane を閉じ、BML browser を再表示してください。callback がない
+場合は要求を成功扱いにせず、runtime は現在の application を維持します。
+
 ## アプリケーション境界と権限
 
 MH-AIT の `MH-Application Boundary and Permission Descriptor` (`descriptor_tag=0x802C`)

package/docs/receiver-host-contracts.md

@@ -58,6 +58,26 @@ read-only through the legacy `receiverinfo` Ureg used by broadcaster apps. The
 host owns persistence and passes a snapshot; writes inside the app do not flow
 back into the host's settings.
 
+## HTML application canvas
+
+The runtime reads `width` and `height` from the document's
+`meta[name="viewport"]` and sends the declared logical canvas to the receiver
+host. A document declaring `width=1920,height=1080` is rendered as a 1920×1080
+application plane and fitted inside `viewport`; this also applies when the
+document has no ARIB broadcast-media object. The default remains 3840×2160 when
+the declaration is absent or invalid.
+
+This is an application-document contract, not a broadcaster or transport
+profile. Hosts must not override it with station-specific CSS sizing rules.
+
+## HTML user agent
+
+An integrating receiver may provide `userAgent` when it needs to expose an
+honest Hybridcast capability token to managed HTML documents. The value is
+installed before document scripts execute and restored when that runtime is
+unloaded. The SDK does not add a broadcaster, smart-card, or device-vendor
+identity on its own.
+
 ## Device identifiers
 
 The default package combination remains `huggy`, `Huggy ARIB HTML5 Receiver`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libaribhtml5",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "Browser runtime and receiver host for ARIB HTML5 data broadcasting",
   "keywords": [
     "arib",
@@ -60,9 +60,10 @@
   },
   "scripts": {
     "dev": "vite --host 127.0.0.1",
-    "test": "node --experimental-strip-types scripts/test-runtime-contracts.mjs && node --experimental-strip-types scripts/test-vfs-worker.mjs",
+    "test": "node --experimental-strip-types scripts/test-runtime-contracts.mjs && node --experimental-strip-types scripts/test-external-network.mjs && node --experimental-strip-types scripts/test-caption-controller.mjs && node --experimental-strip-types scripts/test-runtime-application.mjs && node --experimental-strip-types scripts/test-receiver-protocol.mjs && node --experimental-strip-types scripts/test-receiver-canvas.mjs && node --experimental-strip-types scripts/test-receiver-session.mjs && node --experimental-strip-types scripts/test-media-plane-characterization.mjs && node --experimental-strip-types scripts/test-vfs-worker.mjs",
     "build": "tsc --noEmit && vite build && vite build --config vite.sdk.config.mjs && vite build --config vite.worker.config.mjs",
     "build:sdk": "tsc --noEmit && vite build --config vite.sdk.config.mjs && vite build --config vite.worker.config.mjs && npm run build:types",
+    "build:tv": "tsc --noEmit && node --experimental-strip-types scripts/test-tv-input.mjs && vite build --config vite.tv.config.mjs",
     "build:types": "tsc -p tsconfig.build.json && node scripts/rewrite-declaration-imports.mjs",
     "preview": "vite preview --host 127.0.0.1"
   }