libaribhtml5 0.1.7 → 0.1.9

package/dist/types/acas-number.d.ts

@@ -0,0 +1,6 @@
+/** Convert the receiver's 48-bit identifier to the 20-digit A-CAS number. */
+export declare function encodeAcasNumber(receiverIdentifier: string): string;
+/** Recover the 48-bit receiver identifier and reject an invalid checksum. */
+export declare function decodeAcasNumber(acasNumber: string): string;
+export declare function verifyAcasNumber(acasNumber: string): boolean;
+export declare function formatAcasNumber(acasNumber: string): string;

package/dist/types/receiver/protocol.d.ts

@@ -14,6 +14,12 @@ export type ReceiverMediaPlaneFallback = {
     screenWidth: number;
     screenHeight: number;
 };
+export type ReceiverCanvasSize = {
+    width: number;
+    height: number;
+};
+/** Normalize the untrusted logical canvas dimensions reported by the runtime. */
+export declare function normalizeReceiverCanvasSize(message: RuntimeMessage): ReceiverCanvasSize | null;
 export declare function normalizeStageBackgroundColor(value: unknown): string | null;
 export declare function normalizeCaptionSubscriptionTags(value: unknown): number[];
 export declare function normalizeApplicationReplaceRequest(message: RuntimeMessage): AribApplicationReplaceRequest | null;

package/dist/types/receiver/types.d.ts

@@ -20,6 +20,8 @@ export type AribApplicationInformation = RuntimeApplicationInformation;
 export type { AribApplicationReplaceRequest } from './protocol';
 export type AribApplicationReplaceHandler = (request: AribApplicationReplaceRequest) => void | Promise<void>;
 export type AribExitManagedStateHandler = (url: string) => void | Promise<void>;
+/** Return an HTML application to the receiver-owned BML data-broadcasting browser. */
+export type AribLaunchDataBroadcastingBrowserHandler = () => void | Promise<void>;
 export type AribBroadcastClock = {
     /** Absolute broadcast time at the anchor, as Unix epoch milliseconds. */
     epochMilliseconds: number;
@@ -80,12 +82,18 @@ export type AribReceiverHostOptions = {
     onReplaceApplication?: AribApplicationReplaceHandler;
     /** Transfer an application to an unmanaged general-application URL. */
     onExitManagedState?: AribExitManagedStateHandler;
+    /** Return the current Hybridcast HTML application to its paired BML browser. */
+    onLaunchDataBroadcastingBrowser?: AribLaunchDataBroadcastingBrowserHandler;
     /** Override the default browser alert when the receiver cannot open the EPG. */
     onProgramGuideUnavailable?: AribProgramGuideUnavailableHandler;
     /** Receiver identity/capabilities exposed to the broadcast application. */
     systemInformation?: ReceiverSystemInformationOverrides;
     /** Resolve receiver/CAS identifiers; defaults to the bundled Huggy demo identity. */
     getDeviceIdentifier?: ReceiverDeviceIdentifierProvider;
+    /** Initial BML general registers exposed through navigator.bmlCompat. */
+    bmlGreg?: string[];
+    /** Optional user-agent string exposed only within the managed HTML runtime. */
+    userAgent?: string;
     /** Receiver UI hook for a TR-B39 viewer-participation corner notification. */
     onViewerParticipation?: (event: AribViewerParticipationEvent) => void;
 };

package/dist/types/receiver-host.d.ts

@@ -5,7 +5,7 @@ import { type AribProgramGuideRequest } from './program-guide';
 import { type AribApplicationPresentationState, type AribViewerParticipationNotification } from './viewer-participation';
 import type { AribApplicationInformation, AribBroadcastClock, AribCaptionPacket, AribReceiverHostOptions } from './receiver/types';
 export type { AribMediaPlane, AribMediaPlaneAdapter, AribMediaPlaneLayer, AribMediaPlaneStackEntry, AribMediaPlaneUnmountReason, AribVideoPlane, } from './media-plane';
-export type { AribApplicationInformation, AribApplicationReplaceHandler, AribApplicationReplaceRequest, AribBroadcastClock, AribCaptionPacket, AribCaptionSubscription, AribExitManagedStateHandler, AribReceiverHostOptions, AribReceiverLifecycleEvent, } from './receiver/types';
+export type { AribApplicationInformation, AribApplicationReplaceHandler, AribApplicationReplaceRequest, AribBroadcastClock, AribCaptionPacket, AribCaptionSubscription, AribExitManagedStateHandler, AribLaunchDataBroadcastingBrowserHandler, AribReceiverHostOptions, AribReceiverLifecycleEvent, } from './receiver/types';
 export declare class AribReceiverHost {
     readonly iframe: HTMLIFrameElement;
     readonly viewport: HTMLElement;
@@ -27,9 +27,12 @@ export declare class AribReceiverHost {
     private readonly onCaptionSubscription?;
     private readonly onReplaceApplication?;
     private readonly onExitManagedState?;
+    private readonly onLaunchDataBroadcastingBrowser?;
     private readonly onProgramGuideUnavailable?;
     private readonly systemInformation?;
     private readonly getDeviceIdentifier?;
+    private readonly bmlGreg;
+    private readonly userAgent?;
     private readonly onViewerParticipation?;
     private readonly viewerParticipation;
     private readonly canvas;
@@ -44,6 +47,8 @@ export declare class AribReceiverHost {
     private destroyed;
     constructor(options: AribReceiverHostOptions);
     installRuntime(target: RuntimeWindow): void;
+    /** Replace BML general registers while retaining the active runtime reference. */
+    setBmlGreg(values: readonly string[]): void;
     /** Set the MH-AIT identity exposed by applicationManager.getOwnerApplication(). */
     setApplicationInformation(application: AribApplicationInformation | null): void;
     /**

package/dist/types/runtime/install.d.ts

@@ -26,5 +26,9 @@ export type RuntimeOptions = {
     getDeviceIdentifier?: ReceiverDeviceIdentifierProvider;
     /** MH-AIT metadata for the application which owns this document. */
     application?: RuntimeApplicationInformation;
+    /** Receiver-owned BML general registers shared with a paired BML engine. */
+    bmlGreg?: string[];
+    /** Optional receiver identity token exposed to HTML application feature detection. */
+    userAgent?: string;
 };
 export declare function installRuntime(target: RuntimeWindow, options?: RuntimeOptions): void;

package/dist/types/runtime/media-plane-runtime.d.ts

@@ -22,6 +22,7 @@ export declare class RuntimeMediaPlaneController {
     private nextMediaObjectId;
     private activeMediaObject;
     private lastMediaPlane;
+    private lastScreenSize;
     private lastStageBackgroundColor;
     private observedMediaObject;
     private mediaPlaneFrame;
@@ -46,6 +47,7 @@ export declare class RuntimeMediaPlaneController {
     private activeMediaAnimation;
     private observeMediaObject;
     private logicalViewport;
+    private reportScreenSize;
     private slotIdFor;
     private callMediaPlaneAdapter;
     private unmountMediaPlane;

package/dist/types/tv-input.d.ts

@@ -0,0 +1,8 @@
+type TvReceiverIframe = Pick<HTMLIFrameElement, 'contentWindow' | 'inert' | 'style' | 'tabIndex'>;
+/** Keep pointer input on the native TV shell without making the child document inert. */
+export declare function configureTvReceiverIframe(iframe: TvReceiverIframe): void;
+/** Dispatch a receiver key in the child browsing context that owns the application DOM. */
+export declare function dispatchReceiverKey(iframe: TvReceiverIframe, code: number): boolean;
+/** @deprecated Use dispatchReceiverKey(). */
+export declare const dispatchTvReceiverKey: typeof dispatchReceiverKey;
+export {};

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.7",
+  "version": "0.1.9",
   "description": "Browser runtime and receiver host for ARIB HTML5 data broadcasting",
   "keywords": [
     "arib",